From 83a46b2fc41459b46fed36364841a4af5ad99913 Mon Sep 17 00:00:00 2001 From: B3ni Date: Mon, 16 Jun 2025 15:24:27 +0200 Subject: [PATCH] alap --- .gitignore | 74 + .vscode/extensions.json | 5 + .vscode/launch.json | 10 + .vscode/settings.json | 55 + .vsconfig | 6 + Assets/DefaultVolumeProfile.asset | 15 + Assets/DefaultVolumeProfile.asset.meta | 8 + Assets/Materials.meta | 8 + Assets/Materials/black.mat | 135 + Assets/Materials/black.mat.meta | 8 + Assets/Mirror.meta | 8 + Assets/Mirror/Authenticators.meta | 8 + .../Authenticators/BasicAuthenticator.cs | 192 + .../Authenticators/BasicAuthenticator.cs.meta | 11 + .../Authenticators/DeviceAuthenticator.cs | 129 + .../DeviceAuthenticator.cs.meta | 11 + .../Mirror.Authenticators.asmdef | 16 + .../Mirror.Authenticators.asmdef.meta | 7 + .../Authenticators/TimeoutAuthenticator.cs | 70 + .../TimeoutAuthenticator.cs.meta | 11 + Assets/Mirror/CompilerSymbols.meta | 8 + .../Mirror.CompilerSymbols.asmdef | 14 + .../Mirror.CompilerSymbols.asmdef.meta | 7 + .../CompilerSymbols/PreprocessorDefine.cs | 49 + .../PreprocessorDefine.cs.meta | 11 + Assets/Mirror/Components.meta | 8 + Assets/Mirror/Components/AssemblyInfo.cs | 12 + Assets/Mirror/Components/AssemblyInfo.cs.meta | 11 + Assets/Mirror/Components/Discovery.meta | 8 + .../Components/Discovery/NetworkDiscovery.cs | 93 + .../Discovery/NetworkDiscovery.cs.meta | 11 + .../Discovery/NetworkDiscoveryBase.cs | 470 + .../Discovery/NetworkDiscoveryBase.cs.meta | 11 + .../Discovery/NetworkDiscoveryHUD.cs | 132 + .../Discovery/NetworkDiscoveryHUD.cs.meta | 11 + .../Components/Discovery/ServerRequest.cs | 4 + .../Discovery/ServerRequest.cs.meta | 11 + .../Components/Discovery/ServerResponse.cs | 18 + .../Discovery/ServerResponse.cs.meta | 11 + Assets/Mirror/Components/Experimental.meta | 8 + .../Experimental/NetworkLerpRigidbody.cs | 97 + .../Experimental/NetworkLerpRigidbody.cs.meta | 11 + .../Experimental/NetworkRigidbody.cs | 354 + .../Experimental/NetworkRigidbody.cs.meta | 11 + .../Experimental/NetworkRigidbody2D.cs | 349 + .../Experimental/NetworkRigidbody2D.cs.meta | 11 + Assets/Mirror/Components/GUIConsole.cs | 133 + Assets/Mirror/Components/GUIConsole.cs.meta | 11 + .../Mirror/Components/InterestManagement.meta | 8 + .../InterestManagement/Distance.meta | 3 + .../Distance/DistanceInterestManagement.cs | 90 + .../DistanceInterestManagement.cs.meta | 11 + .../DistanceInterestManagementCustomRange.cs | 15 + ...tanceInterestManagementCustomRange.cs.meta | 11 + .../Components/InterestManagement/Match.meta | 3 + .../Match/MatchInterestManagement.cs | 164 + .../Match/MatchInterestManagement.cs.meta | 11 + .../InterestManagement/Match/NetworkMatch.cs | 42 + .../Match/NetworkMatch.cs.meta | 11 + .../Components/InterestManagement/Scene.meta | 3 + .../Scene/SceneInterestManagement.cs | 118 + .../Scene/SceneInterestManagement.cs.meta | 11 + .../InterestManagement/SpatialHashing.meta | 3 + .../SpatialHashing/Grid2D.cs | 104 + .../SpatialHashing/Grid2D.cs.meta | 11 + .../SpatialHashingInterestManagement.cs | 154 + .../SpatialHashingInterestManagement.cs.meta | 11 + .../Components/InterestManagement/Team.meta | 8 + .../InterestManagement/Team/NetworkTeam.cs | 39 + .../Team/NetworkTeam.cs.meta | 11 + .../Team/TeamInterestManagement.cs | 182 + .../Team/TeamInterestManagement.cs.meta | 11 + Assets/Mirror/Components/LagCompensation.meta | 8 + .../LagCompensation/HistoryCollider.cs | 107 + .../LagCompensation/HistoryCollider.cs.meta | 11 + .../LagCompensation/LagCompensator.cs | 196 + .../LagCompensation/LagCompensator.cs.meta | 11 + .../Components/Mirror.Components.asmdef | 16 + .../Components/Mirror.Components.asmdef.meta | 7 + Assets/Mirror/Components/NetworkAnimator.cs | 655 + .../Mirror/Components/NetworkAnimator.cs.meta | 11 + .../Components/NetworkDiagnosticsDebugger.cs | 30 + .../NetworkDiagnosticsDebugger.cs.meta | 3 + .../Mirror/Components/NetworkLobbyManager.cs | 18 + .../Components/NetworkLobbyManager.cs.meta | 11 + .../Mirror/Components/NetworkLobbyPlayer.cs | 15 + .../Components/NetworkLobbyPlayer.cs.meta | 11 + .../Mirror/Components/NetworkPingDisplay.cs | 39 + .../Components/NetworkPingDisplay.cs.meta | 11 + .../Mirror/Components/NetworkRigidbody.meta | 3 + .../NetworkRigidbodyReliable.cs | 96 + .../NetworkRigidbodyReliable.cs.meta | 11 + .../NetworkRigidbodyReliable2D.cs | 96 + .../NetworkRigidbodyReliable2D.cs.meta | 11 + .../NetworkRigidbodyUnreliable.cs | 96 + .../NetworkRigidbodyUnreliable.cs.meta | 11 + .../NetworkRigidbodyUnreliable2D.cs | 96 + .../NetworkRigidbodyUnreliable2D.cs.meta | 11 + .../Mirror/Components/NetworkRoomManager.cs | 685 + .../Components/NetworkRoomManager.cs.meta | 11 + Assets/Mirror/Components/NetworkRoomPlayer.cs | 195 + .../Components/NetworkRoomPlayer.cs.meta | 11 + Assets/Mirror/Components/NetworkStatistics.cs | 194 + .../Components/NetworkStatistics.cs.meta | 11 + .../Mirror/Components/NetworkTransform.meta | 3 + .../NetworkTransform/NetworkTransform.cs | 8 + .../NetworkTransform/NetworkTransform.cs.meta | 11 + .../NetworkTransform/NetworkTransformBase.cs | 489 + .../NetworkTransformBase.cs.meta | 11 + .../NetworkTransform/NetworkTransformChild.cs | 12 + .../NetworkTransformChild.cs.meta | 11 + .../NetworkTransformReliable.cs | 420 + .../NetworkTransformReliable.cs.meta | 11 + .../NetworkTransformUnreliable.cs | 678 + .../NetworkTransformUnreliable.cs.meta | 11 + .../NetworkTransform/TransformSnapshot.cs | 68 + .../TransformSnapshot.cs.meta | 11 + .../NetworkTransform/TransformSyncData.cs | 156 + .../TransformSyncData.cs.meta | 11 + .../Mirror/Components/PredictedRigidbody.meta | 3 + .../PredictedRigidbody/LocalGhostMaterial.mat | 85 + .../LocalGhostMaterial.mat.meta | 8 + .../PredictedRigidbody/PredictedRigidbody.cs | 841 ++ .../PredictedRigidbody.cs.meta | 15 + .../PredictedRigidbodyPhysicsGhost.cs | 15 + .../PredictedRigidbodyPhysicsGhost.cs.meta | 11 + .../PredictedRigidbodyRemoteGhost.cs | 1 + .../PredictedRigidbodyRemoteGhost.cs.meta | 11 + .../PredictedRigidbody/PredictionUtils.cs | 419 + .../PredictionUtils.cs.meta | 11 + .../RemoteGhostMaterial.mat | 85 + .../RemoteGhostMaterial.mat.meta | 8 + .../PredictedRigidbody/RigidbodyState.cs | 58 + .../PredictedRigidbody/RigidbodyState.cs.meta | 11 + Assets/Mirror/Components/RemoteStatistics.cs | 441 + .../Components/RemoteStatistics.cs.meta | 11 + Assets/Mirror/Core.meta | 8 + Assets/Mirror/Core/AssemblyInfo.cs | 12 + Assets/Mirror/Core/AssemblyInfo.cs.meta | 11 + Assets/Mirror/Core/Attributes.cs | 91 + Assets/Mirror/Core/Attributes.cs.meta | 11 + Assets/Mirror/Core/Batching.meta | 8 + Assets/Mirror/Core/Batching/Batcher.cs | 150 + Assets/Mirror/Core/Batching/Batcher.cs.meta | 11 + Assets/Mirror/Core/Batching/Unbatcher.cs | 129 + Assets/Mirror/Core/Batching/Unbatcher.cs.meta | 11 + Assets/Mirror/Core/ConnectionQuality.cs | 74 + Assets/Mirror/Core/ConnectionQuality.cs.meta | 11 + Assets/Mirror/Core/HostMode.cs | 44 + Assets/Mirror/Core/HostMode.cs.meta | 11 + Assets/Mirror/Core/InterestManagement.cs | 146 + Assets/Mirror/Core/InterestManagement.cs.meta | 11 + Assets/Mirror/Core/InterestManagementBase.cs | 77 + .../Core/InterestManagementBase.cs.meta | 11 + Assets/Mirror/Core/LagCompensation.meta | 3 + Assets/Mirror/Core/LagCompensation/Capture.cs | 13 + .../Core/LagCompensation/Capture.cs.meta | 11 + .../Core/LagCompensation/HistoryBounds.cs | 139 + .../LagCompensation/HistoryBounds.cs.meta | 11 + .../Core/LagCompensation/LagCompensation.cs | 144 + .../LagCompensation/LagCompensation.cs.meta | 11 + .../LagCompensationSettings.cs | 19 + .../LagCompensationSettings.cs.meta | 11 + .../Core/LagCompensation/MinMaxBounds.cs | 73 + .../Core/LagCompensation/MinMaxBounds.cs.meta | 11 + Assets/Mirror/Core/LocalConnectionToClient.cs | 82 + .../Core/LocalConnectionToClient.cs.meta | 11 + Assets/Mirror/Core/LocalConnectionToServer.cs | 117 + .../Core/LocalConnectionToServer.cs.meta | 11 + Assets/Mirror/Core/Messages.cs | 140 + Assets/Mirror/Core/Messages.cs.meta | 11 + Assets/Mirror/Core/Mirror.asmdef | 16 + Assets/Mirror/Core/Mirror.asmdef.meta | 7 + Assets/Mirror/Core/NetworkAuthenticator.cs | 84 + .../Mirror/Core/NetworkAuthenticator.cs.meta | 11 + Assets/Mirror/Core/NetworkBehaviour.cs | 1370 ++ Assets/Mirror/Core/NetworkBehaviour.cs.meta | 11 + Assets/Mirror/Core/NetworkBehaviourSyncVar.cs | 33 + .../Core/NetworkBehaviourSyncVar.cs.meta | 11 + Assets/Mirror/Core/NetworkClient.cs | 1842 +++ Assets/Mirror/Core/NetworkClient.cs.meta | 11 + .../Core/NetworkClient_TimeInterpolation.cs | 168 + .../NetworkClient_TimeInterpolation.cs.meta | 11 + Assets/Mirror/Core/NetworkConnection.cs | 207 + Assets/Mirror/Core/NetworkConnection.cs.meta | 11 + .../Mirror/Core/NetworkConnectionToClient.cs | 220 + .../Core/NetworkConnectionToClient.cs.meta | 11 + .../Mirror/Core/NetworkConnectionToServer.cs | 24 + .../Core/NetworkConnectionToServer.cs.meta | 11 + Assets/Mirror/Core/NetworkDiagnostics.cs | 63 + Assets/Mirror/Core/NetworkDiagnostics.cs.meta | 11 + Assets/Mirror/Core/NetworkIdentity.cs | 1390 ++ Assets/Mirror/Core/NetworkIdentity.cs.meta | 11 + Assets/Mirror/Core/NetworkLoop.cs | 211 + Assets/Mirror/Core/NetworkLoop.cs.meta | 11 + Assets/Mirror/Core/NetworkManager.cs | 1504 ++ Assets/Mirror/Core/NetworkManager.cs.meta | 11 + Assets/Mirror/Core/NetworkManagerHUD.cs | 162 + Assets/Mirror/Core/NetworkManagerHUD.cs.meta | 11 + Assets/Mirror/Core/NetworkMessage.cs | 4 + Assets/Mirror/Core/NetworkMessage.cs.meta | 11 + Assets/Mirror/Core/NetworkMessages.cs | 210 + Assets/Mirror/Core/NetworkMessages.cs.meta | 11 + Assets/Mirror/Core/NetworkReader.cs | 249 + Assets/Mirror/Core/NetworkReader.cs.meta | 11 + Assets/Mirror/Core/NetworkReaderExtensions.cs | 388 + .../Core/NetworkReaderExtensions.cs.meta | 11 + Assets/Mirror/Core/NetworkReaderPool.cs | 45 + Assets/Mirror/Core/NetworkReaderPool.cs.meta | 11 + Assets/Mirror/Core/NetworkReaderPooled.cs | 15 + .../Mirror/Core/NetworkReaderPooled.cs.meta | 11 + Assets/Mirror/Core/NetworkServer.cs | 1981 +++ Assets/Mirror/Core/NetworkServer.cs.meta | 11 + Assets/Mirror/Core/NetworkStartPosition.cs | 21 + .../Mirror/Core/NetworkStartPosition.cs.meta | 11 + Assets/Mirror/Core/NetworkTime.cs | 243 + Assets/Mirror/Core/NetworkTime.cs.meta | 11 + Assets/Mirror/Core/NetworkWriter.cs | 249 + Assets/Mirror/Core/NetworkWriter.cs.meta | 11 + Assets/Mirror/Core/NetworkWriterExtensions.cs | 430 + .../Core/NetworkWriterExtensions.cs.meta | 11 + Assets/Mirror/Core/NetworkWriterPool.cs | 37 + Assets/Mirror/Core/NetworkWriterPool.cs.meta | 11 + Assets/Mirror/Core/NetworkWriterPooled.cs | 13 + .../Mirror/Core/NetworkWriterPooled.cs.meta | 11 + Assets/Mirror/Core/PortTransport.cs | 13 + Assets/Mirror/Core/PortTransport.cs.meta | 11 + Assets/Mirror/Core/Prediction.meta | 3 + Assets/Mirror/Core/Prediction/Prediction.cs | 176 + .../Mirror/Core/Prediction/Prediction.cs.meta | 11 + Assets/Mirror/Core/RemoteCalls.cs | 151 + Assets/Mirror/Core/RemoteCalls.cs.meta | 11 + Assets/Mirror/Core/SnapshotInterpolation.meta | 8 + .../Core/SnapshotInterpolation/Snapshot.cs | 17 + .../SnapshotInterpolation/Snapshot.cs.meta | 11 + .../SnapshotInterpolation.cs | 390 + .../SnapshotInterpolation.cs.meta | 11 + .../SnapshotInterpolationSettings.cs | 70 + .../SnapshotInterpolationSettings.cs.meta | 3 + .../SnapshotInterpolation/TimeSnapshot.cs | 15 + .../TimeSnapshot.cs.meta | 11 + Assets/Mirror/Core/SyncDictionary.cs | 326 + Assets/Mirror/Core/SyncDictionary.cs.meta | 11 + Assets/Mirror/Core/SyncList.cs | 420 + Assets/Mirror/Core/SyncList.cs.meta | 11 + Assets/Mirror/Core/SyncObject.cs | 53 + Assets/Mirror/Core/SyncObject.cs.meta | 11 + Assets/Mirror/Core/SyncSet.cs | 352 + Assets/Mirror/Core/SyncSet.cs.meta | 11 + Assets/Mirror/Core/Threading.meta | 8 + .../Threading/ConcurrentNetworkWriterPool.cs | 45 + .../ConcurrentNetworkWriterPool.cs.meta | 11 + .../ConcurrentNetworkWriterPooled.cs | 11 + .../ConcurrentNetworkWriterPooled.cs.meta | 3 + .../Mirror/Core/Threading/ConcurrentPool.cs | 44 + .../Core/Threading/ConcurrentPool.cs.meta | 11 + Assets/Mirror/Core/Threading/ThreadLog.cs | 112 + .../Mirror/Core/Threading/ThreadLog.cs.meta | 11 + Assets/Mirror/Core/Threading/WorkerThread.cs | 165 + .../Core/Threading/WorkerThread.cs.meta | 11 + Assets/Mirror/Core/Tools.meta | 3 + Assets/Mirror/Core/Tools/AccurateInterval.cs | 86 + .../Core/Tools/AccurateInterval.cs.meta | 11 + Assets/Mirror/Core/Tools/Compression.cs | 556 + Assets/Mirror/Core/Tools/Compression.cs.meta | 11 + Assets/Mirror/Core/Tools/DeltaCompression.cs | 38 + .../Core/Tools/DeltaCompression.cs.meta | 11 + .../Core/Tools/ExponentialMovingAverage.cs | 53 + .../Tools/ExponentialMovingAverage.cs.meta | 11 + Assets/Mirror/Core/Tools/Extensions.cs | 112 + Assets/Mirror/Core/Tools/Extensions.cs.meta | 11 + Assets/Mirror/Core/Tools/Mathd.cs | 32 + Assets/Mirror/Core/Tools/Mathd.cs.meta | 11 + Assets/Mirror/Core/Tools/Pool.cs | 40 + Assets/Mirror/Core/Tools/Pool.cs.meta | 11 + Assets/Mirror/Core/Tools/Readme.txt | 1 + Assets/Mirror/Core/Tools/Readme.txt.meta | 3 + Assets/Mirror/Core/Tools/TimeSample.cs | 61 + Assets/Mirror/Core/Tools/TimeSample.cs.meta | 11 + Assets/Mirror/Core/Tools/Utils.cs | 222 + Assets/Mirror/Core/Tools/Utils.cs.meta | 11 + Assets/Mirror/Core/Tools/Vector3Long.cs | 125 + Assets/Mirror/Core/Tools/Vector3Long.cs.meta | 11 + Assets/Mirror/Core/Transport.cs | 191 + Assets/Mirror/Core/Transport.cs.meta | 11 + Assets/Mirror/Core/TransportError.cs | 17 + Assets/Mirror/Core/TransportError.cs.meta | 11 + Assets/Mirror/Core/WeaverFuse.cs | 22 + Assets/Mirror/Core/WeaverFuse.cs.meta | 11 + Assets/Mirror/Editor.meta | 8 + Assets/Mirror/Editor/AndroidManifestHelper.cs | 113 + .../Editor/AndroidManifestHelper.cs.meta | 11 + Assets/Mirror/Editor/EditorHelper.cs | 41 + Assets/Mirror/Editor/EditorHelper.cs.meta | 11 + Assets/Mirror/Editor/Icon.meta | 8 + Assets/Mirror/Editor/Icon/MirrorIcon.png | Bin 0 -> 138247 bytes Assets/Mirror/Editor/Icon/MirrorIcon.png.meta | 110 + Assets/Mirror/Editor/InspectorHelper.cs | 77 + Assets/Mirror/Editor/InspectorHelper.cs.meta | 11 + Assets/Mirror/Editor/Mirror.Editor.asmdef | 19 + .../Mirror/Editor/Mirror.Editor.asmdef.meta | 7 + .../Editor/NetworkBehaviourInspector.cs | 104 + .../Editor/NetworkBehaviourInspector.cs.meta | 11 + .../Editor/NetworkInformationPreview.cs | 305 + .../Editor/NetworkInformationPreview.cs.meta | 11 + Assets/Mirror/Editor/NetworkManagerEditor.cs | 181 + .../Editor/NetworkManagerEditor.cs.meta | 11 + .../Mirror/Editor/NetworkScenePostProcess.cs | 98 + .../Editor/NetworkScenePostProcess.cs.meta | 11 + Assets/Mirror/Editor/ReadOnlyDrawer.cs | 19 + Assets/Mirror/Editor/ReadOnlyDrawer.cs.meta | 11 + Assets/Mirror/Editor/SceneDrawer.cs | 47 + Assets/Mirror/Editor/SceneDrawer.cs.meta | 11 + .../Editor/SyncObjectCollectionsDrawer.cs | 83 + .../SyncObjectCollectionsDrawer.cs.meta | 3 + .../Mirror/Editor/SyncVarAttributeDrawer.cs | 28 + .../Editor/SyncVarAttributeDrawer.cs.meta | 11 + Assets/Mirror/Editor/Weaver.meta | 8 + Assets/Mirror/Editor/Weaver/AssemblyInfo.cs | 3 + .../Mirror/Editor/Weaver/AssemblyInfo.cs.meta | 11 + Assets/Mirror/Editor/Weaver/EntryPoint.meta | 3 + .../EntryPoint/CompilationFinishedHook.cs | 188 + .../CompilationFinishedHook.cs.meta | 11 + .../EntryPoint/CompilationFinishedLogger.cs | 31 + .../CompilationFinishedLogger.cs.meta | 3 + .../Weaver/EntryPoint/EnterPlayModeHook.cs | 44 + .../EntryPoint/EnterPlayModeHook.cs.meta | 3 + .../Weaver/EntryPointILPostProcessor.meta | 3 + .../CompiledAssemblyFromFile.cs | 31 + .../CompiledAssemblyFromFile.cs.meta | 3 + .../ILPostProcessorAssemblyResolver.cs | 199 + .../ILPostProcessorAssemblyResolver.cs.meta | 3 + .../ILPostProcessorFromFile.cs | 53 + .../ILPostProcessorFromFile.cs.meta | 3 + .../ILPostProcessorHook.cs | 143 + .../ILPostProcessorHook.cs.meta | 3 + .../ILPostProcessorLogger.cs | 68 + .../ILPostProcessorLogger.cs.meta | 3 + .../ILPostProcessorReflectionImporter.cs | 36 + .../ILPostProcessorReflectionImporter.cs.meta | 3 + ...PostProcessorReflectionImporterProvider.cs | 16 + ...rocessorReflectionImporterProvider.cs.meta | 3 + Assets/Mirror/Editor/Weaver/Extensions.cs | 359 + .../Mirror/Editor/Weaver/Extensions.cs.meta | 11 + Assets/Mirror/Editor/Weaver/Helpers.cs | 26 + Assets/Mirror/Editor/Weaver/Helpers.cs.meta | 11 + Assets/Mirror/Editor/Weaver/Logger.cs | 13 + Assets/Mirror/Editor/Weaver/Logger.cs.meta | 11 + Assets/Mirror/Editor/Weaver/Processors.meta | 8 + .../Weaver/Processors/CommandProcessor.cs | 130 + .../Processors/CommandProcessor.cs.meta | 11 + .../Weaver/Processors/MethodProcessor.cs | 139 + .../Weaver/Processors/MethodProcessor.cs.meta | 11 + .../Processors/MonoBehaviourProcessor.cs | 56 + .../Processors/MonoBehaviourProcessor.cs.meta | 11 + .../Processors/NetworkBehaviourProcessor.cs | 1055 ++ .../NetworkBehaviourProcessor.cs.meta | 11 + .../Processors/ReaderWriterProcessor.cs | 216 + .../Processors/ReaderWriterProcessor.cs.meta | 11 + .../Editor/Weaver/Processors/RpcProcessor.cs | 104 + .../Weaver/Processors/RpcProcessor.cs.meta | 11 + .../ServerClientAttributeProcessor.cs | 163 + .../ServerClientAttributeProcessor.cs.meta | 11 + .../Processors/SyncObjectInitializer.cs | 39 + .../Processors/SyncObjectInitializer.cs.meta | 11 + .../Weaver/Processors/SyncObjectProcessor.cs | 90 + .../Processors/SyncObjectProcessor.cs.meta | 11 + .../SyncVarAttributeAccessReplacer.cs | 206 + .../SyncVarAttributeAccessReplacer.cs.meta | 11 + .../Processors/SyncVarAttributeProcessor.cs | 515 + .../SyncVarAttributeProcessor.cs.meta | 11 + .../Weaver/Processors/TargetRpcProcessor.cs | 159 + .../Processors/TargetRpcProcessor.cs.meta | 11 + Assets/Mirror/Editor/Weaver/Readers.cs | 385 + Assets/Mirror/Editor/Weaver/Readers.cs.meta | 11 + Assets/Mirror/Editor/Weaver/Resolvers.cs | 126 + Assets/Mirror/Editor/Weaver/Resolvers.cs.meta | 11 + .../Editor/Weaver/SyncVarAccessLists.cs | 32 + .../Editor/Weaver/SyncVarAccessLists.cs.meta | 3 + .../Editor/Weaver/TypeReferenceComparer.cs | 15 + .../Weaver/TypeReferenceComparer.cs.meta | 11 + .../Editor/Weaver/Unity.Mirror.CodeGen.asmdef | 21 + .../Weaver/Unity.Mirror.CodeGen.asmdef.meta | 7 + Assets/Mirror/Editor/Weaver/Weaver.cs | 267 + Assets/Mirror/Editor/Weaver/Weaver.cs.meta | 11 + .../Mirror/Editor/Weaver/WeaverExceptions.cs | 26 + .../Editor/Weaver/WeaverExceptions.cs.meta | 11 + Assets/Mirror/Editor/Weaver/WeaverTypes.cs | 171 + .../Mirror/Editor/Weaver/WeaverTypes.cs.meta | 3 + Assets/Mirror/Editor/Weaver/Writers.cs | 341 + Assets/Mirror/Editor/Weaver/Writers.cs.meta | 11 + Assets/Mirror/Editor/Welcome.cs | 23 + Assets/Mirror/Editor/Welcome.cs.meta | 11 + Assets/Mirror/Notice.txt | 123 + Assets/Mirror/Notice.txt.meta | 7 + Assets/Mirror/Plugins.meta | 8 + Assets/Mirror/Plugins/BouncyCastle.meta | 8 + .../BouncyCastle.Cryptography.dll | Bin 0 -> 6954264 bytes .../BouncyCastle.Cryptography.dll.meta | 33 + Assets/Mirror/Plugins/BouncyCastle/LICENSE.md | 13 + .../Plugins/BouncyCastle/LICENSE.md.meta | 7 + Assets/Mirror/Plugins/Mono.Cecil.meta | 8 + Assets/Mirror/Plugins/Mono.Cecil/License.txt | 25 + .../Plugins/Mono.Cecil/License.txt.meta | 7 + .../Plugins/Mono.Cecil/Mono.CecilX.Mdb.dll | Bin 0 -> 43520 bytes .../Mono.Cecil/Mono.CecilX.Mdb.dll.meta | 92 + .../Plugins/Mono.Cecil/Mono.CecilX.Pdb.dll | Bin 0 -> 87552 bytes .../Mono.Cecil/Mono.CecilX.Pdb.dll.meta | 92 + .../Plugins/Mono.Cecil/Mono.CecilX.Rocks.dll | Bin 0 -> 27648 bytes .../Mono.Cecil/Mono.CecilX.Rocks.dll.meta | 92 + .../Mirror/Plugins/Mono.Cecil/Mono.CecilX.dll | Bin 0 -> 340992 bytes .../Plugins/Mono.Cecil/Mono.CecilX.dll.meta | 94 + Assets/Mirror/Presets.meta | 8 + Assets/Mirror/Presets/NetworkTransform.meta | 8 + .../ClientAuth-Balanced.preset | 124 + .../ClientAuth-Balanced.preset.meta | 8 + .../ClientAuth-FastPaced.preset | 124 + .../ClientAuth-FastPaced.preset.meta | 8 + .../ClientAuth-VeryCasual.preset | 124 + .../ClientAuth-VeryCasual.preset.meta | 8 + Assets/Mirror/Readme.txt | 15 + Assets/Mirror/Readme.txt.meta | 7 + Assets/Mirror/Runtime.meta | 8 + Assets/Mirror/Runtime/Transports.meta | 8 + .../Runtime/Transports/FizzySteamworks.meta | 8 + .../BidirectionalDictionary.cs | 89 + .../BidirectionalDictionary.cs.meta | 11 + .../FizzySteamworks/FizzySteamworks.asmdef | 22 + .../FizzySteamworks.asmdef.meta | 7 + .../FizzySteamworks/FizzySteamworks.cs | 311 + .../FizzySteamworks/FizzySteamworks.cs.meta | 11 + .../Transports/FizzySteamworks/IClient.cs | 14 + .../FizzySteamworks/IClient.cs.meta | 11 + .../Transports/FizzySteamworks/IServer.cs | 12 + .../FizzySteamworks/IServer.cs.meta | 11 + .../Transports/FizzySteamworks/LICENSE | 37 + .../Transports/FizzySteamworks/LICENSE.meta | 7 + .../FizzySteamworks/LegacyClient.cs | 177 + .../FizzySteamworks/LegacyClient.cs.meta | 11 + .../FizzySteamworks/LegacyCommon.cs | 180 + .../FizzySteamworks/LegacyCommon.cs.meta | 11 + .../FizzySteamworks/LegacyServer.cs | 170 + .../FizzySteamworks/LegacyServer.cs.meta | 11 + .../Transports/FizzySteamworks/NextClient.cs | 226 + .../FizzySteamworks/NextClient.cs.meta | 11 + .../Transports/FizzySteamworks/NextCommon.cs | 48 + .../FizzySteamworks/NextCommon.cs.meta | 11 + .../Transports/FizzySteamworks/NextServer.cs | 246 + .../FizzySteamworks/NextServer.cs.meta | 11 + .../Transports/FizzySteamworks/README.md | 55 + .../Transports/FizzySteamworks/README.md.meta | 7 + .../Transports/FizzySteamworks/package.json | 21 + .../FizzySteamworks/package.json.meta | 7 + Assets/Mirror/Transports.meta | 8 + Assets/Mirror/Transports/Edgegap.meta | 8 + .../Transports/Edgegap/EdgegapRelay.meta | 8 + .../Edgegap/EdgegapRelay/EdgegapKcpClient.cs | 141 + .../EdgegapRelay/EdgegapKcpClient.cs.meta | 11 + .../Edgegap/EdgegapRelay/EdgegapKcpServer.cs | 203 + .../EdgegapRelay/EdgegapKcpServer.cs.meta | 11 + .../EdgegapRelay/EdgegapKcpTransport.cs | 162 + .../EdgegapRelay/EdgegapKcpTransport.cs.meta | 11 + .../Edgegap/EdgegapRelay/Protocol.cs | 29 + .../Edgegap/EdgegapRelay/Protocol.cs.meta | 11 + .../Transports/Edgegap/EdgegapRelay/README.md | 20 + .../Edgegap/EdgegapRelay/README.md.meta | 7 + .../EdgegapRelay/RelayCredentialsFromArgs.cs | 25 + .../RelayCredentialsFromArgs.cs.meta | 11 + Assets/Mirror/Transports/Edgegap/edgegap.png | Bin 0 -> 4347 bytes .../Transports/Edgegap/edgegap.png.meta | 123 + Assets/Mirror/Transports/Encryption.meta | 3 + .../Mirror/Transports/Encryption/Editor.meta | 3 + .../Editor/EncryptionTransportEditor.asmdef | 18 + .../EncryptionTransportEditor.asmdef.meta | 7 + .../Editor/EncryptionTransportInspector.cs | 81 + .../EncryptionTransportInspector.cs.meta | 3 + .../Encryption/EncryptedConnection.cs | 595 + .../Encryption/EncryptedConnection.cs.meta | 3 + .../Encryption/EncryptionCredentials.cs | 125 + .../Encryption/EncryptionCredentials.cs.meta | 3 + .../Encryption/EncryptionTransport.cs | 268 + .../Encryption/EncryptionTransport.cs.meta | 11 + .../Transports/Encryption/PubKeyInfo.cs | 9 + .../Transports/Encryption/PubKeyInfo.cs.meta | 3 + Assets/Mirror/Transports/KCP.meta | 8 + Assets/Mirror/Transports/KCP/KcpTransport.cs | 371 + .../Transports/KCP/KcpTransport.cs.meta | 11 + .../Transports/KCP/ThreadedKcpTransport.cs | 327 + .../KCP/ThreadedKcpTransport.cs.meta | 11 + Assets/Mirror/Transports/KCP/kcp2k.meta | 8 + Assets/Mirror/Transports/KCP/kcp2k/KCP.asmdef | 16 + .../Transports/KCP/kcp2k/KCP.asmdef.meta | 7 + .../Mirror/Transports/KCP/kcp2k/LICENSE.txt | 24 + .../Transports/KCP/kcp2k/LICENSE.txt.meta | 7 + .../Mirror/Transports/KCP/kcp2k/VERSION.txt | 256 + .../Transports/KCP/kcp2k/VERSION.txt.meta | 7 + Assets/Mirror/Transports/KCP/kcp2k/empty.meta | 3 + .../KCP/kcp2k/empty/KcpServerNonAlloc.cs | 1 + .../KCP/kcp2k/empty/KcpServerNonAlloc.cs.meta | 3 + .../Transports/KCP/kcp2k/highlevel.meta | 8 + .../Transports/KCP/kcp2k/highlevel/Common.cs | 75 + .../KCP/kcp2k/highlevel/Common.cs.meta | 3 + .../KCP/kcp2k/highlevel/ErrorCode.cs | 15 + .../KCP/kcp2k/highlevel/ErrorCode.cs.meta | 3 + .../KCP/kcp2k/highlevel/Extensions.cs | 166 + .../KCP/kcp2k/highlevel/Extensions.cs.meta | 3 + .../KCP/kcp2k/highlevel/KcpChannel.cs | 10 + .../KCP/kcp2k/highlevel/KcpChannel.cs.meta | 3 + .../KCP/kcp2k/highlevel/KcpClient.cs | 291 + .../KCP/kcp2k/highlevel/KcpClient.cs.meta | 3 + .../KCP/kcp2k/highlevel/KcpConfig.cs | 97 + .../KCP/kcp2k/highlevel/KcpConfig.cs.meta | 3 + .../KCP/kcp2k/highlevel/KcpHeader.cs | 26 + .../KCP/kcp2k/highlevel/KcpHeader.cs.meta | 3 + .../Transports/KCP/kcp2k/highlevel/KcpPeer.cs | 775 + .../KCP/kcp2k/highlevel/KcpPeer.cs.meta | 3 + .../KCP/kcp2k/highlevel/KcpServer.cs | 411 + .../KCP/kcp2k/highlevel/KcpServer.cs.meta | 3 + .../kcp2k/highlevel/KcpServerConnection.cs | 124 + .../highlevel/KcpServerConnection.cs.meta | 3 + .../KCP/kcp2k/highlevel/KcpState.cs | 4 + .../KCP/kcp2k/highlevel/KcpState.cs.meta | 11 + .../Transports/KCP/kcp2k/highlevel/Log.cs | 14 + .../KCP/kcp2k/highlevel/Log.cs.meta | 11 + Assets/Mirror/Transports/KCP/kcp2k/kcp.meta | 8 + .../Transports/KCP/kcp2k/kcp/AckItem.cs | 8 + .../Transports/KCP/kcp2k/kcp/AckItem.cs.meta | 11 + .../Transports/KCP/kcp2k/kcp/AssemblyInfo.cs | 3 + .../KCP/kcp2k/kcp/AssemblyInfo.cs.meta | 3 + Assets/Mirror/Transports/KCP/kcp2k/kcp/Kcp.cs | 1118 ++ .../Transports/KCP/kcp2k/kcp/Kcp.cs.meta | 11 + .../Mirror/Transports/KCP/kcp2k/kcp/Pool.cs | 46 + .../Transports/KCP/kcp2k/kcp/Pool.cs.meta | 11 + .../Transports/KCP/kcp2k/kcp/Segment.cs | 78 + .../Transports/KCP/kcp2k/kcp/Segment.cs.meta | 11 + .../Mirror/Transports/KCP/kcp2k/kcp/Utils.cs | 76 + .../Transports/KCP/kcp2k/kcp/Utils.cs.meta | 11 + Assets/Mirror/Transports/Latency.meta | 8 + .../Transports/Latency/LatencySimulation.cs | 323 + .../Latency/LatencySimulation.cs.meta | 11 + Assets/Mirror/Transports/Middleware.meta | 8 + .../Middleware/MiddlewareTransport.cs | 61 + .../Middleware/MiddlewareTransport.cs.meta | 11 + .../Transports/Mirror.Transports.asmdef | 19 + .../Transports/Mirror.Transports.asmdef.meta | 7 + Assets/Mirror/Transports/Multiplex.meta | 8 + .../Multiplex/MultiplexTransport.cs | 440 + .../Multiplex/MultiplexTransport.cs.meta | 11 + Assets/Mirror/Transports/SimpleWeb.meta | 8 + .../Mirror/Transports/SimpleWeb/Editor.meta | 8 + .../Editor/ClientWebsocketSettingsDrawer.cs | 71 + .../ClientWebsocketSettingsDrawer.cs.meta | 3 + .../Transports/SimpleWeb/SimpleWeb.meta | 8 + .../SimpleWeb/SimpleWeb/AssemblyInfo.cs | 7 + .../SimpleWeb/SimpleWeb/AssemblyInfo.cs.meta | 11 + .../SimpleWeb/SimpleWeb/CHANGELOG.md | 48 + .../SimpleWeb/SimpleWeb/CHANGELOG.md.meta | 7 + .../SimpleWeb/SimpleWeb/Client.meta | 8 + .../Client/ClientWebsocketSettings.cs | 17 + .../Client/ClientWebsocketSettings.cs.meta | 3 + .../SimpleWeb/Client/SimpleWebClient.cs | 103 + .../SimpleWeb/Client/SimpleWebClient.cs.meta | 11 + .../SimpleWeb/Client/StandAlone.meta | 8 + .../Client/StandAlone/ClientHandshake.cs | 91 + .../Client/StandAlone/ClientHandshake.cs.meta | 11 + .../Client/StandAlone/ClientSslHelper.cs | 47 + .../Client/StandAlone/ClientSslHelper.cs.meta | 11 + .../StandAlone/WebSocketClientStandAlone.cs | 140 + .../WebSocketClientStandAlone.cs.meta | 11 + .../SimpleWeb/SimpleWeb/Client/Webgl.meta | 8 + .../SimpleWeb/Client/Webgl/SimpleWebJSLib.cs | 34 + .../Client/Webgl/SimpleWebJSLib.cs.meta | 11 + .../Client/Webgl/WebSocketClientWebGl.cs | 142 + .../Client/Webgl/WebSocketClientWebGl.cs.meta | 11 + .../SimpleWeb/Client/Webgl/plugin.meta | 8 + .../Client/Webgl/plugin/SimpleWeb.jslib | 114 + .../Client/Webgl/plugin/SimpleWeb.jslib.meta | 37 + .../SimpleWeb/SimpleWeb/Common.meta | 8 + .../SimpleWeb/SimpleWeb/Common/BufferPool.cs | 249 + .../SimpleWeb/Common/BufferPool.cs.meta | 11 + .../SimpleWeb/SimpleWeb/Common/Connection.cs | 134 + .../SimpleWeb/Common/Connection.cs.meta | 11 + .../SimpleWeb/SimpleWeb/Common/Constants.cs | 76 + .../SimpleWeb/Common/Constants.cs.meta | 11 + .../SimpleWeb/SimpleWeb/Common/EventType.cs | 10 + .../SimpleWeb/Common/EventType.cs.meta | 11 + .../SimpleWeb/SimpleWeb/Common/Log.cs | 224 + .../SimpleWeb/SimpleWeb/Common/Log.cs.meta | 11 + .../SimpleWeb/SimpleWeb/Common/Message.cs | 49 + .../SimpleWeb/Common/Message.cs.meta | 11 + .../SimpleWeb/Common/MessageProcessor.cs | 175 + .../SimpleWeb/Common/MessageProcessor.cs.meta | 11 + .../SimpleWeb/SimpleWeb/Common/ReadHelper.cs | 123 + .../SimpleWeb/Common/ReadHelper.cs.meta | 11 + .../SimpleWeb/SimpleWeb/Common/ReceiveLoop.cs | 253 + .../SimpleWeb/Common/ReceiveLoop.cs.meta | 11 + .../SimpleWeb/SimpleWeb/Common/Request.cs | 26 + .../SimpleWeb/Common/Request.cs.meta | 11 + .../SimpleWeb/SimpleWeb/Common/SendLoop.cs | 225 + .../SimpleWeb/Common/SendLoop.cs.meta | 11 + .../SimpleWeb/SimpleWeb/Common/TcpConfig.cs | 26 + .../SimpleWeb/Common/TcpConfig.cs.meta | 11 + .../SimpleWeb/SimpleWeb/Common/Utils.cs | 13 + .../SimpleWeb/SimpleWeb/Common/Utils.cs.meta | 11 + .../Transports/SimpleWeb/SimpleWeb/LICENSE | 21 + .../SimpleWeb/SimpleWeb/LICENSE.meta | 7 + .../Transports/SimpleWeb/SimpleWeb/README.txt | 19 + .../SimpleWeb/SimpleWeb/README.txt.meta | 7 + .../SimpleWeb/SimpleWeb/Server.meta | 8 + .../SimpleWeb/Server/ServerHandshake.cs | 156 + .../SimpleWeb/Server/ServerHandshake.cs.meta | 11 + .../SimpleWeb/Server/ServerSslHelper.cs | 74 + .../SimpleWeb/Server/ServerSslHelper.cs.meta | 11 + .../SimpleWeb/Server/SimpleWebServer.cs | 115 + .../SimpleWeb/Server/SimpleWebServer.cs.meta | 11 + .../SimpleWeb/Server/WebSocketServer.cs | 239 + .../SimpleWeb/Server/WebSocketServer.cs.meta | 11 + .../SimpleWeb/SimpleWebTransport.asmdef | 14 + .../SimpleWeb/SimpleWebTransport.asmdef.meta | 7 + .../SimpleWeb/SimpleWeb/SslConfigLoader.cs | 49 + .../SimpleWeb/SslConfigLoader.cs.meta | 11 + .../SimpleWeb/SimpleWebTransport.cs | 383 + .../SimpleWeb/SimpleWebTransport.cs.meta | 11 + Assets/Mirror/Transports/Telepathy.meta | 8 + .../Transports/Telepathy/Telepathy.meta | 8 + .../Transports/Telepathy/Telepathy/Client.cs | 361 + .../Telepathy/Telepathy/Client.cs.meta | 11 + .../Transports/Telepathy/Telepathy/Common.cs | 39 + .../Telepathy/Telepathy/Common.cs.meta | 11 + .../Telepathy/Telepathy/ConnectionState.cs | 35 + .../Telepathy/ConnectionState.cs.meta | 11 + .../Telepathy/Telepathy/EventType.cs | 9 + .../Telepathy/Telepathy/EventType.cs.meta | 11 + .../Transports/Telepathy/Telepathy/LICENSE | 21 + .../Telepathy/Telepathy/LICENSE.meta | 7 + .../Transports/Telepathy/Telepathy/Log.cs | 15 + .../Telepathy/Telepathy/Log.cs.meta | 11 + .../Telepathy/MagnificentReceivePipe.cs | 222 + .../Telepathy/MagnificentReceivePipe.cs.meta | 11 + .../Telepathy/MagnificentSendPipe.cs | 165 + .../Telepathy/MagnificentSendPipe.cs.meta | 11 + .../Telepathy/NetworkStreamExtensions.cs | 67 + .../Telepathy/NetworkStreamExtensions.cs.meta | 11 + .../Transports/Telepathy/Telepathy/Pool.cs | 34 + .../Telepathy/Telepathy/Pool.cs.meta | 11 + .../Transports/Telepathy/Telepathy/Server.cs | 401 + .../Telepathy/Telepathy/Server.cs.meta | 11 + .../Telepathy/Telepathy/Telepathy.asmdef | 12 + .../Telepathy/Telepathy/Telepathy.asmdef.meta | 7 + .../Telepathy/Telepathy/ThreadFunctions.cs | 244 + .../Telepathy/ThreadFunctions.cs.meta | 11 + .../Transports/Telepathy/Telepathy/Utils.cs | 23 + .../Telepathy/Telepathy/Utils.cs.meta | 11 + .../Transports/Telepathy/Telepathy/VERSION | 65 + .../Telepathy/Telepathy/VERSION.meta | 7 + .../Telepathy/TelepathyTransport.cs | 269 + .../Telepathy/TelepathyTransport.cs.meta | 11 + Assets/Mirror/Transports/Threaded.meta | 8 + .../Transports/Threaded/ThreadedTransport.cs | 655 + .../Threaded/ThreadedTransport.cs.meta | 11 + Assets/Mirror/Version.txt | 1 + Assets/Mirror/Version.txt.meta | 7 + Assets/ParrelSync.meta | 8 + Assets/ParrelSync/Examples.meta | 8 + .../Examples/CustomArgumentExample.cs | 31 + .../Examples/CustomArgumentExample.cs.meta | 11 + Assets/ParrelSync/LICENSE.md | 22 + Assets/ParrelSync/LICENSE.md.meta | 7 + Assets/ParrelSync/ParrelSync.meta | 8 + Assets/ParrelSync/ParrelSync/Editor.meta | 8 + .../ParrelSync/Editor/AssetModBlock.meta | 8 + .../Editor/AssetModBlock/EditorQuit.cs | 22 + .../Editor/AssetModBlock/EditorQuit.cs.meta | 11 + .../ParrelSyncAssetModificationProcessor.cs | 34 + ...rrelSyncAssetModificationProcessor.cs.meta | 11 + .../ParrelSync/Editor/ClonesManager.cs | 668 + .../ParrelSync/Editor/ClonesManager.cs.meta | 11 + .../ParrelSync/Editor/ClonesManagerWindow.cs | 198 + .../Editor/ClonesManagerWindow.cs.meta | 11 + .../ParrelSync/Editor/ExternalLinks.cs | 13 + .../ParrelSync/Editor/ExternalLinks.cs.meta | 11 + .../ParrelSync/Editor/FileUtilities.cs | 31 + .../ParrelSync/Editor/FileUtilities.cs.meta | 11 + .../ParrelSync/ParrelSync/Editor/NonCore.meta | 8 + .../Editor/NonCore/AskFeedbackDialog.cs | 78 + .../Editor/NonCore/AskFeedbackDialog.cs.meta | 11 + .../Editor/NonCore/OtherMenuItem.cs | 26 + .../Editor/NonCore/OtherMenuItem.cs.meta | 11 + .../ParrelSync/Editor/Preferences.cs | 110 + .../ParrelSync/Editor/Preferences.cs.meta | 11 + .../ParrelSync/ParrelSync/Editor/Project.cs | 112 + .../ParrelSync/Editor/Project.cs.meta | 11 + .../ParrelSync/Editor/UpdateChecker.cs | 60 + .../ParrelSync/Editor/UpdateChecker.cs.meta | 11 + .../Editor/ValidateCopiedFoldersIntegrity.cs | 73 + .../ValidateCopiedFoldersIntegrity.cs.meta | 11 + Assets/ParrelSync/ParrelSync/package.json | 10 + .../ParrelSync/ParrelSync/package.json.meta | 7 + .../ParrelSync/projectCloner.asmdef | 15 + .../ParrelSync/projectCloner.asmdef.meta | 7 + Assets/ParrelSync/README.md | 91 + Assets/ParrelSync/README.md.meta | 7 + Assets/ParrelSync/VERSION.txt | 1 + Assets/ParrelSync/VERSION.txt.meta | 7 + Assets/Prefabs.meta | 8 + Assets/Prefabs/Lobby_PlayerMesh.prefab | 131 + Assets/Prefabs/Lobby_PlayerMesh.prefab.meta | 7 + Assets/Prefabs/Player.prefab | 482 + Assets/Prefabs/Player.prefab.meta | 7 + Assets/Prefabs/UI.meta | 8 + Assets/Prefabs/UI/Buttom_Element.prefab | 333 + Assets/Prefabs/UI/Buttom_Element.prefab.meta | 7 + Assets/Prefabs/UI/Friend_Element.prefab | 361 + Assets/Prefabs/UI/Friend_Element.prefab.meta | 7 + Assets/Resources.meta | 8 + Assets/Resources/Markers.meta | 8 + Assets/Resources/Markers/Nametag_Marker.asset | 23 + .../Markers/Nametag_Marker.asset.meta | 8 + Assets/Resources/Markers/Party_Nametag.prefab | 553 + .../Markers/Party_Nametag.prefab.meta | 7 + Assets/Scenes.meta | 8 + Assets/Scenes/MainMenu.unity | 4753 ++++++ Assets/Scenes/MainMenu.unity.meta | 7 + Assets/Scenes/Stage_1.unity | 1514 ++ Assets/Scenes/Stage_1.unity.meta | 7 + Assets/Scripts.meta | 5 + Assets/Scripts/CharacterSkinElement.cs | 67 + Assets/Scripts/CharacterSkinElement.cs.meta | 11 + Assets/Scripts/CharacterSkinHandler.cs | 88 + Assets/Scripts/CharacterSkinHandler.cs.meta | 11 + Assets/Scripts/Extensions.meta | 8 + Assets/Scripts/Extensions/ArrayExtension.cs | 15 + .../Scripts/Extensions/ArrayExtension.cs.meta | 11 + .../Extensions/MonoBehaviourExtensions.cs | 49 + .../MonoBehaviourExtensions.cs.meta | 11 + Assets/Scripts/Extensions/SteamHelper.cs | 56 + Assets/Scripts/Extensions/SteamHelper.cs.meta | 11 + Assets/Scripts/FriendItem.cs | 62 + Assets/Scripts/FriendItem.cs.meta | 11 + Assets/Scripts/FriendListManager.cs | 102 + Assets/Scripts/FriendListManager.cs.meta | 11 + Assets/Scripts/LobbyController.cs | 53 + Assets/Scripts/LobbyController.cs.meta | 11 + Assets/Scripts/MainMenu.cs | 93 + Assets/Scripts/MainMenu.cs.meta | 11 + Assets/Scripts/Markers.meta | 8 + Assets/Scripts/Markers/Marker.cs | 54 + Assets/Scripts/Markers/Marker.cs.meta | 11 + Assets/Scripts/Markers/MarkerDefinition.cs | 18 + .../Scripts/Markers/MarkerDefinition.cs.meta | 11 + Assets/Scripts/Markers/MarkerHandler.cs | 89 + Assets/Scripts/Markers/MarkerHandler.cs.meta | 11 + Assets/Scripts/Markers/NametagMarker.cs | 25 + Assets/Scripts/Markers/NametagMarker.cs.meta | 11 + Assets/Scripts/Movement.cs | 94 + Assets/Scripts/Movement.cs.meta | 11 + Assets/Scripts/MyClient.cs | 133 + Assets/Scripts/MyClient.cs.meta | 11 + Assets/Scripts/MyNetworkManager.cs | 58 + Assets/Scripts/MyNetworkManager.cs.meta | 11 + Assets/Scripts/PopupManager.cs | 68 + Assets/Scripts/PopupManager.cs.meta | 11 + Assets/Scripts/SteamLobby.cs | 195 + Assets/Scripts/SteamLobby.cs.meta | 11 + Assets/Scripts/Steamworks.NET.meta | 5 + Assets/Scripts/Steamworks.NET/SteamManager.cs | 182 + .../Steamworks.NET/SteamManager.cs.meta | 8 + Assets/Scripts/Tools.meta | 8 + Assets/Scripts/Tools/SceneSwitcher.cs | 78 + Assets/Scripts/Tools/SceneSwitcher.cs.meta | 11 + Assets/Scripts/UIElements.meta | 8 + Assets/Settings.meta | 8 + Assets/Settings/SampleSceneProfile.asset | 123 + Assets/Settings/SampleSceneProfile.asset.meta | 8 + Assets/Settings/URP-Balanced-Renderer.asset | 76 + .../Settings/URP-Balanced-Renderer.asset.meta | 8 + Assets/Settings/URP-Balanced.asset | 136 + Assets/Settings/URP-Balanced.asset.meta | 8 + .../Settings/URP-HighFidelity-Renderer.asset | 91 + .../URP-HighFidelity-Renderer.asset.meta | 8 + Assets/Settings/URP-HighFidelity.asset | 136 + Assets/Settings/URP-HighFidelity.asset.meta | 8 + Assets/Settings/URP-Performant-Renderer.asset | 52 + .../URP-Performant-Renderer.asset.meta | 8 + Assets/Settings/URP-Performant.asset | 136 + Assets/Settings/URP-Performant.asset.meta | 8 + Assets/TextMesh Pro.meta | 8 + Assets/TextMesh Pro/Documentation.meta | 8 + .../TextMesh Pro User Guide 2016.pdf | Bin 0 -> 694398 bytes .../TextMesh Pro User Guide 2016.pdf.meta | 7 + Assets/TextMesh Pro/Examples & Extras.meta | 8 + .../TextMesh Pro/Examples & Extras/Fonts.meta | 8 + .../Examples & Extras/Fonts/Anton OFL.txt | 93 + .../Fonts/Anton OFL.txt.meta | 8 + .../Examples & Extras/Fonts/Anton.ttf | Bin 0 -> 42376 bytes .../Examples & Extras/Fonts/Anton.ttf.meta | 19 + .../Examples & Extras/Fonts/Bangers - OFL.txt | 93 + .../Fonts/Bangers - OFL.txt.meta | 8 + .../Examples & Extras/Fonts/Bangers.ttf | Bin 0 -> 39676 bytes .../Examples & Extras/Fonts/Bangers.ttf.meta | 19 + .../Fonts/Electronic Highway Sign.TTF | Bin 0 -> 73060 bytes .../Fonts/Electronic Highway Sign.TTF.meta | 22 + .../Fonts/Oswald-Bold - OFL.txt | 92 + .../Fonts/Oswald-Bold - OFL.txt.meta | 8 + .../Examples & Extras/Fonts/Oswald-Bold.ttf | Bin 0 -> 53056 bytes .../Fonts/Oswald-Bold.ttf.meta | 19 + .../Fonts/Roboto-Bold - AFL.txt | 202 + .../Fonts/Roboto-Bold - AFL.txt.meta | 8 + .../Fonts/Roboto-Bold - License.txt | 3 + .../Fonts/Roboto-Bold - License.txt.meta | 8 + .../Examples & Extras/Fonts/Roboto-Bold.ttf | Bin 0 -> 170760 bytes .../Fonts/Roboto-Bold.ttf.meta | 22 + .../Examples & Extras/Fonts/Unity - OFL.txt | 92 + .../Fonts/Unity - OFL.txt.meta | 8 + .../Examples & Extras/Fonts/Unity.ttf | Bin 0 -> 1644 bytes .../Examples & Extras/Fonts/Unity.ttf.meta | 21 + .../Examples & Extras/Materials.meta | 9 + .../Crate - Surface Shader Scene.mat | 84 + .../Crate - Surface Shader Scene.mat.meta | 6 + .../Materials/Crate - URP.mat | 138 + .../Materials/Crate - URP.mat.meta | 8 + .../Materials/Ground - Logo Scene.mat | 207 + .../Materials/Ground - Logo Scene.mat.meta | 6 + .../Ground - Surface Shader Scene.mat | 112 + .../Ground - Surface Shader Scene.mat.meta | 6 + .../Materials/Ground - URP.mat | 173 + .../Materials/Ground - URP.mat.meta | 8 + .../Materials/Small Crate_diffuse.mat | 127 + .../Materials/Small Crate_diffuse.mat.meta | 8 + .../Examples & Extras/Prefabs.meta | 9 + .../Prefabs/Text Popup.prefab | 280 + .../Prefabs/Text Popup.prefab.meta | 8 + .../Prefabs/TextMeshPro - Prefab 1.prefab | 219 + .../TextMeshPro - Prefab 1.prefab.meta | 6 + .../Prefabs/TextMeshPro - Prefab 2.prefab | 219 + .../TextMeshPro - Prefab 2.prefab.meta | 6 + .../Examples & Extras/Resources.meta | 9 + .../Resources/Color Gradient Presets.meta | 8 + .../Blue to Purple - Vertical.asset | 17 + .../Blue to Purple - Vertical.asset.meta | 8 + .../Dark to Light Green - Vertical.asset | 17 + .../Dark to Light Green - Vertical.asset.meta | 8 + .../Light to Dark Green - Vertical.asset | 17 + .../Light to Dark Green - Vertical.asset.meta | 8 + .../Yellow to Orange - Vertical.asset | 17 + .../Yellow to Orange - Vertical.asset.meta | 8 + .../Resources/Fonts & Materials.meta | 9 + .../Anton SDF - Drop Shadow.mat | 104 + .../Anton SDF - Drop Shadow.mat.meta | 8 + .../Fonts & Materials/Anton SDF - Outline.mat | 104 + .../Anton SDF - Outline.mat.meta | 8 + .../Anton SDF - Sunny Days.mat | 104 + .../Anton SDF - Sunny Days.mat.meta | 8 + .../Fonts & Materials/Anton SDF.asset | 318 + .../Fonts & Materials/Anton SDF.asset.meta | 8 + .../Bangers SDF - Drop Shadow - 2 Pass.mat | 112 + ...angers SDF - Drop Shadow - 2 Pass.mat.meta | 8 + .../Bangers SDF - Drop Shadow.mat | 110 + .../Bangers SDF - Drop Shadow.mat.meta | 8 + .../Bangers SDF - Outline.mat | 110 + .../Bangers SDF - Outline.mat.meta | 8 + .../Fonts & Materials/Bangers SDF Glow.mat | 113 + .../Bangers SDF Glow.mat.meta | 8 + .../Bangers SDF Logo - URP.mat | 151 + .../Bangers SDF Logo - URP.mat.meta | 8 + .../Fonts & Materials/Bangers SDF Logo.mat | 101 + .../Bangers SDF Logo.mat.meta | 6 + .../Fonts & Materials/Bangers SDF.asset | 302 + .../Fonts & Materials/Bangers SDF.asset.meta | 6 + .../Electronic Highway Sign SDF.asset | 302 + .../Electronic Highway Sign SDF.asset.meta | 8 + .../LiberationSans SDF - Metalic Green.mat | 104 + ...iberationSans SDF - Metalic Green.mat.meta | 8 + .../LiberationSans SDF - Overlay.mat | 62 + .../LiberationSans SDF - Overlay.mat.meta | 8 + .../LiberationSans SDF - Soft Mask.mat | 112 + .../LiberationSans SDF - Soft Mask.mat.meta | 8 + .../Fonts & Materials/Oswald Bold SDF.asset | 302 + .../Oswald Bold SDF.asset.meta | 8 + .../Roboto-Bold SDF - Drop Shadow.mat | 104 + .../Roboto-Bold SDF - Drop Shadow.mat.meta | 8 + .../Roboto-Bold SDF - HDRP Unlit.mat | 191 + .../Roboto-Bold SDF - HDRP Unlit.mat.meta | 8 + .../Roboto-Bold SDF - Surface.mat | 107 + .../Roboto-Bold SDF - Surface.mat.meta | 8 + .../Roboto-Bold SDF - URP.mat | 157 + .../Roboto-Bold SDF - URP.mat.meta | 8 + .../Fonts & Materials/Roboto-Bold SDF.asset | 302 + .../Roboto-Bold SDF.asset.meta | 8 + .../Unity SDF - HDRP LIT - Bloom.mat | 223 + .../Unity SDF - HDRP LIT - Bloom.mat.meta | 8 + .../Unity SDF - HDRP LIT - Outline.mat | 173 + .../Unity SDF - HDRP LIT - Outline.mat.meta | 8 + .../Fonts & Materials/Unity SDF.asset | 389 + .../Fonts & Materials/Unity SDF.asset.meta | 8 + .../Resources/Sprite Assets.meta | 9 + .../Sprite Assets/Default Sprite Asset.asset | 351 + .../Default Sprite Asset.asset.meta | 8 + .../Sprite Assets/DropCap Numbers.asset | 406 + .../Sprite Assets/DropCap Numbers.asset.meta | 8 + .../Examples & Extras/Scenes.meta | 9 + .../01- Single Line TextMesh Pro.unity | 380 + .../01- Single Line TextMesh Pro.unity.meta | 24 + .../Scenes/02 - Multi-line TextMesh Pro.unity | 384 + .../02 - Multi-line TextMesh Pro.unity.meta | 24 + .../Scenes/03 - Line Justification.unity | 896 ++ .../Scenes/03 - Line Justification.unity.meta | 24 + .../Scenes/04 - Word Wrapping.unity | 379 + .../Scenes/04 - Word Wrapping.unity.meta | 24 + .../Scenes/05 - Style Tags.unity | 1017 ++ .../Scenes/05 - Style Tags.unity.meta | 24 + .../06 - Extra Rich Text Examples.unity | 677 + .../06 - Extra Rich Text Examples.unity.meta | 6 + ...07 - Superscript & Subscript Example.unity | 383 + ...Superscript & Subscript Example.unity.meta | 24 + .../Scenes/08 - Improved Text Alignment.unity | 544 + .../08 - Improved Text Alignment.unity.meta | 6 + .../Scenes/09 - Margin Tag Example.unity | 945 ++ .../Scenes/09 - Margin Tag Example.unity.meta | 8 + ...10 - Bullets & Numbered List Example.unity | 665 + ...Bullets & Numbered List Example.unity.meta | 8 + .../Scenes/11 - The Style Tag.unity | 554 + .../Scenes/11 - The Style Tag.unity.meta | 8 + .../Scenes/12 - Link Example.unity | 779 + .../Scenes/12 - Link Example.unity.meta | 8 + .../Scenes/12a - Text Interactions.unity | 807 ++ .../Scenes/12a - Text Interactions.unity.meta | 8 + .../Scenes/13 - Soft Hyphenation.unity | 507 + .../Scenes/13 - Soft Hyphenation.unity.meta | 8 + .../Scenes/14 - Multi Font & Sprites.unity | 544 + .../14 - Multi Font & Sprites.unity.meta | 8 + .../15 - Inline Graphics & Sprites.unity | 595 + .../15 - Inline Graphics & Sprites.unity.meta | 6 + ... - Linked text overflow mode example.unity | 1063 ++ ...nked text overflow mode example.unity.meta | 8 + .../Scenes/17 - Old Computer Terminal.unity | 691 + .../17 - Old Computer Terminal.unity.meta | 8 + .../18 - ScrollRect & Masking & Layout.unity | 9490 ++++++++++++ ...- ScrollRect & Masking & Layout.unity.meta | 8 + .../19 - Masking Texture & Soft Mask.unity | 604 + ...9 - Masking Texture & Soft Mask.unity.meta | 8 + .../20 - Input Field with Scrollbar.unity | 2242 +++ ...20 - Input Field with Scrollbar.unity.meta | 8 + .../Scenes/21 - Script Example.unity | 239 + .../Scenes/21 - Script Example.unity.meta | 24 + .../Scenes/22 - Basic Scripting Example.unity | 447 + .../22 - Basic Scripting Example.unity.meta | 8 + .../23 - Animating Vertex Attributes.unity | 520 + ...3 - Animating Vertex Attributes.unity.meta | 8 + .../24 - Surface Shader Example URP.unity | 3160 ++++ ...24 - Surface Shader Example URP.unity.meta | 24 + .../Scenes/24 - Surface Shader Example.unity | 2687 ++++ .../24 - Surface Shader Example.unity.meta | 24 + .../Scenes/25 - Sunny Days Example.unity | 615 + .../Scenes/25 - Sunny Days Example.unity.meta | 8 + .../26 - Dropdown Placeholder Example.unity | 3418 +++++ ... - Dropdown Placeholder Example.unity.meta | 7 + .../27 - Double Pass Shader Example.unity | 550 + ...27 - Double Pass Shader Example.unity.meta | 7 + .../Scenes/28 - HDRP Shader Example.meta | 8 + .../Scenes/28 - HDRP Shader Example.unity | 2262 +++ .../28 - HDRP Shader Example.unity.meta | 7 + .../Sky and Fog Volume Profile.asset | 60 + .../Sky and Fog Volume Profile.asset.meta | 8 + .../Scenes/Benchmark (Floating Text).unity | 429 + .../Benchmark (Floating Text).unity.meta | 24 + .../Examples & Extras/Scripts.meta | 9 + .../Examples & Extras/Scripts/Benchmark01.cs | 128 + .../Scripts/Benchmark01.cs.meta | 10 + .../Scripts/Benchmark01_UGUI.cs | 135 + .../Scripts/Benchmark01_UGUI.cs.meta | 10 + .../Examples & Extras/Scripts/Benchmark02.cs | 97 + .../Scripts/Benchmark02.cs.meta | 11 + .../Examples & Extras/Scripts/Benchmark03.cs | 92 + .../Scripts/Benchmark03.cs.meta | 11 + .../Examples & Extras/Scripts/Benchmark04.cs | 85 + .../Scripts/Benchmark04.cs.meta | 11 + .../Scripts/CameraController.cs | 292 + .../Scripts/CameraController.cs.meta | 10 + .../Scripts/ChatController.cs | 51 + .../Scripts/ChatController.cs.meta | 12 + .../Scripts/DropdownSample.cs | 19 + .../Scripts/DropdownSample.cs.meta | 11 + .../Scripts/EnvMapAnimator.cs | 35 + .../Scripts/EnvMapAnimator.cs.meta | 12 + .../Examples & Extras/Scripts/ObjectSpin.cs | 67 + .../Scripts/ObjectSpin.cs.meta | 10 + .../Scripts/ShaderPropAnimator.cs | 51 + .../Scripts/ShaderPropAnimator.cs.meta | 10 + .../Examples & Extras/Scripts/SimpleScript.cs | 58 + .../Scripts/SimpleScript.cs.meta | 10 + .../Scripts/SkewTextExample.cs | 158 + .../Scripts/SkewTextExample.cs.meta | 12 + .../Scripts/TMP_DigitValidator.cs | 27 + .../Scripts/TMP_DigitValidator.cs.meta | 12 + .../Scripts/TMP_ExampleScript_01.cs | 64 + .../Scripts/TMP_ExampleScript_01.cs.meta | 12 + .../Scripts/TMP_FrameRateCounter.cs | 134 + .../Scripts/TMP_FrameRateCounter.cs.meta | 10 + .../Scripts/TMP_PhoneNumberValidator.cs | 105 + .../Scripts/TMP_PhoneNumberValidator.cs.meta | 12 + .../Scripts/TMP_TextEventCheck.cs | 73 + .../Scripts/TMP_TextEventCheck.cs.meta | 12 + .../Scripts/TMP_TextEventHandler.cs | 263 + .../Scripts/TMP_TextEventHandler.cs.meta | 12 + .../Scripts/TMP_TextInfoDebugTool.cs | 652 + .../Scripts/TMP_TextInfoDebugTool.cs.meta | 12 + .../Scripts/TMP_TextSelector_A.cs | 157 + .../Scripts/TMP_TextSelector_A.cs.meta | 12 + .../Scripts/TMP_TextSelector_B.cs | 547 + .../Scripts/TMP_TextSelector_B.cs.meta | 14 + .../Scripts/TMP_UiFrameRateCounter.cs | 125 + .../Scripts/TMP_UiFrameRateCounter.cs.meta | 12 + .../Scripts/TMPro_InstructionOverlay.cs | 84 + .../Scripts/TMPro_InstructionOverlay.cs.meta | 10 + .../Examples & Extras/Scripts/TeleType.cs | 83 + .../Scripts/TeleType.cs.meta | 10 + .../Scripts/TextConsoleSimulator.cs | 121 + .../Scripts/TextConsoleSimulator.cs.meta | 12 + .../Scripts/TextMeshProFloatingText.cs | 223 + .../Scripts/TextMeshProFloatingText.cs.meta | 11 + .../Scripts/TextMeshSpawner.cs | 79 + .../Scripts/TextMeshSpawner.cs.meta | 11 + .../Scripts/VertexColorCycler.cs | 84 + .../Scripts/VertexColorCycler.cs.meta | 12 + .../Examples & Extras/Scripts/VertexJitter.cs | 175 + .../Scripts/VertexJitter.cs.meta | 12 + .../Examples & Extras/Scripts/VertexShakeA.cs | 161 + .../Scripts/VertexShakeA.cs.meta | 12 + .../Examples & Extras/Scripts/VertexShakeB.cs | 185 + .../Scripts/VertexShakeB.cs.meta | 12 + .../Examples & Extras/Scripts/VertexZoom.cs | 192 + .../Scripts/VertexZoom.cs.meta | 12 + .../Scripts/WarpTextExample.cs | 144 + .../Scripts/WarpTextExample.cs.meta | 12 + .../Examples & Extras/Sprites.meta | 9 + .../Sprites/Default Sprites.png | Bin 0 -> 178491 bytes .../Sprites/Default Sprites.png.meta | 437 + .../Sprites/DropCap Numbers.psd | Bin 0 -> 482546 bytes .../Sprites/DropCap Numbers.psd.meta | 166 + .../Examples & Extras/Textures.meta | 9 + .../Textures/Brushed Metal 3.jpg | Bin 0 -> 28175 bytes .../Textures/Brushed Metal 3.jpg.meta | 53 + .../Textures/Floor Cement.jpg | Bin 0 -> 71537 bytes .../Textures/Floor Cement.jpg.meta | 53 + .../Textures/Floor Tiles 1 - diffuse.jpg | Bin 0 -> 155648 bytes .../Textures/Floor Tiles 1 - diffuse.jpg.meta | 53 + .../Textures/Fruit Jelly (B&W).jpg | Bin 0 -> 150089 bytes .../Textures/Fruit Jelly (B&W).jpg.meta | 53 + .../Textures/Gradient Diagonal (Color).jpg | Bin 0 -> 11688 bytes .../Gradient Diagonal (Color).jpg.meta | 57 + .../Textures/Gradient Horizontal (Color).jpg | Bin 0 -> 11341 bytes .../Gradient Horizontal (Color).jpg.meta | 53 + .../Textures/Gradient Vertical (Color).jpg | Bin 0 -> 11336 bytes .../Gradient Vertical (Color).jpg.meta | 53 + .../Textures/Mask Zig-n-Zag.psd | Bin 0 -> 38488 bytes .../Textures/Mask Zig-n-Zag.psd.meta | 56 + .../Textures/Small Crate_diffuse.jpg | Bin 0 -> 95326 bytes .../Textures/Small Crate_diffuse.jpg.meta | 132 + .../Textures/Small Crate_normal.jpg | Bin 0 -> 126976 bytes .../Textures/Small Crate_normal.jpg.meta | 132 + .../Textures/Sunny Days - Seamless.jpg | Bin 0 -> 273488 bytes .../Textures/Sunny Days - Seamless.jpg.meta | 132 + .../Text Overflow - Linked Text Image 1.png | Bin 0 -> 26169 bytes ...xt Overflow - Linked Text Image 1.png.meta | 59 + ...t Overflow - Linked Text UI Screenshot.png | Bin 0 -> 49290 bytes ...rflow - Linked Text UI Screenshot.png.meta | 59 + .../Textures/Wipe Pattern - Circle.psd | Bin 0 -> 32696 bytes .../Textures/Wipe Pattern - Circle.psd.meta | 59 + .../Textures/Wipe Pattern - Diagonal.psd | Bin 0 -> 33064 bytes .../Textures/Wipe Pattern - Diagonal.psd.meta | 58 + .../Textures/Wipe Pattern - Radial Double.psd | Bin 0 -> 33155 bytes .../Wipe Pattern - Radial Double.psd.meta | 58 + .../Textures/Wipe Pattern - Radial Quad.psd | Bin 0 -> 34433 bytes .../Wipe Pattern - Radial Quad.psd.meta | 59 + Assets/TextMesh Pro/Fonts.meta | 8 + .../Fonts/LiberationSans - OFL.txt | 46 + .../Fonts/LiberationSans - OFL.txt.meta | 8 + Assets/TextMesh Pro/Fonts/LiberationSans.ttf | Bin 0 -> 350200 bytes .../Fonts/LiberationSans.ttf.meta | 19 + Assets/TextMesh Pro/Resources.meta | 8 + .../Resources/Fonts & Materials.meta | 9 + .../LiberationSans SDF - Drop Shadow.mat | 106 + .../LiberationSans SDF - Drop Shadow.mat.meta | 8 + .../LiberationSans SDF - Fallback.asset | 499 + .../LiberationSans SDF - Fallback.asset.meta | 8 + .../LiberationSans SDF - Outline.mat | 104 + .../LiberationSans SDF - Outline.mat.meta | 8 + .../LiberationSans SDF.asset | 7821 ++++++++++ .../LiberationSans SDF.asset.meta | 8 + .../LineBreaking Following Characters.txt | 1 + ...LineBreaking Following Characters.txt.meta | 8 + .../LineBreaking Leading Characters.txt | 1 + .../LineBreaking Leading Characters.txt.meta | 8 + .../TextMesh Pro/Resources/Sprite Assets.meta | 9 + .../Resources/Sprite Assets/EmojiOne.asset | 659 + .../Sprite Assets/EmojiOne.asset.meta | 8 + .../TextMesh Pro/Resources/Style Sheets.meta | 9 + .../Style Sheets/Default Style Sheet.asset | 81 + .../Default Style Sheet.asset.meta | 8 + .../TextMesh Pro/Resources/TMP Settings.asset | 52 + .../Resources/TMP Settings.asset.meta | 8 + Assets/TextMesh Pro/Shaders.meta | 8 + Assets/TextMesh Pro/Shaders/SDFFunctions.hlsl | 178 + .../Shaders/SDFFunctions.hlsl.meta | 10 + .../Shaders/TMP_Bitmap-Custom-Atlas.shader | 145 + .../TMP_Bitmap-Custom-Atlas.shader.meta | 9 + .../Shaders/TMP_Bitmap-Mobile.shader | 155 + .../Shaders/TMP_Bitmap-Mobile.shader.meta | 9 + Assets/TextMesh Pro/Shaders/TMP_Bitmap.shader | 145 + .../Shaders/TMP_Bitmap.shader.meta | 9 + .../Shaders/TMP_SDF Overlay.shader | 326 + .../Shaders/TMP_SDF Overlay.shader.meta | 9 + .../TextMesh Pro/Shaders/TMP_SDF SSD.shader | 321 + .../Shaders/TMP_SDF SSD.shader.meta | 9 + .../Shaders/TMP_SDF-HDRP LIT.shadergraph | 12074 ++++++++++++++++ .../Shaders/TMP_SDF-HDRP LIT.shadergraph.meta | 10 + .../Shaders/TMP_SDF-HDRP UNLIT.shadergraph | 11759 +++++++++++++++ .../TMP_SDF-HDRP UNLIT.shadergraph.meta | 10 + .../Shaders/TMP_SDF-Mobile Masking.shader | 258 + .../TMP_SDF-Mobile Masking.shader.meta | 9 + .../Shaders/TMP_SDF-Mobile Overlay.shader | 252 + .../TMP_SDF-Mobile Overlay.shader.meta | 9 + .../Shaders/TMP_SDF-Mobile SSD.shader | 106 + .../Shaders/TMP_SDF-Mobile SSD.shader.meta | 9 + .../Shaders/TMP_SDF-Mobile-2-Pass.shader | 389 + .../Shaders/TMP_SDF-Mobile-2-Pass.shader.meta | 9 + .../Shaders/TMP_SDF-Mobile.shader | 250 + .../Shaders/TMP_SDF-Mobile.shader.meta | 9 + .../Shaders/TMP_SDF-Surface-Mobile.shader | 139 + .../TMP_SDF-Surface-Mobile.shader.meta | 9 + .../Shaders/TMP_SDF-Surface.shader | 159 + .../Shaders/TMP_SDF-Surface.shader.meta | 9 + .../Shaders/TMP_SDF-URP Lit.shadergraph | 11932 +++++++++++++++ .../Shaders/TMP_SDF-URP Lit.shadergraph.meta | 10 + .../Shaders/TMP_SDF-URP Unlit.shadergraph | 11629 +++++++++++++++ .../TMP_SDF-URP Unlit.shadergraph.meta | 10 + Assets/TextMesh Pro/Shaders/TMP_SDF.shader | 326 + .../TextMesh Pro/Shaders/TMP_SDF.shader.meta | 9 + Assets/TextMesh Pro/Shaders/TMP_Sprite.shader | 131 + .../Shaders/TMP_Sprite.shader.meta | 9 + Assets/TextMesh Pro/Shaders/TMPro.cginc | 84 + Assets/TextMesh Pro/Shaders/TMPro.cginc.meta | 9 + .../TextMesh Pro/Shaders/TMPro_Mobile.cginc | 165 + .../Shaders/TMPro_Mobile.cginc.meta | 9 + .../Shaders/TMPro_Properties.cginc | 80 + .../Shaders/TMPro_Properties.cginc.meta | 9 + .../TextMesh Pro/Shaders/TMPro_Surface.cginc | 99 + .../Shaders/TMPro_Surface.cginc.meta | 9 + Assets/TextMesh Pro/Sprites.meta | 8 + .../Sprites/EmojiOne Attribution.txt | 3 + .../Sprites/EmojiOne Attribution.txt.meta | 7 + Assets/TextMesh Pro/Sprites/EmojiOne.json | 156 + .../TextMesh Pro/Sprites/EmojiOne.json.meta | 8 + Assets/TextMesh Pro/Sprites/EmojiOne.png | Bin 0 -> 112319 bytes Assets/TextMesh Pro/Sprites/EmojiOne.png.meta | 431 + ...niversalRenderPipelineGlobalSettings.asset | 346 + ...salRenderPipelineGlobalSettings.asset.meta | 8 + Assets/com.rlabrecque.steamworks.net.meta | 8 + .../com.rlabrecque.steamworks.net/Editor.meta | 8 + .../Editor/RedistCopy.cs | 76 + .../Editor/RedistCopy.cs.meta | 11 + .../Editor/RedistInstall.cs | 70 + .../Editor/RedistInstall.cs.meta | 11 + ...om.rlabrecque.steamworks.net.editor.asmdef | 18 + ...abrecque.steamworks.net.editor.asmdef.meta | 7 + .../com.rlabrecque.steamworks.net/LICENSE.md | 21 + .../LICENSE.md.meta | 7 + .../Plugins.meta | 8 + .../Plugins/libsteam_api.so | Bin 0 -> 391056 bytes .../Plugins/libsteam_api.so.meta | 64 + .../Plugins/steam_api.bundle.meta | 65 + .../Plugins/steam_api.bundle/Contents.meta | 8 + .../steam_api.bundle/Contents/Info.plist | 38 + .../steam_api.bundle/Contents/Info.plist.meta | 7 + .../steam_api.bundle/Contents/MacOS.meta | 8 + .../Contents/MacOS/libsteam_api.dylib | Bin 0 -> 610496 bytes .../Contents/MacOS/libsteam_api.dylib.meta | 7 + .../Plugins/steam_api.dll | Bin 0 -> 266600 bytes .../Plugins/steam_api.dll.meta | 64 + .../Plugins/steam_api64.dll | Bin 0 -> 298856 bytes .../Plugins/steam_api64.dll.meta | 64 + .../com.rlabrecque.steamworks.net/README.md | 15 + .../README.md.meta | 7 + .../Runtime.meta | 8 + .../Runtime/CallbackDispatcher.cs | 400 + .../Runtime/CallbackDispatcher.cs.meta | 11 + .../Runtime/CallbackIdentity.cs | 35 + .../Runtime/CallbackIdentity.cs.meta | 11 + .../Runtime/ISteamMatchmakingResponses.cs | 490 + .../ISteamMatchmakingResponses.cs.meta | 11 + .../Runtime/InteropHelp.cs | 267 + .../Runtime/InteropHelp.cs.meta | 11 + .../Runtime/Packsize.cs | 71 + .../Runtime/Packsize.cs.meta | 11 + .../Runtime/Steam.cs | 568 + .../Runtime/Steam.cs.meta | 11 + .../Runtime/Version.cs | 24 + .../Runtime/Version.cs.meta | 11 + .../Runtime/autogen.meta | 8 + .../Runtime/autogen/NativeMethods.cs | 3337 +++++ .../Runtime/autogen/NativeMethods.cs.meta | 11 + .../Runtime/autogen/SteamCallbacks.cs | 2939 ++++ .../Runtime/autogen/SteamCallbacks.cs.meta | 11 + .../Runtime/autogen/SteamConstants.cs | 330 + .../Runtime/autogen/SteamConstants.cs.meta | 11 + .../Runtime/autogen/SteamEnums.cs | 2787 ++++ .../Runtime/autogen/SteamEnums.cs.meta | 11 + .../Runtime/autogen/SteamStructs.cs | 452 + .../Runtime/autogen/SteamStructs.cs.meta | 11 + .../Runtime/autogen/isteamapplist.cs | 63 + .../Runtime/autogen/isteamapplist.cs.meta | 11 + .../Runtime/autogen/isteamapps.cs | 277 + .../Runtime/autogen/isteamapps.cs.meta | 11 + .../Runtime/autogen/isteamclient.cs | 376 + .../Runtime/autogen/isteamclient.cs.meta | 11 + .../Runtime/autogen/isteamfriends.cs | 688 + .../Runtime/autogen/isteamfriends.cs.meta | 11 + .../Runtime/autogen/isteamgameserver.cs | 450 + .../Runtime/autogen/isteamgameserver.cs.meta | 11 + .../Runtime/autogen/isteamgameserverclient.cs | 376 + .../autogen/isteamgameserverclient.cs.meta | 11 + .../Runtime/autogen/isteamgameserverhttp.cs | 277 + .../autogen/isteamgameserverhttp.cs.meta | 11 + .../autogen/isteamgameserverinventory.cs | 478 + .../autogen/isteamgameserverinventory.cs.meta | 11 + .../autogen/isteamgameservernetworking.cs | 270 + .../isteamgameservernetworking.cs.meta | 11 + .../isteamgameservernetworkingsockets.cs | 1111 ++ .../isteamgameservernetworkingsockets.cs.meta | 11 + .../isteamgameservernetworkingutils.cs | 444 + .../isteamgameservernetworkingutils.cs.meta | 11 + .../Runtime/autogen/isteamgameserverstats.cs | 110 + .../autogen/isteamgameserverstats.cs.meta | 11 + .../Runtime/autogen/isteamgameserverugc.cs | 709 + .../autogen/isteamgameserverugc.cs.meta | 11 + .../Runtime/autogen/isteamgameserverutils.cs | 356 + .../autogen/isteamgameserverutils.cs.meta | 11 + .../Runtime/autogen/isteamhtmlsurface.cs | 341 + .../Runtime/autogen/isteamhtmlsurface.cs.meta | 11 + .../Runtime/autogen/isteamhttp.cs | 277 + .../Runtime/autogen/isteamhttp.cs.meta | 11 + .../Runtime/autogen/isteaminput.cs | 476 + .../Runtime/autogen/isteaminput.cs.meta | 11 + .../Runtime/autogen/isteaminventory.cs | 478 + .../Runtime/autogen/isteaminventory.cs.meta | 11 + .../Runtime/autogen/isteammatchmaking.cs | 892 ++ .../Runtime/autogen/isteammatchmaking.cs.meta | 11 + .../Runtime/autogen/isteammusic.cs | 69 + .../Runtime/autogen/isteammusic.cs.meta | 11 + .../Runtime/autogen/isteammusicremote.cs | 212 + .../Runtime/autogen/isteammusicremote.cs.meta | 11 + .../Runtime/autogen/isteamnetworking.cs | 270 + .../Runtime/autogen/isteamnetworking.cs.meta | 11 + .../autogen/isteamnetworkingmessages.cs | 139 + .../autogen/isteamnetworkingmessages.cs.meta | 11 + .../autogen/isteamnetworkingsockets.cs | 1111 ++ .../autogen/isteamnetworkingsockets.cs.meta | 11 + .../Runtime/autogen/isteamnetworkingutils.cs | 444 + .../autogen/isteamnetworkingutils.cs.meta | 11 + .../Runtime/autogen/isteamparentalsettings.cs | 51 + .../autogen/isteamparentalsettings.cs.meta | 11 + .../Runtime/autogen/isteamremoteplay.cs | 80 + .../Runtime/autogen/isteamremoteplay.cs.meta | 11 + .../Runtime/autogen/isteamremotestorage.cs | 434 + .../autogen/isteamremotestorage.cs.meta | 11 + .../Runtime/autogen/isteamscreenshots.cs | 111 + .../Runtime/autogen/isteamscreenshots.cs.meta | 11 + .../Runtime/autogen/isteamugc.cs | 709 + .../Runtime/autogen/isteamugc.cs.meta | 11 + .../Runtime/autogen/isteamuser.cs | 381 + .../Runtime/autogen/isteamuser.cs.meta | 11 + .../Runtime/autogen/isteamuserstats.cs | 474 + .../Runtime/autogen/isteamuserstats.cs.meta | 11 + .../Runtime/autogen/isteamutils.cs | 356 + .../Runtime/autogen/isteamutils.cs.meta | 11 + .../Runtime/autogen/isteamvideo.cs | 54 + .../Runtime/autogen/isteamvideo.cs.meta | 11 + .../com.rlabrecque.steamworks.net.asmdef | 20 + .../com.rlabrecque.steamworks.net.asmdef.meta | 7 + .../Runtime/types.meta | 8 + .../Runtime/types/MatchmakingTypes.meta | 8 + .../MatchmakingTypes/gameserveritem_t.cs | 106 + .../MatchmakingTypes/gameserveritem_t.cs.meta | 11 + .../types/MatchmakingTypes/servernetadr_t.cs | 116 + .../MatchmakingTypes/servernetadr_t.cs.meta | 11 + .../Runtime/types/SteamClient.meta | 8 + .../SteamAPIWarningMessageHook_t.cs | 22 + .../SteamAPIWarningMessageHook_t.cs.meta | 11 + .../SteamAPI_CheckCallbackRegistered_t.cs | 22 + ...SteamAPI_CheckCallbackRegistered_t.cs.meta | 11 + .../Runtime/types/SteamClientPublic.meta | 8 + .../types/SteamClientPublic/CGameID.cs | 154 + .../types/SteamClientPublic/CGameID.cs.meta | 11 + .../types/SteamClientPublic/CSteamID.cs | 269 + .../types/SteamClientPublic/CSteamID.cs.meta | 11 + .../types/SteamClientPublic/HAuthTicket.cs | 65 + .../SteamClientPublic/HAuthTicket.cs.meta | 11 + .../Runtime/types/SteamDatagramTickets.meta | 8 + .../SteamDatagramHostedAddress.cs | 44 + .../SteamDatagramHostedAddress.cs.meta | 11 + .../SteamDatagramRelayAuthTicket.cs | 144 + .../SteamDatagramRelayAuthTicket.cs.meta | 11 + .../Runtime/types/SteamFriends.meta | 8 + .../types/SteamFriends/FriendsGroupID_t.cs | 65 + .../SteamFriends/FriendsGroupID_t.cs.meta | 11 + .../Runtime/types/SteamHTMLSurface.meta | 8 + .../types/SteamHTMLSurface/HHTMLBrowser.cs | 65 + .../SteamHTMLSurface/HHTMLBrowser.cs.meta | 11 + .../Runtime/types/SteamHTTP.meta | 8 + .../SteamHTTP/HTTPCookieContainerHandle.cs | 65 + .../HTTPCookieContainerHandle.cs.meta | 11 + .../types/SteamHTTP/HTTPRequestHandle.cs | 65 + .../types/SteamHTTP/HTTPRequestHandle.cs.meta | 11 + .../Runtime/types/SteamInput.meta | 8 + .../SteamInput/InputActionSetHandle_t.cs | 64 + .../SteamInput/InputActionSetHandle_t.cs.meta | 11 + .../SteamInput/InputAnalogActionHandle_t.cs | 64 + .../InputAnalogActionHandle_t.cs.meta | 11 + .../SteamInput/InputDigitalActionHandle_t.cs | 64 + .../InputDigitalActionHandle_t.cs.meta | 11 + .../Runtime/types/SteamInput/InputHandle_t.cs | 64 + .../types/SteamInput/InputHandle_t.cs.meta | 11 + .../SteamInputActionEventCallbackPointer.cs | 22 + ...eamInputActionEventCallbackPointer.cs.meta | 11 + .../SteamInput/SteamInputActionEvent_t.cs | 65 + .../SteamInputActionEvent_t.cs.meta | 11 + .../Runtime/types/SteamInventory.meta | 8 + .../SteamInventory/SteamInventoryResult_t.cs | 65 + .../SteamInventoryResult_t.cs.meta | 11 + .../SteamInventoryUpdateHandle_t.cs | 65 + .../SteamInventoryUpdateHandle_t.cs.meta | 11 + .../types/SteamInventory/SteamItemDef_t.cs | 64 + .../SteamInventory/SteamItemDef_t.cs.meta | 11 + .../SteamInventory/SteamItemInstanceID_t.cs | 65 + .../SteamItemInstanceID_t.cs.meta | 11 + .../Runtime/types/SteamMatchmaking.meta | 8 + .../SteamMatchmaking/HServerListRequest.cs | 61 + .../HServerListRequest.cs.meta | 11 + .../types/SteamMatchmaking/HServerQuery.cs | 65 + .../SteamMatchmaking/HServerQuery.cs.meta | 11 + .../Runtime/types/SteamNetworking.meta | 8 + .../SteamNetworking/SNetListenSocket_t.cs | 64 + .../SNetListenSocket_t.cs.meta | 11 + .../types/SteamNetworking/SNetSocket_t.cs | 64 + .../SteamNetworking/SNetSocket_t.cs.meta | 11 + .../Runtime/types/SteamNetworkingSockets.meta | 8 + .../ISteamNetworkingConnectionSignaling.cs | 65 + ...SteamNetworkingConnectionSignaling.cs.meta | 11 + .../ISteamNetworkingSignalingRecvContext.cs | 65 + ...teamNetworkingSignalingRecvContext.cs.meta | 11 + .../Runtime/types/SteamNetworkingTypes.meta | 8 + .../FSteamNetworkingSocketsDebugOutput.cs | 23 + ...FSteamNetworkingSocketsDebugOutput.cs.meta | 11 + .../HSteamListenSocket.cs | 65 + .../HSteamListenSocket.cs.meta | 11 + .../HSteamNetConnection.cs | 65 + .../HSteamNetConnection.cs.meta | 11 + .../HSteamNetPollGroup.cs | 65 + .../HSteamNetPollGroup.cs.meta | 11 + .../SteamNetworkingConfigValue_t.cs | 64 + .../SteamNetworkingConfigValue_t.cs.meta | 11 + .../SteamNetworkingErrMsg.cs | 30 + .../SteamNetworkingErrMsg.cs.meta | 11 + .../SteamNetworkingIPAddr.cs | 114 + .../SteamNetworkingIPAddr.cs.meta | 11 + .../SteamNetworkingIdentity.cs | 212 + .../SteamNetworkingIdentity.cs.meta | 11 + .../SteamNetworkingMessage_t.cs | 124 + .../SteamNetworkingMessage_t.cs.meta | 11 + .../SteamNetworkingMicroseconds.cs | 64 + .../SteamNetworkingMicroseconds.cs.meta | 11 + .../SteamNetworkingPOPID.cs | 64 + .../SteamNetworkingPOPID.cs.meta | 11 + .../Runtime/types/SteamRemotePlay.meta | 8 + .../SteamRemotePlay/RemotePlaySessionID_t.cs | 64 + .../RemotePlaySessionID_t.cs.meta | 11 + .../Runtime/types/SteamRemoteStorage.meta | 8 + .../SteamRemoteStorage/PublishedFileId_t.cs | 65 + .../PublishedFileId_t.cs.meta | 11 + .../PublishedFileUpdateHandle_t.cs | 65 + .../PublishedFileUpdateHandle_t.cs.meta | 11 + .../UGCFileWriteStreamHandle_t.cs | 65 + .../UGCFileWriteStreamHandle_t.cs.meta | 11 + .../types/SteamRemoteStorage/UGCHandle_t.cs | 65 + .../SteamRemoteStorage/UGCHandle_t.cs.meta | 11 + .../Runtime/types/SteamScreenshots.meta | 8 + .../SteamScreenshots/ScreenshotHandle.cs | 65 + .../SteamScreenshots/ScreenshotHandle.cs.meta | 11 + .../Runtime/types/SteamTypes.meta | 8 + .../Runtime/types/SteamTypes/AccountID_t.cs | 64 + .../types/SteamTypes/AccountID_t.cs.meta | 11 + .../Runtime/types/SteamTypes/AppId_t.cs | 65 + .../Runtime/types/SteamTypes/AppId_t.cs.meta | 11 + .../Runtime/types/SteamTypes/DepotId_t.cs | 65 + .../types/SteamTypes/DepotId_t.cs.meta | 11 + .../types/SteamTypes/PartyBeaconID_t.cs | 65 + .../types/SteamTypes/PartyBeaconID_t.cs.meta | 11 + .../Runtime/types/SteamTypes/RTime32.cs | 64 + .../Runtime/types/SteamTypes/RTime32.cs.meta | 11 + .../types/SteamTypes/SteamAPICall_t.cs | 65 + .../types/SteamTypes/SteamAPICall_t.cs.meta | 11 + .../types/SteamTypes/SteamIPAddress_t.cs | 97 + .../types/SteamTypes/SteamIPAddress_t.cs.meta | 11 + .../Runtime/types/SteamUGC.meta | 8 + .../types/SteamUGC/UGCQueryHandle_t.cs | 65 + .../types/SteamUGC/UGCQueryHandle_t.cs.meta | 11 + .../types/SteamUGC/UGCUpdateHandle_t.cs | 65 + .../types/SteamUGC/UGCUpdateHandle_t.cs.meta | 11 + .../Runtime/types/SteamUserStats.meta | 8 + .../SteamLeaderboardEntries_t.cs | 64 + .../SteamLeaderboardEntries_t.cs.meta | 11 + .../SteamUserStats/SteamLeaderboard_t.cs | 64 + .../SteamUserStats/SteamLeaderboard_t.cs.meta | 11 + .../Runtime/types/Steam_api_common.meta | 8 + .../types/Steam_api_common/HSteamPipe.cs | 64 + .../types/Steam_api_common/HSteamPipe.cs.meta | 11 + .../types/Steam_api_common/HSteamUser.cs | 64 + .../types/Steam_api_common/HSteamUser.cs.meta | 11 + .../package.json | 21 + .../package.json.meta | 7 + Packages/manifest.json | 48 + Packages/packages-lock.json | 487 + ProjectSettings/AudioManager.asset | 19 + .../BurstAotSettings_StandaloneWindows.json | 16 + ProjectSettings/ClusterInputManager.asset | 6 + ProjectSettings/CommonBurstAotSettings.json | 6 + ProjectSettings/DynamicsManager.asset | 36 + ProjectSettings/EditorBuildSettings.asset | 14 + ProjectSettings/EditorSettings.asset | 35 + ProjectSettings/GraphicsSettings.asset | 70 + ProjectSettings/InputManager.asset | 487 + ProjectSettings/MemorySettings.asset | 35 + ProjectSettings/MultiplayerManager.asset | 7 + ProjectSettings/NavMeshAreas.asset | 91 + ProjectSettings/PackageManagerSettings.asset | 37 + ProjectSettings/Physics2DSettings.asset | 56 + ProjectSettings/PresetManager.asset | 7 + ProjectSettings/ProjectSettings.asset | 923 ++ ProjectSettings/ProjectVersion.txt | 2 + ProjectSettings/QualitySettings.asset | 136 + ProjectSettings/SceneTemplateSettings.json | 126 + ProjectSettings/ShaderGraphSettings.asset | 18 + ProjectSettings/TagManager.asset | 52 + ProjectSettings/TimeManager.asset | 9 + ProjectSettings/URPProjectSettings.asset | 15 + ProjectSettings/UnityConnectSettings.asset | 36 + ProjectSettings/VFXManager.asset | 12 + ProjectSettings/VersionControlSettings.asset | 8 + ProjectSettings/XRSettings.asset | 10 + README.md | 2 + steam_appid.txt | 1 + 1452 files changed, 214261 insertions(+) create mode 100644 .gitignore create mode 100644 .vscode/extensions.json create mode 100644 .vscode/launch.json create mode 100644 .vscode/settings.json create mode 100644 .vsconfig create mode 100644 Assets/DefaultVolumeProfile.asset create mode 100644 Assets/DefaultVolumeProfile.asset.meta create mode 100644 Assets/Materials.meta create mode 100644 Assets/Materials/black.mat create mode 100644 Assets/Materials/black.mat.meta create mode 100644 Assets/Mirror.meta create mode 100644 Assets/Mirror/Authenticators.meta create mode 100644 Assets/Mirror/Authenticators/BasicAuthenticator.cs create mode 100644 Assets/Mirror/Authenticators/BasicAuthenticator.cs.meta create mode 100644 Assets/Mirror/Authenticators/DeviceAuthenticator.cs create mode 100644 Assets/Mirror/Authenticators/DeviceAuthenticator.cs.meta create mode 100644 Assets/Mirror/Authenticators/Mirror.Authenticators.asmdef create mode 100644 Assets/Mirror/Authenticators/Mirror.Authenticators.asmdef.meta create mode 100644 Assets/Mirror/Authenticators/TimeoutAuthenticator.cs create mode 100644 Assets/Mirror/Authenticators/TimeoutAuthenticator.cs.meta create mode 100644 Assets/Mirror/CompilerSymbols.meta create mode 100644 Assets/Mirror/CompilerSymbols/Mirror.CompilerSymbols.asmdef create mode 100644 Assets/Mirror/CompilerSymbols/Mirror.CompilerSymbols.asmdef.meta create mode 100644 Assets/Mirror/CompilerSymbols/PreprocessorDefine.cs create mode 100644 Assets/Mirror/CompilerSymbols/PreprocessorDefine.cs.meta create mode 100644 Assets/Mirror/Components.meta create mode 100644 Assets/Mirror/Components/AssemblyInfo.cs create mode 100644 Assets/Mirror/Components/AssemblyInfo.cs.meta create mode 100644 Assets/Mirror/Components/Discovery.meta create mode 100644 Assets/Mirror/Components/Discovery/NetworkDiscovery.cs create mode 100644 Assets/Mirror/Components/Discovery/NetworkDiscovery.cs.meta create mode 100644 Assets/Mirror/Components/Discovery/NetworkDiscoveryBase.cs create mode 100644 Assets/Mirror/Components/Discovery/NetworkDiscoveryBase.cs.meta create mode 100644 Assets/Mirror/Components/Discovery/NetworkDiscoveryHUD.cs create mode 100644 Assets/Mirror/Components/Discovery/NetworkDiscoveryHUD.cs.meta create mode 100644 Assets/Mirror/Components/Discovery/ServerRequest.cs create mode 100644 Assets/Mirror/Components/Discovery/ServerRequest.cs.meta create mode 100644 Assets/Mirror/Components/Discovery/ServerResponse.cs create mode 100644 Assets/Mirror/Components/Discovery/ServerResponse.cs.meta create mode 100644 Assets/Mirror/Components/Experimental.meta create mode 100644 Assets/Mirror/Components/Experimental/NetworkLerpRigidbody.cs create mode 100644 Assets/Mirror/Components/Experimental/NetworkLerpRigidbody.cs.meta create mode 100644 Assets/Mirror/Components/Experimental/NetworkRigidbody.cs create mode 100644 Assets/Mirror/Components/Experimental/NetworkRigidbody.cs.meta create mode 100644 Assets/Mirror/Components/Experimental/NetworkRigidbody2D.cs create mode 100644 Assets/Mirror/Components/Experimental/NetworkRigidbody2D.cs.meta create mode 100644 Assets/Mirror/Components/GUIConsole.cs create mode 100644 Assets/Mirror/Components/GUIConsole.cs.meta create mode 100644 Assets/Mirror/Components/InterestManagement.meta create mode 100644 Assets/Mirror/Components/InterestManagement/Distance.meta create mode 100644 Assets/Mirror/Components/InterestManagement/Distance/DistanceInterestManagement.cs create mode 100644 Assets/Mirror/Components/InterestManagement/Distance/DistanceInterestManagement.cs.meta create mode 100644 Assets/Mirror/Components/InterestManagement/Distance/DistanceInterestManagementCustomRange.cs create mode 100644 Assets/Mirror/Components/InterestManagement/Distance/DistanceInterestManagementCustomRange.cs.meta create mode 100644 Assets/Mirror/Components/InterestManagement/Match.meta create mode 100644 Assets/Mirror/Components/InterestManagement/Match/MatchInterestManagement.cs create mode 100644 Assets/Mirror/Components/InterestManagement/Match/MatchInterestManagement.cs.meta create mode 100644 Assets/Mirror/Components/InterestManagement/Match/NetworkMatch.cs create mode 100644 Assets/Mirror/Components/InterestManagement/Match/NetworkMatch.cs.meta create mode 100644 Assets/Mirror/Components/InterestManagement/Scene.meta create mode 100644 Assets/Mirror/Components/InterestManagement/Scene/SceneInterestManagement.cs create mode 100644 Assets/Mirror/Components/InterestManagement/Scene/SceneInterestManagement.cs.meta create mode 100644 Assets/Mirror/Components/InterestManagement/SpatialHashing.meta create mode 100644 Assets/Mirror/Components/InterestManagement/SpatialHashing/Grid2D.cs create mode 100644 Assets/Mirror/Components/InterestManagement/SpatialHashing/Grid2D.cs.meta create mode 100644 Assets/Mirror/Components/InterestManagement/SpatialHashing/SpatialHashingInterestManagement.cs create mode 100644 Assets/Mirror/Components/InterestManagement/SpatialHashing/SpatialHashingInterestManagement.cs.meta create mode 100644 Assets/Mirror/Components/InterestManagement/Team.meta create mode 100644 Assets/Mirror/Components/InterestManagement/Team/NetworkTeam.cs create mode 100644 Assets/Mirror/Components/InterestManagement/Team/NetworkTeam.cs.meta create mode 100644 Assets/Mirror/Components/InterestManagement/Team/TeamInterestManagement.cs create mode 100644 Assets/Mirror/Components/InterestManagement/Team/TeamInterestManagement.cs.meta create mode 100644 Assets/Mirror/Components/LagCompensation.meta create mode 100644 Assets/Mirror/Components/LagCompensation/HistoryCollider.cs create mode 100644 Assets/Mirror/Components/LagCompensation/HistoryCollider.cs.meta create mode 100644 Assets/Mirror/Components/LagCompensation/LagCompensator.cs create mode 100644 Assets/Mirror/Components/LagCompensation/LagCompensator.cs.meta create mode 100644 Assets/Mirror/Components/Mirror.Components.asmdef create mode 100644 Assets/Mirror/Components/Mirror.Components.asmdef.meta create mode 100644 Assets/Mirror/Components/NetworkAnimator.cs create mode 100644 Assets/Mirror/Components/NetworkAnimator.cs.meta create mode 100644 Assets/Mirror/Components/NetworkDiagnosticsDebugger.cs create mode 100644 Assets/Mirror/Components/NetworkDiagnosticsDebugger.cs.meta create mode 100644 Assets/Mirror/Components/NetworkLobbyManager.cs create mode 100644 Assets/Mirror/Components/NetworkLobbyManager.cs.meta create mode 100644 Assets/Mirror/Components/NetworkLobbyPlayer.cs create mode 100644 Assets/Mirror/Components/NetworkLobbyPlayer.cs.meta create mode 100644 Assets/Mirror/Components/NetworkPingDisplay.cs create mode 100644 Assets/Mirror/Components/NetworkPingDisplay.cs.meta create mode 100644 Assets/Mirror/Components/NetworkRigidbody.meta create mode 100644 Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyReliable.cs create mode 100644 Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyReliable.cs.meta create mode 100644 Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyReliable2D.cs create mode 100644 Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyReliable2D.cs.meta create mode 100644 Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyUnreliable.cs create mode 100644 Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyUnreliable.cs.meta create mode 100644 Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyUnreliable2D.cs create mode 100644 Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyUnreliable2D.cs.meta create mode 100644 Assets/Mirror/Components/NetworkRoomManager.cs create mode 100644 Assets/Mirror/Components/NetworkRoomManager.cs.meta create mode 100644 Assets/Mirror/Components/NetworkRoomPlayer.cs create mode 100644 Assets/Mirror/Components/NetworkRoomPlayer.cs.meta create mode 100644 Assets/Mirror/Components/NetworkStatistics.cs create mode 100644 Assets/Mirror/Components/NetworkStatistics.cs.meta create mode 100644 Assets/Mirror/Components/NetworkTransform.meta create mode 100644 Assets/Mirror/Components/NetworkTransform/NetworkTransform.cs create mode 100644 Assets/Mirror/Components/NetworkTransform/NetworkTransform.cs.meta create mode 100644 Assets/Mirror/Components/NetworkTransform/NetworkTransformBase.cs create mode 100644 Assets/Mirror/Components/NetworkTransform/NetworkTransformBase.cs.meta create mode 100644 Assets/Mirror/Components/NetworkTransform/NetworkTransformChild.cs create mode 100644 Assets/Mirror/Components/NetworkTransform/NetworkTransformChild.cs.meta create mode 100644 Assets/Mirror/Components/NetworkTransform/NetworkTransformReliable.cs create mode 100644 Assets/Mirror/Components/NetworkTransform/NetworkTransformReliable.cs.meta create mode 100644 Assets/Mirror/Components/NetworkTransform/NetworkTransformUnreliable.cs create mode 100644 Assets/Mirror/Components/NetworkTransform/NetworkTransformUnreliable.cs.meta create mode 100644 Assets/Mirror/Components/NetworkTransform/TransformSnapshot.cs create mode 100644 Assets/Mirror/Components/NetworkTransform/TransformSnapshot.cs.meta create mode 100644 Assets/Mirror/Components/NetworkTransform/TransformSyncData.cs create mode 100644 Assets/Mirror/Components/NetworkTransform/TransformSyncData.cs.meta create mode 100644 Assets/Mirror/Components/PredictedRigidbody.meta create mode 100644 Assets/Mirror/Components/PredictedRigidbody/LocalGhostMaterial.mat create mode 100644 Assets/Mirror/Components/PredictedRigidbody/LocalGhostMaterial.mat.meta create mode 100644 Assets/Mirror/Components/PredictedRigidbody/PredictedRigidbody.cs create mode 100644 Assets/Mirror/Components/PredictedRigidbody/PredictedRigidbody.cs.meta create mode 100644 Assets/Mirror/Components/PredictedRigidbody/PredictedRigidbodyPhysicsGhost.cs create mode 100644 Assets/Mirror/Components/PredictedRigidbody/PredictedRigidbodyPhysicsGhost.cs.meta create mode 100644 Assets/Mirror/Components/PredictedRigidbody/PredictedRigidbodyRemoteGhost.cs create mode 100644 Assets/Mirror/Components/PredictedRigidbody/PredictedRigidbodyRemoteGhost.cs.meta create mode 100644 Assets/Mirror/Components/PredictedRigidbody/PredictionUtils.cs create mode 100644 Assets/Mirror/Components/PredictedRigidbody/PredictionUtils.cs.meta create mode 100644 Assets/Mirror/Components/PredictedRigidbody/RemoteGhostMaterial.mat create mode 100644 Assets/Mirror/Components/PredictedRigidbody/RemoteGhostMaterial.mat.meta create mode 100644 Assets/Mirror/Components/PredictedRigidbody/RigidbodyState.cs create mode 100644 Assets/Mirror/Components/PredictedRigidbody/RigidbodyState.cs.meta create mode 100644 Assets/Mirror/Components/RemoteStatistics.cs create mode 100644 Assets/Mirror/Components/RemoteStatistics.cs.meta create mode 100644 Assets/Mirror/Core.meta create mode 100644 Assets/Mirror/Core/AssemblyInfo.cs create mode 100644 Assets/Mirror/Core/AssemblyInfo.cs.meta create mode 100644 Assets/Mirror/Core/Attributes.cs create mode 100644 Assets/Mirror/Core/Attributes.cs.meta create mode 100644 Assets/Mirror/Core/Batching.meta create mode 100644 Assets/Mirror/Core/Batching/Batcher.cs create mode 100644 Assets/Mirror/Core/Batching/Batcher.cs.meta create mode 100644 Assets/Mirror/Core/Batching/Unbatcher.cs create mode 100644 Assets/Mirror/Core/Batching/Unbatcher.cs.meta create mode 100644 Assets/Mirror/Core/ConnectionQuality.cs create mode 100644 Assets/Mirror/Core/ConnectionQuality.cs.meta create mode 100644 Assets/Mirror/Core/HostMode.cs create mode 100644 Assets/Mirror/Core/HostMode.cs.meta create mode 100644 Assets/Mirror/Core/InterestManagement.cs create mode 100644 Assets/Mirror/Core/InterestManagement.cs.meta create mode 100644 Assets/Mirror/Core/InterestManagementBase.cs create mode 100644 Assets/Mirror/Core/InterestManagementBase.cs.meta create mode 100644 Assets/Mirror/Core/LagCompensation.meta create mode 100644 Assets/Mirror/Core/LagCompensation/Capture.cs create mode 100644 Assets/Mirror/Core/LagCompensation/Capture.cs.meta create mode 100644 Assets/Mirror/Core/LagCompensation/HistoryBounds.cs create mode 100644 Assets/Mirror/Core/LagCompensation/HistoryBounds.cs.meta create mode 100644 Assets/Mirror/Core/LagCompensation/LagCompensation.cs create mode 100644 Assets/Mirror/Core/LagCompensation/LagCompensation.cs.meta create mode 100644 Assets/Mirror/Core/LagCompensation/LagCompensationSettings.cs create mode 100644 Assets/Mirror/Core/LagCompensation/LagCompensationSettings.cs.meta create mode 100644 Assets/Mirror/Core/LagCompensation/MinMaxBounds.cs create mode 100644 Assets/Mirror/Core/LagCompensation/MinMaxBounds.cs.meta create mode 100644 Assets/Mirror/Core/LocalConnectionToClient.cs create mode 100644 Assets/Mirror/Core/LocalConnectionToClient.cs.meta create mode 100644 Assets/Mirror/Core/LocalConnectionToServer.cs create mode 100644 Assets/Mirror/Core/LocalConnectionToServer.cs.meta create mode 100644 Assets/Mirror/Core/Messages.cs create mode 100644 Assets/Mirror/Core/Messages.cs.meta create mode 100644 Assets/Mirror/Core/Mirror.asmdef create mode 100644 Assets/Mirror/Core/Mirror.asmdef.meta create mode 100644 Assets/Mirror/Core/NetworkAuthenticator.cs create mode 100644 Assets/Mirror/Core/NetworkAuthenticator.cs.meta create mode 100644 Assets/Mirror/Core/NetworkBehaviour.cs create mode 100644 Assets/Mirror/Core/NetworkBehaviour.cs.meta create mode 100644 Assets/Mirror/Core/NetworkBehaviourSyncVar.cs create mode 100644 Assets/Mirror/Core/NetworkBehaviourSyncVar.cs.meta create mode 100644 Assets/Mirror/Core/NetworkClient.cs create mode 100644 Assets/Mirror/Core/NetworkClient.cs.meta create mode 100644 Assets/Mirror/Core/NetworkClient_TimeInterpolation.cs create mode 100644 Assets/Mirror/Core/NetworkClient_TimeInterpolation.cs.meta create mode 100644 Assets/Mirror/Core/NetworkConnection.cs create mode 100644 Assets/Mirror/Core/NetworkConnection.cs.meta create mode 100644 Assets/Mirror/Core/NetworkConnectionToClient.cs create mode 100644 Assets/Mirror/Core/NetworkConnectionToClient.cs.meta create mode 100644 Assets/Mirror/Core/NetworkConnectionToServer.cs create mode 100644 Assets/Mirror/Core/NetworkConnectionToServer.cs.meta create mode 100644 Assets/Mirror/Core/NetworkDiagnostics.cs create mode 100644 Assets/Mirror/Core/NetworkDiagnostics.cs.meta create mode 100644 Assets/Mirror/Core/NetworkIdentity.cs create mode 100644 Assets/Mirror/Core/NetworkIdentity.cs.meta create mode 100644 Assets/Mirror/Core/NetworkLoop.cs create mode 100644 Assets/Mirror/Core/NetworkLoop.cs.meta create mode 100644 Assets/Mirror/Core/NetworkManager.cs create mode 100644 Assets/Mirror/Core/NetworkManager.cs.meta create mode 100644 Assets/Mirror/Core/NetworkManagerHUD.cs create mode 100644 Assets/Mirror/Core/NetworkManagerHUD.cs.meta create mode 100644 Assets/Mirror/Core/NetworkMessage.cs create mode 100644 Assets/Mirror/Core/NetworkMessage.cs.meta create mode 100644 Assets/Mirror/Core/NetworkMessages.cs create mode 100644 Assets/Mirror/Core/NetworkMessages.cs.meta create mode 100644 Assets/Mirror/Core/NetworkReader.cs create mode 100644 Assets/Mirror/Core/NetworkReader.cs.meta create mode 100644 Assets/Mirror/Core/NetworkReaderExtensions.cs create mode 100644 Assets/Mirror/Core/NetworkReaderExtensions.cs.meta create mode 100644 Assets/Mirror/Core/NetworkReaderPool.cs create mode 100644 Assets/Mirror/Core/NetworkReaderPool.cs.meta create mode 100644 Assets/Mirror/Core/NetworkReaderPooled.cs create mode 100644 Assets/Mirror/Core/NetworkReaderPooled.cs.meta create mode 100644 Assets/Mirror/Core/NetworkServer.cs create mode 100644 Assets/Mirror/Core/NetworkServer.cs.meta create mode 100644 Assets/Mirror/Core/NetworkStartPosition.cs create mode 100644 Assets/Mirror/Core/NetworkStartPosition.cs.meta create mode 100644 Assets/Mirror/Core/NetworkTime.cs create mode 100644 Assets/Mirror/Core/NetworkTime.cs.meta create mode 100644 Assets/Mirror/Core/NetworkWriter.cs create mode 100644 Assets/Mirror/Core/NetworkWriter.cs.meta create mode 100644 Assets/Mirror/Core/NetworkWriterExtensions.cs create mode 100644 Assets/Mirror/Core/NetworkWriterExtensions.cs.meta create mode 100644 Assets/Mirror/Core/NetworkWriterPool.cs create mode 100644 Assets/Mirror/Core/NetworkWriterPool.cs.meta create mode 100644 Assets/Mirror/Core/NetworkWriterPooled.cs create mode 100644 Assets/Mirror/Core/NetworkWriterPooled.cs.meta create mode 100644 Assets/Mirror/Core/PortTransport.cs create mode 100644 Assets/Mirror/Core/PortTransport.cs.meta create mode 100644 Assets/Mirror/Core/Prediction.meta create mode 100644 Assets/Mirror/Core/Prediction/Prediction.cs create mode 100644 Assets/Mirror/Core/Prediction/Prediction.cs.meta create mode 100644 Assets/Mirror/Core/RemoteCalls.cs create mode 100644 Assets/Mirror/Core/RemoteCalls.cs.meta create mode 100644 Assets/Mirror/Core/SnapshotInterpolation.meta create mode 100644 Assets/Mirror/Core/SnapshotInterpolation/Snapshot.cs create mode 100644 Assets/Mirror/Core/SnapshotInterpolation/Snapshot.cs.meta create mode 100644 Assets/Mirror/Core/SnapshotInterpolation/SnapshotInterpolation.cs create mode 100644 Assets/Mirror/Core/SnapshotInterpolation/SnapshotInterpolation.cs.meta create mode 100644 Assets/Mirror/Core/SnapshotInterpolation/SnapshotInterpolationSettings.cs create mode 100644 Assets/Mirror/Core/SnapshotInterpolation/SnapshotInterpolationSettings.cs.meta create mode 100644 Assets/Mirror/Core/SnapshotInterpolation/TimeSnapshot.cs create mode 100644 Assets/Mirror/Core/SnapshotInterpolation/TimeSnapshot.cs.meta create mode 100644 Assets/Mirror/Core/SyncDictionary.cs create mode 100644 Assets/Mirror/Core/SyncDictionary.cs.meta create mode 100644 Assets/Mirror/Core/SyncList.cs create mode 100644 Assets/Mirror/Core/SyncList.cs.meta create mode 100644 Assets/Mirror/Core/SyncObject.cs create mode 100644 Assets/Mirror/Core/SyncObject.cs.meta create mode 100644 Assets/Mirror/Core/SyncSet.cs create mode 100644 Assets/Mirror/Core/SyncSet.cs.meta create mode 100644 Assets/Mirror/Core/Threading.meta create mode 100644 Assets/Mirror/Core/Threading/ConcurrentNetworkWriterPool.cs create mode 100644 Assets/Mirror/Core/Threading/ConcurrentNetworkWriterPool.cs.meta create mode 100644 Assets/Mirror/Core/Threading/ConcurrentNetworkWriterPooled.cs create mode 100644 Assets/Mirror/Core/Threading/ConcurrentNetworkWriterPooled.cs.meta create mode 100644 Assets/Mirror/Core/Threading/ConcurrentPool.cs create mode 100644 Assets/Mirror/Core/Threading/ConcurrentPool.cs.meta create mode 100644 Assets/Mirror/Core/Threading/ThreadLog.cs create mode 100644 Assets/Mirror/Core/Threading/ThreadLog.cs.meta create mode 100644 Assets/Mirror/Core/Threading/WorkerThread.cs create mode 100644 Assets/Mirror/Core/Threading/WorkerThread.cs.meta create mode 100644 Assets/Mirror/Core/Tools.meta create mode 100644 Assets/Mirror/Core/Tools/AccurateInterval.cs create mode 100644 Assets/Mirror/Core/Tools/AccurateInterval.cs.meta create mode 100644 Assets/Mirror/Core/Tools/Compression.cs create mode 100644 Assets/Mirror/Core/Tools/Compression.cs.meta create mode 100644 Assets/Mirror/Core/Tools/DeltaCompression.cs create mode 100644 Assets/Mirror/Core/Tools/DeltaCompression.cs.meta create mode 100644 Assets/Mirror/Core/Tools/ExponentialMovingAverage.cs create mode 100644 Assets/Mirror/Core/Tools/ExponentialMovingAverage.cs.meta create mode 100644 Assets/Mirror/Core/Tools/Extensions.cs create mode 100644 Assets/Mirror/Core/Tools/Extensions.cs.meta create mode 100644 Assets/Mirror/Core/Tools/Mathd.cs create mode 100644 Assets/Mirror/Core/Tools/Mathd.cs.meta create mode 100644 Assets/Mirror/Core/Tools/Pool.cs create mode 100644 Assets/Mirror/Core/Tools/Pool.cs.meta create mode 100644 Assets/Mirror/Core/Tools/Readme.txt create mode 100644 Assets/Mirror/Core/Tools/Readme.txt.meta create mode 100644 Assets/Mirror/Core/Tools/TimeSample.cs create mode 100644 Assets/Mirror/Core/Tools/TimeSample.cs.meta create mode 100644 Assets/Mirror/Core/Tools/Utils.cs create mode 100644 Assets/Mirror/Core/Tools/Utils.cs.meta create mode 100644 Assets/Mirror/Core/Tools/Vector3Long.cs create mode 100644 Assets/Mirror/Core/Tools/Vector3Long.cs.meta create mode 100644 Assets/Mirror/Core/Transport.cs create mode 100644 Assets/Mirror/Core/Transport.cs.meta create mode 100644 Assets/Mirror/Core/TransportError.cs create mode 100644 Assets/Mirror/Core/TransportError.cs.meta create mode 100644 Assets/Mirror/Core/WeaverFuse.cs create mode 100644 Assets/Mirror/Core/WeaverFuse.cs.meta create mode 100644 Assets/Mirror/Editor.meta create mode 100644 Assets/Mirror/Editor/AndroidManifestHelper.cs create mode 100644 Assets/Mirror/Editor/AndroidManifestHelper.cs.meta create mode 100644 Assets/Mirror/Editor/EditorHelper.cs create mode 100644 Assets/Mirror/Editor/EditorHelper.cs.meta create mode 100644 Assets/Mirror/Editor/Icon.meta create mode 100644 Assets/Mirror/Editor/Icon/MirrorIcon.png create mode 100644 Assets/Mirror/Editor/Icon/MirrorIcon.png.meta create mode 100644 Assets/Mirror/Editor/InspectorHelper.cs create mode 100644 Assets/Mirror/Editor/InspectorHelper.cs.meta create mode 100644 Assets/Mirror/Editor/Mirror.Editor.asmdef create mode 100644 Assets/Mirror/Editor/Mirror.Editor.asmdef.meta create mode 100644 Assets/Mirror/Editor/NetworkBehaviourInspector.cs create mode 100644 Assets/Mirror/Editor/NetworkBehaviourInspector.cs.meta create mode 100644 Assets/Mirror/Editor/NetworkInformationPreview.cs create mode 100644 Assets/Mirror/Editor/NetworkInformationPreview.cs.meta create mode 100644 Assets/Mirror/Editor/NetworkManagerEditor.cs create mode 100644 Assets/Mirror/Editor/NetworkManagerEditor.cs.meta create mode 100644 Assets/Mirror/Editor/NetworkScenePostProcess.cs create mode 100644 Assets/Mirror/Editor/NetworkScenePostProcess.cs.meta create mode 100644 Assets/Mirror/Editor/ReadOnlyDrawer.cs create mode 100644 Assets/Mirror/Editor/ReadOnlyDrawer.cs.meta create mode 100644 Assets/Mirror/Editor/SceneDrawer.cs create mode 100644 Assets/Mirror/Editor/SceneDrawer.cs.meta create mode 100644 Assets/Mirror/Editor/SyncObjectCollectionsDrawer.cs create mode 100644 Assets/Mirror/Editor/SyncObjectCollectionsDrawer.cs.meta create mode 100644 Assets/Mirror/Editor/SyncVarAttributeDrawer.cs create mode 100644 Assets/Mirror/Editor/SyncVarAttributeDrawer.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver.meta create mode 100644 Assets/Mirror/Editor/Weaver/AssemblyInfo.cs create mode 100644 Assets/Mirror/Editor/Weaver/AssemblyInfo.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/EntryPoint.meta create mode 100644 Assets/Mirror/Editor/Weaver/EntryPoint/CompilationFinishedHook.cs create mode 100644 Assets/Mirror/Editor/Weaver/EntryPoint/CompilationFinishedHook.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/EntryPoint/CompilationFinishedLogger.cs create mode 100644 Assets/Mirror/Editor/Weaver/EntryPoint/CompilationFinishedLogger.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/EntryPoint/EnterPlayModeHook.cs create mode 100644 Assets/Mirror/Editor/Weaver/EntryPoint/EnterPlayModeHook.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor.meta create mode 100644 Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/CompiledAssemblyFromFile.cs create mode 100644 Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/CompiledAssemblyFromFile.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorAssemblyResolver.cs create mode 100644 Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorAssemblyResolver.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorFromFile.cs create mode 100644 Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorFromFile.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorHook.cs create mode 100644 Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorHook.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorLogger.cs create mode 100644 Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorLogger.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorReflectionImporter.cs create mode 100644 Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorReflectionImporter.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorReflectionImporterProvider.cs create mode 100644 Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorReflectionImporterProvider.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/Extensions.cs create mode 100644 Assets/Mirror/Editor/Weaver/Extensions.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/Helpers.cs create mode 100644 Assets/Mirror/Editor/Weaver/Helpers.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/Logger.cs create mode 100644 Assets/Mirror/Editor/Weaver/Logger.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/Processors.meta create mode 100644 Assets/Mirror/Editor/Weaver/Processors/CommandProcessor.cs create mode 100644 Assets/Mirror/Editor/Weaver/Processors/CommandProcessor.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/Processors/MethodProcessor.cs create mode 100644 Assets/Mirror/Editor/Weaver/Processors/MethodProcessor.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/Processors/MonoBehaviourProcessor.cs create mode 100644 Assets/Mirror/Editor/Weaver/Processors/MonoBehaviourProcessor.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/Processors/NetworkBehaviourProcessor.cs create mode 100644 Assets/Mirror/Editor/Weaver/Processors/NetworkBehaviourProcessor.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/Processors/ReaderWriterProcessor.cs create mode 100644 Assets/Mirror/Editor/Weaver/Processors/ReaderWriterProcessor.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/Processors/RpcProcessor.cs create mode 100644 Assets/Mirror/Editor/Weaver/Processors/RpcProcessor.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/Processors/ServerClientAttributeProcessor.cs create mode 100644 Assets/Mirror/Editor/Weaver/Processors/ServerClientAttributeProcessor.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/Processors/SyncObjectInitializer.cs create mode 100644 Assets/Mirror/Editor/Weaver/Processors/SyncObjectInitializer.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/Processors/SyncObjectProcessor.cs create mode 100644 Assets/Mirror/Editor/Weaver/Processors/SyncObjectProcessor.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/Processors/SyncVarAttributeAccessReplacer.cs create mode 100644 Assets/Mirror/Editor/Weaver/Processors/SyncVarAttributeAccessReplacer.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/Processors/SyncVarAttributeProcessor.cs create mode 100644 Assets/Mirror/Editor/Weaver/Processors/SyncVarAttributeProcessor.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/Processors/TargetRpcProcessor.cs create mode 100644 Assets/Mirror/Editor/Weaver/Processors/TargetRpcProcessor.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/Readers.cs create mode 100644 Assets/Mirror/Editor/Weaver/Readers.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/Resolvers.cs create mode 100644 Assets/Mirror/Editor/Weaver/Resolvers.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/SyncVarAccessLists.cs create mode 100644 Assets/Mirror/Editor/Weaver/SyncVarAccessLists.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/TypeReferenceComparer.cs create mode 100644 Assets/Mirror/Editor/Weaver/TypeReferenceComparer.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/Unity.Mirror.CodeGen.asmdef create mode 100644 Assets/Mirror/Editor/Weaver/Unity.Mirror.CodeGen.asmdef.meta create mode 100644 Assets/Mirror/Editor/Weaver/Weaver.cs create mode 100644 Assets/Mirror/Editor/Weaver/Weaver.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/WeaverExceptions.cs create mode 100644 Assets/Mirror/Editor/Weaver/WeaverExceptions.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/WeaverTypes.cs create mode 100644 Assets/Mirror/Editor/Weaver/WeaverTypes.cs.meta create mode 100644 Assets/Mirror/Editor/Weaver/Writers.cs create mode 100644 Assets/Mirror/Editor/Weaver/Writers.cs.meta create mode 100644 Assets/Mirror/Editor/Welcome.cs create mode 100644 Assets/Mirror/Editor/Welcome.cs.meta create mode 100644 Assets/Mirror/Notice.txt create mode 100644 Assets/Mirror/Notice.txt.meta create mode 100644 Assets/Mirror/Plugins.meta create mode 100644 Assets/Mirror/Plugins/BouncyCastle.meta create mode 100644 Assets/Mirror/Plugins/BouncyCastle/BouncyCastle.Cryptography.dll create mode 100644 Assets/Mirror/Plugins/BouncyCastle/BouncyCastle.Cryptography.dll.meta create mode 100644 Assets/Mirror/Plugins/BouncyCastle/LICENSE.md create mode 100644 Assets/Mirror/Plugins/BouncyCastle/LICENSE.md.meta create mode 100644 Assets/Mirror/Plugins/Mono.Cecil.meta create mode 100644 Assets/Mirror/Plugins/Mono.Cecil/License.txt create mode 100644 Assets/Mirror/Plugins/Mono.Cecil/License.txt.meta create mode 100644 Assets/Mirror/Plugins/Mono.Cecil/Mono.CecilX.Mdb.dll create mode 100644 Assets/Mirror/Plugins/Mono.Cecil/Mono.CecilX.Mdb.dll.meta create mode 100644 Assets/Mirror/Plugins/Mono.Cecil/Mono.CecilX.Pdb.dll create mode 100644 Assets/Mirror/Plugins/Mono.Cecil/Mono.CecilX.Pdb.dll.meta create mode 100644 Assets/Mirror/Plugins/Mono.Cecil/Mono.CecilX.Rocks.dll create mode 100644 Assets/Mirror/Plugins/Mono.Cecil/Mono.CecilX.Rocks.dll.meta create mode 100644 Assets/Mirror/Plugins/Mono.Cecil/Mono.CecilX.dll create mode 100644 Assets/Mirror/Plugins/Mono.Cecil/Mono.CecilX.dll.meta create mode 100644 Assets/Mirror/Presets.meta create mode 100644 Assets/Mirror/Presets/NetworkTransform.meta create mode 100644 Assets/Mirror/Presets/NetworkTransform/ClientAuth-Balanced.preset create mode 100644 Assets/Mirror/Presets/NetworkTransform/ClientAuth-Balanced.preset.meta create mode 100644 Assets/Mirror/Presets/NetworkTransform/ClientAuth-FastPaced.preset create mode 100644 Assets/Mirror/Presets/NetworkTransform/ClientAuth-FastPaced.preset.meta create mode 100644 Assets/Mirror/Presets/NetworkTransform/ClientAuth-VeryCasual.preset create mode 100644 Assets/Mirror/Presets/NetworkTransform/ClientAuth-VeryCasual.preset.meta create mode 100644 Assets/Mirror/Readme.txt create mode 100644 Assets/Mirror/Readme.txt.meta create mode 100644 Assets/Mirror/Runtime.meta create mode 100644 Assets/Mirror/Runtime/Transports.meta create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks.meta create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks/BidirectionalDictionary.cs create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks/BidirectionalDictionary.cs.meta create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks/FizzySteamworks.asmdef create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks/FizzySteamworks.asmdef.meta create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks/FizzySteamworks.cs create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks/FizzySteamworks.cs.meta create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks/IClient.cs create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks/IClient.cs.meta create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks/IServer.cs create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks/IServer.cs.meta create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks/LICENSE create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks/LICENSE.meta create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks/LegacyClient.cs create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks/LegacyClient.cs.meta create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks/LegacyCommon.cs create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks/LegacyCommon.cs.meta create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks/LegacyServer.cs create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks/LegacyServer.cs.meta create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks/NextClient.cs create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks/NextClient.cs.meta create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks/NextCommon.cs create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks/NextCommon.cs.meta create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks/NextServer.cs create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks/NextServer.cs.meta create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks/README.md create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks/README.md.meta create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks/package.json create mode 100644 Assets/Mirror/Runtime/Transports/FizzySteamworks/package.json.meta create mode 100644 Assets/Mirror/Transports.meta create mode 100644 Assets/Mirror/Transports/Edgegap.meta create mode 100644 Assets/Mirror/Transports/Edgegap/EdgegapRelay.meta create mode 100644 Assets/Mirror/Transports/Edgegap/EdgegapRelay/EdgegapKcpClient.cs create mode 100644 Assets/Mirror/Transports/Edgegap/EdgegapRelay/EdgegapKcpClient.cs.meta create mode 100644 Assets/Mirror/Transports/Edgegap/EdgegapRelay/EdgegapKcpServer.cs create mode 100644 Assets/Mirror/Transports/Edgegap/EdgegapRelay/EdgegapKcpServer.cs.meta create mode 100644 Assets/Mirror/Transports/Edgegap/EdgegapRelay/EdgegapKcpTransport.cs create mode 100644 Assets/Mirror/Transports/Edgegap/EdgegapRelay/EdgegapKcpTransport.cs.meta create mode 100644 Assets/Mirror/Transports/Edgegap/EdgegapRelay/Protocol.cs create mode 100644 Assets/Mirror/Transports/Edgegap/EdgegapRelay/Protocol.cs.meta create mode 100644 Assets/Mirror/Transports/Edgegap/EdgegapRelay/README.md create mode 100644 Assets/Mirror/Transports/Edgegap/EdgegapRelay/README.md.meta create mode 100644 Assets/Mirror/Transports/Edgegap/EdgegapRelay/RelayCredentialsFromArgs.cs create mode 100644 Assets/Mirror/Transports/Edgegap/EdgegapRelay/RelayCredentialsFromArgs.cs.meta create mode 100644 Assets/Mirror/Transports/Edgegap/edgegap.png create mode 100644 Assets/Mirror/Transports/Edgegap/edgegap.png.meta create mode 100644 Assets/Mirror/Transports/Encryption.meta create mode 100644 Assets/Mirror/Transports/Encryption/Editor.meta create mode 100644 Assets/Mirror/Transports/Encryption/Editor/EncryptionTransportEditor.asmdef create mode 100644 Assets/Mirror/Transports/Encryption/Editor/EncryptionTransportEditor.asmdef.meta create mode 100644 Assets/Mirror/Transports/Encryption/Editor/EncryptionTransportInspector.cs create mode 100644 Assets/Mirror/Transports/Encryption/Editor/EncryptionTransportInspector.cs.meta create mode 100644 Assets/Mirror/Transports/Encryption/EncryptedConnection.cs create mode 100644 Assets/Mirror/Transports/Encryption/EncryptedConnection.cs.meta create mode 100644 Assets/Mirror/Transports/Encryption/EncryptionCredentials.cs create mode 100644 Assets/Mirror/Transports/Encryption/EncryptionCredentials.cs.meta create mode 100644 Assets/Mirror/Transports/Encryption/EncryptionTransport.cs create mode 100644 Assets/Mirror/Transports/Encryption/EncryptionTransport.cs.meta create mode 100644 Assets/Mirror/Transports/Encryption/PubKeyInfo.cs create mode 100644 Assets/Mirror/Transports/Encryption/PubKeyInfo.cs.meta create mode 100644 Assets/Mirror/Transports/KCP.meta create mode 100644 Assets/Mirror/Transports/KCP/KcpTransport.cs create mode 100644 Assets/Mirror/Transports/KCP/KcpTransport.cs.meta create mode 100644 Assets/Mirror/Transports/KCP/ThreadedKcpTransport.cs create mode 100644 Assets/Mirror/Transports/KCP/ThreadedKcpTransport.cs.meta create mode 100644 Assets/Mirror/Transports/KCP/kcp2k.meta create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/KCP.asmdef create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/KCP.asmdef.meta create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/LICENSE.txt create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/LICENSE.txt.meta create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/VERSION.txt create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/VERSION.txt.meta create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/empty.meta create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/empty/KcpServerNonAlloc.cs create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/empty/KcpServerNonAlloc.cs.meta create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/highlevel.meta create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/highlevel/Common.cs create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/highlevel/Common.cs.meta create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/highlevel/ErrorCode.cs create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/highlevel/ErrorCode.cs.meta create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/highlevel/Extensions.cs create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/highlevel/Extensions.cs.meta create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/highlevel/KcpChannel.cs create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/highlevel/KcpChannel.cs.meta create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/highlevel/KcpClient.cs create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/highlevel/KcpClient.cs.meta create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/highlevel/KcpConfig.cs create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/highlevel/KcpConfig.cs.meta create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/highlevel/KcpHeader.cs create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/highlevel/KcpHeader.cs.meta create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/highlevel/KcpPeer.cs create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/highlevel/KcpPeer.cs.meta create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/highlevel/KcpServer.cs create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/highlevel/KcpServer.cs.meta create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/highlevel/KcpServerConnection.cs create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/highlevel/KcpServerConnection.cs.meta create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/highlevel/KcpState.cs create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/highlevel/KcpState.cs.meta create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/highlevel/Log.cs create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/highlevel/Log.cs.meta create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/kcp.meta create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/kcp/AckItem.cs create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/kcp/AckItem.cs.meta create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/kcp/AssemblyInfo.cs create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/kcp/AssemblyInfo.cs.meta create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/kcp/Kcp.cs create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/kcp/Kcp.cs.meta create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/kcp/Pool.cs create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/kcp/Pool.cs.meta create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/kcp/Segment.cs create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/kcp/Segment.cs.meta create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/kcp/Utils.cs create mode 100644 Assets/Mirror/Transports/KCP/kcp2k/kcp/Utils.cs.meta create mode 100644 Assets/Mirror/Transports/Latency.meta create mode 100644 Assets/Mirror/Transports/Latency/LatencySimulation.cs create mode 100644 Assets/Mirror/Transports/Latency/LatencySimulation.cs.meta create mode 100644 Assets/Mirror/Transports/Middleware.meta create mode 100644 Assets/Mirror/Transports/Middleware/MiddlewareTransport.cs create mode 100644 Assets/Mirror/Transports/Middleware/MiddlewareTransport.cs.meta create mode 100644 Assets/Mirror/Transports/Mirror.Transports.asmdef create mode 100644 Assets/Mirror/Transports/Mirror.Transports.asmdef.meta create mode 100644 Assets/Mirror/Transports/Multiplex.meta create mode 100644 Assets/Mirror/Transports/Multiplex/MultiplexTransport.cs create mode 100644 Assets/Mirror/Transports/Multiplex/MultiplexTransport.cs.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/Editor.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/Editor/ClientWebsocketSettingsDrawer.cs create mode 100644 Assets/Mirror/Transports/SimpleWeb/Editor/ClientWebsocketSettingsDrawer.cs.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/AssemblyInfo.cs create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/AssemblyInfo.cs.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/CHANGELOG.md create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/CHANGELOG.md.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Client.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Client/ClientWebsocketSettings.cs create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Client/ClientWebsocketSettings.cs.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Client/SimpleWebClient.cs create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Client/SimpleWebClient.cs.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Client/StandAlone.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Client/StandAlone/ClientHandshake.cs create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Client/StandAlone/ClientHandshake.cs.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Client/StandAlone/ClientSslHelper.cs create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Client/StandAlone/ClientSslHelper.cs.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Client/StandAlone/WebSocketClientStandAlone.cs create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Client/StandAlone/WebSocketClientStandAlone.cs.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Client/Webgl.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Client/Webgl/SimpleWebJSLib.cs create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Client/Webgl/SimpleWebJSLib.cs.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Client/Webgl/WebSocketClientWebGl.cs create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Client/Webgl/WebSocketClientWebGl.cs.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Client/Webgl/plugin.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Client/Webgl/plugin/SimpleWeb.jslib create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Client/Webgl/plugin/SimpleWeb.jslib.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Common.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Common/BufferPool.cs create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Common/BufferPool.cs.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Common/Connection.cs create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Common/Connection.cs.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Common/Constants.cs create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Common/Constants.cs.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Common/EventType.cs create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Common/EventType.cs.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Common/Log.cs create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Common/Log.cs.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Common/Message.cs create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Common/Message.cs.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Common/MessageProcessor.cs create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Common/MessageProcessor.cs.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Common/ReadHelper.cs create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Common/ReadHelper.cs.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Common/ReceiveLoop.cs create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Common/ReceiveLoop.cs.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Common/Request.cs create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Common/Request.cs.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Common/SendLoop.cs create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Common/SendLoop.cs.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Common/TcpConfig.cs create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Common/TcpConfig.cs.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Common/Utils.cs create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Common/Utils.cs.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/LICENSE create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/LICENSE.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/README.txt create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/README.txt.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Server.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Server/ServerHandshake.cs create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Server/ServerHandshake.cs.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Server/ServerSslHelper.cs create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Server/ServerSslHelper.cs.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Server/SimpleWebServer.cs create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Server/SimpleWebServer.cs.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Server/WebSocketServer.cs create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/Server/WebSocketServer.cs.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/SimpleWebTransport.asmdef create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/SimpleWebTransport.asmdef.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/SslConfigLoader.cs create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWeb/SslConfigLoader.cs.meta create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWebTransport.cs create mode 100644 Assets/Mirror/Transports/SimpleWeb/SimpleWebTransport.cs.meta create mode 100644 Assets/Mirror/Transports/Telepathy.meta create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy.meta create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/Client.cs create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/Client.cs.meta create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/Common.cs create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/Common.cs.meta create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/ConnectionState.cs create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/ConnectionState.cs.meta create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/EventType.cs create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/EventType.cs.meta create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/LICENSE create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/LICENSE.meta create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/Log.cs create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/Log.cs.meta create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/MagnificentReceivePipe.cs create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/MagnificentReceivePipe.cs.meta create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/MagnificentSendPipe.cs create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/MagnificentSendPipe.cs.meta create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/NetworkStreamExtensions.cs create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/NetworkStreamExtensions.cs.meta create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/Pool.cs create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/Pool.cs.meta create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/Server.cs create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/Server.cs.meta create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/Telepathy.asmdef create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/Telepathy.asmdef.meta create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/ThreadFunctions.cs create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/ThreadFunctions.cs.meta create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/Utils.cs create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/Utils.cs.meta create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/VERSION create mode 100644 Assets/Mirror/Transports/Telepathy/Telepathy/VERSION.meta create mode 100644 Assets/Mirror/Transports/Telepathy/TelepathyTransport.cs create mode 100644 Assets/Mirror/Transports/Telepathy/TelepathyTransport.cs.meta create mode 100644 Assets/Mirror/Transports/Threaded.meta create mode 100644 Assets/Mirror/Transports/Threaded/ThreadedTransport.cs create mode 100644 Assets/Mirror/Transports/Threaded/ThreadedTransport.cs.meta create mode 100644 Assets/Mirror/Version.txt create mode 100644 Assets/Mirror/Version.txt.meta create mode 100644 Assets/ParrelSync.meta create mode 100644 Assets/ParrelSync/Examples.meta create mode 100644 Assets/ParrelSync/Examples/CustomArgumentExample.cs create mode 100644 Assets/ParrelSync/Examples/CustomArgumentExample.cs.meta create mode 100644 Assets/ParrelSync/LICENSE.md create mode 100644 Assets/ParrelSync/LICENSE.md.meta create mode 100644 Assets/ParrelSync/ParrelSync.meta create mode 100644 Assets/ParrelSync/ParrelSync/Editor.meta create mode 100644 Assets/ParrelSync/ParrelSync/Editor/AssetModBlock.meta create mode 100644 Assets/ParrelSync/ParrelSync/Editor/AssetModBlock/EditorQuit.cs create mode 100644 Assets/ParrelSync/ParrelSync/Editor/AssetModBlock/EditorQuit.cs.meta create mode 100644 Assets/ParrelSync/ParrelSync/Editor/AssetModBlock/ParrelSyncAssetModificationProcessor.cs create mode 100644 Assets/ParrelSync/ParrelSync/Editor/AssetModBlock/ParrelSyncAssetModificationProcessor.cs.meta create mode 100644 Assets/ParrelSync/ParrelSync/Editor/ClonesManager.cs create mode 100644 Assets/ParrelSync/ParrelSync/Editor/ClonesManager.cs.meta create mode 100644 Assets/ParrelSync/ParrelSync/Editor/ClonesManagerWindow.cs create mode 100644 Assets/ParrelSync/ParrelSync/Editor/ClonesManagerWindow.cs.meta create mode 100644 Assets/ParrelSync/ParrelSync/Editor/ExternalLinks.cs create mode 100644 Assets/ParrelSync/ParrelSync/Editor/ExternalLinks.cs.meta create mode 100644 Assets/ParrelSync/ParrelSync/Editor/FileUtilities.cs create mode 100644 Assets/ParrelSync/ParrelSync/Editor/FileUtilities.cs.meta create mode 100644 Assets/ParrelSync/ParrelSync/Editor/NonCore.meta create mode 100644 Assets/ParrelSync/ParrelSync/Editor/NonCore/AskFeedbackDialog.cs create mode 100644 Assets/ParrelSync/ParrelSync/Editor/NonCore/AskFeedbackDialog.cs.meta create mode 100644 Assets/ParrelSync/ParrelSync/Editor/NonCore/OtherMenuItem.cs create mode 100644 Assets/ParrelSync/ParrelSync/Editor/NonCore/OtherMenuItem.cs.meta create mode 100644 Assets/ParrelSync/ParrelSync/Editor/Preferences.cs create mode 100644 Assets/ParrelSync/ParrelSync/Editor/Preferences.cs.meta create mode 100644 Assets/ParrelSync/ParrelSync/Editor/Project.cs create mode 100644 Assets/ParrelSync/ParrelSync/Editor/Project.cs.meta create mode 100644 Assets/ParrelSync/ParrelSync/Editor/UpdateChecker.cs create mode 100644 Assets/ParrelSync/ParrelSync/Editor/UpdateChecker.cs.meta create mode 100644 Assets/ParrelSync/ParrelSync/Editor/ValidateCopiedFoldersIntegrity.cs create mode 100644 Assets/ParrelSync/ParrelSync/Editor/ValidateCopiedFoldersIntegrity.cs.meta create mode 100644 Assets/ParrelSync/ParrelSync/package.json create mode 100644 Assets/ParrelSync/ParrelSync/package.json.meta create mode 100644 Assets/ParrelSync/ParrelSync/projectCloner.asmdef create mode 100644 Assets/ParrelSync/ParrelSync/projectCloner.asmdef.meta create mode 100644 Assets/ParrelSync/README.md create mode 100644 Assets/ParrelSync/README.md.meta create mode 100644 Assets/ParrelSync/VERSION.txt create mode 100644 Assets/ParrelSync/VERSION.txt.meta create mode 100644 Assets/Prefabs.meta create mode 100644 Assets/Prefabs/Lobby_PlayerMesh.prefab create mode 100644 Assets/Prefabs/Lobby_PlayerMesh.prefab.meta create mode 100644 Assets/Prefabs/Player.prefab create mode 100644 Assets/Prefabs/Player.prefab.meta create mode 100644 Assets/Prefabs/UI.meta create mode 100644 Assets/Prefabs/UI/Buttom_Element.prefab create mode 100644 Assets/Prefabs/UI/Buttom_Element.prefab.meta create mode 100644 Assets/Prefabs/UI/Friend_Element.prefab create mode 100644 Assets/Prefabs/UI/Friend_Element.prefab.meta create mode 100644 Assets/Resources.meta create mode 100644 Assets/Resources/Markers.meta create mode 100644 Assets/Resources/Markers/Nametag_Marker.asset create mode 100644 Assets/Resources/Markers/Nametag_Marker.asset.meta create mode 100644 Assets/Resources/Markers/Party_Nametag.prefab create mode 100644 Assets/Resources/Markers/Party_Nametag.prefab.meta create mode 100644 Assets/Scenes.meta create mode 100644 Assets/Scenes/MainMenu.unity create mode 100644 Assets/Scenes/MainMenu.unity.meta create mode 100644 Assets/Scenes/Stage_1.unity create mode 100644 Assets/Scenes/Stage_1.unity.meta create mode 100644 Assets/Scripts.meta create mode 100644 Assets/Scripts/CharacterSkinElement.cs create mode 100644 Assets/Scripts/CharacterSkinElement.cs.meta create mode 100644 Assets/Scripts/CharacterSkinHandler.cs create mode 100644 Assets/Scripts/CharacterSkinHandler.cs.meta create mode 100644 Assets/Scripts/Extensions.meta create mode 100644 Assets/Scripts/Extensions/ArrayExtension.cs create mode 100644 Assets/Scripts/Extensions/ArrayExtension.cs.meta create mode 100644 Assets/Scripts/Extensions/MonoBehaviourExtensions.cs create mode 100644 Assets/Scripts/Extensions/MonoBehaviourExtensions.cs.meta create mode 100644 Assets/Scripts/Extensions/SteamHelper.cs create mode 100644 Assets/Scripts/Extensions/SteamHelper.cs.meta create mode 100644 Assets/Scripts/FriendItem.cs create mode 100644 Assets/Scripts/FriendItem.cs.meta create mode 100644 Assets/Scripts/FriendListManager.cs create mode 100644 Assets/Scripts/FriendListManager.cs.meta create mode 100644 Assets/Scripts/LobbyController.cs create mode 100644 Assets/Scripts/LobbyController.cs.meta create mode 100644 Assets/Scripts/MainMenu.cs create mode 100644 Assets/Scripts/MainMenu.cs.meta create mode 100644 Assets/Scripts/Markers.meta create mode 100644 Assets/Scripts/Markers/Marker.cs create mode 100644 Assets/Scripts/Markers/Marker.cs.meta create mode 100644 Assets/Scripts/Markers/MarkerDefinition.cs create mode 100644 Assets/Scripts/Markers/MarkerDefinition.cs.meta create mode 100644 Assets/Scripts/Markers/MarkerHandler.cs create mode 100644 Assets/Scripts/Markers/MarkerHandler.cs.meta create mode 100644 Assets/Scripts/Markers/NametagMarker.cs create mode 100644 Assets/Scripts/Markers/NametagMarker.cs.meta create mode 100644 Assets/Scripts/Movement.cs create mode 100644 Assets/Scripts/Movement.cs.meta create mode 100644 Assets/Scripts/MyClient.cs create mode 100644 Assets/Scripts/MyClient.cs.meta create mode 100644 Assets/Scripts/MyNetworkManager.cs create mode 100644 Assets/Scripts/MyNetworkManager.cs.meta create mode 100644 Assets/Scripts/PopupManager.cs create mode 100644 Assets/Scripts/PopupManager.cs.meta create mode 100644 Assets/Scripts/SteamLobby.cs create mode 100644 Assets/Scripts/SteamLobby.cs.meta create mode 100644 Assets/Scripts/Steamworks.NET.meta create mode 100644 Assets/Scripts/Steamworks.NET/SteamManager.cs create mode 100644 Assets/Scripts/Steamworks.NET/SteamManager.cs.meta create mode 100644 Assets/Scripts/Tools.meta create mode 100644 Assets/Scripts/Tools/SceneSwitcher.cs create mode 100644 Assets/Scripts/Tools/SceneSwitcher.cs.meta create mode 100644 Assets/Scripts/UIElements.meta create mode 100644 Assets/Settings.meta create mode 100644 Assets/Settings/SampleSceneProfile.asset create mode 100644 Assets/Settings/SampleSceneProfile.asset.meta create mode 100644 Assets/Settings/URP-Balanced-Renderer.asset create mode 100644 Assets/Settings/URP-Balanced-Renderer.asset.meta create mode 100644 Assets/Settings/URP-Balanced.asset create mode 100644 Assets/Settings/URP-Balanced.asset.meta create mode 100644 Assets/Settings/URP-HighFidelity-Renderer.asset create mode 100644 Assets/Settings/URP-HighFidelity-Renderer.asset.meta create mode 100644 Assets/Settings/URP-HighFidelity.asset create mode 100644 Assets/Settings/URP-HighFidelity.asset.meta create mode 100644 Assets/Settings/URP-Performant-Renderer.asset create mode 100644 Assets/Settings/URP-Performant-Renderer.asset.meta create mode 100644 Assets/Settings/URP-Performant.asset create mode 100644 Assets/Settings/URP-Performant.asset.meta create mode 100644 Assets/TextMesh Pro.meta create mode 100644 Assets/TextMesh Pro/Documentation.meta create mode 100644 Assets/TextMesh Pro/Documentation/TextMesh Pro User Guide 2016.pdf create mode 100644 Assets/TextMesh Pro/Documentation/TextMesh Pro User Guide 2016.pdf.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Fonts.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Fonts/Anton OFL.txt create mode 100644 Assets/TextMesh Pro/Examples & Extras/Fonts/Anton OFL.txt.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Fonts/Anton.ttf create mode 100644 Assets/TextMesh Pro/Examples & Extras/Fonts/Anton.ttf.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Fonts/Bangers - OFL.txt create mode 100644 Assets/TextMesh Pro/Examples & Extras/Fonts/Bangers - OFL.txt.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Fonts/Bangers.ttf create mode 100644 Assets/TextMesh Pro/Examples & Extras/Fonts/Bangers.ttf.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Fonts/Electronic Highway Sign.TTF create mode 100644 Assets/TextMesh Pro/Examples & Extras/Fonts/Electronic Highway Sign.TTF.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Fonts/Oswald-Bold - OFL.txt create mode 100644 Assets/TextMesh Pro/Examples & Extras/Fonts/Oswald-Bold - OFL.txt.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Fonts/Oswald-Bold.ttf create mode 100644 Assets/TextMesh Pro/Examples & Extras/Fonts/Oswald-Bold.ttf.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Fonts/Roboto-Bold - AFL.txt create mode 100644 Assets/TextMesh Pro/Examples & Extras/Fonts/Roboto-Bold - AFL.txt.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Fonts/Roboto-Bold - License.txt create mode 100644 Assets/TextMesh Pro/Examples & Extras/Fonts/Roboto-Bold - License.txt.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Fonts/Roboto-Bold.ttf create mode 100644 Assets/TextMesh Pro/Examples & Extras/Fonts/Roboto-Bold.ttf.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Fonts/Unity - OFL.txt create mode 100644 Assets/TextMesh Pro/Examples & Extras/Fonts/Unity - OFL.txt.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Fonts/Unity.ttf create mode 100644 Assets/TextMesh Pro/Examples & Extras/Fonts/Unity.ttf.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Materials.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Materials/Crate - Surface Shader Scene.mat create mode 100644 Assets/TextMesh Pro/Examples & Extras/Materials/Crate - Surface Shader Scene.mat.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Materials/Crate - URP.mat create mode 100644 Assets/TextMesh Pro/Examples & Extras/Materials/Crate - URP.mat.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Materials/Ground - Logo Scene.mat create mode 100644 Assets/TextMesh Pro/Examples & Extras/Materials/Ground - Logo Scene.mat.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Materials/Ground - Surface Shader Scene.mat create mode 100644 Assets/TextMesh Pro/Examples & Extras/Materials/Ground - Surface Shader Scene.mat.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Materials/Ground - URP.mat create mode 100644 Assets/TextMesh Pro/Examples & Extras/Materials/Ground - URP.mat.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Materials/Small Crate_diffuse.mat create mode 100644 Assets/TextMesh Pro/Examples & Extras/Materials/Small Crate_diffuse.mat.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Prefabs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Prefabs/Text Popup.prefab create mode 100644 Assets/TextMesh Pro/Examples & Extras/Prefabs/Text Popup.prefab.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Prefabs/TextMeshPro - Prefab 1.prefab create mode 100644 Assets/TextMesh Pro/Examples & Extras/Prefabs/TextMeshPro - Prefab 1.prefab.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Prefabs/TextMeshPro - Prefab 2.prefab create mode 100644 Assets/TextMesh Pro/Examples & Extras/Prefabs/TextMeshPro - Prefab 2.prefab.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Color Gradient Presets.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Color Gradient Presets/Blue to Purple - Vertical.asset create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Color Gradient Presets/Blue to Purple - Vertical.asset.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Color Gradient Presets/Dark to Light Green - Vertical.asset create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Color Gradient Presets/Dark to Light Green - Vertical.asset.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Color Gradient Presets/Light to Dark Green - Vertical.asset create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Color Gradient Presets/Light to Dark Green - Vertical.asset.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Color Gradient Presets/Yellow to Orange - Vertical.asset create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Color Gradient Presets/Yellow to Orange - Vertical.asset.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Anton SDF - Drop Shadow.mat create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Anton SDF - Drop Shadow.mat.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Anton SDF - Outline.mat create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Anton SDF - Outline.mat.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Anton SDF - Sunny Days.mat create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Anton SDF - Sunny Days.mat.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Anton SDF.asset create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Anton SDF.asset.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Bangers SDF - Drop Shadow - 2 Pass.mat create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Bangers SDF - Drop Shadow - 2 Pass.mat.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Bangers SDF - Drop Shadow.mat create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Bangers SDF - Drop Shadow.mat.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Bangers SDF - Outline.mat create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Bangers SDF - Outline.mat.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Bangers SDF Glow.mat create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Bangers SDF Glow.mat.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Bangers SDF Logo - URP.mat create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Bangers SDF Logo - URP.mat.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Bangers SDF Logo.mat create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Bangers SDF Logo.mat.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Bangers SDF.asset create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Bangers SDF.asset.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Electronic Highway Sign SDF.asset create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Electronic Highway Sign SDF.asset.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/LiberationSans SDF - Metalic Green.mat create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/LiberationSans SDF - Metalic Green.mat.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/LiberationSans SDF - Overlay.mat create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/LiberationSans SDF - Overlay.mat.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/LiberationSans SDF - Soft Mask.mat create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/LiberationSans SDF - Soft Mask.mat.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Oswald Bold SDF.asset create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Oswald Bold SDF.asset.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Roboto-Bold SDF - Drop Shadow.mat create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Roboto-Bold SDF - Drop Shadow.mat.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Roboto-Bold SDF - HDRP Unlit.mat create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Roboto-Bold SDF - HDRP Unlit.mat.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Roboto-Bold SDF - Surface.mat create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Roboto-Bold SDF - Surface.mat.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Roboto-Bold SDF - URP.mat create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Roboto-Bold SDF - URP.mat.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Roboto-Bold SDF.asset create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Roboto-Bold SDF.asset.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Unity SDF - HDRP LIT - Bloom.mat create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Unity SDF - HDRP LIT - Bloom.mat.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Unity SDF - HDRP LIT - Outline.mat create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Unity SDF - HDRP LIT - Outline.mat.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Unity SDF.asset create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Fonts & Materials/Unity SDF.asset.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Sprite Assets.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Sprite Assets/Default Sprite Asset.asset create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Sprite Assets/Default Sprite Asset.asset.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Sprite Assets/DropCap Numbers.asset create mode 100644 Assets/TextMesh Pro/Examples & Extras/Resources/Sprite Assets/DropCap Numbers.asset.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/01- Single Line TextMesh Pro.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/01- Single Line TextMesh Pro.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/02 - Multi-line TextMesh Pro.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/02 - Multi-line TextMesh Pro.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/03 - Line Justification.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/03 - Line Justification.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/04 - Word Wrapping.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/04 - Word Wrapping.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/05 - Style Tags.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/05 - Style Tags.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/06 - Extra Rich Text Examples.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/06 - Extra Rich Text Examples.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/07 - Superscript & Subscript Example.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/07 - Superscript & Subscript Example.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/08 - Improved Text Alignment.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/08 - Improved Text Alignment.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/09 - Margin Tag Example.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/09 - Margin Tag Example.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/10 - Bullets & Numbered List Example.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/10 - Bullets & Numbered List Example.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/11 - The Style Tag.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/11 - The Style Tag.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/12 - Link Example.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/12 - Link Example.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/12a - Text Interactions.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/12a - Text Interactions.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/13 - Soft Hyphenation.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/13 - Soft Hyphenation.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/14 - Multi Font & Sprites.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/14 - Multi Font & Sprites.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/15 - Inline Graphics & Sprites.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/15 - Inline Graphics & Sprites.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/16 - Linked text overflow mode example.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/16 - Linked text overflow mode example.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/17 - Old Computer Terminal.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/17 - Old Computer Terminal.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/18 - ScrollRect & Masking & Layout.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/18 - ScrollRect & Masking & Layout.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/19 - Masking Texture & Soft Mask.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/19 - Masking Texture & Soft Mask.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/20 - Input Field with Scrollbar.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/20 - Input Field with Scrollbar.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/21 - Script Example.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/21 - Script Example.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/22 - Basic Scripting Example.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/22 - Basic Scripting Example.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/23 - Animating Vertex Attributes.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/23 - Animating Vertex Attributes.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/24 - Surface Shader Example URP.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/24 - Surface Shader Example URP.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/24 - Surface Shader Example.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/24 - Surface Shader Example.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/25 - Sunny Days Example.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/25 - Sunny Days Example.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/26 - Dropdown Placeholder Example.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/26 - Dropdown Placeholder Example.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/27 - Double Pass Shader Example.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/27 - Double Pass Shader Example.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/28 - HDRP Shader Example.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/28 - HDRP Shader Example.unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/28 - HDRP Shader Example.unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/28 - HDRP Shader Example/Sky and Fog Volume Profile.asset create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/28 - HDRP Shader Example/Sky and Fog Volume Profile.asset.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/Benchmark (Floating Text).unity create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scenes/Benchmark (Floating Text).unity.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/Benchmark01.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/Benchmark01.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/Benchmark01_UGUI.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/Benchmark01_UGUI.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/Benchmark02.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/Benchmark02.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/Benchmark03.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/Benchmark03.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/Benchmark04.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/Benchmark04.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/CameraController.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/CameraController.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/ChatController.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/ChatController.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/DropdownSample.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/DropdownSample.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/EnvMapAnimator.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/EnvMapAnimator.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/ObjectSpin.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/ObjectSpin.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/ShaderPropAnimator.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/ShaderPropAnimator.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/SimpleScript.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/SimpleScript.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/SkewTextExample.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/SkewTextExample.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TMP_DigitValidator.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TMP_DigitValidator.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TMP_ExampleScript_01.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TMP_ExampleScript_01.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TMP_FrameRateCounter.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TMP_FrameRateCounter.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TMP_PhoneNumberValidator.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TMP_PhoneNumberValidator.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TMP_TextEventCheck.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TMP_TextEventCheck.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TMP_TextEventHandler.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TMP_TextEventHandler.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TMP_TextInfoDebugTool.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TMP_TextInfoDebugTool.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TMP_TextSelector_A.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TMP_TextSelector_A.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TMP_TextSelector_B.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TMP_TextSelector_B.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TMP_UiFrameRateCounter.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TMP_UiFrameRateCounter.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TMPro_InstructionOverlay.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TMPro_InstructionOverlay.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TeleType.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TeleType.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TextConsoleSimulator.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TextConsoleSimulator.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TextMeshProFloatingText.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TextMeshProFloatingText.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TextMeshSpawner.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/TextMeshSpawner.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/VertexColorCycler.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/VertexColorCycler.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/VertexJitter.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/VertexJitter.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/VertexShakeA.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/VertexShakeA.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/VertexShakeB.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/VertexShakeB.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/VertexZoom.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/VertexZoom.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/WarpTextExample.cs create mode 100644 Assets/TextMesh Pro/Examples & Extras/Scripts/WarpTextExample.cs.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Sprites.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Sprites/Default Sprites.png create mode 100644 Assets/TextMesh Pro/Examples & Extras/Sprites/Default Sprites.png.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Sprites/DropCap Numbers.psd create mode 100644 Assets/TextMesh Pro/Examples & Extras/Sprites/DropCap Numbers.psd.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Brushed Metal 3.jpg create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Brushed Metal 3.jpg.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Floor Cement.jpg create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Floor Cement.jpg.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Floor Tiles 1 - diffuse.jpg create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Floor Tiles 1 - diffuse.jpg.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Fruit Jelly (B&W).jpg create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Fruit Jelly (B&W).jpg.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Gradient Diagonal (Color).jpg create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Gradient Diagonal (Color).jpg.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Gradient Horizontal (Color).jpg create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Gradient Horizontal (Color).jpg.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Gradient Vertical (Color).jpg create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Gradient Vertical (Color).jpg.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Mask Zig-n-Zag.psd create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Mask Zig-n-Zag.psd.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Small Crate_diffuse.jpg create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Small Crate_diffuse.jpg.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Small Crate_normal.jpg create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Small Crate_normal.jpg.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Sunny Days - Seamless.jpg create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Sunny Days - Seamless.jpg.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Text Overflow - Linked Text Image 1.png create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Text Overflow - Linked Text Image 1.png.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Text Overflow - Linked Text UI Screenshot.png create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Text Overflow - Linked Text UI Screenshot.png.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Wipe Pattern - Circle.psd create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Wipe Pattern - Circle.psd.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Wipe Pattern - Diagonal.psd create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Wipe Pattern - Diagonal.psd.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Wipe Pattern - Radial Double.psd create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Wipe Pattern - Radial Double.psd.meta create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Wipe Pattern - Radial Quad.psd create mode 100644 Assets/TextMesh Pro/Examples & Extras/Textures/Wipe Pattern - Radial Quad.psd.meta create mode 100644 Assets/TextMesh Pro/Fonts.meta create mode 100644 Assets/TextMesh Pro/Fonts/LiberationSans - OFL.txt create mode 100644 Assets/TextMesh Pro/Fonts/LiberationSans - OFL.txt.meta create mode 100644 Assets/TextMesh Pro/Fonts/LiberationSans.ttf create mode 100644 Assets/TextMesh Pro/Fonts/LiberationSans.ttf.meta create mode 100644 Assets/TextMesh Pro/Resources.meta create mode 100644 Assets/TextMesh Pro/Resources/Fonts & Materials.meta create mode 100644 Assets/TextMesh Pro/Resources/Fonts & Materials/LiberationSans SDF - Drop Shadow.mat create mode 100644 Assets/TextMesh Pro/Resources/Fonts & Materials/LiberationSans SDF - Drop Shadow.mat.meta create mode 100644 Assets/TextMesh Pro/Resources/Fonts & Materials/LiberationSans SDF - Fallback.asset create mode 100644 Assets/TextMesh Pro/Resources/Fonts & Materials/LiberationSans SDF - Fallback.asset.meta create mode 100644 Assets/TextMesh Pro/Resources/Fonts & Materials/LiberationSans SDF - Outline.mat create mode 100644 Assets/TextMesh Pro/Resources/Fonts & Materials/LiberationSans SDF - Outline.mat.meta create mode 100644 Assets/TextMesh Pro/Resources/Fonts & Materials/LiberationSans SDF.asset create mode 100644 Assets/TextMesh Pro/Resources/Fonts & Materials/LiberationSans SDF.asset.meta create mode 100644 Assets/TextMesh Pro/Resources/LineBreaking Following Characters.txt create mode 100644 Assets/TextMesh Pro/Resources/LineBreaking Following Characters.txt.meta create mode 100644 Assets/TextMesh Pro/Resources/LineBreaking Leading Characters.txt create mode 100644 Assets/TextMesh Pro/Resources/LineBreaking Leading Characters.txt.meta create mode 100644 Assets/TextMesh Pro/Resources/Sprite Assets.meta create mode 100644 Assets/TextMesh Pro/Resources/Sprite Assets/EmojiOne.asset create mode 100644 Assets/TextMesh Pro/Resources/Sprite Assets/EmojiOne.asset.meta create mode 100644 Assets/TextMesh Pro/Resources/Style Sheets.meta create mode 100644 Assets/TextMesh Pro/Resources/Style Sheets/Default Style Sheet.asset create mode 100644 Assets/TextMesh Pro/Resources/Style Sheets/Default Style Sheet.asset.meta create mode 100644 Assets/TextMesh Pro/Resources/TMP Settings.asset create mode 100644 Assets/TextMesh Pro/Resources/TMP Settings.asset.meta create mode 100644 Assets/TextMesh Pro/Shaders.meta create mode 100644 Assets/TextMesh Pro/Shaders/SDFFunctions.hlsl create mode 100644 Assets/TextMesh Pro/Shaders/SDFFunctions.hlsl.meta create mode 100644 Assets/TextMesh Pro/Shaders/TMP_Bitmap-Custom-Atlas.shader create mode 100644 Assets/TextMesh Pro/Shaders/TMP_Bitmap-Custom-Atlas.shader.meta create mode 100644 Assets/TextMesh Pro/Shaders/TMP_Bitmap-Mobile.shader create mode 100644 Assets/TextMesh Pro/Shaders/TMP_Bitmap-Mobile.shader.meta create mode 100644 Assets/TextMesh Pro/Shaders/TMP_Bitmap.shader create mode 100644 Assets/TextMesh Pro/Shaders/TMP_Bitmap.shader.meta create mode 100644 Assets/TextMesh Pro/Shaders/TMP_SDF Overlay.shader create mode 100644 Assets/TextMesh Pro/Shaders/TMP_SDF Overlay.shader.meta create mode 100644 Assets/TextMesh Pro/Shaders/TMP_SDF SSD.shader create mode 100644 Assets/TextMesh Pro/Shaders/TMP_SDF SSD.shader.meta create mode 100644 Assets/TextMesh Pro/Shaders/TMP_SDF-HDRP LIT.shadergraph create mode 100644 Assets/TextMesh Pro/Shaders/TMP_SDF-HDRP LIT.shadergraph.meta create mode 100644 Assets/TextMesh Pro/Shaders/TMP_SDF-HDRP UNLIT.shadergraph create mode 100644 Assets/TextMesh Pro/Shaders/TMP_SDF-HDRP UNLIT.shadergraph.meta create mode 100644 Assets/TextMesh Pro/Shaders/TMP_SDF-Mobile Masking.shader create mode 100644 Assets/TextMesh Pro/Shaders/TMP_SDF-Mobile Masking.shader.meta create mode 100644 Assets/TextMesh Pro/Shaders/TMP_SDF-Mobile Overlay.shader create mode 100644 Assets/TextMesh Pro/Shaders/TMP_SDF-Mobile Overlay.shader.meta create mode 100644 Assets/TextMesh Pro/Shaders/TMP_SDF-Mobile SSD.shader create mode 100644 Assets/TextMesh Pro/Shaders/TMP_SDF-Mobile SSD.shader.meta create mode 100644 Assets/TextMesh Pro/Shaders/TMP_SDF-Mobile-2-Pass.shader create mode 100644 Assets/TextMesh Pro/Shaders/TMP_SDF-Mobile-2-Pass.shader.meta create mode 100644 Assets/TextMesh Pro/Shaders/TMP_SDF-Mobile.shader create mode 100644 Assets/TextMesh Pro/Shaders/TMP_SDF-Mobile.shader.meta create mode 100644 Assets/TextMesh Pro/Shaders/TMP_SDF-Surface-Mobile.shader create mode 100644 Assets/TextMesh Pro/Shaders/TMP_SDF-Surface-Mobile.shader.meta create mode 100644 Assets/TextMesh Pro/Shaders/TMP_SDF-Surface.shader create mode 100644 Assets/TextMesh Pro/Shaders/TMP_SDF-Surface.shader.meta create mode 100644 Assets/TextMesh Pro/Shaders/TMP_SDF-URP Lit.shadergraph create mode 100644 Assets/TextMesh Pro/Shaders/TMP_SDF-URP Lit.shadergraph.meta create mode 100644 Assets/TextMesh Pro/Shaders/TMP_SDF-URP Unlit.shadergraph create mode 100644 Assets/TextMesh Pro/Shaders/TMP_SDF-URP Unlit.shadergraph.meta create mode 100644 Assets/TextMesh Pro/Shaders/TMP_SDF.shader create mode 100644 Assets/TextMesh Pro/Shaders/TMP_SDF.shader.meta create mode 100644 Assets/TextMesh Pro/Shaders/TMP_Sprite.shader create mode 100644 Assets/TextMesh Pro/Shaders/TMP_Sprite.shader.meta create mode 100644 Assets/TextMesh Pro/Shaders/TMPro.cginc create mode 100644 Assets/TextMesh Pro/Shaders/TMPro.cginc.meta create mode 100644 Assets/TextMesh Pro/Shaders/TMPro_Mobile.cginc create mode 100644 Assets/TextMesh Pro/Shaders/TMPro_Mobile.cginc.meta create mode 100644 Assets/TextMesh Pro/Shaders/TMPro_Properties.cginc create mode 100644 Assets/TextMesh Pro/Shaders/TMPro_Properties.cginc.meta create mode 100644 Assets/TextMesh Pro/Shaders/TMPro_Surface.cginc create mode 100644 Assets/TextMesh Pro/Shaders/TMPro_Surface.cginc.meta create mode 100644 Assets/TextMesh Pro/Sprites.meta create mode 100644 Assets/TextMesh Pro/Sprites/EmojiOne Attribution.txt create mode 100644 Assets/TextMesh Pro/Sprites/EmojiOne Attribution.txt.meta create mode 100644 Assets/TextMesh Pro/Sprites/EmojiOne.json create mode 100644 Assets/TextMesh Pro/Sprites/EmojiOne.json.meta create mode 100644 Assets/TextMesh Pro/Sprites/EmojiOne.png create mode 100644 Assets/TextMesh Pro/Sprites/EmojiOne.png.meta create mode 100644 Assets/UniversalRenderPipelineGlobalSettings.asset create mode 100644 Assets/UniversalRenderPipelineGlobalSettings.asset.meta create mode 100644 Assets/com.rlabrecque.steamworks.net.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Editor.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Editor/RedistCopy.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Editor/RedistCopy.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Editor/RedistInstall.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Editor/RedistInstall.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Editor/com.rlabrecque.steamworks.net.editor.asmdef create mode 100644 Assets/com.rlabrecque.steamworks.net/Editor/com.rlabrecque.steamworks.net.editor.asmdef.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/LICENSE.md create mode 100644 Assets/com.rlabrecque.steamworks.net/LICENSE.md.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Plugins.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Plugins/libsteam_api.so create mode 100644 Assets/com.rlabrecque.steamworks.net/Plugins/libsteam_api.so.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Plugins/steam_api.bundle.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Plugins/steam_api.bundle/Contents.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Plugins/steam_api.bundle/Contents/Info.plist create mode 100644 Assets/com.rlabrecque.steamworks.net/Plugins/steam_api.bundle/Contents/Info.plist.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Plugins/steam_api.bundle/Contents/MacOS.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Plugins/steam_api.bundle/Contents/MacOS/libsteam_api.dylib create mode 100644 Assets/com.rlabrecque.steamworks.net/Plugins/steam_api.bundle/Contents/MacOS/libsteam_api.dylib.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Plugins/steam_api.dll create mode 100644 Assets/com.rlabrecque.steamworks.net/Plugins/steam_api.dll.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Plugins/steam_api64.dll create mode 100644 Assets/com.rlabrecque.steamworks.net/Plugins/steam_api64.dll.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/README.md create mode 100644 Assets/com.rlabrecque.steamworks.net/README.md.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/CallbackDispatcher.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/CallbackDispatcher.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/CallbackIdentity.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/CallbackIdentity.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/ISteamMatchmakingResponses.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/ISteamMatchmakingResponses.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/InteropHelp.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/InteropHelp.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/Packsize.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/Packsize.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/Steam.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/Steam.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/Version.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/Version.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/NativeMethods.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/NativeMethods.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/SteamCallbacks.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/SteamCallbacks.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/SteamConstants.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/SteamConstants.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/SteamEnums.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/SteamEnums.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/SteamStructs.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/SteamStructs.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamapplist.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamapplist.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamapps.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamapps.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamclient.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamclient.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamfriends.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamfriends.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamgameserver.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamgameserver.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamgameserverclient.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamgameserverclient.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamgameserverhttp.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamgameserverhttp.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamgameserverinventory.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamgameserverinventory.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamgameservernetworking.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamgameservernetworking.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamgameservernetworkingsockets.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamgameservernetworkingsockets.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamgameservernetworkingutils.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamgameservernetworkingutils.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamgameserverstats.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamgameserverstats.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamgameserverugc.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamgameserverugc.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamgameserverutils.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamgameserverutils.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamhtmlsurface.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamhtmlsurface.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamhttp.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamhttp.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteaminput.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteaminput.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteaminventory.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteaminventory.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteammatchmaking.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteammatchmaking.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteammusic.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteammusic.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteammusicremote.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteammusicremote.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamnetworking.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamnetworking.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamnetworkingmessages.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamnetworkingmessages.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamnetworkingsockets.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamnetworkingsockets.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamnetworkingutils.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamnetworkingutils.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamparentalsettings.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamparentalsettings.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamremoteplay.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamremoteplay.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamremotestorage.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamremotestorage.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamscreenshots.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamscreenshots.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamugc.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamugc.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamuser.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamuser.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamuserstats.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamuserstats.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamutils.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamutils.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamvideo.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/autogen/isteamvideo.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/com.rlabrecque.steamworks.net.asmdef create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/com.rlabrecque.steamworks.net.asmdef.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/MatchmakingTypes.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/MatchmakingTypes/gameserveritem_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/MatchmakingTypes/gameserveritem_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/MatchmakingTypes/servernetadr_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/MatchmakingTypes/servernetadr_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamClient.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamClient/SteamAPIWarningMessageHook_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamClient/SteamAPIWarningMessageHook_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamClient/SteamAPI_CheckCallbackRegistered_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamClient/SteamAPI_CheckCallbackRegistered_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamClientPublic.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamClientPublic/CGameID.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamClientPublic/CGameID.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamClientPublic/CSteamID.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamClientPublic/CSteamID.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamClientPublic/HAuthTicket.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamClientPublic/HAuthTicket.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamDatagramTickets.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamDatagramTickets/SteamDatagramHostedAddress.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamDatagramTickets/SteamDatagramHostedAddress.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamDatagramTickets/SteamDatagramRelayAuthTicket.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamDatagramTickets/SteamDatagramRelayAuthTicket.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamFriends.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamFriends/FriendsGroupID_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamFriends/FriendsGroupID_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamHTMLSurface.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamHTMLSurface/HHTMLBrowser.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamHTMLSurface/HHTMLBrowser.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamHTTP.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamHTTP/HTTPCookieContainerHandle.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamHTTP/HTTPCookieContainerHandle.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamHTTP/HTTPRequestHandle.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamHTTP/HTTPRequestHandle.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamInput.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamInput/InputActionSetHandle_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamInput/InputActionSetHandle_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamInput/InputAnalogActionHandle_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamInput/InputAnalogActionHandle_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamInput/InputDigitalActionHandle_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamInput/InputDigitalActionHandle_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamInput/InputHandle_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamInput/InputHandle_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamInput/SteamInputActionEventCallbackPointer.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamInput/SteamInputActionEventCallbackPointer.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamInput/SteamInputActionEvent_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamInput/SteamInputActionEvent_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamInventory.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamInventory/SteamInventoryResult_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamInventory/SteamInventoryResult_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamInventory/SteamInventoryUpdateHandle_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamInventory/SteamInventoryUpdateHandle_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamInventory/SteamItemDef_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamInventory/SteamItemDef_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamInventory/SteamItemInstanceID_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamInventory/SteamItemInstanceID_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamMatchmaking.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamMatchmaking/HServerListRequest.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamMatchmaking/HServerListRequest.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamMatchmaking/HServerQuery.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamMatchmaking/HServerQuery.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworking.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworking/SNetListenSocket_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworking/SNetListenSocket_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworking/SNetSocket_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworking/SNetSocket_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworkingSockets.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworkingSockets/ISteamNetworkingConnectionSignaling.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworkingSockets/ISteamNetworkingConnectionSignaling.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworkingSockets/ISteamNetworkingSignalingRecvContext.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworkingSockets/ISteamNetworkingSignalingRecvContext.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworkingTypes.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworkingTypes/FSteamNetworkingSocketsDebugOutput.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworkingTypes/FSteamNetworkingSocketsDebugOutput.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworkingTypes/HSteamListenSocket.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworkingTypes/HSteamListenSocket.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworkingTypes/HSteamNetConnection.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworkingTypes/HSteamNetConnection.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworkingTypes/HSteamNetPollGroup.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworkingTypes/HSteamNetPollGroup.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworkingTypes/SteamNetworkingConfigValue_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworkingTypes/SteamNetworkingConfigValue_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworkingTypes/SteamNetworkingErrMsg.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworkingTypes/SteamNetworkingErrMsg.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworkingTypes/SteamNetworkingIPAddr.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworkingTypes/SteamNetworkingIPAddr.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworkingTypes/SteamNetworkingIdentity.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworkingTypes/SteamNetworkingIdentity.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworkingTypes/SteamNetworkingMessage_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworkingTypes/SteamNetworkingMessage_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworkingTypes/SteamNetworkingMicroseconds.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworkingTypes/SteamNetworkingMicroseconds.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworkingTypes/SteamNetworkingPOPID.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamNetworkingTypes/SteamNetworkingPOPID.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamRemotePlay.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamRemotePlay/RemotePlaySessionID_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamRemotePlay/RemotePlaySessionID_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamRemoteStorage.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamRemoteStorage/PublishedFileId_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamRemoteStorage/PublishedFileId_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamRemoteStorage/PublishedFileUpdateHandle_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamRemoteStorage/PublishedFileUpdateHandle_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamRemoteStorage/UGCFileWriteStreamHandle_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamRemoteStorage/UGCFileWriteStreamHandle_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamRemoteStorage/UGCHandle_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamRemoteStorage/UGCHandle_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamScreenshots.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamScreenshots/ScreenshotHandle.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamScreenshots/ScreenshotHandle.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamTypes.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamTypes/AccountID_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamTypes/AccountID_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamTypes/AppId_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamTypes/AppId_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamTypes/DepotId_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamTypes/DepotId_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamTypes/PartyBeaconID_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamTypes/PartyBeaconID_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamTypes/RTime32.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamTypes/RTime32.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamTypes/SteamAPICall_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamTypes/SteamAPICall_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamTypes/SteamIPAddress_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamTypes/SteamIPAddress_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamUGC.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamUGC/UGCQueryHandle_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamUGC/UGCQueryHandle_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamUGC/UGCUpdateHandle_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamUGC/UGCUpdateHandle_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamUserStats.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamUserStats/SteamLeaderboardEntries_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamUserStats/SteamLeaderboardEntries_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamUserStats/SteamLeaderboard_t.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/SteamUserStats/SteamLeaderboard_t.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/Steam_api_common.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/Steam_api_common/HSteamPipe.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/Steam_api_common/HSteamPipe.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/Steam_api_common/HSteamUser.cs create mode 100644 Assets/com.rlabrecque.steamworks.net/Runtime/types/Steam_api_common/HSteamUser.cs.meta create mode 100644 Assets/com.rlabrecque.steamworks.net/package.json create mode 100644 Assets/com.rlabrecque.steamworks.net/package.json.meta create mode 100644 Packages/manifest.json create mode 100644 Packages/packages-lock.json create mode 100644 ProjectSettings/AudioManager.asset create mode 100644 ProjectSettings/BurstAotSettings_StandaloneWindows.json create mode 100644 ProjectSettings/ClusterInputManager.asset create mode 100644 ProjectSettings/CommonBurstAotSettings.json create mode 100644 ProjectSettings/DynamicsManager.asset create mode 100644 ProjectSettings/EditorBuildSettings.asset create mode 100644 ProjectSettings/EditorSettings.asset create mode 100644 ProjectSettings/GraphicsSettings.asset create mode 100644 ProjectSettings/InputManager.asset create mode 100644 ProjectSettings/MemorySettings.asset create mode 100644 ProjectSettings/MultiplayerManager.asset create mode 100644 ProjectSettings/NavMeshAreas.asset create mode 100644 ProjectSettings/PackageManagerSettings.asset create mode 100644 ProjectSettings/Physics2DSettings.asset create mode 100644 ProjectSettings/PresetManager.asset create mode 100644 ProjectSettings/ProjectSettings.asset create mode 100644 ProjectSettings/ProjectVersion.txt create mode 100644 ProjectSettings/QualitySettings.asset create mode 100644 ProjectSettings/SceneTemplateSettings.json create mode 100644 ProjectSettings/ShaderGraphSettings.asset create mode 100644 ProjectSettings/TagManager.asset create mode 100644 ProjectSettings/TimeManager.asset create mode 100644 ProjectSettings/URPProjectSettings.asset create mode 100644 ProjectSettings/UnityConnectSettings.asset create mode 100644 ProjectSettings/VFXManager.asset create mode 100644 ProjectSettings/VersionControlSettings.asset create mode 100644 ProjectSettings/XRSettings.asset create mode 100644 README.md create mode 100644 steam_appid.txt diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..efec83d --- /dev/null +++ b/.gitignore @@ -0,0 +1,74 @@ +# This .gitignore file should be placed at the root of your Unity project directory +# +# Get latest from https://github.com/github/gitignore/blob/main/Unity.gitignore +# +.utmp/ +/[Ll]ibrary/ +/[Tt]emp/ +/[Oo]bj/ +/[Bb]uild/ +/[Bb]uilds/ +/[Ll]ogs/ +/[Uu]ser[Ss]ettings/ + +# MemoryCaptures can get excessive in size. +# They also could contain extremely sensitive data +/[Mm]emoryCaptures/ + +# Recordings can get excessive in size +/[Rr]ecordings/ + +# Uncomment this line if you wish to ignore the asset store tools plugin +# /[Aa]ssets/AssetStoreTools* + +# Autogenerated Jetbrains Rider plugin +/[Aa]ssets/Plugins/Editor/JetBrains* + +# Visual Studio cache directory +.vs/ + +# Gradle cache directory +.gradle/ + +# Autogenerated VS/MD/Consulo solution and project files +ExportedObj/ +.consulo/ +*.csproj +*.unityproj +*.sln +*.suo +*.tmp +*.user +*.userprefs +*.pidb +*.booproj +*.svd +*.pdb +*.mdb +*.opendb +*.VC.db + +# Unity3D generated meta files +*.pidb.meta +*.pdb.meta +*.mdb.meta + +# Unity3D generated file on crash reports +sysinfo.txt + +# Builds +*.apk +*.aab +*.unitypackage +*.unitypackage.meta +*.app + +# Crashlytics generated file +crashlytics-build.properties + +# Packed Addressables +/[Aa]ssets/[Aa]ddressable[Aa]ssets[Dd]ata/*/*.bin* + +# Temporary auto-generated Android Assets +/[Aa]ssets/[Ss]treamingAssets/aa.meta +/[Aa]ssets/[Ss]treamingAssets/aa/* diff --git a/.vscode/extensions.json b/.vscode/extensions.json new file mode 100644 index 0000000..ddb6ff8 --- /dev/null +++ b/.vscode/extensions.json @@ -0,0 +1,5 @@ +{ + "recommendations": [ + "visualstudiotoolsforunity.vstuc" + ] +} diff --git a/.vscode/launch.json b/.vscode/launch.json new file mode 100644 index 0000000..da60e25 --- /dev/null +++ b/.vscode/launch.json @@ -0,0 +1,10 @@ +{ + "version": "0.2.0", + "configurations": [ + { + "name": "Attach to Unity", + "type": "vstuc", + "request": "attach" + } + ] +} \ No newline at end of file diff --git a/.vscode/settings.json b/.vscode/settings.json new file mode 100644 index 0000000..f77a017 --- /dev/null +++ b/.vscode/settings.json @@ -0,0 +1,55 @@ +{ + "files.exclude": { + "**/.DS_Store": true, + "**/.git": true, + "**/.gitmodules": true, + "**/*.booproj": true, + "**/*.pidb": true, + "**/*.suo": true, + "**/*.user": true, + "**/*.userprefs": true, + "**/*.unityproj": true, + "**/*.dll": true, + "**/*.exe": true, + "**/*.pdf": true, + "**/*.mid": true, + "**/*.midi": true, + "**/*.wav": true, + "**/*.gif": true, + "**/*.ico": true, + "**/*.jpg": true, + "**/*.jpeg": true, + "**/*.png": true, + "**/*.psd": true, + "**/*.tga": true, + "**/*.tif": true, + "**/*.tiff": true, + "**/*.3ds": true, + "**/*.3DS": true, + "**/*.fbx": true, + "**/*.FBX": true, + "**/*.lxo": true, + "**/*.LXO": true, + "**/*.ma": true, + "**/*.MA": true, + "**/*.obj": true, + "**/*.OBJ": true, + "**/*.asset": true, + "**/*.cubemap": true, + "**/*.flare": true, + "**/*.mat": true, + "**/*.meta": true, + "**/*.prefab": true, + "**/*.unity": true, + "build/": true, + "Build/": true, + "Library/": true, + "library/": true, + "obj/": true, + "Obj/": true, + "ProjectSettings/": true, + "temp/": true, + "Temp/": true + }, + "dotnet.defaultSolution": "multiplayer-game.sln" +} \ No newline at end of file diff --git a/.vsconfig b/.vsconfig new file mode 100644 index 0000000..d70cd98 --- /dev/null +++ b/.vsconfig @@ -0,0 +1,6 @@ +{ + "version": "1.0", + "components": [ + "Microsoft.VisualStudio.Workload.ManagedGame" + ] +} diff --git a/Assets/DefaultVolumeProfile.asset b/Assets/DefaultVolumeProfile.asset new file mode 100644 index 0000000..36c3781 --- /dev/null +++ b/Assets/DefaultVolumeProfile.asset @@ -0,0 +1,15 @@ +%YAML 1.1 +%TAG !u! tag:unity3d.com,2011: +--- !u!114 &11400000 +MonoBehaviour: + m_ObjectHideFlags: 0 + m_CorrespondingSourceObject: {fileID: 0} + m_PrefabInstance: {fileID: 0} + m_PrefabAsset: {fileID: 0} + m_GameObject: {fileID: 0} + m_Enabled: 1 + m_EditorHideFlags: 0 + m_Script: {fileID: 11500000, guid: d7fd9488000d3734a9e00ee676215985, type: 3} + m_Name: DefaultVolumeProfile + m_EditorClassIdentifier: + components: [] diff --git a/Assets/DefaultVolumeProfile.asset.meta b/Assets/DefaultVolumeProfile.asset.meta new file mode 100644 index 0000000..bf08d80 --- /dev/null +++ b/Assets/DefaultVolumeProfile.asset.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: 4d700d2576e8690408c7f734564d78f7 +NativeFormatImporter: + externalObjects: {} + mainObjectFileID: 11400000 + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Materials.meta b/Assets/Materials.meta new file mode 100644 index 0000000..4537ddc --- /dev/null +++ b/Assets/Materials.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: 38871691704490b4f8b7f99ba454f9c1 +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Materials/black.mat b/Assets/Materials/black.mat new file mode 100644 index 0000000..06d72b7 --- /dev/null +++ b/Assets/Materials/black.mat @@ -0,0 +1,135 @@ +%YAML 1.1 +%TAG !u! tag:unity3d.com,2011: +--- !u!114 &-5298968235196956465 +MonoBehaviour: + m_ObjectHideFlags: 11 + m_CorrespondingSourceObject: {fileID: 0} + m_PrefabInstance: {fileID: 0} + m_PrefabAsset: {fileID: 0} + m_GameObject: {fileID: 0} + m_Enabled: 1 + m_EditorHideFlags: 0 + m_Script: {fileID: 11500000, guid: d0353a89b1f911e48b9e16bdc9f2e058, type: 3} + m_Name: + m_EditorClassIdentifier: + version: 9 +--- !u!21 &2100000 +Material: + serializedVersion: 8 + m_ObjectHideFlags: 0 + m_CorrespondingSourceObject: {fileID: 0} + m_PrefabInstance: {fileID: 0} + m_PrefabAsset: {fileID: 0} + m_Name: black + m_Shader: {fileID: 4800000, guid: 933532a4fcc9baf4fa0491de14d08ed7, type: 3} + m_Parent: {fileID: 0} + m_ModifiedSerializedProperties: 0 + m_ValidKeywords: [] + m_InvalidKeywords: [] + m_LightmapFlags: 4 + m_EnableInstancingVariants: 0 + m_DoubleSidedGI: 0 + m_CustomRenderQueue: -1 + stringTagMap: + RenderType: Opaque + disabledShaderPasses: + - MOTIONVECTORS + m_LockedProperties: + m_SavedProperties: + serializedVersion: 3 + m_TexEnvs: + - _BaseMap: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - _BumpMap: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - _DetailAlbedoMap: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - _DetailMask: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - _DetailNormalMap: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - _EmissionMap: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - _MainTex: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - _MetallicGlossMap: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - _OcclusionMap: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - _ParallaxMap: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - _SpecGlossMap: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - unity_Lightmaps: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - unity_LightmapsInd: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - unity_ShadowMasks: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + m_Ints: [] + m_Floats: + - _AlphaClip: 0 + - _AlphaToMask: 0 + - _Blend: 0 + - _BlendModePreserveSpecular: 1 + - _BumpScale: 1 + - _ClearCoatMask: 0 + - _ClearCoatSmoothness: 0 + - _Cull: 2 + - _Cutoff: 0.5 + - _DetailAlbedoMapScale: 1 + - _DetailNormalMapScale: 1 + - _DstBlend: 0 + - _DstBlendAlpha: 0 + - _EnvironmentReflections: 1 + - _GlossMapScale: 0 + - _Glossiness: 0 + - _GlossyReflections: 0 + - _Metallic: 0 + - _OcclusionStrength: 1 + - _Parallax: 0.005 + - _QueueOffset: 0 + - _ReceiveShadows: 1 + - _Smoothness: 0 + - _SmoothnessTextureChannel: 0 + - _SpecularHighlights: 1 + - _SrcBlend: 1 + - _SrcBlendAlpha: 1 + - _Surface: 0 + - _WorkflowMode: 1 + - _ZWrite: 1 + m_Colors: + - _BaseColor: {r: 0.122641504, g: 0.122641504, b: 0.122641504, a: 1} + - _Color: {r: 0.12264148, g: 0.12264148, b: 0.12264148, a: 1} + - _EmissionColor: {r: 0, g: 0, b: 0, a: 1} + - _SpecColor: {r: 0.19999996, g: 0.19999996, b: 0.19999996, a: 1} + m_BuildTextureStacks: [] + m_AllowLocking: 1 diff --git a/Assets/Materials/black.mat.meta b/Assets/Materials/black.mat.meta new file mode 100644 index 0000000..859b299 --- /dev/null +++ b/Assets/Materials/black.mat.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: c7ae0124944d0364984ad3872a6720f9 +NativeFormatImporter: + externalObjects: {} + mainObjectFileID: 2100000 + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror.meta b/Assets/Mirror.meta new file mode 100644 index 0000000..a7a3dd0 --- /dev/null +++ b/Assets/Mirror.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: 5cf8eb36be0834b3da408c694a41cb88 +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Authenticators.meta b/Assets/Mirror/Authenticators.meta new file mode 100644 index 0000000..644f4ec --- /dev/null +++ b/Assets/Mirror/Authenticators.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: 1b2f9d254154cd942ba40b06b869b8f3 +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Authenticators/BasicAuthenticator.cs b/Assets/Mirror/Authenticators/BasicAuthenticator.cs new file mode 100644 index 0000000..3c077c7 --- /dev/null +++ b/Assets/Mirror/Authenticators/BasicAuthenticator.cs @@ -0,0 +1,192 @@ +using System.Collections; +using System.Collections.Generic; +using UnityEngine; + +namespace Mirror.Authenticators +{ + [AddComponentMenu("Network/ Authenticators/Basic Authenticator")] + [HelpURL("https://mirror-networking.gitbook.io/docs/components/network-authenticators/basic-authenticator")] + public class BasicAuthenticator : NetworkAuthenticator + { + [Header("Server Credentials")] + public string serverUsername; + public string serverPassword; + + [Header("Client Credentials")] + public string username; + public string password; + + readonly HashSet connectionsPendingDisconnect = new HashSet(); + + #region Messages + + public struct AuthRequestMessage : NetworkMessage + { + // use whatever credentials make sense for your game + // for example, you might want to pass the accessToken if using oauth + public string authUsername; + public string authPassword; + } + + public struct AuthResponseMessage : NetworkMessage + { + public byte code; + public string message; + } + + #endregion + + #region Server + + /// + /// Called on server from StartServer to initialize the Authenticator + /// Server message handlers should be registered in this method. + /// + public override void OnStartServer() + { + // register a handler for the authentication request we expect from client + NetworkServer.RegisterHandler(OnAuthRequestMessage, false); + } + + /// + /// Called on server from StopServer to reset the Authenticator + /// Server message handlers should be unregistered in this method. + /// + public override void OnStopServer() + { + // unregister the handler for the authentication request + NetworkServer.UnregisterHandler(); + } + + /// + /// Called on server from OnServerConnectInternal when a client needs to authenticate + /// + /// Connection to client. + public override void OnServerAuthenticate(NetworkConnectionToClient conn) + { + // do nothing...wait for AuthRequestMessage from client + } + + /// + /// Called on server when the client's AuthRequestMessage arrives + /// + /// Connection to client. + /// The message payload + public void OnAuthRequestMessage(NetworkConnectionToClient conn, AuthRequestMessage msg) + { + //Debug.Log($"Authentication Request: {msg.authUsername} {msg.authPassword}"); + + if (connectionsPendingDisconnect.Contains(conn)) return; + + // check the credentials by calling your web server, database table, playfab api, or any method appropriate. + if (msg.authUsername == serverUsername && msg.authPassword == serverPassword) + { + // create and send msg to client so it knows to proceed + AuthResponseMessage authResponseMessage = new AuthResponseMessage + { + code = 100, + message = "Success" + }; + + conn.Send(authResponseMessage); + + // Accept the successful authentication + ServerAccept(conn); + } + else + { + connectionsPendingDisconnect.Add(conn); + + // create and send msg to client so it knows to disconnect + AuthResponseMessage authResponseMessage = new AuthResponseMessage + { + code = 200, + message = "Invalid Credentials" + }; + + conn.Send(authResponseMessage); + + // must set NetworkConnection isAuthenticated = false + conn.isAuthenticated = false; + + // disconnect the client after 1 second so that response message gets delivered + StartCoroutine(DelayedDisconnect(conn, 1f)); + } + } + + IEnumerator DelayedDisconnect(NetworkConnectionToClient conn, float waitTime) + { + yield return new WaitForSeconds(waitTime); + + // Reject the unsuccessful authentication + ServerReject(conn); + + yield return null; + + // remove conn from pending connections + connectionsPendingDisconnect.Remove(conn); + } + + #endregion + + #region Client + + /// + /// Called on client from StartClient to initialize the Authenticator + /// Client message handlers should be registered in this method. + /// + public override void OnStartClient() + { + // register a handler for the authentication response we expect from server + NetworkClient.RegisterHandler(OnAuthResponseMessage, false); + } + + /// + /// Called on client from StopClient to reset the Authenticator + /// Client message handlers should be unregistered in this method. + /// + public override void OnStopClient() + { + // unregister the handler for the authentication response + NetworkClient.UnregisterHandler(); + } + + /// + /// Called on client from OnClientConnectInternal when a client needs to authenticate + /// + public override void OnClientAuthenticate() + { + AuthRequestMessage authRequestMessage = new AuthRequestMessage + { + authUsername = username, + authPassword = password + }; + + NetworkClient.Send(authRequestMessage); + } + + /// + /// Called on client when the server's AuthResponseMessage arrives + /// + /// The message payload + public void OnAuthResponseMessage(AuthResponseMessage msg) + { + if (msg.code == 100) + { + //Debug.Log($"Authentication Response: {msg.message}"); + + // Authentication has been accepted + ClientAccept(); + } + else + { + Debug.LogError($"Authentication Response: {msg.message}"); + + // Authentication has been rejected + ClientReject(); + } + } + + #endregion + } +} diff --git a/Assets/Mirror/Authenticators/BasicAuthenticator.cs.meta b/Assets/Mirror/Authenticators/BasicAuthenticator.cs.meta new file mode 100644 index 0000000..4765013 --- /dev/null +++ b/Assets/Mirror/Authenticators/BasicAuthenticator.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 28496b776660156428f00cf78289c1ec +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Authenticators/DeviceAuthenticator.cs b/Assets/Mirror/Authenticators/DeviceAuthenticator.cs new file mode 100644 index 0000000..5e0ea56 --- /dev/null +++ b/Assets/Mirror/Authenticators/DeviceAuthenticator.cs @@ -0,0 +1,129 @@ +using System; +using UnityEngine; + +namespace Mirror.Authenticators +{ + /// + /// An authenticator that identifies the user by their device. + /// A GUID is used as a fallback when the platform doesn't support SystemInfo.deviceUniqueIdentifier. + /// Note: deviceUniqueIdentifier can be spoofed, so security is not guaranteed. + /// See https://docs.unity3d.com/ScriptReference/SystemInfo-deviceUniqueIdentifier.html for details. + /// + [AddComponentMenu("Network/ Authenticators/Device Authenticator")] + [HelpURL("https://mirror-networking.gitbook.io/docs/components/network-authenticators/device-authenticator")] + public class DeviceAuthenticator : NetworkAuthenticator + { + #region Messages + + public struct AuthRequestMessage : NetworkMessage + { + public string clientDeviceID; + } + + public struct AuthResponseMessage : NetworkMessage { } + + #endregion + + #region Server + + /// + /// Called on server from StartServer to initialize the Authenticator + /// Server message handlers should be registered in this method. + /// + public override void OnStartServer() + { + // register a handler for the authentication request we expect from client + NetworkServer.RegisterHandler(OnAuthRequestMessage, false); + } + + /// + /// Called on server from StopServer to reset the Authenticator + /// Server message handlers should be registered in this method. + /// + public override void OnStopServer() + { + // unregister the handler for the authentication request + NetworkServer.UnregisterHandler(); + } + + /// + /// Called on server from OnServerConnectInternal when a client needs to authenticate + /// + /// Connection to client. + public override void OnServerAuthenticate(NetworkConnectionToClient conn) + { + // do nothing, wait for client to send his id + } + + void OnAuthRequestMessage(NetworkConnectionToClient conn, AuthRequestMessage msg) + { + Debug.Log($"connection {conn.connectionId} authenticated with id {msg.clientDeviceID}"); + + // Store the device id for later reference, e.g. when spawning the player + conn.authenticationData = msg.clientDeviceID; + + // Send a response to client telling it to proceed as authenticated + conn.Send(new AuthResponseMessage()); + + // Accept the successful authentication + ServerAccept(conn); + } + + #endregion + + #region Client + + /// + /// Called on client from StartClient to initialize the Authenticator + /// Client message handlers should be registered in this method. + /// + public override void OnStartClient() + { + // register a handler for the authentication response we expect from server + NetworkClient.RegisterHandler(OnAuthResponseMessage, false); + } + + /// + /// Called on client from StopClient to reset the Authenticator + /// Client message handlers should be unregistered in this method. + /// + public override void OnStopClient() + { + // unregister the handler for the authentication response + NetworkClient.UnregisterHandler(); + } + + /// + /// Called on client from OnClientConnectInternal when a client needs to authenticate + /// + public override void OnClientAuthenticate() + { + string deviceUniqueIdentifier = SystemInfo.deviceUniqueIdentifier; + + // Not all platforms support this, so we use a GUID instead + if (deviceUniqueIdentifier == SystemInfo.unsupportedIdentifier) + { + // Get the value from PlayerPrefs if it exists, new GUID if it doesn't + deviceUniqueIdentifier = PlayerPrefs.GetString("deviceUniqueIdentifier", Guid.NewGuid().ToString()); + + // Store the deviceUniqueIdentifier to PlayerPrefs (in case we just made a new GUID) + PlayerPrefs.SetString("deviceUniqueIdentifier", deviceUniqueIdentifier); + } + + // send the deviceUniqueIdentifier to the server + NetworkClient.Send(new AuthRequestMessage { clientDeviceID = deviceUniqueIdentifier } ); + } + + /// + /// Called on client when the server's AuthResponseMessage arrives + /// + /// The message payload + public void OnAuthResponseMessage(AuthResponseMessage msg) + { + Debug.Log("Authentication Success"); + ClientAccept(); + } + + #endregion + } +} diff --git a/Assets/Mirror/Authenticators/DeviceAuthenticator.cs.meta b/Assets/Mirror/Authenticators/DeviceAuthenticator.cs.meta new file mode 100644 index 0000000..9ca9f64 --- /dev/null +++ b/Assets/Mirror/Authenticators/DeviceAuthenticator.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 60960a6ba81a842deb2fdcdc93788242 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Authenticators/Mirror.Authenticators.asmdef b/Assets/Mirror/Authenticators/Mirror.Authenticators.asmdef new file mode 100644 index 0000000..70eacf3 --- /dev/null +++ b/Assets/Mirror/Authenticators/Mirror.Authenticators.asmdef @@ -0,0 +1,16 @@ +{ + "name": "Mirror.Authenticators", + "rootNamespace": "", + "references": [ + "GUID:30817c1a0e6d646d99c048fc403f5979" + ], + "includePlatforms": [], + "excludePlatforms": [], + "allowUnsafeCode": false, + "overrideReferences": false, + "precompiledReferences": [], + "autoReferenced": true, + "defineConstraints": [], + "versionDefines": [], + "noEngineReferences": false +} \ No newline at end of file diff --git a/Assets/Mirror/Authenticators/Mirror.Authenticators.asmdef.meta b/Assets/Mirror/Authenticators/Mirror.Authenticators.asmdef.meta new file mode 100644 index 0000000..2731701 --- /dev/null +++ b/Assets/Mirror/Authenticators/Mirror.Authenticators.asmdef.meta @@ -0,0 +1,7 @@ +fileFormatVersion: 2 +guid: e720aa64e3f58fb4880566a322584340 +AssemblyDefinitionImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Authenticators/TimeoutAuthenticator.cs b/Assets/Mirror/Authenticators/TimeoutAuthenticator.cs new file mode 100644 index 0000000..711ee6e --- /dev/null +++ b/Assets/Mirror/Authenticators/TimeoutAuthenticator.cs @@ -0,0 +1,70 @@ +using System.Collections; +using UnityEngine; + +namespace Mirror.Authenticators +{ + /// + /// An authenticator that disconnects connections if they don't + /// authenticate within a specified time limit. + /// + [AddComponentMenu("Network/ Authenticators/Timeout Authenticator")] + public class TimeoutAuthenticator : NetworkAuthenticator + { + public NetworkAuthenticator authenticator; + + [Range(0, 600), Tooltip("Timeout to auto-disconnect in seconds. Set to 0 for no timeout.")] + public float timeout = 60; + + public void Awake() + { + authenticator.OnServerAuthenticated.AddListener(connection => OnServerAuthenticated.Invoke(connection)); + authenticator.OnClientAuthenticated.AddListener(OnClientAuthenticated.Invoke); + } + + public override void OnStartServer() + { + authenticator.OnStartServer(); + } + + public override void OnStopServer() + { + authenticator.OnStopServer(); + } + + public override void OnStartClient() + { + authenticator.OnStartClient(); + } + + public override void OnStopClient() + { + authenticator.OnStopClient(); + } + + public override void OnServerAuthenticate(NetworkConnectionToClient conn) + { + authenticator.OnServerAuthenticate(conn); + if (timeout > 0) + StartCoroutine(BeginAuthentication(conn)); + } + + public override void OnClientAuthenticate() + { + authenticator.OnClientAuthenticate(); + if (timeout > 0) + StartCoroutine(BeginAuthentication(NetworkClient.connection)); + } + + IEnumerator BeginAuthentication(NetworkConnection conn) + { + //Debug.Log($"Authentication countdown started {conn} {timeout}"); + yield return new WaitForSecondsRealtime(timeout); + + if (!conn.isAuthenticated) + { + Debug.LogError($"Authentication Timeout - Disconnecting {conn}"); + conn.Disconnect(); + } + } + } +} diff --git a/Assets/Mirror/Authenticators/TimeoutAuthenticator.cs.meta b/Assets/Mirror/Authenticators/TimeoutAuthenticator.cs.meta new file mode 100644 index 0000000..b19ddec --- /dev/null +++ b/Assets/Mirror/Authenticators/TimeoutAuthenticator.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 24d8269a07b8e4edfa374753a91c946e +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/CompilerSymbols.meta b/Assets/Mirror/CompilerSymbols.meta new file mode 100644 index 0000000..4652ae1 --- /dev/null +++ b/Assets/Mirror/CompilerSymbols.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: 1f8b918bcd89f5c488b06f5574f34760 +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/CompilerSymbols/Mirror.CompilerSymbols.asmdef b/Assets/Mirror/CompilerSymbols/Mirror.CompilerSymbols.asmdef new file mode 100644 index 0000000..af25622 --- /dev/null +++ b/Assets/Mirror/CompilerSymbols/Mirror.CompilerSymbols.asmdef @@ -0,0 +1,14 @@ +{ + "name": "Mirror.CompilerSymbols", + "references": [], + "optionalUnityReferences": [], + "includePlatforms": [ + "Editor" + ], + "excludePlatforms": [], + "allowUnsafeCode": false, + "overrideReferences": false, + "precompiledReferences": [], + "autoReferenced": true, + "defineConstraints": [] +} \ No newline at end of file diff --git a/Assets/Mirror/CompilerSymbols/Mirror.CompilerSymbols.asmdef.meta b/Assets/Mirror/CompilerSymbols/Mirror.CompilerSymbols.asmdef.meta new file mode 100644 index 0000000..8b23823 --- /dev/null +++ b/Assets/Mirror/CompilerSymbols/Mirror.CompilerSymbols.asmdef.meta @@ -0,0 +1,7 @@ +fileFormatVersion: 2 +guid: 325984b52e4128546bc7558552f8b1d2 +AssemblyDefinitionImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/CompilerSymbols/PreprocessorDefine.cs b/Assets/Mirror/CompilerSymbols/PreprocessorDefine.cs new file mode 100644 index 0000000..79775a7 --- /dev/null +++ b/Assets/Mirror/CompilerSymbols/PreprocessorDefine.cs @@ -0,0 +1,49 @@ +using System.Collections.Generic; +using UnityEditor; + +namespace Mirror +{ + static class PreprocessorDefine + { + /// + /// Add define symbols as soon as Unity gets done compiling. + /// + [InitializeOnLoadMethod] + public static void AddDefineSymbols() + { +#if UNITY_2021_2_OR_NEWER + string currentDefines = PlayerSettings.GetScriptingDefineSymbols(UnityEditor.Build.NamedBuildTarget.FromBuildTargetGroup(EditorUserBuildSettings.selectedBuildTargetGroup)); +#else + // Deprecated in Unity 2023.1 + string currentDefines = PlayerSettings.GetScriptingDefineSymbolsForGroup(EditorUserBuildSettings.selectedBuildTargetGroup); +#endif + // Remove oldest when adding next month's symbol. + // Keep a rolling 12 months of symbols. + HashSet defines = new HashSet(currentDefines.Split(';')) + { + "MIRROR", + "MIRROR_79_OR_NEWER", + "MIRROR_81_OR_NEWER", + "MIRROR_82_OR_NEWER", + "MIRROR_83_OR_NEWER", + "MIRROR_84_OR_NEWER", + "MIRROR_85_OR_NEWER", + "MIRROR_86_OR_NEWER", + "MIRROR_89_OR_NEWER" + }; + + // only touch PlayerSettings if we actually modified it, + // otherwise it shows up as changed in git each time. + string newDefines = string.Join(";", defines); + if (newDefines != currentDefines) + { +#if UNITY_2021_2_OR_NEWER + PlayerSettings.SetScriptingDefineSymbols(UnityEditor.Build.NamedBuildTarget.FromBuildTargetGroup(EditorUserBuildSettings.selectedBuildTargetGroup), newDefines); +#else + // Deprecated in Unity 2023.1 + PlayerSettings.SetScriptingDefineSymbolsForGroup(EditorUserBuildSettings.selectedBuildTargetGroup, newDefines); +#endif + } + } + } +} diff --git a/Assets/Mirror/CompilerSymbols/PreprocessorDefine.cs.meta b/Assets/Mirror/CompilerSymbols/PreprocessorDefine.cs.meta new file mode 100644 index 0000000..6306c16 --- /dev/null +++ b/Assets/Mirror/CompilerSymbols/PreprocessorDefine.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: f1d66fe74ec6f42dd974cba37d25d453 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components.meta b/Assets/Mirror/Components.meta new file mode 100644 index 0000000..c2771d9 --- /dev/null +++ b/Assets/Mirror/Components.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: 9bee879fbc8ef4b1a9a9f7088bfbf726 +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/AssemblyInfo.cs b/Assets/Mirror/Components/AssemblyInfo.cs new file mode 100644 index 0000000..f342716 --- /dev/null +++ b/Assets/Mirror/Components/AssemblyInfo.cs @@ -0,0 +1,12 @@ +using System.Runtime.CompilerServices; + +[assembly: InternalsVisibleTo("Mirror.Tests.Common")] +[assembly: InternalsVisibleTo("Mirror.Tests")] +// need to use Unity.*.CodeGen assembly name to import Unity.CompilationPipeline +// for ILPostProcessor tests. +[assembly: InternalsVisibleTo("Unity.Mirror.Tests.CodeGen")] +[assembly: InternalsVisibleTo("Mirror.Tests.Generated")] +[assembly: InternalsVisibleTo("Mirror.Tests.Runtime")] +[assembly: InternalsVisibleTo("Mirror.Tests.Performance.Editor")] +[assembly: InternalsVisibleTo("Mirror.Tests.Performance.Runtime")] +[assembly: InternalsVisibleTo("Mirror.Editor")] diff --git a/Assets/Mirror/Components/AssemblyInfo.cs.meta b/Assets/Mirror/Components/AssemblyInfo.cs.meta new file mode 100644 index 0000000..f9af1fa --- /dev/null +++ b/Assets/Mirror/Components/AssemblyInfo.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: a65b9283f7a724e70b8e17cb277f4c1e +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/Discovery.meta b/Assets/Mirror/Components/Discovery.meta new file mode 100644 index 0000000..d5bb0cb --- /dev/null +++ b/Assets/Mirror/Components/Discovery.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: b5dcf9618f5e14a4eb60bff5480284a6 +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/Discovery/NetworkDiscovery.cs b/Assets/Mirror/Components/Discovery/NetworkDiscovery.cs new file mode 100644 index 0000000..5fa9397 --- /dev/null +++ b/Assets/Mirror/Components/Discovery/NetworkDiscovery.cs @@ -0,0 +1,93 @@ +using System; +using System.Net; +using UnityEngine; +using UnityEngine.Events; + +namespace Mirror.Discovery +{ + [Serializable] + public class ServerFoundUnityEvent : UnityEvent {}; + + [DisallowMultipleComponent] + [AddComponentMenu("Network/Network Discovery")] + public class NetworkDiscovery : NetworkDiscoveryBase + { + #region Server + + /// + /// Process the request from a client + /// + /// + /// Override if you wish to provide more information to the clients + /// such as the name of the host player + /// + /// Request coming from client + /// Address of the client that sent the request + /// The message to be sent back to the client or null + protected override ServerResponse ProcessRequest(ServerRequest request, IPEndPoint endpoint) + { + // In this case we don't do anything with the request + // but other discovery implementations might want to use the data + // in there, This way the client can ask for + // specific game mode or something + + try + { + // this is an example reply message, return your own + // to include whatever is relevant for your game + return new ServerResponse + { + serverId = ServerId, + uri = transport.ServerUri() + }; + } + catch (NotImplementedException) + { + Debug.LogError($"Transport {transport} does not support network discovery"); + throw; + } + } + + #endregion + + #region Client + + /// + /// Create a message that will be broadcasted on the network to discover servers + /// + /// + /// Override if you wish to include additional data in the discovery message + /// such as desired game mode, language, difficulty, etc... + /// An instance of ServerRequest with data to be broadcasted + protected override ServerRequest GetRequest() => new ServerRequest(); + + /// + /// Process the answer from a server + /// + /// + /// A client receives a reply from a server, this method processes the + /// reply and raises an event + /// + /// Response that came from the server + /// Address of the server that replied + protected override void ProcessResponse(ServerResponse response, IPEndPoint endpoint) + { + // we received a message from the remote endpoint + response.EndPoint = endpoint; + + // although we got a supposedly valid url, we may not be able to resolve + // the provided host + // However we know the real ip address of the server because we just + // received a packet from it, so use that as host. + UriBuilder realUri = new UriBuilder(response.uri) + { + Host = response.EndPoint.Address.ToString() + }; + response.uri = realUri.Uri; + + OnServerFound.Invoke(response); + } + + #endregion + } +} diff --git a/Assets/Mirror/Components/Discovery/NetworkDiscovery.cs.meta b/Assets/Mirror/Components/Discovery/NetworkDiscovery.cs.meta new file mode 100644 index 0000000..c691a61 --- /dev/null +++ b/Assets/Mirror/Components/Discovery/NetworkDiscovery.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: c761308e733c51245b2e8bb4201f46dc +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/Discovery/NetworkDiscoveryBase.cs b/Assets/Mirror/Components/Discovery/NetworkDiscoveryBase.cs new file mode 100644 index 0000000..4417344 --- /dev/null +++ b/Assets/Mirror/Components/Discovery/NetworkDiscoveryBase.cs @@ -0,0 +1,470 @@ +using System; +using System.Net; +using System.Net.Sockets; +using System.Threading.Tasks; +using UnityEngine; + +// Based on https://github.com/EnlightenedOne/MirrorNetworkDiscovery +// forked from https://github.com/in0finite/MirrorNetworkDiscovery +// Both are MIT Licensed + +namespace Mirror.Discovery +{ + /// + /// Base implementation for Network Discovery. Extend this component + /// to provide custom discovery with game specific data + /// NetworkDiscovery for a sample implementation + /// + [DisallowMultipleComponent] + [HelpURL("https://mirror-networking.gitbook.io/docs/components/network-discovery")] + public abstract class NetworkDiscoveryBase : MonoBehaviour + where Request : NetworkMessage + where Response : NetworkMessage + { + public static bool SupportedOnThisPlatform { get { return Application.platform != RuntimePlatform.WebGLPlayer; } } + + [SerializeField] + [Tooltip("If true, broadcasts a discovery request every ActiveDiscoveryInterval seconds")] + public bool enableActiveDiscovery = true; + + // broadcast address needs to be configurable on iOS: + // https://github.com/vis2k/Mirror/pull/3255 + [Tooltip("iOS may require LAN IP address here (e.g. 192.168.x.x), otherwise leave blank.")] + public string BroadcastAddress = ""; + + [SerializeField] + [Tooltip("The UDP port the server will listen for multi-cast messages")] + protected int serverBroadcastListenPort = 47777; + + [SerializeField] + [Tooltip("Time in seconds between multi-cast messages")] + [Range(1, 60)] + float ActiveDiscoveryInterval = 3; + + [Tooltip("Transport to be advertised during discovery")] + public Transport transport; + + [Tooltip("Invoked when a server is found")] + public ServerFoundUnityEvent OnServerFound; + + // Each game should have a random unique handshake, + // this way you can tell if this is the same game or not + [HideInInspector] + public long secretHandshake; + + public long ServerId { get; private set; } + + protected UdpClient serverUdpClient; + protected UdpClient clientUdpClient; + +#if UNITY_EDITOR + public virtual void OnValidate() + { + if (transport == null) + transport = GetComponent(); + + if (secretHandshake == 0) + { + secretHandshake = RandomLong(); + UnityEditor.Undo.RecordObject(this, "Set secret handshake"); + } + } +#endif + + /// + /// virtual so that inheriting classes' Start() can call base.Start() too + /// + public virtual void Start() + { + ServerId = RandomLong(); + + // active transport gets initialized in Awake + // so make sure we set it here in Start() after Awake + // Or just let the user assign it in the inspector + if (transport == null) + transport = Transport.active; + + // Server mode? then start advertising + if (Utils.IsHeadless()) + { + AdvertiseServer(); + } + } + + public static long RandomLong() + { + int value1 = UnityEngine.Random.Range(int.MinValue, int.MaxValue); + int value2 = UnityEngine.Random.Range(int.MinValue, int.MaxValue); + return value1 + ((long)value2 << 32); + } + + // Ensure the ports are cleared no matter when Game/Unity UI exits + void OnApplicationQuit() + { + //Debug.Log("NetworkDiscoveryBase OnApplicationQuit"); + Shutdown(); + } + + void OnDisable() + { + //Debug.Log("NetworkDiscoveryBase OnDisable"); + Shutdown(); + } + + void OnDestroy() + { + //Debug.Log("NetworkDiscoveryBase OnDestroy"); + Shutdown(); + } + + void Shutdown() + { + EndpMulticastLock(); + if (serverUdpClient != null) + { + try + { + serverUdpClient.Close(); + } + catch (Exception) + { + // it is just close, swallow the error + } + + serverUdpClient = null; + } + + if (clientUdpClient != null) + { + try + { + clientUdpClient.Close(); + } + catch (Exception) + { + // it is just close, swallow the error + } + + clientUdpClient = null; + } + + CancelInvoke(); + } + + #region Server + + /// + /// Advertise this server in the local network + /// + public void AdvertiseServer() + { + if (!SupportedOnThisPlatform) + throw new PlatformNotSupportedException("Network discovery not supported in this platform"); + + StopDiscovery(); + + // Setup port -- may throw exception + serverUdpClient = new UdpClient(serverBroadcastListenPort) + { + EnableBroadcast = true, + MulticastLoopback = false + }; + + // listen for client pings + _ = ServerListenAsync(); + } + + public async Task ServerListenAsync() + { + BeginMulticastLock(); + while (true) + { + try + { + await ReceiveRequestAsync(serverUdpClient); + } + catch (ObjectDisposedException) + { + // socket has been closed + break; + } + catch (Exception) {} + } + } + + async Task ReceiveRequestAsync(UdpClient udpClient) + { + // only proceed if there is available data in network buffer, or otherwise Receive() will block + // average time for UdpClient.Available : 10 us + + UdpReceiveResult udpReceiveResult = await udpClient.ReceiveAsync(); + + using (NetworkReaderPooled networkReader = NetworkReaderPool.Get(udpReceiveResult.Buffer)) + { + long handshake = networkReader.ReadLong(); + if (handshake != secretHandshake) + { + // message is not for us + throw new ProtocolViolationException("Invalid handshake"); + } + + Request request = networkReader.Read(); + + ProcessClientRequest(request, udpReceiveResult.RemoteEndPoint); + } + } + + /// + /// Reply to the client to inform it of this server + /// + /// + /// Override if you wish to ignore server requests based on + /// custom criteria such as language, full server game mode or difficulty + /// + /// Request coming from client + /// Address of the client that sent the request + protected virtual void ProcessClientRequest(Request request, IPEndPoint endpoint) + { + Response info = ProcessRequest(request, endpoint); + + if (info == null) + return; + + using (NetworkWriterPooled writer = NetworkWriterPool.Get()) + { + try + { + writer.WriteLong(secretHandshake); + + writer.Write(info); + + ArraySegment data = writer.ToArraySegment(); + // signature matches + // send response + serverUdpClient.Send(data.Array, data.Count, endpoint); + } + catch (Exception ex) + { + Debug.LogException(ex, this); + } + } + } + + /// + /// Process the request from a client + /// + /// + /// Override if you wish to provide more information to the clients + /// such as the name of the host player + /// + /// Request coming from client + /// Address of the client that sent the request + /// The message to be sent back to the client or null + protected abstract Response ProcessRequest(Request request, IPEndPoint endpoint); + + // Android Multicast fix: https://github.com/vis2k/Mirror/pull/2887 +#if UNITY_ANDROID + AndroidJavaObject multicastLock; + bool hasMulticastLock; +#endif + + void BeginMulticastLock() + { +#if UNITY_ANDROID + if (hasMulticastLock) return; + + if (Application.platform == RuntimePlatform.Android) + { + using (AndroidJavaObject activity = new AndroidJavaClass("com.unity3d.player.UnityPlayer").GetStatic("currentActivity")) + { + using (var wifiManager = activity.Call("getSystemService", "wifi")) + { + multicastLock = wifiManager.Call("createMulticastLock", "lock"); + multicastLock.Call("acquire"); + hasMulticastLock = true; + } + } + } +#endif + } + + void EndpMulticastLock() + { +#if UNITY_ANDROID + if (!hasMulticastLock) return; + + multicastLock?.Call("release"); + hasMulticastLock = false; +#endif + } + +#endregion + + #region Client + + /// + /// Start Active Discovery + /// + public void StartDiscovery() + { + if (!SupportedOnThisPlatform) + throw new PlatformNotSupportedException("Network discovery not supported in this platform"); + + StopDiscovery(); + + try + { + // Setup port + clientUdpClient = new UdpClient(0) + { + EnableBroadcast = true, + MulticastLoopback = false + }; + } + catch (Exception) + { + // Free the port if we took it + //Debug.LogError("NetworkDiscoveryBase StartDiscovery Exception"); + Shutdown(); + throw; + } + + _ = ClientListenAsync(); + + if (enableActiveDiscovery) InvokeRepeating(nameof(BroadcastDiscoveryRequest), 0, ActiveDiscoveryInterval); + } + + /// + /// Stop Active Discovery + /// + public void StopDiscovery() + { + //Debug.Log("NetworkDiscoveryBase StopDiscovery"); + Shutdown(); + } + + /// + /// Awaits for server response + /// + /// ClientListenAsync Task + public async Task ClientListenAsync() + { + // while clientUpdClient to fix: + // https://github.com/vis2k/Mirror/pull/2908 + // + // If, you cancel discovery the clientUdpClient is set to null. + // However, nothing cancels ClientListenAsync. If we change the if(true) + // to check if the client is null. You can properly cancel the discovery, + // and kill the listen thread. + // + // Prior to this fix, if you cancel the discovery search. It crashes the + // thread, and is super noisy in the output. As well as causes issues on + // the quest. + while (clientUdpClient != null) + { + try + { + await ReceiveGameBroadcastAsync(clientUdpClient); + } + catch (ObjectDisposedException) + { + // socket was closed, no problem + return; + } + catch (Exception ex) + { + Debug.LogException(ex); + } + } + } + + /// + /// Sends discovery request from client + /// + public void BroadcastDiscoveryRequest() + { + if (clientUdpClient == null) + return; + + if (NetworkClient.isConnected) + { + StopDiscovery(); + return; + } + + IPEndPoint endPoint = new IPEndPoint(IPAddress.Broadcast, serverBroadcastListenPort); + + if (!string.IsNullOrWhiteSpace(BroadcastAddress)) + { + try + { + endPoint = new IPEndPoint(IPAddress.Parse(BroadcastAddress), serverBroadcastListenPort); + } + catch (Exception ex) + { + Debug.LogException(ex); + } + } + + using (NetworkWriterPooled writer = NetworkWriterPool.Get()) + { + writer.WriteLong(secretHandshake); + + try + { + Request request = GetRequest(); + + writer.Write(request); + + ArraySegment data = writer.ToArraySegment(); + + clientUdpClient.SendAsync(data.Array, data.Count, endPoint); + } + catch (Exception) + { + // It is ok if we can't broadcast to one of the addresses + } + } + } + + /// + /// Create a message that will be broadcasted on the network to discover servers + /// + /// + /// Override if you wish to include additional data in the discovery message + /// such as desired game mode, language, difficulty, etc... + /// An instance of ServerRequest with data to be broadcasted + protected virtual Request GetRequest() => default; + + async Task ReceiveGameBroadcastAsync(UdpClient udpClient) + { + // only proceed if there is available data in network buffer, or otherwise Receive() will block + // average time for UdpClient.Available : 10 us + + UdpReceiveResult udpReceiveResult = await udpClient.ReceiveAsync(); + + using (NetworkReaderPooled networkReader = NetworkReaderPool.Get(udpReceiveResult.Buffer)) + { + if (networkReader.ReadLong() != secretHandshake) + return; + + Response response = networkReader.Read(); + + ProcessResponse(response, udpReceiveResult.RemoteEndPoint); + } + } + + /// + /// Process the answer from a server + /// + /// + /// A client receives a reply from a server, this method processes the + /// reply and raises an event + /// + /// Response that came from the server + /// Address of the server that replied + protected abstract void ProcessResponse(Response response, IPEndPoint endpoint); + + #endregion + } +} diff --git a/Assets/Mirror/Components/Discovery/NetworkDiscoveryBase.cs.meta b/Assets/Mirror/Components/Discovery/NetworkDiscoveryBase.cs.meta new file mode 100644 index 0000000..fecf845 --- /dev/null +++ b/Assets/Mirror/Components/Discovery/NetworkDiscoveryBase.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: b9971d60ce61f4e39b07cd9e7e0c68fa +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/Discovery/NetworkDiscoveryHUD.cs b/Assets/Mirror/Components/Discovery/NetworkDiscoveryHUD.cs new file mode 100644 index 0000000..e43c3d7 --- /dev/null +++ b/Assets/Mirror/Components/Discovery/NetworkDiscoveryHUD.cs @@ -0,0 +1,132 @@ +using System.Collections.Generic; +using UnityEngine; + +namespace Mirror.Discovery +{ + [DisallowMultipleComponent] + [AddComponentMenu("Network/Network Discovery HUD")] + [HelpURL("https://mirror-networking.gitbook.io/docs/components/network-discovery")] + [RequireComponent(typeof(NetworkDiscovery))] + public class NetworkDiscoveryHUD : MonoBehaviour + { + readonly Dictionary discoveredServers = new Dictionary(); + Vector2 scrollViewPos = Vector2.zero; + + public NetworkDiscovery networkDiscovery; + +#if UNITY_EDITOR + void OnValidate() + { + if (networkDiscovery == null) + { + networkDiscovery = GetComponent(); + UnityEditor.Events.UnityEventTools.AddPersistentListener(networkDiscovery.OnServerFound, OnDiscoveredServer); + UnityEditor.Undo.RecordObjects(new Object[] { this, networkDiscovery }, "Set NetworkDiscovery"); + } + } +#endif + + void OnGUI() + { + if (NetworkManager.singleton == null) + return; + + if (!NetworkClient.isConnected && !NetworkServer.active && !NetworkClient.active) + DrawGUI(); + + if (NetworkServer.active || NetworkClient.active) + StopButtons(); + } + + void DrawGUI() + { + GUILayout.BeginArea(new Rect(10, 10, 300, 500)); + GUILayout.BeginHorizontal(); + + if (GUILayout.Button("Find Servers")) + { + discoveredServers.Clear(); + networkDiscovery.StartDiscovery(); + } + + // LAN Host + if (GUILayout.Button("Start Host")) + { + discoveredServers.Clear(); + NetworkManager.singleton.StartHost(); + networkDiscovery.AdvertiseServer(); + } + + // Dedicated server + if (GUILayout.Button("Start Server")) + { + discoveredServers.Clear(); + NetworkManager.singleton.StartServer(); + networkDiscovery.AdvertiseServer(); + } + + GUILayout.EndHorizontal(); + + // show list of found server + + GUILayout.Label($"Discovered Servers [{discoveredServers.Count}]:"); + + // servers + scrollViewPos = GUILayout.BeginScrollView(scrollViewPos); + + foreach (ServerResponse info in discoveredServers.Values) + if (GUILayout.Button(info.EndPoint.Address.ToString())) + Connect(info); + + GUILayout.EndScrollView(); + GUILayout.EndArea(); + } + + void StopButtons() + { + GUILayout.BeginArea(new Rect(10, 40, 100, 25)); + + // stop host if host mode + if (NetworkServer.active && NetworkClient.isConnected) + { + if (GUILayout.Button("Stop Host")) + { + NetworkManager.singleton.StopHost(); + networkDiscovery.StopDiscovery(); + } + } + // stop client if client-only + else if (NetworkClient.isConnected) + { + if (GUILayout.Button("Stop Client")) + { + NetworkManager.singleton.StopClient(); + networkDiscovery.StopDiscovery(); + } + } + // stop server if server-only + else if (NetworkServer.active) + { + if (GUILayout.Button("Stop Server")) + { + NetworkManager.singleton.StopServer(); + networkDiscovery.StopDiscovery(); + } + } + + GUILayout.EndArea(); + } + + void Connect(ServerResponse info) + { + networkDiscovery.StopDiscovery(); + NetworkManager.singleton.StartClient(info.uri); + } + + public void OnDiscoveredServer(ServerResponse info) + { + // Note that you can check the versioning to decide if you can connect to the server or not using this method + discoveredServers[info.serverId] = info; + } + } +} diff --git a/Assets/Mirror/Components/Discovery/NetworkDiscoveryHUD.cs.meta b/Assets/Mirror/Components/Discovery/NetworkDiscoveryHUD.cs.meta new file mode 100644 index 0000000..f93b275 --- /dev/null +++ b/Assets/Mirror/Components/Discovery/NetworkDiscoveryHUD.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 88c37d3deca7a834d80cfd8d3cfcc510 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/Discovery/ServerRequest.cs b/Assets/Mirror/Components/Discovery/ServerRequest.cs new file mode 100644 index 0000000..647b619 --- /dev/null +++ b/Assets/Mirror/Components/Discovery/ServerRequest.cs @@ -0,0 +1,4 @@ +namespace Mirror.Discovery +{ + public struct ServerRequest : NetworkMessage {} +} diff --git a/Assets/Mirror/Components/Discovery/ServerRequest.cs.meta b/Assets/Mirror/Components/Discovery/ServerRequest.cs.meta new file mode 100644 index 0000000..a7e246c --- /dev/null +++ b/Assets/Mirror/Components/Discovery/ServerRequest.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: ea7254bf7b9454da4adad881d94cd141 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/Discovery/ServerResponse.cs b/Assets/Mirror/Components/Discovery/ServerResponse.cs new file mode 100644 index 0000000..7465783 --- /dev/null +++ b/Assets/Mirror/Components/Discovery/ServerResponse.cs @@ -0,0 +1,18 @@ +using System; +using System.Net; + +namespace Mirror.Discovery +{ + public struct ServerResponse : NetworkMessage + { + // The server that sent this + // this is a property so that it is not serialized, but the + // client fills this up after we receive it + public IPEndPoint EndPoint { get; set; } + + public Uri uri; + + // Prevent duplicate server appearance when a connection can be made via LAN on multiple NICs + public long serverId; + } +} \ No newline at end of file diff --git a/Assets/Mirror/Components/Discovery/ServerResponse.cs.meta b/Assets/Mirror/Components/Discovery/ServerResponse.cs.meta new file mode 100644 index 0000000..239b218 --- /dev/null +++ b/Assets/Mirror/Components/Discovery/ServerResponse.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 36f97227fdf2d7a4e902db5bfc43039c +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/Experimental.meta b/Assets/Mirror/Components/Experimental.meta new file mode 100644 index 0000000..57cce38 --- /dev/null +++ b/Assets/Mirror/Components/Experimental.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: bfbf2a1f2b300c5489dcab219ef2846e +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/Experimental/NetworkLerpRigidbody.cs b/Assets/Mirror/Components/Experimental/NetworkLerpRigidbody.cs new file mode 100644 index 0000000..adca7cb --- /dev/null +++ b/Assets/Mirror/Components/Experimental/NetworkLerpRigidbody.cs @@ -0,0 +1,97 @@ +using System; +using UnityEngine; + +namespace Mirror.Experimental +{ + [AddComponentMenu("Network/ Experimental/Network Lerp Rigidbody")] + [HelpURL("https://mirror-networking.gitbook.io/docs/components/network-lerp-rigidbody")] + [Obsolete("Use the new NetworkRigidbodyReliable/Unreliable component with Snapshot Interpolation instead.")] + public class NetworkLerpRigidbody : NetworkBehaviour + { + [Header("Settings")] + [SerializeField] internal Rigidbody target = null; + + [Tooltip("How quickly current velocity approaches target velocity")] + [SerializeField] float lerpVelocityAmount = 0.5f; + + [Tooltip("How quickly current position approaches target position")] + [SerializeField] float lerpPositionAmount = 0.5f; + + [Tooltip("Set to true if moves come from owner client, set to false if moves always come from server")] + [SerializeField] bool clientAuthority = false; + + double nextSyncTime; + + [SyncVar()] + Vector3 targetVelocity; + + [SyncVar()] + Vector3 targetPosition; + + /// + /// Ignore value if is host or client with Authority + /// + bool IgnoreSync => isServer || ClientWithAuthority; + + bool ClientWithAuthority => clientAuthority && isOwned; + + protected override void OnValidate() + { + base.OnValidate(); + Reset(); + } + + public virtual void Reset() + { + if (target == null) + target = GetComponent(); + + syncDirection = SyncDirection.ClientToServer; + } + + void Update() + { + if (isServer) + SyncToClients(); + else if (ClientWithAuthority) + SendToServer(); + } + + void SyncToClients() + { + targetVelocity = target.velocity; + targetPosition = target.position; + } + + void SendToServer() + { + double now = NetworkTime.localTime; // Unity 2019 doesn't have Time.timeAsDouble yet + if (now > nextSyncTime) + { + nextSyncTime = now + syncInterval; + CmdSendState(target.velocity, target.position); + } + } + + [Command] + void CmdSendState(Vector3 velocity, Vector3 position) + { + target.velocity = velocity; + target.position = position; + targetVelocity = velocity; + targetPosition = position; + } + + void FixedUpdate() + { + if (IgnoreSync) { return; } + + target.velocity = Vector3.Lerp(target.velocity, targetVelocity, lerpVelocityAmount); + target.position = Vector3.Lerp(target.position, targetPosition, lerpPositionAmount); + // add velocity to position as position would have moved on server at that velocity + target.position += target.velocity * Time.fixedDeltaTime; + + // TODO does this also need to sync acceleration so and update velocity? + } + } +} diff --git a/Assets/Mirror/Components/Experimental/NetworkLerpRigidbody.cs.meta b/Assets/Mirror/Components/Experimental/NetworkLerpRigidbody.cs.meta new file mode 100644 index 0000000..35ef1fe --- /dev/null +++ b/Assets/Mirror/Components/Experimental/NetworkLerpRigidbody.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 7f032128052c95a46afb0ddd97d994cc +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/Experimental/NetworkRigidbody.cs b/Assets/Mirror/Components/Experimental/NetworkRigidbody.cs new file mode 100644 index 0000000..aa204ad --- /dev/null +++ b/Assets/Mirror/Components/Experimental/NetworkRigidbody.cs @@ -0,0 +1,354 @@ +using System; +using UnityEngine; + +namespace Mirror.Experimental +{ + [AddComponentMenu("Network/ Experimental/Network Rigidbody")] + [HelpURL("https://mirror-networking.gitbook.io/docs/components/network-rigidbody")] + [Obsolete("Use the new NetworkRigidbodyReliable/Unreliable component with Snapshot Interpolation instead.")] + public class NetworkRigidbody : NetworkBehaviour + { + [Header("Settings")] + [SerializeField] internal Rigidbody target = null; + + [Tooltip("Set to true if moves come from owner client, set to false if moves always come from server")] + public bool clientAuthority = false; + + [Header("Velocity")] + [Tooltip("Syncs Velocity every SyncInterval")] + [SerializeField] bool syncVelocity = true; + + [Tooltip("Set velocity to 0 each frame (only works if syncVelocity is false")] + [SerializeField] bool clearVelocity = false; + + [Tooltip("Only Syncs Value if distance between previous and current is great than sensitivity")] + [SerializeField] float velocitySensitivity = 0.1f; + + [Header("Angular Velocity")] + [Tooltip("Syncs AngularVelocity every SyncInterval")] + [SerializeField] bool syncAngularVelocity = true; + + [Tooltip("Set angularVelocity to 0 each frame (only works if syncAngularVelocity is false")] + [SerializeField] bool clearAngularVelocity = false; + + [Tooltip("Only Syncs Value if distance between previous and current is great than sensitivity")] + [SerializeField] float angularVelocitySensitivity = 0.1f; + + /// + /// Values sent on client with authority after they are sent to the server + /// + readonly ClientSyncState previousValue = new ClientSyncState(); + + protected override void OnValidate() + { + base.OnValidate(); + Reset(); + } + + public virtual void Reset() + { + if (target == null) + target = GetComponent(); + + syncDirection = SyncDirection.ClientToServer; + } + + #region Sync vars + + [SyncVar(hook = nameof(OnVelocityChanged))] + Vector3 velocity; + + [SyncVar(hook = nameof(OnAngularVelocityChanged))] + Vector3 angularVelocity; + + [SyncVar(hook = nameof(OnIsKinematicChanged))] + bool isKinematic; + + [SyncVar(hook = nameof(OnUseGravityChanged))] + bool useGravity; + + [SyncVar(hook = nameof(OnuDragChanged))] + float drag; + + [SyncVar(hook = nameof(OnAngularDragChanged))] + float angularDrag; + + /// + /// Ignore value if is host or client with Authority + /// + /// + bool IgnoreSync => isServer || ClientWithAuthority; + + bool ClientWithAuthority => clientAuthority && isOwned; + + void OnVelocityChanged(Vector3 _, Vector3 newValue) + { + if (IgnoreSync) + return; + + target.velocity = newValue; + } + + void OnAngularVelocityChanged(Vector3 _, Vector3 newValue) + { + if (IgnoreSync) + return; + + target.angularVelocity = newValue; + } + + void OnIsKinematicChanged(bool _, bool newValue) + { + if (IgnoreSync) + return; + + target.isKinematic = newValue; + } + + void OnUseGravityChanged(bool _, bool newValue) + { + if (IgnoreSync) + return; + + target.useGravity = newValue; + } + + void OnuDragChanged(float _, float newValue) + { + if (IgnoreSync) + return; + + target.drag = newValue; + } + + void OnAngularDragChanged(float _, float newValue) + { + if (IgnoreSync) + return; + + target.angularDrag = newValue; + } + + #endregion + + internal void Update() + { + if (isServer) + SyncToClients(); + else if (ClientWithAuthority) + SendToServer(); + } + + internal void FixedUpdate() + { + if (clearAngularVelocity && !syncAngularVelocity) + target.angularVelocity = Vector3.zero; + + if (clearVelocity && !syncVelocity) + target.velocity = Vector3.zero; + } + + /// + /// Updates sync var values on server so that they sync to the client + /// + [Server] + void SyncToClients() + { + // only update if they have changed more than Sensitivity + + Vector3 currentVelocity = syncVelocity ? target.velocity : default; + Vector3 currentAngularVelocity = syncAngularVelocity ? target.angularVelocity : default; + + bool velocityChanged = syncVelocity && ((previousValue.velocity - currentVelocity).sqrMagnitude > velocitySensitivity * velocitySensitivity); + bool angularVelocityChanged = syncAngularVelocity && ((previousValue.angularVelocity - currentAngularVelocity).sqrMagnitude > angularVelocitySensitivity * angularVelocitySensitivity); + + if (velocityChanged) + { + velocity = currentVelocity; + previousValue.velocity = currentVelocity; + } + + if (angularVelocityChanged) + { + angularVelocity = currentAngularVelocity; + previousValue.angularVelocity = currentAngularVelocity; + } + + // other rigidbody settings + isKinematic = target.isKinematic; + useGravity = target.useGravity; + drag = target.drag; + angularDrag = target.angularDrag; + } + + /// + /// Uses Command to send values to server + /// + [Client] + void SendToServer() + { + if (!isOwned) + { + Debug.LogWarning("SendToServer called without authority"); + return; + } + + SendVelocity(); + SendRigidBodySettings(); + } + + [Client] + void SendVelocity() + { + double now = NetworkTime.localTime; // Unity 2019 doesn't have Time.timeAsDouble yet + if (now < previousValue.nextSyncTime) + return; + + Vector3 currentVelocity = syncVelocity ? target.velocity : default; + Vector3 currentAngularVelocity = syncAngularVelocity ? target.angularVelocity : default; + + bool velocityChanged = syncVelocity && ((previousValue.velocity - currentVelocity).sqrMagnitude > velocitySensitivity * velocitySensitivity); + bool angularVelocityChanged = syncAngularVelocity && ((previousValue.angularVelocity - currentAngularVelocity).sqrMagnitude > angularVelocitySensitivity * angularVelocitySensitivity); + + // if angularVelocity has changed it is likely that velocity has also changed so just sync both values + // however if only velocity has changed just send velocity + if (angularVelocityChanged) + { + CmdSendVelocityAndAngular(currentVelocity, currentAngularVelocity); + previousValue.velocity = currentVelocity; + previousValue.angularVelocity = currentAngularVelocity; + } + else if (velocityChanged) + { + CmdSendVelocity(currentVelocity); + previousValue.velocity = currentVelocity; + } + + + // only update syncTime if either has changed + if (angularVelocityChanged || velocityChanged) + previousValue.nextSyncTime = now + syncInterval; + } + + [Client] + void SendRigidBodySettings() + { + // These shouldn't change often so it is ok to send in their own Command + if (previousValue.isKinematic != target.isKinematic) + { + CmdSendIsKinematic(target.isKinematic); + previousValue.isKinematic = target.isKinematic; + } + if (previousValue.useGravity != target.useGravity) + { + CmdSendUseGravity(target.useGravity); + previousValue.useGravity = target.useGravity; + } + if (previousValue.drag != target.drag) + { + CmdSendDrag(target.drag); + previousValue.drag = target.drag; + } + if (previousValue.angularDrag != target.angularDrag) + { + CmdSendAngularDrag(target.angularDrag); + previousValue.angularDrag = target.angularDrag; + } + } + + /// + /// Called when only Velocity has changed on the client + /// + [Command] + void CmdSendVelocity(Vector3 velocity) + { + // Ignore messages from client if not in client authority mode + if (!clientAuthority) + return; + + this.velocity = velocity; + target.velocity = velocity; + } + + /// + /// Called when angularVelocity has changed on the client + /// + [Command] + void CmdSendVelocityAndAngular(Vector3 velocity, Vector3 angularVelocity) + { + // Ignore messages from client if not in client authority mode + if (!clientAuthority) + return; + + if (syncVelocity) + { + this.velocity = velocity; + target.velocity = velocity; + } + + this.angularVelocity = angularVelocity; + target.angularVelocity = angularVelocity; + } + + [Command] + void CmdSendIsKinematic(bool isKinematic) + { + // Ignore messages from client if not in client authority mode + if (!clientAuthority) + return; + + this.isKinematic = isKinematic; + target.isKinematic = isKinematic; + } + + [Command] + void CmdSendUseGravity(bool useGravity) + { + // Ignore messages from client if not in client authority mode + if (!clientAuthority) + return; + + this.useGravity = useGravity; + target.useGravity = useGravity; + } + + [Command] + void CmdSendDrag(float drag) + { + // Ignore messages from client if not in client authority mode + if (!clientAuthority) + return; + + this.drag = drag; + target.drag = drag; + } + + [Command] + void CmdSendAngularDrag(float angularDrag) + { + // Ignore messages from client if not in client authority mode + if (!clientAuthority) + return; + + this.angularDrag = angularDrag; + target.angularDrag = angularDrag; + } + + /// + /// holds previously synced values + /// + public class ClientSyncState + { + /// + /// Next sync time that velocity will be synced, based on syncInterval. + /// + public double nextSyncTime; + public Vector3 velocity; + public Vector3 angularVelocity; + public bool isKinematic; + public bool useGravity; + public float drag; + public float angularDrag; + } + } +} diff --git a/Assets/Mirror/Components/Experimental/NetworkRigidbody.cs.meta b/Assets/Mirror/Components/Experimental/NetworkRigidbody.cs.meta new file mode 100644 index 0000000..1610f0a --- /dev/null +++ b/Assets/Mirror/Components/Experimental/NetworkRigidbody.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 83392ae5c1b731446909f252fd494ae4 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/Experimental/NetworkRigidbody2D.cs b/Assets/Mirror/Components/Experimental/NetworkRigidbody2D.cs new file mode 100644 index 0000000..ba68374 --- /dev/null +++ b/Assets/Mirror/Components/Experimental/NetworkRigidbody2D.cs @@ -0,0 +1,349 @@ +using UnityEngine; + +namespace Mirror.Experimental +{ + [AddComponentMenu("Network/ Experimental/Network Rigidbody 2D")] + [HelpURL("https://mirror-networking.gitbook.io/docs/components/network-rigidbody")] + public class NetworkRigidbody2D : NetworkBehaviour + { + [Header("Settings")] + [SerializeField] internal Rigidbody2D target = null; + + [Tooltip("Set to true if moves come from owner client, set to false if moves always come from server")] + public bool clientAuthority = false; + + [Header("Velocity")] + [Tooltip("Syncs Velocity every SyncInterval")] + [SerializeField] bool syncVelocity = true; + + [Tooltip("Set velocity to 0 each frame (only works if syncVelocity is false")] + [SerializeField] bool clearVelocity = false; + + [Tooltip("Only Syncs Value if distance between previous and current is great than sensitivity")] + [SerializeField] float velocitySensitivity = 0.1f; + + [Header("Angular Velocity")] + [Tooltip("Syncs AngularVelocity every SyncInterval")] + [SerializeField] bool syncAngularVelocity = true; + + [Tooltip("Set angularVelocity to 0 each frame (only works if syncAngularVelocity is false")] + [SerializeField] bool clearAngularVelocity = false; + + [Tooltip("Only Syncs Value if distance between previous and current is great than sensitivity")] + [SerializeField] float angularVelocitySensitivity = 0.1f; + + /// + /// Values sent on client with authority after they are sent to the server + /// + readonly ClientSyncState previousValue = new ClientSyncState(); + + protected override void OnValidate() + { + base.OnValidate(); + Reset(); + } + + public virtual void Reset() + { + if (target == null) + target = GetComponent(); + + syncDirection = SyncDirection.ClientToServer; + } + + #region Sync vars + + [SyncVar(hook = nameof(OnVelocityChanged))] + Vector2 velocity; + + [SyncVar(hook = nameof(OnAngularVelocityChanged))] + float angularVelocity; + + [SyncVar(hook = nameof(OnIsKinematicChanged))] + bool isKinematic; + + [SyncVar(hook = nameof(OnGravityScaleChanged))] + float gravityScale; + + [SyncVar(hook = nameof(OnuDragChanged))] + float drag; + + [SyncVar(hook = nameof(OnAngularDragChanged))] + float angularDrag; + + /// + /// Ignore value if is host or client with Authority + /// + bool IgnoreSync => isServer || ClientWithAuthority; + + bool ClientWithAuthority => clientAuthority && isOwned; + + void OnVelocityChanged(Vector2 _, Vector2 newValue) + { + if (IgnoreSync) + return; + + target.linearVelocity = newValue; + } + + void OnAngularVelocityChanged(float _, float newValue) + { + if (IgnoreSync) + return; + + target.angularVelocity = newValue; + } + + void OnIsKinematicChanged(bool _, bool newValue) + { + if (IgnoreSync) + return; + + target.isKinematic = newValue; + } + + void OnGravityScaleChanged(float _, float newValue) + { + if (IgnoreSync) + return; + + target.gravityScale = newValue; + } + + void OnuDragChanged(float _, float newValue) + { + if (IgnoreSync) + return; + + target.linearDamping = newValue; + } + + void OnAngularDragChanged(float _, float newValue) + { + if (IgnoreSync) + return; + + target.angularDamping = newValue; + } + + #endregion + + internal void Update() + { + if (isServer) + SyncToClients(); + else if (ClientWithAuthority) + SendToServer(); + } + + internal void FixedUpdate() + { + if (clearAngularVelocity && !syncAngularVelocity) + target.angularVelocity = 0f; + + if (clearVelocity && !syncVelocity) + target.linearVelocity = Vector2.zero; + } + + /// + /// Updates sync var values on server so that they sync to the client + /// + [Server] + void SyncToClients() + { + // only update if they have changed more than Sensitivity + + Vector2 currentVelocity = syncVelocity ? target.linearVelocity : default; + float currentAngularVelocity = syncAngularVelocity ? target.angularVelocity : default; + + bool velocityChanged = syncVelocity && ((previousValue.velocity - currentVelocity).sqrMagnitude > velocitySensitivity * velocitySensitivity); + bool angularVelocityChanged = syncAngularVelocity && ((previousValue.angularVelocity - currentAngularVelocity) > angularVelocitySensitivity); + + if (velocityChanged) + { + velocity = currentVelocity; + previousValue.velocity = currentVelocity; + } + + if (angularVelocityChanged) + { + angularVelocity = currentAngularVelocity; + previousValue.angularVelocity = currentAngularVelocity; + } + + // other rigidbody settings + isKinematic = target.isKinematic; + gravityScale = target.gravityScale; + drag = target.linearDamping; + angularDrag = target.angularDamping; + } + + /// + /// Uses Command to send values to server + /// + [Client] + void SendToServer() + { + if (!isOwned) + { + Debug.LogWarning("SendToServer called without authority"); + return; + } + + SendVelocity(); + SendRigidBodySettings(); + } + + [Client] + void SendVelocity() + { + float now = Time.time; + if (now < previousValue.nextSyncTime) + return; + + Vector2 currentVelocity = syncVelocity ? target.linearVelocity : default; + float currentAngularVelocity = syncAngularVelocity ? target.angularVelocity : default; + + bool velocityChanged = syncVelocity && ((previousValue.velocity - currentVelocity).sqrMagnitude > velocitySensitivity * velocitySensitivity); + bool angularVelocityChanged = syncAngularVelocity && previousValue.angularVelocity != currentAngularVelocity;//((previousValue.angularVelocity - currentAngularVelocity).sqrMagnitude > angularVelocitySensitivity * angularVelocitySensitivity); + + // if angularVelocity has changed it is likely that velocity has also changed so just sync both values + // however if only velocity has changed just send velocity + if (angularVelocityChanged) + { + CmdSendVelocityAndAngular(currentVelocity, currentAngularVelocity); + previousValue.velocity = currentVelocity; + previousValue.angularVelocity = currentAngularVelocity; + } + else if (velocityChanged) + { + CmdSendVelocity(currentVelocity); + previousValue.velocity = currentVelocity; + } + + // only update syncTime if either has changed + if (angularVelocityChanged || velocityChanged) + previousValue.nextSyncTime = now + syncInterval; + } + + [Client] + void SendRigidBodySettings() + { + // These shouldn't change often so it is ok to send in their own Command + if (previousValue.isKinematic != target.isKinematic) + { + CmdSendIsKinematic(target.isKinematic); + previousValue.isKinematic = target.isKinematic; + } + if (previousValue.gravityScale != target.gravityScale) + { + CmdChangeGravityScale(target.gravityScale); + previousValue.gravityScale = target.gravityScale; + } + if (previousValue.drag != target.linearDamping) + { + CmdSendDrag(target.linearDamping); + previousValue.drag = target.linearDamping; + } + if (previousValue.angularDrag != target.angularDamping) + { + CmdSendAngularDrag(target.angularDamping); + previousValue.angularDrag = target.angularDamping; + } + } + + /// + /// Called when only Velocity has changed on the client + /// + [Command] + void CmdSendVelocity(Vector2 velocity) + { + // Ignore messages from client if not in client authority mode + if (!clientAuthority) + return; + + this.velocity = velocity; + target.linearVelocity = velocity; + } + + /// + /// Called when angularVelocity has changed on the client + /// + [Command] + void CmdSendVelocityAndAngular(Vector2 velocity, float angularVelocity) + { + // Ignore messages from client if not in client authority mode + if (!clientAuthority) + return; + + if (syncVelocity) + { + this.velocity = velocity; + target.linearVelocity = velocity; + } + this.angularVelocity = angularVelocity; + target.angularVelocity = angularVelocity; + } + + [Command] + void CmdSendIsKinematic(bool isKinematic) + { + // Ignore messages from client if not in client authority mode + if (!clientAuthority) + return; + + this.isKinematic = isKinematic; + target.isKinematic = isKinematic; + } + + [Command] + void CmdChangeGravityScale(float gravityScale) + { + // Ignore messages from client if not in client authority mode + if (!clientAuthority) + return; + + this.gravityScale = gravityScale; + target.gravityScale = gravityScale; + } + + [Command] + void CmdSendDrag(float drag) + { + // Ignore messages from client if not in client authority mode + if (!clientAuthority) + return; + + this.drag = drag; + target.linearDamping = drag; + } + + [Command] + void CmdSendAngularDrag(float angularDrag) + { + // Ignore messages from client if not in client authority mode + if (!clientAuthority) + return; + + this.angularDrag = angularDrag; + target.angularDamping = angularDrag; + } + + /// + /// holds previously synced values + /// + public class ClientSyncState + { + /// + /// Next sync time that velocity will be synced, based on syncInterval. + /// + public float nextSyncTime; + public Vector2 velocity; + public float angularVelocity; + public bool isKinematic; + public float gravityScale; + public float drag; + public float angularDrag; + } + } +} diff --git a/Assets/Mirror/Components/Experimental/NetworkRigidbody2D.cs.meta b/Assets/Mirror/Components/Experimental/NetworkRigidbody2D.cs.meta new file mode 100644 index 0000000..df466bd --- /dev/null +++ b/Assets/Mirror/Components/Experimental/NetworkRigidbody2D.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: ab2cbc52526ea384ba280d13cd1a57b9 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/GUIConsole.cs b/Assets/Mirror/Components/GUIConsole.cs new file mode 100644 index 0000000..7055fe1 --- /dev/null +++ b/Assets/Mirror/Components/GUIConsole.cs @@ -0,0 +1,133 @@ +// People should be able to see and report errors to the developer very easily. +// +// Unity's Developer Console only works in development builds and it only shows +// errors. This class provides a console that works in all builds and also shows +// log and warnings in development builds. +// +// Note: we don't include the stack trace, because that can also be grabbed from +// the log files if needed. +// +// Note: there is no 'hide' button because we DO want people to see those errors +// and report them back to us. +// +// Note: normal Debug.Log messages can be shown by building in Debug/Development +// mode. +using UnityEngine; +using System.Collections.Generic; + +namespace Mirror +{ + struct LogEntry + { + public string message; + public LogType type; + + public LogEntry(string message, LogType type) + { + this.message = message; + this.type = type; + } + } + + public class GUIConsole : MonoBehaviour + { + public int height = 80; + public int offsetY = 40; + + // only keep the recent 'n' entries. otherwise memory would grow forever + // and drawing would get slower and slower. + public int maxLogCount = 50; + + // Unity Editor has the Console window, we don't need to show it there. + // unless for testing, so keep it as option. + public bool showInEditor = false; + + // log as queue so we can remove the first entry easily + readonly Queue log = new Queue(); + + // hotkey to show/hide at runtime for easier debugging + // (sometimes we need to temporarily hide/show it) + // Default is BackQuote, because F keys are already assigned in browsers + [Tooltip("Hotkey to show/hide the console at runtime\nBack Quote is usually on the left above Tab\nChange with caution - F keys are generally already taken in Browsers")] + public KeyCode hotKey = KeyCode.BackQuote; + + // GUI + bool visible; + Vector2 scroll = Vector2.zero; + + // only show at runtime, or if showInEditor is enabled + bool show => !Application.isEditor || showInEditor; + + void Awake() + { + // only show at runtime, or if showInEditor is enabled + if (show) + Application.logMessageReceived += OnLog; + } + + // OnLog logs everything, even Debug.Log messages in release builds + // => this makes a lot of things easier. e.g. addon initialization logs. + // => it's really better to have than not to have those + void OnLog(string message, string stackTrace, LogType type) + { + // is this important? + // => always show exceptions & errors + // => usually a good idea to show warnings too, otherwise it's too + // easy to miss OnDeserialize warnings etc. in builds + bool isImportant = type == LogType.Error || type == LogType.Exception || type == LogType.Warning; + + // use stack trace only if important + // (otherwise users would have to find and search the log file. + // seeing it in the console directly is way easier to deal with.) + // => only add \n if stack trace is available (only in debug builds) + if (isImportant && !string.IsNullOrWhiteSpace(stackTrace)) + message += $"\n{stackTrace}"; + + // add to queue + log.Enqueue(new LogEntry(message, type)); + + // respect max entries + if (log.Count > maxLogCount) + log.Dequeue(); + + // become visible if it was important + // (no need to become visible for regular log. let the user decide.) + if (isImportant) + visible = true; + + // auto scroll + scroll.y = float.MaxValue; + } + + void Update() + { + if (show && Input.GetKeyDown(hotKey)) + visible = !visible; + } + + void OnGUI() + { + if (!visible) return; + + // If this offset is changed, also change width in NetworkManagerHUD::OnGUI + int offsetX = 300 + 20; + + GUILayout.BeginArea(new Rect(offsetX, offsetY, Screen.width - offsetX - 10, height)); + + scroll = GUILayout.BeginScrollView(scroll, "Box", GUILayout.Width(Screen.width - offsetX - 10), GUILayout.Height(height)); + foreach (LogEntry entry in log) + { + if (entry.type == LogType.Error || entry.type == LogType.Exception) + GUI.color = Color.red; + else if (entry.type == LogType.Warning) + GUI.color = Color.yellow; + + GUILayout.Label(entry.message); + GUI.color = Color.white; + } + GUILayout.EndScrollView(); + + GUILayout.EndArea(); + } + } +} diff --git a/Assets/Mirror/Components/GUIConsole.cs.meta b/Assets/Mirror/Components/GUIConsole.cs.meta new file mode 100644 index 0000000..5664216 --- /dev/null +++ b/Assets/Mirror/Components/GUIConsole.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 9021b6cc314944290986ab6feb48db79 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/InterestManagement.meta b/Assets/Mirror/Components/InterestManagement.meta new file mode 100644 index 0000000..9b1f746 --- /dev/null +++ b/Assets/Mirror/Components/InterestManagement.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: c66f27e006ab94253b39a55a3b213651 +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/InterestManagement/Distance.meta b/Assets/Mirror/Components/InterestManagement/Distance.meta new file mode 100644 index 0000000..9847902 --- /dev/null +++ b/Assets/Mirror/Components/InterestManagement/Distance.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: fa4cbc6b9c584db4971985cb9f369077 +timeCreated: 1613110605 \ No newline at end of file diff --git a/Assets/Mirror/Components/InterestManagement/Distance/DistanceInterestManagement.cs b/Assets/Mirror/Components/InterestManagement/Distance/DistanceInterestManagement.cs new file mode 100644 index 0000000..6549961 --- /dev/null +++ b/Assets/Mirror/Components/InterestManagement/Distance/DistanceInterestManagement.cs @@ -0,0 +1,90 @@ +// straight forward Vector3.Distance based interest management. +using System.Collections.Generic; +using UnityEngine; + +namespace Mirror +{ + [AddComponentMenu("Network/ Interest Management/ Distance/Distance Interest Management")] + public class DistanceInterestManagement : InterestManagement + { + [Tooltip("The maximum range that objects will be visible at. Add DistanceInterestManagementCustomRange onto NetworkIdentities for custom ranges.")] + public int visRange = 500; + + [Tooltip("Rebuild all every 'rebuildInterval' seconds.")] + public float rebuildInterval = 1; + double lastRebuildTime; + + // cache custom ranges to avoid runtime TryGetComponent lookups + readonly Dictionary CustomRanges = new Dictionary(); + + // helper function to get vis range for a given object, or default. + [ServerCallback] + int GetVisRange(NetworkIdentity identity) + { + return CustomRanges.TryGetValue(identity, out DistanceInterestManagementCustomRange custom) ? custom.visRange : visRange; + } + + [ServerCallback] + public override void ResetState() + { + lastRebuildTime = 0D; + CustomRanges.Clear(); + } + + public override void OnSpawned(NetworkIdentity identity) + { + if (identity.TryGetComponent(out DistanceInterestManagementCustomRange custom)) + CustomRanges[identity] = custom; + } + + public override void OnDestroyed(NetworkIdentity identity) + { + CustomRanges.Remove(identity); + } + + public override bool OnCheckObserver(NetworkIdentity identity, NetworkConnectionToClient newObserver) + { + int range = GetVisRange(identity); + return Vector3.Distance(identity.transform.position, newObserver.identity.transform.position) < range; + } + + public override void OnRebuildObservers(NetworkIdentity identity, HashSet newObservers) + { + // cache range and .transform because both call GetComponent. + int range = GetVisRange(identity); + Vector3 position = identity.transform.position; + + // brute force distance check + // -> only player connections can be observers, so it's enough if we + // go through all connections instead of all spawned identities. + // -> compared to UNET's sphere cast checking, this one is orders of + // magnitude faster. if we have 10k monsters and run a sphere + // cast 10k times, we will see a noticeable lag even with physics + // layers. but checking to every connection is fast. + foreach (NetworkConnectionToClient conn in NetworkServer.connections.Values) + { + // authenticated and joined world with a player? + if (conn != null && conn.isAuthenticated && conn.identity != null) + { + // check distance + if (Vector3.Distance(conn.identity.transform.position, position) < range) + { + newObservers.Add(conn); + } + } + } + } + + // internal so we can update from tests + [ServerCallback] + internal void Update() + { + // rebuild all spawned NetworkIdentity's observers every interval + if (NetworkTime.localTime >= lastRebuildTime + rebuildInterval) + { + RebuildAll(); + lastRebuildTime = NetworkTime.localTime; + } + } + } +} diff --git a/Assets/Mirror/Components/InterestManagement/Distance/DistanceInterestManagement.cs.meta b/Assets/Mirror/Components/InterestManagement/Distance/DistanceInterestManagement.cs.meta new file mode 100644 index 0000000..1a575af --- /dev/null +++ b/Assets/Mirror/Components/InterestManagement/Distance/DistanceInterestManagement.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 8f60becab051427fbdd3c8ac9ab4712b +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/InterestManagement/Distance/DistanceInterestManagementCustomRange.cs b/Assets/Mirror/Components/InterestManagement/Distance/DistanceInterestManagementCustomRange.cs new file mode 100644 index 0000000..12556e5 --- /dev/null +++ b/Assets/Mirror/Components/InterestManagement/Distance/DistanceInterestManagementCustomRange.cs @@ -0,0 +1,15 @@ +// add this to NetworkIdentities for custom range if needed. +// only works with DistanceInterestManagement. +using UnityEngine; + +namespace Mirror +{ + [DisallowMultipleComponent] + [AddComponentMenu("Network/ Interest Management/ Distance/Distance Custom Range")] + [HelpURL("https://mirror-networking.gitbook.io/docs/guides/interest-management")] + public class DistanceInterestManagementCustomRange : NetworkBehaviour + { + [Tooltip("The maximum range that objects will be visible at.")] + public int visRange = 100; + } +} diff --git a/Assets/Mirror/Components/InterestManagement/Distance/DistanceInterestManagementCustomRange.cs.meta b/Assets/Mirror/Components/InterestManagement/Distance/DistanceInterestManagementCustomRange.cs.meta new file mode 100644 index 0000000..406ca78 --- /dev/null +++ b/Assets/Mirror/Components/InterestManagement/Distance/DistanceInterestManagementCustomRange.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: b2e242ee38a14076a39934172a19079b +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/InterestManagement/Match.meta b/Assets/Mirror/Components/InterestManagement/Match.meta new file mode 100644 index 0000000..e429883 --- /dev/null +++ b/Assets/Mirror/Components/InterestManagement/Match.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: 5eca5245ae6bb460e9a92f7e14d5493a +timeCreated: 1622649517 \ No newline at end of file diff --git a/Assets/Mirror/Components/InterestManagement/Match/MatchInterestManagement.cs b/Assets/Mirror/Components/InterestManagement/Match/MatchInterestManagement.cs new file mode 100644 index 0000000..d741d0c --- /dev/null +++ b/Assets/Mirror/Components/InterestManagement/Match/MatchInterestManagement.cs @@ -0,0 +1,164 @@ +using System; +using System.Collections.Generic; +using UnityEngine; + +namespace Mirror +{ + [AddComponentMenu("Network/ Interest Management/ Match/Match Interest Management")] + public class MatchInterestManagement : InterestManagement + { + [Header("Diagnostics")] + [ReadOnly, SerializeField] + internal ushort matchCount; + + readonly Dictionary> matchObjects = + new Dictionary>(); + + readonly HashSet dirtyMatches = new HashSet(); + + // LateUpdate so that all spawns/despawns/changes are done + [ServerCallback] + void LateUpdate() + { + // Rebuild all dirty matches + // dirtyMatches will be empty if no matches changed members + // by spawning or destroying or changing matchId in this frame. + foreach (Guid dirtyMatch in dirtyMatches) + { + // rebuild always, even if matchObjects[dirtyMatch] is empty. + // Players might have left the match, but they may still be spawned. + RebuildMatchObservers(dirtyMatch); + + // clean up empty entries in the dict + if (matchObjects[dirtyMatch].Count == 0) + matchObjects.Remove(dirtyMatch); + } + + dirtyMatches.Clear(); + + matchCount = (ushort)matchObjects.Count; + } + + [ServerCallback] + void RebuildMatchObservers(Guid matchId) + { + foreach (NetworkMatch networkMatch in matchObjects[matchId]) + if (networkMatch.netIdentity != null) + NetworkServer.RebuildObservers(networkMatch.netIdentity, false); + } + + // called by NetworkMatch.matchId setter + [ServerCallback] + internal void OnMatchChanged(NetworkMatch networkMatch, Guid oldMatch) + { + // This object is in a new match so observers in the prior match + // and the new match need to rebuild their respective observers lists. + + // Remove this object from the hashset of the match it just left + // Guid.Empty is never a valid matchId + if (oldMatch != Guid.Empty) + { + dirtyMatches.Add(oldMatch); + matchObjects[oldMatch].Remove(networkMatch); + } + + // Guid.Empty is never a valid matchId + if (networkMatch.matchId == Guid.Empty) + return; + + dirtyMatches.Add(networkMatch.matchId); + + // Make sure this new match is in the dictionary + if (!matchObjects.ContainsKey(networkMatch.matchId)) + matchObjects[networkMatch.matchId] = new HashSet(); + + // Add this object to the hashset of the new match + matchObjects[networkMatch.matchId].Add(networkMatch); + } + + [ServerCallback] + public override void OnSpawned(NetworkIdentity identity) + { + if (!identity.TryGetComponent(out NetworkMatch networkMatch)) + return; + + Guid networkMatchId = networkMatch.matchId; + + // Guid.Empty is never a valid matchId...do not add to matchObjects collection + if (networkMatchId == Guid.Empty) + return; + + // Debug.Log($"MatchInterestManagement.OnSpawned({identity.name}) currentMatch: {currentMatch}"); + if (!matchObjects.TryGetValue(networkMatchId, out HashSet objects)) + { + objects = new HashSet(); + matchObjects.Add(networkMatchId, objects); + } + + objects.Add(networkMatch); + + // Match ID could have been set in NetworkBehaviour::OnStartServer on this object. + // Since that's after OnCheckObserver is called it would be missed, so force Rebuild here. + // Add the current match to dirtyMatches for LateUpdate to rebuild it. + dirtyMatches.Add(networkMatchId); + } + + [ServerCallback] + public override void OnDestroyed(NetworkIdentity identity) + { + // Don't RebuildSceneObservers here - that will happen in LateUpdate. + // Multiple objects could be destroyed in same frame and we don't + // want to rebuild for each one...let LateUpdate do it once. + // We must add the current match to dirtyMatches for LateUpdate to rebuild it. + if (identity.TryGetComponent(out NetworkMatch currentMatch)) + { + if (currentMatch.matchId != Guid.Empty && + matchObjects.TryGetValue(currentMatch.matchId, out HashSet objects) && + objects.Remove(currentMatch)) + dirtyMatches.Add(currentMatch.matchId); + } + } + + [ServerCallback] + public override bool OnCheckObserver(NetworkIdentity identity, NetworkConnectionToClient newObserver) + { + // Never observed if no NetworkMatch component + if (!identity.TryGetComponent(out NetworkMatch identityNetworkMatch)) + return false; + + // Guid.Empty is never a valid matchId + if (identityNetworkMatch.matchId == Guid.Empty) + return false; + + // Never observed if no NetworkMatch component + if (!newObserver.identity.TryGetComponent(out NetworkMatch newObserverNetworkMatch)) + return false; + + // Guid.Empty is never a valid matchId + if (newObserverNetworkMatch.matchId == Guid.Empty) + return false; + + return identityNetworkMatch.matchId == newObserverNetworkMatch.matchId; + } + + [ServerCallback] + public override void OnRebuildObservers(NetworkIdentity identity, HashSet newObservers) + { + if (!identity.TryGetComponent(out NetworkMatch networkMatch)) + return; + + // Guid.Empty is never a valid matchId + if (networkMatch.matchId == Guid.Empty) + return; + + // Abort if this match hasn't been created yet by OnSpawned or OnMatchChanged + if (!matchObjects.TryGetValue(networkMatch.matchId, out HashSet objects)) + return; + + // Add everything in the hashset for this object's current match + foreach (NetworkMatch netMatch in objects) + if (netMatch.netIdentity != null && netMatch.netIdentity.connectionToClient != null) + newObservers.Add(netMatch.netIdentity.connectionToClient); + } + } +} diff --git a/Assets/Mirror/Components/InterestManagement/Match/MatchInterestManagement.cs.meta b/Assets/Mirror/Components/InterestManagement/Match/MatchInterestManagement.cs.meta new file mode 100644 index 0000000..605d215 --- /dev/null +++ b/Assets/Mirror/Components/InterestManagement/Match/MatchInterestManagement.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: d09f5c8bf2f4747b7a9284ef5d9ce2a7 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/InterestManagement/Match/NetworkMatch.cs b/Assets/Mirror/Components/InterestManagement/Match/NetworkMatch.cs new file mode 100644 index 0000000..0d55fd0 --- /dev/null +++ b/Assets/Mirror/Components/InterestManagement/Match/NetworkMatch.cs @@ -0,0 +1,42 @@ +// simple component that holds match information +using System; +using UnityEngine; + +namespace Mirror +{ + [DisallowMultipleComponent] + [AddComponentMenu("Network/ Interest Management/ Match/Network Match")] + [HelpURL("https://mirror-networking.gitbook.io/docs/guides/interest-management")] + public class NetworkMatch : NetworkBehaviour + { + Guid _matchId; + +#pragma warning disable IDE0052 // Suppress warning for unused field...this is for debugging purposes + [SerializeField, ReadOnly] + [Tooltip("Match ID is shown here on server for debugging purposes.")] + string MatchID = string.Empty; +#pragma warning restore IDE0052 + + ///Set this to the same value on all networked objects that belong to a given match + public Guid matchId + { + get => _matchId; + set + { + if (!NetworkServer.active) + throw new InvalidOperationException("matchId can only be set at runtime on active server"); + + if (_matchId == value) + return; + + Guid oldMatch = _matchId; + _matchId = value; + MatchID = value.ToString(); + + // Only inform the AOI if this netIdentity has been spawned (isServer) and only if using a MatchInterestManagement + if (isServer && NetworkServer.aoi is MatchInterestManagement matchInterestManagement) + matchInterestManagement.OnMatchChanged(this, oldMatch); + } + } + } +} diff --git a/Assets/Mirror/Components/InterestManagement/Match/NetworkMatch.cs.meta b/Assets/Mirror/Components/InterestManagement/Match/NetworkMatch.cs.meta new file mode 100644 index 0000000..47fc70a --- /dev/null +++ b/Assets/Mirror/Components/InterestManagement/Match/NetworkMatch.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 5d17e718851449a6879986e45c458fb7 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/InterestManagement/Scene.meta b/Assets/Mirror/Components/InterestManagement/Scene.meta new file mode 100644 index 0000000..28b469f --- /dev/null +++ b/Assets/Mirror/Components/InterestManagement/Scene.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: 7655d309a46a4bd4860edf964228b3f6 +timeCreated: 1622649517 \ No newline at end of file diff --git a/Assets/Mirror/Components/InterestManagement/Scene/SceneInterestManagement.cs b/Assets/Mirror/Components/InterestManagement/Scene/SceneInterestManagement.cs new file mode 100644 index 0000000..28e5eba --- /dev/null +++ b/Assets/Mirror/Components/InterestManagement/Scene/SceneInterestManagement.cs @@ -0,0 +1,118 @@ +using System.Collections.Generic; +using UnityEngine; +using UnityEngine.SceneManagement; + +namespace Mirror +{ + [AddComponentMenu("Network/ Interest Management/ Scene/Scene Interest Management")] + public class SceneInterestManagement : InterestManagement + { + // Use Scene instead of string scene.name because when additively + // loading multiples of a subscene the name won't be unique + readonly Dictionary> sceneObjects = + new Dictionary>(); + + readonly Dictionary lastObjectScene = + new Dictionary(); + + HashSet dirtyScenes = new HashSet(); + + [ServerCallback] + public override void OnSpawned(NetworkIdentity identity) + { + Scene currentScene = identity.gameObject.scene; + lastObjectScene[identity] = currentScene; + // Debug.Log($"SceneInterestManagement.OnSpawned({identity.name}) currentScene: {currentScene}"); + if (!sceneObjects.TryGetValue(currentScene, out HashSet objects)) + { + objects = new HashSet(); + sceneObjects.Add(currentScene, objects); + } + + objects.Add(identity); + } + + [ServerCallback] + public override void OnDestroyed(NetworkIdentity identity) + { + // Don't RebuildSceneObservers here - that will happen in Update. + // Multiple objects could be destroyed in same frame and we don't + // want to rebuild for each one...let Update do it once. + // We must add the current scene to dirtyScenes for Update to rebuild it. + if (lastObjectScene.TryGetValue(identity, out Scene currentScene)) + { + lastObjectScene.Remove(identity); + if (sceneObjects.TryGetValue(currentScene, out HashSet objects) && objects.Remove(identity)) + dirtyScenes.Add(currentScene); + } + } + + // internal so we can update from tests + [ServerCallback] + internal void Update() + { + // for each spawned: + // if scene changed: + // add previous to dirty + // add new to dirty + foreach (NetworkIdentity identity in NetworkServer.spawned.Values) + { + if (!lastObjectScene.TryGetValue(identity, out Scene currentScene)) + continue; + + Scene newScene = identity.gameObject.scene; + if (newScene == currentScene) + continue; + + // Mark new/old scenes as dirty so they get rebuilt + dirtyScenes.Add(currentScene); + dirtyScenes.Add(newScene); + + // This object is in a new scene so observers in the prior scene + // and the new scene need to rebuild their respective observers lists. + + // Remove this object from the hashset of the scene it just left + sceneObjects[currentScene].Remove(identity); + + // Set this to the new scene this object just entered + lastObjectScene[identity] = newScene; + + // Make sure this new scene is in the dictionary + if (!sceneObjects.ContainsKey(newScene)) + sceneObjects.Add(newScene, new HashSet()); + + // Add this object to the hashset of the new scene + sceneObjects[newScene].Add(identity); + } + + // rebuild all dirty scenes + foreach (Scene dirtyScene in dirtyScenes) + RebuildSceneObservers(dirtyScene); + + dirtyScenes.Clear(); + } + + void RebuildSceneObservers(Scene scene) + { + foreach (NetworkIdentity netIdentity in sceneObjects[scene]) + if (netIdentity != null) + NetworkServer.RebuildObservers(netIdentity, false); + } + + public override bool OnCheckObserver(NetworkIdentity identity, NetworkConnectionToClient newObserver) + { + return identity.gameObject.scene == newObserver.identity.gameObject.scene; + } + + public override void OnRebuildObservers(NetworkIdentity identity, HashSet newObservers) + { + if (!sceneObjects.TryGetValue(identity.gameObject.scene, out HashSet objects)) + return; + + // Add everything in the hashset for this object's current scene + foreach (NetworkIdentity networkIdentity in objects) + if (networkIdentity != null && networkIdentity.connectionToClient != null) + newObservers.Add(networkIdentity.connectionToClient); + } + } +} diff --git a/Assets/Mirror/Components/InterestManagement/Scene/SceneInterestManagement.cs.meta b/Assets/Mirror/Components/InterestManagement/Scene/SceneInterestManagement.cs.meta new file mode 100644 index 0000000..9cc1ff5 --- /dev/null +++ b/Assets/Mirror/Components/InterestManagement/Scene/SceneInterestManagement.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: b979f26c95d34324ba005bfacfa9c4fc +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/InterestManagement/SpatialHashing.meta b/Assets/Mirror/Components/InterestManagement/SpatialHashing.meta new file mode 100644 index 0000000..00f5cd6 --- /dev/null +++ b/Assets/Mirror/Components/InterestManagement/SpatialHashing.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: cfa12b73503344d49b398b01bcb07967 +timeCreated: 1613110634 \ No newline at end of file diff --git a/Assets/Mirror/Components/InterestManagement/SpatialHashing/Grid2D.cs b/Assets/Mirror/Components/InterestManagement/SpatialHashing/Grid2D.cs new file mode 100644 index 0000000..d557713 --- /dev/null +++ b/Assets/Mirror/Components/InterestManagement/SpatialHashing/Grid2D.cs @@ -0,0 +1,104 @@ +// Grid2D from uMMORPG: get/set values of type T at any point +// -> not named 'Grid' because Unity already has a Grid type. causes warnings. +// -> struct to avoid memory indirection. it's accessed a lot. +using System.Collections.Generic; +using UnityEngine; + +namespace Mirror +{ + // struct to avoid memory indirection. it's accessed a lot. + public struct Grid2D + { + // the grid + // note that we never remove old keys. + // => over time, HashSets will be allocated for every possible + // grid position in the world + // => Clear() doesn't clear them so we don't constantly reallocate the + // entries when populating the grid in every Update() call + // => makes the code a lot easier too + // => this is FINE because in the worst case, every grid position in the + // game world is filled with a player anyway! + readonly Dictionary> grid; + + // cache a 9 neighbor grid of vector2 offsets so we can use them more easily + readonly Vector2Int[] neighbourOffsets; + + public Grid2D(int initialCapacity) + { + grid = new Dictionary>(initialCapacity); + + neighbourOffsets = new[] { + Vector2Int.up, + Vector2Int.up + Vector2Int.left, + Vector2Int.up + Vector2Int.right, + Vector2Int.left, + Vector2Int.zero, + Vector2Int.right, + Vector2Int.down, + Vector2Int.down + Vector2Int.left, + Vector2Int.down + Vector2Int.right + }; + } + + // helper function so we can add an entry without worrying + public void Add(Vector2Int position, T value) + { + // initialize set in grid if it's not in there yet + if (!grid.TryGetValue(position, out HashSet hashSet)) + { + // each grid entry may hold hundreds of entities. + // let's create the HashSet with a large initial capacity + // in order to avoid resizing & allocations. +#if !UNITY_2021_3_OR_NEWER + // Unity 2019 doesn't have "new HashSet(capacity)" yet + hashSet = new HashSet(); +#else + hashSet = new HashSet(128); +#endif + grid[position] = hashSet; + } + + // add to it + hashSet.Add(value); + } + + // helper function to get set at position without worrying + // -> result is passed as parameter to avoid allocations + // -> result is not cleared before. this allows us to pass the HashSet from + // GetWithNeighbours and avoid .UnionWith which is very expensive. + void GetAt(Vector2Int position, HashSet result) + { + // return the set at position + if (grid.TryGetValue(position, out HashSet hashSet)) + { + foreach (T entry in hashSet) + result.Add(entry); + } + } + + // helper function to get at position and it's 8 neighbors without worrying + // -> result is passed as parameter to avoid allocations + public void GetWithNeighbours(Vector2Int position, HashSet result) + { + // clear result first + result.Clear(); + + // add neighbours + foreach (Vector2Int offset in neighbourOffsets) + GetAt(position + offset, result); + } + + // clear: clears the whole grid + // IMPORTANT: we already allocated HashSets and don't want to do + // reallocate every single update when we rebuild the grid. + // => so simply remove each position's entries, but keep + // every position in there + // => see 'grid' comments above! + // => named ClearNonAlloc to make it more obvious! + public void ClearNonAlloc() + { + foreach (HashSet hashSet in grid.Values) + hashSet.Clear(); + } + } +} diff --git a/Assets/Mirror/Components/InterestManagement/SpatialHashing/Grid2D.cs.meta b/Assets/Mirror/Components/InterestManagement/SpatialHashing/Grid2D.cs.meta new file mode 100644 index 0000000..f1d3cf0 --- /dev/null +++ b/Assets/Mirror/Components/InterestManagement/SpatialHashing/Grid2D.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 7c5232a4d2854116a35d52b80ec07752 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/InterestManagement/SpatialHashing/SpatialHashingInterestManagement.cs b/Assets/Mirror/Components/InterestManagement/SpatialHashing/SpatialHashingInterestManagement.cs new file mode 100644 index 0000000..066a1c5 --- /dev/null +++ b/Assets/Mirror/Components/InterestManagement/SpatialHashing/SpatialHashingInterestManagement.cs @@ -0,0 +1,154 @@ +// extremely fast spatial hashing interest management based on uMMORPG GridChecker. +// => 30x faster in initial tests +// => scales way higher +using System.Collections.Generic; +using UnityEngine; + +namespace Mirror +{ + [AddComponentMenu("Network/ Interest Management/ Spatial Hash/Spatial Hashing Interest Management")] + public class SpatialHashingInterestManagement : InterestManagement + { + [Tooltip("The maximum range that objects will be visible at.")] + public int visRange = 30; + + // we use a 9 neighbour grid. + // so we always see in a distance of 2 grids. + // for example, our own grid and then one on top / below / left / right. + // + // this means that grid resolution needs to be distance / 2. + // so for example, for distance = 30 we see 2 cells = 15 * 2 distance. + // + // on first sight, it seems we need distance / 3 (we see left/us/right). + // but that's not the case. + // resolution would be 10, and we only see 1 cell far, so 10+10=20. + public int resolution => visRange / 2; + + [Tooltip("Rebuild all every 'rebuildInterval' seconds.")] + public float rebuildInterval = 1; + double lastRebuildTime; + + public enum CheckMethod + { + XZ_FOR_3D, + XY_FOR_2D + } + [Tooltip("Spatial Hashing supports 3D (XZ) and 2D (XY) games.")] + public CheckMethod checkMethod = CheckMethod.XZ_FOR_3D; + + // debugging + public bool showSlider; + + // the grid + // begin with a large capacity to avoid resizing & allocations. + Grid2D grid = new Grid2D(1024); + + // project 3d world position to grid position + Vector2Int ProjectToGrid(Vector3 position) => + checkMethod == CheckMethod.XZ_FOR_3D + ? Vector2Int.RoundToInt(new Vector2(position.x, position.z) / resolution) + : Vector2Int.RoundToInt(new Vector2(position.x, position.y) / resolution); + + public override bool OnCheckObserver(NetworkIdentity identity, NetworkConnectionToClient newObserver) + { + // calculate projected positions + Vector2Int projected = ProjectToGrid(identity.transform.position); + Vector2Int observerProjected = ProjectToGrid(newObserver.identity.transform.position); + + // distance needs to be at max one of the 8 neighbors, which is + // 1 for the direct neighbors + // 1.41 for the diagonal neighbors (= sqrt(2)) + // => use sqrMagnitude and '2' to avoid computations. same result. + return (projected - observerProjected).sqrMagnitude <= 2; + } + + public override void OnRebuildObservers(NetworkIdentity identity, HashSet newObservers) + { + // add everyone in 9 neighbour grid + // -> pass observers to GetWithNeighbours directly to avoid allocations + // and expensive .UnionWith computations. + Vector2Int current = ProjectToGrid(identity.transform.position); + grid.GetWithNeighbours(current, newObservers); + } + + [ServerCallback] + public override void ResetState() + { + lastRebuildTime = 0D; + } + + // update everyone's position in the grid + // (internal so we can update from tests) + [ServerCallback] + internal void Update() + { + // NOTE: unlike Scene/MatchInterestManagement, this rebuilds ALL + // entities every INTERVAL. consider the other approach later. + + // IMPORTANT: refresh grid every update! + // => newly spawned entities get observers assigned via + // OnCheckObservers. this can happen any time and we don't want + // them broadcast to old (moved or destroyed) connections. + // => players do move all the time. we want them to always be in the + // correct grid position. + // => note that the actual 'rebuildall' doesn't need to happen all + // the time. + // NOTE: consider refreshing grid only every 'interval' too. but not + // for now. stability & correctness matter. + + // clear old grid results before we update everyone's position. + // (this way we get rid of destroyed connections automatically) + // + // NOTE: keeps allocated HashSets internally. + // clearing & populating every frame works without allocations + grid.ClearNonAlloc(); + + // put every connection into the grid at it's main player's position + // NOTE: player sees in a radius around him. NOT around his pet too. + foreach (NetworkConnectionToClient connection in NetworkServer.connections.Values) + { + // authenticated and joined world with a player? + if (connection.isAuthenticated && connection.identity != null) + { + // calculate current grid position + Vector2Int position = ProjectToGrid(connection.identity.transform.position); + + // put into grid + grid.Add(position, connection); + } + } + + // rebuild all spawned entities' observers every 'interval' + // this will call OnRebuildObservers which then returns the + // observers at grid[position] for each entity. + if (NetworkTime.localTime >= lastRebuildTime + rebuildInterval) + { + RebuildAll(); + lastRebuildTime = NetworkTime.localTime; + } + } + +// OnGUI allocates even if it does nothing. avoid in release. +#if UNITY_EDITOR || DEVELOPMENT_BUILD + // slider from dotsnet. it's nice to play around with in the benchmark + // demo. + void OnGUI() + { + if (!showSlider) return; + + // only show while server is running. not on client, etc. + if (!NetworkServer.active) return; + + int height = 30; + int width = 250; + GUILayout.BeginArea(new Rect(Screen.width / 2 - width / 2, Screen.height - height, width, height)); + GUILayout.BeginHorizontal("Box"); + GUILayout.Label("Radius:"); + visRange = Mathf.RoundToInt(GUILayout.HorizontalSlider(visRange, 0, 200, GUILayout.Width(150))); + GUILayout.Label(visRange.ToString()); + GUILayout.EndHorizontal(); + GUILayout.EndArea(); + } +#endif + } +} diff --git a/Assets/Mirror/Components/InterestManagement/SpatialHashing/SpatialHashingInterestManagement.cs.meta b/Assets/Mirror/Components/InterestManagement/SpatialHashing/SpatialHashingInterestManagement.cs.meta new file mode 100644 index 0000000..271e433 --- /dev/null +++ b/Assets/Mirror/Components/InterestManagement/SpatialHashing/SpatialHashingInterestManagement.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 39adc6e09d5544ed955a50ce8600355a +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/InterestManagement/Team.meta b/Assets/Mirror/Components/InterestManagement/Team.meta new file mode 100644 index 0000000..fe40aa4 --- /dev/null +++ b/Assets/Mirror/Components/InterestManagement/Team.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: 2d418e60072433b4bbebbf5f3a7de1bb +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/InterestManagement/Team/NetworkTeam.cs b/Assets/Mirror/Components/InterestManagement/Team/NetworkTeam.cs new file mode 100644 index 0000000..290eb06 --- /dev/null +++ b/Assets/Mirror/Components/InterestManagement/Team/NetworkTeam.cs @@ -0,0 +1,39 @@ +// simple component that holds team information +using System; +using UnityEngine; + +namespace Mirror +{ + [DisallowMultipleComponent] + [AddComponentMenu("Network/ Interest Management/ Team/Network Team")] + [HelpURL("https://mirror-networking.gitbook.io/docs/guides/interest-management")] + public class NetworkTeam : NetworkBehaviour + { + [SerializeField] + [Tooltip("Set teamId on Server at runtime to the same value on all networked objects that belong to a given team")] + string _teamId; + + public string teamId + { + get => _teamId; + set + { + if (Application.IsPlaying(gameObject) && !NetworkServer.active) + throw new InvalidOperationException("teamId can only be set at runtime on active server"); + + if (_teamId == value) + return; + + string oldTeam = _teamId; + _teamId = value; + + //Only inform the AOI if this netIdentity has been spawned(isServer) and only if using a TeamInterestManagement + if (isServer && NetworkServer.aoi is TeamInterestManagement teamInterestManagement) + teamInterestManagement.OnTeamChanged(this, oldTeam); + } + } + + [Tooltip("When enabled this object is visible to all clients. Typically this would be true for player objects")] + public bool forceShown; + } +} diff --git a/Assets/Mirror/Components/InterestManagement/Team/NetworkTeam.cs.meta b/Assets/Mirror/Components/InterestManagement/Team/NetworkTeam.cs.meta new file mode 100644 index 0000000..ca75a7a --- /dev/null +++ b/Assets/Mirror/Components/InterestManagement/Team/NetworkTeam.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 2576730625b1632468cbcbfe5e721f88 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/InterestManagement/Team/TeamInterestManagement.cs b/Assets/Mirror/Components/InterestManagement/Team/TeamInterestManagement.cs new file mode 100644 index 0000000..cb5bdb7 --- /dev/null +++ b/Assets/Mirror/Components/InterestManagement/Team/TeamInterestManagement.cs @@ -0,0 +1,182 @@ +using System.Collections.Generic; +using UnityEngine; + +namespace Mirror +{ + [AddComponentMenu("Network/ Interest Management/ Team/Team Interest Management")] + public class TeamInterestManagement : InterestManagement + { + readonly Dictionary> teamObjects = + new Dictionary>(); + + readonly HashSet dirtyTeams = new HashSet(); + + // LateUpdate so that all spawns/despawns/changes are done + [ServerCallback] + void LateUpdate() + { + // Rebuild all dirty teams + // dirtyTeams will be empty if no teams changed members + // by spawning or destroying or changing teamId in this frame. + foreach (string dirtyTeam in dirtyTeams) + { + // rebuild always, even if teamObjects[dirtyTeam] is empty. + // Players might have left the team, but they may still be spawned. + RebuildTeamObservers(dirtyTeam); + + // clean up empty entries in the dict + if (teamObjects[dirtyTeam].Count == 0) + teamObjects.Remove(dirtyTeam); + } + + dirtyTeams.Clear(); + } + + [ServerCallback] + void RebuildTeamObservers(string teamId) + { + foreach (NetworkTeam networkTeam in teamObjects[teamId]) + if (networkTeam.netIdentity != null) + NetworkServer.RebuildObservers(networkTeam.netIdentity, false); + } + + // called by NetworkTeam.teamId setter + [ServerCallback] + internal void OnTeamChanged(NetworkTeam networkTeam, string oldTeam) + { + // This object is in a new team so observers in the prior team + // and the new team need to rebuild their respective observers lists. + + // Remove this object from the hashset of the team it just left + // Null / Empty string is never a valid teamId + if (!string.IsNullOrWhiteSpace(oldTeam)) + { + dirtyTeams.Add(oldTeam); + teamObjects[oldTeam].Remove(networkTeam); + } + + // Null / Empty string is never a valid teamId + if (string.IsNullOrWhiteSpace(networkTeam.teamId)) + return; + + dirtyTeams.Add(networkTeam.teamId); + + // Make sure this new team is in the dictionary + if (!teamObjects.ContainsKey(networkTeam.teamId)) + teamObjects[networkTeam.teamId] = new HashSet(); + + // Add this object to the hashset of the new team + teamObjects[networkTeam.teamId].Add(networkTeam); + } + + [ServerCallback] + public override void OnSpawned(NetworkIdentity identity) + { + if (!identity.TryGetComponent(out NetworkTeam networkTeam)) + return; + + string networkTeamId = networkTeam.teamId; + + // Null / Empty string is never a valid teamId...do not add to teamObjects collection + if (string.IsNullOrWhiteSpace(networkTeamId)) + return; + + // Debug.Log($"TeamInterestManagement.OnSpawned({identity.name}) currentTeam: {currentTeam}"); + if (!teamObjects.TryGetValue(networkTeamId, out HashSet objects)) + { + objects = new HashSet(); + teamObjects.Add(networkTeamId, objects); + } + + objects.Add(networkTeam); + + // Team ID could have been set in NetworkBehaviour::OnStartServer on this object. + // Since that's after OnCheckObserver is called it would be missed, so force Rebuild here. + // Add the current team to dirtyTeames for LateUpdate to rebuild it. + dirtyTeams.Add(networkTeamId); + } + + [ServerCallback] + public override void OnDestroyed(NetworkIdentity identity) + { + // Don't RebuildSceneObservers here - that will happen in LateUpdate. + // Multiple objects could be destroyed in same frame and we don't + // want to rebuild for each one...let LateUpdate do it once. + // We must add the current team to dirtyTeames for LateUpdate to rebuild it. + if (identity.TryGetComponent(out NetworkTeam currentTeam)) + { + if (!string.IsNullOrWhiteSpace(currentTeam.teamId) && + teamObjects.TryGetValue(currentTeam.teamId, out HashSet objects) && + objects.Remove(currentTeam)) + dirtyTeams.Add(currentTeam.teamId); + } + } + + public override bool OnCheckObserver(NetworkIdentity identity, NetworkConnectionToClient newObserver) + { + // Always observed if no NetworkTeam component + if (!identity.TryGetComponent(out NetworkTeam identityNetworkTeam)) + return true; + + if (identityNetworkTeam.forceShown) + return true; + + // Null / Empty string is never a valid teamId + if (string.IsNullOrWhiteSpace(identityNetworkTeam.teamId)) + return false; + + // Always observed if no NetworkTeam component + if (!newObserver.identity.TryGetComponent(out NetworkTeam newObserverNetworkTeam)) + return true; + + // Null / Empty string is never a valid teamId + if (string.IsNullOrWhiteSpace(newObserverNetworkTeam.teamId)) + return false; + + //Debug.Log($"TeamInterestManagement.OnCheckObserver {identity.name} {identityNetworkTeam.teamId} | {newObserver.identity.name} {newObserverNetworkTeam.teamId}"); + + // Observed only if teamId's team + return identityNetworkTeam.teamId == newObserverNetworkTeam.teamId; + } + + public override void OnRebuildObservers(NetworkIdentity identity, HashSet newObservers) + { + // If this object doesn't have a NetworkTeam then it's visible to all clients + if (!identity.TryGetComponent(out NetworkTeam networkTeam)) + { + AddAllConnections(newObservers); + return; + } + + // If this object has NetworkTeam and forceShown == true then it's visible to all clients + if (networkTeam.forceShown) + { + AddAllConnections(newObservers); + return; + } + + // Null / Empty string is never a valid teamId + if (string.IsNullOrWhiteSpace(networkTeam.teamId)) + return; + + // Abort if this team hasn't been created yet by OnSpawned or OnTeamChanged + if (!teamObjects.TryGetValue(networkTeam.teamId, out HashSet objects)) + return; + + // Add everything in the hashset for this object's current team + foreach (NetworkTeam netTeam in objects) + if (netTeam.netIdentity != null && netTeam.netIdentity.connectionToClient != null) + newObservers.Add(netTeam.netIdentity.connectionToClient); + } + + void AddAllConnections(HashSet newObservers) + { + foreach (NetworkConnectionToClient conn in NetworkServer.connections.Values) + { + // authenticated and joined world with a player? + if (conn != null && conn.isAuthenticated && conn.identity != null) + newObservers.Add(conn); + } + } + } +} diff --git a/Assets/Mirror/Components/InterestManagement/Team/TeamInterestManagement.cs.meta b/Assets/Mirror/Components/InterestManagement/Team/TeamInterestManagement.cs.meta new file mode 100644 index 0000000..6e8748a --- /dev/null +++ b/Assets/Mirror/Components/InterestManagement/Team/TeamInterestManagement.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: dceb9a7085758fd4590419ff5b14b636 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/LagCompensation.meta b/Assets/Mirror/Components/LagCompensation.meta new file mode 100644 index 0000000..669a5b8 --- /dev/null +++ b/Assets/Mirror/Components/LagCompensation.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: 00ac1d0527f234939aba22b4d7cbf280 +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/LagCompensation/HistoryCollider.cs b/Assets/Mirror/Components/LagCompensation/HistoryCollider.cs new file mode 100644 index 0000000..8e841a4 --- /dev/null +++ b/Assets/Mirror/Components/LagCompensation/HistoryCollider.cs @@ -0,0 +1,107 @@ +// Applies HistoryBounds to the physics world by projecting to a trigger Collider. +// This way we can use Physics.Raycast on it. +using UnityEngine; + +namespace Mirror +{ + public class HistoryCollider : MonoBehaviour + { + [Header("Components")] + [Tooltip("The object's actual collider. We need to know where it is, and how large it is.")] + public Collider actualCollider; + + [Tooltip("The helper collider that the history bounds are projected onto.\nNeeds to be added to a child GameObject to counter-rotate an axis aligned Bounding Box onto it.\nThis is only used by this component.")] + public BoxCollider boundsCollider; + + [Header("History")] + [Tooltip("Keep this many past bounds in the buffer. The larger this is, the further we can raycast into the past.\nMaximum time := historyAmount * captureInterval")] + public int boundsLimit = 8; + + [Tooltip("Gather N bounds at a time into a bucket for faster encapsulation. A factor of 2 will be twice as fast, etc.")] + public int boundsPerBucket = 2; + + [Tooltip("Capture bounds every 'captureInterval' seconds. Larger values will require fewer computations, but may not capture every small move.")] + public float captureInterval = 0.100f; // 100 ms + double lastCaptureTime = 0; + + [Header("Debug")] + public Color historyColor = new Color(1.0f, 0.5f, 0.0f, 1.0f); + public Color currentColor = Color.red; + + protected HistoryBounds history = null; + + protected virtual void Awake() + { + history = new HistoryBounds(boundsLimit, boundsPerBucket); + + // ensure colliders were set. + // bounds collider should always be a trigger. + if (actualCollider == null) Debug.LogError("HistoryCollider: actualCollider was not set."); + if (boundsCollider == null) Debug.LogError("HistoryCollider: boundsCollider was not set."); + if (boundsCollider.transform.parent != transform) Debug.LogError("HistoryCollider: boundsCollider must be a child of this GameObject."); + if (!boundsCollider.isTrigger) Debug.LogError("HistoryCollider: boundsCollider must be a trigger."); + } + + // capturing and projecting onto colliders should use physics update + protected virtual void FixedUpdate() + { + // capture current bounds every interval + if (NetworkTime.localTime >= lastCaptureTime + captureInterval) + { + lastCaptureTime = NetworkTime.localTime; + CaptureBounds(); + } + + // project bounds onto helper collider + ProjectBounds(); + } + + protected virtual void CaptureBounds() + { + // grab current collider bounds + // this is in world space coordinates, and axis aligned + // TODO double check + Bounds bounds = actualCollider.bounds; + + // insert into history + history.Insert(bounds); + } + + protected virtual void ProjectBounds() + { + // grab total collider encapsulating all of history + Bounds total = history.total; + + // don't assign empty bounds, this will throw a Unity warning + if (history.boundsCount == 0) return; + + // scale projection doesn't work yet. + // for now, don't allow scale changes. + if (transform.lossyScale != Vector3.one) + { + Debug.LogWarning($"HistoryCollider: {name}'s transform global scale must be (1,1,1)."); + return; + } + + // counter rotate the child collider against the gameobject's rotation. + // we need this to always be axis aligned. + boundsCollider.transform.localRotation = Quaternion.Inverse(transform.rotation); + + // project world space bounds to collider's local space + boundsCollider.center = boundsCollider.transform.InverseTransformPoint(total.center); + boundsCollider.size = total.size; // TODO projection? + } + + // TODO runtime drawing for debugging? + protected virtual void OnDrawGizmos() + { + // draw total bounds + Gizmos.color = historyColor; + Gizmos.DrawWireCube(history.total.center, history.total.size); + + // draw current bounds + Gizmos.color = currentColor; + Gizmos.DrawWireCube(actualCollider.bounds.center, actualCollider.bounds.size); + } + } +} diff --git a/Assets/Mirror/Components/LagCompensation/HistoryCollider.cs.meta b/Assets/Mirror/Components/LagCompensation/HistoryCollider.cs.meta new file mode 100644 index 0000000..6275ff1 --- /dev/null +++ b/Assets/Mirror/Components/LagCompensation/HistoryCollider.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: f5f2158d9776d4b569858f793be4da60 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/LagCompensation/LagCompensator.cs b/Assets/Mirror/Components/LagCompensation/LagCompensator.cs new file mode 100644 index 0000000..96b6366 --- /dev/null +++ b/Assets/Mirror/Components/LagCompensation/LagCompensator.cs @@ -0,0 +1,196 @@ +// Add this component to a Player object with collider. +// Automatically keeps a history for lag compensation. +using System; +using System.Collections.Generic; +using UnityEngine; + +namespace Mirror +{ + public struct Capture3D : Capture + { + public double timestamp { get; set; } + public Vector3 position; + public Vector3 size; + + public Capture3D(double timestamp, Vector3 position, Vector3 size) + { + this.timestamp = timestamp; + this.position = position; + this.size = size; + } + + public void DrawGizmo() + { + Gizmos.DrawWireCube(position, size); + } + + public static Capture3D Interpolate(Capture3D from, Capture3D to, double t) => + new Capture3D( + 0, // interpolated snapshot is applied directly. don't need timestamps. + Vector3.LerpUnclamped(from.position, to.position, (float)t), + Vector3.LerpUnclamped(from.size, to.size, (float)t) + ); + + public override string ToString() => $"(time={timestamp} pos={position} size={size})"; + } + + [Obsolete("This is a preview version. Community feedback is welcome!")] + public class LagCompensator : NetworkBehaviour + { + [Header("Components")] + [Tooltip("The collider to keep a history of.")] + public Collider trackedCollider; // assign this in inspector + + [Header("Settings")] + public LagCompensationSettings lagCompensationSettings = new LagCompensationSettings(); + double lastCaptureTime; + + // lag compensation history of + readonly Queue> history = new Queue>(); + + [Header("Debugging")] + public Color historyColor = Color.white; + + protected virtual void Update() + { + // only capture on server + if (!NetworkServer.active) return; + + // capture lag compensation snapshots every interval. + // NetworkTime.localTime because Unity 2019 doesn't have 'double' time yet. + if (NetworkTime.localTime >= lastCaptureTime + lagCompensationSettings.captureInterval) + { + lastCaptureTime = NetworkTime.localTime; + Capture(); + } + } + + protected virtual void Capture() + { + // capture current state + Capture3D capture = new Capture3D( + NetworkTime.localTime, + trackedCollider.bounds.center, + trackedCollider.bounds.size + ); + + // insert into history + LagCompensation.Insert(history, lagCompensationSettings.historyLimit, NetworkTime.localTime, capture); + } + + protected virtual void OnDrawGizmos() + { + // draw history + Gizmos.color = historyColor; + LagCompensation.DrawGizmos(history); + } + + // sampling //////////////////////////////////////////////////////////// + // sample the sub-tick (=interpolated) history of this object for a hit test. + // 'viewer' needs to be the player who fired! + // for example, if A fires at B, then call B.Sample(viewer, point, tolerance). + [Server] + public virtual bool Sample(NetworkConnectionToClient viewer, out Capture3D sample) + { + // never trust the client: estimate client time instead. + // https://developer.valvesoftware.com/wiki/Source_Multiplayer_Networking + // the estimation is very good. the error is as low as ~6ms for the demo. + // note that passing 'rtt' is fine: EstimateTime halves it to latency. + double estimatedTime = LagCompensation.EstimateTime(NetworkTime.localTime, viewer.rtt, NetworkClient.bufferTime); + + // sample the history to get the nearest snapshots around 'timestamp' + if (LagCompensation.Sample(history, estimatedTime, lagCompensationSettings.captureInterval, out Capture3D resultBefore, out Capture3D resultAfter, out double t)) + { + // interpolate to get a decent estimation at exactly 'timestamp' + sample = Capture3D.Interpolate(resultBefore, resultAfter, t); + return true; + } + else Debug.Log($"CmdClicked: history doesn't contain {estimatedTime:F3}"); + + sample = default; + return false; + } + + // convenience tests /////////////////////////////////////////////////// + // there are multiple different ways to check a hit against the sample: + // - raycasting + // - bounds.contains + // - increasing bounds by tolerance and checking contains + // - threshold to bounds.closestpoint + // let's offer a few solutions directly and see which users prefer. + + // bounds check: checks distance to closest point on bounds in history @ -rtt. + // 'viewer' needs to be the player who fired! + // for example, if A fires at B, then call B.Sample(viewer, point, tolerance). + // this is super simple and fast, but not 100% physically accurate since we don't raycast. + [Server] + public virtual bool BoundsCheck( + NetworkConnectionToClient viewer, + Vector3 hitPoint, + float toleranceDistance, + out float distance, + out Vector3 nearest) + { + // first, sample the history at -rtt of the viewer. + if (Sample(viewer, out Capture3D capture)) + { + // now that we know where the other player was at that time, + // we can see if the hit point was within tolerance of it. + // TODO consider rotations??? + // TODO consider original collider shape?? + Bounds bounds = new Bounds(capture.position, capture.size); + nearest = bounds.ClosestPoint(hitPoint); + distance = Vector3.Distance(nearest, hitPoint); + return distance <= toleranceDistance; + } + nearest = hitPoint; + distance = 0; + return false; + } + + // raycast check: creates a collider the sampled position and raycasts to hitPoint. + // 'viewer' needs to be the player who fired! + // for example, if A fires at B, then call B.Sample(viewer, point, tolerance). + // this is physically accurate (checks against walls etc.), with the cost + // of a runtime instantiation. + // + // originPoint: where the player fired the weapon. + // hitPoint: where the player's local raycast hit. + // tolerance: scale up the sampled collider by % in order to have a bit of a tolerance. + // 0 means no extra tolerance, 0.05 means 5% extra tolerance. + // layerMask: the layer mask to use for the raycast. + [Server] + public virtual bool RaycastCheck( + NetworkConnectionToClient viewer, + Vector3 originPoint, + Vector3 hitPoint, + float tolerancePercent, + int layerMask, + out RaycastHit hit) + { + // first, sample the history at -rtt of the viewer. + if (Sample(viewer, out Capture3D capture)) + { + // instantiate a real physics collider on demand. + // TODO rotation?? + // TODO different collier types?? + GameObject temp = new GameObject("LagCompensatorTest"); + temp.transform.position = capture.position; + BoxCollider tempCollider = temp.AddComponent(); + tempCollider.size = capture.size * (1 + tolerancePercent); + + // raycast + Vector3 direction = hitPoint - originPoint; + float maxDistance = direction.magnitude * 2; + bool result = Physics.Raycast(originPoint, direction, out hit, maxDistance, layerMask); + + // cleanup + Destroy(temp); + return result; + } + + hit = default; + return false; + } + } +} diff --git a/Assets/Mirror/Components/LagCompensation/LagCompensator.cs.meta b/Assets/Mirror/Components/LagCompensation/LagCompensator.cs.meta new file mode 100644 index 0000000..d4912e4 --- /dev/null +++ b/Assets/Mirror/Components/LagCompensation/LagCompensator.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: a898831dd60c4cdfbfd9a6ea5702ed01 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/Mirror.Components.asmdef b/Assets/Mirror/Components/Mirror.Components.asmdef new file mode 100644 index 0000000..90c360e --- /dev/null +++ b/Assets/Mirror/Components/Mirror.Components.asmdef @@ -0,0 +1,16 @@ +{ + "name": "Mirror.Components", + "rootNamespace": "", + "references": [ + "GUID:30817c1a0e6d646d99c048fc403f5979" + ], + "includePlatforms": [], + "excludePlatforms": [], + "allowUnsafeCode": true, + "overrideReferences": false, + "precompiledReferences": [], + "autoReferenced": true, + "defineConstraints": [], + "versionDefines": [], + "noEngineReferences": false +} \ No newline at end of file diff --git a/Assets/Mirror/Components/Mirror.Components.asmdef.meta b/Assets/Mirror/Components/Mirror.Components.asmdef.meta new file mode 100644 index 0000000..263b6f0 --- /dev/null +++ b/Assets/Mirror/Components/Mirror.Components.asmdef.meta @@ -0,0 +1,7 @@ +fileFormatVersion: 2 +guid: 72872094b21c16e48b631b2224833d49 +AssemblyDefinitionImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/NetworkAnimator.cs b/Assets/Mirror/Components/NetworkAnimator.cs new file mode 100644 index 0000000..2189098 --- /dev/null +++ b/Assets/Mirror/Components/NetworkAnimator.cs @@ -0,0 +1,655 @@ +using System.Linq; +using UnityEngine; +using UnityEngine.Serialization; + +namespace Mirror +{ + /// + /// A component to synchronize Mecanim animation states for networked objects. + /// + /// + /// The animation of game objects can be networked by this component. There are two models of authority for networked movement: + /// If the object has authority on the client, then it should be animated locally on the owning client. The animation state information will be sent from the owning client to the server, then broadcast to all of the other clients. This is common for player objects. + /// If the object has authority on the server, then it should be animated on the server and state information will be sent to all clients. This is common for objects not related to a specific client, such as an enemy unit. + /// The NetworkAnimator synchronizes all animation parameters of the selected Animator. It does not automatically synchronize triggers. The function SetTrigger can by used by an object with authority to fire an animation trigger on other clients. + /// + // [RequireComponent(typeof(NetworkIdentity))] disabled to allow child NetworkBehaviours + [AddComponentMenu("Network/Network Animator")] + [HelpURL("https://mirror-networking.gitbook.io/docs/components/network-animator")] + public class NetworkAnimator : NetworkBehaviour + { + [Header("Authority")] + [Tooltip("Set to true if animations come from owner client, set to false if animations always come from server")] + public bool clientAuthority; + + /// + /// The animator component to synchronize. + /// + [FormerlySerializedAs("m_Animator")] + [Header("Animator")] + [Tooltip("Animator that will have parameters synchronized")] + public Animator animator; + + /// + /// Syncs animator.speed + /// + [SyncVar(hook = nameof(OnAnimatorSpeedChanged))] + float animatorSpeed; + float previousSpeed; + + // Note: not an object[] array because otherwise initialization is real annoying + int[] lastIntParameters; + float[] lastFloatParameters; + bool[] lastBoolParameters; + AnimatorControllerParameter[] parameters; + + // multiple layers + int[] animationHash; + int[] transitionHash; + float[] layerWeight; + double nextSendTime; + + bool SendMessagesAllowed + { + get + { + if (isServer) + { + if (!clientAuthority) + return true; + + // This is a special case where we have client authority but we have not assigned the client who has + // authority over it, no animator data will be sent over the network by the server. + // + // So we check here for a connectionToClient and if it is null we will + // let the server send animation data until we receive an owner. + if (netIdentity != null && netIdentity.connectionToClient == null) + return true; + } + + return (isOwned && clientAuthority); + } + } + + void Initialize() + { + // store the animator parameters in a variable - the "Animator.parameters" getter allocates + // a new parameter array every time it is accessed so we should avoid doing it in a loop + parameters = animator.parameters + .Where(par => !animator.IsParameterControlledByCurve(par.nameHash)) + .ToArray(); + lastIntParameters = new int[parameters.Length]; + lastFloatParameters = new float[parameters.Length]; + lastBoolParameters = new bool[parameters.Length]; + + animationHash = new int[animator.layerCount]; + transitionHash = new int[animator.layerCount]; + layerWeight = new float[animator.layerCount]; + } + + // fix https://github.com/MirrorNetworking/Mirror/issues/2810 + // both Awake and Enable need to initialize arrays. + // in case users call SetActive(false) -> SetActive(true). + void Awake() => Initialize(); + void OnEnable() => Initialize(); + + public virtual void Reset() + { + syncDirection = SyncDirection.ClientToServer; + } + + void FixedUpdate() + { + if (!SendMessagesAllowed) + return; + + if (!animator.enabled) + return; + + CheckSendRate(); + + for (int i = 0; i < animator.layerCount; i++) + { + int stateHash; + float normalizedTime; + if (!CheckAnimStateChanged(out stateHash, out normalizedTime, i)) + { + continue; + } + + using (NetworkWriterPooled writer = NetworkWriterPool.Get()) + { + WriteParameters(writer); + SendAnimationMessage(stateHash, normalizedTime, i, layerWeight[i], writer.ToArray()); + } + } + + CheckSpeed(); + } + + void CheckSpeed() + { + float newSpeed = animator.speed; + if (Mathf.Abs(previousSpeed - newSpeed) > 0.001f) + { + previousSpeed = newSpeed; + if (isServer) + { + animatorSpeed = newSpeed; + } + else if (isClient) + { + CmdSetAnimatorSpeed(newSpeed); + } + } + } + + void OnAnimatorSpeedChanged(float _, float value) + { + // skip if host or client with authority + // they will have already set the speed so don't set again + if (isServer || (isOwned && clientAuthority)) + return; + + animator.speed = value; + } + + bool CheckAnimStateChanged(out int stateHash, out float normalizedTime, int layerId) + { + bool change = false; + stateHash = 0; + normalizedTime = 0; + + float lw = animator.GetLayerWeight(layerId); + if (Mathf.Abs(lw - layerWeight[layerId]) > 0.001f) + { + layerWeight[layerId] = lw; + change = true; + } + + if (animator.IsInTransition(layerId)) + { + AnimatorTransitionInfo tt = animator.GetAnimatorTransitionInfo(layerId); + if (tt.fullPathHash != transitionHash[layerId]) + { + // first time in this transition + transitionHash[layerId] = tt.fullPathHash; + animationHash[layerId] = 0; + return true; + } + return change; + } + + AnimatorStateInfo st = animator.GetCurrentAnimatorStateInfo(layerId); + if (st.fullPathHash != animationHash[layerId]) + { + // first time in this animation state + if (animationHash[layerId] != 0) + { + // came from another animation directly - from Play() + stateHash = st.fullPathHash; + normalizedTime = st.normalizedTime; + } + transitionHash[layerId] = 0; + animationHash[layerId] = st.fullPathHash; + return true; + } + return change; + } + + void CheckSendRate() + { + double now = NetworkTime.localTime; + if (SendMessagesAllowed && syncInterval >= 0 && now > nextSendTime) + { + nextSendTime = now + syncInterval; + + using (NetworkWriterPooled writer = NetworkWriterPool.Get()) + { + if (WriteParameters(writer)) + SendAnimationParametersMessage(writer.ToArray()); + } + } + } + + void SendAnimationMessage(int stateHash, float normalizedTime, int layerId, float weight, byte[] parameters) + { + if (isServer) + { + RpcOnAnimationClientMessage(stateHash, normalizedTime, layerId, weight, parameters); + } + else if (isClient) + { + CmdOnAnimationServerMessage(stateHash, normalizedTime, layerId, weight, parameters); + } + } + + void SendAnimationParametersMessage(byte[] parameters) + { + if (isServer) + { + RpcOnAnimationParametersClientMessage(parameters); + } + else if (isClient) + { + CmdOnAnimationParametersServerMessage(parameters); + } + } + + void HandleAnimMsg(int stateHash, float normalizedTime, int layerId, float weight, NetworkReader reader) + { + if (isOwned && clientAuthority) + return; + + // usually transitions will be triggered by parameters, if not, play anims directly. + // NOTE: this plays "animations", not transitions, so any transitions will be skipped. + // NOTE: there is no API to play a transition(?) + if (stateHash != 0 && animator.enabled) + { + animator.Play(stateHash, layerId, normalizedTime); + } + + animator.SetLayerWeight(layerId, weight); + + ReadParameters(reader); + } + + void HandleAnimParamsMsg(NetworkReader reader) + { + if (isOwned && clientAuthority) + return; + + ReadParameters(reader); + } + + void HandleAnimTriggerMsg(int hash) + { + if (animator.enabled) + animator.SetTrigger(hash); + } + + void HandleAnimResetTriggerMsg(int hash) + { + if (animator.enabled) + animator.ResetTrigger(hash); + } + + ulong NextDirtyBits() + { + ulong dirtyBits = 0; + for (int i = 0; i < parameters.Length; i++) + { + AnimatorControllerParameter par = parameters[i]; + bool changed = false; + if (par.type == AnimatorControllerParameterType.Int) + { + int newIntValue = animator.GetInteger(par.nameHash); + changed = newIntValue != lastIntParameters[i]; + if (changed) + lastIntParameters[i] = newIntValue; + } + else if (par.type == AnimatorControllerParameterType.Float) + { + float newFloatValue = animator.GetFloat(par.nameHash); + changed = Mathf.Abs(newFloatValue - lastFloatParameters[i]) > 0.001f; + // only set lastValue if it was changed, otherwise value could slowly drift within the 0.001f limit each frame + if (changed) + lastFloatParameters[i] = newFloatValue; + } + else if (par.type == AnimatorControllerParameterType.Bool) + { + bool newBoolValue = animator.GetBool(par.nameHash); + changed = newBoolValue != lastBoolParameters[i]; + if (changed) + lastBoolParameters[i] = newBoolValue; + } + if (changed) + { + dirtyBits |= 1ul << i; + } + } + return dirtyBits; + } + + bool WriteParameters(NetworkWriter writer, bool forceAll = false) + { + // fix: https://github.com/MirrorNetworking/Mirror/issues/2852 + // serialize parameterCount to be 100% sure we deserialize correct amount of bytes. + // (255 parameters should be enough for everyone, write it as byte) + byte parameterCount = (byte)parameters.Length; + writer.WriteByte(parameterCount); + + ulong dirtyBits = forceAll ? (~0ul) : NextDirtyBits(); + writer.WriteULong(dirtyBits); + + // iterate on byte count. if it's >256, it won't break + // serialization - just not serialize excess layers. + for (int i = 0; i < parameterCount; i++) + { + if ((dirtyBits & (1ul << i)) == 0) + continue; + + AnimatorControllerParameter par = parameters[i]; + if (par.type == AnimatorControllerParameterType.Int) + { + int newIntValue = animator.GetInteger(par.nameHash); + writer.WriteInt(newIntValue); + } + else if (par.type == AnimatorControllerParameterType.Float) + { + float newFloatValue = animator.GetFloat(par.nameHash); + writer.WriteFloat(newFloatValue); + } + else if (par.type == AnimatorControllerParameterType.Bool) + { + bool newBoolValue = animator.GetBool(par.nameHash); + writer.WriteBool(newBoolValue); + } + } + return dirtyBits != 0; + } + + void ReadParameters(NetworkReader reader) + { + // fix: https://github.com/MirrorNetworking/Mirror/issues/2852 + // serialize parameterCount to be 100% sure we deserialize correct amount of bytes. + // mismatch shows error to make this super easy to debug. + byte parameterCount = reader.ReadByte(); + if (parameterCount != parameters.Length) + { + Debug.LogError($"NetworkAnimator: serialized parameter count={parameterCount} does not match expected parameter count={parameters.Length}. Are you changing animators at runtime?", gameObject); + return; + } + + bool animatorEnabled = animator.enabled; + // need to read values from NetworkReader even if animator is disabled + ulong dirtyBits = reader.ReadULong(); + for (int i = 0; i < parameterCount; i++) + { + if ((dirtyBits & (1ul << i)) == 0) + continue; + + AnimatorControllerParameter par = parameters[i]; + if (par.type == AnimatorControllerParameterType.Int) + { + int newIntValue = reader.ReadInt(); + if (animatorEnabled) + animator.SetInteger(par.nameHash, newIntValue); + } + else if (par.type == AnimatorControllerParameterType.Float) + { + float newFloatValue = reader.ReadFloat(); + if (animatorEnabled) + animator.SetFloat(par.nameHash, newFloatValue); + } + else if (par.type == AnimatorControllerParameterType.Bool) + { + bool newBoolValue = reader.ReadBool(); + if (animatorEnabled) + animator.SetBool(par.nameHash, newBoolValue); + } + } + } + + public override void OnSerialize(NetworkWriter writer, bool initialState) + { + base.OnSerialize(writer, initialState); + if (initialState) + { + // fix: https://github.com/MirrorNetworking/Mirror/issues/2852 + // serialize layerCount to be 100% sure we deserialize correct amount of bytes. + // (255 layers should be enough for everyone, write it as byte) + byte layerCount = (byte)animator.layerCount; + writer.WriteByte(layerCount); + + // iterate on byte count. if it's >256, it won't break + // serialization - just not serialize excess layers. + for (int i = 0; i < layerCount; i++) + { + AnimatorStateInfo st = animator.IsInTransition(i) + ? animator.GetNextAnimatorStateInfo(i) + : animator.GetCurrentAnimatorStateInfo(i); + writer.WriteInt(st.fullPathHash); + writer.WriteFloat(st.normalizedTime); + writer.WriteFloat(animator.GetLayerWeight(i)); + } + WriteParameters(writer, true); + } + } + + public override void OnDeserialize(NetworkReader reader, bool initialState) + { + base.OnDeserialize(reader, initialState); + if (initialState) + { + // fix: https://github.com/MirrorNetworking/Mirror/issues/2852 + // serialize layerCount to be 100% sure we deserialize correct amount of bytes. + // mismatch shows error to make this super easy to debug. + byte layerCount = reader.ReadByte(); + if (layerCount != animator.layerCount) + { + Debug.LogError($"NetworkAnimator: serialized layer count={layerCount} does not match expected layer count={animator.layerCount}. Are you changing animators at runtime?", gameObject); + return; + } + + for (int i = 0; i < layerCount; i++) + { + int stateHash = reader.ReadInt(); + float normalizedTime = reader.ReadFloat(); + float weight = reader.ReadFloat(); + + animator.SetLayerWeight(i, weight); + animator.Play(stateHash, i, normalizedTime); + } + + ReadParameters(reader); + } + } + + /// + /// Causes an animation trigger to be invoked for a networked object. + /// If local authority is set, and this is called from the client, then the trigger will be invoked on the server and all clients. If not, then this is called on the server, and the trigger will be called on all clients. + /// + /// Name of trigger. + public void SetTrigger(string triggerName) + { + SetTrigger(Animator.StringToHash(triggerName)); + } + + /// + /// Causes an animation trigger to be invoked for a networked object. + /// + /// Hash id of trigger (from the Animator). + public void SetTrigger(int hash) + { + if (clientAuthority) + { + if (!isClient) + { + Debug.LogWarning("Tried to set animation in the server for a client-controlled animator", gameObject); + return; + } + + if (!isOwned) + { + Debug.LogWarning("Only the client with authority can set animations", gameObject); + return; + } + + if (isClient) + CmdOnAnimationTriggerServerMessage(hash); + + // call on client right away + HandleAnimTriggerMsg(hash); + } + else + { + if (!isServer) + { + Debug.LogWarning("Tried to set animation in the client for a server-controlled animator", gameObject); + return; + } + + HandleAnimTriggerMsg(hash); + RpcOnAnimationTriggerClientMessage(hash); + } + } + + /// + /// Causes an animation trigger to be reset for a networked object. + /// If local authority is set, and this is called from the client, then the trigger will be reset on the server and all clients. If not, then this is called on the server, and the trigger will be reset on all clients. + /// + /// Name of trigger. + public void ResetTrigger(string triggerName) + { + ResetTrigger(Animator.StringToHash(triggerName)); + } + + /// Causes an animation trigger to be reset for a networked object. + /// Hash id of trigger (from the Animator). + public void ResetTrigger(int hash) + { + if (clientAuthority) + { + if (!isClient) + { + Debug.LogWarning("Tried to reset animation in the server for a client-controlled animator", gameObject); + return; + } + + if (!isOwned) + { + Debug.LogWarning("Only the client with authority can reset animations", gameObject); + return; + } + + if (isClient) + CmdOnAnimationResetTriggerServerMessage(hash); + + // call on client right away + HandleAnimResetTriggerMsg(hash); + } + else + { + if (!isServer) + { + Debug.LogWarning("Tried to reset animation in the client for a server-controlled animator", gameObject); + return; + } + + HandleAnimResetTriggerMsg(hash); + RpcOnAnimationResetTriggerClientMessage(hash); + } + } + + #region server message handlers + + [Command] + void CmdOnAnimationServerMessage(int stateHash, float normalizedTime, int layerId, float weight, byte[] parameters) + { + // Ignore messages from client if not in client authority mode + if (!clientAuthority) + return; + + //Debug.Log($"OnAnimationMessage for netId {netId}"); + + // handle and broadcast + using (NetworkReaderPooled networkReader = NetworkReaderPool.Get(parameters)) + { + HandleAnimMsg(stateHash, normalizedTime, layerId, weight, networkReader); + RpcOnAnimationClientMessage(stateHash, normalizedTime, layerId, weight, parameters); + } + } + + [Command] + void CmdOnAnimationParametersServerMessage(byte[] parameters) + { + // Ignore messages from client if not in client authority mode + if (!clientAuthority) + return; + + // handle and broadcast + using (NetworkReaderPooled networkReader = NetworkReaderPool.Get(parameters)) + { + HandleAnimParamsMsg(networkReader); + RpcOnAnimationParametersClientMessage(parameters); + } + } + + [Command] + void CmdOnAnimationTriggerServerMessage(int hash) + { + // Ignore messages from client if not in client authority mode + if (!clientAuthority) + return; + + // handle and broadcast + // host should have already the trigger + bool isHostOwner = isClient && isOwned; + if (!isHostOwner) + { + HandleAnimTriggerMsg(hash); + } + + RpcOnAnimationTriggerClientMessage(hash); + } + + [Command] + void CmdOnAnimationResetTriggerServerMessage(int hash) + { + // Ignore messages from client if not in client authority mode + if (!clientAuthority) + return; + + // handle and broadcast + // host should have already the trigger + bool isHostOwner = isClient && isOwned; + if (!isHostOwner) + { + HandleAnimResetTriggerMsg(hash); + } + + RpcOnAnimationResetTriggerClientMessage(hash); + } + + [Command] + void CmdSetAnimatorSpeed(float newSpeed) + { + // set animator + animator.speed = newSpeed; + animatorSpeed = newSpeed; + } + + #endregion + + #region client message handlers + + [ClientRpc] + void RpcOnAnimationClientMessage(int stateHash, float normalizedTime, int layerId, float weight, byte[] parameters) + { + using (NetworkReaderPooled networkReader = NetworkReaderPool.Get(parameters)) + HandleAnimMsg(stateHash, normalizedTime, layerId, weight, networkReader); + } + + [ClientRpc] + void RpcOnAnimationParametersClientMessage(byte[] parameters) + { + using (NetworkReaderPooled networkReader = NetworkReaderPool.Get(parameters)) + HandleAnimParamsMsg(networkReader); + } + + [ClientRpc(includeOwner = false)] + void RpcOnAnimationTriggerClientMessage(int hash) + { + HandleAnimTriggerMsg(hash); + } + + [ClientRpc(includeOwner = false)] + void RpcOnAnimationResetTriggerClientMessage(int hash) + { + HandleAnimResetTriggerMsg(hash); + } + + #endregion + } +} diff --git a/Assets/Mirror/Components/NetworkAnimator.cs.meta b/Assets/Mirror/Components/NetworkAnimator.cs.meta new file mode 100644 index 0000000..211ce78 --- /dev/null +++ b/Assets/Mirror/Components/NetworkAnimator.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 7f6f3bf89aa97405989c802ba270f815 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/NetworkDiagnosticsDebugger.cs b/Assets/Mirror/Components/NetworkDiagnosticsDebugger.cs new file mode 100644 index 0000000..021b791 --- /dev/null +++ b/Assets/Mirror/Components/NetworkDiagnosticsDebugger.cs @@ -0,0 +1,30 @@ +using UnityEngine; + +namespace Mirror +{ + public class NetworkDiagnosticsDebugger : MonoBehaviour + { + public bool logInMessages = true; + public bool logOutMessages = true; + void OnInMessage(NetworkDiagnostics.MessageInfo msgInfo) + { + if (logInMessages) + Debug.Log(msgInfo); + } + void OnOutMessage(NetworkDiagnostics.MessageInfo msgInfo) + { + if (logOutMessages) + Debug.Log(msgInfo); + } + void OnEnable() + { + NetworkDiagnostics.InMessageEvent += OnInMessage; + NetworkDiagnostics.OutMessageEvent += OnOutMessage; + } + void OnDisable() + { + NetworkDiagnostics.InMessageEvent -= OnInMessage; + NetworkDiagnostics.OutMessageEvent -= OnOutMessage; + } + } +} diff --git a/Assets/Mirror/Components/NetworkDiagnosticsDebugger.cs.meta b/Assets/Mirror/Components/NetworkDiagnosticsDebugger.cs.meta new file mode 100644 index 0000000..5a9819e --- /dev/null +++ b/Assets/Mirror/Components/NetworkDiagnosticsDebugger.cs.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: bc9f0a0fe4124424b8f9d4927795ee01 +timeCreated: 1700945893 \ No newline at end of file diff --git a/Assets/Mirror/Components/NetworkLobbyManager.cs b/Assets/Mirror/Components/NetworkLobbyManager.cs new file mode 100644 index 0000000..3dcd4ea --- /dev/null +++ b/Assets/Mirror/Components/NetworkLobbyManager.cs @@ -0,0 +1,18 @@ +using System; +using UnityEngine; + +namespace Mirror +{ + /// + /// This is a specialized NetworkManager that includes a networked lobby. + /// + /// + /// The lobby has slots that track the joined players, and a maximum player count that is enforced. It requires that the NetworkLobbyPlayer component be on the lobby player objects. + /// NetworkLobbyManager is derived from NetworkManager, and so it implements many of the virtual functions provided by the NetworkManager class. To avoid accidentally replacing functionality of the NetworkLobbyManager, there are new virtual functions on the NetworkLobbyManager that begin with "OnLobby". These should be used on classes derived from NetworkLobbyManager instead of the virtual functions on NetworkManager. + /// The OnLobby*() functions have empty implementations on the NetworkLobbyManager base class, so the base class functions do not have to be called. + /// + [AddComponentMenu("Network/Network Lobby Manager")] + [HelpURL("https://mirror-networking.gitbook.io/docs/components/network-room-manager")] + [Obsolete("Use / inherit from NetworkRoomManager instead")] + public class NetworkLobbyManager : NetworkRoomManager {} +} diff --git a/Assets/Mirror/Components/NetworkLobbyManager.cs.meta b/Assets/Mirror/Components/NetworkLobbyManager.cs.meta new file mode 100644 index 0000000..a32c8c7 --- /dev/null +++ b/Assets/Mirror/Components/NetworkLobbyManager.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: a4c96e6dd99826849ab1431f94547141 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/NetworkLobbyPlayer.cs b/Assets/Mirror/Components/NetworkLobbyPlayer.cs new file mode 100644 index 0000000..95ffbbc --- /dev/null +++ b/Assets/Mirror/Components/NetworkLobbyPlayer.cs @@ -0,0 +1,15 @@ +using System; +using UnityEngine; + +namespace Mirror +{ + /// + /// This component works in conjunction with the NetworkLobbyManager to make up the multiplayer lobby system. + /// The LobbyPrefab object of the NetworkLobbyManager must have this component on it. This component holds basic lobby player data required for the lobby to function. Game specific data for lobby players can be put in other components on the LobbyPrefab or in scripts derived from NetworkLobbyPlayer. + /// + [DisallowMultipleComponent] + [AddComponentMenu("Network/Network Lobby Player")] + [HelpURL("https://mirror-networking.gitbook.io/docs/components/network-room-player")] + [Obsolete("Use / inherit from NetworkRoomPlayer instead")] + public class NetworkLobbyPlayer : NetworkRoomPlayer {} +} diff --git a/Assets/Mirror/Components/NetworkLobbyPlayer.cs.meta b/Assets/Mirror/Components/NetworkLobbyPlayer.cs.meta new file mode 100644 index 0000000..7a21eec --- /dev/null +++ b/Assets/Mirror/Components/NetworkLobbyPlayer.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 777a368af85f2e84da7ea5666581921b +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/NetworkPingDisplay.cs b/Assets/Mirror/Components/NetworkPingDisplay.cs new file mode 100644 index 0000000..255e62d --- /dev/null +++ b/Assets/Mirror/Components/NetworkPingDisplay.cs @@ -0,0 +1,39 @@ +using System; +using UnityEngine; + +namespace Mirror +{ + /// + /// Component that will display the clients ping in milliseconds + /// + [DisallowMultipleComponent] + [AddComponentMenu("Network/Network Ping Display")] + [HelpURL("https://mirror-networking.gitbook.io/docs/components/network-ping-display")] + public class NetworkPingDisplay : MonoBehaviour + { + public Color color = Color.white; + public int padding = 2; + public int width = 150; + public int height = 25; + + void OnGUI() + { + // only while client is active + if (!NetworkClient.active) return; + + // show stats in bottom right corner, right aligned + GUI.color = color; + Rect rect = new Rect(Screen.width - width - padding, Screen.height - height - padding, width, height); + GUILayout.BeginArea(rect); + GUIStyle style = GUI.skin.GetStyle("Label"); + style.alignment = TextAnchor.MiddleRight; + GUILayout.BeginHorizontal(style); + GUILayout.Label($"RTT: {Math.Round(NetworkTime.rtt * 1000)}ms"); + GUI.color = NetworkClient.connectionQuality.ColorCode(); + GUILayout.Label($"Q: {new string('-', (int)NetworkClient.connectionQuality)}"); + GUILayout.EndHorizontal(); + GUILayout.EndArea(); + GUI.color = Color.white; + } + } +} diff --git a/Assets/Mirror/Components/NetworkPingDisplay.cs.meta b/Assets/Mirror/Components/NetworkPingDisplay.cs.meta new file mode 100644 index 0000000..221a745 --- /dev/null +++ b/Assets/Mirror/Components/NetworkPingDisplay.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: bc654f29862fc2643b948f772ebb9e68 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/NetworkRigidbody.meta b/Assets/Mirror/Components/NetworkRigidbody.meta new file mode 100644 index 0000000..a67178e --- /dev/null +++ b/Assets/Mirror/Components/NetworkRigidbody.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: 80106690aef541a5b8e2f8fb3d5949ad +timeCreated: 1686733778 \ No newline at end of file diff --git a/Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyReliable.cs b/Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyReliable.cs new file mode 100644 index 0000000..4611d3b --- /dev/null +++ b/Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyReliable.cs @@ -0,0 +1,96 @@ +using UnityEngine; + +namespace Mirror +{ + // [RequireComponent(typeof(Rigidbody))] <- OnValidate ensures this is on .target + public class NetworkRigidbodyReliable : NetworkTransformReliable + { + bool clientAuthority => syncDirection == SyncDirection.ClientToServer; + + Rigidbody rb; + bool wasKinematic; + + // cach Rigidbody and original isKinematic setting + protected override void Awake() + { + // we can't overwrite .target to be a Rigidbody. + // but we can use its Rigidbody component. + rb = target.GetComponent(); + if (rb == null) + { + Debug.LogError($"{name}'s NetworkRigidbody.target {target.name} is missing a Rigidbody", this); + return; + } + wasKinematic = rb.isKinematic; + base.Awake(); + } + + // reset forced isKinematic flag to original. + // otherwise the overwritten value would remain between sessions forever. + // for example, a game may run as client, set rigidbody.iskinematic=true, + // then run as server, where .iskinematic isn't touched and remains at + // the overwritten=true, even though the user set it to false originally. + public override void OnStopServer() => rb.isKinematic = wasKinematic; + public override void OnStopClient() => rb.isKinematic = wasKinematic; + + // overwriting Construct() and Apply() to set Rigidbody.MovePosition + // would give more jittery movement. + + // FixedUpdate for physics + void FixedUpdate() + { + // who ever has authority moves the Rigidbody with physics. + // everyone else simply sets it to kinematic. + // so that only the Transform component is synced. + + // host mode + if (isServer && isClient) + { + // in host mode, we own it it if: + // clientAuthority is disabled (hence server / we own it) + // clientAuthority is enabled and we have authority over this object. + bool owned = !clientAuthority || IsClientWithAuthority; + + // only set to kinematic if we don't own it + // otherwise don't touch isKinematic. + // the authority owner might use it either way. + if (!owned) rb.isKinematic = true; + } + // client only + else if (isClient) + { + // on the client, we own it only if clientAuthority is enabled, + // and we have authority over this object. + bool owned = IsClientWithAuthority; + + // only set to kinematic if we don't own it + // otherwise don't touch isKinematic. + // the authority owner might use it either way. + if (!owned) rb.isKinematic = true; + } + // server only + else if (isServer) + { + // on the server, we always own it if clientAuthority is disabled. + bool owned = !clientAuthority; + + // only set to kinematic if we don't own it + // otherwise don't touch isKinematic. + // the authority owner might use it either way. + if (!owned) rb.isKinematic = true; + } + } + + protected override void OnValidate() + { + base.OnValidate(); + + // we can't overwrite .target to be a Rigidbody. + // but we can ensure that .target has a Rigidbody, and use it. + if (target.GetComponent() == null) + { + Debug.LogWarning($"{name}'s NetworkRigidbody.target {target.name} is missing a Rigidbody", this); + } + } + } +} diff --git a/Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyReliable.cs.meta b/Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyReliable.cs.meta new file mode 100644 index 0000000..b3b61c9 --- /dev/null +++ b/Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyReliable.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: cb803efbe62c34d7baece46c9ffebad9 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyReliable2D.cs b/Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyReliable2D.cs new file mode 100644 index 0000000..82bc25b --- /dev/null +++ b/Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyReliable2D.cs @@ -0,0 +1,96 @@ +using UnityEngine; + +namespace Mirror +{ + // [RequireComponent(typeof(Rigidbody))] <- OnValidate ensures this is on .target + public class NetworkRigidbodyReliable2D : NetworkTransformReliable + { + bool clientAuthority => syncDirection == SyncDirection.ClientToServer; + + Rigidbody2D rb; + bool wasKinematic; + + // cach Rigidbody and original isKinematic setting + protected override void Awake() + { + // we can't overwrite .target to be a Rigidbody. + // but we can use its Rigidbody component. + rb = target.GetComponent(); + if (rb == null) + { + Debug.LogError($"{name}'s NetworkRigidbody2D.target {target.name} is missing a Rigidbody2D", this); + return; + } + wasKinematic = rb.isKinematic; + base.Awake(); + } + + // reset forced isKinematic flag to original. + // otherwise the overwritten value would remain between sessions forever. + // for example, a game may run as client, set rigidbody.iskinematic=true, + // then run as server, where .iskinematic isn't touched and remains at + // the overwritten=true, even though the user set it to false originally. + public override void OnStopServer() => rb.isKinematic = wasKinematic; + public override void OnStopClient() => rb.isKinematic = wasKinematic; + + // overwriting Construct() and Apply() to set Rigidbody.MovePosition + // would give more jittery movement. + + // FixedUpdate for physics + void FixedUpdate() + { + // who ever has authority moves the Rigidbody with physics. + // everyone else simply sets it to kinematic. + // so that only the Transform component is synced. + + // host mode + if (isServer && isClient) + { + // in host mode, we own it it if: + // clientAuthority is disabled (hence server / we own it) + // clientAuthority is enabled and we have authority over this object. + bool owned = !clientAuthority || IsClientWithAuthority; + + // only set to kinematic if we don't own it + // otherwise don't touch isKinematic. + // the authority owner might use it either way. + if (!owned) rb.isKinematic = true; + } + // client only + else if (isClient) + { + // on the client, we own it only if clientAuthority is enabled, + // and we have authority over this object. + bool owned = IsClientWithAuthority; + + // only set to kinematic if we don't own it + // otherwise don't touch isKinematic. + // the authority owner might use it either way. + if (!owned) rb.isKinematic = true; + } + // server only + else if (isServer) + { + // on the server, we always own it if clientAuthority is disabled. + bool owned = !clientAuthority; + + // only set to kinematic if we don't own it + // otherwise don't touch isKinematic. + // the authority owner might use it either way. + if (!owned) rb.isKinematic = true; + } + } + + protected override void OnValidate() + { + base.OnValidate(); + + // we can't overwrite .target to be a Rigidbody. + // but we can ensure that .target has a Rigidbody, and use it. + if (target.GetComponent() == null) + { + Debug.LogWarning($"{name}'s NetworkRigidbody2D.target {target.name} is missing a Rigidbody2D", this); + } + } + } +} diff --git a/Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyReliable2D.cs.meta b/Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyReliable2D.cs.meta new file mode 100644 index 0000000..172c8a4 --- /dev/null +++ b/Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyReliable2D.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 7ec4f7556ca1e4b55a3381fc6a02b1bc +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyUnreliable.cs b/Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyUnreliable.cs new file mode 100644 index 0000000..c943f18 --- /dev/null +++ b/Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyUnreliable.cs @@ -0,0 +1,96 @@ +using UnityEngine; + +namespace Mirror +{ + // [RequireComponent(typeof(Rigidbody))] <- OnValidate ensures this is on .target + public class NetworkRigidbodyUnreliable : NetworkTransformUnreliable + { + bool clientAuthority => syncDirection == SyncDirection.ClientToServer; + + Rigidbody rb; + bool wasKinematic; + + // cach Rigidbody and original isKinematic setting + protected override void Awake() + { + // we can't overwrite .target to be a Rigidbody. + // but we can use its Rigidbody component. + rb = target.GetComponent(); + if (rb == null) + { + Debug.LogError($"{name}'s NetworkRigidbody.target {target.name} is missing a Rigidbody", this); + return; + } + wasKinematic = rb.isKinematic; + base.Awake(); + } + + // reset forced isKinematic flag to original. + // otherwise the overwritten value would remain between sessions forever. + // for example, a game may run as client, set rigidbody.iskinematic=true, + // then run as server, where .iskinematic isn't touched and remains at + // the overwritten=true, even though the user set it to false originally. + public override void OnStopServer() => rb.isKinematic = wasKinematic; + public override void OnStopClient() => rb.isKinematic = wasKinematic; + + // overwriting Construct() and Apply() to set Rigidbody.MovePosition + // would give more jittery movement. + + // FixedUpdate for physics + void FixedUpdate() + { + // who ever has authority moves the Rigidbody with physics. + // everyone else simply sets it to kinematic. + // so that only the Transform component is synced. + + // host mode + if (isServer && isClient) + { + // in host mode, we own it it if: + // clientAuthority is disabled (hence server / we own it) + // clientAuthority is enabled and we have authority over this object. + bool owned = !clientAuthority || IsClientWithAuthority; + + // only set to kinematic if we don't own it + // otherwise don't touch isKinematic. + // the authority owner might use it either way. + if (!owned) rb.isKinematic = true; + } + // client only + else if (isClient) + { + // on the client, we own it only if clientAuthority is enabled, + // and we have authority over this object. + bool owned = IsClientWithAuthority; + + // only set to kinematic if we don't own it + // otherwise don't touch isKinematic. + // the authority owner might use it either way. + if (!owned) rb.isKinematic = true; + } + // server only + else if (isServer) + { + // on the server, we always own it if clientAuthority is disabled. + bool owned = !clientAuthority; + + // only set to kinematic if we don't own it + // otherwise don't touch isKinematic. + // the authority owner might use it either way. + if (!owned) rb.isKinematic = true; + } + } + + protected override void OnValidate() + { + base.OnValidate(); + + // we can't overwrite .target to be a Rigidbody. + // but we can ensure that .target has a Rigidbody, and use it. + if (target.GetComponent() == null) + { + Debug.LogWarning($"{name}'s NetworkRigidbody.target {target.name} is missing a Rigidbody", this); + } + } + } +} diff --git a/Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyUnreliable.cs.meta b/Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyUnreliable.cs.meta new file mode 100644 index 0000000..2dfb14b --- /dev/null +++ b/Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyUnreliable.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 3b20dc110904e47f8a154cdcf6433eae +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyUnreliable2D.cs b/Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyUnreliable2D.cs new file mode 100644 index 0000000..c770b33 --- /dev/null +++ b/Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyUnreliable2D.cs @@ -0,0 +1,96 @@ +using UnityEngine; + +namespace Mirror +{ + // [RequireComponent(typeof(Rigidbody))] <- OnValidate ensures this is on .target + public class NetworkRigidbodyUnreliable2D : NetworkTransformUnreliable + { + bool clientAuthority => syncDirection == SyncDirection.ClientToServer; + + Rigidbody2D rb; + bool wasKinematic; + + // cach Rigidbody and original isKinematic setting + protected override void Awake() + { + // we can't overwrite .target to be a Rigidbody. + // but we can use its Rigidbody component. + rb = target.GetComponent(); + if (rb == null) + { + Debug.LogError($"{name}'s NetworkRigidbody2D.target {target.name} is missing a Rigidbody2D", this); + return; + } + wasKinematic = rb.isKinematic; + base.Awake(); + } + + // reset forced isKinematic flag to original. + // otherwise the overwritten value would remain between sessions forever. + // for example, a game may run as client, set rigidbody.iskinematic=true, + // then run as server, where .iskinematic isn't touched and remains at + // the overwritten=true, even though the user set it to false originally. + public override void OnStopServer() => rb.isKinematic = wasKinematic; + public override void OnStopClient() => rb.isKinematic = wasKinematic; + + // overwriting Construct() and Apply() to set Rigidbody.MovePosition + // would give more jittery movement. + + // FixedUpdate for physics + void FixedUpdate() + { + // who ever has authority moves the Rigidbody with physics. + // everyone else simply sets it to kinematic. + // so that only the Transform component is synced. + + // host mode + if (isServer && isClient) + { + // in host mode, we own it it if: + // clientAuthority is disabled (hence server / we own it) + // clientAuthority is enabled and we have authority over this object. + bool owned = !clientAuthority || IsClientWithAuthority; + + // only set to kinematic if we don't own it + // otherwise don't touch isKinematic. + // the authority owner might use it either way. + if (!owned) rb.isKinematic = true; + } + // client only + else if (isClient) + { + // on the client, we own it only if clientAuthority is enabled, + // and we have authority over this object. + bool owned = IsClientWithAuthority; + + // only set to kinematic if we don't own it + // otherwise don't touch isKinematic. + // the authority owner might use it either way. + if (!owned) rb.isKinematic = true; + } + // server only + else if (isServer) + { + // on the server, we always own it if clientAuthority is disabled. + bool owned = !clientAuthority; + + // only set to kinematic if we don't own it + // otherwise don't touch isKinematic. + // the authority owner might use it either way. + if (!owned) rb.isKinematic = true; + } + } + + protected override void OnValidate() + { + base.OnValidate(); + + // we can't overwrite .target to be a Rigidbody. + // but we can ensure that .target has a Rigidbody, and use it. + if (target.GetComponent() == null) + { + Debug.LogWarning($"{name}'s NetworkRigidbody2D.target {target.name} is missing a Rigidbody2D", this); + } + } + } +} diff --git a/Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyUnreliable2D.cs.meta b/Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyUnreliable2D.cs.meta new file mode 100644 index 0000000..8a19149 --- /dev/null +++ b/Assets/Mirror/Components/NetworkRigidbody/NetworkRigidbodyUnreliable2D.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 1c7e12ad9b9ae443c9fdf37e9f5ecd36 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/NetworkRoomManager.cs b/Assets/Mirror/Components/NetworkRoomManager.cs new file mode 100644 index 0000000..11e17f2 --- /dev/null +++ b/Assets/Mirror/Components/NetworkRoomManager.cs @@ -0,0 +1,685 @@ +using System.Collections.Generic; +using System.Linq; +using UnityEngine; +using UnityEngine.SceneManagement; +using UnityEngine.Serialization; + +namespace Mirror +{ + /// + /// This is a specialized NetworkManager that includes a networked room. + /// + /// + /// The room has slots that track the joined players, and a maximum player count that is enforced. It requires that the NetworkRoomPlayer component be on the room player objects. + /// NetworkRoomManager is derived from NetworkManager, and so it implements many of the virtual functions provided by the NetworkManager class. To avoid accidentally replacing functionality of the NetworkRoomManager, there are new virtual functions on the NetworkRoomManager that begin with "OnRoom". These should be used on classes derived from NetworkRoomManager instead of the virtual functions on NetworkManager. + /// The OnRoom*() functions have empty implementations on the NetworkRoomManager base class, so the base class functions do not have to be called. + /// + [AddComponentMenu("Network/Network Room Manager")] + [HelpURL("https://mirror-networking.gitbook.io/docs/components/network-room-manager")] + public class NetworkRoomManager : NetworkManager + { + public struct PendingPlayer + { + public NetworkConnectionToClient conn; + public GameObject roomPlayer; + } + + [Header("Room Settings")] + [FormerlySerializedAs("m_ShowRoomGUI")] + [SerializeField] + [Tooltip("This flag controls whether the default UI is shown for the room")] + public bool showRoomGUI = true; + + [FormerlySerializedAs("m_MinPlayers")] + [SerializeField] + [Tooltip("Minimum number of players to auto-start the game")] + public int minPlayers = 1; + + [FormerlySerializedAs("m_RoomPlayerPrefab")] + [SerializeField] + [Tooltip("Prefab to use for the Room Player")] + public NetworkRoomPlayer roomPlayerPrefab; + + /// + /// The scene to use for the room. This is similar to the offlineScene of the NetworkManager. + /// + [Scene] + public string RoomScene; + + /// + /// The scene to use for the playing the game from the room. This is similar to the onlineScene of the NetworkManager. + /// + [Scene] + public string GameplayScene; + + /// + /// List of players that are in the Room + /// + [FormerlySerializedAs("m_PendingPlayers")] + public List pendingPlayers = new List(); + + [Header("Diagnostics")] + /// + /// True when all players have submitted a Ready message + /// + [Tooltip("Diagnostic flag indicating all players are ready to play")] + [FormerlySerializedAs("allPlayersReady")] + [ReadOnly, SerializeField] bool _allPlayersReady; + + /// + /// These slots track players that enter the room. + /// The slotId on players is global to the game - across all players. + /// + [ReadOnly, Tooltip("List of Room Player objects")] + public List roomSlots = new List(); + + public bool allPlayersReady + { + get => _allPlayersReady; + set + { + bool wasReady = _allPlayersReady; + bool nowReady = value; + + if (wasReady != nowReady) + { + _allPlayersReady = value; + + if (nowReady) + { + OnRoomServerPlayersReady(); + } + else + { + OnRoomServerPlayersNotReady(); + } + } + } + } + + public override void OnValidate() + { + base.OnValidate(); + + // always <= maxConnections + minPlayers = Mathf.Min(minPlayers, maxConnections); + + // always >= 0 + minPlayers = Mathf.Max(minPlayers, 0); + + if (roomPlayerPrefab != null) + { + NetworkIdentity identity = roomPlayerPrefab.GetComponent(); + if (identity == null) + { + roomPlayerPrefab = null; + Debug.LogError("RoomPlayer prefab must have a NetworkIdentity component."); + } + } + } + + void SceneLoadedForPlayer(NetworkConnectionToClient conn, GameObject roomPlayer) + { + //Debug.Log($"NetworkRoom SceneLoadedForPlayer scene: {SceneManager.GetActiveScene().path} {conn}"); + + if (Utils.IsSceneActive(RoomScene)) + { + // cant be ready in room, add to ready list + PendingPlayer pending; + pending.conn = conn; + pending.roomPlayer = roomPlayer; + pendingPlayers.Add(pending); + return; + } + + GameObject gamePlayer = OnRoomServerCreateGamePlayer(conn, roomPlayer); + if (gamePlayer == null) + { + // get start position from base class + Transform startPos = GetStartPosition(); + gamePlayer = startPos != null + ? Instantiate(playerPrefab, startPos.position, startPos.rotation) + : Instantiate(playerPrefab, Vector3.zero, Quaternion.identity); + } + + if (!OnRoomServerSceneLoadedForPlayer(conn, roomPlayer, gamePlayer)) + return; + + // replace room player with game player + NetworkServer.ReplacePlayerForConnection(conn, gamePlayer, true); + } + + internal void CallOnClientEnterRoom() + { + OnRoomClientEnter(); + foreach (NetworkRoomPlayer player in roomSlots) + if (player != null) + { + player.OnClientEnterRoom(); + } + } + + internal void CallOnClientExitRoom() + { + OnRoomClientExit(); + foreach (NetworkRoomPlayer player in roomSlots) + if (player != null) + { + player.OnClientExitRoom(); + } + } + + /// + /// CheckReadyToBegin checks all of the players in the room to see if their readyToBegin flag is set. + /// If all of the players are ready, then the server switches from the RoomScene to the PlayScene, essentially starting the game. This is called automatically in response to NetworkRoomPlayer.CmdChangeReadyState. + /// + public void CheckReadyToBegin() + { + if (!Utils.IsSceneActive(RoomScene)) + return; + + int numberOfReadyPlayers = NetworkServer.connections.Count(conn => + conn.Value != null && + conn.Value.identity != null && + conn.Value.identity.TryGetComponent(out NetworkRoomPlayer nrp) && + nrp.readyToBegin); + + bool enoughReadyPlayers = minPlayers <= 0 || numberOfReadyPlayers >= minPlayers; + if (enoughReadyPlayers) + { + pendingPlayers.Clear(); + allPlayersReady = true; + } + else + allPlayersReady = false; + } + + #region server handlers + + /// + /// Called on the server when a new client connects. + /// Unity calls this on the Server when a Client connects to the Server. Use an override to tell the NetworkManager what to do when a client connects to the server. + /// + /// Connection from client. + public override void OnServerConnect(NetworkConnectionToClient conn) + { + // cannot join game in progress + if (!Utils.IsSceneActive(RoomScene)) + { + Debug.Log($"Not in Room scene...disconnecting {conn}"); + conn.Disconnect(); + return; + } + + base.OnServerConnect(conn); + OnRoomServerConnect(conn); + } + + /// + /// Called on the server when a client disconnects. + /// This is called on the Server when a Client disconnects from the Server. Use an override to decide what should happen when a disconnection is detected. + /// + /// Connection from client. + public override void OnServerDisconnect(NetworkConnectionToClient conn) + { + if (conn.identity != null) + { + NetworkRoomPlayer roomPlayer = conn.identity.GetComponent(); + + if (roomPlayer != null) + roomSlots.Remove(roomPlayer); + + foreach (NetworkIdentity clientOwnedObject in conn.owned) + { + roomPlayer = clientOwnedObject.GetComponent(); + if (roomPlayer != null) + roomSlots.Remove(roomPlayer); + } + } + + allPlayersReady = false; + + foreach (NetworkRoomPlayer player in roomSlots) + { + if (player != null) + player.GetComponent().readyToBegin = false; + } + + if (Utils.IsSceneActive(RoomScene)) + RecalculateRoomPlayerIndices(); + + OnRoomServerDisconnect(conn); + base.OnServerDisconnect(conn); + + if (Utils.IsHeadless()) + { + if (numPlayers < 1) + StopServer(); + } + } + + // Sequential index used in round-robin deployment of players into instances and score positioning + public int clientIndex; + + /// + /// Called on the server when a client is ready. + /// The default implementation of this function calls NetworkServer.SetClientReady() to continue the network setup process. + /// + /// Connection from client. + public override void OnServerReady(NetworkConnectionToClient conn) + { + //Debug.Log($"NetworkRoomManager OnServerReady {conn}"); + base.OnServerReady(conn); + + if (conn != null && conn.identity != null) + { + GameObject roomPlayer = conn.identity.gameObject; + + // if null or not a room player, don't replace it + if (roomPlayer != null && roomPlayer.GetComponent() != null) + SceneLoadedForPlayer(conn, roomPlayer); + } + } + + /// + /// Called on the server when a client adds a new player with NetworkClient.AddPlayer. + /// The default implementation for this function creates a new player object from the playerPrefab. + /// + /// Connection from client. + public override void OnServerAddPlayer(NetworkConnectionToClient conn) + { + // increment the index before adding the player, so first player starts at 1 + clientIndex++; + + if (Utils.IsSceneActive(RoomScene)) + { + allPlayersReady = false; + + //Debug.Log("NetworkRoomManager.OnServerAddPlayer playerPrefab: {roomPlayerPrefab.name}"); + + GameObject newRoomGameObject = OnRoomServerCreateRoomPlayer(conn); + if (newRoomGameObject == null) + newRoomGameObject = Instantiate(roomPlayerPrefab.gameObject, Vector3.zero, Quaternion.identity); + + NetworkServer.AddPlayerForConnection(conn, newRoomGameObject); + } + else + { + // Late joiners not supported...should've been kicked by OnServerDisconnect + Debug.Log($"Not in Room scene...disconnecting {conn}"); + conn.Disconnect(); + } + } + + [Server] + public void RecalculateRoomPlayerIndices() + { + if (roomSlots.Count > 0) + { + for (int i = 0; i < roomSlots.Count; i++) + { + roomSlots[i].index = i; + } + } + } + + /// + /// This causes the server to switch scenes and sets the networkSceneName. + /// Clients that connect to this server will automatically switch to this scene. This is called automatically if onlineScene or offlineScene are set, but it can be called from user code to switch scenes again while the game is in progress. This automatically sets clients to be not-ready. The clients must call NetworkClient.Ready() again to participate in the new scene. + /// + /// + public override void ServerChangeScene(string newSceneName) + { + if (newSceneName == RoomScene) + { + foreach (NetworkRoomPlayer roomPlayer in roomSlots) + { + if (roomPlayer == null) + continue; + + // find the game-player object for this connection, and destroy it + NetworkIdentity identity = roomPlayer.GetComponent(); + + if (NetworkServer.active) + { + // re-add the room object + roomPlayer.GetComponent().readyToBegin = false; + NetworkServer.ReplacePlayerForConnection(identity.connectionToClient, roomPlayer.gameObject); + } + } + + allPlayersReady = false; + } + + base.ServerChangeScene(newSceneName); + } + + /// + /// Called on the server when a scene is completed loaded, when the scene load was initiated by the server with ServerChangeScene(). + /// + /// The name of the new scene. + public override void OnServerSceneChanged(string sceneName) + { + if (sceneName != RoomScene) + { + // call SceneLoadedForPlayer on any players that become ready while we were loading the scene. + foreach (PendingPlayer pending in pendingPlayers) + SceneLoadedForPlayer(pending.conn, pending.roomPlayer); + + pendingPlayers.Clear(); + } + + OnRoomServerSceneChanged(sceneName); + } + + /// + /// This is invoked when a server is started - including when a host is started. + /// StartServer has multiple signatures, but they all cause this hook to be called. + /// + public override void OnStartServer() + { + if (string.IsNullOrWhiteSpace(RoomScene)) + { + Debug.LogError("NetworkRoomManager RoomScene is empty. Set the RoomScene in the inspector for the NetworkRoomManager"); + return; + } + + if (string.IsNullOrWhiteSpace(GameplayScene)) + { + Debug.LogError("NetworkRoomManager PlayScene is empty. Set the PlayScene in the inspector for the NetworkRoomManager"); + return; + } + + OnRoomStartServer(); + } + + /// + /// This is invoked when a host is started. + /// StartHost has multiple signatures, but they all cause this hook to be called. + /// + public override void OnStartHost() + { + OnRoomStartHost(); + } + + /// + /// This is called when a server is stopped - including when a host is stopped. + /// + public override void OnStopServer() + { + roomSlots.Clear(); + OnRoomStopServer(); + } + + /// + /// This is called when a host is stopped. + /// + public override void OnStopHost() + { + OnRoomStopHost(); + } + + #endregion + + #region client handlers + + /// + /// This is invoked when the client is started. + /// + public override void OnStartClient() + { + if (roomPlayerPrefab == null || roomPlayerPrefab.gameObject == null) + Debug.LogError("NetworkRoomManager no RoomPlayer prefab is registered. Please add a RoomPlayer prefab."); + else + NetworkClient.RegisterPrefab(roomPlayerPrefab.gameObject); + + if (playerPrefab == null) + Debug.LogError("NetworkRoomManager no GamePlayer prefab is registered. Please add a GamePlayer prefab."); + + OnRoomStartClient(); + } + + /// + /// Called on the client when connected to a server. + /// The default implementation of this function sets the client as ready and adds a player. Override the function to dictate what happens when the client connects. + /// + public override void OnClientConnect() + { + OnRoomClientConnect(); + base.OnClientConnect(); + } + + /// + /// Called on clients when disconnected from a server. + /// This is called on the client when it disconnects from the server. Override this function to decide what happens when the client disconnects. + /// + public override void OnClientDisconnect() + { + OnRoomClientDisconnect(); + base.OnClientDisconnect(); + } + + /// + /// This is called when a client is stopped. + /// + public override void OnStopClient() + { + OnRoomStopClient(); + CallOnClientExitRoom(); + roomSlots.Clear(); + } + + /// + /// Called on clients when a scene has completed loaded, when the scene load was initiated by the server. + /// Scene changes can cause player objects to be destroyed. The default implementation of OnClientSceneChanged in the NetworkManager is to add a player object for the connection if no player object exists. + /// + public override void OnClientSceneChanged() + { + if (Utils.IsSceneActive(RoomScene)) + { + if (NetworkClient.isConnected) + CallOnClientEnterRoom(); + } + else + CallOnClientExitRoom(); + + base.OnClientSceneChanged(); + OnRoomClientSceneChanged(); + } + + #endregion + + #region room server virtuals + + /// + /// This is called on the host when a host is started. + /// + public virtual void OnRoomStartHost() {} + + /// + /// This is called on the host when the host is stopped. + /// + public virtual void OnRoomStopHost() {} + + /// + /// This is called on the server when the server is started - including when a host is started. + /// + public virtual void OnRoomStartServer() {} + + /// + /// This is called on the server when the server is started - including when a host is stopped. + /// + public virtual void OnRoomStopServer() {} + + /// + /// This is called on the server when a new client connects to the server. + /// + /// The new connection. + public virtual void OnRoomServerConnect(NetworkConnectionToClient conn) {} + + /// + /// This is called on the server when a client disconnects. + /// + /// The connection that disconnected. + public virtual void OnRoomServerDisconnect(NetworkConnectionToClient conn) {} + + /// + /// This is called on the server when a networked scene finishes loading. + /// + /// Name of the new scene. + public virtual void OnRoomServerSceneChanged(string sceneName) {} + + /// + /// This allows customization of the creation of the room-player object on the server. + /// By default the roomPlayerPrefab is used to create the room-player, but this function allows that behaviour to be customized. + /// + /// The connection the player object is for. + /// The new room-player object. + public virtual GameObject OnRoomServerCreateRoomPlayer(NetworkConnectionToClient conn) + { + return null; + } + + /// + /// This allows customization of the creation of the GamePlayer object on the server. + /// By default the gamePlayerPrefab is used to create the game-player, but this function allows that behaviour to be customized. The object returned from the function will be used to replace the room-player on the connection. + /// + /// The connection the player object is for. + /// The room player object for this connection. + /// A new GamePlayer object. + public virtual GameObject OnRoomServerCreateGamePlayer(NetworkConnectionToClient conn, GameObject roomPlayer) + { + return null; + } + + /// + /// This allows customization of the creation of the GamePlayer object on the server. + /// This is only called for subsequent GamePlay scenes after the first one. + /// See OnRoomServerCreateGamePlayer(NetworkConnection, GameObject) to customize the player object for the initial GamePlay scene. + /// + /// The connection the player object is for. + public virtual void OnRoomServerAddPlayer(NetworkConnectionToClient conn) + { + base.OnServerAddPlayer(conn); + } + + // for users to apply settings from their room player object to their in-game player object + /// + /// This is called on the server when it is told that a client has finished switching from the room scene to a game player scene. + /// When switching from the room, the room-player is replaced with a game-player object. This callback function gives an opportunity to apply state from the room-player to the game-player object. + /// + /// The connection of the player + /// The room player object. + /// The game player object. + /// False to not allow this player to replace the room player. + public virtual bool OnRoomServerSceneLoadedForPlayer(NetworkConnectionToClient conn, GameObject roomPlayer, GameObject gamePlayer) + { + return true; + } + + /// + /// This is called on server from NetworkRoomPlayer.CmdChangeReadyState when client indicates change in Ready status. + /// + public virtual void ReadyStatusChanged() + { + int CurrentPlayers = 0; + int ReadyPlayers = 0; + + foreach (NetworkRoomPlayer item in roomSlots) + { + if (item != null) + { + CurrentPlayers++; + if (item.readyToBegin) + ReadyPlayers++; + } + } + + if (CurrentPlayers == ReadyPlayers) + CheckReadyToBegin(); + else + allPlayersReady = false; + } + + /// + /// This is called on the server when all the players in the room are ready. + /// The default implementation of this function uses ServerChangeScene() to switch to the game player scene. By implementing this callback you can customize what happens when all the players in the room are ready, such as adding a countdown or a confirmation for a group leader. + /// + public virtual void OnRoomServerPlayersReady() + { + // all players are readyToBegin, start the game + ServerChangeScene(GameplayScene); + } + + /// + /// This is called on the server when CheckReadyToBegin finds that players are not ready + /// May be called multiple times while not ready players are joining + /// + public virtual void OnRoomServerPlayersNotReady() {} + + #endregion + + #region room client virtuals + + /// + /// This is a hook to allow custom behaviour when the game client enters the room. + /// + public virtual void OnRoomClientEnter() {} + + /// + /// This is a hook to allow custom behaviour when the game client exits the room. + /// + public virtual void OnRoomClientExit() {} + + /// + /// This is called on the client when it connects to server. + /// + public virtual void OnRoomClientConnect() {} + + /// + /// This is called on the client when disconnected from a server. + /// + public virtual void OnRoomClientDisconnect() {} + + /// + /// This is called on the client when a client is started. + /// + public virtual void OnRoomStartClient() {} + + /// + /// This is called on the client when the client stops. + /// + public virtual void OnRoomStopClient() {} + + /// + /// This is called on the client when the client is finished loading a new networked scene. + /// + public virtual void OnRoomClientSceneChanged() {} + + #endregion + + #region optional UI + + /// + /// virtual so inheriting classes can roll their own + /// + public virtual void OnGUI() + { + if (!showRoomGUI) + return; + + if (NetworkServer.active && Utils.IsSceneActive(GameplayScene)) + { + GUILayout.BeginArea(new Rect(Screen.width - 150f, 10f, 140f, 30f)); + if (GUILayout.Button("Return to Room")) + ServerChangeScene(RoomScene); + GUILayout.EndArea(); + } + + if (Utils.IsSceneActive(RoomScene)) + GUI.Box(new Rect(10f, 180f, 520f, 150f), "PLAYERS"); + } + + #endregion + } +} diff --git a/Assets/Mirror/Components/NetworkRoomManager.cs.meta b/Assets/Mirror/Components/NetworkRoomManager.cs.meta new file mode 100644 index 0000000..76e7d42 --- /dev/null +++ b/Assets/Mirror/Components/NetworkRoomManager.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 615e6c6589cf9e54cad646b5a11e0529 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/NetworkRoomPlayer.cs b/Assets/Mirror/Components/NetworkRoomPlayer.cs new file mode 100644 index 0000000..6b7cda4 --- /dev/null +++ b/Assets/Mirror/Components/NetworkRoomPlayer.cs @@ -0,0 +1,195 @@ +using UnityEngine; + +namespace Mirror +{ + /// + /// This component works in conjunction with the NetworkRoomManager to make up the multiplayer room system. + /// The RoomPrefab object of the NetworkRoomManager must have this component on it. This component holds basic room player data required for the room to function. Game specific data for room players can be put in other components on the RoomPrefab or in scripts derived from NetworkRoomPlayer. + /// + [DisallowMultipleComponent] + [AddComponentMenu("Network/Network Room Player")] + [HelpURL("https://mirror-networking.gitbook.io/docs/components/network-room-player")] + public class NetworkRoomPlayer : NetworkBehaviour + { + /// + /// This flag controls whether the default UI is shown for the room player. + /// As this UI is rendered using the old GUI system, it is only recommended for testing purposes. + /// + [Tooltip("This flag controls whether the default UI is shown for the room player")] + public bool showRoomGUI = true; + + [Header("Diagnostics")] + + /// + /// Diagnostic flag indicating whether this player is ready for the game to begin. + /// Invoke CmdChangeReadyState method on the client to set this flag. + /// When all players are ready to begin, the game will start. This should not be set directly, CmdChangeReadyState should be called on the client to set it on the server. + /// + [ReadOnly, Tooltip("Diagnostic flag indicating whether this player is ready for the game to begin")] + [SyncVar(hook = nameof(ReadyStateChanged))] + public bool readyToBegin; + + /// + /// Diagnostic index of the player, e.g. Player1, Player2, etc. + /// + [ReadOnly, Tooltip("Diagnostic index of the player, e.g. Player1, Player2, etc.")] + [SyncVar(hook = nameof(IndexChanged))] + public int index; + + #region Unity Callbacks + + /// + /// Do not use Start - Override OnStartHost / OnStartClient instead! + /// + public virtual void Start() + { + if (NetworkManager.singleton is NetworkRoomManager room) + { + // NetworkRoomPlayer object must be set to DontDestroyOnLoad along with NetworkRoomManager + // in server and all clients, otherwise it will be respawned in the game scene which would + // have undesirable effects. + if (room.dontDestroyOnLoad) + DontDestroyOnLoad(gameObject); + + room.roomSlots.Add(this); + + if (NetworkServer.active) + room.RecalculateRoomPlayerIndices(); + + if (NetworkClient.active) + room.CallOnClientEnterRoom(); + } + else Debug.LogError("RoomPlayer could not find a NetworkRoomManager. The RoomPlayer requires a NetworkRoomManager object to function. Make sure that there is one in the scene."); + } + + public virtual void OnDisable() + { + if (NetworkClient.active && NetworkManager.singleton is NetworkRoomManager room) + { + // only need to call this on client as server removes it before object is destroyed + room.roomSlots.Remove(this); + + room.CallOnClientExitRoom(); + } + } + + #endregion + + #region Commands + + [Command] + public void CmdChangeReadyState(bool readyState) + { + readyToBegin = readyState; + NetworkRoomManager room = NetworkManager.singleton as NetworkRoomManager; + if (room != null) + { + room.ReadyStatusChanged(); + } + } + + #endregion + + #region SyncVar Hooks + + /// + /// This is a hook that is invoked on clients when the index changes. + /// + /// The old index value + /// The new index value + public virtual void IndexChanged(int oldIndex, int newIndex) {} + + /// + /// This is a hook that is invoked on clients when a RoomPlayer switches between ready or not ready. + /// This function is called when the a client player calls CmdChangeReadyState. + /// + /// New Ready State + public virtual void ReadyStateChanged(bool oldReadyState, bool newReadyState) {} + + #endregion + + #region Room Client Virtuals + + /// + /// This is a hook that is invoked on clients for all room player objects when entering the room. + /// Note: isLocalPlayer is not guaranteed to be set until OnStartLocalPlayer is called. + /// + public virtual void OnClientEnterRoom() {} + + /// + /// This is a hook that is invoked on clients for all room player objects when exiting the room. + /// + public virtual void OnClientExitRoom() {} + + #endregion + + #region Optional UI + + /// + /// Render a UI for the room. Override to provide your own UI + /// + public virtual void OnGUI() + { + if (!showRoomGUI) + return; + + NetworkRoomManager room = NetworkManager.singleton as NetworkRoomManager; + if (room) + { + if (!room.showRoomGUI) + return; + + if (!Utils.IsSceneActive(room.RoomScene)) + return; + + DrawPlayerReadyState(); + DrawPlayerReadyButton(); + } + } + + void DrawPlayerReadyState() + { + GUILayout.BeginArea(new Rect(20f + (index * 100), 200f, 90f, 130f)); + + GUILayout.Label($"Player [{index + 1}]"); + + if (readyToBegin) + GUILayout.Label("Ready"); + else + GUILayout.Label("Not Ready"); + + if (((isServer && index > 0) || isServerOnly) && GUILayout.Button("REMOVE")) + { + // This button only shows on the Host for all players other than the Host + // Host and Players can't remove themselves (stop the client instead) + // Host can kick a Player this way. + GetComponent().connectionToClient.Disconnect(); + } + + GUILayout.EndArea(); + } + + void DrawPlayerReadyButton() + { + if (NetworkClient.active && isLocalPlayer) + { + GUILayout.BeginArea(new Rect(20f, 300f, 120f, 20f)); + + if (readyToBegin) + { + if (GUILayout.Button("Cancel")) + CmdChangeReadyState(false); + } + else + { + if (GUILayout.Button("Ready")) + CmdChangeReadyState(true); + } + + GUILayout.EndArea(); + } + } + + #endregion + } +} diff --git a/Assets/Mirror/Components/NetworkRoomPlayer.cs.meta b/Assets/Mirror/Components/NetworkRoomPlayer.cs.meta new file mode 100644 index 0000000..0299bea --- /dev/null +++ b/Assets/Mirror/Components/NetworkRoomPlayer.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 79874ac94d5b1314788ecf0e86bd23fd +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/NetworkStatistics.cs b/Assets/Mirror/Components/NetworkStatistics.cs new file mode 100644 index 0000000..c00bb19 --- /dev/null +++ b/Assets/Mirror/Components/NetworkStatistics.cs @@ -0,0 +1,194 @@ +using System; +using UnityEngine; + +namespace Mirror +{ + /// + /// Shows Network messages and bytes sent and received per second. + /// + /// + /// Add this component to the same object as Network Manager. + /// + [AddComponentMenu("Network/Network Statistics")] + [DisallowMultipleComponent] + [HelpURL("https://mirror-networking.gitbook.io/docs/components/network-statistics")] + public class NetworkStatistics : MonoBehaviour + { + // update interval + double intervalStartTime; + + // --------------------------------------------------------------------- + + // CLIENT (public fields for other components to grab statistics) + // long bytes to support >2GB + [HideInInspector] public int clientIntervalReceivedPackets; + [HideInInspector] public long clientIntervalReceivedBytes; + [HideInInspector] public int clientIntervalSentPackets; + [HideInInspector] public long clientIntervalSentBytes; + + // results from last interval + // long bytes to support >2GB + [HideInInspector] public int clientReceivedPacketsPerSecond; + [HideInInspector] public long clientReceivedBytesPerSecond; + [HideInInspector] public int clientSentPacketsPerSecond; + [HideInInspector] public long clientSentBytesPerSecond; + + // --------------------------------------------------------------------- + + // SERVER (public fields for other components to grab statistics) + // capture interval + // long bytes to support >2GB + [HideInInspector] public int serverIntervalReceivedPackets; + [HideInInspector] public long serverIntervalReceivedBytes; + [HideInInspector] public int serverIntervalSentPackets; + [HideInInspector] public long serverIntervalSentBytes; + + // results from last interval + // long bytes to support >2GB + [HideInInspector] public int serverReceivedPacketsPerSecond; + [HideInInspector] public long serverReceivedBytesPerSecond; + [HideInInspector] public int serverSentPacketsPerSecond; + [HideInInspector] public long serverSentBytesPerSecond; + + // NetworkManager sets Transport.active in Awake(). + // so let's hook into it in Start(). + void Start() + { + // find available transport + Transport transport = Transport.active; + if (transport != null) + { + transport.OnClientDataReceived += OnClientReceive; + transport.OnClientDataSent += OnClientSend; + transport.OnServerDataReceived += OnServerReceive; + transport.OnServerDataSent += OnServerSend; + } + else Debug.LogError($"NetworkStatistics: no available or active Transport found on this platform: {Application.platform}"); + } + + void OnDestroy() + { + // remove transport hooks + Transport transport = Transport.active; + if (transport != null) + { + transport.OnClientDataReceived -= OnClientReceive; + transport.OnClientDataSent -= OnClientSend; + transport.OnServerDataReceived -= OnServerReceive; + transport.OnServerDataSent -= OnServerSend; + } + } + + void OnClientReceive(ArraySegment data, int channelId) + { + ++clientIntervalReceivedPackets; + clientIntervalReceivedBytes += data.Count; + } + + void OnClientSend(ArraySegment data, int channelId) + { + ++clientIntervalSentPackets; + clientIntervalSentBytes += data.Count; + } + + void OnServerReceive(int connectionId, ArraySegment data, int channelId) + { + ++serverIntervalReceivedPackets; + serverIntervalReceivedBytes += data.Count; + } + + void OnServerSend(int connectionId, ArraySegment data, int channelId) + { + ++serverIntervalSentPackets; + serverIntervalSentBytes += data.Count; + } + + void Update() + { + // calculate results every second + if (NetworkTime.localTime >= intervalStartTime + 1) + { + if (NetworkClient.active) UpdateClient(); + if (NetworkServer.active) UpdateServer(); + + intervalStartTime = NetworkTime.localTime; + } + } + + void UpdateClient() + { + clientReceivedPacketsPerSecond = clientIntervalReceivedPackets; + clientReceivedBytesPerSecond = clientIntervalReceivedBytes; + clientSentPacketsPerSecond = clientIntervalSentPackets; + clientSentBytesPerSecond = clientIntervalSentBytes; + + clientIntervalReceivedPackets = 0; + clientIntervalReceivedBytes = 0; + clientIntervalSentPackets = 0; + clientIntervalSentBytes = 0; + } + + void UpdateServer() + { + serverReceivedPacketsPerSecond = serverIntervalReceivedPackets; + serverReceivedBytesPerSecond = serverIntervalReceivedBytes; + serverSentPacketsPerSecond = serverIntervalSentPackets; + serverSentBytesPerSecond = serverIntervalSentBytes; + + serverIntervalReceivedPackets = 0; + serverIntervalReceivedBytes = 0; + serverIntervalSentPackets = 0; + serverIntervalSentBytes = 0; + } + + void OnGUI() + { + // only show if either server or client active + if (NetworkClient.active || NetworkServer.active) + { + // create main GUI area + // 120 is below NetworkManager HUD in all cases. + GUILayout.BeginArea(new Rect(10, 120, 215, 300)); + + // show client / server stats if active + if (NetworkClient.active) OnClientGUI(); + if (NetworkServer.active) OnServerGUI(); + + // end of GUI area + GUILayout.EndArea(); + } + } + + void OnClientGUI() + { + // background + GUILayout.BeginVertical("Box"); + GUILayout.Label("Client Statistics"); + + // sending ("msgs" instead of "packets" to fit larger numbers) + GUILayout.Label($"Send: {clientSentPacketsPerSecond} msgs @ {Utils.PrettyBytes(clientSentBytesPerSecond)}/s"); + + // receiving ("msgs" instead of "packets" to fit larger numbers) + GUILayout.Label($"Recv: {clientReceivedPacketsPerSecond} msgs @ {Utils.PrettyBytes(clientReceivedBytesPerSecond)}/s"); + + // end background + GUILayout.EndVertical(); + } + + void OnServerGUI() + { + // background + GUILayout.BeginVertical("Box"); + GUILayout.Label("Server Statistics"); + + // sending ("msgs" instead of "packets" to fit larger numbers) + GUILayout.Label($"Send: {serverSentPacketsPerSecond} msgs @ {Utils.PrettyBytes(serverSentBytesPerSecond)}/s"); + + // receiving ("msgs" instead of "packets" to fit larger numbers) + GUILayout.Label($"Recv: {serverReceivedPacketsPerSecond} msgs @ {Utils.PrettyBytes(serverReceivedBytesPerSecond)}/s"); + + // end background + GUILayout.EndVertical(); + } + } +} diff --git a/Assets/Mirror/Components/NetworkStatistics.cs.meta b/Assets/Mirror/Components/NetworkStatistics.cs.meta new file mode 100644 index 0000000..0bf4251 --- /dev/null +++ b/Assets/Mirror/Components/NetworkStatistics.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 6d7da4e566d24ea7b0e12178d934b648 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/NetworkTransform.meta b/Assets/Mirror/Components/NetworkTransform.meta new file mode 100644 index 0000000..1b6770d --- /dev/null +++ b/Assets/Mirror/Components/NetworkTransform.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: 36de72d9255741659bcbd1971ed29822 +timeCreated: 1668358590 \ No newline at end of file diff --git a/Assets/Mirror/Components/NetworkTransform/NetworkTransform.cs b/Assets/Mirror/Components/NetworkTransform/NetworkTransform.cs new file mode 100644 index 0000000..8a1a24a --- /dev/null +++ b/Assets/Mirror/Components/NetworkTransform/NetworkTransform.cs @@ -0,0 +1,8 @@ +using System; + +namespace Mirror +{ + // DEPRECATED 2023-06-15 + [Obsolete("NetworkTransform was renamed to NetworkTransformUnreliable.\nYou can easily swap the component's script by going into the Unity Inspector debug mode:\n1. Click the vertical dots on the top right in the Inspector tab.\n2. Find your NetworkTransform component\n3. Drag NetworkTransformUnreliable into the 'Script' field in the Inspector.\n4. Find the three dots and return to Normal mode.")] + public class NetworkTransform : NetworkTransformUnreliable {} +} diff --git a/Assets/Mirror/Components/NetworkTransform/NetworkTransform.cs.meta b/Assets/Mirror/Components/NetworkTransform/NetworkTransform.cs.meta new file mode 100644 index 0000000..a569990 --- /dev/null +++ b/Assets/Mirror/Components/NetworkTransform/NetworkTransform.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 2f74aedd71d9a4f55b3ce499326d45fb +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/NetworkTransform/NetworkTransformBase.cs b/Assets/Mirror/Components/NetworkTransform/NetworkTransformBase.cs new file mode 100644 index 0000000..e752c20 --- /dev/null +++ b/Assets/Mirror/Components/NetworkTransform/NetworkTransformBase.cs @@ -0,0 +1,489 @@ +// Snapshot Interpolation: https://gafferongames.com/post/snapshot_interpolation/ +// +// Base class for NetworkTransform and NetworkTransformChild. +// => simple unreliable sync without any interpolation for now. +// => which means we don't need teleport detection either +// +// NOTE: several functions are virtual in case someone needs to modify a part. +// +// Channel: uses UNRELIABLE at all times. +// -> out of order packets are dropped automatically +// -> it's better than RELIABLE for several reasons: +// * head of line blocking would add delay +// * resending is mostly pointless +// * bigger data race: +// -> if we use a Cmd() at position X over reliable +// -> client gets Cmd() and X at the same time, but buffers X for bufferTime +// -> for unreliable, it would get X before the reliable Cmd(), still +// buffer for bufferTime but end up closer to the original time +using System; +using System.Collections.Generic; +using UnityEngine; + +namespace Mirror +{ + public enum CoordinateSpace { Local, World } + + public abstract class NetworkTransformBase : NetworkBehaviour + { + // target transform to sync. can be on a child. + // TODO this field is kind of unnecessary since we now support child NetworkBehaviours + [Header("Target")] + [Tooltip("The Transform component to sync. May be on on this GameObject, or on a child.")] + public Transform target; + + // Is this a client with authority over this transform? + // This component could be on the player object or any object that has been assigned authority to this client. + protected bool IsClientWithAuthority => isClient && authority; + + // snapshots with initial capacity to avoid early resizing & allocations: see NetworkRigidbodyBenchmark example. + public readonly SortedList clientSnapshots = new SortedList(16); + public readonly SortedList serverSnapshots = new SortedList(16); + + // selective sync ////////////////////////////////////////////////////// + [Header("Selective Sync\nDon't change these at Runtime")] + public bool syncPosition = true; // do not change at runtime! + public bool syncRotation = true; // do not change at runtime! + public bool syncScale = false; // do not change at runtime! rare. off by default. + + [Header("Bandwidth Savings")] + [Tooltip("When true, changes are not sent unless greater than sensitivity values below.")] + public bool onlySyncOnChange = true; + [Tooltip("Apply smallest-three quaternion compression. This is lossy, you can disable it if the small rotation inaccuracies are noticeable in your project.")] + public bool compressRotation = true; + + // interpolation is on by default, but can be disabled to jump to + // the destination immediately. some projects need this. + [Header("Interpolation")] + [Tooltip("Set to false to have a snap-like effect on position movement.")] + public bool interpolatePosition = true; + [Tooltip("Set to false to have a snap-like effect on rotations.")] + public bool interpolateRotation = true; + [Tooltip("Set to false to remove scale smoothing. Example use-case: Instant flipping of sprites that use -X and +X for direction.")] + public bool interpolateScale = true; + + // CoordinateSpace /////////////////////////////////////////////////////////// + [Header("Coordinate Space")] + [Tooltip("Local by default. World may be better when changing hierarchy, or non-NetworkTransforms root position/rotation/scale values.")] + public CoordinateSpace coordinateSpace = CoordinateSpace.Local; + + [Header("Send Interval Multiplier")] + [Tooltip("Check/Sync every multiple of Network Manager send interval (= 1 / NM Send Rate), instead of every send interval.\n(30 NM send rate, and 3 interval, is a send every 0.1 seconds)\nA larger interval means less network sends, which has a variety of upsides. The drawbacks are delays and lower accuracy, you should find a nice balance between not sending too much, but the results looking good for your particular scenario.")] + [Range(1, 120)] + public uint sendIntervalMultiplier = 1; + + [Header("Timeline Offset")] + [Tooltip("Add a small timeline offset to account for decoupled arrival of NetworkTime and NetworkTransform snapshots.\nfixes: https://github.com/MirrorNetworking/Mirror/issues/3427")] + public bool timelineOffset = false; + + // Ninja's Notes on offset & mulitplier: + // + // In a no multiplier scenario: + // 1. Snapshots are sent every frame (frame being 1 NM send interval). + // 2. Time Interpolation is set to be 'behind' by 2 frames times. + // In theory where everything works, we probably have around 2 snapshots before we need to interpolate snapshots. From NT perspective, we should always have around 2 snapshots ready, so no stutter. + // + // In a multiplier scenario: + // 1. Snapshots are sent every 10 frames. + // 2. Time Interpolation remains 'behind by 2 frames'. + // When everything works, we are receiving NT snapshots every 10 frames, but start interpolating after 2. + // Even if I assume we had 2 snapshots to begin with to start interpolating (which we don't), by the time we reach 13th frame, we are out of snapshots, and have to wait 7 frames for next snapshot to come. This is the reason why we absolutely need the timestamp adjustment. We are starting way too early to interpolate. + // + protected double timeStampAdjustment => NetworkServer.sendInterval * (sendIntervalMultiplier - 1); + protected double offset => timelineOffset ? NetworkServer.sendInterval * sendIntervalMultiplier : 0; + + // debugging /////////////////////////////////////////////////////////// + [Header("Debug")] + public bool showGizmos; + public bool showOverlay; + public Color overlayColor = new Color(0, 0, 0, 0.5f); + + // initialization ////////////////////////////////////////////////////// + // make sure to call this when inheriting too! + protected virtual void Awake() { } + + protected override void OnValidate() + { + base.OnValidate(); + + // set target to self if none yet + if (target == null) target = transform; + + // time snapshot interpolation happens globally. + // value (transform) happens in here. + // both always need to be on the same send interval. + // force the setting to '0' in OnValidate to make it obvious that we + // actually use NetworkServer.sendInterval. + syncInterval = 0; + + // Unity doesn't support setting world scale. + // OnValidate force disables syncScale in world mode. + if (coordinateSpace == CoordinateSpace.World) syncScale = false; + } + + // snapshot functions ////////////////////////////////////////////////// + // get local/world position + protected virtual Vector3 GetPosition() => + coordinateSpace == CoordinateSpace.Local ? target.localPosition : target.position; + + // get local/world rotation + protected virtual Quaternion GetRotation() => + coordinateSpace == CoordinateSpace.Local ? target.localRotation : target.rotation; + + // get local/world scale + protected virtual Vector3 GetScale() => + coordinateSpace == CoordinateSpace.Local ? target.localScale : target.lossyScale; + + // set local/world position + protected virtual void SetPosition(Vector3 position) + { + if (coordinateSpace == CoordinateSpace.Local) + target.localPosition = position; + else + target.position = position; + } + + // set local/world rotation + protected virtual void SetRotation(Quaternion rotation) + { + if (coordinateSpace == CoordinateSpace.Local) + target.localRotation = rotation; + else + target.rotation = rotation; + } + + // set local/world position + protected virtual void SetScale(Vector3 scale) + { + if (coordinateSpace == CoordinateSpace.Local) + target.localScale = scale; + // Unity doesn't support setting world scale. + // OnValidate disables syncScale in world mode. + // else + // target.lossyScale = scale; // TODO + } + + // construct a snapshot of the current state + // => internal for testing + protected virtual TransformSnapshot Construct() + { + // NetworkTime.localTime for double precision until Unity has it too + return new TransformSnapshot( + // our local time is what the other end uses as remote time + NetworkTime.localTime, // Unity 2019 doesn't have timeAsDouble yet + 0, // the other end fills out local time itself + GetPosition(), + GetRotation(), + GetScale() + ); + } + + protected void AddSnapshot(SortedList snapshots, double timeStamp, Vector3? position, Quaternion? rotation, Vector3? scale) + { + // position, rotation, scale can have no value if same as last time. + // saves bandwidth. + // but we still need to feed it to snapshot interpolation. we can't + // just have gaps in there if nothing has changed. for example, if + // client sends snapshot at t=0 + // client sends nothing for 10s because not moved + // client sends snapshot at t=10 + // then the server would assume that it's one super slow move and + // replay it for 10 seconds. + + if (!position.HasValue) position = snapshots.Count > 0 ? snapshots.Values[snapshots.Count - 1].position : GetPosition(); + if (!rotation.HasValue) rotation = snapshots.Count > 0 ? snapshots.Values[snapshots.Count - 1].rotation : GetRotation(); + if (!scale.HasValue) scale = snapshots.Count > 0 ? snapshots.Values[snapshots.Count - 1].scale : GetScale(); + + // insert transform snapshot + SnapshotInterpolation.InsertIfNotExists( + snapshots, + NetworkClient.snapshotSettings.bufferLimit, + new TransformSnapshot( + timeStamp, // arrival remote timestamp. NOT remote time. + NetworkTime.localTime, // Unity 2019 doesn't have timeAsDouble yet + position.Value, + rotation.Value, + scale.Value + ) + ); + } + + // apply a snapshot to the Transform. + // -> start, end, interpolated are all passed in caes they are needed + // -> a regular game would apply the 'interpolated' snapshot + // -> a board game might want to jump to 'goal' directly + // (it's easier to always interpolate and then apply selectively, + // instead of manually interpolating x, y, z, ... depending on flags) + // => internal for testing + // + // NOTE: stuck detection is unnecessary here. + // we always set transform.position anyway, we can't get stuck. + protected virtual void Apply(TransformSnapshot interpolated, TransformSnapshot endGoal) + { + // local position/rotation for VR support + // + // if syncPosition/Rotation/Scale is disabled then we received nulls + // -> current position/rotation/scale would've been added as snapshot + // -> we still interpolated + // -> but simply don't apply it. if the user doesn't want to sync + // scale, then we should not touch scale etc. + + // interpolate parts + if (syncPosition) SetPosition(interpolatePosition ? interpolated.position : endGoal.position); + if (syncRotation) SetRotation(interpolateRotation ? interpolated.rotation : endGoal.rotation); + if (syncScale) SetScale(interpolateScale ? interpolated.scale : endGoal.scale); + } + + // client->server teleport to force position without interpolation. + // otherwise it would interpolate to a (far away) new position. + // => manually calling Teleport is the only 100% reliable solution. + [Command] + public void CmdTeleport(Vector3 destination) + { + // client can only teleport objects that it has authority over. + if (syncDirection != SyncDirection.ClientToServer) return; + + // TODO what about host mode? + OnTeleport(destination); + + // if a client teleports, we need to broadcast to everyone else too + // TODO the teleported client should ignore the rpc though. + // otherwise if it already moved again after teleporting, + // the rpc would come a little bit later and reset it once. + // TODO or not? if client ONLY calls Teleport(pos), the position + // would only be set after the rpc. unless the client calls + // BOTH Teleport(pos) and target.position=pos + RpcTeleport(destination); + } + + // client->server teleport to force position and rotation without interpolation. + // otherwise it would interpolate to a (far away) new position. + // => manually calling Teleport is the only 100% reliable solution. + [Command] + public void CmdTeleport(Vector3 destination, Quaternion rotation) + { + // client can only teleport objects that it has authority over. + if (syncDirection != SyncDirection.ClientToServer) return; + + // TODO what about host mode? + OnTeleport(destination, rotation); + + // if a client teleports, we need to broadcast to everyone else too + // TODO the teleported client should ignore the rpc though. + // otherwise if it already moved again after teleporting, + // the rpc would come a little bit later and reset it once. + // TODO or not? if client ONLY calls Teleport(pos), the position + // would only be set after the rpc. unless the client calls + // BOTH Teleport(pos) and target.position=pos + RpcTeleport(destination, rotation); + } + + // server->client teleport to force position without interpolation. + // otherwise it would interpolate to a (far away) new position. + // => manually calling Teleport is the only 100% reliable solution. + [ClientRpc] + public void RpcTeleport(Vector3 destination) + { + // NOTE: even in client authority mode, the server is always allowed + // to teleport the player. for example: + // * CmdEnterPortal() might teleport the player + // * Some people use client authority with server sided checks + // so the server should be able to reset position if needed. + + // TODO what about host mode? + OnTeleport(destination); + } + + // server->client teleport to force position and rotation without interpolation. + // otherwise it would interpolate to a (far away) new position. + // => manually calling Teleport is the only 100% reliable solution. + [ClientRpc] + public void RpcTeleport(Vector3 destination, Quaternion rotation) + { + // NOTE: even in client authority mode, the server is always allowed + // to teleport the player. for example: + // * CmdEnterPortal() might teleport the player + // * Some people use client authority with server sided checks + // so the server should be able to reset position if needed. + + // TODO what about host mode? + OnTeleport(destination, rotation); + } + + [ClientRpc] + void RpcResetState() + { + ResetState(); + } + + // common Teleport code for client->server and server->client + protected virtual void OnTeleport(Vector3 destination) + { + // set the new position. + // interpolation will automatically continue. + target.position = destination; + + // reset interpolation to immediately jump to the new position. + // do not call Reset() here, this would cause delta compression to + // get out of sync for NetworkTransformReliable because NTReliable's + // 'override Reset()' resets lastDe/SerializedPosition: + // https://github.com/MirrorNetworking/Mirror/issues/3588 + // because client's next OnSerialize() will delta compress, + // but server's last delta will have been reset, causing offsets. + // + // instead, simply clear snapshots. + serverSnapshots.Clear(); + clientSnapshots.Clear(); + + // TODO + // what if we still receive a snapshot from before the interpolation? + // it could easily happen over unreliable. + // -> maybe add destination as first entry? + } + + // common Teleport code for client->server and server->client + protected virtual void OnTeleport(Vector3 destination, Quaternion rotation) + { + // set the new position. + // interpolation will automatically continue. + target.position = destination; + target.rotation = rotation; + + // reset interpolation to immediately jump to the new position. + // do not call Reset() here, this would cause delta compression to + // get out of sync for NetworkTransformReliable because NTReliable's + // 'override Reset()' resets lastDe/SerializedPosition: + // https://github.com/MirrorNetworking/Mirror/issues/3588 + // because client's next OnSerialize() will delta compress, + // but server's last delta will have been reset, causing offsets. + // + // instead, simply clear snapshots. + serverSnapshots.Clear(); + clientSnapshots.Clear(); + + // TODO + // what if we still receive a snapshot from before the interpolation? + // it could easily happen over unreliable. + // -> maybe add destination as first entry? + } + + public virtual void ResetState() + { + // disabled objects aren't updated anymore. + // so let's clear the buffers. + serverSnapshots.Clear(); + clientSnapshots.Clear(); + } + + public virtual void Reset() + { + ResetState(); + // default to ClientToServer so this works immediately for users + syncDirection = SyncDirection.ClientToServer; + } + + protected virtual void OnEnable() + { + ResetState(); + + if (NetworkServer.active) + NetworkIdentity.clientAuthorityCallback += OnClientAuthorityChanged; + } + + protected virtual void OnDisable() + { + ResetState(); + + if (NetworkServer.active) + NetworkIdentity.clientAuthorityCallback -= OnClientAuthorityChanged; + } + + [ServerCallback] + void OnClientAuthorityChanged(NetworkConnectionToClient conn, NetworkIdentity identity, bool authorityState) + { + if (identity != netIdentity) return; + + // If server gets authority or syncdirection is server to client, + // we don't reset buffers. + // This is because if syncdirection is S to C, we will never have + // snapshot issues since there is only ever 1 source. + + if (syncDirection == SyncDirection.ClientToServer) + { + ResetState(); + RpcResetState(); + } + } + + // OnGUI allocates even if it does nothing. avoid in release. +#if UNITY_EDITOR || DEVELOPMENT_BUILD + // debug /////////////////////////////////////////////////////////////// + protected virtual void OnGUI() + { + if (!showOverlay) return; + if (!Camera.main) return; + + // show data next to player for easier debugging. this is very useful! + // IMPORTANT: this is basically an ESP hack for shooter games. + // DO NOT make this available with a hotkey in release builds + if (!Debug.isDebugBuild) return; + + // project position to screen + Vector3 point = Camera.main.WorldToScreenPoint(target.position); + + // enough alpha, in front of camera and in screen? + if (point.z >= 0 && Utils.IsPointInScreen(point)) + { + GUI.color = overlayColor; + GUILayout.BeginArea(new Rect(point.x, Screen.height - point.y, 200, 100)); + + // always show both client & server buffers so it's super + // obvious if we accidentally populate both. + GUILayout.Label($"Server Buffer:{serverSnapshots.Count}"); + GUILayout.Label($"Client Buffer:{clientSnapshots.Count}"); + + GUILayout.EndArea(); + GUI.color = Color.white; + } + } + + protected virtual void DrawGizmos(SortedList buffer) + { + // only draw if we have at least two entries + if (buffer.Count < 2) return; + + // calculate threshold for 'old enough' snapshots + double threshold = NetworkTime.localTime - NetworkClient.bufferTime; + Color oldEnoughColor = new Color(0, 1, 0, 0.5f); + Color notOldEnoughColor = new Color(0.5f, 0.5f, 0.5f, 0.3f); + + // draw the whole buffer for easier debugging. + // it's worth seeing how much we have buffered ahead already + for (int i = 0; i < buffer.Count; ++i) + { + // color depends on if old enough or not + TransformSnapshot entry = buffer.Values[i]; + bool oldEnough = entry.localTime <= threshold; + Gizmos.color = oldEnough ? oldEnoughColor : notOldEnoughColor; + Gizmos.DrawWireCube(entry.position, Vector3.one); + } + + // extra: lines between start<->position<->goal + Gizmos.color = Color.green; + Gizmos.DrawLine(buffer.Values[0].position, target.position); + Gizmos.color = Color.white; + Gizmos.DrawLine(target.position, buffer.Values[1].position); + } + + protected virtual void OnDrawGizmos() + { + // This fires in edit mode but that spams NRE's so check isPlaying + if (!Application.isPlaying) return; + if (!showGizmos) return; + + if (isServer) DrawGizmos(serverSnapshots); + if (isClient) DrawGizmos(clientSnapshots); + } +#endif + } +} diff --git a/Assets/Mirror/Components/NetworkTransform/NetworkTransformBase.cs.meta b/Assets/Mirror/Components/NetworkTransform/NetworkTransformBase.cs.meta new file mode 100644 index 0000000..ef58471 --- /dev/null +++ b/Assets/Mirror/Components/NetworkTransform/NetworkTransformBase.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 7c44135fde488424eaf28566206ce473 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/NetworkTransform/NetworkTransformChild.cs b/Assets/Mirror/Components/NetworkTransform/NetworkTransformChild.cs new file mode 100644 index 0000000..a844d9d --- /dev/null +++ b/Assets/Mirror/Components/NetworkTransform/NetworkTransformChild.cs @@ -0,0 +1,12 @@ +// A component to synchronize the position of child transforms of networked objects. +// There must be a NetworkTransform on the root object of the hierarchy. There can be multiple NetworkTransformChild components on an object. This does not use physics for synchronization, it simply synchronizes the localPosition and localRotation of the child transform and lerps towards the recieved values. +using System; +using UnityEngine; + +namespace Mirror +{ + // Deprecated 2022-10-25 + [AddComponentMenu("")] + [Obsolete("NetworkTransformChild is not needed anymore. The .target is now exposed in NetworkTransform itself. Note you can open the Inspector in debug view and replace the source script instead of reassigning everything.")] + public class NetworkTransformChild : NetworkTransform {} +} diff --git a/Assets/Mirror/Components/NetworkTransform/NetworkTransformChild.cs.meta b/Assets/Mirror/Components/NetworkTransform/NetworkTransformChild.cs.meta new file mode 100644 index 0000000..ae36756 --- /dev/null +++ b/Assets/Mirror/Components/NetworkTransform/NetworkTransformChild.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 734b48bea0b204338958ee3d885e11f0 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/NetworkTransform/NetworkTransformReliable.cs b/Assets/Mirror/Components/NetworkTransform/NetworkTransformReliable.cs new file mode 100644 index 0000000..f6e851b --- /dev/null +++ b/Assets/Mirror/Components/NetworkTransform/NetworkTransformReliable.cs @@ -0,0 +1,420 @@ +// NetworkTransform V3 (reliable) by mischa (2022-10) +using System.Collections.Generic; +using System.Runtime.CompilerServices; +using UnityEngine; + +namespace Mirror +{ + [AddComponentMenu("Network/Network Transform (Reliable)")] + public class NetworkTransformReliable : NetworkTransformBase + { + uint sendIntervalCounter = 0; + double lastSendIntervalTime = double.MinValue; + + [Tooltip("If we only sync on change, then we need to correct old snapshots if more time than sendInterval * multiplier has elapsed.\n\nOtherwise the first move will always start interpolating from the last move sequence's time, which will make it stutter when starting every time.")] + public float onlySyncOnChangeCorrectionMultiplier = 2; + + [Header("Rotation")] + [Tooltip("Sensitivity of changes needed before an updated state is sent over the network")] + public float rotationSensitivity = 0.01f; + + // delta compression is capable of detecting byte-level changes. + // if we scale float position to bytes, + // then small movements will only change one byte. + // this gives optimal bandwidth. + // benchmark with 0.01 precision: 130 KB/s => 60 KB/s + // benchmark with 0.1 precision: 130 KB/s => 30 KB/s + [Header("Precision")] + [Tooltip("Position is rounded in order to drastically minimize bandwidth.\n\nFor example, a precision of 0.01 rounds to a centimeter. In other words, sub-centimeter movements aren't synced until they eventually exceeded an actual centimeter.\n\nDepending on how important the object is, a precision of 0.01-0.10 (1-10 cm) is recommended.\n\nFor example, even a 1cm precision combined with delta compression cuts the Benchmark demo's bandwidth in half, compared to sending every tiny change.")] + [Range(0.00_01f, 1f)] // disallow 0 division. 1mm to 1m precision is enough range. + public float positionPrecision = 0.01f; // 1 cm + [Range(0.00_01f, 1f)] // disallow 0 division. 1mm to 1m precision is enough range. + public float scalePrecision = 0.01f; // 1 cm + + // delta compression needs to remember 'last' to compress against + protected Vector3Long lastSerializedPosition = Vector3Long.zero; + protected Vector3Long lastDeserializedPosition = Vector3Long.zero; + + protected Vector3Long lastSerializedScale = Vector3Long.zero; + protected Vector3Long lastDeserializedScale = Vector3Long.zero; + + // Used to store last sent snapshots + protected TransformSnapshot last; + + protected int lastClientCount = 1; + + // update ////////////////////////////////////////////////////////////// + void Update() + { + // if server then always sync to others. + if (isServer) UpdateServer(); + // 'else if' because host mode shouldn't send anything to server. + // it is the server. don't overwrite anything there. + else if (isClient) UpdateClient(); + } + + void LateUpdate() + { + // set dirty to trigger OnSerialize. either always, or only if changed. + // It has to be checked in LateUpdate() for onlySyncOnChange to avoid + // the possibility of Update() running first before the object's movement + // script's Update(), which then causes NT to send every alternate frame + // instead. + if (isServer || (IsClientWithAuthority && NetworkClient.ready)) + { + if (sendIntervalCounter == sendIntervalMultiplier && (!onlySyncOnChange || Changed(Construct()))) + SetDirty(); + + CheckLastSendTime(); + } + } + + protected virtual void UpdateServer() + { + // apply buffered snapshots IF client authority + // -> in server authority, server moves the object + // so no need to apply any snapshots there. + // -> don't apply for host mode player objects either, even if in + // client authority mode. if it doesn't go over the network, + // then we don't need to do anything. + // -> connectionToClient is briefly null after scene changes: + // https://github.com/MirrorNetworking/Mirror/issues/3329 + if (syncDirection == SyncDirection.ClientToServer && + connectionToClient != null && + !isOwned) + { + if (serverSnapshots.Count > 0) + { + // step the transform interpolation without touching time. + // NetworkClient is responsible for time globally. + SnapshotInterpolation.StepInterpolation( + serverSnapshots, + connectionToClient.remoteTimeline, + out TransformSnapshot from, + out TransformSnapshot to, + out double t); + + // interpolate & apply + TransformSnapshot computed = TransformSnapshot.Interpolate(from, to, t); + Apply(computed, to); + } + } + } + + protected virtual void UpdateClient() + { + // client authority, and local player (= allowed to move myself)? + if (!IsClientWithAuthority) + { + // only while we have snapshots + if (clientSnapshots.Count > 0) + { + // step the interpolation without touching time. + // NetworkClient is responsible for time globally. + SnapshotInterpolation.StepInterpolation( + clientSnapshots, + NetworkTime.time, // == NetworkClient.localTimeline from snapshot interpolation + out TransformSnapshot from, + out TransformSnapshot to, + out double t); + + // interpolate & apply + TransformSnapshot computed = TransformSnapshot.Interpolate(from, to, t); + Apply(computed, to); + } + + lastClientCount = clientSnapshots.Count; + } + } + + protected virtual void CheckLastSendTime() + { + // timeAsDouble not available in older Unity versions. + if (AccurateInterval.Elapsed(NetworkTime.localTime, NetworkServer.sendInterval, ref lastSendIntervalTime)) + { + if (sendIntervalCounter == sendIntervalMultiplier) + sendIntervalCounter = 0; + sendIntervalCounter++; + } + } + + // check if position / rotation / scale changed since last sync + protected virtual bool Changed(TransformSnapshot current) => + // position is quantized and delta compressed. + // only consider it changed if the quantized representation is changed. + // careful: don't use 'serialized / deserialized last'. as it depends on sync mode etc. + QuantizedChanged(last.position, current.position, positionPrecision) || + // rotation isn't quantized / delta compressed. + // check with sensitivity. + Quaternion.Angle(last.rotation, current.rotation) > rotationSensitivity || + // scale is quantized and delta compressed. + // only consider it changed if the quantized representation is changed. + // careful: don't use 'serialized / deserialized last'. as it depends on sync mode etc. + QuantizedChanged(last.scale, current.scale, scalePrecision); + + // helper function to compare quantized representations of a Vector3 + [MethodImpl(MethodImplOptions.AggressiveInlining)] + protected bool QuantizedChanged(Vector3 u, Vector3 v, float precision) + { + Compression.ScaleToLong(u, precision, out Vector3Long uQuantized); + Compression.ScaleToLong(v, precision, out Vector3Long vQuantized); + return uQuantized != vQuantized; + } + + // NT may be used on client/server/host to Owner/Observers with + // ServerToClient or ClientToServer. + // however, OnSerialize should always delta against last. + public override void OnSerialize(NetworkWriter writer, bool initialState) + { + // get current snapshot for broadcasting. + TransformSnapshot snapshot = Construct(); + + // ClientToServer optimization: + // for interpolated client owned identities, + // always broadcast the latest known snapshot so other clients can + // interpolate immediately instead of catching up too + + // TODO dirty mask? [compression is very good w/o it already] + // each vector's component is delta compressed. + // an unchanged component would still require 1 byte. + // let's use a dirty bit mask to filter those out as well. + + // initial + if (initialState) + { + // If there is a last serialized snapshot, we use it. + // This prevents the new client getting a snapshot that is different + // from what the older clients last got. If this happens, and on the next + // regular serialisation the delta compression will get wrong values. + // Notes: + // 1. Interestingly only the older clients have it wrong, because at the end + // of this function, last = snapshot which is the initial state's snapshot + // 2. Regular NTR gets by this bug because it sends every frame anyway so initialstate + // snapshot constructed would have been the same as the last anyway. + if (last.remoteTime > 0) snapshot = last; + if (syncPosition) writer.WriteVector3(snapshot.position); + if (syncRotation) + { + // (optional) smallest three compression for now. no delta. + if (compressRotation) + writer.WriteUInt(Compression.CompressQuaternion(snapshot.rotation)); + else + writer.WriteQuaternion(snapshot.rotation); + } + if (syncScale) writer.WriteVector3(snapshot.scale); + } + // delta + else + { + // int before = writer.Position; + + if (syncPosition) + { + // quantize -> delta -> varint + Compression.ScaleToLong(snapshot.position, positionPrecision, out Vector3Long quantized); + DeltaCompression.Compress(writer, lastSerializedPosition, quantized); + } + if (syncRotation) + { + // (optional) smallest three compression for now. no delta. + if (compressRotation) + writer.WriteUInt(Compression.CompressQuaternion(snapshot.rotation)); + else + writer.WriteQuaternion(snapshot.rotation); + } + if (syncScale) + { + // quantize -> delta -> varint + Compression.ScaleToLong(snapshot.scale, scalePrecision, out Vector3Long quantized); + DeltaCompression.Compress(writer, lastSerializedScale, quantized); + } + } + + // save serialized as 'last' for next delta compression + if (syncPosition) Compression.ScaleToLong(snapshot.position, positionPrecision, out lastSerializedPosition); + if (syncScale) Compression.ScaleToLong(snapshot.scale, scalePrecision, out lastSerializedScale); + + // set 'last' + last = snapshot; + } + + public override void OnDeserialize(NetworkReader reader, bool initialState) + { + Vector3? position = null; + Quaternion? rotation = null; + Vector3? scale = null; + + // initial + if (initialState) + { + if (syncPosition) position = reader.ReadVector3(); + if (syncRotation) + { + // (optional) smallest three compression for now. no delta. + if (compressRotation) + rotation = Compression.DecompressQuaternion(reader.ReadUInt()); + else + rotation = reader.ReadQuaternion(); + } + if (syncScale) scale = reader.ReadVector3(); + } + // delta + else + { + // varint -> delta -> quantize + if (syncPosition) + { + Vector3Long quantized = DeltaCompression.Decompress(reader, lastDeserializedPosition); + position = Compression.ScaleToFloat(quantized, positionPrecision); + } + if (syncRotation) + { + // (optional) smallest three compression for now. no delta. + if (compressRotation) + rotation = Compression.DecompressQuaternion(reader.ReadUInt()); + else + rotation = reader.ReadQuaternion(); + } + if (syncScale) + { + Vector3Long quantized = DeltaCompression.Decompress(reader, lastDeserializedScale); + scale = Compression.ScaleToFloat(quantized, scalePrecision); + } + } + + // handle depending on server / client / host. + // server has priority for host mode. + if (isServer) OnClientToServerSync(position, rotation, scale); + else if (isClient) OnServerToClientSync(position, rotation, scale); + + // save deserialized as 'last' for next delta compression + if (syncPosition) Compression.ScaleToLong(position.Value, positionPrecision, out lastDeserializedPosition); + if (syncScale) Compression.ScaleToLong(scale.Value, scalePrecision, out lastDeserializedScale); + } + + // sync //////////////////////////////////////////////////////////////// + + // local authority client sends sync message to server for broadcasting + protected virtual void OnClientToServerSync(Vector3? position, Quaternion? rotation, Vector3? scale) + { + // only apply if in client authority mode + if (syncDirection != SyncDirection.ClientToServer) return; + + // protect against ever growing buffer size attacks + if (serverSnapshots.Count >= connectionToClient.snapshotBufferSizeLimit) return; + + // 'only sync on change' needs a correction on every new move sequence. + if (onlySyncOnChange && + NeedsCorrection(serverSnapshots, connectionToClient.remoteTimeStamp, NetworkServer.sendInterval * sendIntervalMultiplier, onlySyncOnChangeCorrectionMultiplier)) + { + RewriteHistory( + serverSnapshots, + connectionToClient.remoteTimeStamp, + NetworkTime.localTime, // arrival remote timestamp. NOT remote timeline. + NetworkServer.sendInterval * sendIntervalMultiplier, // Unity 2019 doesn't have timeAsDouble yet + GetPosition(), + GetRotation(), + GetScale()); + } + + // add a small timeline offset to account for decoupled arrival of + // NetworkTime and NetworkTransform snapshots. + // needs to be sendInterval. half sendInterval doesn't solve it. + // https://github.com/MirrorNetworking/Mirror/issues/3427 + // remove this after LocalWorldState. + AddSnapshot(serverSnapshots, connectionToClient.remoteTimeStamp + timeStampAdjustment + offset, position, rotation, scale); + } + + // server broadcasts sync message to all clients + protected virtual void OnServerToClientSync(Vector3? position, Quaternion? rotation, Vector3? scale) + { + // don't apply for local player with authority + if (IsClientWithAuthority) return; + + // 'only sync on change' needs a correction on every new move sequence. + if (onlySyncOnChange && + NeedsCorrection(clientSnapshots, NetworkClient.connection.remoteTimeStamp, NetworkClient.sendInterval * sendIntervalMultiplier, onlySyncOnChangeCorrectionMultiplier)) + { + RewriteHistory( + clientSnapshots, + NetworkClient.connection.remoteTimeStamp, // arrival remote timestamp. NOT remote timeline. + NetworkTime.localTime, // Unity 2019 doesn't have timeAsDouble yet + NetworkClient.sendInterval * sendIntervalMultiplier, + GetPosition(), + GetRotation(), + GetScale()); + } + + // add a small timeline offset to account for decoupled arrival of + // NetworkTime and NetworkTransform snapshots. + // needs to be sendInterval. half sendInterval doesn't solve it. + // https://github.com/MirrorNetworking/Mirror/issues/3427 + // remove this after LocalWorldState. + AddSnapshot(clientSnapshots, NetworkClient.connection.remoteTimeStamp + timeStampAdjustment + offset, position, rotation, scale); + } + + // only sync on change ///////////////////////////////////////////////// + // snap interp. needs a continous flow of packets. + // 'only sync on change' interrupts it while not changed. + // once it restarts, snap interp. will interp from the last old position. + // this will cause very noticeable stutter for the first move each time. + // the fix is quite simple. + + // 1. detect if the remaining snapshot is too old from a past move. + static bool NeedsCorrection( + SortedList snapshots, + double remoteTimestamp, + double bufferTime, + double toleranceMultiplier) => + snapshots.Count == 1 && + remoteTimestamp - snapshots.Keys[0] >= bufferTime * toleranceMultiplier; + + // 2. insert a fake snapshot at current position, + // exactly one 'sendInterval' behind the newly received one. + static void RewriteHistory( + SortedList snapshots, + // timestamp of packet arrival, not interpolated remote time! + double remoteTimeStamp, + double localTime, + double sendInterval, + Vector3 position, + Quaternion rotation, + Vector3 scale) + { + // clear the previous snapshot + snapshots.Clear(); + + // insert a fake one at where we used to be, + // 'sendInterval' behind the new one. + SnapshotInterpolation.InsertIfNotExists( + snapshots, + NetworkClient.snapshotSettings.bufferLimit, + new TransformSnapshot( + remoteTimeStamp - sendInterval, // arrival remote timestamp. NOT remote time. + localTime - sendInterval, // Unity 2019 doesn't have timeAsDouble yet + position, + rotation, + scale + ) + ); + } + + // reset state for next session. + // do not ever call this during a session (i.e. after teleport). + // calling this will break delta compression. + public override void ResetState() + { + base.ResetState(); + + // reset delta + lastSerializedPosition = Vector3Long.zero; + lastDeserializedPosition = Vector3Long.zero; + + lastSerializedScale = Vector3Long.zero; + lastDeserializedScale = Vector3Long.zero; + + // reset 'last' for delta too + last = new TransformSnapshot(0, 0, Vector3.zero, Quaternion.identity, Vector3.zero); + } + } +} diff --git a/Assets/Mirror/Components/NetworkTransform/NetworkTransformReliable.cs.meta b/Assets/Mirror/Components/NetworkTransform/NetworkTransformReliable.cs.meta new file mode 100644 index 0000000..ece9c7d --- /dev/null +++ b/Assets/Mirror/Components/NetworkTransform/NetworkTransformReliable.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 8ff3ba0becae47b8b9381191598957c8 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/NetworkTransform/NetworkTransformUnreliable.cs b/Assets/Mirror/Components/NetworkTransform/NetworkTransformUnreliable.cs new file mode 100644 index 0000000..ec5d3e1 --- /dev/null +++ b/Assets/Mirror/Components/NetworkTransform/NetworkTransformUnreliable.cs @@ -0,0 +1,678 @@ +// NetworkTransform V2 by mischa (2021-07) +using System.Collections.Generic; +using UnityEngine; + +namespace Mirror +{ + [AddComponentMenu("Network/Network Transform (Unreliable)")] + public class NetworkTransformUnreliable : NetworkTransformBase + { + uint sendIntervalCounter = 0; + double lastSendIntervalTime = double.MinValue; + + // Testing under really bad network conditions, 2%-5% packet loss and 250-1200ms ping, 5 proved to eliminate any twitching, however this should not be the default as it is a rare case Developers may want to cover. + [Tooltip("How much time, as a multiple of send interval, has passed before clearing buffers.\nA larger buffer means more delay, but results in smoother movement.\nExample: 1 for faster responses minimal smoothing, 5 covers bad pings but has noticable delay, 3 is recommended for balanced results,.")] + public float bufferResetMultiplier = 3; + [Tooltip("Detect and send only changed data, such as Position X and Z, not the full Vector3 of X Y Z. Lowers network data at cost of extra calculations.")] + public bool changedDetection = true; + + [Header("Sensitivity"), Tooltip("Sensitivity of changes needed before an updated state is sent over the network")] + public float positionSensitivity = 0.01f; + public float rotationSensitivity = 0.01f; + public float scaleSensitivity = 0.01f; + + protected bool positionChanged; + protected bool rotationChanged; + protected bool scaleChanged; + + // Used to store last sent snapshots + protected TransformSnapshot lastSnapshot; + protected bool cachedSnapshotComparison; + protected Changed cachedChangedComparison; + protected bool hasSentUnchangedPosition; + + // update ////////////////////////////////////////////////////////////// + // Update applies interpolation + void Update() + { + if (isServer) UpdateServerInterpolation(); + // for all other clients (and for local player if !authority), + // we need to apply snapshots from the buffer. + // 'else if' because host mode shouldn't interpolate client + else if (isClient && !IsClientWithAuthority) UpdateClientInterpolation(); + } + + // LateUpdate broadcasts. + // movement scripts may change positions in Update. + // use LateUpdate to ensure changes are detected in the same frame. + // otherwise this may run before user update, delaying detection until next frame. + // this could cause visible jitter. + void LateUpdate() + { + // if server then always sync to others. + if (isServer) UpdateServerBroadcast(); + // client authority, and local player (= allowed to move myself)? + // 'else if' because host mode shouldn't send anything to server. + // it is the server. don't overwrite anything there. + else if (isClient && IsClientWithAuthority) UpdateClientBroadcast(); + } + + protected virtual void CheckLastSendTime() + { + // We check interval every frame, and then send if interval is reached. + // So by the time sendIntervalCounter == sendIntervalMultiplier, data is sent, + // thus we reset the counter here. + // This fixes previous issue of, if sendIntervalMultiplier = 1, we send every frame, + // because intervalCounter is always = 1 in the previous version. + + // Changing == to >= https://github.com/MirrorNetworking/Mirror/issues/3571 + + if (sendIntervalCounter >= sendIntervalMultiplier) + sendIntervalCounter = 0; + + // timeAsDouble not available in older Unity versions. + if (AccurateInterval.Elapsed(NetworkTime.localTime, NetworkServer.sendInterval, ref lastSendIntervalTime)) + sendIntervalCounter++; + } + + void UpdateServerBroadcast() + { + // broadcast to all clients each 'sendInterval' + // (client with authority will drop the rpc) + // NetworkTime.localTime for double precision until Unity has it too + // + // IMPORTANT: + // snapshot interpolation requires constant sending. + // DO NOT only send if position changed. for example: + // --- + // * client sends first position at t=0 + // * ... 10s later ... + // * client moves again, sends second position at t=10 + // --- + // * server gets first position at t=0 + // * server gets second position at t=10 + // * server moves from first to second within a time of 10s + // => would be a super slow move, instead of a wait & move. + // + // IMPORTANT: + // DO NOT send nulls if not changed 'since last send' either. we + // send unreliable and don't know which 'last send' the other end + // received successfully. + // + // Checks to ensure server only sends snapshots if object is + // on server authority(!clientAuthority) mode because on client + // authority mode snapshots are broadcasted right after the authoritative + // client updates server in the command function(see above), OR, + // since host does not send anything to update the server, any client + // authoritative movement done by the host will have to be broadcasted + // here by checking IsClientWithAuthority. + // TODO send same time that NetworkServer sends time snapshot? + CheckLastSendTime(); + + if (sendIntervalCounter == sendIntervalMultiplier && // same interval as time interpolation! + (syncDirection == SyncDirection.ServerToClient || IsClientWithAuthority)) + { + // send snapshot without timestamp. + // receiver gets it from batch timestamp to save bandwidth. + TransformSnapshot snapshot = Construct(); + + if (changedDetection) + { + cachedChangedComparison = CompareChangedSnapshots(snapshot); + + if ((cachedChangedComparison == Changed.None || cachedChangedComparison == Changed.CompressRot) && hasSentUnchangedPosition && onlySyncOnChange) { return; } + + SyncData syncData = new SyncData(cachedChangedComparison, snapshot); + + RpcServerToClientSync(syncData); + + if (cachedChangedComparison == Changed.None || cachedChangedComparison == Changed.CompressRot) + { + hasSentUnchangedPosition = true; + } + else + { + hasSentUnchangedPosition = false; + UpdateLastSentSnapshot(cachedChangedComparison, snapshot); + } + } + else + { + cachedSnapshotComparison = CompareSnapshots(snapshot); + if (cachedSnapshotComparison && hasSentUnchangedPosition && onlySyncOnChange) { return; } + + if (compressRotation) + { + RpcServerToClientSyncCompressRotation( + // only sync what the user wants to sync + syncPosition && positionChanged ? snapshot.position : default(Vector3?), + syncRotation && rotationChanged ? Compression.CompressQuaternion(snapshot.rotation) : default(uint?), + syncScale && scaleChanged ? snapshot.scale : default(Vector3?) + ); + } + else + { + RpcServerToClientSync( + // only sync what the user wants to sync + syncPosition && positionChanged ? snapshot.position : default(Vector3?), + syncRotation && rotationChanged ? snapshot.rotation : default(Quaternion?), + syncScale && scaleChanged ? snapshot.scale : default(Vector3?) + ); + } + + if (cachedSnapshotComparison) + { + hasSentUnchangedPosition = true; + } + else + { + hasSentUnchangedPosition = false; + + // Fixes https://github.com/MirrorNetworking/Mirror/issues/3572 + // This also fixes https://github.com/MirrorNetworking/Mirror/issues/3573 + // with the exception of Quaternion.Angle sensitivity has to be > 0.16. + // Unity issue, we are leaving it as is. + + if (positionChanged) lastSnapshot.position = snapshot.position; + if (rotationChanged) lastSnapshot.rotation = snapshot.rotation; + if (positionChanged) lastSnapshot.scale = snapshot.scale; + } + } + } + } + + void UpdateServerInterpolation() + { + // apply buffered snapshots IF client authority + // -> in server authority, server moves the object + // so no need to apply any snapshots there. + // -> don't apply for host mode player objects either, even if in + // client authority mode. if it doesn't go over the network, + // then we don't need to do anything. + // -> connectionToClient is briefly null after scene changes: + // https://github.com/MirrorNetworking/Mirror/issues/3329 + if (syncDirection == SyncDirection.ClientToServer && + connectionToClient != null && + !isOwned) + { + if (serverSnapshots.Count == 0) return; + + // step the transform interpolation without touching time. + // NetworkClient is responsible for time globally. + SnapshotInterpolation.StepInterpolation( + serverSnapshots, + connectionToClient.remoteTimeline, + out TransformSnapshot from, + out TransformSnapshot to, + out double t); + + // interpolate & apply + TransformSnapshot computed = TransformSnapshot.Interpolate(from, to, t); + Apply(computed, to); + } + } + + void UpdateClientBroadcast() + { + // https://github.com/vis2k/Mirror/pull/2992/ + if (!NetworkClient.ready) return; + + // send to server each 'sendInterval' + // NetworkTime.localTime for double precision until Unity has it too + // + // IMPORTANT: + // snapshot interpolation requires constant sending. + // DO NOT only send if position changed. for example: + // --- + // * client sends first position at t=0 + // * ... 10s later ... + // * client moves again, sends second position at t=10 + // --- + // * server gets first position at t=0 + // * server gets second position at t=10 + // * server moves from first to second within a time of 10s + // => would be a super slow move, instead of a wait & move. + // + // IMPORTANT: + // DO NOT send nulls if not changed 'since last send' either. we + // send unreliable and don't know which 'last send' the other end + // received successfully. + CheckLastSendTime(); + if (sendIntervalCounter == sendIntervalMultiplier) // same interval as time interpolation! + { + // send snapshot without timestamp. + // receiver gets it from batch timestamp to save bandwidth. + TransformSnapshot snapshot = Construct(); + + if (changedDetection) + { + cachedChangedComparison = CompareChangedSnapshots(snapshot); + + if ((cachedChangedComparison == Changed.None || cachedChangedComparison == Changed.CompressRot) && hasSentUnchangedPosition && onlySyncOnChange) { return; } + + SyncData syncData = new SyncData(cachedChangedComparison, snapshot); + + CmdClientToServerSync(syncData); + + if (cachedChangedComparison == Changed.None || cachedChangedComparison == Changed.CompressRot) + { + hasSentUnchangedPosition = true; + } + else + { + hasSentUnchangedPosition = false; + UpdateLastSentSnapshot(cachedChangedComparison, snapshot); + } + } + else + { + cachedSnapshotComparison = CompareSnapshots(snapshot); + if (cachedSnapshotComparison && hasSentUnchangedPosition && onlySyncOnChange) { return; } + + if (compressRotation) + { + CmdClientToServerSyncCompressRotation( + // only sync what the user wants to sync + syncPosition && positionChanged ? snapshot.position : default(Vector3?), + syncRotation && rotationChanged ? Compression.CompressQuaternion(snapshot.rotation) : default(uint?), + syncScale && scaleChanged ? snapshot.scale : default(Vector3?) + ); + } + else + { + CmdClientToServerSync( + // only sync what the user wants to sync + syncPosition && positionChanged ? snapshot.position : default(Vector3?), + syncRotation && rotationChanged ? snapshot.rotation : default(Quaternion?), + syncScale && scaleChanged ? snapshot.scale : default(Vector3?) + ); + } + + if (cachedSnapshotComparison) + { + hasSentUnchangedPosition = true; + } + else + { + hasSentUnchangedPosition = false; + + // Fixes https://github.com/MirrorNetworking/Mirror/issues/3572 + // This also fixes https://github.com/MirrorNetworking/Mirror/issues/3573 + // with the exception of Quaternion.Angle sensitivity has to be > 0.16. + // Unity issue, we are leaving it as is. + if (positionChanged) lastSnapshot.position = snapshot.position; + if (rotationChanged) lastSnapshot.rotation = snapshot.rotation; + if (positionChanged) lastSnapshot.scale = snapshot.scale; + } + } + } + } + + void UpdateClientInterpolation() + { + // only while we have snapshots + if (clientSnapshots.Count == 0) return; + + // step the interpolation without touching time. + // NetworkClient is responsible for time globally. + SnapshotInterpolation.StepInterpolation( + clientSnapshots, + NetworkTime.time, // == NetworkClient.localTimeline from snapshot interpolation + out TransformSnapshot from, + out TransformSnapshot to, + out double t); + + // interpolate & apply + TransformSnapshot computed = TransformSnapshot.Interpolate(from, to, t); + Apply(computed, to); + } + + public override void OnSerialize(NetworkWriter writer, bool initialState) + { + // sync target component's position on spawn. + // fixes https://github.com/vis2k/Mirror/pull/3051/ + // (Spawn message wouldn't sync NTChild positions either) + if (initialState) + { + if (syncPosition) writer.WriteVector3(GetPosition()); + if (syncRotation) writer.WriteQuaternion(GetRotation()); + if (syncScale) writer.WriteVector3(GetScale()); + } + } + + public override void OnDeserialize(NetworkReader reader, bool initialState) + { + // sync target component's position on spawn. + // fixes https://github.com/vis2k/Mirror/pull/3051/ + // (Spawn message wouldn't sync NTChild positions either) + if (initialState) + { + if (syncPosition) SetPosition(reader.ReadVector3()); + if (syncRotation) SetRotation(reader.ReadQuaternion()); + if (syncScale) SetScale(reader.ReadVector3()); + } + } + + // Returns true if position, rotation AND scale are unchanged, within given sensitivity range. + protected virtual bool CompareSnapshots(TransformSnapshot currentSnapshot) + { + positionChanged = Vector3.SqrMagnitude(lastSnapshot.position - currentSnapshot.position) > positionSensitivity * positionSensitivity; + rotationChanged = Quaternion.Angle(lastSnapshot.rotation, currentSnapshot.rotation) > rotationSensitivity; + scaleChanged = Vector3.SqrMagnitude(lastSnapshot.scale - currentSnapshot.scale) > scaleSensitivity * scaleSensitivity; + + return (!positionChanged && !rotationChanged && !scaleChanged); + } + + // cmd ///////////////////////////////////////////////////////////////// + // only unreliable. see comment above of this file. + [Command(channel = Channels.Unreliable)] + void CmdClientToServerSync(Vector3? position, Quaternion? rotation, Vector3? scale) + { + OnClientToServerSync(position, rotation, scale); + //For client authority, immediately pass on the client snapshot to all other + //clients instead of waiting for server to send its snapshots. + if (syncDirection == SyncDirection.ClientToServer) + RpcServerToClientSync(position, rotation, scale); + } + + // cmd ///////////////////////////////////////////////////////////////// + // only unreliable. see comment above of this file. + [Command(channel = Channels.Unreliable)] + void CmdClientToServerSyncCompressRotation(Vector3? position, uint? rotation, Vector3? scale) + { + // A fix to not apply current interpolated GetRotation when receiving null/unchanged value, instead use last sent snapshot rotation. + Quaternion newRotation; + if (rotation.HasValue) + { + newRotation = Compression.DecompressQuaternion((uint)rotation); + } + else + { + newRotation = serverSnapshots.Count > 0 ? serverSnapshots.Values[serverSnapshots.Count - 1].rotation : GetRotation(); + } + OnClientToServerSync(position, newRotation, scale); + //For client authority, immediately pass on the client snapshot to all other + //clients instead of waiting for server to send its snapshots. + if (syncDirection == SyncDirection.ClientToServer) + RpcServerToClientSyncCompressRotation(position, rotation, scale); + } + + // local authority client sends sync message to server for broadcasting + protected virtual void OnClientToServerSync(Vector3? position, Quaternion? rotation, Vector3? scale) + { + // only apply if in client authority mode + if (syncDirection != SyncDirection.ClientToServer) return; + + // protect against ever growing buffer size attacks + if (serverSnapshots.Count >= connectionToClient.snapshotBufferSizeLimit) return; + + // only player owned objects (with a connection) can send to + // server. we can get the timestamp from the connection. + double timestamp = connectionToClient.remoteTimeStamp; + + if (onlySyncOnChange) + { + double timeIntervalCheck = bufferResetMultiplier * sendIntervalMultiplier * NetworkClient.sendInterval; + + if (serverSnapshots.Count > 0 && serverSnapshots.Values[serverSnapshots.Count - 1].remoteTime + timeIntervalCheck < timestamp) + ResetState(); + } + + AddSnapshot(serverSnapshots, connectionToClient.remoteTimeStamp + timeStampAdjustment + offset, position, rotation, scale); + } + + // rpc ///////////////////////////////////////////////////////////////// + // only unreliable. see comment above of this file. + [ClientRpc(channel = Channels.Unreliable)] + void RpcServerToClientSync(Vector3? position, Quaternion? rotation, Vector3? scale) => + OnServerToClientSync(position, rotation, scale); + + // rpc ///////////////////////////////////////////////////////////////// + // only unreliable. see comment above of this file. + [ClientRpc(channel = Channels.Unreliable)] + void RpcServerToClientSyncCompressRotation(Vector3? position, uint? rotation, Vector3? scale) + { + // A fix to not apply current interpolated GetRotation when receiving null/unchanged value, instead use last sent snapshot rotation. + Quaternion newRotation; + if (rotation.HasValue) + { + newRotation = Compression.DecompressQuaternion((uint)rotation); + } + else + { + newRotation = clientSnapshots.Count > 0 ? clientSnapshots.Values[clientSnapshots.Count - 1].rotation : GetRotation(); + } + OnServerToClientSync(position, newRotation, scale); + } + + // server broadcasts sync message to all clients + protected virtual void OnServerToClientSync(Vector3? position, Quaternion? rotation, Vector3? scale) + { + // in host mode, the server sends rpcs to all clients. + // the host client itself will receive them too. + // -> host server is always the source of truth + // -> we can ignore any rpc on the host client + // => otherwise host objects would have ever growing clientBuffers + // (rpc goes to clients. if isServer is true too then we are host) + if (isServer) return; + + // don't apply for local player with authority + if (IsClientWithAuthority) return; + + // on the client, we receive rpcs for all entities. + // not all of them have a connectionToServer. + // but all of them go through NetworkClient.connection. + // we can get the timestamp from there. + double timestamp = NetworkClient.connection.remoteTimeStamp; + + if (onlySyncOnChange) + { + double timeIntervalCheck = bufferResetMultiplier * sendIntervalMultiplier * NetworkServer.sendInterval; + + if (clientSnapshots.Count > 0 && clientSnapshots.Values[clientSnapshots.Count - 1].remoteTime + timeIntervalCheck < timestamp) + ResetState(); + } + + AddSnapshot(clientSnapshots, NetworkClient.connection.remoteTimeStamp + timeStampAdjustment + offset, position, rotation, scale); + } + + protected virtual void UpdateLastSentSnapshot(Changed change, TransformSnapshot currentSnapshot) + { + if (change == Changed.None || change == Changed.CompressRot) return; + + if ((change & Changed.PosX) > 0) lastSnapshot.position.x = currentSnapshot.position.x; + if ((change & Changed.PosY) > 0) lastSnapshot.position.y = currentSnapshot.position.y; + if ((change & Changed.PosZ) > 0) lastSnapshot.position.z = currentSnapshot.position.z; + + if (compressRotation) + { + if ((change & Changed.Rot) > 0) lastSnapshot.rotation = currentSnapshot.rotation; + } + else + { + Vector3 newRotation; + newRotation.x = (change & Changed.RotX) > 0 ? currentSnapshot.rotation.eulerAngles.x : lastSnapshot.rotation.eulerAngles.x; + newRotation.y = (change & Changed.RotY) > 0 ? currentSnapshot.rotation.eulerAngles.y : lastSnapshot.rotation.eulerAngles.y; + newRotation.z = (change & Changed.RotZ) > 0 ? currentSnapshot.rotation.eulerAngles.z : lastSnapshot.rotation.eulerAngles.z; + + lastSnapshot.rotation = Quaternion.Euler(newRotation); + } + + if ((change & Changed.Scale) > 0) lastSnapshot.scale = currentSnapshot.scale; + } + + // Returns true if position, rotation AND scale are unchanged, within given sensitivity range. + // Note the sensitivity comparison are different for pos, rot and scale. + protected virtual Changed CompareChangedSnapshots(TransformSnapshot currentSnapshot) + { + Changed change = Changed.None; + + if (syncPosition) + { + bool positionChanged = Vector3.SqrMagnitude(lastSnapshot.position - currentSnapshot.position) > positionSensitivity * positionSensitivity; + if (positionChanged) + { + if (Mathf.Abs(lastSnapshot.position.x - currentSnapshot.position.x) > positionSensitivity) change |= Changed.PosX; + if (Mathf.Abs(lastSnapshot.position.y - currentSnapshot.position.y) > positionSensitivity) change |= Changed.PosY; + if (Mathf.Abs(lastSnapshot.position.z - currentSnapshot.position.z) > positionSensitivity) change |= Changed.PosZ; + } + } + + if (syncRotation) + { + if (compressRotation) + { + bool rotationChanged = Quaternion.Angle(lastSnapshot.rotation, currentSnapshot.rotation) > rotationSensitivity; + if (rotationChanged) + { + // Here we set all Rot enum flags, to tell us if there was a change in rotation + // when using compression. If no change, we don't write the compressed Quat. + change |= Changed.CompressRot; + change |= Changed.Rot; + } + else + { + change |= Changed.CompressRot; + } + } + else + { + if (Mathf.Abs(lastSnapshot.rotation.eulerAngles.x - currentSnapshot.rotation.eulerAngles.x) > rotationSensitivity) change |= Changed.RotX; + if (Mathf.Abs(lastSnapshot.rotation.eulerAngles.y - currentSnapshot.rotation.eulerAngles.y) > rotationSensitivity) change |= Changed.RotY; + if (Mathf.Abs(lastSnapshot.rotation.eulerAngles.z - currentSnapshot.rotation.eulerAngles.z) > rotationSensitivity) change |= Changed.RotZ; + } + } + + if (syncScale) + { + if (Vector3.SqrMagnitude(lastSnapshot.scale - currentSnapshot.scale) > scaleSensitivity * scaleSensitivity) change |= Changed.Scale; + } + + return change; + } + + [Command(channel = Channels.Unreliable)] + void CmdClientToServerSync(SyncData syncData) + { + OnClientToServerSync(syncData); + //For client authority, immediately pass on the client snapshot to all other + //clients instead of waiting for server to send its snapshots. + if (syncDirection == SyncDirection.ClientToServer) + RpcServerToClientSync(syncData); + } + + protected virtual void OnClientToServerSync(SyncData syncData) + { + // only apply if in client authority mode + if (syncDirection != SyncDirection.ClientToServer) return; + + // protect against ever growing buffer size attacks + if (serverSnapshots.Count >= connectionToClient.snapshotBufferSizeLimit) return; + + // only player owned objects (with a connection) can send to + // server. we can get the timestamp from the connection. + double timestamp = connectionToClient.remoteTimeStamp; + + if (onlySyncOnChange) + { + double timeIntervalCheck = bufferResetMultiplier * sendIntervalMultiplier * NetworkClient.sendInterval; + + if (serverSnapshots.Count > 0 && serverSnapshots.Values[serverSnapshots.Count - 1].remoteTime + timeIntervalCheck < timestamp) + ResetState(); + } + + UpdateSyncData(ref syncData, serverSnapshots); + + AddSnapshot(serverSnapshots, connectionToClient.remoteTimeStamp + timeStampAdjustment + offset, syncData.position, syncData.quatRotation, syncData.scale); + } + + + [ClientRpc(channel = Channels.Unreliable)] + void RpcServerToClientSync(SyncData syncData) => + OnServerToClientSync(syncData); + + protected virtual void OnServerToClientSync(SyncData syncData) + { + // in host mode, the server sends rpcs to all clients. + // the host client itself will receive them too. + // -> host server is always the source of truth + // -> we can ignore any rpc on the host client + // => otherwise host objects would have ever growing clientBuffers + // (rpc goes to clients. if isServer is true too then we are host) + if (isServer) return; + + // don't apply for local player with authority + if (IsClientWithAuthority) return; + + // on the client, we receive rpcs for all entities. + // not all of them have a connectionToServer. + // but all of them go through NetworkClient.connection. + // we can get the timestamp from there. + double timestamp = NetworkClient.connection.remoteTimeStamp; + + if (onlySyncOnChange) + { + double timeIntervalCheck = bufferResetMultiplier * sendIntervalMultiplier * NetworkServer.sendInterval; + + if (clientSnapshots.Count > 0 && clientSnapshots.Values[clientSnapshots.Count - 1].remoteTime + timeIntervalCheck < timestamp) + ResetState(); + } + + UpdateSyncData(ref syncData, clientSnapshots); + + AddSnapshot(clientSnapshots, NetworkClient.connection.remoteTimeStamp + timeStampAdjustment + offset, syncData.position, syncData.quatRotation, syncData.scale); + } + + protected virtual void UpdateSyncData(ref SyncData syncData, SortedList snapshots) + { + if (syncData.changedDataByte == Changed.None || syncData.changedDataByte == Changed.CompressRot) + { + syncData.position = snapshots.Count > 0 ? snapshots.Values[snapshots.Count - 1].position : GetPosition(); + syncData.quatRotation = snapshots.Count > 0 ? snapshots.Values[snapshots.Count - 1].rotation : GetRotation(); + syncData.scale = snapshots.Count > 0 ? snapshots.Values[snapshots.Count - 1].scale : GetScale(); + } + else + { + // Just going to update these without checking if syncposition or not, + // because if not syncing position, NT will not apply any position data + // to the target during Apply(). + + syncData.position.x = (syncData.changedDataByte & Changed.PosX) > 0 ? syncData.position.x : (snapshots.Count > 0 ? snapshots.Values[snapshots.Count - 1].position.x : GetPosition().x); + syncData.position.y = (syncData.changedDataByte & Changed.PosY) > 0 ? syncData.position.y : (snapshots.Count > 0 ? snapshots.Values[snapshots.Count - 1].position.y : GetPosition().y); + syncData.position.z = (syncData.changedDataByte & Changed.PosZ) > 0 ? syncData.position.z : (snapshots.Count > 0 ? snapshots.Values[snapshots.Count - 1].position.z : GetPosition().z); + + // If compressRot is true, we already have the Quat in syncdata. + if ((syncData.changedDataByte & Changed.CompressRot) == 0) + { + syncData.vecRotation.x = (syncData.changedDataByte & Changed.RotX) > 0 ? syncData.vecRotation.x : (snapshots.Count > 0 ? snapshots.Values[snapshots.Count - 1].rotation.eulerAngles.x : GetRotation().eulerAngles.x); + syncData.vecRotation.y = (syncData.changedDataByte & Changed.RotY) > 0 ? syncData.vecRotation.y : (snapshots.Count > 0 ? snapshots.Values[snapshots.Count - 1].rotation.eulerAngles.y : GetRotation().eulerAngles.y); ; + syncData.vecRotation.z = (syncData.changedDataByte & Changed.RotZ) > 0 ? syncData.vecRotation.z : (snapshots.Count > 0 ? snapshots.Values[snapshots.Count - 1].rotation.eulerAngles.z : GetRotation().eulerAngles.z); + + syncData.quatRotation = Quaternion.Euler(syncData.vecRotation); + } + else + { + syncData.quatRotation = (syncData.changedDataByte & Changed.Rot) > 0 ? syncData.quatRotation : (snapshots.Count > 0 ? snapshots.Values[snapshots.Count - 1].rotation : GetRotation()); + } + + syncData.scale = (syncData.changedDataByte & Changed.Scale) > 0 ? syncData.scale : (snapshots.Count > 0 ? snapshots.Values[snapshots.Count - 1].scale : GetScale()); + } + } + + // This is to extract position/rotation/scale data from payload. Override + // Construct and Deconstruct if you are implementing a different SyncData logic. + // Note however that snapshot interpolation still requires the basic 3 data + // position, rotation and scale, which are computed from here. + protected virtual void DeconstructSyncData(System.ArraySegment receivedPayload, out byte? changedFlagData, out Vector3? position, out Quaternion? rotation, out Vector3? scale) + { + using (NetworkReaderPooled reader = NetworkReaderPool.Get(receivedPayload)) + { + SyncData syncData = reader.Read(); + changedFlagData = (byte)syncData.changedDataByte; + position = syncData.position; + rotation = syncData.quatRotation; + scale = syncData.scale; + } + } + } +} diff --git a/Assets/Mirror/Components/NetworkTransform/NetworkTransformUnreliable.cs.meta b/Assets/Mirror/Components/NetworkTransform/NetworkTransformUnreliable.cs.meta new file mode 100644 index 0000000..3a4a75a --- /dev/null +++ b/Assets/Mirror/Components/NetworkTransform/NetworkTransformUnreliable.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: a553cb17010b2403e8523b558bffbc14 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/NetworkTransform/TransformSnapshot.cs b/Assets/Mirror/Components/NetworkTransform/TransformSnapshot.cs new file mode 100644 index 0000000..01b863c --- /dev/null +++ b/Assets/Mirror/Components/NetworkTransform/TransformSnapshot.cs @@ -0,0 +1,68 @@ +// snapshot for snapshot interpolation +// https://gafferongames.com/post/snapshot_interpolation/ +// position, rotation, scale for compatibility for now. +using UnityEngine; + +namespace Mirror +{ + // NetworkTransform Snapshot + public struct TransformSnapshot : Snapshot + { + // time or sequence are needed to throw away older snapshots. + // + // glenn fiedler starts with a 16 bit sequence number. + // supposedly this is meant as a simplified example. + // in the end we need the remote timestamp for accurate interpolation + // and buffering over time. + // + // note: in theory, IF server sends exactly(!) at the same interval then + // the 16 bit ushort timestamp would be enough to calculate the + // remote time (sequence * sendInterval). but Unity's update is + // not guaranteed to run on the exact intervals / do catchup. + // => remote timestamp is better for now + // + // [REMOTE TIME, NOT LOCAL TIME] + // => DOUBLE for long term accuracy & batching gives us double anyway + public double remoteTime { get; set; } + + // the local timestamp (when we received it) + // used to know if the first two snapshots are old enough to start. + public double localTime { get; set; } + + public Vector3 position; + public Quaternion rotation; + public Vector3 scale; + + public TransformSnapshot(double remoteTime, double localTime, Vector3 position, Quaternion rotation, Vector3 scale) + { + this.remoteTime = remoteTime; + this.localTime = localTime; + this.position = position; + this.rotation = rotation; + this.scale = scale; + } + + public static TransformSnapshot Interpolate(TransformSnapshot from, TransformSnapshot to, double t) + { + // NOTE: + // Vector3 & Quaternion components are float anyway, so we can + // keep using the functions with 't' as float instead of double. + return new TransformSnapshot( + // interpolated snapshot is applied directly. don't need timestamps. + 0, 0, + // lerp position/rotation/scale unclamped in case we ever need + // to extrapolate. atm SnapshotInterpolation never does. + Vector3.LerpUnclamped(from.position, to.position, (float)t), + // IMPORTANT: LerpUnclamped(0, 60, 1.5) extrapolates to ~86. + // SlerpUnclamped(0, 60, 1.5) extrapolates to 90! + // (0, 90, 1.5) is even worse. for Lerp. + // => Slerp works way better for our euler angles. + Quaternion.SlerpUnclamped(from.rotation, to.rotation, (float)t), + Vector3.LerpUnclamped(from.scale, to.scale, (float)t) + ); + } + + public override string ToString() => + $"TransformSnapshot(remoteTime={remoteTime:F2}, localTime={localTime:F2}, pos={position}, rot={rotation}, scale={scale})"; + } +} diff --git a/Assets/Mirror/Components/NetworkTransform/TransformSnapshot.cs.meta b/Assets/Mirror/Components/NetworkTransform/TransformSnapshot.cs.meta new file mode 100644 index 0000000..f43458f --- /dev/null +++ b/Assets/Mirror/Components/NetworkTransform/TransformSnapshot.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: d3dae77b43dc4e1dbb2012924b2da79c +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/NetworkTransform/TransformSyncData.cs b/Assets/Mirror/Components/NetworkTransform/TransformSyncData.cs new file mode 100644 index 0000000..9b6d51c --- /dev/null +++ b/Assets/Mirror/Components/NetworkTransform/TransformSyncData.cs @@ -0,0 +1,156 @@ +using UnityEngine; +using System; +using Mirror; + +namespace Mirror +{ + [Serializable] + public struct SyncData + { + public Changed changedDataByte; + public Vector3 position; + public Quaternion quatRotation; + public Vector3 vecRotation; + public Vector3 scale; + + public SyncData(Changed _dataChangedByte, Vector3 _position, Quaternion _rotation, Vector3 _scale) + { + this.changedDataByte = _dataChangedByte; + this.position = _position; + this.quatRotation = _rotation; + this.vecRotation = quatRotation.eulerAngles; + this.scale = _scale; + } + + public SyncData(Changed _dataChangedByte, TransformSnapshot _snapshot) + { + this.changedDataByte = _dataChangedByte; + this.position = _snapshot.position; + this.quatRotation = _snapshot.rotation; + this.vecRotation = quatRotation.eulerAngles; + this.scale = _snapshot.scale; + } + + public SyncData(Changed _dataChangedByte, Vector3 _position, Vector3 _vecRotation, Vector3 _scale) + { + this.changedDataByte = _dataChangedByte; + this.position = _position; + this.vecRotation = _vecRotation; + this.quatRotation = Quaternion.Euler(vecRotation); + this.scale = _scale; + } + } + + [Flags] + public enum Changed : byte + { + None = 0, + PosX = 1 << 0, + PosY = 1 << 1, + PosZ = 1 << 2, + CompressRot = 1 << 3, + RotX = 1 << 4, + RotY = 1 << 5, + RotZ = 1 << 6, + Scale = 1 << 7, + + Pos = PosX | PosY | PosZ, + Rot = RotX | RotY | RotZ + } + + + public static class SyncDataReaderWriter + { + public static void WriteSyncData(this NetworkWriter writer, SyncData syncData) + { + writer.WriteByte((byte)syncData.changedDataByte); + + // Write position + if ((syncData.changedDataByte & Changed.PosX) > 0) + { + writer.WriteFloat(syncData.position.x); + } + + if ((syncData.changedDataByte & Changed.PosY) > 0) + { + writer.WriteFloat(syncData.position.y); + } + + if ((syncData.changedDataByte & Changed.PosZ) > 0) + { + writer.WriteFloat(syncData.position.z); + } + + // Write rotation + if ((syncData.changedDataByte & Changed.CompressRot) > 0) + { + if((syncData.changedDataByte & Changed.Rot) > 0) + { + writer.WriteUInt(Compression.CompressQuaternion(syncData.quatRotation)); + } + } + else + { + if ((syncData.changedDataByte & Changed.RotX) > 0) + { + writer.WriteFloat(syncData.quatRotation.eulerAngles.x); + } + + if ((syncData.changedDataByte & Changed.RotY) > 0) + { + writer.WriteFloat(syncData.quatRotation.eulerAngles.y); + } + + if ((syncData.changedDataByte & Changed.RotZ) > 0) + { + writer.WriteFloat(syncData.quatRotation.eulerAngles.z); + } + } + + // Write scale + if ((syncData.changedDataByte & Changed.Scale) > 0) + { + writer.WriteVector3(syncData.scale); + } + } + + public static SyncData ReadSyncData(this NetworkReader reader) + { + Changed changedData = (Changed)reader.ReadByte(); + + // If we have nothing to read here, let's say because posX is unchanged, then we can write anything + // for now, but in the NT, we will need to check changedData again, to put the right values of the axis + // back. We don't have it here. + + Vector3 position = + new Vector3( + (changedData & Changed.PosX) > 0 ? reader.ReadFloat() : 0, + (changedData & Changed.PosY) > 0 ? reader.ReadFloat() : 0, + (changedData & Changed.PosZ) > 0 ? reader.ReadFloat() : 0 + ); + + Vector3 vecRotation = new Vector3(); + Quaternion quatRotation = new Quaternion(); + + if ((changedData & Changed.CompressRot) > 0) + { + quatRotation = (changedData & Changed.RotX) > 0 ? Compression.DecompressQuaternion(reader.ReadUInt()) : new Quaternion(); + } + else + { + vecRotation = + new Vector3( + (changedData & Changed.RotX) > 0 ? reader.ReadFloat() : 0, + (changedData & Changed.RotY) > 0 ? reader.ReadFloat() : 0, + (changedData & Changed.RotZ) > 0 ? reader.ReadFloat() : 0 + ); + } + + Vector3 scale = (changedData & Changed.Scale) == Changed.Scale ? reader.ReadVector3() : new Vector3(); + + SyncData _syncData = (changedData & Changed.CompressRot) > 0 ? new SyncData(changedData, position, quatRotation, scale) : new SyncData(changedData, position, vecRotation, scale); + + return _syncData; + } + } +} diff --git a/Assets/Mirror/Components/NetworkTransform/TransformSyncData.cs.meta b/Assets/Mirror/Components/NetworkTransform/TransformSyncData.cs.meta new file mode 100644 index 0000000..15bb004 --- /dev/null +++ b/Assets/Mirror/Components/NetworkTransform/TransformSyncData.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: a1c0832ca88e749ff96fe04cebb617ef +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/PredictedRigidbody.meta b/Assets/Mirror/Components/PredictedRigidbody.meta new file mode 100644 index 0000000..3bd5cec --- /dev/null +++ b/Assets/Mirror/Components/PredictedRigidbody.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: 09cc6745984c453a8cfb4cf4244d2570 +timeCreated: 1693576410 \ No newline at end of file diff --git a/Assets/Mirror/Components/PredictedRigidbody/LocalGhostMaterial.mat b/Assets/Mirror/Components/PredictedRigidbody/LocalGhostMaterial.mat new file mode 100644 index 0000000..ff29a73 --- /dev/null +++ b/Assets/Mirror/Components/PredictedRigidbody/LocalGhostMaterial.mat @@ -0,0 +1,85 @@ +%YAML 1.1 +%TAG !u! tag:unity3d.com,2011: +--- !u!21 &2100000 +Material: + serializedVersion: 8 + m_ObjectHideFlags: 0 + m_CorrespondingSourceObject: {fileID: 0} + m_PrefabInstance: {fileID: 0} + m_PrefabAsset: {fileID: 0} + m_Name: LocalGhostMaterial + m_Shader: {fileID: 46, guid: 0000000000000000f000000000000000, type: 0} + m_Parent: {fileID: 0} + m_ModifiedSerializedProperties: 0 + m_ValidKeywords: + - _ALPHAPREMULTIPLY_ON + m_InvalidKeywords: [] + m_LightmapFlags: 4 + m_EnableInstancingVariants: 0 + m_DoubleSidedGI: 0 + m_CustomRenderQueue: 3000 + stringTagMap: + RenderType: Transparent + disabledShaderPasses: [] + m_LockedProperties: + m_SavedProperties: + serializedVersion: 3 + m_TexEnvs: + - _BumpMap: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - _DetailAlbedoMap: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - _DetailMask: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - _DetailNormalMap: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - _EmissionMap: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - _MainTex: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - _MetallicGlossMap: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - _OcclusionMap: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - _ParallaxMap: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + m_Ints: [] + m_Floats: + - _BumpScale: 1 + - _Cutoff: 0.5 + - _DetailNormalMapScale: 1 + - _DstBlend: 10 + - _GlossMapScale: 1 + - _Glossiness: 0.92 + - _GlossyReflections: 1 + - _Metallic: 0 + - _Mode: 3 + - _OcclusionStrength: 1 + - _Parallax: 0.02 + - _SmoothnessTextureChannel: 0 + - _SpecularHighlights: 1 + - _SrcBlend: 1 + - _UVSec: 0 + - _ZWrite: 0 + m_Colors: + - _Color: {r: 1, g: 0, b: 0.067070484, a: 0.15686275} + - _EmissionColor: {r: 0, g: 0, b: 0, a: 1} + m_BuildTextureStacks: [] diff --git a/Assets/Mirror/Components/PredictedRigidbody/LocalGhostMaterial.mat.meta b/Assets/Mirror/Components/PredictedRigidbody/LocalGhostMaterial.mat.meta new file mode 100644 index 0000000..bd5cfe5 --- /dev/null +++ b/Assets/Mirror/Components/PredictedRigidbody/LocalGhostMaterial.mat.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: 411a48b4a197d4924bec3e3809bc9320 +NativeFormatImporter: + externalObjects: {} + mainObjectFileID: 2100000 + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/PredictedRigidbody/PredictedRigidbody.cs b/Assets/Mirror/Components/PredictedRigidbody/PredictedRigidbody.cs new file mode 100644 index 0000000..9c2a66d --- /dev/null +++ b/Assets/Mirror/Components/PredictedRigidbody/PredictedRigidbody.cs @@ -0,0 +1,841 @@ +// PredictedRigidbody which stores & indidvidually rewinds history per Rigidbody. +// +// This brings significant performance savings because: +// - if a scene has 1000 objects +// - and a player interacts with say 3 objects at a time +// - Physics.Simulate() would resimulate 1000 objects +// - where as this component only resimulates the 3 changed objects +// +// The downside is that history rewinding is done manually via Vector math, +// instead of real physics. It's not 100% correct - but it sure is fast! +using System; +using System.Collections.Generic; +using UnityEngine; + +namespace Mirror +{ + public enum CorrectionMode + { + Set, // rigidbody.position/rotation = ... + Move, // rigidbody.MovePosition/Rotation + } + + // [RequireComponent(typeof(Rigidbody))] <- RB is moved out at runtime, can't require it. + public class PredictedRigidbody : NetworkBehaviour + { + Transform tf; // this component is performance critical. cache .transform getter! + protected Rigidbody predictedRigidbody; // always valid, even while moved onto the ghost. + Vector3 lastPosition; + + // motion smoothing happen on-demand, because it requires moving physics components to another GameObject. + // this only starts at a given velocity and ends when stopped moving. + // to avoid constant on/off/on effects, it also stays on for a minimum time. + [Header("Motion Smoothing")] + [Tooltip("Smoothing via Ghost-following only happens on demand, while moving with a minimum velocity.")] + public float motionSmoothingVelocityThreshold = 0.1f; + public float motionSmoothingAngularVelocityThreshold = 0.1f; + public float motionSmoothingTimeTolerance = 0.5f; + double motionSmoothingLastMovedTime; + + // client keeps state history for correction & reconciliation. + // this needs to be a SortedList because we need to be able to insert inbetween. + // RingBuffer would be faster iteration, but can't do insertions. + [Header("State History")] + public int stateHistoryLimit = 32; // 32 x 50 ms = 1.6 seconds is definitely enough + readonly SortedList stateHistory = new SortedList(); + public float recordInterval = 0.050f; + + [Tooltip("(Optional) performance optimization where FixedUpdate.RecordState() only inserts state into history if the state actually changed.\nThis is generally a good idea.")] + public bool onlyRecordChanges = true; + + [Tooltip("(Optional) performance optimization where received state is compared to the LAST recorded state first, before sampling the whole history.\n\nThis can save significant traversal overhead for idle objects with a tiny chance of missing corrections for objects which revisisted the same position in the recent history twice.")] + public bool compareLastFirst = true; + + [Header("Reconciliation")] + [Tooltip("Correction threshold in meters. For example, 0.1 means that if the client is off by more than 10cm, it gets corrected.")] + public double positionCorrectionThreshold = 0.10; + [Tooltip("Correction threshold in degrees. For example, 5 means that if the client is off by more than 5 degrees, it gets corrected.")] + public double rotationCorrectionThreshold = 5; + + [Tooltip("Applying server corrections one frame ahead gives much better results. We don't know why yet, so this is an option for now.")] + public bool oneFrameAhead = true; + + [Header("Smoothing")] + [Tooltip("Configure how to apply the corrected state.")] + public CorrectionMode correctionMode = CorrectionMode.Move; + + [Tooltip("Snap to the server state directly when velocity is < threshold. This is useful to reduce jitter/fighting effects before coming to rest.\nNote this applies position, rotation and velocity(!) so it's still smooth.")] + public float snapThreshold = 2; // 0.5 has too much fighting-at-rest, 2 seems ideal. + + [Header("Visual Interpolation")] + [Tooltip("After creating the visual interpolation object, keep showing the original Rigidbody with a ghost (transparent) material for debugging.")] + public bool showGhost = true; + [Tooltip("Physics components are moved onto a ghost object beyond this threshold. Main object visually interpolates to it.")] + public float ghostVelocityThreshold = 0.1f; + + [Tooltip("After creating the visual interpolation object, replace this object's renderer materials with the ghost (ideally transparent) material.")] + public Material localGhostMaterial; + public Material remoteGhostMaterial; + + [Tooltip("How fast to interpolate to the target position, relative to how far we are away from it.\nHigher value will be more jitter but sharper moves, lower value will be less jitter but a little too smooth / rounded moves.")] + public float positionInterpolationSpeed = 15; // 10 is a little too low for billiards at least + public float rotationInterpolationSpeed = 10; + + [Tooltip("Teleport if we are further than 'multiplier x collider size' behind.")] + public float teleportDistanceMultiplier = 10; + + [Header("Bandwidth")] + [Tooltip("Reduce sends while velocity==0. Client's objects may slightly move due to gravity/physics, so we still want to send corrections occasionally even if an object is idle on the server the whole time.")] + public bool reduceSendsWhileIdle = true; + + [Header("Debugging")] + public float lineTime = 10; + + // Rigidbody & Collider are moved out into a separate object. + // this way the visual object can smoothly follow. + protected GameObject physicsCopy; + // protected Transform physicsCopyTransform; // caching to avoid GetComponent + // protected Rigidbody physicsCopyRigidbody => rb; // caching to avoid GetComponent + // protected Collider physicsCopyCollider; // caching to avoid GetComponent + float smoothFollowThreshold; // caching to avoid calculation in LateUpdate + + // we also create one extra ghost for the exact known server state. + protected GameObject remoteCopy; + + // joints + Vector3 initialPosition; + Quaternion initialRotation; + // Vector3 initialScale; // don't change scale for now. causes issues with parenting. + + void Awake() + { + tf = transform; + predictedRigidbody = GetComponent(); + if (predictedRigidbody == null) throw new InvalidOperationException($"Prediction: {name} is missing a Rigidbody component."); + + // cache some threshold to avoid calculating them in LateUpdate + float colliderSize = GetComponentInChildren().bounds.size.magnitude; + smoothFollowThreshold = colliderSize * teleportDistanceMultiplier; + + // cache initial position/rotation/scale to be used when moving physics components (configurable joints' range of motion) + initialPosition = tf.position; + initialRotation = tf.rotation; + // initialScale = tf.localScale; + } + + protected virtual void CopyRenderersAsGhost(GameObject destination, Material material) + { + // find the MeshRenderer component, which sometimes is on a child. + MeshRenderer originalMeshRenderer = GetComponentInChildren(true); + MeshFilter originalMeshFilter = GetComponentInChildren(true); + if (originalMeshRenderer != null && originalMeshFilter != null) + { + MeshFilter meshFilter = destination.AddComponent(); + meshFilter.mesh = originalMeshFilter.mesh; + + MeshRenderer meshRenderer = destination.AddComponent(); + meshRenderer.material = originalMeshRenderer.material; + + // renderers often have multiple materials. copy all. + if (originalMeshRenderer.materials != null) + { + Material[] materials = new Material[originalMeshRenderer.materials.Length]; + for (int i = 0; i < materials.Length; ++i) + { + materials[i] = material; + } + meshRenderer.materials = materials; // need to reassign to see it in effect + } + } + // if we didn't find a renderer, show a warning + else Debug.LogWarning($"PredictedRigidbody: {name} found no renderer to copy onto the visual object. If you are using a custom setup, please overwrite PredictedRigidbody.CreateVisualCopy()."); + } + + // instantiate a physics-only copy of the gameobject to apply corrections. + // this way the main visual object can smoothly follow. + // it's best to separate the physics instead of separating the renderers. + // some projects have complex rendering / animation setups which we can't touch. + // besides, Rigidbody+Collider are two components, where as renders may be many. + protected virtual void CreateGhosts() + { + // skip if host mode or already separated + if (isServer || physicsCopy != null) return; + + Debug.Log($"Separating Physics for {name}"); + + // create an empty GameObject with the same name + _Physical + // it's important to copy world position/rotation/scale, not local! + // because the original object may be a child of another. + // + // for example: + // parent (scale=1.5) + // child (scale=0.5) + // + // if we copy localScale then the copy has scale=0.5, where as the + // original would have a global scale of ~1.0. + physicsCopy = new GameObject($"{name}_Physical"); + + // assign the same Layer for the physics copy. + // games may use a custom physics collision matrix, layer matters. + physicsCopy.layer = gameObject.layer; + + // add the PredictedRigidbodyPhysical component + PredictedRigidbodyPhysicsGhost physicsGhostRigidbody = physicsCopy.AddComponent(); + physicsGhostRigidbody.target = tf; + + // when moving (Configurable)Joints, their range of motion is + // relative to the initial position. if we move them after the + // GameObject rotated, the range of motion is wrong. + // the easiest solution is to move to initial position, + // then move physics components, then move back. + // => remember previous + Vector3 position = tf.position; + Quaternion rotation = tf.rotation; + // Vector3 scale = tf.localScale; // don't change scale for now. causes issues with parenting. + // => reset to initial + physicsGhostRigidbody.transform.position = tf.position = initialPosition; + physicsGhostRigidbody.transform.rotation = tf.rotation = initialRotation; + physicsGhostRigidbody.transform.localScale = tf.lossyScale;// world scale! // = initialScale; // don't change scale for now. causes issues with parenting. + // => move physics components + PredictionUtils.MovePhysicsComponents(gameObject, physicsCopy); + // => reset previous + physicsGhostRigidbody.transform.position = tf.position = position; + physicsGhostRigidbody.transform.rotation = tf.rotation = rotation; + //physicsGhostRigidbody.transform.localScale = tf.lossyScale; // world scale! //= scale; // don't change scale for now. causes issues with parenting. + + // show ghost by copying all renderers / materials with ghost material applied + if (showGhost) + { + // one for the locally predicted rigidbody + CopyRenderersAsGhost(physicsCopy, localGhostMaterial); + + // one for the latest remote state for comparison + // it's important to copy world position/rotation/scale, not local! + // because the original object may be a child of another. + // + // for example: + // parent (scale=1.5) + // child (scale=0.5) + // + // if we copy localScale then the copy has scale=0.5, where as the + // original would have a global scale of ~1.0. + remoteCopy = new GameObject($"{name}_Remote"); + remoteCopy.transform.position = tf.position; // world position! + remoteCopy.transform.rotation = tf.rotation; // world rotation! + remoteCopy.transform.localScale = tf.lossyScale; // world scale! + CopyRenderersAsGhost(remoteCopy, remoteGhostMaterial); + } + + // assign our Rigidbody reference to the ghost + predictedRigidbody = physicsCopy.GetComponent(); + } + + protected virtual void DestroyGhosts() + { + // move the copy's Rigidbody back onto self. + // important for scene objects which may be reused for AOI spawn/despawn. + // otherwise next time they wouldn't have a collider anymore. + if (physicsCopy != null) + { + // when moving (Configurable)Joints, their range of motion is + // relative to the initial position. if we move them after the + // GameObject rotated, the range of motion is wrong. + // the easiest solution is to move to initial position, + // then move physics components, then move back. + // => remember previous + Vector3 position = tf.position; + Quaternion rotation = tf.rotation; + Vector3 scale = tf.localScale; + // => reset to initial + physicsCopy.transform.position = tf.position = initialPosition; + physicsCopy.transform.rotation = tf.rotation = initialRotation; + physicsCopy.transform.localScale = tf.lossyScale;// = initialScale; + // => move physics components + PredictionUtils.MovePhysicsComponents(physicsCopy, gameObject); + // => reset previous + tf.position = position; + tf.rotation = rotation; + tf.localScale = scale; + + // when moving components back, we need to undo the joints initial-delta rotation that we added. + Destroy(physicsCopy); + + // reassign our Rigidbody reference + predictedRigidbody = GetComponent(); + } + + // simply destroy the remote copy + if (remoteCopy != null) Destroy(remoteCopy); + } + + // this shows in profiler LateUpdates! need to make this as fast as possible! + protected virtual void SmoothFollowPhysicsCopy() + { + // hard follow: + // tf.position = physicsCopyCollider.position; + // tf.rotation = physicsCopyCollider.rotation; + + // ORIGINAL VERSION: CLEAN AND SIMPLE + /* + // if we are further than N colliders sizes behind, then teleport + float colliderSize = physicsCopyCollider.bounds.size.magnitude; + float threshold = colliderSize * teleportDistanceMultiplier; + float distance = Vector3.Distance(tf.position, physicsCopyRigidbody.position); + if (distance > threshold) + { + tf.position = physicsCopyRigidbody.position; + tf.rotation = physicsCopyRigidbody.rotation; + Debug.Log($"[PredictedRigidbody] Teleported because distance to physics copy = {distance:F2} > threshold {threshold:F2}"); + return; + } + + // smoothly interpolate to the target position. + // speed relative to how far away we are + float positionStep = distance * positionInterpolationSpeed; + tf.position = Vector3.MoveTowards(tf.position, physicsCopyRigidbody.position, positionStep * Time.deltaTime); + + // smoothly interpolate to the target rotation. + // Quaternion.RotateTowards doesn't seem to work at all, so let's use SLerp. + tf.rotation = Quaternion.Slerp(tf.rotation, physicsCopyRigidbody.rotation, rotationInterpolationSpeed * Time.deltaTime); + */ + + // FAST VERSION: this shows in profiler a lot, so cache EVERYTHING! + tf.GetPositionAndRotation(out Vector3 currentPosition, out Quaternion currentRotation); // faster than tf.position + tf.rotation + Vector3 physicsPosition = predictedRigidbody.position; + Quaternion physicsRotation = predictedRigidbody.rotation; + float deltaTime = Time.deltaTime; + + float distance = Vector3.Distance(currentPosition, physicsPosition); + if (distance > smoothFollowThreshold) + { + tf.SetPositionAndRotation(physicsPosition, physicsRotation); // faster than .position and .rotation manually + Debug.Log($"[PredictedRigidbody] Teleported because distance to physics copy = {distance:F2} > threshold {smoothFollowThreshold:F2}"); + return; + } + + // smoothly interpolate to the target position. + // speed relative to how far away we are. + // => speed increases by distance² because the further away, the + // sooner we need to catch the fuck up + // float positionStep = (distance * distance) * interpolationSpeed; + float positionStep = distance * positionInterpolationSpeed; + Vector3 newPosition = Vector3.MoveTowards(currentPosition, physicsPosition, positionStep * deltaTime); + + // smoothly interpolate to the target rotation. + // Quaternion.RotateTowards doesn't seem to work at all, so let's use SLerp. + // Quaternions always need to be normalized in order to be a valid rotation after operations + Quaternion newRotation = Quaternion.Slerp(currentRotation, physicsRotation, rotationInterpolationSpeed * deltaTime).normalized; + + // assign position and rotation together. faster than accessing manually. + tf.SetPositionAndRotation(newPosition, newRotation); + } + + // destroy visual copy only in OnStopClient(). + // OnDestroy() wouldn't be called for scene objects that are only disabled instead of destroyed. + public override void OnStopClient() + { + DestroyGhosts(); + } + + void UpdateServer() + { + // bandwidth optimization while idle. + if (reduceSendsWhileIdle) + { + // while moving, always sync every frame for immediate corrections. + // while idle, only sync once per second. + // + // we still need to sync occasionally because objects on client + // may still slide or move slightly due to gravity, physics etc. + // and those still need to get corrected if not moving on server. + // + // TODO + // next round of optimizations: if client received nothing for 1s, + // force correct to last received state. then server doesn't need + // to send once per second anymore. + syncInterval = IsMoving() ? 0 : 1; + } + + // always set dirty to always serialize in next sync interval. + SetDirty(); + } + + // movement detection is virtual, in case projects want to use other methods. + protected virtual bool IsMoving() => + predictedRigidbody.linearVelocity.magnitude >= motionSmoothingVelocityThreshold || + predictedRigidbody.angularVelocity.magnitude >= motionSmoothingAngularVelocityThreshold; + + void UpdateGhosting() + { + // client only uses ghosts on demand while interacting. + // this way 1000 GameObjects don't need +1000 Ghost GameObjects all the time! + + // no ghost at the moment + if (physicsCopy == null) + { + // faster than velocity threshold? then create the ghosts. + // with 10% buffer zone so we don't flip flop all the time. + if (IsMoving()) + { + CreateGhosts(); + OnBeginPrediction(); + } + } + // ghosting at the moment + else + { + // always set last moved time while moving. + // this way we can avoid on/off/oneffects when stopping. + if (IsMoving()) + { + motionSmoothingLastMovedTime = NetworkTime.time; + } + // slower than velocity threshold? then destroy the ghosts. + // with a minimum time since starting to move, to avoid on/off/on effects. + else + { + if (NetworkTime.time >= motionSmoothingLastMovedTime + motionSmoothingTimeTolerance) + { + DestroyGhosts(); + OnEndPrediction(); + physicsCopy = null; // TESTING + } + } + } + } + + void Update() + { + if (isServer) UpdateServer(); + if (isClientOnly) UpdateGhosting(); + } + + void LateUpdate() + { + // only follow on client-only, not in server or host mode + if (isClientOnly && physicsCopy) SmoothFollowPhysicsCopy(); + } + + void FixedUpdate() + { + // on clients (not host) we record the current state every FixedUpdate. + // this is cheap, and allows us to keep a dense history. + if (isClientOnly) + { + // OPTIMIZATION: RecordState() is expensive because it inserts into a SortedList. + // only record if state actually changed! + // risks not having up to date states when correcting, + // but it doesn't matter since we'll always compare with the 'newest' anyway. + // + // we check in here instead of in RecordState() because RecordState() should definitely record if we call it! + if (onlyRecordChanges) + { + // TODO maybe don't reuse the correction thresholds? + tf.GetPositionAndRotation(out Vector3 position, out Quaternion rotation); + if (Vector3.Distance(lastRecorded.position, position) < positionCorrectionThreshold && + Quaternion.Angle(lastRecorded.rotation, rotation) < rotationCorrectionThreshold) + { + // Debug.Log($"FixedUpdate for {name}: taking optimized early return instead of recording state."); + return; + } + } + + RecordState(); + } + } + + // manually store last recorded so we can easily check against this + // without traversing the SortedList. + RigidbodyState lastRecorded; + double lastRecordTime; + void RecordState() + { + // instead of recording every fixedupdate, let's record in an interval. + // we don't want to record every tiny move and correct too hard. + if (NetworkTime.time < lastRecordTime + recordInterval) return; + lastRecordTime = NetworkTime.time; + + // NetworkTime.time is always behind by bufferTime. + // prediction aims to be on the exact same server time (immediately). + // use predictedTime to record state, otherwise we would record in the past. + double predictedTime = NetworkTime.predictedTime; + + // FixedUpdate may run twice in the same frame / NetworkTime.time. + // for now, simply don't record if already recorded there. + // previously we checked ContainsKey which is O(logN) for SortedList + // if (stateHistory.ContainsKey(predictedTime)) + // return; + // instead, simply store the last recorded time and don't insert if same. + if (predictedTime == lastRecorded.timestamp) return; + + // keep state history within limit + if (stateHistory.Count >= stateHistoryLimit) + stateHistory.RemoveAt(0); + + // grab current position/rotation/velocity only once. + // this is performance critical, avoid calling .transform multiple times. + tf.GetPositionAndRotation(out Vector3 currentPosition, out Quaternion currentRotation); // faster than accessing .position + .rotation manually + Vector3 currentVelocity = predictedRigidbody.linearVelocity; + Vector3 currentAngularVelocity = predictedRigidbody.angularVelocity; + + // calculate delta to previous state (if any) + Vector3 positionDelta = Vector3.zero; + Vector3 velocityDelta = Vector3.zero; + Vector3 angularVelocityDelta = Vector3.zero; + Quaternion rotationDelta = Quaternion.identity; + if (stateHistory.Count > 0) + { + RigidbodyState last = stateHistory.Values[stateHistory.Count - 1]; + positionDelta = currentPosition - last.position; + velocityDelta = currentVelocity - last.velocity; + // Quaternions always need to be normalized in order to be valid rotations after operations + rotationDelta = (currentRotation * Quaternion.Inverse(last.rotation)).normalized; + angularVelocityDelta = currentAngularVelocity - last.angularVelocity; + + // debug draw the recorded state + // Debug.DrawLine(last.position, currentPosition, Color.red, lineTime); + } + + // create state to insert + RigidbodyState state = new RigidbodyState( + predictedTime, + positionDelta, + currentPosition, + rotationDelta, + currentRotation, + velocityDelta, + currentVelocity, + angularVelocityDelta, + currentAngularVelocity + ); + + // add state to history + stateHistory.Add(predictedTime, state); + + // manually remember last inserted state for faster .Last comparisons + lastRecorded = state; + } + + // optional user callbacks, in case people need to know about events. + protected virtual void OnSnappedIntoPlace() {} + protected virtual void OnBeforeApplyState() {} + protected virtual void OnCorrected() {} + protected virtual void OnBeginPrediction() {} // when the Rigidbody moved above threshold and we created a ghost + protected virtual void OnEndPrediction() {} // when the Rigidbody came to rest and we destroyed the ghost + + void ApplyState(double timestamp, Vector3 position, Quaternion rotation, Vector3 velocity, Vector3 angularVelocity) + { + // fix rigidbodies seemingly dancing in place instead of coming to rest. + // hard snap to the position below a threshold velocity. + // this is fine because the visual object still smoothly interpolates to it. + // => consider both velocity and angular velocity (in case of Rigidbodies only rotating with joints etc.) + if (predictedRigidbody.linearVelocity.magnitude <= snapThreshold && + predictedRigidbody.angularVelocity.magnitude <= snapThreshold) + { + // Debug.Log($"Prediction: snapped {name} into place because velocity {predictedRigidbody.velocity.magnitude:F3} <= {snapThreshold:F3}"); + + // apply server state immediately. + // important to apply velocity as well, instead of Vector3.zero. + // in case an object is still slightly moving, we don't want it + // to stop and start moving again on client - slide as well here. + predictedRigidbody.position = position; + predictedRigidbody.rotation = rotation; + // projects may keep Rigidbodies as kinematic sometimes. in that case, setting velocity would log an error + if (!predictedRigidbody.isKinematic) + { + predictedRigidbody.linearVelocity = velocity; + predictedRigidbody.angularVelocity = angularVelocity; + } + + // clear history and insert the exact state we just applied. + // this makes future corrections more accurate. + stateHistory.Clear(); + stateHistory.Add(timestamp, new RigidbodyState( + timestamp, + Vector3.zero, + position, + Quaternion.identity, + rotation, + Vector3.zero, + velocity, + Vector3.zero, + angularVelocity + )); + + // user callback + OnSnappedIntoPlace(); + return; + } + + // we have a callback for snapping into place (above). + // we also need one for corrections without snapping into place. + // call it before applying pos/rot/vel in case we need to set kinematic etc. + OnBeforeApplyState(); + + // Rigidbody .position teleports, while .MovePosition interpolates + // TODO is this a good idea? what about next capture while it's interpolating? + if (correctionMode == CorrectionMode.Move) + { + predictedRigidbody.MovePosition(position); + predictedRigidbody.MoveRotation(rotation); + } + else if (correctionMode == CorrectionMode.Set) + { + predictedRigidbody.position = position; + predictedRigidbody.rotation = rotation; + } + + // there's only one way to set velocity. + // (projects may keep Rigidbodies as kinematic sometimes. in that case, setting velocity would log an error) + if (!predictedRigidbody.isKinematic) + { + predictedRigidbody.linearVelocity = velocity; + predictedRigidbody.angularVelocity = angularVelocity; + } + } + + // process a received server state. + // compares it against our history and applies corrections if needed. + void OnReceivedState(double timestamp, RigidbodyState state) + { + // always update remote state ghost + if (remoteCopy != null) + { + Transform remoteCopyTransform = remoteCopy.transform; + remoteCopyTransform.SetPositionAndRotation(state.position, state.rotation); // faster than .position + .rotation setters + remoteCopyTransform.localScale = tf.lossyScale; // world scale! see CreateGhosts comment. + } + + // OPTIONAL performance optimization when comparing idle objects. + // even idle objects will have a history of ~32 entries. + // sampling & traversing through them is unnecessarily costly. + // instead, compare directly against the current rigidbody position! + // => this is technically not 100% correct if an object runs in + // circles where it may revisit the same position twice. + // => but practically, objects that didn't move will have their + // whole history look like the last inserted state. + // => comparing against that is free and gives us a significant + // performance saving vs. a tiny chance of incorrect results due + // to objects running in circles. + // => the RecordState() call below is expensive too, so we want to + // do this before even recording the latest state. the only way + // to do this (in case last recorded state is too old), is to + // compare against live rigidbody.position without any recording. + // this is as fast as it gets for skipping idle objects. + // + // if this ever causes issues, feel free to disable it. + if (compareLastFirst && + Vector3.Distance(state.position, predictedRigidbody.position) < positionCorrectionThreshold && + Quaternion.Angle(state.rotation, predictedRigidbody.rotation) < rotationCorrectionThreshold) + { + // Debug.Log($"OnReceivedState for {name}: taking optimized early return!"); + return; + } + + // we only capture state every 'interval' milliseconds. + // so the newest entry in 'history' may be up to 'interval' behind 'now'. + // if there's no latency, we may receive a server state for 'now'. + // sampling would fail, if we haven't recorded anything in a while. + // to solve this, always record the current state when receiving a server state. + RecordState(); + + // correction requires at least 2 existing states for 'before' and 'after'. + // if we don't have two yet, drop this state and try again next time once we recorded more. + if (stateHistory.Count < 2) return; + + RigidbodyState oldest = stateHistory.Values[0]; + RigidbodyState newest = stateHistory.Values[stateHistory.Count - 1]; + + // edge case: is the state older than the oldest state in history? + // this can happen if the client gets so far behind the server + // that it doesn't have a recored history to sample from. + // in that case, we should hard correct the client. + // otherwise it could be out of sync as long as it's too far behind. + if (state.timestamp < oldest.timestamp) + { + // when starting, client may only have 2-3 states in history. + // it's expected that server states would be behind those 2-3. + // only show a warning if it's behind the full history limit! + if (stateHistory.Count >= stateHistoryLimit) + Debug.LogWarning($"Hard correcting client object {name} because the client is too far behind the server. History of size={stateHistory.Count} @ t={timestamp:F3} oldest={oldest.timestamp:F3} newest={newest.timestamp:F3}. This would cause the client to be out of sync as long as it's behind."); + + // force apply the state + ApplyState(state.timestamp, state.position, state.rotation, state.velocity, state.angularVelocity); + return; + } + + // edge case: is it newer than the newest state in history? + // this can happen if client's predictedTime predicts too far ahead of the server. + // in that case, log a warning for now but still apply the correction. + // otherwise it could be out of sync as long as it's too far ahead. + // + // for example, when running prediction on the same machine with near zero latency. + // when applying corrections here, this looks just fine on the local machine. + if (newest.timestamp < state.timestamp) + { + // the correction is for a state in the future. + // we clamp it to 'now'. + // but only correct if off by threshold. + // TODO maybe we should interpolate this back to 'now'? + if (Vector3.Distance(state.position, predictedRigidbody.position) >= positionCorrectionThreshold) + { + double ahead = state.timestamp - newest.timestamp; + Debug.Log($"Hard correction because the client is ahead of the server by {(ahead*1000):F1}ms. History of size={stateHistory.Count} @ t={timestamp:F3} oldest={oldest.timestamp:F3} newest={newest.timestamp:F3}. This can happen when latency is near zero, and is fine unless it shows jitter."); + ApplyState(state.timestamp, state.position, state.rotation, state.velocity, state.angularVelocity); + } + return; + } + + // find the two closest client states between timestamp + if (!Prediction.Sample(stateHistory, timestamp, out RigidbodyState before, out RigidbodyState after, out int afterIndex, out double t)) + { + // something went very wrong. sampling should've worked. + // hard correct to recover the error. + Debug.LogError($"Failed to sample history of size={stateHistory.Count} @ t={timestamp:F3} oldest={oldest.timestamp:F3} newest={newest.timestamp:F3}. This should never happen because the timestamp is within history."); + ApplyState(state.timestamp, state.position, state.rotation, state.velocity, state.angularVelocity); + return; + } + + // interpolate between them to get the best approximation + RigidbodyState interpolated = RigidbodyState.Interpolate(before, after, (float)t); + + // calculate the difference between where we were and where we should be + // TODO only position for now. consider rotation etc. too later + float positionDifference = Vector3.Distance(state.position, interpolated.position); + float rotationDifference = Quaternion.Angle(state.rotation, interpolated.rotation); + // Debug.Log($"Sampled history of size={stateHistory.Count} @ {timestamp:F3}: client={interpolated.position} server={state.position} difference={difference:F3} / {correctionThreshold:F3}"); + + // too far off? then correct it + if (positionDifference >= positionCorrectionThreshold || + rotationDifference >= rotationCorrectionThreshold) + { + // Debug.Log($"CORRECTION NEEDED FOR {name} @ {timestamp:F3}: client={interpolated.position} server={state.position} difference={difference:F3}"); + + // show the received correction position + velocity for debugging. + // helps to compare with the interpolated/applied correction locally. + //Debug.DrawLine(state.position, state.position + state.velocity * 0.1f, Color.white, lineTime); + + // insert the correction and correct the history on top of it. + // returns the final recomputed state after rewinding. + RigidbodyState recomputed = Prediction.CorrectHistory(stateHistory, stateHistoryLimit, state, before, after, afterIndex); + + // log, draw & apply the final position. + // always do this here, not when iterating above, in case we aren't iterating. + // for example, on same machine with near zero latency. + // int correctedAmount = stateHistory.Count - afterIndex; + // Debug.Log($"Correcting {name}: {correctedAmount} / {stateHistory.Count} states to final position from: {rb.position} to: {last.position}"); + //Debug.DrawLine(physicsCopyRigidbody.position, recomputed.position, Color.green, lineTime); + ApplyState(recomputed.timestamp, recomputed.position, recomputed.rotation, recomputed.velocity, recomputed.angularVelocity); + + // user callback + OnCorrected(); + } + } + + // send state to clients every sendInterval. + // reliable for now. + // TODO we should use the one from FixedUpdate + public override void OnSerialize(NetworkWriter writer, bool initialState) + { + // Time.time was at the beginning of this frame. + // NetworkLateUpdate->Broadcast->OnSerialize is at the end of the frame. + // as result, client should use this to correct the _next_ frame. + // otherwise we see noticeable resets that seem off by one frame. + // + // to solve this, we can send the current deltaTime. + // server is technically supposed to be at a fixed frame rate, but this can vary. + // sending server's current deltaTime is the safest option. + // client then applies it on top of remoteTimestamp. + + + // FAST VERSION: this shows in profiler a lot, so cache EVERYTHING! + tf.GetPositionAndRotation(out Vector3 position, out Quaternion rotation); // faster than tf.position + tf.rotation. server's rigidbody is on the same transform. + writer.WriteFloat(Time.deltaTime); + writer.WriteVector3(position); + writer.WriteQuaternion(rotation); + writer.WriteVector3(predictedRigidbody.linearVelocity); + writer.WriteVector3(predictedRigidbody.angularVelocity); + } + + // read the server's state, compare with client state & correct if necessary. + public override void OnDeserialize(NetworkReader reader, bool initialState) + { + // deserialize data + // we want to know the time on the server when this was sent, which is remoteTimestamp. + double timestamp = NetworkClient.connection.remoteTimeStamp; + + // server send state at the end of the frame. + // parse and apply the server's delta time to our timestamp. + // otherwise we see noticeable resets that seem off by one frame. + double serverDeltaTime = reader.ReadFloat(); + timestamp += serverDeltaTime; + + // however, adding yet one more frame delay gives much(!) better results. + // we don't know why yet, so keep this as an option for now. + // possibly because client captures at the beginning of the frame, + // with physics happening at the end of the frame? + if (oneFrameAhead) timestamp += serverDeltaTime; + + // parse state + Vector3 position = reader.ReadVector3(); + Quaternion rotation = reader.ReadQuaternion(); + Vector3 velocity = reader.ReadVector3(); + Vector3 angularVelocity = reader.ReadVector3(); + + // process received state + OnReceivedState(timestamp, new RigidbodyState(timestamp, Vector3.zero, position, Quaternion.identity, rotation, Vector3.zero, velocity, Vector3.zero, angularVelocity)); + } + + protected override void OnValidate() + { + base.OnValidate(); + + // force syncDirection to be ServerToClient + syncDirection = SyncDirection.ServerToClient; + + // state should be synced immediately for now. + // later when we have prediction fully dialed in, + // then we can maybe relax this a bit. + syncInterval = 0; + } + + // helper function for Physics tests to check if a Rigidbody belongs to + // a PredictedRigidbody component (either on it, or on its ghost). + public static bool IsPredicted(Rigidbody rb, out PredictedRigidbody predictedRigidbody) + { + // by default, Rigidbody is on the PredictedRigidbody GameObject + if (rb.TryGetComponent(out predictedRigidbody)) + return true; + + // it might be on a ghost while interacting + if (rb.TryGetComponent(out PredictedRigidbodyPhysicsGhost ghost)) + { + predictedRigidbody = ghost.target.GetComponent(); + return true; + } + + // otherwise the Rigidbody does not belong to any PredictedRigidbody. + predictedRigidbody = null; + return false; + } + + // helper function for Physics tests to check if a Collider (which may be in children) belongs to + // a PredictedRigidbody component (either on it, or on its ghost). + public static bool IsPredicted(Collider co, out PredictedRigidbody predictedRigidbody) + { + // by default, Collider is on the PredictedRigidbody GameObject or it's children. + predictedRigidbody = co.GetComponentInParent(); + if (predictedRigidbody != null) + return true; + + // it might be on a ghost while interacting + PredictedRigidbodyPhysicsGhost ghost = co.GetComponentInParent(); + if (ghost != null && ghost.target != null && ghost.target.TryGetComponent(out predictedRigidbody)) + return true; + + // otherwise the Rigidbody does not belong to any PredictedRigidbody. + predictedRigidbody = null; + return false; + } + } +} diff --git a/Assets/Mirror/Components/PredictedRigidbody/PredictedRigidbody.cs.meta b/Assets/Mirror/Components/PredictedRigidbody/PredictedRigidbody.cs.meta new file mode 100644 index 0000000..6456058 --- /dev/null +++ b/Assets/Mirror/Components/PredictedRigidbody/PredictedRigidbody.cs.meta @@ -0,0 +1,15 @@ +fileFormatVersion: 2 +guid: d38927cdc6024b9682b5fe9778b9ef99 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: + - localGhostMaterial: {fileID: 2100000, guid: 411a48b4a197d4924bec3e3809bc9320, + type: 2} + - remoteGhostMaterial: {fileID: 2100000, guid: 04f0b2088c857414393bab3b80356776, + type: 2} + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/PredictedRigidbody/PredictedRigidbodyPhysicsGhost.cs b/Assets/Mirror/Components/PredictedRigidbody/PredictedRigidbodyPhysicsGhost.cs new file mode 100644 index 0000000..f28d49f --- /dev/null +++ b/Assets/Mirror/Components/PredictedRigidbody/PredictedRigidbodyPhysicsGhost.cs @@ -0,0 +1,15 @@ +// Prediction moves out the Rigidbody & Collider into a separate object. +// this component simply points back to the owner component. +// in case Raycasts hit it and need to know the owner, etc. +using UnityEngine; + +namespace Mirror +{ + public class PredictedRigidbodyPhysicsGhost : MonoBehaviour + { + // this is performance critical, so store target's .Transform instead of + // PredictedRigidbody, this way we don't need to call the .transform getter. + [Tooltip("The predicted rigidbody owner.")] + public Transform target; + } +} diff --git a/Assets/Mirror/Components/PredictedRigidbody/PredictedRigidbodyPhysicsGhost.cs.meta b/Assets/Mirror/Components/PredictedRigidbody/PredictedRigidbodyPhysicsGhost.cs.meta new file mode 100644 index 0000000..e4b8787 --- /dev/null +++ b/Assets/Mirror/Components/PredictedRigidbody/PredictedRigidbodyPhysicsGhost.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 25593abc9bf0d44878a4ad6018204061 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/PredictedRigidbody/PredictedRigidbodyRemoteGhost.cs b/Assets/Mirror/Components/PredictedRigidbody/PredictedRigidbodyRemoteGhost.cs new file mode 100644 index 0000000..636f397 --- /dev/null +++ b/Assets/Mirror/Components/PredictedRigidbody/PredictedRigidbodyRemoteGhost.cs @@ -0,0 +1 @@ +// removed 2024-02-09 diff --git a/Assets/Mirror/Components/PredictedRigidbody/PredictedRigidbodyRemoteGhost.cs.meta b/Assets/Mirror/Components/PredictedRigidbody/PredictedRigidbodyRemoteGhost.cs.meta new file mode 100644 index 0000000..f79f911 --- /dev/null +++ b/Assets/Mirror/Components/PredictedRigidbody/PredictedRigidbodyRemoteGhost.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 62e7e9424c7e48d69b6a3517796142a1 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/PredictedRigidbody/PredictionUtils.cs b/Assets/Mirror/Components/PredictedRigidbody/PredictionUtils.cs new file mode 100644 index 0000000..83c9515 --- /dev/null +++ b/Assets/Mirror/Components/PredictedRigidbody/PredictionUtils.cs @@ -0,0 +1,419 @@ +// standalone utility functions for PredictedRigidbody component. +using System; +using UnityEngine; + +namespace Mirror +{ + public static class PredictionUtils + { + // rigidbody /////////////////////////////////////////////////////////// + // move a Rigidbody + settings from one GameObject to another. + public static void MoveRigidbody(GameObject source, GameObject destination) + { + // create a new Rigidbody component on destination. + // note that adding a Joint automatically adds a Rigidbody. + // so first check if one was added yet. + Rigidbody original = source.GetComponent(); + if (original == null) throw new Exception($"Prediction: attempted to move {source}'s Rigidbody to the predicted copy, but there was no component."); + Rigidbody rigidbodyCopy; + if (!destination.TryGetComponent(out rigidbodyCopy)) + rigidbodyCopy = destination.AddComponent(); + + // copy all properties + rigidbodyCopy.mass = original.mass; + rigidbodyCopy.linearDamping = original.linearDamping; + rigidbodyCopy.angularDamping = original.angularDamping; + rigidbodyCopy.useGravity = original.useGravity; + rigidbodyCopy.isKinematic = original.isKinematic; + rigidbodyCopy.interpolation = original.interpolation; + rigidbodyCopy.collisionDetectionMode = original.collisionDetectionMode; + rigidbodyCopy.constraints = original.constraints; + rigidbodyCopy.sleepThreshold = original.sleepThreshold; + rigidbodyCopy.freezeRotation = original.freezeRotation; + + // moving (Configurable)Joints messes up their range of motion unless + // we reset to initial position first (we do this in PredictedRigibody.cs). + // so here we don't set the Rigidbody's physics position at all. + // rigidbodyCopy.position = original.position; + // rigidbodyCopy.rotation = original.rotation; + + // projects may keep Rigidbodies as kinematic sometimes. in that case, setting velocity would log an error + if (!original.isKinematic) + { + rigidbodyCopy.linearVelocity = original.linearVelocity; + rigidbodyCopy.angularVelocity = original.angularVelocity; + } + + // destroy original + GameObject.Destroy(original); + } + + // helper function: if a collider is on a child, copy that child first. + // this way child's relative position/rotation/scale are preserved. + public static GameObject CopyRelativeTransform(GameObject source, Transform sourceChild, GameObject destination) + { + // is this on the source root? then we want to put it on the destination root. + if (sourceChild == source.transform) return destination; + + // is this on a child? then create the same child with the same transform on destination. + // note this is technically only correct for the immediate child since + // .localPosition is relative to parent, but this is good enough. + GameObject child = new GameObject(sourceChild.name); + child.transform.SetParent(destination.transform, true); + child.transform.localPosition = sourceChild.localPosition; + child.transform.localRotation = sourceChild.localRotation; + child.transform.localScale = sourceChild.localScale; + + // assign the same Layer for the physics copy. + // games may use a custom physics collision matrix, layer matters. + child.layer = sourceChild.gameObject.layer; + + return child; + } + + // colliders /////////////////////////////////////////////////////////// + // move all BoxColliders + settings from one GameObject to another. + public static void MoveBoxColliders(GameObject source, GameObject destination) + { + // colliders may be on children + BoxCollider[] sourceColliders = source.GetComponentsInChildren(); + foreach (BoxCollider sourceCollider in sourceColliders) + { + // copy the relative transform: + // if collider is on root, it returns destination root. + // if collider is on a child, it creates and returns a child on destination. + GameObject target = CopyRelativeTransform(source, sourceCollider.transform, destination); + BoxCollider colliderCopy = target.AddComponent(); + colliderCopy.center = sourceCollider.center; + colliderCopy.size = sourceCollider.size; + colliderCopy.isTrigger = sourceCollider.isTrigger; + colliderCopy.material = sourceCollider.material; + GameObject.Destroy(sourceCollider); + } + } + + // move all SphereColliders + settings from one GameObject to another. + public static void MoveSphereColliders(GameObject source, GameObject destination) + { + // colliders may be on children + SphereCollider[] sourceColliders = source.GetComponentsInChildren(); + foreach (SphereCollider sourceCollider in sourceColliders) + { + // copy the relative transform: + // if collider is on root, it returns destination root. + // if collider is on a child, it creates and returns a child on destination. + GameObject target = CopyRelativeTransform(source, sourceCollider.transform, destination); + SphereCollider colliderCopy = target.AddComponent(); + colliderCopy.center = sourceCollider.center; + colliderCopy.radius = sourceCollider.radius; + colliderCopy.isTrigger = sourceCollider.isTrigger; + colliderCopy.material = sourceCollider.material; + GameObject.Destroy(sourceCollider); + } + } + + // move all CapsuleColliders + settings from one GameObject to another. + public static void MoveCapsuleColliders(GameObject source, GameObject destination) + { + // colliders may be on children + CapsuleCollider[] sourceColliders = source.GetComponentsInChildren(); + foreach (CapsuleCollider sourceCollider in sourceColliders) + { + // copy the relative transform: + // if collider is on root, it returns destination root. + // if collider is on a child, it creates and returns a child on destination. + GameObject target = CopyRelativeTransform(source, sourceCollider.transform, destination); + CapsuleCollider colliderCopy = target.AddComponent(); + colliderCopy.center = sourceCollider.center; + colliderCopy.radius = sourceCollider.radius; + colliderCopy.height = sourceCollider.height; + colliderCopy.direction = sourceCollider.direction; + colliderCopy.isTrigger = sourceCollider.isTrigger; + colliderCopy.material = sourceCollider.material; + GameObject.Destroy(sourceCollider); + } + } + + // move all MeshColliders + settings from one GameObject to another. + public static void MoveMeshColliders(GameObject source, GameObject destination) + { + // colliders may be on children + MeshCollider[] sourceColliders = source.GetComponentsInChildren(); + foreach (MeshCollider sourceCollider in sourceColliders) + { + // when Models have Mesh->Read/Write disabled, it means that Unity + // uploads the mesh directly to the GPU and erases it on the CPU. + // on some platforms this makes moving a MeshCollider in builds impossible: + // + // "CollisionMeshData couldn't be created because the mesh has been marked as non-accessible." + // + // on other platforms, this works fine. + // let's show an explicit log message so in case collisions don't + // work at runtime, it's obvious why it happens and how to fix it. + if (!sourceCollider.sharedMesh.isReadable) + { + Debug.Log($"[Prediction]: MeshCollider on {sourceCollider.name} isn't readable, which may indicate that the Mesh only exists on the GPU. If {sourceCollider.name} is missing collisions, then please select the model in the Project Area, and enable Mesh->Read/Write so it's also available on the CPU!"); + // don't early return. keep trying, it may work. + } + + // copy the relative transform: + // if collider is on root, it returns destination root. + // if collider is on a child, it creates and returns a child on destination. + GameObject target = CopyRelativeTransform(source, sourceCollider.transform, destination); + MeshCollider colliderCopy = target.AddComponent(); + colliderCopy.sharedMesh = sourceCollider.sharedMesh; + colliderCopy.convex = sourceCollider.convex; + colliderCopy.isTrigger = sourceCollider.isTrigger; + colliderCopy.material = sourceCollider.material; + GameObject.Destroy(sourceCollider); + } + } + + // move all Colliders + settings from one GameObject to another. + public static void MoveAllColliders(GameObject source, GameObject destination) + { + MoveBoxColliders(source, destination); + MoveSphereColliders(source, destination); + MoveCapsuleColliders(source, destination); + MoveMeshColliders(source, destination); + } + + // joints ////////////////////////////////////////////////////////////// + // move all CharacterJoints + settings from one GameObject to another. + public static void MoveCharacterJoints(GameObject source, GameObject destination) + { + // colliders may be on children + CharacterJoint[] sourceJoints = source.GetComponentsInChildren(); + foreach (CharacterJoint sourceJoint in sourceJoints) + { + // copy the relative transform: + // if joint is on root, it returns destination root. + // if joint is on a child, it creates and returns a child on destination. + GameObject target = CopyRelativeTransform(source, sourceJoint.transform, destination); + CharacterJoint jointCopy = target.AddComponent(); + // apply settings, in alphabetical order + jointCopy.anchor = sourceJoint.anchor; + jointCopy.autoConfigureConnectedAnchor = sourceJoint.autoConfigureConnectedAnchor; + jointCopy.axis = sourceJoint.axis; + jointCopy.breakForce = sourceJoint.breakForce; + jointCopy.breakTorque = sourceJoint.breakTorque; + jointCopy.connectedAnchor = sourceJoint.connectedAnchor; + jointCopy.connectedBody = sourceJoint.connectedBody; + jointCopy.connectedMassScale = sourceJoint.connectedMassScale; + jointCopy.enableCollision = sourceJoint.enableCollision; + jointCopy.enablePreprocessing = sourceJoint.enablePreprocessing; + jointCopy.enableProjection = sourceJoint.enableProjection; + jointCopy.highTwistLimit = sourceJoint.highTwistLimit; + jointCopy.lowTwistLimit = sourceJoint.lowTwistLimit; + jointCopy.massScale = sourceJoint.massScale; + jointCopy.projectionAngle = sourceJoint.projectionAngle; + jointCopy.projectionDistance = sourceJoint.projectionDistance; + jointCopy.swing1Limit = sourceJoint.swing1Limit; + jointCopy.swing2Limit = sourceJoint.swing2Limit; + jointCopy.swingAxis = sourceJoint.swingAxis; + jointCopy.swingLimitSpring = sourceJoint.swingLimitSpring; + jointCopy.twistLimitSpring = sourceJoint.twistLimitSpring; +#if UNITY_2020_3_OR_NEWER + jointCopy.connectedArticulationBody = sourceJoint.connectedArticulationBody; +#endif + + GameObject.Destroy(sourceJoint); + } + } + + // move all ConfigurableJoints + settings from one GameObject to another. + public static void MoveConfigurableJoints(GameObject source, GameObject destination) + { + // colliders may be on children + ConfigurableJoint[] sourceJoints = source.GetComponentsInChildren(); + foreach (ConfigurableJoint sourceJoint in sourceJoints) + { + // copy the relative transform: + // if joint is on root, it returns destination root. + // if joint is on a child, it creates and returns a child on destination. + GameObject target = CopyRelativeTransform(source, sourceJoint.transform, destination); + ConfigurableJoint jointCopy = target.AddComponent(); + // apply settings, in alphabetical order + jointCopy.anchor = sourceJoint.anchor; + jointCopy.angularXLimitSpring = sourceJoint.angularXLimitSpring; + jointCopy.angularXDrive = sourceJoint.angularXDrive; + jointCopy.angularXMotion = sourceJoint.angularXMotion; + jointCopy.angularYLimit = sourceJoint.angularYLimit; + jointCopy.angularYMotion = sourceJoint.angularYMotion; + jointCopy.angularYZDrive = sourceJoint.angularYZDrive; + jointCopy.angularYZLimitSpring = sourceJoint.angularYZLimitSpring; + jointCopy.angularZLimit = sourceJoint.angularZLimit; + jointCopy.angularZMotion = sourceJoint.angularZMotion; + jointCopy.autoConfigureConnectedAnchor = sourceJoint.autoConfigureConnectedAnchor; + jointCopy.axis = sourceJoint.axis; + jointCopy.breakForce = sourceJoint.breakForce; + jointCopy.breakTorque = sourceJoint.breakTorque; + jointCopy.configuredInWorldSpace = sourceJoint.configuredInWorldSpace; + jointCopy.connectedAnchor = sourceJoint.connectedAnchor; + jointCopy.connectedBody = sourceJoint.connectedBody; + jointCopy.connectedMassScale = sourceJoint.connectedMassScale; + jointCopy.enableCollision = sourceJoint.enableCollision; + jointCopy.enablePreprocessing = sourceJoint.enablePreprocessing; + jointCopy.highAngularXLimit = sourceJoint.highAngularXLimit; // moving this only works if the object is at initial position/rotation/scale, see PredictedRigidbody.cs + jointCopy.linearLimitSpring = sourceJoint.linearLimitSpring; + jointCopy.linearLimit = sourceJoint.linearLimit; + jointCopy.lowAngularXLimit = sourceJoint.lowAngularXLimit; // moving this only works if the object is at initial position/rotation/scale, see PredictedRigidbody.cs + jointCopy.massScale = sourceJoint.massScale; + jointCopy.projectionAngle = sourceJoint.projectionAngle; + jointCopy.projectionDistance = sourceJoint.projectionDistance; + jointCopy.projectionMode = sourceJoint.projectionMode; + jointCopy.rotationDriveMode = sourceJoint.rotationDriveMode; + jointCopy.secondaryAxis = sourceJoint.secondaryAxis; + jointCopy.slerpDrive = sourceJoint.slerpDrive; + jointCopy.swapBodies = sourceJoint.swapBodies; + jointCopy.targetAngularVelocity = sourceJoint.targetAngularVelocity; + jointCopy.targetPosition = sourceJoint.targetPosition; + jointCopy.targetRotation = sourceJoint.targetRotation; + jointCopy.targetVelocity = sourceJoint.targetVelocity; + jointCopy.xDrive = sourceJoint.xDrive; + jointCopy.xMotion = sourceJoint.xMotion; + jointCopy.yDrive = sourceJoint.yDrive; + jointCopy.yMotion = sourceJoint.yMotion; + jointCopy.zDrive = sourceJoint.zDrive; + jointCopy.zMotion = sourceJoint.zMotion; +#if UNITY_2020_3_OR_NEWER + jointCopy.connectedArticulationBody = sourceJoint.connectedArticulationBody; +#endif + + GameObject.Destroy(sourceJoint); + } + } + + // move all FixedJoints + settings from one GameObject to another. + public static void MoveFixedJoints(GameObject source, GameObject destination) + { + // colliders may be on children + FixedJoint[] sourceJoints = source.GetComponentsInChildren(); + foreach (FixedJoint sourceJoint in sourceJoints) + { + // copy the relative transform: + // if joint is on root, it returns destination root. + // if joint is on a child, it creates and returns a child on destination. + GameObject target = CopyRelativeTransform(source, sourceJoint.transform, destination); + FixedJoint jointCopy = target.AddComponent(); + // apply settings, in alphabetical order + jointCopy.anchor = sourceJoint.anchor; + jointCopy.autoConfigureConnectedAnchor = sourceJoint.autoConfigureConnectedAnchor; + jointCopy.axis = sourceJoint.axis; + jointCopy.breakForce = sourceJoint.breakForce; + jointCopy.breakTorque = sourceJoint.breakTorque; + jointCopy.connectedAnchor = sourceJoint.connectedAnchor; + jointCopy.connectedBody = sourceJoint.connectedBody; + jointCopy.connectedMassScale = sourceJoint.connectedMassScale; + jointCopy.enableCollision = sourceJoint.enableCollision; + jointCopy.enablePreprocessing = sourceJoint.enablePreprocessing; + jointCopy.massScale = sourceJoint.massScale; +#if UNITY_2020_3_OR_NEWER + jointCopy.connectedArticulationBody = sourceJoint.connectedArticulationBody; +#endif + + GameObject.Destroy(sourceJoint); + } + } + + // move all HingeJoints + settings from one GameObject to another. + public static void MoveHingeJoints(GameObject source, GameObject destination) + { + // colliders may be on children + HingeJoint[] sourceJoints = source.GetComponentsInChildren(); + foreach (HingeJoint sourceJoint in sourceJoints) + { + // copy the relative transform: + // if joint is on root, it returns destination root. + // if joint is on a child, it creates and returns a child on destination. + GameObject target = CopyRelativeTransform(source, sourceJoint.transform, destination); + HingeJoint jointCopy = target.AddComponent(); + // apply settings, in alphabetical order + jointCopy.anchor = sourceJoint.anchor; + jointCopy.autoConfigureConnectedAnchor = sourceJoint.autoConfigureConnectedAnchor; + jointCopy.axis = sourceJoint.axis; + jointCopy.breakForce = sourceJoint.breakForce; + jointCopy.breakTorque = sourceJoint.breakTorque; + jointCopy.connectedAnchor = sourceJoint.connectedAnchor; + jointCopy.connectedBody = sourceJoint.connectedBody; + jointCopy.connectedMassScale = sourceJoint.connectedMassScale; + jointCopy.enableCollision = sourceJoint.enableCollision; + jointCopy.enablePreprocessing = sourceJoint.enablePreprocessing; + jointCopy.limits = sourceJoint.limits; + jointCopy.massScale = sourceJoint.massScale; + jointCopy.motor = sourceJoint.motor; + jointCopy.spring = sourceJoint.spring; + jointCopy.useLimits = sourceJoint.useLimits; + jointCopy.useMotor = sourceJoint.useMotor; + jointCopy.useSpring = sourceJoint.useSpring; +#if UNITY_2020_3_OR_NEWER + jointCopy.connectedArticulationBody = sourceJoint.connectedArticulationBody; +#endif +#if UNITY_2022_3_OR_NEWER + jointCopy.extendedLimits = sourceJoint.extendedLimits; + jointCopy.useAcceleration = sourceJoint.useAcceleration; +#endif + + GameObject.Destroy(sourceJoint); + } + } + + // move all SpringJoints + settings from one GameObject to another. + public static void MoveSpringJoints(GameObject source, GameObject destination) + { + // colliders may be on children + SpringJoint[] sourceJoints = source.GetComponentsInChildren(); + foreach (SpringJoint sourceJoint in sourceJoints) + { + // copy the relative transform: + // if joint is on root, it returns destination root. + // if joint is on a child, it creates and returns a child on destination. + GameObject target = CopyRelativeTransform(source, sourceJoint.transform, destination); + SpringJoint jointCopy = target.AddComponent(); + // apply settings, in alphabetical order + jointCopy.anchor = sourceJoint.anchor; + jointCopy.autoConfigureConnectedAnchor = sourceJoint.autoConfigureConnectedAnchor; + jointCopy.axis = sourceJoint.axis; + jointCopy.breakForce = sourceJoint.breakForce; + jointCopy.breakTorque = sourceJoint.breakTorque; + jointCopy.connectedAnchor = sourceJoint.connectedAnchor; + jointCopy.connectedBody = sourceJoint.connectedBody; + jointCopy.connectedMassScale = sourceJoint.connectedMassScale; + jointCopy.damper = sourceJoint.damper; + jointCopy.enableCollision = sourceJoint.enableCollision; + jointCopy.enablePreprocessing = sourceJoint.enablePreprocessing; + jointCopy.massScale = sourceJoint.massScale; + jointCopy.maxDistance = sourceJoint.maxDistance; + jointCopy.minDistance = sourceJoint.minDistance; + jointCopy.spring = sourceJoint.spring; + jointCopy.tolerance = sourceJoint.tolerance; +#if UNITY_2020_3_OR_NEWER + jointCopy.connectedArticulationBody = sourceJoint.connectedArticulationBody; +#endif + + GameObject.Destroy(sourceJoint); + } + } + + // move all Joints + settings from one GameObject to another. + public static void MoveAllJoints(GameObject source, GameObject destination) + { + MoveCharacterJoints(source, destination); + MoveConfigurableJoints(source, destination); + MoveFixedJoints(source, destination); + MoveHingeJoints(source, destination); + MoveSpringJoints(source, destination); + } + + // all ///////////////////////////////////////////////////////////////// + // move all physics components from one GameObject to another. + public static void MovePhysicsComponents(GameObject source, GameObject destination) + { + // need to move joints first, otherwise we might see: + // 'can't move Rigidbody because a Joint depends on it' + MoveAllJoints(source, destination); + MoveAllColliders(source, destination); + MoveRigidbody(source, destination); + } + } +} diff --git a/Assets/Mirror/Components/PredictedRigidbody/PredictionUtils.cs.meta b/Assets/Mirror/Components/PredictedRigidbody/PredictionUtils.cs.meta new file mode 100644 index 0000000..52cc737 --- /dev/null +++ b/Assets/Mirror/Components/PredictedRigidbody/PredictionUtils.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 17cfe1beb3f94a69b94bf60afc37ef7a +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/PredictedRigidbody/RemoteGhostMaterial.mat b/Assets/Mirror/Components/PredictedRigidbody/RemoteGhostMaterial.mat new file mode 100644 index 0000000..d652a50 --- /dev/null +++ b/Assets/Mirror/Components/PredictedRigidbody/RemoteGhostMaterial.mat @@ -0,0 +1,85 @@ +%YAML 1.1 +%TAG !u! tag:unity3d.com,2011: +--- !u!21 &2100000 +Material: + serializedVersion: 8 + m_ObjectHideFlags: 0 + m_CorrespondingSourceObject: {fileID: 0} + m_PrefabInstance: {fileID: 0} + m_PrefabAsset: {fileID: 0} + m_Name: RemoteGhostMaterial + m_Shader: {fileID: 46, guid: 0000000000000000f000000000000000, type: 0} + m_Parent: {fileID: 0} + m_ModifiedSerializedProperties: 0 + m_ValidKeywords: + - _ALPHAPREMULTIPLY_ON + m_InvalidKeywords: [] + m_LightmapFlags: 4 + m_EnableInstancingVariants: 0 + m_DoubleSidedGI: 0 + m_CustomRenderQueue: 3000 + stringTagMap: + RenderType: Transparent + disabledShaderPasses: [] + m_LockedProperties: + m_SavedProperties: + serializedVersion: 3 + m_TexEnvs: + - _BumpMap: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - _DetailAlbedoMap: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - _DetailMask: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - _DetailNormalMap: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - _EmissionMap: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - _MainTex: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - _MetallicGlossMap: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - _OcclusionMap: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + - _ParallaxMap: + m_Texture: {fileID: 0} + m_Scale: {x: 1, y: 1} + m_Offset: {x: 0, y: 0} + m_Ints: [] + m_Floats: + - _BumpScale: 1 + - _Cutoff: 0.5 + - _DetailNormalMapScale: 1 + - _DstBlend: 10 + - _GlossMapScale: 1 + - _Glossiness: 0.92 + - _GlossyReflections: 1 + - _Metallic: 0 + - _Mode: 3 + - _OcclusionStrength: 1 + - _Parallax: 0.02 + - _SmoothnessTextureChannel: 0 + - _SpecularHighlights: 1 + - _SrcBlend: 1 + - _UVSec: 0 + - _ZWrite: 0 + m_Colors: + - _Color: {r: 0.09849727, g: 1, b: 0, a: 0.15686275} + - _EmissionColor: {r: 0, g: 0, b: 0, a: 1} + m_BuildTextureStacks: [] diff --git a/Assets/Mirror/Components/PredictedRigidbody/RemoteGhostMaterial.mat.meta b/Assets/Mirror/Components/PredictedRigidbody/RemoteGhostMaterial.mat.meta new file mode 100644 index 0000000..50854eb --- /dev/null +++ b/Assets/Mirror/Components/PredictedRigidbody/RemoteGhostMaterial.mat.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: 04f0b2088c857414393bab3b80356776 +NativeFormatImporter: + externalObjects: {} + mainObjectFileID: 2100000 + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/PredictedRigidbody/RigidbodyState.cs b/Assets/Mirror/Components/PredictedRigidbody/RigidbodyState.cs new file mode 100644 index 0000000..be8eaae --- /dev/null +++ b/Assets/Mirror/Components/PredictedRigidbody/RigidbodyState.cs @@ -0,0 +1,58 @@ +// PredictedRigidbody stores a history of its rigidbody states. +using UnityEngine; + +namespace Mirror +{ + public struct RigidbodyState : PredictedState + { + public double timestamp { get; private set; } + + // we want to store position delta (last + delta = current), and current. + // this way we can apply deltas on top of corrected positions to get the corrected final position. + public Vector3 positionDelta { get; set; } // delta to get from last to this position + public Vector3 position { get; set; } + + public Quaternion rotationDelta { get; set; } // delta to get from last to this rotation + public Quaternion rotation { get; set; } + + public Vector3 velocityDelta { get; set; } // delta to get from last to this velocity + public Vector3 velocity { get; set; } + + public Vector3 angularVelocityDelta { get; set; } // delta to get from last to this velocity + public Vector3 angularVelocity { get; set; } + + public RigidbodyState( + double timestamp, + Vector3 positionDelta, + Vector3 position, + Quaternion rotationDelta, + Quaternion rotation, + Vector3 velocityDelta, + Vector3 velocity, + Vector3 angularVelocityDelta, + Vector3 angularVelocity) + { + this.timestamp = timestamp; + this.positionDelta = positionDelta; + this.position = position; + this.rotationDelta = rotationDelta; + this.rotation = rotation; + this.velocityDelta = velocityDelta; + this.velocity = velocity; + this.angularVelocityDelta = angularVelocityDelta; + this.angularVelocity = angularVelocity; + } + + public static RigidbodyState Interpolate(RigidbodyState a, RigidbodyState b, float t) + { + return new RigidbodyState + { + position = Vector3.Lerp(a.position, b.position, t), + // Quaternions always need to be normalized in order to be a valid rotation after operations + rotation = Quaternion.Slerp(a.rotation, b.rotation, t).normalized, + velocity = Vector3.Lerp(a.velocity, b.velocity, t), + angularVelocity = Vector3.Lerp(a.angularVelocity, b.angularVelocity, t) + }; + } + } +} diff --git a/Assets/Mirror/Components/PredictedRigidbody/RigidbodyState.cs.meta b/Assets/Mirror/Components/PredictedRigidbody/RigidbodyState.cs.meta new file mode 100644 index 0000000..93affc5 --- /dev/null +++ b/Assets/Mirror/Components/PredictedRigidbody/RigidbodyState.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: ed0e1c0c874c4c9db6be2d5885bb7bee +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Components/RemoteStatistics.cs b/Assets/Mirror/Components/RemoteStatistics.cs new file mode 100644 index 0000000..aa18815 --- /dev/null +++ b/Assets/Mirror/Components/RemoteStatistics.cs @@ -0,0 +1,441 @@ +// remote statistics panel from Mirror II to show connections, load, etc. +// server syncs statistics to clients if authenticated. +// +// attach this to a player. +// requires NetworkStatistics component on the Network object. +// +// Unity's OnGUI is the easiest to use solution at the moment. +// * playfab is super complex to set up +// * http servers would be nice, but still need to open ports, live refresh, etc +// +// for safety reasons, let's keep this read-only. +// at least until there's safe authentication. +using System; +using System.IO; +using UnityEngine; + +namespace Mirror +{ + // server -> client + struct Stats + { + // general + public int connections; + public double uptime; + public int configuredTickRate; + public int actualTickRate; + + // traffic + public long sentBytesPerSecond; + public long receiveBytesPerSecond; + + // cpu + public float serverTickInterval; + public double fullUpdateAvg; + public double serverEarlyAvg; + public double serverLateAvg; + public double transportEarlyAvg; + public double transportLateAvg; + + // C# boilerplate + public Stats( + // general + int connections, + double uptime, + int configuredTickRate, + int actualTickRate, + // traffic + long sentBytesPerSecond, + long receiveBytesPerSecond, + // cpu + float serverTickInterval, + double fullUpdateAvg, + double serverEarlyAvg, + double serverLateAvg, + double transportEarlyAvg, + double transportLateAvg + ) + { + // general + this.connections = connections; + this.uptime = uptime; + this.configuredTickRate = configuredTickRate; + this.actualTickRate = actualTickRate; + + // traffic + this.sentBytesPerSecond = sentBytesPerSecond; + this.receiveBytesPerSecond = receiveBytesPerSecond; + + // cpu + this.serverTickInterval = serverTickInterval; + this.fullUpdateAvg = fullUpdateAvg; + this.serverEarlyAvg = serverEarlyAvg; + this.serverLateAvg = serverLateAvg; + this.transportEarlyAvg = transportEarlyAvg; + this.transportLateAvg = transportLateAvg; + } + } + + // [RequireComponent(typeof(NetworkStatistics))] <- needs to be on Network GO, not on NI + public class RemoteStatistics : NetworkBehaviour + { + // components ("fake statics" for similar API) + protected NetworkStatistics NetworkStatistics; + + // broadcast to client. + // stats are quite huge, let's only send every few seconds via TargetRpc. + // instead of sending multiple times per second via NB.OnSerialize. + [Tooltip("Send stats every 'interval' seconds to client.")] + public float sendInterval = 1; + double lastSendTime; + + [Header("GUI")] + public bool showGui; + public KeyCode hotKey = KeyCode.F11; + Rect windowRect = new Rect(0, 0, 400, 400); + + // password can't be stored in code or in Unity project. + // it would be available in clients otherwise. + // this is not perfectly secure. that's why RemoteStatistics is read-only. + [Header("Authentication")] + public string passwordFile = "remote_statistics.txt"; + protected bool serverAuthenticated; // client needs to authenticate + protected bool clientAuthenticated; // show GUI until authenticated + protected string serverPassword = null; // null means not found, auth impossible + protected string clientPassword = ""; // for GUI + + // statistics synced to client + Stats stats; + + void LoadPassword() + { + // TODO only load once, not for all players? + // let's avoid static state for now. + + // load the password + string path = Path.GetFullPath(passwordFile); + if (File.Exists(path)) + { + // don't spam the server logs for every player's loaded file + // Debug.Log($"RemoteStatistics: loading password file: {path}"); + try + { + serverPassword = File.ReadAllText(path); + } + catch (Exception exception) + { + Debug.LogWarning($"RemoteStatistics: failed to read password file: {exception}"); + } + } + else + { + Debug.LogWarning($"RemoteStatistics: password file has not been created. Authentication will be impossible. Please save the password in: {path}"); + } + } + + protected override void OnValidate() + { + base.OnValidate(); + syncMode = SyncMode.Owner; + } + + // make sure to call base function when overwriting! + // public so it can also be called from tests (and be overwritten by users) + public override void OnStartServer() + { + NetworkStatistics = NetworkManager.singleton.GetComponent(); + if (NetworkStatistics == null) throw new Exception($"RemoteStatistics requires a NetworkStatistics component on {NetworkManager.singleton.name}!"); + + // server needs to load the password + LoadPassword(); + } + + public override void OnStartLocalPlayer() + { + // center the window initially + windowRect.x = Screen.width / 2 - windowRect.width / 2; + windowRect.y = Screen.height / 2 - windowRect.height / 2; + } + + [TargetRpc] + void TargetRpcSync(Stats v) + { + // store stats and flag as authenticated + clientAuthenticated = true; + stats = v; + } + + [Command] + public void CmdAuthenticate(string v) + { + // was a valid password loaded on the server, + // and did the client send the correct one? + if (!string.IsNullOrWhiteSpace(serverPassword) && + serverPassword.Equals(v)) + { + serverAuthenticated = true; + Debug.Log($"RemoteStatistics: connectionId {connectionToClient.connectionId} authenticated with player {name}"); + } + } + + void UpdateServer() + { + // only sync if client has authenticated on the server + if (!serverAuthenticated) return; + + // NetworkTime.localTime has defines for 2019 / 2020 compatibility + if (NetworkTime.localTime >= lastSendTime + sendInterval) + { + lastSendTime = NetworkTime.localTime; + + // target rpc to owner client + TargetRpcSync(new Stats( + // general + NetworkServer.connections.Count, + NetworkTime.time, + NetworkServer.tickRate, + NetworkServer.actualTickRate, + + // traffic + NetworkStatistics.serverSentBytesPerSecond, + NetworkStatistics.serverReceivedBytesPerSecond, + + // cpu + NetworkServer.tickInterval, + NetworkServer.fullUpdateDuration.average, + NetworkServer.earlyUpdateDuration.average, + NetworkServer.lateUpdateDuration.average, + 0, // TODO ServerTransport.earlyUpdateDuration.average, + 0 // TODO ServerTransport.lateUpdateDuration.average + )); + } + } + + void UpdateClient() + { + if (Input.GetKeyDown(hotKey)) + showGui = !showGui; + } + + void Update() + { + if (isServer) UpdateServer(); + if (isLocalPlayer) UpdateClient(); + } + + void OnGUI() + { + if (!isLocalPlayer) return; + if (!showGui) return; + + windowRect = GUILayout.Window(0, windowRect, OnWindow, "Remote Statistics"); + windowRect = Utils.KeepInScreen(windowRect); + } + + // Text: value + void GUILayout_TextAndValue(string text, string value) + { + GUILayout.BeginHorizontal(); + GUILayout.Label(text); + GUILayout.FlexibleSpace(); + GUILayout.Label(value); + GUILayout.EndHorizontal(); + } + + // fake a progress bar via horizontal scroll bar with ratio as width + void GUILayout_ProgressBar(double ratio, int width) + { + // clamp ratio, otherwise >1 would make it extremely large + ratio = Mathd.Clamp01(ratio); + GUILayout.HorizontalScrollbar(0, (float)ratio, 0, 1, GUILayout.Width(width)); + } + + // need to specify progress bar & caption width, + // otherwise differently sized captions would always misalign the + // progress bars. + void GUILayout_TextAndProgressBar(string text, double ratio, int progressbarWidth, string caption, int captionWidth, Color captionColor) + { + GUILayout.BeginHorizontal(); + GUILayout.Label(text); + GUILayout.FlexibleSpace(); + GUILayout_ProgressBar(ratio, progressbarWidth); + + // coloring the caption is enough. otherwise it's too much. + GUI.color = captionColor; + GUILayout.Label(caption, GUILayout.Width(captionWidth)); + GUI.color = Color.white; + + GUILayout.EndHorizontal(); + } + + void GUI_Authenticate() + { + GUILayout.BeginVertical("Box"); // start general + GUILayout.Label("Authentication"); + + // warning if insecure connection + // if (ClientTransport.IsEncrypted()) + // { + // GUILayout.Label("Connection is encrypted!"); + // } + // else + // { + GUILayout.Label("Connection is not encrypted. Use with care!"); + // } + + // input + clientPassword = GUILayout.PasswordField(clientPassword, '*'); + + // button + GUI.enabled = !string.IsNullOrWhiteSpace(clientPassword); + if (GUILayout.Button("Authenticate")) + { + CmdAuthenticate(clientPassword); + } + GUI.enabled = true; + + GUILayout.EndVertical(); // end general + } + + void GUI_General( + int connections, + double uptime, + int configuredTickRate, + int actualTickRate) + { + GUILayout.BeginVertical("Box"); // start general + GUILayout.Label("General"); + + // connections + GUILayout_TextAndValue("Connections:", $"{connections}"); + + // uptime + GUILayout_TextAndValue("Uptime:", $"{Utils.PrettySeconds(uptime)}"); // TODO + + // tick rate + // might be lower under heavy load. + // might be higher in editor if targetFrameRate can't be set. + GUI.color = actualTickRate < configuredTickRate ? Color.red : Color.green; + GUILayout_TextAndValue("Tick Rate:", $"{actualTickRate} Hz / {configuredTickRate} Hz"); + GUI.color = Color.white; + + GUILayout.EndVertical(); // end general + } + + void GUI_Traffic( + long serverSentBytesPerSecond, + long serverReceivedBytesPerSecond) + { + GUILayout.BeginVertical("Box"); + GUILayout.Label("Network"); + + GUILayout_TextAndValue("Outgoing:", $"{Utils.PrettyBytes(serverSentBytesPerSecond) }/s"); + GUILayout_TextAndValue("Incoming:", $"{Utils.PrettyBytes(serverReceivedBytesPerSecond)}/s"); + + GUILayout.EndVertical(); + } + + void GUI_Cpu( + float serverTickInterval, + double fullUpdateAvg, + double serverEarlyAvg, + double serverLateAvg, + double transportEarlyAvg, + double transportLateAvg) + { + const int barWidth = 120; + const int captionWidth = 90; + + GUILayout.BeginVertical("Box"); + GUILayout.Label("CPU"); + + // unity update + // happens every 'tickInterval'. progress bar shows it in relation. + // <= 90% load is green, otherwise red + double fullRatio = fullUpdateAvg / serverTickInterval; + GUILayout_TextAndProgressBar( + "World Update Avg:", + fullRatio, + barWidth, $"{fullUpdateAvg * 1000:F1} ms", + captionWidth, + fullRatio <= 0.9 ? Color.green : Color.red); + + // server update + // happens every 'tickInterval'. progress bar shows it in relation. + // <= 90% load is green, otherwise red + double serverRatio = (serverEarlyAvg + serverLateAvg) / serverTickInterval; + GUILayout_TextAndProgressBar( + "Server Update Avg:", + serverRatio, + barWidth, $"{serverEarlyAvg * 1000:F1} + {serverLateAvg * 1000:F1} ms", + captionWidth, + serverRatio <= 0.9 ? Color.green : Color.red); + + // transport: early + late update milliseconds. + // for threaded transport, this is the thread's update time. + // happens every 'tickInterval'. progress bar shows it in relation. + // <= 90% load is green, otherwise red + // double transportRatio = (transportEarlyAvg + transportLateAvg) / serverTickInterval; + // GUILayout_TextAndProgressBar( + // "Transport Avg:", + // transportRatio, + // barWidth, + // $"{transportEarlyAvg * 1000:F1} + {transportLateAvg * 1000:F1} ms", + // captionWidth, + // transportRatio <= 0.9 ? Color.green : Color.red); + + GUILayout.EndVertical(); + } + + void GUI_Notice() + { + // for security reasons, let's keep this read-only for now. + + // single line keeps input & visuals simple + // GUILayout.BeginVertical("Box"); + // GUILayout.Label("Global Notice"); + // notice = GUILayout.TextField(notice); + // if (GUILayout.Button("Send")) + // { + // // TODO + // } + // GUILayout.EndVertical(); + } + + void OnWindow(int windowID) + { + if (!clientAuthenticated) + { + GUI_Authenticate(); + } + else + { + GUI_General( + stats.connections, + stats.uptime, + stats.configuredTickRate, + stats.actualTickRate + ); + + GUI_Traffic( + stats.sentBytesPerSecond, + stats.receiveBytesPerSecond + ); + + GUI_Cpu( + stats.serverTickInterval, + stats.fullUpdateAvg, + stats.serverEarlyAvg, + stats.serverLateAvg, + stats.transportEarlyAvg, + stats.transportLateAvg + ); + + GUI_Notice(); + } + + // dragable window in any case + GUI.DragWindow(new Rect(0, 0, 10000, 10000)); + } + } +} diff --git a/Assets/Mirror/Components/RemoteStatistics.cs.meta b/Assets/Mirror/Components/RemoteStatistics.cs.meta new file mode 100644 index 0000000..4c4d043 --- /dev/null +++ b/Assets/Mirror/Components/RemoteStatistics.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: ba360e4ff6b44fc6898f56322b90c6c8 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core.meta b/Assets/Mirror/Core.meta new file mode 100644 index 0000000..85ee3eb --- /dev/null +++ b/Assets/Mirror/Core.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: 9f4328ccc5f724e45afe2215d275b5d5 +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/AssemblyInfo.cs b/Assets/Mirror/Core/AssemblyInfo.cs new file mode 100644 index 0000000..f342716 --- /dev/null +++ b/Assets/Mirror/Core/AssemblyInfo.cs @@ -0,0 +1,12 @@ +using System.Runtime.CompilerServices; + +[assembly: InternalsVisibleTo("Mirror.Tests.Common")] +[assembly: InternalsVisibleTo("Mirror.Tests")] +// need to use Unity.*.CodeGen assembly name to import Unity.CompilationPipeline +// for ILPostProcessor tests. +[assembly: InternalsVisibleTo("Unity.Mirror.Tests.CodeGen")] +[assembly: InternalsVisibleTo("Mirror.Tests.Generated")] +[assembly: InternalsVisibleTo("Mirror.Tests.Runtime")] +[assembly: InternalsVisibleTo("Mirror.Tests.Performance.Editor")] +[assembly: InternalsVisibleTo("Mirror.Tests.Performance.Runtime")] +[assembly: InternalsVisibleTo("Mirror.Editor")] diff --git a/Assets/Mirror/Core/AssemblyInfo.cs.meta b/Assets/Mirror/Core/AssemblyInfo.cs.meta new file mode 100644 index 0000000..50cc028 --- /dev/null +++ b/Assets/Mirror/Core/AssemblyInfo.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: e28d5f410e25b42e6a76a2ffc10e4675 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/Attributes.cs b/Assets/Mirror/Core/Attributes.cs new file mode 100644 index 0000000..df8236a --- /dev/null +++ b/Assets/Mirror/Core/Attributes.cs @@ -0,0 +1,91 @@ +using System; +using UnityEngine; + +namespace Mirror +{ + /// + /// SyncVars are used to synchronize a variable from the server to all clients automatically. + /// Value must be changed on server, not directly by clients. Hook parameter allows you to define a client-side method to be invoked when the client gets an update from the server. + /// + [AttributeUsage(AttributeTargets.Field)] + public class SyncVarAttribute : PropertyAttribute + { + public string hook; + } + + /// + /// Call this from a client to run this function on the server. + /// Make sure to validate input etc. It's not possible to call this from a server. + /// + [AttributeUsage(AttributeTargets.Method)] + public class CommandAttribute : Attribute + { + public int channel = Channels.Reliable; + public bool requiresAuthority = true; + } + + /// + /// The server uses a Remote Procedure Call (RPC) to run this function on clients. + /// + [AttributeUsage(AttributeTargets.Method)] + public class ClientRpcAttribute : Attribute + { + public int channel = Channels.Reliable; + public bool includeOwner = true; + } + + /// + /// The server uses a Remote Procedure Call (RPC) to run this function on a specific client. + /// + [AttributeUsage(AttributeTargets.Method)] + public class TargetRpcAttribute : Attribute + { + public int channel = Channels.Reliable; + } + + /// + /// Prevents clients from running this method. + /// Prints a warning if a client tries to execute this method. + /// + [AttributeUsage(AttributeTargets.Method)] + public class ServerAttribute : Attribute {} + + /// + /// Prevents clients from running this method. + /// No warning is thrown. + /// + [AttributeUsage(AttributeTargets.Method)] + public class ServerCallbackAttribute : Attribute {} + + /// + /// Prevents the server from running this method. + /// Prints a warning if the server tries to execute this method. + /// + [AttributeUsage(AttributeTargets.Method)] + public class ClientAttribute : Attribute {} + + /// + /// Prevents the server from running this method. + /// No warning is printed. + /// + [AttributeUsage(AttributeTargets.Method)] + public class ClientCallbackAttribute : Attribute {} + + /// + /// Converts a string property into a Scene property in the inspector + /// + public class SceneAttribute : PropertyAttribute {} + + /// + /// Used to show private SyncList in the inspector, + /// Use instead of SerializeField for non Serializable types + /// + [AttributeUsage(AttributeTargets.Field)] + public class ShowInInspectorAttribute : Attribute {} + + /// + /// Used to make a field readonly in the inspector + /// + [AttributeUsage(AttributeTargets.Field)] + public class ReadOnlyAttribute : PropertyAttribute {} +} diff --git a/Assets/Mirror/Core/Attributes.cs.meta b/Assets/Mirror/Core/Attributes.cs.meta new file mode 100644 index 0000000..c50a489 --- /dev/null +++ b/Assets/Mirror/Core/Attributes.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: c04c722ee2ffd49c8a56ab33667b10b0 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/Batching.meta b/Assets/Mirror/Core/Batching.meta new file mode 100644 index 0000000..bf23600 --- /dev/null +++ b/Assets/Mirror/Core/Batching.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: 1c38e1bebe9947f8b842a8a57aa2b71c +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/Batching/Batcher.cs b/Assets/Mirror/Core/Batching/Batcher.cs new file mode 100644 index 0000000..5e30f08 --- /dev/null +++ b/Assets/Mirror/Core/Batching/Batcher.cs @@ -0,0 +1,150 @@ +// batching functionality encapsulated into one class. +// -> less complexity +// -> easy to test +// +// IMPORTANT: we use THRESHOLD batching, not MAXED SIZE batching. +// see threshold comments below. +// +// includes timestamp for tick batching. +// -> allows NetworkTransform etc. to use timestamp without including it in +// every single message +using System; +using System.Collections.Generic; + +namespace Mirror +{ + public class Batcher + { + // batching threshold instead of max size. + // -> small messages are fit into threshold sized batches + // -> messages larger than threshold are single batches + // + // in other words, we fit up to 'threshold' but still allow larger ones + // for two reasons: + // 1.) data races: skipping batching for larger messages would send a + // large spawn message immediately, while others are batched and + // only flushed at the end of the frame + // 2) timestamp batching: if each batch is expected to contain a + // timestamp, then large messages have to be a batch too. otherwise + // they would not contain a timestamp + readonly int threshold; + + // TimeStamp header size. each batch has one. + public const int TimestampSize = sizeof(double); + + // Message header size. each message has one. + public static int MessageHeaderSize(int messageSize) => + Compression.VarUIntSize((ulong)messageSize); + + // maximum overhead for a single message. + // useful for the outside to calculate max message sizes. + public static int MaxMessageOverhead(int messageSize) => + TimestampSize + MessageHeaderSize(messageSize); + + // full batches ready to be sent. + // DO NOT queue NetworkMessage, it would box. + // DO NOT queue each serialization separately. + // it would allocate too many writers. + // https://github.com/vis2k/Mirror/pull/3127 + // => best to build batches on the fly. + readonly Queue batches = new Queue(); + + // current batch in progress + NetworkWriterPooled batch; + + public Batcher(int threshold) + { + this.threshold = threshold; + } + + // add a message for batching + // we allow any sized messages. + // caller needs to make sure they are within max packet size. + public void AddMessage(ArraySegment message, double timeStamp) + { + // predict the needed size, which is varint(size) + content + int headerSize = Compression.VarUIntSize((ulong)message.Count); + int neededSize = headerSize + message.Count; + + // when appending to a batch in progress, check final size. + // if it expands beyond threshold, then we should finalize it first. + // => less than or exactly threshold is fine. + // GetBatch() will finalize it. + // => see unit tests. + if (batch != null && + batch.Position + neededSize > threshold) + { + batches.Enqueue(batch); + batch = null; + } + + // initialize a new batch if necessary + if (batch == null) + { + // borrow from pool. we return it in GetBatch. + batch = NetworkWriterPool.Get(); + + // write timestamp first. + // -> double precision for accuracy over long periods of time + // -> batches are per-frame, it doesn't matter which message's + // timestamp we use. + batch.WriteDouble(timeStamp); + } + + // add serialization to current batch. even if > threshold. + // -> we do allow > threshold sized messages as single batch + // -> WriteBytes instead of WriteSegment because the latter + // would add a size header. we want to write directly. + // + // include size prefix as varint! + // -> fixes NetworkMessage serialization mismatch corrupting the + // next message in a batch. + // -> a _lot_ of time was wasted debugging corrupt batches. + // no easy way to figure out which NetworkMessage has a mismatch. + // -> this is worth everyone's sanity. + // -> varint means we prefix with 1 byte most of the time. + // -> the same issue in NetworkIdentity was why Mirror started! + Compression.CompressVarUInt(batch, (ulong)message.Count); + batch.WriteBytes(message.Array, message.Offset, message.Count); + } + + // helper function to copy a batch to writer and return it to pool + static void CopyAndReturn(NetworkWriterPooled batch, NetworkWriter writer) + { + // make sure the writer is fresh to avoid uncertain situations + if (writer.Position != 0) + throw new ArgumentException($"GetBatch needs a fresh writer!"); + + // copy to the target writer + ArraySegment segment = batch.ToArraySegment(); + writer.WriteBytes(segment.Array, segment.Offset, segment.Count); + + // return batch to pool for reuse + NetworkWriterPool.Return(batch); + } + + // get the next batch which is available for sending (if any). + // TODO safely get & return a batch instead of copying to writer? + // TODO could return pooled writer & use GetBatch in a 'using' statement! + public bool GetBatch(NetworkWriter writer) + { + // get first batch from queue (if any) + if (batches.TryDequeue(out NetworkWriterPooled first)) + { + CopyAndReturn(first, writer); + return true; + } + + // if queue was empty, we can send the batch in progress. + if (batch != null) + { + CopyAndReturn(batch, writer); + batch = null; + return true; + } + + // nothing was written + return false; + } + } +} diff --git a/Assets/Mirror/Core/Batching/Batcher.cs.meta b/Assets/Mirror/Core/Batching/Batcher.cs.meta new file mode 100644 index 0000000..a774908 --- /dev/null +++ b/Assets/Mirror/Core/Batching/Batcher.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 0afaaa611a2142d48a07bdd03b68b2b3 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/Batching/Unbatcher.cs b/Assets/Mirror/Core/Batching/Unbatcher.cs new file mode 100644 index 0000000..6b2c405 --- /dev/null +++ b/Assets/Mirror/Core/Batching/Unbatcher.cs @@ -0,0 +1,129 @@ +// un-batching functionality encapsulated into one class. +// -> less complexity +// -> easy to test +// +// includes timestamp for tick batching. +// -> allows NetworkTransform etc. to use timestamp without including it in +// every single message +using System; +using System.Collections.Generic; + +namespace Mirror +{ + public class Unbatcher + { + // supporting adding multiple batches before GetNextMessage is called. + // just in case. + readonly Queue batches = new Queue(); + + public int BatchesCount => batches.Count; + + // NetworkReader is only created once, + // then pointed to the first batch. + readonly NetworkReader reader = new NetworkReader(new byte[0]); + + // timestamp that was written into the batch remotely. + // for the batch that our reader is currently pointed at. + double readerRemoteTimeStamp; + + // helper function to start reading a batch. + void StartReadingBatch(NetworkWriterPooled batch) + { + // point reader to it + reader.SetBuffer(batch.ToArraySegment()); + + // read remote timestamp (double) + // -> AddBatch quarantees that we have at least 8 bytes to read + readerRemoteTimeStamp = reader.ReadDouble(); + } + + // add a new batch. + // returns true if valid. + // returns false if not, in which case the connection should be disconnected. + public bool AddBatch(ArraySegment batch) + { + // IMPORTANT: ArraySegment is only valid until returning. we copy it! + // + // NOTE: it's not possible to create empty ArraySegments, so we + // don't need to check against that. + + // make sure we have at least 8 bytes to read for tick timestamp + if (batch.Count < Batcher.TimestampSize) + return false; + + // put into a (pooled) writer + // -> WriteBytes instead of WriteSegment because the latter + // would add a size header. we want to write directly. + // -> will be returned to pool when sending! + NetworkWriterPooled writer = NetworkWriterPool.Get(); + writer.WriteBytes(batch.Array, batch.Offset, batch.Count); + + // first batch? then point reader there + if (batches.Count == 0) + StartReadingBatch(writer); + + // add batch + batches.Enqueue(writer); + //Debug.Log($"Adding Batch {BitConverter.ToString(batch.Array, batch.Offset, batch.Count)} => batches={batches.Count} reader={reader}"); + return true; + } + + // get next message, unpacked from batch (if any) + // message ArraySegment is only valid until the next call. + // timestamp is the REMOTE time when the batch was created remotely. + public bool GetNextMessage(out ArraySegment message, out double remoteTimeStamp) + { + message = default; + remoteTimeStamp = 0; + + // do nothing if we don't have any batches. + // otherwise the below queue.Dequeue() would throw an + // InvalidOperationException if operating on empty queue. + if (batches.Count == 0) + return false; + + // was our reader pointed to anything yet? + if (reader.Capacity == 0) + return false; + + // no more data to read? + if (reader.Remaining == 0) + { + // retire the batch + NetworkWriterPooled writer = batches.Dequeue(); + NetworkWriterPool.Return(writer); + + // do we have another batch? + if (batches.Count > 0) + { + // point reader to the next batch. + // we'll return the reader below. + NetworkWriterPooled next = batches.Peek(); + StartReadingBatch(next); + } + // otherwise there's nothing more to read + else return false; + } + + // use the current batch's remote timestamp + // AFTER potentially moving to the next batch ABOVE! + remoteTimeStamp = readerRemoteTimeStamp; + + // enough data to read the size prefix? + if (reader.Remaining == 0) + return false; + + // read the size prefix as varint + // see Batcher.AddMessage comments for explanation. + int size = (int)Compression.DecompressVarUInt(reader); + + // validate size prefix, in case attackers send malicious data + if (reader.Remaining < size) + return false; + + // return the message of size + message = reader.ReadBytesSegment(size); + return true; + } + } +} diff --git a/Assets/Mirror/Core/Batching/Unbatcher.cs.meta b/Assets/Mirror/Core/Batching/Unbatcher.cs.meta new file mode 100644 index 0000000..26038b0 --- /dev/null +++ b/Assets/Mirror/Core/Batching/Unbatcher.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 328562d71e1c45c58581b958845aa7a4 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/ConnectionQuality.cs b/Assets/Mirror/Core/ConnectionQuality.cs new file mode 100644 index 0000000..ee0720a --- /dev/null +++ b/Assets/Mirror/Core/ConnectionQuality.cs @@ -0,0 +1,74 @@ +// standalone, Unity-independent connection-quality algorithm & enum. +// don't need to use this directly, it's built into Mirror's NetworkClient. +using UnityEngine; + +namespace Mirror +{ + public enum ConnectionQuality : byte + { + ESTIMATING, // still estimating + POOR, // unplayable + FAIR, // very noticeable latency, not very enjoyable anymore + GOOD, // very playable for everyone but high level competitors + EXCELLENT // ideal experience for high level competitors + } + + public enum ConnectionQualityMethod : byte + { + Simple, // simple estimation based on rtt and jitter + Pragmatic // based on snapshot interpolation adjustment + } + + // provide different heuristics for users to choose from. + // simple heuristics to get started. + // this will be iterated on over time based on user feedback. + public static class ConnectionQualityHeuristics + { + // convenience extension to color code Connection Quality + public static Color ColorCode(this ConnectionQuality quality) + { + switch (quality) + { + case ConnectionQuality.POOR: return Color.red; + case ConnectionQuality.FAIR: return new Color(1.0f, 0.647f, 0.0f); + case ConnectionQuality.GOOD: return Color.yellow; + case ConnectionQuality.EXCELLENT: return Color.green; + default: return Color.gray; // ESTIMATING + } + } + + // straight forward estimation + // rtt: average round trip time in seconds. + // jitter: average latency variance. + public static ConnectionQuality Simple(double rtt, double jitter) + { + if (rtt <= 0.100 && jitter <= 0.10) return ConnectionQuality.EXCELLENT; + if (rtt <= 0.200 && jitter <= 0.20) return ConnectionQuality.GOOD; + if (rtt <= 0.400 && jitter <= 0.50) return ConnectionQuality.FAIR; + return ConnectionQuality.POOR; + } + + // snapshot interpolation based estimation. + // snap. interp. adjusts buffer time based on connection quality. + // based on this, we can measure how far away we are from the ideal. + // the returned quality will always directly correlate with gameplay. + // => requires SnapshotInterpolation dynamicAdjustment to be enabled! + public static ConnectionQuality Pragmatic(double targetBufferTime, double currentBufferTime) + { + // buffer time is set by the game developer. + // estimating in multiples is a great way to be game independent. + // for example, a fast paced shooter and a slow paced RTS will both + // have poor connection if the multiplier is >10. + double multiplier = currentBufferTime / targetBufferTime; + + // empirically measured with Tanks demo + LatencySimulation. + // it's not obvious to estimate on paper. + if (multiplier <= 1.15) return ConnectionQuality.EXCELLENT; + if (multiplier <= 1.25) return ConnectionQuality.GOOD; + if (multiplier <= 1.50) return ConnectionQuality.FAIR; + + // anything else is poor + return ConnectionQuality.POOR; + } + } +} diff --git a/Assets/Mirror/Core/ConnectionQuality.cs.meta b/Assets/Mirror/Core/ConnectionQuality.cs.meta new file mode 100644 index 0000000..1712ffe --- /dev/null +++ b/Assets/Mirror/Core/ConnectionQuality.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: ff663b880e33e4606b545c8b497041c2 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/HostMode.cs b/Assets/Mirror/Core/HostMode.cs new file mode 100644 index 0000000..3054b3c --- /dev/null +++ b/Assets/Mirror/Core/HostMode.cs @@ -0,0 +1,44 @@ +// host mode related helper functions. +// usually they set up both server & client. +// it's cleaner to keep them in one place, instead of only in server / client. +using System; + +namespace Mirror +{ + public static class HostMode + { + // keep the local connections setup in one function. + // makes host setup easier to follow. + internal static void SetupConnections() + { + // create local connections pair, both are connected + Utils.CreateLocalConnections( + out LocalConnectionToClient connectionToClient, + out LocalConnectionToServer connectionToServer); + + // set client connection + NetworkClient.connection = connectionToServer; + + // set server connection + NetworkServer.SetLocalConnection(connectionToClient); + } + + // call OnConnected on server & client. + // public because NetworkClient.ConnectLocalServer was public before too. + public static void InvokeOnConnected() + { + // call server OnConnected with server's connection to client + NetworkServer.OnConnected(NetworkServer.localConnection); + + // call client OnConnected with client's connection to server + // => previously we used to send a ConnectMessage to + // NetworkServer.localConnection. this would queue the message + // until NetworkClient.Update processes it. + // => invoking the client's OnConnected event directly here makes + // tests fail. so let's do it exactly the same order as before by + // queueing the event for next Update! + //OnConnectedEvent?.Invoke(connection); + ((LocalConnectionToServer)NetworkClient.connection).QueueConnectedEvent(); + } + } +} diff --git a/Assets/Mirror/Core/HostMode.cs.meta b/Assets/Mirror/Core/HostMode.cs.meta new file mode 100644 index 0000000..bf6faed --- /dev/null +++ b/Assets/Mirror/Core/HostMode.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: d27175a08d5341fc97645b49ee533d5a +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/InterestManagement.cs b/Assets/Mirror/Core/InterestManagement.cs new file mode 100644 index 0000000..88ead0f --- /dev/null +++ b/Assets/Mirror/Core/InterestManagement.cs @@ -0,0 +1,146 @@ +// interest management component for custom solutions like +// distance based, spatial hashing, raycast based, etc. + +using System.Collections.Generic; +using UnityEngine; + +namespace Mirror +{ + [DisallowMultipleComponent] + [HelpURL("https://mirror-networking.gitbook.io/docs/guides/interest-management")] + public abstract class InterestManagement : InterestManagementBase + { + // allocate newObservers helper HashSet + readonly HashSet newObservers = + new HashSet(); + + // rebuild observers for the given NetworkIdentity. + // Server will automatically spawn/despawn added/removed ones. + // newObservers: cached hashset to put the result into + // initialize: true if being rebuilt for the first time + // + // IMPORTANT: + // => global rebuild would be more simple, BUT + // => local rebuild is way faster for spawn/despawn because we can + // simply rebuild a select NetworkIdentity only + // => having both .observers and .observing is necessary for local + // rebuilds + // + // in other words, this is the perfect solution even though it's not + // completely simple (due to .observers & .observing). + // + // Mirror maintains .observing automatically in the background. best of + // both worlds without any worrying now! + public abstract void OnRebuildObservers(NetworkIdentity identity, HashSet newObservers); + + // helper function to trigger a full rebuild. + // most implementations should call this in a certain interval. + // some might call this all the time, or only on team changes or + // scene changes and so on. + // + // IMPORTANT: check if NetworkServer.active when using Update()! + [ServerCallback] + protected void RebuildAll() + { + foreach (NetworkIdentity identity in NetworkServer.spawned.Values) + { + NetworkServer.RebuildObservers(identity, false); + } + } + + public override void Rebuild(NetworkIdentity identity, bool initialize) + { + // clear newObservers hashset before using it + newObservers.Clear(); + + // not force hidden? + if (identity.visibility != Visibility.ForceHidden) + { + OnRebuildObservers(identity, newObservers); + } + + // IMPORTANT: AFTER rebuilding add own player connection in any case + // to ensure player always sees himself no matter what. + // -> OnRebuildObservers might clear observers, so we need to add + // the player's own connection AFTER. 100% fail safe. + // -> fixes https://github.com/vis2k/Mirror/issues/692 where a + // player might teleport out of the ProximityChecker's cast, + // losing the own connection as observer. + if (identity.connectionToClient != null) + { + newObservers.Add(identity.connectionToClient); + } + + bool changed = false; + + // add all newObservers that aren't in .observers yet + foreach (NetworkConnectionToClient conn in newObservers) + { + // only add ready connections. + // otherwise the player might not be in the world yet or anymore + if (conn != null && conn.isReady) + { + if (initialize || !identity.observers.ContainsKey(conn.connectionId)) + { + // new observer + conn.AddToObserving(identity); + // Debug.Log($"New Observer for {gameObject} {conn}"); + changed = true; + } + } + } + + // remove all old .observers that aren't in newObservers anymore + foreach (NetworkConnectionToClient conn in identity.observers.Values) + { + if (!newObservers.Contains(conn)) + { + // removed observer + conn.RemoveFromObserving(identity, false); + // Debug.Log($"Removed Observer for {gameObject} {conn}"); + changed = true; + } + } + + // copy new observers to observers + if (changed) + { + identity.observers.Clear(); + foreach (NetworkConnectionToClient conn in newObservers) + { + if (conn != null && conn.isReady) + identity.observers.Add(conn.connectionId, conn); + } + } + + // special case for host mode: we use SetHostVisibility to hide + // NetworkIdentities that aren't in observer range from host. + // this is what games like Dota/Counter-Strike do too, where a host + // does NOT see all players by default. they are in memory, but + // hidden to the host player. + // + // this code is from UNET, it's a bit strange but it works: + // * it hides newly connected identities in host mode + // => that part was the intended behaviour + // * it hides ALL NetworkIdentities in host mode when the host + // connects but hasn't selected a character yet + // => this only works because we have no .localConnection != null + // check. at this stage, localConnection is null because + // StartHost starts the server first, then calls this code, + // then starts the client and sets .localConnection. so we can + // NOT add a null check without breaking host visibility here. + // * it hides ALL NetworkIdentities in server-only mode because + // observers never contain the 'null' .localConnection + // => that was not intended, but let's keep it as it is so we + // don't break anything in host mode. it's way easier than + // iterating all identities in a special function in StartHost. + if (initialize) + { + if (!newObservers.Contains(NetworkServer.localConnection)) + { + SetHostVisibility(identity, false); + } + } + } + } +} diff --git a/Assets/Mirror/Core/InterestManagement.cs.meta b/Assets/Mirror/Core/InterestManagement.cs.meta new file mode 100644 index 0000000..bfabf6b --- /dev/null +++ b/Assets/Mirror/Core/InterestManagement.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 41d809934003479f97e992eebb7ed6af +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/InterestManagementBase.cs b/Assets/Mirror/Core/InterestManagementBase.cs new file mode 100644 index 0000000..ec60d64 --- /dev/null +++ b/Assets/Mirror/Core/InterestManagementBase.cs @@ -0,0 +1,77 @@ +// interest management component for custom solutions like +// distance based, spatial hashing, raycast based, etc. +// low level base class allows for low level spatial hashing etc., which is 3-5x faster. +using UnityEngine; + +namespace Mirror +{ + [DisallowMultipleComponent] + [HelpURL("https://mirror-networking.gitbook.io/docs/guides/interest-management")] + public abstract class InterestManagementBase : MonoBehaviour + { + // initialize NetworkServer/Client .aoi. + // previously we did this in Awake(), but that's called for disabled + // components too. if we do it OnEnable(), then it's not set for + // disabled components. + protected virtual void OnEnable() + { + // do not check if == null or error if already set. + // users may enabled/disable components randomly, + // causing this to be called multiple times. + NetworkServer.aoi = this; + NetworkClient.aoi = this; + } + + [ServerCallback] + public virtual void ResetState() {} + + // Callback used by the visibility system to determine if an observer + // (player) can see the NetworkIdentity. If this function returns true, + // the network connection will be added as an observer. + // conn: Network connection of a player. + // returns True if the player can see this object. + public abstract bool OnCheckObserver(NetworkIdentity identity, NetworkConnectionToClient newObserver); + + + // Callback used by the visibility system for objects on a host. + // Objects on a host (with a local client) cannot be disabled or + // destroyed when they are not visible to the local client. So this + // function is called to allow custom code to hide these objects. A + // typical implementation will disable renderer components on the + // object. This is only called on local clients on a host. + // => need the function in here and virtual so people can overwrite! + // => not everyone wants to hide renderers! + [ServerCallback] + public virtual void SetHostVisibility(NetworkIdentity identity, bool visible) + { + foreach (Renderer rend in identity.GetComponentsInChildren()) + rend.enabled = visible; + } + + /// Called on the server when a new networked object is spawned. + // (useful for 'only rebuild if changed' interest management algorithms) + [ServerCallback] + public virtual void OnSpawned(NetworkIdentity identity) {} + + /// Called on the server when a networked object is destroyed. + // (useful for 'only rebuild if changed' interest management algorithms) + [ServerCallback] + public virtual void OnDestroyed(NetworkIdentity identity) {} + + public abstract void Rebuild(NetworkIdentity identity, bool initialize); + + /// Adds the specified connection to the observers of identity + protected void AddObserver(NetworkConnectionToClient connection, NetworkIdentity identity) + { + connection.AddToObserving(identity); + identity.observers.Add(connection.connectionId, connection); + } + + /// Removes the specified connection from the observers of identity + protected void RemoveObserver(NetworkConnectionToClient connection, NetworkIdentity identity) + { + connection.RemoveFromObserving(identity, false); + identity.observers.Remove(connection.connectionId); + } + } +} diff --git a/Assets/Mirror/Core/InterestManagementBase.cs.meta b/Assets/Mirror/Core/InterestManagementBase.cs.meta new file mode 100644 index 0000000..b2b5ad6 --- /dev/null +++ b/Assets/Mirror/Core/InterestManagementBase.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 18bd2ffe65a444f3b13d59bdac7f2228 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/LagCompensation.meta b/Assets/Mirror/Core/LagCompensation.meta new file mode 100644 index 0000000..b5583ef --- /dev/null +++ b/Assets/Mirror/Core/LagCompensation.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: d2656015ded44e83a24f4c4776bafd40 +timeCreated: 1687920405 \ No newline at end of file diff --git a/Assets/Mirror/Core/LagCompensation/Capture.cs b/Assets/Mirror/Core/LagCompensation/Capture.cs new file mode 100644 index 0000000..e4fdabe --- /dev/null +++ b/Assets/Mirror/Core/LagCompensation/Capture.cs @@ -0,0 +1,13 @@ +namespace Mirror +{ + public interface Capture + { + // server timestamp at time of capture. + double timestamp { get; set; } + + // optional gizmo drawing for visual debugging. + // history is only known on the server, which usually doesn't render. + // showing Gizmos in the Editor is enough. + void DrawGizmo(); + } +} diff --git a/Assets/Mirror/Core/LagCompensation/Capture.cs.meta b/Assets/Mirror/Core/LagCompensation/Capture.cs.meta new file mode 100644 index 0000000..d78c49f --- /dev/null +++ b/Assets/Mirror/Core/LagCompensation/Capture.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 347e831952e943a49095cadd39a5aeb2 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/LagCompensation/HistoryBounds.cs b/Assets/Mirror/Core/LagCompensation/HistoryBounds.cs new file mode 100644 index 0000000..29ebc2e --- /dev/null +++ b/Assets/Mirror/Core/LagCompensation/HistoryBounds.cs @@ -0,0 +1,139 @@ +// HistoryBounds keeps a bounding box of all the object's bounds in the past N seconds. +// useful to decide which objects to rollback, instead of rolling back all of them. +// https://www.youtube.com/watch?v=zrIY0eIyqmI (37:00) +// standalone C# implementation to be engine (and language) agnostic. + +using System.Collections.Generic; +using UnityEngine; + +namespace Mirror +{ + // FakeByte: gather bounds in smaller buckets. + // for example, bucket(t0,t1,t2), bucket(t3,t4,t5), ... + // instead of removing old bounds t0, t1, ... + // we remove a whole bucket every 3 times: bucket(t0,t1,t2) + // and when building total bounds, we encapsulate a few larger buckets + // instead of many smaller bounds. + // + // => a bucket is encapsulate(bounds0, bounds1, bounds2) so we don't + // need a custom struct, simply reuse bounds but remember that each + // entry includes N timestamps. + // + // => note that simply reducing capture interval is _not_ the same. + // we want to capture in detail in case players run in zig-zag. + // but still grow larger buckets internally. + public class HistoryBounds + { + // mischa: use MinMaxBounds to avoid Unity Bounds.Encapsulate conversions. + readonly int boundsPerBucket; + readonly Queue fullBuckets; + + // full bucket limit. older ones will be removed. + readonly int bucketLimit; + + // bucket in progress, contains 0..boundsPerBucket bounds encapsulated. + MinMaxBounds? currentBucket; + int currentBucketSize; + + // amount of total bounds, including bounds in full buckets + current + public int boundsCount { get; private set; } + + // total bounds encapsulating all of the bounds history. + // totalMinMax is used for internal calculations. + // public total is used for Unity representation. + MinMaxBounds totalMinMax; + public Bounds total + { + get + { + Bounds bounds = new Bounds(); + bounds.SetMinMax(totalMinMax.min, totalMinMax.max); + return bounds; + } + } + + public HistoryBounds(int boundsLimit, int boundsPerBucket) + { + // bucketLimit via '/' cuts off remainder. + // that's what we want, since we always have a 'currentBucket'. + this.boundsPerBucket = boundsPerBucket; + this.bucketLimit = (boundsLimit / boundsPerBucket); + + // initialize queue with maximum capacity to avoid runtime resizing + // capacity +1 because it makes the code easier if we insert first, and then remove. + fullBuckets = new Queue(bucketLimit + 1); + } + + // insert new bounds into history. calculates new total bounds. + // Queue.Dequeue() always has the oldest bounds. + public void Insert(Bounds bounds) + { + // convert to MinMax representation for faster .Encapsulate() + MinMaxBounds minmax = new MinMaxBounds + { + min = bounds.min, + max = bounds.max + }; + + // initialize 'total' if not initialized yet. + // we don't want to call (0,0).Encapsulate(bounds). + if (boundsCount == 0) + { + totalMinMax = minmax; + } + + // add to current bucket: + // either initialize new one, or encapsulate into existing one + if (currentBucket == null) + { + currentBucket = minmax; + } + else + { + currentBucket.Value.Encapsulate(minmax); + } + + // current bucket has one more bounds. + // total bounds increased as well. + currentBucketSize += 1; + boundsCount += 1; + + // always encapsulate into total immediately. + // this is free. + totalMinMax.Encapsulate(minmax); + + // current bucket full? + if (currentBucketSize == boundsPerBucket) + { + // move it to full buckets + fullBuckets.Enqueue(currentBucket.Value); + currentBucket = null; + currentBucketSize = 0; + + // full bucket capacity reached? + if (fullBuckets.Count > bucketLimit) + { + // remove oldest bucket + fullBuckets.Dequeue(); + boundsCount -= boundsPerBucket; + + // recompute total bounds + // instead of iterating N buckets, we iterate N / boundsPerBucket buckets. + // TODO technically we could reuse 'currentBucket' before clearing instead of encapsulating again + totalMinMax = minmax; + foreach (MinMaxBounds bucket in fullBuckets) + totalMinMax.Encapsulate(bucket); + } + } + } + + public void Reset() + { + fullBuckets.Clear(); + currentBucket = null; + currentBucketSize = 0; + boundsCount = 0; + totalMinMax = new MinMaxBounds(); + } + } +} diff --git a/Assets/Mirror/Core/LagCompensation/HistoryBounds.cs.meta b/Assets/Mirror/Core/LagCompensation/HistoryBounds.cs.meta new file mode 100644 index 0000000..5f908b0 --- /dev/null +++ b/Assets/Mirror/Core/LagCompensation/HistoryBounds.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: ca9ea58b98a34f73801b162cd5de724e +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/LagCompensation/LagCompensation.cs b/Assets/Mirror/Core/LagCompensation/LagCompensation.cs new file mode 100644 index 0000000..ae37a3f --- /dev/null +++ b/Assets/Mirror/Core/LagCompensation/LagCompensation.cs @@ -0,0 +1,144 @@ +// standalone lag compensation algorithm +// based on the Valve Networking Model: +// https://developer.valvesoftware.com/wiki/Source_Multiplayer_Networking +using System.Collections.Generic; + +namespace Mirror +{ + public static class LagCompensation + { + // history is of . + // Queue allows for fast 'remove first' and 'append last'. + // + // make sure to always insert in order. + // inserting out of order like [1,2,4,3] would cause issues. + // can't safeguard this because Queue doesn't have .Last access. + public static void Insert( + Queue> history, + int historyLimit, + double timestamp, + T capture) + where T : Capture + { + // make space according to history limit. + // do this before inserting, to avoid resizing past capacity. + if (history.Count >= historyLimit) + history.Dequeue(); + + // insert + history.Enqueue(new KeyValuePair(timestamp, capture)); + } + + // get the two snapshots closest to a given timestamp. + // those can be used to interpolate the exact snapshot at that time. + // if timestamp is newer than the newest history entry, then we extrapolate. + // 't' will be between 1 and 2, before is second last, after is last. + // callers should Lerp(before, after, t=1.5) to extrapolate the hit. + // see comments below for extrapolation. + public static bool Sample( + Queue> history, + double timestamp, // current server time + double interval, // capture interval + out T before, + out T after, + out double t) // interpolation factor + where T : Capture + { + before = default; + after = default; + t = 0; + + // can't sample an empty history + // interpolation needs at least one entry. + // extrapolation needs at least two entries. + // can't Lerp(A, A, 1.5). dist(A, A) * 1.5 is always 0. + if(history.Count < 2) { + return false; + } + + // older than oldest + if (timestamp < history.Peek().Key) { + return false; + } + + // iterate through the history + // TODO faster version: guess start index by how many 'intervals' we are behind. + // search around that area. + // should be O(1) most of the time, unless sampling was off. + KeyValuePair prev = new KeyValuePair(); + KeyValuePair prevPrev = new KeyValuePair(); + foreach(KeyValuePair entry in history) { + // exact match? + if (timestamp == entry.Key) { + before = entry.Value; + after = entry.Value; + t = Mathd.InverseLerp(before.timestamp, after.timestamp, timestamp); + return true; + } + + // did we check beyond timestamp? then return the previous two. + if (entry.Key > timestamp) { + before = prev.Value; + after = entry.Value; + t = Mathd.InverseLerp(before.timestamp, after.timestamp, timestamp); + return true; + } + + // remember the last two for extrapolation. + // Queue doesn't have access to .Last. + prevPrev = prev; + prev = entry; + } + + // newer than newest: extrapolate up to one interval. + // let's say we capture every 100 ms: + // 100, 200, 300, 400 + // and the server is at 499 + // if a client sends CmdFire at time 480, then there's no history entry. + // => adding the current entry every time would be too expensive. + // worst case we would capture at 401, 402, 403, 404, ... 100 times + // => not extrapolating isn't great. low latency clients would be + // punished by missing their targets since no entry at 'time' was found. + // => extrapolation is the best solution. make sure this works as + // expected and within limits. + if (prev.Key < timestamp && timestamp <= prev.Key + interval) { + // return the last two valid snapshots. + // can't just return (after, after) because we can't extrapolate + // if their distance is 0. + before = prevPrev.Value; + after = prev.Value; + + // InverseLerp will give [after, after+interval]. + // but we return [before, after, t]. + // so add +1 for the distance from before->after + t = 1 + Mathd.InverseLerp(after.timestamp, after.timestamp + interval, timestamp); + return true; + } + + return false; + } + + // never trust the client. + // we estimate when a message was sent. + // don't trust the client to tell us the time. + // https://developer.valvesoftware.com/wiki/Source_Multiplayer_Networking + // Command Execution Time = Current Server Time - Packet Latency - Client View Interpolation + // => lag compensation demo estimation is off by only ~6ms + public static double EstimateTime(double serverTime, double rtt, double bufferTime) + { + // packet latency is one trip from client to server, so rtt / 2 + // client view interpolation is the snapshot interpolation buffer time + double latency = rtt / 2; + return serverTime - latency - bufferTime; + } + + // convenience function to draw all history gizmos. + // this should be called from OnDrawGizmos. + public static void DrawGizmos(Queue> history) + where T : Capture + { + foreach (KeyValuePair entry in history) + entry.Value.DrawGizmo(); + } + } +} diff --git a/Assets/Mirror/Core/LagCompensation/LagCompensation.cs.meta b/Assets/Mirror/Core/LagCompensation/LagCompensation.cs.meta new file mode 100644 index 0000000..452ab21 --- /dev/null +++ b/Assets/Mirror/Core/LagCompensation/LagCompensation.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: ad53cc7d12144d0ba3a8b0a4515e5d17 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/LagCompensation/LagCompensationSettings.cs b/Assets/Mirror/Core/LagCompensation/LagCompensationSettings.cs new file mode 100644 index 0000000..a7ec944 --- /dev/null +++ b/Assets/Mirror/Core/LagCompensation/LagCompensationSettings.cs @@ -0,0 +1,19 @@ +// snapshot interpolation settings struct. +// can easily be exposed in Unity inspectors. +using System; +using UnityEngine; + +namespace Mirror +{ + // class so we can define defaults easily + [Serializable] + public class LagCompensationSettings + { + [Header("Buffering")] + [Tooltip("Keep this many past snapshots in the buffer. The larger this is, the further we can rewind into the past.\nMaximum rewind time := historyAmount * captureInterval")] + public int historyLimit = 6; + + [Tooltip("Capture state every 'captureInterval' seconds. Larger values will space out the captures more, which gives a longer history but with possible gaps inbetween.\nSmaller values will have fewer gaps, with shorter history.")] + public float captureInterval = 0.100f; // 100 ms + } +} diff --git a/Assets/Mirror/Core/LagCompensation/LagCompensationSettings.cs.meta b/Assets/Mirror/Core/LagCompensation/LagCompensationSettings.cs.meta new file mode 100644 index 0000000..4f43a07 --- /dev/null +++ b/Assets/Mirror/Core/LagCompensation/LagCompensationSettings.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: fa80bec245f94bf8a28ec78777992a1c +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/LagCompensation/MinMaxBounds.cs b/Assets/Mirror/Core/LagCompensation/MinMaxBounds.cs new file mode 100644 index 0000000..b1b4874 --- /dev/null +++ b/Assets/Mirror/Core/LagCompensation/MinMaxBounds.cs @@ -0,0 +1,73 @@ +// Unity's Bounds struct is represented as (center, extents). +// HistoryBounds make heavy use of .Encapsulate(), which has to convert +// Unity's (center, extents) to (min, max) every time, and then convert back. +// +// It's faster to use a (min, max) representation directly instead. +using System; +using System.Runtime.CompilerServices; +using UnityEngine; + +namespace Mirror +{ + public struct MinMaxBounds: IEquatable + { + public Vector3 min; + public Vector3 max; + + // encapsulate a single point + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void Encapsulate(Vector3 point) + { + min = Vector3.Min(this.min, point); + max = Vector3.Max(this.max, point); + } + + // encapsulate another bounds + public void Encapsulate(MinMaxBounds bounds) + { + Encapsulate(bounds.min); + Encapsulate(bounds.max); + } + + // convenience comparison with Unity's bounds, for unit tests etc. + public static bool operator ==(MinMaxBounds lhs, Bounds rhs) => + lhs.min == rhs.min && + lhs.max == rhs.max; + + public static bool operator !=(MinMaxBounds lhs, Bounds rhs) => + !(lhs == rhs); + + public override bool Equals(object obj) => + obj is MinMaxBounds other && + min == other.min && + max == other.max; + + public bool Equals(MinMaxBounds other) => + min.Equals(other.min) && max.Equals(other.max); + + public bool Equals(Bounds other) => + min.Equals(other.min) && max.Equals(other.max); + +#if UNITY_2021_3_OR_NEWER + // Unity 2019/2020 don't have HashCode.Combine yet. + // this is only to avoid reflection. without defining, it works too. + // default generated by rider + public override int GetHashCode() => HashCode.Combine(min, max); +#else + public override int GetHashCode() + { + // return HashCode.Combine(min, max); without using .Combine for older Unity versions + unchecked + { + int hash = 17; + hash = hash * 23 + min.GetHashCode(); + hash = hash * 23 + max.GetHashCode(); + return hash; + } + } +#endif + + // tostring + public override string ToString() => $"({min}, {max})"; + } +} diff --git a/Assets/Mirror/Core/LagCompensation/MinMaxBounds.cs.meta b/Assets/Mirror/Core/LagCompensation/MinMaxBounds.cs.meta new file mode 100644 index 0000000..3eeb073 --- /dev/null +++ b/Assets/Mirror/Core/LagCompensation/MinMaxBounds.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 4372b1e1a1cc4c669cc7bf0925f59d29 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/LocalConnectionToClient.cs b/Assets/Mirror/Core/LocalConnectionToClient.cs new file mode 100644 index 0000000..c41c6ae --- /dev/null +++ b/Assets/Mirror/Core/LocalConnectionToClient.cs @@ -0,0 +1,82 @@ +using System; +using System.Collections.Generic; + +namespace Mirror +{ + // a server's connection TO a LocalClient. + // sending messages on this connection causes the client's handler function to be invoked directly + public class LocalConnectionToClient : NetworkConnectionToClient + { + internal LocalConnectionToServer connectionToServer; + + // packet queue + internal readonly Queue queue = new Queue(); + + public LocalConnectionToClient() : base(LocalConnectionId) {} + + public override string address => "localhost"; + + internal override void Send(ArraySegment segment, int channelId = Channels.Reliable) + { + // instead of invoking it directly, we enqueue and process next update. + // this way we can simulate a similar call flow as with remote clients. + // the closer we get to simulating host as remote, the better! + // both directions do this, so [Command] and [Rpc] behave the same way. + + //Debug.Log($"Enqueue {BitConverter.ToString(segment.Array, segment.Offset, segment.Count)}"); + NetworkWriterPooled writer = NetworkWriterPool.Get(); + writer.WriteBytes(segment.Array, segment.Offset, segment.Count); + connectionToServer.queue.Enqueue(writer); + } + + // true because local connections never timeout + internal override bool IsAlive(float timeout) => true; + + // don't ping host client in host mode + protected override void UpdatePing() {} + + internal override void Update() + { + base.Update(); + + // process internal messages so they are applied at the correct time + while (queue.Count > 0) + { + // call receive on queued writer's content, return to pool + NetworkWriterPooled writer = queue.Dequeue(); + ArraySegment message = writer.ToArraySegment(); + + // OnTransportData assumes a proper batch with timestamp etc. + // let's make a proper batch and pass it to OnTransportData. + Batcher batcher = GetBatchForChannelId(Channels.Reliable); + batcher.AddMessage(message, NetworkTime.localTime); + + using (NetworkWriterPooled batchWriter = NetworkWriterPool.Get()) + { + // make a batch with our local time (double precision) + if (batcher.GetBatch(batchWriter)) + { + NetworkServer.OnTransportData(connectionId, batchWriter.ToArraySegment(), Channels.Reliable); + } + } + + NetworkWriterPool.Return(writer); + } + } + + internal void DisconnectInternal() + { + // set not ready and handle clientscene disconnect in any case + // (might be client or host mode here) + isReady = false; + RemoveFromObservingsObservers(); + } + + /// Disconnects this connection. + public override void Disconnect() + { + DisconnectInternal(); + connectionToServer.DisconnectInternal(); + } + } +} diff --git a/Assets/Mirror/Core/LocalConnectionToClient.cs.meta b/Assets/Mirror/Core/LocalConnectionToClient.cs.meta new file mode 100644 index 0000000..a4f2d2c --- /dev/null +++ b/Assets/Mirror/Core/LocalConnectionToClient.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: a88758df7db2043d6a9d926e0b6d4191 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/LocalConnectionToServer.cs b/Assets/Mirror/Core/LocalConnectionToServer.cs new file mode 100644 index 0000000..15669c7 --- /dev/null +++ b/Assets/Mirror/Core/LocalConnectionToServer.cs @@ -0,0 +1,117 @@ +using System; +using System.Collections.Generic; +using UnityEngine; + +namespace Mirror +{ + // a localClient's connection TO a server. + // send messages on this connection causes the server's handler function to be invoked directly. + public class LocalConnectionToServer : NetworkConnectionToServer + { + internal LocalConnectionToClient connectionToClient; + + // packet queue + internal readonly Queue queue = new Queue(); + + // see caller for comments on why we need this + bool connectedEventPending; + bool disconnectedEventPending; + internal void QueueConnectedEvent() => connectedEventPending = true; + internal void QueueDisconnectedEvent() => disconnectedEventPending = true; + + // Send stage two: serialized NetworkMessage as ArraySegment + internal override void Send(ArraySegment segment, int channelId = Channels.Reliable) + { + if (segment.Count == 0) + { + Debug.LogError("LocalConnection.SendBytes cannot send zero bytes"); + return; + } + + // instead of invoking it directly, we enqueue and process next update. + // this way we can simulate a similar call flow as with remote clients. + // the closer we get to simulating host as remote, the better! + // both directions do this, so [Command] and [Rpc] behave the same way. + + //Debug.Log($"Enqueue {BitConverter.ToString(segment.Array, segment.Offset, segment.Count)}"); + NetworkWriterPooled writer = NetworkWriterPool.Get(); + writer.WriteBytes(segment.Array, segment.Offset, segment.Count); + connectionToClient.queue.Enqueue(writer); + } + + internal override void Update() + { + base.Update(); + + // should we still process a connected event? + if (connectedEventPending) + { + connectedEventPending = false; + NetworkClient.OnConnectedEvent?.Invoke(); + } + + // process internal messages so they are applied at the correct time + while (queue.Count > 0) + { + // call receive on queued writer's content, return to pool + NetworkWriterPooled writer = queue.Dequeue(); + ArraySegment message = writer.ToArraySegment(); + + // OnTransportData assumes a proper batch with timestamp etc. + // let's make a proper batch and pass it to OnTransportData. + Batcher batcher = GetBatchForChannelId(Channels.Reliable); + batcher.AddMessage(message, NetworkTime.localTime); + + using (NetworkWriterPooled batchWriter = NetworkWriterPool.Get()) + { + // make a batch with our local time (double precision) + if (batcher.GetBatch(batchWriter)) + { + NetworkClient.OnTransportData(batchWriter.ToArraySegment(), Channels.Reliable); + } + } + + NetworkWriterPool.Return(writer); + } + + // should we still process a disconnected event? + if (disconnectedEventPending) + { + disconnectedEventPending = false; + NetworkClient.OnDisconnectedEvent?.Invoke(); + } + } + + /// Disconnects this connection. + internal void DisconnectInternal() + { + // set not ready and handle clientscene disconnect in any case + // (might be client or host mode here) + // TODO remove redundant state. have one source of truth for .ready! + isReady = false; + NetworkClient.ready = false; + } + + /// Disconnects this connection. + public override void Disconnect() + { + connectionToClient.DisconnectInternal(); + DisconnectInternal(); + + // simulate what a true remote connection would do: + // first, the server should remove it: + // TODO should probably be in connectionToClient.DisconnectInternal + // because that's the NetworkServer's connection! + NetworkServer.RemoveLocalConnection(); + + // then call OnTransportDisconnected for proper disconnect handling, + // callbacks & cleanups. + // => otherwise OnClientDisconnected() is never called! + // => see NetworkClientTests.DisconnectCallsOnClientDisconnect_HostMode() + NetworkClient.OnTransportDisconnected(); + } + + // true because local connections never timeout + internal override bool IsAlive(float timeout) => true; + } +} diff --git a/Assets/Mirror/Core/LocalConnectionToServer.cs.meta b/Assets/Mirror/Core/LocalConnectionToServer.cs.meta new file mode 100644 index 0000000..856b255 --- /dev/null +++ b/Assets/Mirror/Core/LocalConnectionToServer.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: cdfff390c3504158a269e8b8662e2a40 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/Messages.cs b/Assets/Mirror/Core/Messages.cs new file mode 100644 index 0000000..62888c0 --- /dev/null +++ b/Assets/Mirror/Core/Messages.cs @@ -0,0 +1,140 @@ +using System; +using UnityEngine; + +namespace Mirror +{ + // need to send time every sendInterval. + // batching automatically includes remoteTimestamp. + // all we need to do is ensure that an empty message is sent. + // and react to it. + // => we don't want to insert a snapshot on every batch. + // => do it exactly every sendInterval on every TimeSnapshotMessage. + public struct TimeSnapshotMessage : NetworkMessage {} + + public struct ReadyMessage : NetworkMessage {} + + public struct NotReadyMessage : NetworkMessage {} + + public struct AddPlayerMessage : NetworkMessage {} + + public struct SceneMessage : NetworkMessage + { + public string sceneName; + // Normal = 0, LoadAdditive = 1, UnloadAdditive = 2 + public SceneOperation sceneOperation; + public bool customHandling; + } + + public enum SceneOperation : byte + { + Normal, + LoadAdditive, + UnloadAdditive + } + + public struct CommandMessage : NetworkMessage + { + public uint netId; + public byte componentIndex; + public ushort functionHash; + // the parameters for the Cmd function + // -> ArraySegment to avoid unnecessary allocations + public ArraySegment payload; + } + + public struct RpcMessage : NetworkMessage + { + public uint netId; + public byte componentIndex; + public ushort functionHash; + // the parameters for the Cmd function + // -> ArraySegment to avoid unnecessary allocations + public ArraySegment payload; + } + + public struct SpawnMessage : NetworkMessage + { + // netId of new or existing object + public uint netId; + public bool isLocalPlayer; + // Sets hasAuthority on the spawned object + public bool isOwner; + public ulong sceneId; + // If sceneId != 0 then it is used instead of assetId + public uint assetId; + // Local position + public Vector3 position; + // Local rotation + public Quaternion rotation; + // Local scale + public Vector3 scale; + // serialized component data + // ArraySegment to avoid unnecessary allocations + public ArraySegment payload; + } + + public struct ChangeOwnerMessage : NetworkMessage + { + public uint netId; + public bool isOwner; + public bool isLocalPlayer; + } + + public struct ObjectSpawnStartedMessage : NetworkMessage {} + + public struct ObjectSpawnFinishedMessage : NetworkMessage {} + + public struct ObjectDestroyMessage : NetworkMessage + { + public uint netId; + } + + public struct ObjectHideMessage : NetworkMessage + { + public uint netId; + } + + public struct EntityStateMessage : NetworkMessage + { + public uint netId; + // the serialized component data + // -> ArraySegment to avoid unnecessary allocations + public ArraySegment payload; + } + + // whoever wants to measure rtt, sends this to the other end. + public struct NetworkPingMessage : NetworkMessage + { + // local time is used to calculate round trip time, + // and to calculate the predicted time offset. + public double localTime; + + // predicted time is sent to compare the final error, for debugging only + public double predictedTimeAdjusted; + + public NetworkPingMessage(double localTime, double predictedTimeAdjusted) + { + this.localTime = localTime; + this.predictedTimeAdjusted = predictedTimeAdjusted; + } + } + + // the other end responds with this message. + // we can use this to calculate rtt. + public struct NetworkPongMessage : NetworkMessage + { + // local time is used to calculate round trip time. + public double localTime; + + // predicted error is used to adjust the predicted timeline. + public double predictionErrorUnadjusted; + public double predictionErrorAdjusted; // for debug purposes + + public NetworkPongMessage(double localTime, double predictionErrorUnadjusted, double predictionErrorAdjusted) + { + this.localTime = localTime; + this.predictionErrorUnadjusted = predictionErrorUnadjusted; + this.predictionErrorAdjusted = predictionErrorAdjusted; + } + } +} diff --git a/Assets/Mirror/Core/Messages.cs.meta b/Assets/Mirror/Core/Messages.cs.meta new file mode 100644 index 0000000..5d119e2 --- /dev/null +++ b/Assets/Mirror/Core/Messages.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 938f6f28a6c5b48a0bbd7782342d763b +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/Mirror.asmdef b/Assets/Mirror/Core/Mirror.asmdef new file mode 100644 index 0000000..2fa8d95 --- /dev/null +++ b/Assets/Mirror/Core/Mirror.asmdef @@ -0,0 +1,16 @@ +{ + "name": "Mirror", + "rootNamespace": "", + "references": [ + "GUID:325984b52e4128546bc7558552f8b1d2" + ], + "includePlatforms": [], + "excludePlatforms": [], + "allowUnsafeCode": true, + "overrideReferences": false, + "precompiledReferences": [], + "autoReferenced": true, + "defineConstraints": [], + "versionDefines": [], + "noEngineReferences": false +} \ No newline at end of file diff --git a/Assets/Mirror/Core/Mirror.asmdef.meta b/Assets/Mirror/Core/Mirror.asmdef.meta new file mode 100644 index 0000000..202009b --- /dev/null +++ b/Assets/Mirror/Core/Mirror.asmdef.meta @@ -0,0 +1,7 @@ +fileFormatVersion: 2 +guid: 30817c1a0e6d646d99c048fc403f5979 +AssemblyDefinitionImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/NetworkAuthenticator.cs b/Assets/Mirror/Core/NetworkAuthenticator.cs new file mode 100644 index 0000000..aa1e7f7 --- /dev/null +++ b/Assets/Mirror/Core/NetworkAuthenticator.cs @@ -0,0 +1,84 @@ +using System; +using UnityEngine; +using UnityEngine.Events; + +namespace Mirror +{ + [Serializable] public class UnityEventNetworkConnection : UnityEvent {} + + /// Base class for implementing component-based authentication during the Connect phase + [HelpURL("https://mirror-networking.gitbook.io/docs/components/network-authenticators")] + public abstract class NetworkAuthenticator : MonoBehaviour + { + /// Notify subscribers on the server when a client is authenticated + [Header("Event Listeners (optional)")] + [Tooltip("Mirror has an internal subscriber to this event. You can add your own here.")] + public UnityEventNetworkConnection OnServerAuthenticated = new UnityEventNetworkConnection(); + + /// Notify subscribers on the client when the client is authenticated + [Tooltip("Mirror has an internal subscriber to this event. You can add your own here.")] + public UnityEvent OnClientAuthenticated = new UnityEvent(); + + /// Called when server starts, used to register message handlers if needed. + public virtual void OnStartServer() {} + + /// Called when server stops, used to unregister message handlers if needed. + public virtual void OnStopServer() {} + + /// Called on server from OnServerConnectInternal when a client needs to authenticate + public virtual void OnServerAuthenticate(NetworkConnectionToClient conn) {} + + protected void ServerAccept(NetworkConnectionToClient conn) + { + OnServerAuthenticated.Invoke(conn); + } + + protected void ServerReject(NetworkConnectionToClient conn) + { + conn.Disconnect(); + } + + /// Called when client starts, used to register message handlers if needed. + public virtual void OnStartClient() {} + + /// Called when client stops, used to unregister message handlers if needed. + public virtual void OnStopClient() {} + + /// Called on client from OnClientConnectInternal when a client needs to authenticate + public virtual void OnClientAuthenticate() {} + + protected void ClientAccept() + { + OnClientAuthenticated.Invoke(); + } + + protected void ClientReject() + { + // Set this on the client for local reference + NetworkClient.connection.isAuthenticated = false; + + // disconnect the client + NetworkClient.connection.Disconnect(); + } + + // Reset() instead of OnValidate(): + // Any NetworkAuthenticator assigns itself to the NetworkManager, this is fine on first adding it, + // but if someone intentionally sets Authenticator to null on the NetworkManager again then the + // Authenticator will reassign itself if a value in the inspector is changed. + // My change switches OnValidate to Reset since Reset is only called when the component is first + // added (or reset is pressed). + void Reset() + { +#if UNITY_EDITOR + // automatically assign authenticator field if we add this to NetworkManager + NetworkManager manager = GetComponent(); + if (manager != null && manager.authenticator == null) + { + // undo has to be called before the change happens + UnityEditor.Undo.RecordObject(manager, "Assigned NetworkManager authenticator"); + manager.authenticator = this; + } +#endif + } + } +} diff --git a/Assets/Mirror/Core/NetworkAuthenticator.cs.meta b/Assets/Mirror/Core/NetworkAuthenticator.cs.meta new file mode 100644 index 0000000..d37db68 --- /dev/null +++ b/Assets/Mirror/Core/NetworkAuthenticator.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 407fc95d4a8257f448799f26cdde0c2a +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/NetworkBehaviour.cs b/Assets/Mirror/Core/NetworkBehaviour.cs new file mode 100644 index 0000000..cc81b94 --- /dev/null +++ b/Assets/Mirror/Core/NetworkBehaviour.cs @@ -0,0 +1,1370 @@ +using System; +using System.Collections.Generic; +using System.ComponentModel; +using System.Runtime.CompilerServices; +using UnityEngine; + +namespace Mirror +{ + // SyncMode decides if a component is synced to all observers, or only owner + public enum SyncMode { Observers, Owner } + + // SyncDirection decides if a component is synced from: + // * server to all clients + // * owner client, to server, to all other clients + // + // naming: 'ClientToServer' etc. instead of 'ClientAuthority', because + // that wouldn't be accurate. server's OnDeserialize can still validate + // client data before applying. it's really about direction, not authority. + public enum SyncDirection { ServerToClient, ClientToServer } + + /// Base class for networked components. + // [RequireComponent(typeof(NetworkIdentity))] disabled to allow child NetworkBehaviours + [AddComponentMenu("")] + [HelpURL("https://mirror-networking.gitbook.io/docs/guides/networkbehaviour")] + public abstract class NetworkBehaviour : MonoBehaviour + { + /// Sync direction for OnSerialize. ServerToClient by default. ClientToServer for client authority. + [Tooltip("Server Authority calls OnSerialize on the server and syncs it to clients.\n\nClient Authority calls OnSerialize on the owning client, syncs it to server, which then broadcasts it to all other clients.\n\nUse server authority for cheat safety.")] + [HideInInspector] public SyncDirection syncDirection = SyncDirection.ServerToClient; + + /// sync mode for OnSerialize + // hidden because NetworkBehaviourInspector shows it only if has OnSerialize. + [Tooltip("By default synced data is sent from the server to all Observers of the object.\nChange this to Owner to only have the server update the client that has ownership authority for this object")] + [HideInInspector] public SyncMode syncMode = SyncMode.Observers; + + /// sync interval for OnSerialize (in seconds) + // hidden because NetworkBehaviourInspector shows it only if has OnSerialize. + // [0,2] should be enough. anything >2s is too laggy anyway. + // + // NetworkServer & NetworkClient broadcast() are behind a sendInterval timer now. + // it makes sense to keep every component's syncInterval setting at '0' by default. + // otherwise, the overlapping timers could introduce unexpected latency. + // careful: default of '0.1' may + [Tooltip("Time in seconds until next change is synchronized to the client. '0' means send immediately if changed. '0.5' means only send changes every 500ms.\n(This is for state synchronization like SyncVars, SyncLists, OnSerialize. Not for Cmds, Rpcs, etc.)")] + [Range(0, 2)] + [HideInInspector] public float syncInterval = 0; + internal double lastSyncTime; + + /// True if this object is on the server and has been spawned. + // This is different from NetworkServer.active, which is true if the + // server itself is active rather than this object being active. + public bool isServer => netIdentity.isServer; + + /// True if this object is on the client and has been spawned by the server. + public bool isClient => netIdentity.isClient; + + /// True if this object is the the client's own local player. + public bool isLocalPlayer => netIdentity.isLocalPlayer; + + /// True if this object is on the server-only, not host. + public bool isServerOnly => netIdentity.isServerOnly; + + /// True if this object is on the client-only, not host. + public bool isClientOnly => netIdentity.isClientOnly; + + /// isOwned is true on the client if this NetworkIdentity is one of the .owned entities of our connection on the server. + // for example: main player & pets are owned. monsters & npcs aren't. + public bool isOwned => netIdentity.isOwned; + + /// authority is true if we are allowed to modify this component's state. On server, it's true if SyncDirection is ServerToClient. On client, it's true if SyncDirection is ClientToServer and(!) if this object is owned by the client. + // on the client: if Client->Server SyncDirection and owned + // on the server: if Server->Client SyncDirection + // on the host: if Server->Client SyncDirection (= server owns it), or if Client->Server and owned (=host client owns it) + // in host mode: always true because either server or client always has authority, and host is both. + // + // for example, NetworkTransform: + // client may modify position if ClientAuthority mode and owned + // server may modify position only if server authority + // + // note that in original Mirror, hasAuthority only meant 'isOwned'. + // there was no syncDirection to check. + // + // also note that this is a per-NetworkBehaviour flag. + // another component may not be client authoritative, etc. + public bool authority + { + get + { + // host mode needs to be checked explicitly + if (isClient && isServer) return syncDirection == SyncDirection.ServerToClient || isOwned; + + // client-only + if (isClient) return syncDirection == SyncDirection.ClientToServer && isOwned; + + // server-only + return syncDirection == SyncDirection.ServerToClient; + } + } + + /// The unique network Id of this object (unique at runtime). + public uint netId => netIdentity.netId; + + /// Client's network connection to the server. This is only valid for player objects on the client. + // TODO change to NetworkConnectionToServer, but might cause some breaking + public NetworkConnection connectionToServer => netIdentity.connectionToServer; + + /// Server's network connection to the client. This is only valid for player objects on the server. + public NetworkConnectionToClient connectionToClient => netIdentity.connectionToClient; + + // SyncLists, SyncSets, etc. + protected readonly List syncObjects = new List(); + + // NetworkBehaviourInspector needs to know if we have SyncObjects + internal bool HasSyncObjects() => syncObjects.Count > 0; + + // NetworkIdentity based values set from NetworkIdentity.Awake(), + // which is way more simple and way faster than trying to figure out + // component index from in here by searching all NetworkComponents. + + /// Returns the NetworkIdentity of this object + public NetworkIdentity netIdentity { get; internal set; } + + /// Returns the index of the component on this object + public byte ComponentIndex { get; internal set; } + + // to avoid fully serializing entities every time, we have two options: + // * run a delta compression algorithm + // -> for fixed size types this is as easy as varint(b-a) for all + // -> for dynamically sized types like strings this is not easy. + // algorithms need to detect inserts/deletions, i.e. Myers Diff. + // those are very cpu intensive and barely fast enough for large + // scale multiplayer games (in Unity) + // * or we use dirty bits as meta data about which fields have changed + // -> spares us from running delta algorithms + // -> still supports dynamically sized types + // + // 64 bit mask, tracking up to 64 SyncVars. + // protected since NB child classes read this field in the weaver generated SerializeSyncVars method + protected ulong syncVarDirtyBits; + // 64 bit mask, tracking up to 64 sync collections. + // internal for tests, field for faster access (instead of property) + // TODO 64 SyncLists are too much. consider smaller mask later. + internal ulong syncObjectDirtyBits; + + // Weaver replaces '[SyncVar] int health' with 'Networkhealth' property. + // setter calls the hook if value changed. + // if we then modify the [SyncVar] from inside the setter, + // the setter would call the hook and we deadlock. + // hook guard prevents that. + ulong syncVarHookGuard; + + // USED BY WEAVER to set syncvars in host mode without deadlocking + protected bool GetSyncVarHookGuard(ulong dirtyBit) => + (syncVarHookGuard & dirtyBit) != 0UL; + + // USED BY WEAVER to set syncvars in host mode without deadlocking + protected void SetSyncVarHookGuard(ulong dirtyBit, bool value) + { + // set the bit + if (value) + syncVarHookGuard |= dirtyBit; + // clear the bit + else + syncVarHookGuard &= ~dirtyBit; + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + void SetSyncObjectDirtyBit(ulong dirtyBit) + { + syncObjectDirtyBits |= dirtyBit; + } + + /// Set as dirty so that it's synced to clients again. + // these are masks, not bit numbers, ie. 110011b not '2' for 2nd bit. + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void SetSyncVarDirtyBit(ulong dirtyBit) + { + syncVarDirtyBits |= dirtyBit; + } + + /// Set as dirty to trigger OnSerialize & send. Dirty bits are cleared after the send. + // previously one had to use SetSyncVarDirtyBit(1), which is confusing. + // simply reuse SetSyncVarDirtyBit for now. + // instead of adding another field. + // syncVarDirtyBits does trigger OnSerialize as well. + // + // it's important to set _all_ bits as dirty. + // for example, server needs to broadcast ClientToServer components. + // if we only set the first bit, only that SyncVar would be broadcast. + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void SetDirty() => SetSyncVarDirtyBit(ulong.MaxValue); + + // true if syncInterval elapsed and any SyncVar or SyncObject is dirty + // OR both bitmasks. != 0 if either was dirty. + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public bool IsDirty() => + // check bits first. this is basically free. + (syncVarDirtyBits | syncObjectDirtyBits) != 0UL && + // only check time if bits were dirty. this is more expensive. + NetworkTime.localTime - lastSyncTime >= syncInterval; + + /// Clears all the dirty bits that were set by SetSyncVarDirtyBit() (formally SetDirtyBits) + // automatically invoked when an update is sent for this object, but can + // be called manually as well. + public void ClearAllDirtyBits() + { + lastSyncTime = NetworkTime.localTime; + syncVarDirtyBits = 0L; + syncObjectDirtyBits = 0L; + + // clear all unsynchronized changes in syncobjects + // (Linq allocates, use for instead) + for (int i = 0; i < syncObjects.Count; ++i) + { + syncObjects[i].ClearChanges(); + } + } + + // this gets called in the constructor by the weaver + // for every SyncObject in the component (e.g. SyncLists). + // We collect all of them and we synchronize them with OnSerialize/OnDeserialize + protected void InitSyncObject(SyncObject syncObject) + { + if (syncObject == null) + { + Debug.LogError("Uninitialized SyncObject. Manually call the constructor on your SyncList, SyncSet, SyncDictionary or SyncField"); + return; + } + + // add it, remember the index in list (if Count=0, index=0 etc.) + int index = syncObjects.Count; + syncObjects.Add(syncObject); + + // OnDirty needs to set nth bit in our dirty mask + ulong nthBit = 1UL << index; + syncObject.OnDirty = () => SetSyncObjectDirtyBit(nthBit); + + // who is allowed to modify SyncList/SyncSet/etc.: + // on client: only if owned ClientToserver + // on server: only if ServerToClient. + // but also for initial state when spawning. + // need to set a lambda because 'isClient' isn't available in + // InitSyncObject yet, which is called from the constructor. + syncObject.IsWritable = () => + { + // carefully check each mode separately to ensure correct results. + // fixes: https://github.com/MirrorNetworking/Mirror/issues/3342 + + // normally we would check isServer / isClient here. + // users may add to SyncLists before the object was spawned. + // isServer / isClient would still be false. + // so we need to check NetworkServer/Client.active here instead. + + // host mode: any ServerToClient and any local client owned + if (NetworkServer.active && NetworkClient.active) + return syncDirection == SyncDirection.ServerToClient || isOwned; + + // server only: any ServerToClient + if (NetworkServer.active) + return syncDirection == SyncDirection.ServerToClient; + + // client only: only ClientToServer and owned + if (NetworkClient.active) + { + // spawned: only ClientToServer and owned + if (netId != 0) return syncDirection == SyncDirection.ClientToServer && isOwned; + + // not spawned (character selection previews, etc.): always allow + // fixes https://github.com/MirrorNetworking/Mirror/issues/3343 + return true; + } + + // undefined behaviour should throw to make it very obvious + throw new Exception("InitSyncObject: IsWritable: neither NetworkServer nor NetworkClient are active."); + }; + + // when do we record changes: + // on client: only if owned ClientToServer + // on server: only if we have observers. + // prevents ever growing .changes lists: + // if a monster has no observers but we keep modifing a SyncObject, + // then the changes would never be flushed and keep growing, + // because OnSerialize isn't called without observers. + syncObject.IsRecording = () => + { + // carefully check each mode separately to ensure correct results. + // fixes: https://github.com/MirrorNetworking/Mirror/issues/3342 + + // host mode: only if observed + if (isServer && isClient) return netIdentity.observers.Count > 0; + + // server only: only if observed + if (isServer) return netIdentity.observers.Count > 0; + + // client only: only ClientToServer and owned + if (isClient) return syncDirection == SyncDirection.ClientToServer && isOwned; + + // users may add to SyncLists before the object was spawned. + // isServer / isClient would still be false. + // in that case, allow modifying but don't record changes yet. + return false; + }; + } + + protected virtual void OnValidate() + { + // we now allow child NetworkBehaviours. + // we can not [RequireComponent(typeof(NetworkIdentity))] anymore. + // instead, we need to ensure a NetworkIdentity is somewhere in the + // parents. + // only run this in Editor. don't add more runtime overhead. + + // GetComponentInParent(includeInactive) is needed because Prefabs are not + // considered active, so this check requires to scan inactive. +#if UNITY_EDITOR +#if UNITY_2021_3_OR_NEWER // 2021 has GetComponentInParent(bool includeInactive = false) + if (GetComponent() == null && + GetComponentInParent(true) == null) + { + Debug.LogError($"{GetType()} on {name} requires a NetworkIdentity. Please add a NetworkIdentity component to {name} or it's parents.", this); + } +#elif UNITY_2020_3_OR_NEWER // 2020 only has GetComponentsInParent(bool includeInactive = false), we can use this too + NetworkIdentity[] parentsIds = GetComponentsInParent(true); + int parentIdsCount = parentsIds != null ? parentsIds.Length : 0; + if (GetComponent() == null && parentIdsCount == 0) + { + Debug.LogError($"{GetType()} on {name} requires a NetworkIdentity. Please add a NetworkIdentity component to {name} or it's parents.", this); + } +#endif +#endif + } + + // pass full function name to avoid ClassA.Func <-> ClassB.Func collisions + protected void SendCommandInternal(string functionFullName, int functionHashCode, NetworkWriter writer, int channelId, bool requiresAuthority = true) + { + // this was in Weaver before + // NOTE: we could remove this later to allow calling Cmds on Server + // to avoid Wrapper functions. a lot of people requested this. + if (!NetworkClient.active) + { + Debug.LogError($"Command {functionFullName} called on {name} without an active client.", gameObject); + return; + } + + // previously we used NetworkClient.readyConnection. + // now we check .ready separately. + if (!NetworkClient.ready) + { + // Unreliable Cmds from NetworkTransform may be generated, + // or client may have been set NotReady intentionally, so + // only warn if on the reliable channel. + if (channelId == Channels.Reliable) + Debug.LogWarning($"Command {functionFullName} called on {name} while NetworkClient is not ready.\nThis may be ignored if client intentionally set NotReady.", gameObject); + return; + } + + // local players can always send commands, regardless of authority, + // other objects must have authority. + if (!(!requiresAuthority || isLocalPlayer || isOwned)) + { + Debug.LogWarning($"Command {functionFullName} called on {name} without authority.", gameObject); + return; + } + + // IMPORTANT: can't use .connectionToServer here because calling + // a command on other objects is allowed if requireAuthority is + // false. other objects don't have a .connectionToServer. + // => so we always need to use NetworkClient.connection instead. + // => see also: https://github.com/vis2k/Mirror/issues/2629 + if (NetworkClient.connection == null) + { + Debug.LogError($"Command {functionFullName} called on {name} with no client running.", gameObject); + return; + } + + // construct the message + CommandMessage message = new CommandMessage + { + netId = netId, + componentIndex = ComponentIndex, + // type+func so Inventory.RpcUse != Equipment.RpcUse + functionHash = (ushort)functionHashCode, + // segment to avoid reader allocations + payload = writer.ToArraySegment() + }; + + // IMPORTANT: can't use .connectionToServer here because calling + // a command on other objects is allowed if requireAuthority is + // false. other objects don't have a .connectionToServer. + // => so we always need to use NetworkClient.connection instead. + // => see also: https://github.com/vis2k/Mirror/issues/2629 + // This bypasses the null check in NetworkClient.Send but we have + // a null check above with a detailed error log. + NetworkClient.connection.Send(message, channelId); + } + + // pass full function name to avoid ClassA.Func <-> ClassB.Func collisions + protected void SendRPCInternal(string functionFullName, int functionHashCode, NetworkWriter writer, int channelId, bool includeOwner) + { + // this was in Weaver before + if (!NetworkServer.active) + { + Debug.LogError($"RPC Function {functionFullName} called without an active server.", gameObject); + return; + } + + // This cannot use NetworkServer.active, as that is not specific to this object. + if (!isServer) + { + Debug.LogWarning($"ClientRpc {functionFullName} called on un-spawned object: {name}", gameObject); + return; + } + + // construct the message + RpcMessage message = new RpcMessage + { + netId = netId, + componentIndex = ComponentIndex, + // type+func so Inventory.RpcUse != Equipment.RpcUse + functionHash = (ushort)functionHashCode, + // segment to avoid reader allocations + payload = writer.ToArraySegment() + }; + + // serialize it to each ready observer's connection's rpc buffer. + // send them all at once, instead of sending one message per rpc. + // NetworkServer.SendToReadyObservers(netIdentity, message, includeOwner, channelId); + + // safety check used to be in SendToReadyObservers. keep it for now. + if (netIdentity.observers == null || netIdentity.observers.Count == 0) + return; + + // serialize the message only once + using (NetworkWriterPooled serialized = NetworkWriterPool.Get()) + { + serialized.Write(message); + + // send to every observer. + // batching buffers this automatically. + foreach (NetworkConnectionToClient conn in netIdentity.observers.Values) + { + bool isOwner = conn == netIdentity.connectionToClient; + if ((!isOwner || includeOwner) && conn.isReady) + { + conn.Send(message, channelId); + } + } + } + } + + // pass full function name to avoid ClassA.Func <-> ClassB.Func collisions + protected void SendTargetRPCInternal(NetworkConnection conn, string functionFullName, int functionHashCode, NetworkWriter writer, int channelId) + { + if (!NetworkServer.active) + { + Debug.LogError($"TargetRPC {functionFullName} was called on {name} when server not active.", gameObject); + return; + } + + if (!isServer) + { + Debug.LogWarning($"TargetRpc {functionFullName} called on {name} but that object has not been spawned or has been unspawned.", gameObject); + return; + } + + // connection parameter is optional. assign if null. + if (conn is null) + { + conn = connectionToClient; + } + + // if still null + if (conn is null) + { + Debug.LogError($"TargetRPC {functionFullName} can't be sent because it was given a null connection. Make sure {name} is owned by a connection, or if you pass a connection manually then make sure it's not null. For example, TargetRpcs can be called on Player/Pet which are owned by a connection. However, they can not be called on Monsters/Npcs which don't have an owner connection.", gameObject); + return; + } + + // TODO change conn type to NetworkConnectionToClient to begin with. + if (!(conn is NetworkConnectionToClient connToClient)) + { + Debug.LogError($"TargetRPC {functionFullName} called on {name} requires a NetworkConnectionToClient but was given {conn.GetType().Name}", gameObject); + return; + } + + // construct the message + RpcMessage message = new RpcMessage + { + netId = netId, + componentIndex = ComponentIndex, + // type+func so Inventory.RpcUse != Equipment.RpcUse + functionHash = (ushort)functionHashCode, + // segment to avoid reader allocations + payload = writer.ToArraySegment() + }; + + // send it to the connection. + // batching buffers this automatically. + conn.Send(message, channelId); + } + + // move the [SyncVar] generated property's .set into C# to avoid much IL + // + // public int health = 42; + // + // public int Networkhealth + // { + // get + // { + // return health; + // } + // [param: In] + // set + // { + // if (!NetworkBehaviour.SyncVarEqual(value, ref health)) + // { + // int oldValue = health; + // SetSyncVar(value, ref health, 1uL); + // if (NetworkServer.activeHost && !GetSyncVarHookGuard(1uL)) + // { + // SetSyncVarHookGuard(1uL, value: true); + // OnChanged(oldValue, value); + // SetSyncVarHookGuard(1uL, value: false); + // } + // } + // } + // } + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void GeneratedSyncVarSetter(T value, ref T field, ulong dirtyBit, Action OnChanged) + { + if (!SyncVarEqual(value, ref field)) + { + T oldValue = field; + SetSyncVar(value, ref field, dirtyBit); + + // call hook (if any) + if (OnChanged != null) + { + // in host mode, setting a SyncVar calls the hook directly. + // in client-only mode, OnDeserialize would call it. + // we use hook guard to protect against deadlock where hook + // changes syncvar, calling hook again. + if (NetworkServer.activeHost && !GetSyncVarHookGuard(dirtyBit)) + { + SetSyncVarHookGuard(dirtyBit, true); + OnChanged(oldValue, value); + SetSyncVarHookGuard(dirtyBit, false); + } + } + } + } + + // GameObject needs custom handling for persistence via netId. + // has one extra parameter. + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void GeneratedSyncVarSetter_GameObject(GameObject value, ref GameObject field, ulong dirtyBit, Action OnChanged, ref uint netIdField) + { + if (!SyncVarGameObjectEqual(value, netIdField)) + { + GameObject oldValue = field; + SetSyncVarGameObject(value, ref field, dirtyBit, ref netIdField); + + // call hook (if any) + if (OnChanged != null) + { + // in host mode, setting a SyncVar calls the hook directly. + // in client-only mode, OnDeserialize would call it. + // we use hook guard to protect against deadlock where hook + // changes syncvar, calling hook again. + if (NetworkServer.activeHost && !GetSyncVarHookGuard(dirtyBit)) + { + SetSyncVarHookGuard(dirtyBit, true); + OnChanged(oldValue, value); + SetSyncVarHookGuard(dirtyBit, false); + } + } + } + } + + // NetworkIdentity needs custom handling for persistence via netId. + // has one extra parameter. + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void GeneratedSyncVarSetter_NetworkIdentity(NetworkIdentity value, ref NetworkIdentity field, ulong dirtyBit, Action OnChanged, ref uint netIdField) + { + if (!SyncVarNetworkIdentityEqual(value, netIdField)) + { + NetworkIdentity oldValue = field; + SetSyncVarNetworkIdentity(value, ref field, dirtyBit, ref netIdField); + + // call hook (if any) + if (OnChanged != null) + { + // in host mode, setting a SyncVar calls the hook directly. + // in client-only mode, OnDeserialize would call it. + // we use hook guard to protect against deadlock where hook + // changes syncvar, calling hook again. + if (NetworkServer.activeHost && !GetSyncVarHookGuard(dirtyBit)) + { + SetSyncVarHookGuard(dirtyBit, true); + OnChanged(oldValue, value); + SetSyncVarHookGuard(dirtyBit, false); + } + } + } + } + + // NetworkBehaviour needs custom handling for persistence via netId. + // has one extra parameter. + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void GeneratedSyncVarSetter_NetworkBehaviour(T value, ref T field, ulong dirtyBit, Action OnChanged, ref NetworkBehaviourSyncVar netIdField) + where T : NetworkBehaviour + { + if (!SyncVarNetworkBehaviourEqual(value, netIdField)) + { + T oldValue = field; + SetSyncVarNetworkBehaviour(value, ref field, dirtyBit, ref netIdField); + + // call hook (if any) + if (OnChanged != null) + { + // in host mode, setting a SyncVar calls the hook directly. + // in client-only mode, OnDeserialize would call it. + // we use hook guard to protect against deadlock where hook + // changes syncvar, calling hook again. + if (NetworkServer.activeHost && !GetSyncVarHookGuard(dirtyBit)) + { + SetSyncVarHookGuard(dirtyBit, true); + OnChanged(oldValue, value); + SetSyncVarHookGuard(dirtyBit, false); + } + } + } + } + + // helper function for [SyncVar] GameObjects. + // needs to be public so that tests & NetworkBehaviours from other + // assemblies both find it + [EditorBrowsable(EditorBrowsableState.Never)] + public static bool SyncVarGameObjectEqual(GameObject newGameObject, uint netIdField) + { + uint newNetId = 0; + if (newGameObject != null) + { + if (newGameObject.TryGetComponent(out NetworkIdentity identity)) + { + newNetId = identity.netId; + if (newNetId == 0) + { + Debug.LogWarning($"SetSyncVarGameObject GameObject {newGameObject} has a zero netId. Maybe it is not spawned yet?"); + } + } + } + + return newNetId == netIdField; + } + + // helper function for [SyncVar] GameObjects. + // dirtyBit is a mask like 00010 + protected void SetSyncVarGameObject(GameObject newGameObject, ref GameObject gameObjectField, ulong dirtyBit, ref uint netIdField) + { + if (GetSyncVarHookGuard(dirtyBit)) + return; + + uint newNetId = 0; + if (newGameObject != null) + { + if (newGameObject.TryGetComponent(out NetworkIdentity identity)) + { + newNetId = identity.netId; + if (newNetId == 0) + { + Debug.LogWarning($"SetSyncVarGameObject GameObject {newGameObject} has a zero netId. Maybe it is not spawned yet?"); + } + } + } + + //Debug.Log($"SetSyncVar GameObject {GetType().Name} bit:{dirtyBit} netfieldId:{netIdField} -> {newNetId}"); + SetSyncVarDirtyBit(dirtyBit); + // assign new one on the server, and in case we ever need it on client too + gameObjectField = newGameObject; + netIdField = newNetId; + } + + // helper function for [SyncVar] GameObjects. + // -> ref GameObject as second argument makes OnDeserialize processing easier + protected GameObject GetSyncVarGameObject(uint netId, ref GameObject gameObjectField) + { + // server always uses the field + // if neither, fallback to original field + // fixes: https://github.com/MirrorNetworking/Mirror/issues/3447 + if (isServer || !isClient) + { + return gameObjectField; + } + + // client always looks up based on netId because objects might get in and out of range + // over and over again, which shouldn't null them forever + if (NetworkClient.spawned.TryGetValue(netId, out NetworkIdentity identity) && identity != null) + return gameObjectField = identity.gameObject; + return null; + } + + // helper function for [SyncVar] NetworkIdentities. + // needs to be public so that tests & NetworkBehaviours from other + // assemblies both find it + [EditorBrowsable(EditorBrowsableState.Never)] + public static bool SyncVarNetworkIdentityEqual(NetworkIdentity newIdentity, uint netIdField) + { + uint newNetId = 0; + if (newIdentity != null) + { + newNetId = newIdentity.netId; + if (newNetId == 0) + { + Debug.LogWarning($"SetSyncVarNetworkIdentity NetworkIdentity {newIdentity} has a zero netId. Maybe it is not spawned yet?"); + } + } + + // netId changed? + return newNetId == netIdField; + } + + // move the [SyncVar] generated OnDeserialize C# to avoid much IL. + // + // before: + // public override void DeserializeSyncVars(NetworkReader reader, bool initialState) + // { + // base.DeserializeSyncVars(reader, initialState); + // if (initialState) + // { + // int num = health; + // Networkhealth = reader.ReadInt(); + // if (!NetworkBehaviour.SyncVarEqual(num, ref health)) + // { + // OnChanged(num, health); + // } + // return; + // } + // long num2 = (long)reader.ReadULong(); + // if ((num2 & 1L) != 0L) + // { + // int num3 = health; + // Networkhealth = reader.ReadInt(); + // if (!NetworkBehaviour.SyncVarEqual(num3, ref health)) + // { + // OnChanged(num3, health); + // } + // } + // } + // + // after: + // + // public override void DeserializeSyncVars(NetworkReader reader, bool initialState) + // { + // base.DeserializeSyncVars(reader, initialState); + // if (initialState) + // { + // GeneratedSyncVarDeserialize(reader, ref health, null, reader.ReadInt()); + // return; + // } + // long num = (long)reader.ReadULong(); + // if ((num & 1L) != 0L) + // { + // GeneratedSyncVarDeserialize(reader, ref health, null, reader.ReadInt()); + // } + // } + public void GeneratedSyncVarDeserialize(ref T field, Action OnChanged, T value) + { + T previous = field; + field = value; + + // any hook? then call if changed. + if (OnChanged != null && !SyncVarEqual(previous, ref field)) + { + OnChanged(previous, field); + } + } + + // move the [SyncVar] generated OnDeserialize C# to avoid much IL. + // + // before: + // public override void DeserializeSyncVars(NetworkReader reader, bool initialState) + // { + // base.DeserializeSyncVars(reader, initialState); + // if (initialState) + // { + // uint __targetNetId = ___targetNetId; + // GameObject networktarget = Networktarget; + // ___targetNetId = reader.ReadUInt(); + // if (!NetworkBehaviour.SyncVarEqual(__targetNetId, ref ___targetNetId)) + // { + // OnChangedNB(networktarget, Networktarget); + // } + // return; + // } + // long num = (long)reader.ReadULong(); + // if ((num & 1L) != 0L) + // { + // uint __targetNetId2 = ___targetNetId; + // GameObject networktarget2 = Networktarget; + // ___targetNetId = reader.ReadUInt(); + // if (!NetworkBehaviour.SyncVarEqual(__targetNetId2, ref ___targetNetId)) + // { + // OnChangedNB(networktarget2, Networktarget); + // } + // } + // } + // + // after: + // public override void DeserializeSyncVars(NetworkReader reader, bool initialState) + // { + // base.DeserializeSyncVars(reader, initialState); + // if (initialState) + // { + // GeneratedSyncVarDeserialize_GameObject(reader, ref target, OnChangedNB, ref ___targetNetId); + // return; + // } + // long num = (long)reader.ReadULong(); + // if ((num & 1L) != 0L) + // { + // GeneratedSyncVarDeserialize_GameObject(reader, ref target, OnChangedNB, ref ___targetNetId); + // } + // } + public void GeneratedSyncVarDeserialize_GameObject(ref GameObject field, Action OnChanged, NetworkReader reader, ref uint netIdField) + { + uint previousNetId = netIdField; + GameObject previousGameObject = field; + netIdField = reader.ReadUInt(); + + // get the new GameObject now that netId field is set + field = GetSyncVarGameObject(netIdField, ref field); + + // any hook? then call if changed. + if (OnChanged != null && !SyncVarEqual(previousNetId, ref netIdField)) + { + OnChanged(previousGameObject, field); + } + } + + // move the [SyncVar] generated OnDeserialize C# to avoid much IL. + // + // before: + // public override void DeserializeSyncVars(NetworkReader reader, bool initialState) + // { + // base.DeserializeSyncVars(reader, initialState); + // if (initialState) + // { + // uint __targetNetId = ___targetNetId; + // NetworkIdentity networktarget = Networktarget; + // ___targetNetId = reader.ReadUInt(); + // if (!NetworkBehaviour.SyncVarEqual(__targetNetId, ref ___targetNetId)) + // { + // OnChangedNI(networktarget, Networktarget); + // } + // return; + // } + // long num = (long)reader.ReadULong(); + // if ((num & 1L) != 0L) + // { + // uint __targetNetId2 = ___targetNetId; + // NetworkIdentity networktarget2 = Networktarget; + // ___targetNetId = reader.ReadUInt(); + // if (!NetworkBehaviour.SyncVarEqual(__targetNetId2, ref ___targetNetId)) + // { + // OnChangedNI(networktarget2, Networktarget); + // } + // } + // } + // + // after: + // + // public override void DeserializeSyncVars(NetworkReader reader, bool initialState) + // { + // base.DeserializeSyncVars(reader, initialState); + // if (initialState) + // { + // GeneratedSyncVarDeserialize_NetworkIdentity(reader, ref target, OnChangedNI, ref ___targetNetId); + // return; + // } + // long num = (long)reader.ReadULong(); + // if ((num & 1L) != 0L) + // { + // GeneratedSyncVarDeserialize_NetworkIdentity(reader, ref target, OnChangedNI, ref ___targetNetId); + // } + // } + public void GeneratedSyncVarDeserialize_NetworkIdentity(ref NetworkIdentity field, Action OnChanged, NetworkReader reader, ref uint netIdField) + { + uint previousNetId = netIdField; + NetworkIdentity previousIdentity = field; + netIdField = reader.ReadUInt(); + + // get the new NetworkIdentity now that netId field is set + field = GetSyncVarNetworkIdentity(netIdField, ref field); + + // any hook? then call if changed. + if (OnChanged != null && !SyncVarEqual(previousNetId, ref netIdField)) + { + OnChanged(previousIdentity, field); + } + } + + // move the [SyncVar] generated OnDeserialize C# to avoid much IL. + // + // before: + // + // public override void DeserializeSyncVars(NetworkReader reader, bool initialState) + // { + // base.DeserializeSyncVars(reader, initialState); + // if (initialState) + // { + // NetworkBehaviourSyncVar __targetNetId = ___targetNetId; + // Tank networktarget = Networktarget; + // ___targetNetId = reader.ReadNetworkBehaviourSyncVar(); + // if (!NetworkBehaviour.SyncVarEqual(__targetNetId, ref ___targetNetId)) + // { + // OnChangedNB(networktarget, Networktarget); + // } + // return; + // } + // long num = (long)reader.ReadULong(); + // if ((num & 1L) != 0L) + // { + // NetworkBehaviourSyncVar __targetNetId2 = ___targetNetId; + // Tank networktarget2 = Networktarget; + // ___targetNetId = reader.ReadNetworkBehaviourSyncVar(); + // if (!NetworkBehaviour.SyncVarEqual(__targetNetId2, ref ___targetNetId)) + // { + // OnChangedNB(networktarget2, Networktarget); + // } + // } + // } + // + // after: + // + // public override void DeserializeSyncVars(NetworkReader reader, bool initialState) + // { + // base.DeserializeSyncVars(reader, initialState); + // if (initialState) + // { + // GeneratedSyncVarDeserialize_NetworkBehaviour(reader, ref target, OnChangedNB, ref ___targetNetId); + // return; + // } + // long num = (long)reader.ReadULong(); + // if ((num & 1L) != 0L) + // { + // GeneratedSyncVarDeserialize_NetworkBehaviour(reader, ref target, OnChangedNB, ref ___targetNetId); + // } + // } + public void GeneratedSyncVarDeserialize_NetworkBehaviour(ref T field, Action OnChanged, NetworkReader reader, ref NetworkBehaviourSyncVar netIdField) + where T : NetworkBehaviour + { + NetworkBehaviourSyncVar previousNetId = netIdField; + T previousBehaviour = field; + netIdField = reader.ReadNetworkBehaviourSyncVar(); + + // get the new NetworkBehaviour now that netId field is set + field = GetSyncVarNetworkBehaviour(netIdField, ref field); + + // any hook? then call if changed. + if (OnChanged != null && !SyncVarEqual(previousNetId, ref netIdField)) + { + OnChanged(previousBehaviour, field); + } + } + + // helper function for [SyncVar] NetworkIdentities. + // dirtyBit is a mask like 00010 + protected void SetSyncVarNetworkIdentity(NetworkIdentity newIdentity, ref NetworkIdentity identityField, ulong dirtyBit, ref uint netIdField) + { + if (GetSyncVarHookGuard(dirtyBit)) + return; + + uint newNetId = 0; + if (newIdentity != null) + { + newNetId = newIdentity.netId; + if (newNetId == 0) + { + Debug.LogWarning($"SetSyncVarNetworkIdentity NetworkIdentity {newIdentity} has a zero netId. Maybe it is not spawned yet?"); + } + } + + //Debug.Log($"SetSyncVarNetworkIdentity NetworkIdentity {GetType().Name} bit:{dirtyBit} netIdField:{netIdField} -> {newNetId}"); + SetSyncVarDirtyBit(dirtyBit); + netIdField = newNetId; + // assign new one on the server, and in case we ever need it on client too + identityField = newIdentity; + } + + // helper function for [SyncVar] NetworkIdentities. + // -> ref GameObject as second argument makes OnDeserialize processing easier + protected NetworkIdentity GetSyncVarNetworkIdentity(uint netId, ref NetworkIdentity identityField) + { + // server always uses the field + // if neither, fallback to original field + // fixes: https://github.com/MirrorNetworking/Mirror/issues/3447 + if (isServer || !isClient) + { + return identityField; + } + + // client always looks up based on netId because objects might get in and out of range + // over and over again, which shouldn't null them forever + NetworkClient.spawned.TryGetValue(netId, out identityField); + return identityField; + } + + protected static bool SyncVarNetworkBehaviourEqual(T newBehaviour, NetworkBehaviourSyncVar syncField) where T : NetworkBehaviour + { + uint newNetId = 0; + byte newComponentIndex = 0; + if (newBehaviour != null) + { + newNetId = newBehaviour.netId; + newComponentIndex = newBehaviour.ComponentIndex; + if (newNetId == 0) + { + Debug.LogWarning($"SetSyncVarNetworkIdentity NetworkIdentity {newBehaviour} has a zero netId. Maybe it is not spawned yet?"); + } + } + + // netId changed? + return syncField.Equals(newNetId, newComponentIndex); + } + + // helper function for [SyncVar] NetworkIdentities. + // dirtyBit is a mask like 00010 + protected void SetSyncVarNetworkBehaviour(T newBehaviour, ref T behaviourField, ulong dirtyBit, ref NetworkBehaviourSyncVar syncField) where T : NetworkBehaviour + { + if (GetSyncVarHookGuard(dirtyBit)) + return; + + uint newNetId = 0; + byte componentIndex = 0; + if (newBehaviour != null) + { + newNetId = newBehaviour.netId; + componentIndex = newBehaviour.ComponentIndex; + if (newNetId == 0) + { + Debug.LogWarning($"{nameof(SetSyncVarNetworkBehaviour)} NetworkIdentity {newBehaviour} has a zero netId. Maybe it is not spawned yet?"); + } + } + + syncField = new NetworkBehaviourSyncVar(newNetId, componentIndex); + + SetSyncVarDirtyBit(dirtyBit); + + // assign new one on the server, and in case we ever need it on client too + behaviourField = newBehaviour; + + // Debug.Log($"SetSyncVarNetworkBehaviour NetworkIdentity {GetType().Name} bit [{dirtyBit}] netIdField:{oldField}->{syncField}"); + } + + // helper function for [SyncVar] NetworkIdentities. + // -> ref GameObject as second argument makes OnDeserialize processing easier + protected T GetSyncVarNetworkBehaviour(NetworkBehaviourSyncVar syncNetBehaviour, ref T behaviourField) where T : NetworkBehaviour + { + // server always uses the field + // if neither, fallback to original field + // fixes: https://github.com/MirrorNetworking/Mirror/issues/3447 + if (isServer || !isClient) + { + return behaviourField; + } + + // client always looks up based on netId because objects might get in and out of range + // over and over again, which shouldn't null them forever + if (!NetworkClient.spawned.TryGetValue(syncNetBehaviour.netId, out NetworkIdentity identity)) + { + return null; + } + + behaviourField = identity.NetworkBehaviours[syncNetBehaviour.componentIndex] as T; + return behaviourField; + } + + protected static bool SyncVarEqual(T value, ref T fieldValue) + { + // newly initialized or changed value? + // value.Equals(fieldValue) allocates without 'where T : IEquatable' + // seems like we use EqualityComparer to avoid allocations, + // because not all SyncVars are IEquatable + return EqualityComparer.Default.Equals(value, fieldValue); + } + + // dirtyBit is a mask like 00010 + protected void SetSyncVar(T value, ref T fieldValue, ulong dirtyBit) + { + //Debug.Log($"SetSyncVar {GetType().Name} bit:{dirtyBit} fieldValue:{value}"); + SetSyncVarDirtyBit(dirtyBit); + fieldValue = value; + } + + /// Override to do custom serialization (instead of SyncVars/SyncLists). Use OnDeserialize too. + // if a class has syncvars, then OnSerialize/OnDeserialize are added + // automatically. + // + // initialState is true for full spawns, false for delta syncs. + // note: SyncVar hooks are only called when inital=false + public virtual void OnSerialize(NetworkWriter writer, bool initialState) + { + SerializeSyncObjects(writer, initialState); + SerializeSyncVars(writer, initialState); + } + + /// Override to do custom deserialization (instead of SyncVars/SyncLists). Use OnSerialize too. + public virtual void OnDeserialize(NetworkReader reader, bool initialState) + { + DeserializeSyncObjects(reader, initialState); + DeserializeSyncVars(reader, initialState); + } + + void SerializeSyncObjects(NetworkWriter writer, bool initialState) + { + // if initialState: write all SyncVars. + // otherwise write dirtyBits+dirty SyncVars + if (initialState) + SerializeObjectsAll(writer); + else + SerializeObjectsDelta(writer); + } + + void DeserializeSyncObjects(NetworkReader reader, bool initialState) + { + if (initialState) + { + DeserializeObjectsAll(reader); + } + else + { + DeserializeObjectsDelta(reader); + } + } + + // USED BY WEAVER + protected virtual void SerializeSyncVars(NetworkWriter writer, bool initialState) + { + // SyncVar are written here in subclass + + // if initialState + // write all SyncVars + // else + // write syncVarDirtyBits + // write dirty SyncVars + } + + // USED BY WEAVER + protected virtual void DeserializeSyncVars(NetworkReader reader, bool initialState) + { + // SyncVars are read here in subclass + + // if initialState + // read all SyncVars + // else + // read syncVarDirtyBits + // read dirty SyncVars + } + + public void SerializeObjectsAll(NetworkWriter writer) + { + for (int i = 0; i < syncObjects.Count; i++) + { + SyncObject syncObject = syncObjects[i]; + syncObject.OnSerializeAll(writer); + } + } + + public void SerializeObjectsDelta(NetworkWriter writer) + { + // write the mask + writer.WriteULong(syncObjectDirtyBits); + + // serializable objects, such as synclists + for (int i = 0; i < syncObjects.Count; i++) + { + // check dirty mask at nth bit + SyncObject syncObject = syncObjects[i]; + if ((syncObjectDirtyBits & (1UL << i)) != 0) + { + syncObject.OnSerializeDelta(writer); + } + } + } + + internal void DeserializeObjectsAll(NetworkReader reader) + { + for (int i = 0; i < syncObjects.Count; i++) + { + SyncObject syncObject = syncObjects[i]; + syncObject.OnDeserializeAll(reader); + } + } + + internal void DeserializeObjectsDelta(NetworkReader reader) + { + ulong dirty = reader.ReadULong(); + for (int i = 0; i < syncObjects.Count; i++) + { + // check dirty mask at nth bit + SyncObject syncObject = syncObjects[i]; + if ((dirty & (1UL << i)) != 0) + { + syncObject.OnDeserializeDelta(reader); + } + } + } + + // safely serialize each component in a way that one reading too much or + // too few bytes will show obvious, easy to resolve error messages. + // + // prevents the original UNET bug which started Mirror: + // https://github.com/vis2k/Mirror/issues/2617 + // where one component would read too much, and then all following reads + // on other entities would be mismatched, causing the weirdest errors. + // + // reads <> for 100% safety. + internal void Serialize(NetworkWriter writer, bool initialState) + { + // reserve length header to ensure the correct amount will be read. + // originally we used a 4 byte header (too bandwidth heavy). + // instead, let's "& 0xFF" the size. + // + // this is cleaner than barriers at the end of payload, because: + // - ensures the correct safety is read _before_ payload. + // - it's quite hard to break the check. + // a component would need to read/write the intented amount + // multiplied by 255 in order to miss the check. + // with barriers, reading 1 byte too much may still succeed if the + // next component's first byte matches the expected barrier. + // - we can still attempt to correct the invalid position via the + // safety length byte (we know that one is correct). + // + // it's just overall cleaner, and still low on bandwidth. + + // write placeholder length byte + // (jumping back later is WAY faster than allocating a temporary + // writer for the payload, then writing payload.size, payload) + int headerPosition = writer.Position; + writer.WriteByte(0); + int contentPosition = writer.Position; + + // write payload + try + { + // note this may not write anything if no syncIntervals elapsed + OnSerialize(writer, initialState); + } + catch (Exception e) + { + // show a detailed error and let the user know what went wrong + Debug.LogError($"OnSerialize failed for: object={name} component={GetType()} sceneId={netIdentity.sceneId:X}\n\n{e}"); + } + int endPosition = writer.Position; + + // fill in length hash as the last byte of the 4 byte length + writer.Position = headerPosition; + int size = endPosition - contentPosition; + byte safety = (byte)(size & 0xFF); + writer.WriteByte(safety); + writer.Position = endPosition; + + //Debug.Log($"OnSerializeSafely written for object {name} component:{GetType()} sceneId:{sceneId:X} header:{headerPosition} content:{contentPosition} end:{endPosition} contentSize:{endPosition - contentPosition}"); + } + + // correct the read size with the 1 byte length hash (by mischa). + // -> the component most likely read a few too many/few bytes. + // -> we know the correct last byte of the expected size (=the safety). + // -> attempt to reconstruct the size via safety byte. + // it will be correct unless someone wrote way way too much, + // as in > 255 bytes worth too much. + [MethodImpl(MethodImplOptions.AggressiveInlining)] + internal static int ErrorCorrection(int size, byte safety) + { + // clear the last byte which most likely contains the error + uint cleared = (uint)size & 0xFFFFFF00; + + // insert the safety which we know to be correct + return (int)(cleared | safety); + } + + // returns false in case of errors. + // server needs to know in order to disconnect on error. + internal bool Deserialize(NetworkReader reader, bool initialState) + { + // detect errors, but attempt to correct before returning + bool result = true; + + // read 1 byte length hash safety & capture beginning for size check + byte safety = reader.ReadByte(); + int chunkStart = reader.Position; + + // call OnDeserialize and wrap it in a try-catch block so there's no + // way to mess up another component's deserialization + try + { + //Debug.Log($"OnDeserializeSafely: {name} component:{GetType()} sceneId:{sceneId:X} length:{contentSize}"); + OnDeserialize(reader, initialState); + } + catch (Exception e) + { + // show a detailed error and let the user know what went wrong + Debug.LogError($"OnDeserialize failed Exception={e.GetType()} (see below) object={name} component={GetType()} netId={netId}. Possible Reasons:\n" + + $" * Do {GetType()}'s OnSerialize and OnDeserialize calls write the same amount of data? \n" + + $" * Was there an exception in {GetType()}'s OnSerialize/OnDeserialize code?\n" + + $" * Are the server and client the exact same project?\n" + + $" * Maybe this OnDeserialize call was meant for another GameObject? The sceneIds can easily get out of sync if the Hierarchy was modified only in the client OR the server. Try rebuilding both.\n\n" + + $"Exception {e}"); + result = false; + } + + // compare bytes read with length hash + int size = reader.Position - chunkStart; + byte sizeHash = (byte)(size & 0xFF); + if (sizeHash != safety) + { + // warn the user. + Debug.LogWarning($"{name} (netId={netId}): {GetType()} OnDeserialize size mismatch. It read {size} bytes, which caused a size hash mismatch of {sizeHash:X2} vs. {safety:X2}. Make sure that OnSerialize and OnDeserialize write/read the same amount of data in all cases."); + + // attempt to fix the position, so the following components + // don't all fail. this is very likely to work, unless the user + // read more than 255 bytes too many / too few. + // + // see test: SerializationSizeMismatch. + int correctedSize = ErrorCorrection(size, safety); + reader.Position = chunkStart + correctedSize; + result = false; + } + + return result; + } + + internal void ResetSyncObjects() + { + foreach (SyncObject syncObject in syncObjects) + { + syncObject.Reset(); + } + } + + /// Like Start(), but only called on server and host. + public virtual void OnStartServer() {} + + /// Stop event, only called on server and host. + public virtual void OnStopServer() {} + + /// Like Start(), but only called on client and host. + public virtual void OnStartClient() {} + + /// Stop event, only called on client and host. + public virtual void OnStopClient() {} + + /// Like Start(), but only called on client and host for the local player object. + public virtual void OnStartLocalPlayer() {} + + /// Stop event, but only called on client and host for the local player object. + public virtual void OnStopLocalPlayer() {} + + /// Like Start(), but only called for objects the client has authority over. + public virtual void OnStartAuthority() {} + + /// Stop event, only called for objects the client has authority over. + public virtual void OnStopAuthority() {} + + // Weaver injects this into inheriting classes to return true. + // allows runtime & tests to check if a type was weaved. + [EditorBrowsable(EditorBrowsableState.Never)] + public virtual bool Weaved() => false; + } +} diff --git a/Assets/Mirror/Core/NetworkBehaviour.cs.meta b/Assets/Mirror/Core/NetworkBehaviour.cs.meta new file mode 100644 index 0000000..f0bc195 --- /dev/null +++ b/Assets/Mirror/Core/NetworkBehaviour.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 655ee8cba98594f70880da5cc4dc442d +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/NetworkBehaviourSyncVar.cs b/Assets/Mirror/Core/NetworkBehaviourSyncVar.cs new file mode 100644 index 0000000..e9ed726 --- /dev/null +++ b/Assets/Mirror/Core/NetworkBehaviourSyncVar.cs @@ -0,0 +1,33 @@ +using System; + +namespace Mirror +{ + // backing field for sync NetworkBehaviour + public struct NetworkBehaviourSyncVar : IEquatable + { + public uint netId; + // limited to 255 behaviours per identity + public byte componentIndex; + + public NetworkBehaviourSyncVar(uint netId, int componentIndex) : this() + { + this.netId = netId; + this.componentIndex = (byte)componentIndex; + } + + public bool Equals(NetworkBehaviourSyncVar other) + { + return other.netId == netId && other.componentIndex == componentIndex; + } + + public bool Equals(uint netId, int componentIndex) + { + return this.netId == netId && this.componentIndex == componentIndex; + } + + public override string ToString() + { + return $"[netId:{netId} compIndex:{componentIndex}]"; + } + } +} diff --git a/Assets/Mirror/Core/NetworkBehaviourSyncVar.cs.meta b/Assets/Mirror/Core/NetworkBehaviourSyncVar.cs.meta new file mode 100644 index 0000000..47e3893 --- /dev/null +++ b/Assets/Mirror/Core/NetworkBehaviourSyncVar.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: b04fe7518657486089dfaf811db0b3ea +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/NetworkClient.cs b/Assets/Mirror/Core/NetworkClient.cs new file mode 100644 index 0000000..097dd3e --- /dev/null +++ b/Assets/Mirror/Core/NetworkClient.cs @@ -0,0 +1,1842 @@ +using System; +using System.Collections.Generic; +using System.Linq; +using Mirror.RemoteCalls; +using UnityEngine; + +namespace Mirror +{ + public enum ConnectState + { + None, + // connecting between Connect() and OnTransportConnected() + Connecting, + Connected, + // disconnecting between Disconnect() and OnTransportDisconnected() + Disconnecting, + Disconnected + } + + /// NetworkClient with connection to server. + public static partial class NetworkClient + { + // time & value snapshot interpolation are separate. + // -> time is interpolated globally on NetworkClient / NetworkConnection + // -> value is interpolated per-component, i.e. NetworkTransform. + // however, both need to be on the same send interval. + // + // additionally, server & client need to use the same send interval. + // otherwise it's too easy to accidentally cause interpolation issues if + // a component sends with client.interval but interpolates with + // server.interval, etc. + public static int sendRate => NetworkServer.sendRate; + public static float sendInterval => sendRate < int.MaxValue ? 1f / sendRate : 0; // for 30 Hz, that's 33ms + static double lastSendTime; + + // For security, it is recommended to disconnect a player if a networked + // action triggers an exception\nThis could prevent components being + // accessed in an undefined state, which may be an attack vector for + // exploits. + // + // However, some games may want to allow exceptions in order to not + // interrupt the player's experience. + public static bool exceptionsDisconnect = true; // security by default + + // message handlers by messageId + internal static readonly Dictionary handlers = + new Dictionary(); + + /// All spawned NetworkIdentities by netId. + // client sees OBSERVED spawned ones. + public static readonly Dictionary spawned = + new Dictionary(); + + /// Client's NetworkConnection to server. + public static NetworkConnection connection { get; internal set; } + + /// True if client is ready (= joined world). + // TODO redundant state. point it to .connection.isReady instead (& test) + // TODO OR remove NetworkConnection.isReady? unless it's used on server + // + // TODO maybe ClientState.Connected/Ready/AddedPlayer/etc.? + // way better for security if we can check states in callbacks + public static bool ready; + + /// NetworkIdentity of the localPlayer + public static NetworkIdentity localPlayer { get; internal set; } + + // NetworkClient state + internal static ConnectState connectState = ConnectState.None; + + /// active is true while a client is connecting/connected either as standalone or as host client. + // (= while the network is active) + public static bool active => connectState == ConnectState.Connecting || + connectState == ConnectState.Connected; + + /// active is true while the client is connected in host mode. + // naming consistent with NetworkServer.activeHost. + public static bool activeHost => connection is LocalConnectionToServer; + + /// Check if client is connecting (before connected). + public static bool isConnecting => connectState == ConnectState.Connecting; + + /// Check if client is connected (after connecting). + public static bool isConnected => connectState == ConnectState.Connected; + + // OnConnected / OnDisconnected used to be NetworkMessages that were + // invoked. this introduced a bug where external clients could send + // Connected/Disconnected messages over the network causing undefined + // behaviour. + // => public so that custom NetworkManagers can hook into it + public static Action OnConnectedEvent; + public static Action OnDisconnectedEvent; + public static Action OnErrorEvent; + + /// Registered spawnable prefabs by assetId. + public static readonly Dictionary prefabs = + new Dictionary(); + + // custom spawn / unspawn handlers by assetId. + // useful to support prefab pooling etc.: + // https://mirror-networking.gitbook.io/docs/guides/gameobjects/custom-spawnfunctions + internal static readonly Dictionary spawnHandlers = + new Dictionary(); + internal static readonly Dictionary unspawnHandlers = + new Dictionary(); + + // spawning + // internal for tests + internal static bool isSpawnFinished; + + // Disabled scene objects that can be spawned again, by sceneId. + internal static readonly Dictionary spawnableObjects = + new Dictionary(); + + internal static Unbatcher unbatcher = new Unbatcher(); + + // interest management component (optional) + // only needed for SetHostVisibility + public static InterestManagementBase aoi; + + // scene loading + public static bool isLoadingScene; + + // connection quality + // this is set by a virtual function in NetworkManager, + // which allows users to overwrite it with their own estimations. + public static ConnectionQuality connectionQuality = ConnectionQuality.ESTIMATING; + public static ConnectionQuality lastConnectionQuality = ConnectionQuality.ESTIMATING; + public static ConnectionQualityMethod connectionQualityMethod = ConnectionQualityMethod.Simple; + public static float connectionQualityInterval = 3; + static double lastConnectionQualityUpdate; + + /// + /// Invoked when connection quality changes. + /// First argument is the old quality, second argument is the new quality. + /// + public static event Action onConnectionQualityChanged; + + // initialization ////////////////////////////////////////////////////// + static void AddTransportHandlers() + { + // community Transports may forget to call OnDisconnected. + // which could cause handlers to be added twice with +=. + // ensure we always clear the old ones first. + // fixes: https://github.com/vis2k/Mirror/issues/3152 + RemoveTransportHandlers(); + + // += so that other systems can also hook into it (i.e. statistics) + Transport.active.OnClientConnected += OnTransportConnected; + Transport.active.OnClientDataReceived += OnTransportData; + Transport.active.OnClientDisconnected += OnTransportDisconnected; + Transport.active.OnClientError += OnTransportError; + } + + static void RemoveTransportHandlers() + { + // -= so that other systems can also hook into it (i.e. statistics) + Transport.active.OnClientConnected -= OnTransportConnected; + Transport.active.OnClientDataReceived -= OnTransportData; + Transport.active.OnClientDisconnected -= OnTransportDisconnected; + Transport.active.OnClientError -= OnTransportError; + } + + // connect ///////////////////////////////////////////////////////////// + // initialize is called before every connect + static void Initialize(bool hostMode) + { + // safety: ensure Weaving succeded. + // if it silently failed, we would get lots of 'writer not found' + // and other random errors at runtime instead. this is cleaner. + if (!WeaverFuse.Weaved()) + { + // if it failed, throw an exception to early exit all Connect calls. + throw new Exception("NetworkClient won't start because Weaving failed or didn't run."); + } + + // Debug.Log($"Client Connect: {address}"); + Debug.Assert(Transport.active != null, "There was no active transport when calling NetworkClient.Connect, If you are calling Connect manually then make sure to set 'Transport.active' first"); + + // reset unbatcher in case any batches from last session remain. + // need to do this in Initialize() so it runs for the host as well. + // fixes host mode scene transition receiving data from previous scene. + // credits: BigBoxVR + unbatcher = new Unbatcher(); + + // reset time interpolation on every new connect. + // ensures last sessions' state is cleared before starting again. + InitTimeInterpolation(); + + RegisterMessageHandlers(hostMode); + Transport.active.enabled = true; + } + + /// Connect client to a NetworkServer by address. + public static void Connect(string address) + { + Initialize(false); + + AddTransportHandlers(); + connectState = ConnectState.Connecting; + Transport.active.ClientConnect(address); + connection = new NetworkConnectionToServer(); + } + + /// Connect client to a NetworkServer by Uri. + public static void Connect(Uri uri) + { + Initialize(false); + + AddTransportHandlers(); + connectState = ConnectState.Connecting; + Transport.active.ClientConnect(uri); + connection = new NetworkConnectionToServer(); + } + + // TODO why are there two connect host methods? + // called from NetworkManager.FinishStartHost() + public static void ConnectHost() + { + Initialize(true); + connectState = ConnectState.Connected; + HostMode.SetupConnections(); + } + + // disconnect ////////////////////////////////////////////////////////// + /// Disconnect from server. + public static void Disconnect() + { + // only if connected or connecting. + // don't disconnect() again if already in the process of + // disconnecting or fully disconnected. + if (connectState != ConnectState.Connecting && + connectState != ConnectState.Connected) + return; + + // we are disconnecting until OnTransportDisconnected is called. + // setting state to Disconnected would stop OnTransportDisconnected + // from calling cleanup code because it would think we are already + // disconnected fully. + // TODO move to 'cleanup' code below if safe + connectState = ConnectState.Disconnecting; + ready = false; + + // call Disconnect on the NetworkConnection + connection?.Disconnect(); + + // IMPORTANT: do NOT clear connection here yet. + // we still need it in OnTransportDisconnected for callbacks. + // connection = null; + } + + // transport events //////////////////////////////////////////////////// + // called by Transport + static void OnTransportConnected() + { + if (connection != null) + { + // reset network time stats + NetworkTime.ResetStatics(); + + // the handler may want to send messages to the client + // thus we should set the connected state before calling the handler + connectState = ConnectState.Connected; + // ping right away after connecting so client gets new time asap + NetworkTime.SendPing(); + OnConnectedEvent?.Invoke(); + } + else Debug.LogError("Skipped Connect message handling because connection is null."); + } + + // helper function + static bool UnpackAndInvoke(NetworkReader reader, int channelId) + { + if (NetworkMessages.UnpackId(reader, out ushort msgType)) + { + // try to invoke the handler for that message + if (handlers.TryGetValue(msgType, out NetworkMessageDelegate handler)) + { + handler.Invoke(connection, reader, channelId); + + // message handler may disconnect client, making connection = null + // therefore must check for null to avoid NRE. + if (connection != null) + connection.lastMessageTime = Time.time; + + return true; + } + else + { + // message in a batch are NOT length prefixed to save bandwidth. + // every message needs to be handled and read until the end. + // otherwise it would overlap into the next message. + // => need to warn and disconnect to avoid undefined behaviour. + // => WARNING, not error. can happen if attacker sends random data. + Debug.LogWarning($"Unknown message id: {msgType}. This can happen if no handler was registered for this message."); + // simply return false. caller is responsible for disconnecting. + //connection.Disconnect(); + return false; + } + } + else + { + // => WARNING, not error. can happen if attacker sends random data. + Debug.LogWarning("Invalid message header."); + // simply return false. caller is responsible for disconnecting. + //connection.Disconnect(); + return false; + } + } + + // called by Transport + internal static void OnTransportData(ArraySegment data, int channelId) + { + if (connection != null) + { + // server might batch multiple messages into one packet. + // feed it to the Unbatcher. + // NOTE: we don't need to associate a channelId because we + // always process all messages in the batch. + if (!unbatcher.AddBatch(data)) + { + if (exceptionsDisconnect) + { + Debug.LogError($"NetworkClient: failed to add batch, disconnecting."); + connection.Disconnect(); + } + else + Debug.LogWarning($"NetworkClient: failed to add batch."); + + return; + } + + // process all messages in the batch. + // only while NOT loading a scene. + // if we get a scene change message, then we need to stop + // processing. otherwise we might apply them to the old scene. + // => fixes https://github.com/vis2k/Mirror/issues/2651 + // + // NOTE: is scene starts loading, then the rest of the batch + // would only be processed when OnTransportData is called + // the next time. + // => consider moving processing to NetworkEarlyUpdate. + while (!isLoadingScene && + unbatcher.GetNextMessage(out ArraySegment message, out double remoteTimestamp)) + { + using (NetworkReaderPooled reader = NetworkReaderPool.Get(message)) + { + // enough to read at least header size? + if (reader.Remaining >= NetworkMessages.IdSize) + { + // make remoteTimeStamp available to the user + connection.remoteTimeStamp = remoteTimestamp; + + // handle message + if (!UnpackAndInvoke(reader, channelId)) + { + // warn, disconnect and return if failed + // -> warning because attackers might send random data + // -> messages in a batch aren't length prefixed. + // failing to read one would cause undefined + // behaviour for every message afterwards. + // so we need to disconnect. + // -> return to avoid the below unbatches.count error. + // we already disconnected and handled it. + if (exceptionsDisconnect) + { + Debug.LogError($"NetworkClient: failed to unpack and invoke message. Disconnecting."); + connection.Disconnect(); + } + else + Debug.LogWarning($"NetworkClient: failed to unpack and invoke message."); + + return; + } + } + // otherwise disconnect + else + { + if (exceptionsDisconnect) + { + Debug.LogError($"NetworkClient: received Message was too short (messages should start with message id). Disconnecting."); + connection.Disconnect(); + } + else + Debug.LogWarning("NetworkClient: received Message was too short (messages should start with message id)"); + return; + } + } + } + + // if we weren't interrupted by a scene change, + // then all batched messages should have been processed now. + // if not, we need to log an error to avoid debugging hell. + // otherwise batches would silently grow. + // we need to log an error to avoid debugging hell. + // + // EXAMPLE: https://github.com/vis2k/Mirror/issues/2882 + // -> UnpackAndInvoke silently returned because no handler for id + // -> Reader would never be read past the end + // -> Batch would never be retired because end is never reached + // + // NOTE: prefixing every message in a batch with a length would + // avoid ever not reading to the end. for extra bandwidth. + // + // IMPORTANT: always keep this check to detect memory leaks. + // this took half a day to debug last time. + if (!isLoadingScene && unbatcher.BatchesCount > 0) + { + Debug.LogError($"Still had {unbatcher.BatchesCount} batches remaining after processing, even though processing was not interrupted by a scene change. This should never happen, as it would cause ever growing batches.\nPossible reasons:\n* A message didn't deserialize as much as it serialized\n*There was no message handler for a message id, so the reader wasn't read until the end."); + } + } + else Debug.LogError("Skipped Data message handling because connection is null."); + } + + // called by Transport + // IMPORTANT: often times when disconnecting, we call this from Mirror + // too because we want to remove the connection and handle + // the disconnect immediately. + // => which is fine as long as we guarantee it only runs once + // => which we do by setting the state to Disconnected! + internal static void OnTransportDisconnected() + { + // StopClient called from user code triggers Disconnected event + // from transport which calls StopClient again, so check here + // and short circuit running the Shutdown process twice. + if (connectState == ConnectState.Disconnected) return; + + // Raise the event before changing ConnectState + // because 'active' depends on this during shutdown + // + // previously OnDisconnected was only invoked if connection != null. + // however, if DNS resolve fails in Transport.Connect(), + // OnDisconnected would never be called because 'connection' is only + // created after the Transport.Connect() call. + // fixes: https://github.com/MirrorNetworking/Mirror/issues/3365 + OnDisconnectedEvent?.Invoke(); + + connectState = ConnectState.Disconnected; + ready = false; + snapshots.Clear(); + localTimeline = 0; + + // now that everything was handled, clear the connection. + // previously this was done in Disconnect() already, but we still + // need it for the above OnDisconnectedEvent. + connection = null; + + // transport handlers are only added when connecting. + // so only remove when actually disconnecting. + RemoveTransportHandlers(); + } + + // transport errors are forwarded to high level + static void OnTransportError(TransportError error, string reason) + { + // transport errors will happen. logging a warning is enough. + // make sure the user does not panic. + Debug.LogWarning($"Client Transport Error: {error}: {reason}. This is fine."); + OnErrorEvent?.Invoke(error, reason); + } + + // send //////////////////////////////////////////////////////////////// + /// Send a NetworkMessage to the server over the given channel. + public static void Send(T message, int channelId = Channels.Reliable) + where T : struct, NetworkMessage + { + if (connection != null) + { + if (connectState == ConnectState.Connected) + { + connection.Send(message, channelId); + } + else Debug.LogError("NetworkClient Send when not connected to a server"); + } + else Debug.LogError("NetworkClient Send with no connection"); + } + + // message handlers //////////////////////////////////////////////////// + internal static void RegisterMessageHandlers(bool hostMode) + { + // host mode client / remote client react to some messages differently. + // but we still need to add handlers for all of them to avoid + // 'message id not found' errors. + if (hostMode) + { + RegisterHandler(OnHostClientObjectDestroy); + RegisterHandler(OnHostClientObjectHide); + RegisterHandler(_ => { }, false); + RegisterHandler(OnHostClientSpawn); + // host mode doesn't need spawning + RegisterHandler(_ => { }); + // host mode doesn't need spawning + RegisterHandler(_ => { }); + // host mode doesn't need state updates + RegisterHandler(_ => { }); + } + else + { + RegisterHandler(OnObjectDestroy); + RegisterHandler(OnObjectHide); + RegisterHandler(NetworkTime.OnClientPong, false); + RegisterHandler(NetworkTime.OnClientPing, false); + RegisterHandler(OnSpawn); + RegisterHandler(OnObjectSpawnStarted); + RegisterHandler(OnObjectSpawnFinished); + RegisterHandler(OnEntityStateMessage); + } + + // These handlers are the same for host and remote clients + RegisterHandler(OnTimeSnapshotMessage); + RegisterHandler(OnChangeOwner); + RegisterHandler(OnRPCMessage); + } + + /// Register a handler for a message type T. Most should require authentication. + public static void RegisterHandler(Action handler, bool requireAuthentication = true) + where T : struct, NetworkMessage + { + ushort msgType = NetworkMessageId.Id; + if (handlers.ContainsKey(msgType)) + { + Debug.LogWarning($"NetworkClient.RegisterHandler replacing handler for {typeof(T).FullName}, id={msgType}. If replacement is intentional, use ReplaceHandler instead to avoid this warning."); + } + + // register Id <> Type in lookup for debugging. + NetworkMessages.Lookup[msgType] = typeof(T); + + // we use the same WrapHandler function for server and client. + // so let's wrap it to ignore the NetworkConnection parameter. + // it's not needed on client. it's always NetworkClient.connection. + void HandlerWrapped(NetworkConnection _, T value) => handler(value); + handlers[msgType] = NetworkMessages.WrapHandler((Action)HandlerWrapped, requireAuthentication, exceptionsDisconnect); + } + + /// Register a handler for a message type T. Most should require authentication. + // This version passes channelId to the handler. + public static void RegisterHandler(Action handler, bool requireAuthentication = true) + where T : struct, NetworkMessage + { + ushort msgType = NetworkMessageId.Id; + if (handlers.ContainsKey(msgType)) + { + Debug.LogWarning($"NetworkClient.RegisterHandler replacing handler for {typeof(T).FullName}, id={msgType}. If replacement is intentional, use ReplaceHandler instead to avoid this warning."); + } + + // register Id <> Type in lookup for debugging. + NetworkMessages.Lookup[msgType] = typeof(T); + + // we use the same WrapHandler function for server and client. + // so let's wrap it to ignore the NetworkConnection parameter. + // it's not needed on client. it's always NetworkClient.connection. + void HandlerWrapped(NetworkConnection _, T value, int channelId) => handler(value, channelId); + handlers[msgType] = NetworkMessages.WrapHandler((Action)HandlerWrapped, requireAuthentication, exceptionsDisconnect); + } + + // Deprecated 2024-01-21 + [Obsolete("Use ReplaceHandler without the NetworkConnection parameter instead. This version is obsolete and will be removed soon.")] + public static void ReplaceHandler(Action handler, bool requireAuthentication = true) + where T : struct, NetworkMessage + { + // we use the same WrapHandler function for server and client. + // so let's wrap it to ignore the NetworkConnection parameter. + // it's not needed on client. it's always NetworkClient.connection. + ushort msgType = NetworkMessageId.Id; + + // register Id <> Type in lookup for debugging. + NetworkMessages.Lookup[msgType] = typeof(T); + + void HandlerWrapped(NetworkConnection _, T value) => handler(_, value); + handlers[msgType] = NetworkMessages.WrapHandler((Action)HandlerWrapped, requireAuthentication, exceptionsDisconnect); + } + + /// Replace a handler for a particular message type. Should require authentication by default. + // RegisterHandler throws a warning (as it should) if a handler is assigned twice + // Use of ReplaceHandler makes it clear the user intended to replace the handler + public static void ReplaceHandler(Action handler, bool requireAuthentication = true) + where T : struct, NetworkMessage + { + // we use the same WrapHandler function for server and client. + // so let's wrap it to ignore the NetworkConnection parameter. + // it's not needed on client. it's always NetworkClient.connection. + ushort msgType = NetworkMessageId.Id; + + // register Id <> Type in lookup for debugging. + NetworkMessages.Lookup[msgType] = typeof(T); + + void HandlerWrapped(NetworkConnection _, T value) => handler(value); + handlers[msgType] = NetworkMessages.WrapHandler((Action)HandlerWrapped, requireAuthentication, exceptionsDisconnect); + } + + /// Replace a handler for a particular message type. Should require authentication by default. This version passes channelId to the handler. + // RegisterHandler throws a warning (as it should) if a handler is assigned twice + // Use of ReplaceHandler makes it clear the user intended to replace the handler + public static void ReplaceHandler(Action handler, bool requireAuthentication = true) + where T : struct, NetworkMessage + { + // we use the same WrapHandler function for server and client. + // so let's wrap it to ignore the NetworkConnection parameter. + // it's not needed on client. it's always NetworkClient.connection. + ushort msgType = NetworkMessageId.Id; + + // register Id <> Type in lookup for debugging. + NetworkMessages.Lookup[msgType] = typeof(T); + + void HandlerWrapped(NetworkConnection _, T value, int channelId) => handler(value, channelId); + handlers[msgType] = NetworkMessages.WrapHandler((Action)HandlerWrapped, requireAuthentication, exceptionsDisconnect); + } + + /// Unregister a message handler of type T. + public static bool UnregisterHandler() + where T : struct, NetworkMessage + { + // use int to minimize collisions + ushort msgType = NetworkMessageId.Id; + return handlers.Remove(msgType); + } + + // spawnable prefabs /////////////////////////////////////////////////// + /// Find the registered prefab for this asset id. + // Useful for debuggers + public static bool GetPrefab(uint assetId, out GameObject prefab) + { + prefab = null; + return assetId != 0 && + prefabs.TryGetValue(assetId, out prefab) && + prefab != null; + } + + /// Validates Prefab then adds it to prefabs dictionary. + static void RegisterPrefabIdentity(NetworkIdentity prefab) + { + if (prefab.assetId == 0) + { + Debug.LogError($"Can not Register '{prefab.name}' because it had empty assetid. If this is a scene Object use RegisterSpawnHandler instead"); + return; + } + + if (prefab.sceneId != 0) + { + Debug.LogError($"Can not Register '{prefab.name}' because it has a sceneId, make sure you are passing in the original prefab and not an instance in the scene."); + return; + } + + // disallow child NetworkIdentities. + // TODO likely not necessary anymore due to the new check in + // NetworkIdentity.OnValidate. + NetworkIdentity[] identities = prefab.GetComponentsInChildren(); + if (identities.Length > 1) + { + Debug.LogError($"Prefab '{prefab.name}' has multiple NetworkIdentity components. There should only be one NetworkIdentity on a prefab, and it must be on the root object."); + } + + if (prefabs.ContainsKey(prefab.assetId)) + { + GameObject existingPrefab = prefabs[prefab.assetId]; + Debug.LogWarning($"Replacing existing prefab with assetId '{prefab.assetId}'. Old prefab '{existingPrefab.name}', New prefab '{prefab.name}'"); + } + + if (spawnHandlers.ContainsKey(prefab.assetId) || unspawnHandlers.ContainsKey(prefab.assetId)) + { + Debug.LogWarning($"Adding prefab '{prefab.name}' with assetId '{prefab.assetId}' when spawnHandlers with same assetId already exists. If you want to use custom spawn handling, then remove the prefab from NetworkManager's registered prefabs first."); + } + + // Debug.Log($"Registering prefab '{prefab.name}' as asset:{prefab.assetId}"); + + prefabs[prefab.assetId] = prefab.gameObject; + } + + /// Register spawnable prefab with custom assetId. + // Note: newAssetId can not be set on GameObjects that already have an assetId + // Note: registering with assetId is useful for assetbundles etc. a lot + // of people use this. + public static void RegisterPrefab(GameObject prefab, uint newAssetId) + { + if (prefab == null) + { + Debug.LogError("Could not register prefab because it was null"); + return; + } + + if (newAssetId == 0) + { + Debug.LogError($"Could not register '{prefab.name}' with new assetId because the new assetId was empty"); + return; + } + + if (!prefab.TryGetComponent(out NetworkIdentity identity)) + { + Debug.LogError($"Could not register '{prefab.name}' since it contains no NetworkIdentity component"); + return; + } + + if (identity.assetId != 0 && identity.assetId != newAssetId) + { + Debug.LogError($"Could not register '{prefab.name}' to {newAssetId} because it already had an AssetId, Existing assetId {identity.assetId}"); + return; + } + + identity.assetId = newAssetId; + + RegisterPrefabIdentity(identity); + } + + /// Register spawnable prefab. + public static void RegisterPrefab(GameObject prefab) + { + if (prefab == null) + { + Debug.LogError("Could not register prefab because it was null"); + return; + } + + if (!prefab.TryGetComponent(out NetworkIdentity identity)) + { + Debug.LogError($"Could not register '{prefab.name}' since it contains no NetworkIdentity component"); + return; + } + + RegisterPrefabIdentity(identity); + } + + /// Register a spawnable prefab with custom assetId and custom spawn/unspawn handlers. + // Note: newAssetId can not be set on GameObjects that already have an assetId + // Note: registering with assetId is useful for assetbundles etc. a lot + // of people use this. + // TODO why do we have one with SpawnDelegate and one with SpawnHandlerDelegate? + public static void RegisterPrefab(GameObject prefab, uint newAssetId, SpawnDelegate spawnHandler, UnSpawnDelegate unspawnHandler) + { + // We need this check here because we don't want a null handler in the lambda expression below + if (spawnHandler == null) + { + Debug.LogError($"Can not Register null SpawnHandler for {newAssetId}"); + return; + } + + RegisterPrefab(prefab, newAssetId, msg => spawnHandler(msg.position, msg.assetId), unspawnHandler); + } + + /// Register a spawnable prefab with custom spawn/unspawn handlers. + // TODO why do we have one with SpawnDelegate and one with SpawnHandlerDelegate? + public static void RegisterPrefab(GameObject prefab, SpawnDelegate spawnHandler, UnSpawnDelegate unspawnHandler) + { + if (prefab == null) + { + Debug.LogError("Could not register handler for prefab because the prefab was null"); + return; + } + + if (!prefab.TryGetComponent(out NetworkIdentity identity)) + { + Debug.LogError($"Could not register handler for '{prefab.name}' since it contains no NetworkIdentity component"); + return; + } + + if (identity.sceneId != 0) + { + Debug.LogError($"Can not Register '{prefab.name}' because it has a sceneId, make sure you are passing in the original prefab and not an instance in the scene."); + return; + } + + if (identity.assetId == 0) + { + Debug.LogError($"Can not Register handler for '{prefab.name}' because it had empty assetid. If this is a scene Object use RegisterSpawnHandler instead"); + return; + } + + // We need this check here because we don't want a null handler in the lambda expression below + if (spawnHandler == null) + { + Debug.LogError($"Can not Register null SpawnHandler for {identity.assetId}"); + return; + } + + RegisterPrefab(prefab, msg => spawnHandler(msg.position, msg.assetId), unspawnHandler); + } + + /// Register a spawnable prefab with custom assetId and custom spawn/unspawn handlers. + // Note: newAssetId can not be set on GameObjects that already have an assetId + // Note: registering with assetId is useful for assetbundles etc. a lot + // of people use this. + // TODO why do we have one with SpawnDelegate and one with SpawnHandlerDelegate? + public static void RegisterPrefab(GameObject prefab, uint newAssetId, SpawnHandlerDelegate spawnHandler, UnSpawnDelegate unspawnHandler) + { + if (newAssetId == 0) + { + Debug.LogError($"Could not register handler for '{prefab.name}' with new assetId because the new assetId was empty"); + return; + } + + if (prefab == null) + { + Debug.LogError("Could not register handler for prefab because the prefab was null"); + return; + } + + if (!prefab.TryGetComponent(out NetworkIdentity identity)) + { + Debug.LogError($"Could not register handler for '{prefab.name}' since it contains no NetworkIdentity component"); + return; + } + + if (identity.assetId != 0 && identity.assetId != newAssetId) + { + Debug.LogError($"Could not register Handler for '{prefab.name}' to {newAssetId} because it already had an AssetId, Existing assetId {identity.assetId}"); + return; + } + + if (identity.sceneId != 0) + { + Debug.LogError($"Can not Register '{prefab.name}' because it has a sceneId, make sure you are passing in the original prefab and not an instance in the scene."); + return; + } + + identity.assetId = newAssetId; + uint assetId = identity.assetId; + + if (spawnHandler == null) + { + Debug.LogError($"Can not Register null SpawnHandler for {assetId}"); + return; + } + + if (unspawnHandler == null) + { + Debug.LogError($"Can not Register null UnSpawnHandler for {assetId}"); + return; + } + + if (spawnHandlers.ContainsKey(assetId) || unspawnHandlers.ContainsKey(assetId)) + { + Debug.LogWarning($"Replacing existing spawnHandlers for prefab '{prefab.name}' with assetId '{assetId}'"); + } + + if (prefabs.ContainsKey(assetId)) + { + // this is error because SpawnPrefab checks prefabs before handler + Debug.LogError($"assetId '{assetId}' is already used by prefab '{prefabs[assetId].name}', unregister the prefab first before trying to add handler"); + } + + NetworkIdentity[] identities = prefab.GetComponentsInChildren(); + if (identities.Length > 1) + { + Debug.LogError($"Prefab '{prefab.name}' has multiple NetworkIdentity components. There should only be one NetworkIdentity on a prefab, and it must be on the root object."); + } + + //Debug.Log($"Registering custom prefab {prefab.name} as asset:{assetId} {spawnHandler.GetMethodName()}/{unspawnHandler.GetMethodName()}"); + + spawnHandlers[assetId] = spawnHandler; + unspawnHandlers[assetId] = unspawnHandler; + } + + /// Register a spawnable prefab with custom spawn/unspawn handlers. + // TODO why do we have one with SpawnDelegate and one with SpawnHandlerDelegate? + public static void RegisterPrefab(GameObject prefab, SpawnHandlerDelegate spawnHandler, UnSpawnDelegate unspawnHandler) + { + if (prefab == null) + { + Debug.LogError("Could not register handler for prefab because the prefab was null"); + return; + } + + if (!prefab.TryGetComponent(out NetworkIdentity identity)) + { + Debug.LogError($"Could not register handler for '{prefab.name}' since it contains no NetworkIdentity component"); + return; + } + + if (identity.sceneId != 0) + { + Debug.LogError($"Can not Register '{prefab.name}' because it has a sceneId, make sure you are passing in the original prefab and not an instance in the scene."); + return; + } + + uint assetId = identity.assetId; + + if (assetId == 0) + { + Debug.LogError($"Can not Register handler for '{prefab.name}' because it had empty assetid. If this is a scene Object use RegisterSpawnHandler instead"); + return; + } + + if (spawnHandler == null) + { + Debug.LogError($"Can not Register null SpawnHandler for {assetId}"); + return; + } + + if (unspawnHandler == null) + { + Debug.LogError($"Can not Register null UnSpawnHandler for {assetId}"); + return; + } + + if (spawnHandlers.ContainsKey(assetId) || unspawnHandlers.ContainsKey(assetId)) + { + Debug.LogWarning($"Replacing existing spawnHandlers for prefab '{prefab.name}' with assetId '{assetId}'"); + } + + if (prefabs.ContainsKey(assetId)) + { + // this is error because SpawnPrefab checks prefabs before handler + Debug.LogError($"assetId '{assetId}' is already used by prefab '{prefabs[assetId].name}', unregister the prefab first before trying to add handler"); + } + + NetworkIdentity[] identities = prefab.GetComponentsInChildren(); + if (identities.Length > 1) + { + Debug.LogError($"Prefab '{prefab.name}' has multiple NetworkIdentity components. There should only be one NetworkIdentity on a prefab, and it must be on the root object."); + } + + //Debug.Log($"Registering custom prefab {prefab.name} as asset:{assetId} {spawnHandler.GetMethodName()}/{unspawnHandler.GetMethodName()}"); + + spawnHandlers[assetId] = spawnHandler; + unspawnHandlers[assetId] = unspawnHandler; + } + + /// Removes a registered spawn prefab that was setup with NetworkClient.RegisterPrefab. + public static void UnregisterPrefab(GameObject prefab) + { + if (prefab == null) + { + Debug.LogError("Could not unregister prefab because it was null"); + return; + } + + if (!prefab.TryGetComponent(out NetworkIdentity identity)) + { + Debug.LogError($"Could not unregister '{prefab.name}' since it contains no NetworkIdentity component"); + return; + } + + uint assetId = identity.assetId; + + prefabs.Remove(assetId); + spawnHandlers.Remove(assetId); + unspawnHandlers.Remove(assetId); + } + + // spawn handlers ////////////////////////////////////////////////////// + /// This is an advanced spawning function that registers a custom assetId with the spawning system. + // This can be used to register custom spawning methods for an assetId - + // instead of the usual method of registering spawning methods for a + // prefab. This should be used when no prefab exists for the spawned + // objects - such as when they are constructed dynamically at runtime + // from configuration data. + public static void RegisterSpawnHandler(uint assetId, SpawnDelegate spawnHandler, UnSpawnDelegate unspawnHandler) + { + // We need this check here because we don't want a null handler in the lambda expression below + if (spawnHandler == null) + { + Debug.LogError($"Can not Register null SpawnHandler for {assetId}"); + return; + } + + RegisterSpawnHandler(assetId, msg => spawnHandler(msg.position, msg.assetId), unspawnHandler); + } + + /// This is an advanced spawning function that registers a custom assetId with the spawning system. + // This can be used to register custom spawning methods for an assetId - + // instead of the usual method of registering spawning methods for a + // prefab. This should be used when no prefab exists for the spawned + // objects - such as when they are constructed dynamically at runtime + // from configuration data. + public static void RegisterSpawnHandler(uint assetId, SpawnHandlerDelegate spawnHandler, UnSpawnDelegate unspawnHandler) + { + if (spawnHandler == null) + { + Debug.LogError($"Can not Register null SpawnHandler for {assetId}"); + return; + } + + if (unspawnHandler == null) + { + Debug.LogError($"Can not Register null UnSpawnHandler for {assetId}"); + return; + } + + if (assetId == 0) + { + Debug.LogError("Can not Register SpawnHandler for empty assetId"); + return; + } + + if (spawnHandlers.ContainsKey(assetId) || unspawnHandlers.ContainsKey(assetId)) + { + Debug.LogWarning($"Replacing existing spawnHandlers for {assetId}"); + } + + if (prefabs.ContainsKey(assetId)) + { + // this is error because SpawnPrefab checks prefabs before handler + Debug.LogError($"assetId '{assetId}' is already used by prefab '{prefabs[assetId].name}'"); + } + + // Debug.Log("RegisterSpawnHandler asset {assetId} {spawnHandler.GetMethodName()}/{unspawnHandler.GetMethodName()}"); + + spawnHandlers[assetId] = spawnHandler; + unspawnHandlers[assetId] = unspawnHandler; + } + + /// Removes a registered spawn handler function that was registered with NetworkClient.RegisterHandler(). + public static void UnregisterSpawnHandler(uint assetId) + { + spawnHandlers.Remove(assetId); + unspawnHandlers.Remove(assetId); + } + + /// This clears the registered spawn prefabs and spawn handler functions for this client. + public static void ClearSpawners() + { + prefabs.Clear(); + spawnHandlers.Clear(); + unspawnHandlers.Clear(); + } + + internal static bool InvokeUnSpawnHandler(uint assetId, GameObject obj) + { + if (unspawnHandlers.TryGetValue(assetId, out UnSpawnDelegate handler) && handler != null) + { + handler(obj); + return true; + } + return false; + } + + // ready /////////////////////////////////////////////////////////////// + /// Sends Ready message to server, indicating that we loaded the scene, ready to enter the game. + // This could be for example when a client enters an ongoing game and + // has finished loading the current scene. The server should respond to + // the SYSTEM_READY event with an appropriate handler which instantiates + // the players object for example. + public static bool Ready() + { + // Debug.Log($"NetworkClient.Ready() called with connection {conn}"); + if (ready) + { + Debug.LogError("NetworkClient is already ready. It shouldn't be called twice."); + return false; + } + + // need a valid connection to become ready + if (connection == null) + { + Debug.LogError("Ready() called with invalid connection object: conn=null"); + return false; + } + + // Set these before sending the ReadyMessage, otherwise host client + // will fail in InternalAddPlayer with null readyConnection. + // TODO this is redundant. have one source of truth for .ready + ready = true; + connection.isReady = true; + + // Tell server we're ready to have a player object spawned + connection.Send(new ReadyMessage()); + return true; + } + + // add player ////////////////////////////////////////////////////////// + // called from message handler for Owner message + internal static void InternalAddPlayer(NetworkIdentity identity) + { + //Debug.Log("NetworkClient.InternalAddPlayer"); + + // NOTE: It can be "normal" when changing scenes for the player to be destroyed and recreated. + // But, the player structures are not cleaned up, we'll just replace the old player + localPlayer = identity; + + // NOTE: we DONT need to set isClient=true here, because OnStartClient + // is called before OnStartLocalPlayer, hence it's already set. + // localPlayer.isClient = true; + + // TODO this check might not be necessary + //if (readyConnection != null) + if (ready && connection != null) + { + connection.identity = identity; + } + else Debug.LogWarning("NetworkClient can't AddPlayer before being ready. Please call NetworkClient.Ready() first. Clients are considered ready after joining the game world."); + } + + /// Sends AddPlayer message to the server, indicating that we want to join the world. + public static bool AddPlayer() + { + // ensure valid ready connection + if (connection == null) + { + Debug.LogError("AddPlayer requires a valid NetworkClient.connection."); + return false; + } + + // UNET checked 'if readyConnection != null'. + // in other words, we need a connection and we need to be ready. + if (!ready) + { + Debug.LogError("AddPlayer requires a ready NetworkClient."); + return false; + } + + if (connection.identity != null) + { + Debug.LogError("NetworkClient.AddPlayer: a PlayerController was already added. Did you call AddPlayer twice?"); + return false; + } + + // Debug.Log($"NetworkClient.AddPlayer() called with connection {readyConnection}"); + connection.Send(new AddPlayerMessage()); + return true; + } + + // spawning //////////////////////////////////////////////////////////// + internal static void ApplySpawnPayload(NetworkIdentity identity, SpawnMessage message) + { + if (message.assetId != 0) + identity.assetId = message.assetId; + + if (!identity.gameObject.activeSelf) + { + identity.gameObject.SetActive(true); + } + + // apply local values for VR support + identity.transform.localPosition = message.position; + identity.transform.localRotation = message.rotation; + identity.transform.localScale = message.scale; + + // configure flags + // the below DeserializeClient call invokes SyncVarHooks. + // flags always need to be initialized before that. + // fixes: https://github.com/MirrorNetworking/Mirror/issues/3259 + identity.isOwned = message.isOwner; + identity.netId = message.netId; + + if (message.isLocalPlayer) + InternalAddPlayer(identity); + + // configure isClient/isLocalPlayer flags. + // => after InternalAddPlayer. can't initialize .isLocalPlayer + // before InternalAddPlayer sets .localPlayer + // => before DeserializeClient, otherwise SyncVar hooks wouldn't + // have isClient/isLocalPlayer set yet. + // fixes: https://github.com/MirrorNetworking/Mirror/issues/3259 + InitializeIdentityFlags(identity); + + // deserialize components if any payload + // (Count is 0 if there were no components) + if (message.payload.Count > 0) + { + using (NetworkReaderPooled payloadReader = NetworkReaderPool.Get(message.payload)) + { + identity.DeserializeClient(payloadReader, true); + } + } + + spawned[message.netId] = identity; + if (identity.isOwned) connection?.owned.Add(identity); + + // the initial spawn with OnObjectSpawnStarted/Finished calls all + // object's OnStartClient/OnStartLocalPlayer after they were all + // spawned. + // this only happens once though. + // for all future spawns, we need to call OnStartClient/LocalPlayer + // here immediately since there won't be another OnObjectSpawnFinished. + if (isSpawnFinished) + { + InvokeIdentityCallbacks(identity); + } + } + + // Finds Existing Object with NetId or spawns a new one using AssetId or sceneId + internal static bool FindOrSpawnObject(SpawnMessage message, out NetworkIdentity identity) + { + // was the object already spawned? + identity = GetExistingObject(message.netId); + + // if found, return early + if (identity != null) + { + return true; + } + + if (message.assetId == 0 && message.sceneId == 0) + { + Debug.LogError($"OnSpawn message with netId '{message.netId}' has no AssetId or sceneId"); + return false; + } + + identity = message.sceneId == 0 ? SpawnPrefab(message) : SpawnSceneObject(message.sceneId); + + if (identity == null) + { + Debug.LogError($"Could not spawn assetId={message.assetId} scene={message.sceneId:X} netId={message.netId}"); + return false; + } + + return true; + } + + static NetworkIdentity GetExistingObject(uint netid) + { + spawned.TryGetValue(netid, out NetworkIdentity identity); + return identity; + } + + static NetworkIdentity SpawnPrefab(SpawnMessage message) + { + // custom spawn handler for this prefab? (for prefab pools etc.) + // + // IMPORTANT: look for spawn handlers BEFORE looking for registered + // prefabs. Unspawning also looks for unspawn handlers + // before falling back to regular Destroy. this needs to + // be consistent. + // https://github.com/vis2k/Mirror/issues/2705 + if (spawnHandlers.TryGetValue(message.assetId, out SpawnHandlerDelegate handler)) + { + GameObject obj = handler(message); + if (obj == null) + { + Debug.LogError($"Spawn Handler returned null, Handler assetId '{message.assetId}'"); + return null; + } + + if (!obj.TryGetComponent(out NetworkIdentity identity)) + { + Debug.LogError($"Object Spawned by handler did not have a NetworkIdentity, Handler assetId '{message.assetId}'"); + return null; + } + + return identity; + } + + // otherwise look in NetworkManager registered prefabs + if (GetPrefab(message.assetId, out GameObject prefab)) + { + GameObject obj = GameObject.Instantiate(prefab, message.position, message.rotation); + //Debug.Log($"Client spawn handler instantiating [netId{message.netId} asset ID:{message.assetId} pos:{message.position} rotation:{message.rotation}]"); + return obj.GetComponent(); + } + + Debug.LogError($"Failed to spawn server object, did you forget to add it to the NetworkManager? assetId={message.assetId} netId={message.netId}"); + return null; + } + + static NetworkIdentity SpawnSceneObject(ulong sceneId) + { + NetworkIdentity identity = GetAndRemoveSceneObject(sceneId); + if (identity == null) + { + Debug.LogError($"Spawn scene object not found for {sceneId:X}. Make sure that client and server use exactly the same project. This only happens if the hierarchy gets out of sync."); + + // dump the whole spawnable objects dict for easier debugging + //foreach (KeyValuePair kvp in spawnableObjects) + // Debug.Log($"Spawnable: SceneId={kvp.Key:X} name={kvp.Value.name}"); + } + //else Debug.Log($"Client spawn for [netId:{msg.netId}] [sceneId:{msg.sceneId:X}] obj:{identity}"); + return identity; + } + + static NetworkIdentity GetAndRemoveSceneObject(ulong sceneId) + { + if (spawnableObjects.TryGetValue(sceneId, out NetworkIdentity identity)) + { + spawnableObjects.Remove(sceneId); + return identity; + } + return null; + } + + /// Call this after loading/unloading a scene in the client after connection to register the spawnable objects + public static void PrepareToSpawnSceneObjects() + { + // remove existing items, they will be re-added below + spawnableObjects.Clear(); + + // finds all NetworkIdentity currently loaded by unity (includes disabled objects) + NetworkIdentity[] allIdentities = Resources.FindObjectsOfTypeAll(); + foreach (NetworkIdentity identity in allIdentities) + { + // add all unspawned NetworkIdentities to spawnable objects + // need to check netId to make sure object is not spawned + // fixes: https://github.com/MirrorNetworking/Mirror/issues/3541 + // PrepareToSpawnSceneObjects may be called multiple times in case + // the ObjectSpawnStarted message is received multiple times. + if (Utils.IsSceneObject(identity) && + identity.netId == 0) + { + if (spawnableObjects.TryGetValue(identity.sceneId, out NetworkIdentity existingIdentity)) + { + string msg = $"NetworkClient: Duplicate sceneId {identity.sceneId} detected on {identity.gameObject.name} and {existingIdentity.gameObject.name}\n" + + $"This can happen if a networked object is persisted in DontDestroyOnLoad through loading / changing to the scene where it originated,\n" + + $"otherwise you may need to open and re-save the {identity.gameObject.scene} to reset scene id's."; + Debug.LogWarning(msg, identity.gameObject); + } + else + { + spawnableObjects.Add(identity.sceneId, identity); + } + } + } + } + + internal static void OnObjectSpawnStarted(ObjectSpawnStartedMessage _) + { + // Debug.Log("SpawnStarted"); + PrepareToSpawnSceneObjects(); + isSpawnFinished = false; + } + + internal static void OnObjectSpawnFinished(ObjectSpawnFinishedMessage _) + { + // paul: Initialize the objects in the same order as they were + // initialized in the server. This is important if spawned objects + // use data from scene objects + foreach (NetworkIdentity identity in spawned.Values.OrderBy(uv => uv.netId)) + { + // NetworkIdentities should always be removed from .spawned when + // they are destroyed. for safety, let's double check here. + if (identity != null) + { + BootstrapIdentity(identity); + } + else Debug.LogWarning("Found null entry in NetworkClient.spawned. This is unexpected. Was the NetworkIdentity not destroyed properly?"); + } + isSpawnFinished = true; + } + + // host mode callbacks ///////////////////////////////////////////////// + static void OnHostClientObjectDestroy(ObjectDestroyMessage message) + { + //Debug.Log($"NetworkClient.OnLocalObjectObjDestroy netId:{message.netId}"); + + // remove from owned (if any) + if (spawned.TryGetValue(message.netId, out NetworkIdentity identity)) + connection.owned.Remove(identity); + + spawned.Remove(message.netId); + } + + static void OnHostClientObjectHide(ObjectHideMessage message) + { + //Debug.Log($"ClientScene::OnLocalObjectObjHide netId:{message.netId}"); + if (spawned.TryGetValue(message.netId, out NetworkIdentity identity) && + identity != null) + { + if (aoi != null) + aoi.SetHostVisibility(identity, false); + } + } + + internal static void OnHostClientSpawn(SpawnMessage message) + { + // on host mode, the object already exist in NetworkServer.spawned. + // simply add it to NetworkClient.spawned too. + if (NetworkServer.spawned.TryGetValue(message.netId, out NetworkIdentity identity) && identity != null) + { + spawned[message.netId] = identity; + if (message.isOwner) connection.owned.Add(identity); + + // now do the actual 'spawning' on host mode + if (message.isLocalPlayer) + InternalAddPlayer(identity); + + // set visibility before invoking OnStartClient etc. callbacks + if (aoi != null) + aoi.SetHostVisibility(identity, true); + + identity.isOwned = message.isOwner; + BootstrapIdentity(identity); + } + } + + // client-only mode callbacks ////////////////////////////////////////// + static void OnEntityStateMessage(EntityStateMessage message) + { + // Debug.Log($"NetworkClient.OnUpdateVarsMessage {msg.netId}"); + if (spawned.TryGetValue(message.netId, out NetworkIdentity identity) && identity != null) + { + using (NetworkReaderPooled reader = NetworkReaderPool.Get(message.payload)) + identity.DeserializeClient(reader, false); + } + else Debug.LogWarning($"Did not find target for sync message for {message.netId}. Were all prefabs added to the NetworkManager's spawnable list?\nNote: this can be completely normal because UDP messages may arrive out of order, so this message might have arrived after a Destroy message."); + } + + static void OnRPCMessage(RpcMessage message) + { + // Debug.Log($"NetworkClient.OnRPCMessage hash:{message.functionHash} netId:{message.netId}"); + if (spawned.TryGetValue(message.netId, out NetworkIdentity identity)) + { + using (NetworkReaderPooled reader = NetworkReaderPool.Get(message.payload)) + identity.HandleRemoteCall(message.componentIndex, message.functionHash, RemoteCallType.ClientRpc, reader); + } + // Rpcs often can't be applied if interest management unspawned them + } + + static void OnObjectHide(ObjectHideMessage message) => DestroyObject(message.netId); + + internal static void OnObjectDestroy(ObjectDestroyMessage message) => DestroyObject(message.netId); + + internal static void OnSpawn(SpawnMessage message) + { + // Debug.Log($"Client spawn handler instantiating netId={msg.netId} assetID={msg.assetId} sceneId={msg.sceneId:X} pos={msg.position}"); + if (FindOrSpawnObject(message, out NetworkIdentity identity)) + { + ApplySpawnPayload(identity, message); + } + } + + internal static void OnChangeOwner(ChangeOwnerMessage message) + { + NetworkIdentity identity = GetExistingObject(message.netId); + + if (identity != null) + ChangeOwner(identity, message); + else + Debug.LogError($"OnChangeOwner: Could not find object with netId {message.netId}"); + } + + // ChangeOwnerMessage contains new 'owned' and new 'localPlayer' + // that we need to apply to the identity. + internal static void ChangeOwner(NetworkIdentity identity, ChangeOwnerMessage message) + { + // local player before, but not anymore? + // call OnStopLocalPlayer before setting new values. + if (identity.isLocalPlayer && !message.isLocalPlayer) + { + identity.OnStopLocalPlayer(); + } + + // set ownership flag (aka authority) + identity.isOwned = message.isOwner; + + // Add / Remove to client's connectionToServer.owned hashset. + if (identity.isOwned) + connection?.owned.Add(identity); + else + connection?.owned.Remove(identity); + + // Call OnStartAuthority / OnStopAuthority + identity.NotifyAuthority(); + + // set localPlayer flag + identity.isLocalPlayer = message.isLocalPlayer; + + // identity is now local player. set our static helper field to it. + if (identity.isLocalPlayer) + { + localPlayer = identity; + identity.connectionToServer = connection; + identity.OnStartLocalPlayer(); + } + // identity's isLocalPlayer was set to false. + // clear our static localPlayer IF (and only IF) it was that one before. + else if (localPlayer == identity) + { + localPlayer = null; + // TODO set .connectionToServer to null for old local player? + // since we set it in the above 'if' case too. + } + } + + // set up NetworkIdentity flags on the client. + // needs to be separate from invoking callbacks. + // cleaner, and some places need to set flags first. + static void InitializeIdentityFlags(NetworkIdentity identity) + { + // initialize flags before invoking callbacks. + // this way isClient/isLocalPlayer is correct during callbacks. + // fixes: https://github.com/MirrorNetworking/Mirror/issues/3362 + identity.isClient = true; + identity.isLocalPlayer = localPlayer == identity; + + // .connectionToServer is only available for local players. + // set it here, before invoking any callbacks. + // this way it's available in _all_ callbacks. + if (identity.isLocalPlayer) + identity.connectionToServer = connection; + } + + // invoke NetworkIdentity callbacks on the client. + // needs to be separate from configuring flags. + // cleaner, and some places need to set flags first. + static void InvokeIdentityCallbacks(NetworkIdentity identity) + { + // invoke OnStartAuthority + identity.NotifyAuthority(); + + // invoke OnStartClient + identity.OnStartClient(); + + // invoke OnStartLocalPlayer + if (identity.isLocalPlayer) + identity.OnStartLocalPlayer(); + } + + // configure flags & invoke callbacks + static void BootstrapIdentity(NetworkIdentity identity) + { + InitializeIdentityFlags(identity); + InvokeIdentityCallbacks(identity); + } + + // broadcast /////////////////////////////////////////////////////////// + static void BroadcastTimeSnapshot() + { + Send(new TimeSnapshotMessage(), Channels.Unreliable); + } + + // make sure Broadcast() is only called every sendInterval. + // calling it every update() would require too much bandwidth. + static void Broadcast() + { + // joined the world yet? + if (!connection.isReady) return; + + // nothing to do in host mode. server already knows the state. + if (NetworkServer.active) return; + + // send time snapshot every sendInterval. + BroadcastTimeSnapshot(); + + // for each entity that the client owns + foreach (NetworkIdentity identity in connection.owned) + { + // make sure it's not null or destroyed. + // (which can happen if someone uses + // GameObject.Destroy instead of + // NetworkServer.Destroy) + if (identity != null) + { + using (NetworkWriterPooled writer = NetworkWriterPool.Get()) + { + // get serialization for this entity viewed by this connection + // (if anything was serialized this time) + identity.SerializeClient(writer); + if (writer.Position > 0) + { + // send state update message + EntityStateMessage message = new EntityStateMessage + { + netId = identity.netId, + payload = writer.ToArraySegment() + }; + Send(message); + } + } + } + // spawned list should have no null entries because we + // always call Remove in OnObjectDestroy everywhere. + // if it does have null then we missed something. + else Debug.LogWarning($"Found 'null' entry in owned list for client. This is unexpected behaviour."); + } + } + + // update ////////////////////////////////////////////////////////////// + // NetworkEarlyUpdate called before any Update/FixedUpdate + // (we add this to the UnityEngine in NetworkLoop) + internal static void NetworkEarlyUpdate() + { + // process all incoming messages first before updating the world + if (Transport.active != null) + Transport.active.ClientEarlyUpdate(); + + // time snapshot interpolation + UpdateTimeInterpolation(); + } + + // NetworkLateUpdate called after any Update/FixedUpdate/LateUpdate + // (we add this to the UnityEngine in NetworkLoop) + internal static void NetworkLateUpdate() + { + // broadcast ClientToServer components while active + if (active) + { + // broadcast every sendInterval. + // AccurateInterval to avoid update frequency inaccuracy issues: + // https://github.com/vis2k/Mirror/pull/3153 + // + // for example, host mode server doesn't set .targetFrameRate. + // Broadcast() would be called every tick. + // snapshots might be sent way too often, etc. + // + // during tests, we always call Broadcast() though. + // + // also important for syncInterval=0 components like + // NetworkTransform, so they can sync on same interval as time + // snapshots _but_ not every single tick. + // + // Unity 2019 doesn't have Time.timeAsDouble yet + if (!Application.isPlaying || + AccurateInterval.Elapsed(NetworkTime.localTime, sendInterval, ref lastSendTime)) + { + Broadcast(); + } + + UpdateConnectionQuality(); + } + + // Connection Quality ////////////////////////////////////////////////// + // uses 'pragmatic' version based on snapshot interpolation by default. + void UpdateConnectionQuality() + { + // only recalculate every few seconds + // we don't want to fire Good->Bad->Good->Bad dozens of times per second. + if (connectionQualityInterval > 0 && NetworkTime.time > lastConnectionQualityUpdate + connectionQualityInterval) + { + lastConnectionQualityUpdate = NetworkTime.time; + + switch (connectionQualityMethod) + { + case ConnectionQualityMethod.Simple: + connectionQuality = ConnectionQualityHeuristics.Simple(NetworkTime.rtt, NetworkTime.rttVariance); + break; + case ConnectionQualityMethod.Pragmatic: + connectionQuality = ConnectionQualityHeuristics.Pragmatic(initialBufferTime, bufferTime); + break; + } + + if (lastConnectionQuality != connectionQuality) + { + // Invoke the event before assigning the new value so + // the event handler can compare old and new values. + onConnectionQualityChanged?.Invoke(lastConnectionQuality, connectionQuality); + lastConnectionQuality = connectionQuality; + } + } + } + + // update connections to flush out messages _after_ broadcast + // local connection? + if (connection is LocalConnectionToServer localConnection) + { + localConnection.Update(); + } + // remote connection? + else if (connection is NetworkConnectionToServer remoteConnection) + { + // only update things while connected + if (active && connectState == ConnectState.Connected) + { + // update NetworkTime + NetworkTime.UpdateClient(); + + // update connection to flush out batched messages + remoteConnection.Update(); + } + } + + // process all outgoing messages after updating the world + if (Transport.active != null) + Transport.active.ClientLateUpdate(); + } + + // destroy ///////////////////////////////////////////////////////////// + /// Destroys all networked objects on the client. + // Note: NetworkServer.CleanupNetworkIdentities does the same on server. + public static void DestroyAllClientObjects() + { + // user can modify spawned lists which causes InvalidOperationException + // list can modified either in UnSpawnHandler or in OnDisable/OnDestroy + // we need the Try/Catch so that the rest of the shutdown does not get stopped + try + { + foreach (NetworkIdentity identity in spawned.Values) + { + if (identity != null && identity.gameObject != null) + { + if (identity.isLocalPlayer) + identity.OnStopLocalPlayer(); + + identity.OnStopClient(); + + // NetworkClient.Shutdown calls DestroyAllClientObjects. + // which destroys all objects in NetworkClient.spawned. + // => NC.spawned contains owned & observed objects + // => in host mode, we CAN NOT destroy observed objects. + // => that would destroy them other connection's objects + // on the host server, making them disconnect. + // https://github.com/vis2k/Mirror/issues/2954 + bool hostOwned = identity.connectionToServer is LocalConnectionToServer; + bool shouldDestroy = !identity.isServer || hostOwned; + if (shouldDestroy) + { + bool wasUnspawned = InvokeUnSpawnHandler(identity.assetId, identity.gameObject); + + // unspawned objects should be reset for reuse later. + if (wasUnspawned) + { + identity.ResetState(); + } + // without unspawn handler, we need to disable/destroy. + else + { + // scene objects are reset and disabled. + // they always stay in the scene, we don't destroy them. + if (identity.sceneId != 0) + { + identity.ResetState(); + identity.gameObject.SetActive(false); + } + // spawned objects are destroyed + else + { + GameObject.Destroy(identity.gameObject); + } + } + } + } + } + spawned.Clear(); + connection?.owned.Clear(); + } + catch (InvalidOperationException e) + { + Debug.LogException(e); + Debug.LogError("Could not DestroyAllClientObjects because spawned list was modified during loop, make sure you are not modifying NetworkIdentity.spawned by calling NetworkServer.Destroy or NetworkServer.Spawn in OnDestroy or OnDisable."); + } + } + + static void DestroyObject(uint netId) + { + // Debug.Log($"NetworkClient.OnObjDestroy netId: {netId}"); + if (spawned.TryGetValue(netId, out NetworkIdentity identity) && identity != null) + { + if (identity.isLocalPlayer) + identity.OnStopLocalPlayer(); + + identity.OnStopClient(); + + // custom unspawn handler for this prefab? (for prefab pools etc.) + if (InvokeUnSpawnHandler(identity.assetId, identity.gameObject)) + { + // reset object after user's handler + identity.ResetState(); + } + // otherwise fall back to default Destroy + else if (identity.sceneId == 0) + { + // don't call reset before destroy so that values are still set in OnDestroy + GameObject.Destroy(identity.gameObject); + } + // scene object.. disable it in scene instead of destroying + else + { + identity.gameObject.SetActive(false); + spawnableObjects[identity.sceneId] = identity; + // reset for scene objects + identity.ResetState(); + } + + // remove from dictionary no matter how it is unspawned + connection.owned.Remove(identity); // if any + spawned.Remove(netId); + } + //else Debug.LogWarning($"Did not find target for destroy message for {netId}"); + } + + // shutdown //////////////////////////////////////////////////////////// + /// Shutdown the client. + // RuntimeInitializeOnLoadMethod -> fast playmode without domain reload + [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)] + public static void Shutdown() + { + //Debug.Log("Shutting down client."); + + // objects need to be destroyed before spawners are cleared + // fixes: https://github.com/MirrorNetworking/Mirror/issues/3334 + DestroyAllClientObjects(); + + // calls prefabs.Clear(); + // calls spawnHandlers.Clear(); + // calls unspawnHandlers.Clear(); + ClearSpawners(); + + spawned.Clear(); + connection?.owned.Clear(); + handlers.Clear(); + spawnableObjects.Clear(); + + // IMPORTANT: do NOT call NetworkIdentity.ResetStatics() here! + // calling StopClient() in host mode would reset nextNetId to 1, + // causing next connection to have a duplicate netId accidentally. + // => see also: https://github.com/vis2k/Mirror/issues/2954 + //NetworkIdentity.ResetStatics(); + // => instead, reset only the client sided statics. + NetworkIdentity.ResetClientStatics(); + + // disconnect the client connection. + // we do NOT call Transport.Shutdown, because someone only called + // NetworkClient.Shutdown. we can't assume that the server is + // supposed to be shut down too! + if (Transport.active != null) + Transport.active.ClientDisconnect(); + + // reset statics + connectState = ConnectState.None; + connection = null; + localPlayer = null; + ready = false; + isSpawnFinished = false; + isLoadingScene = false; + lastSendTime = 0; + + unbatcher = new Unbatcher(); + + // clear events. someone might have hooked into them before, but + // we don't want to use those hooks after Shutdown anymore. + OnConnectedEvent = null; + OnDisconnectedEvent = null; + OnErrorEvent = null; + } + + // GUI ///////////////////////////////////////////////////////////////// + // called from NetworkManager to display timeline interpolation status. + // useful to indicate catchup / slowdown / dynamic adjustment etc. + public static void OnGUI() + { + // only if in world + if (!ready) return; + + GUILayout.BeginArea(new Rect(10, 5, 1020, 50)); + + GUILayout.BeginHorizontal("Box"); + GUILayout.Label("Snapshot Interp.:"); + // color while catching up / slowing down + if (localTimescale > 1) GUI.color = Color.green; // green traffic light = go fast + else if (localTimescale < 1) GUI.color = Color.red; // red traffic light = go slow + else GUI.color = Color.white; + GUILayout.Box($"timeline: {localTimeline:F2}"); + GUILayout.Box($"buffer: {snapshots.Count}"); + GUILayout.Box($"DriftEMA: {NetworkClient.driftEma.Value:F2}"); + GUILayout.Box($"DelTimeEMA: {NetworkClient.deliveryTimeEma.Value:F2}"); + GUILayout.Box($"timescale: {localTimescale:F2}"); + GUILayout.Box($"BTM: {NetworkClient.bufferTimeMultiplier:F2}"); // current dynamically adjusted multiplier + GUILayout.Box($"RTT: {NetworkTime.rtt * 1000:F0}ms"); + GUILayout.Box($"PredErrUNADJ: {NetworkTime.predictionErrorUnadjusted * 1000:F0}ms"); + GUILayout.Box($"PredErrADJ: {NetworkTime.predictionErrorAdjusted * 1000:F0}ms"); + GUILayout.EndHorizontal(); + + GUILayout.EndArea(); + } + } +} diff --git a/Assets/Mirror/Core/NetworkClient.cs.meta b/Assets/Mirror/Core/NetworkClient.cs.meta new file mode 100644 index 0000000..20cb211 --- /dev/null +++ b/Assets/Mirror/Core/NetworkClient.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: abe6be14204d94224a3e7cd99dd2ea73 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/NetworkClient_TimeInterpolation.cs b/Assets/Mirror/Core/NetworkClient_TimeInterpolation.cs new file mode 100644 index 0000000..8d28859 --- /dev/null +++ b/Assets/Mirror/Core/NetworkClient_TimeInterpolation.cs @@ -0,0 +1,168 @@ +using System; +using System.Collections.Generic; +using UnityEngine; + +namespace Mirror +{ + public static partial class NetworkClient + { + // snapshot interpolation settings ///////////////////////////////////// + // TODO expose the settings to the user later. + // via NetMan or NetworkClientConfig or NetworkClient as component etc. + public static SnapshotInterpolationSettings snapshotSettings = new SnapshotInterpolationSettings(); + + // snapshot interpolation runtime data ///////////////////////////////// + // buffer time is dynamically adjusted. + // store the current multiplier here, without touching the original in settings. + // this way we can easily reset to or compare with original where needed. + public static double bufferTimeMultiplier; + + // original buffer time based on the settings + // dynamically adjusted buffer time based on dynamically adjusted multiplier + public static double initialBufferTime => NetworkServer.sendInterval * snapshotSettings.bufferTimeMultiplier; + public static double bufferTime => NetworkServer.sendInterval * bufferTimeMultiplier; + + // + public static SortedList snapshots = new SortedList(); + + // for smooth interpolation, we need to interpolate along server time. + // any other time (arrival on client, client local time, etc.) is not + // going to give smooth results. + // in other words, this is the remote server's time, but adjusted. + // + // internal for use from NetworkTime. + // double for long running servers, see NetworkTime comments. + internal static double localTimeline; + + // catchup / slowdown adjustments are applied to timescale, + // to be adjusted in every update instead of when receiving messages. + internal static double localTimescale = 1; + + // catchup ///////////////////////////////////////////////////////////// + + + // we use EMA to average the last second worth of snapshot time diffs. + // manually averaging the last second worth of values with a for loop + // would be the same, but a moving average is faster because we only + // ever add one value. + static ExponentialMovingAverage driftEma; + + // dynamic buffer time adjustment ////////////////////////////////////// + // dynamically adjusts bufferTimeMultiplier for smooth results. + // to understand how this works, try this manually: + // + // - disable dynamic adjustment + // - set jitter = 0.2 (20% is a lot!) + // - notice some stuttering + // - disable interpolation to see just how much jitter this really is(!) + // - enable interpolation again + // - manually increase bufferTimeMultiplier to 3-4 + // ... the cube slows down (blue) until it's smooth + // - with dynamic adjustment enabled, it will set 4 automatically + // ... the cube slows down (blue) until it's smooth as well + // + // note that 20% jitter is extreme. + // for this to be perfectly smooth, set the safety tolerance to '2'. + // but realistically this is not necessary, and '1' is enough. + [Header("Snapshot Interpolation: Dynamic Adjustment")] + [Tooltip("Automatically adjust bufferTimeMultiplier for smooth results.\nSets a low multiplier on stable connections, and a high multiplier on jittery connections.")] + public static bool dynamicAdjustment = true; + + [Tooltip("Safety buffer that is always added to the dynamic bufferTimeMultiplier adjustment.")] + public static float dynamicAdjustmentTolerance = 1; // 1 is realistically just fine, 2 is very very safe even for 20% jitter. can be half a frame too. (see above comments) + + [Tooltip("Dynamic adjustment is computed over n-second exponential moving average standard deviation.")] + public static int deliveryTimeEmaDuration = 2; // 1-2s recommended to capture average delivery time + static ExponentialMovingAverage deliveryTimeEma; // average delivery time (standard deviation gives average jitter) + + // OnValidate: see NetworkClient.cs + // add snapshot & initialize client interpolation time if needed + + // initialization called from Awake + static void InitTimeInterpolation() + { + // reset timeline, localTimescale & snapshots from last session (if any) + bufferTimeMultiplier = snapshotSettings.bufferTimeMultiplier; + localTimeline = 0; + localTimescale = 1; + snapshots.Clear(); + + // initialize EMA with 'emaDuration' seconds worth of history. + // 1 second holds 'sendRate' worth of values. + // multiplied by emaDuration gives n-seconds. + driftEma = new ExponentialMovingAverage(NetworkServer.sendRate * snapshotSettings.driftEmaDuration); + deliveryTimeEma = new ExponentialMovingAverage(NetworkServer.sendRate * snapshotSettings.deliveryTimeEmaDuration); + } + + // server sends TimeSnapshotMessage every sendInterval. + // batching already includes the remoteTimestamp. + // we simply insert it on-message here. + // => only for reliable channel. unreliable would always arrive earlier. + static void OnTimeSnapshotMessage(TimeSnapshotMessage _) + { + // insert another snapshot for snapshot interpolation. + // before calling OnDeserialize so components can use + // NetworkTime.time and NetworkTime.timeStamp. + + // Unity 2019 doesn't have Time.timeAsDouble yet + OnTimeSnapshot(new TimeSnapshot(connection.remoteTimeStamp, NetworkTime.localTime)); + } + + // see comments at the top of this file + public static void OnTimeSnapshot(TimeSnapshot snap) + { + // Debug.Log($"NetworkClient: OnTimeSnapshot @ {snap.remoteTime:F3}"); + + // (optional) dynamic adjustment + if (snapshotSettings.dynamicAdjustment) + { + // set bufferTime on the fly. + // shows in inspector for easier debugging :) + bufferTimeMultiplier = SnapshotInterpolation.DynamicAdjustment( + NetworkServer.sendInterval, + deliveryTimeEma.StandardDeviation, + snapshotSettings.dynamicAdjustmentTolerance + ); + } + + // insert into the buffer & initialize / adjust / catchup + SnapshotInterpolation.InsertAndAdjust( + snapshots, + snapshotSettings.bufferLimit, + snap, + ref localTimeline, + ref localTimescale, + NetworkServer.sendInterval, + bufferTime, + snapshotSettings.catchupSpeed, + snapshotSettings.slowdownSpeed, + ref driftEma, + snapshotSettings.catchupNegativeThreshold, + snapshotSettings.catchupPositiveThreshold, + ref deliveryTimeEma); + + // Debug.Log($"inserted TimeSnapshot remote={snap.remoteTime:F2} local={snap.localTime:F2} total={snapshots.Count}"); + } + + // call this from early update, so the timeline is safe to use in update + static void UpdateTimeInterpolation() + { + // only while we have snapshots. + // timeline starts when the first snapshot arrives. + if (snapshots.Count > 0) + { + // progress local timeline. + // NetworkTime uses unscaled time and ignores Time.timeScale. + // fixes Time.timeScale getting server & client time out of sync: + // https://github.com/MirrorNetworking/Mirror/issues/3409 + SnapshotInterpolation.StepTime(Time.unscaledDeltaTime, ref localTimeline, localTimescale); + + // progress local interpolation. + // TimeSnapshot doesn't interpolate anything. + // this is merely to keep removing older snapshots. + SnapshotInterpolation.StepInterpolation(snapshots, localTimeline, out _, out _, out double t); + // Debug.Log($"NetworkClient SnapshotInterpolation @ {localTimeline:F2} t={t:F2}"); + } + } + } +} diff --git a/Assets/Mirror/Core/NetworkClient_TimeInterpolation.cs.meta b/Assets/Mirror/Core/NetworkClient_TimeInterpolation.cs.meta new file mode 100644 index 0000000..3c52ae1 --- /dev/null +++ b/Assets/Mirror/Core/NetworkClient_TimeInterpolation.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: ad039071a9cc487b9f7831d28bbe8e83 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/NetworkConnection.cs b/Assets/Mirror/Core/NetworkConnection.cs new file mode 100644 index 0000000..6317eca --- /dev/null +++ b/Assets/Mirror/Core/NetworkConnection.cs @@ -0,0 +1,207 @@ +using System; +using System.Collections.Generic; +using System.Runtime.CompilerServices; +using UnityEngine; + +namespace Mirror +{ + /// Base NetworkConnection class for server-to-client and client-to-server connection. + public abstract class NetworkConnection + { + public const int LocalConnectionId = 0; + + /// Unique identifier for this connection that is assigned by the transport layer. + // assigned by transport, this id is unique for every connection on server. + // clients don't know their own id and they don't know other client's ids. + public readonly int connectionId; + + /// Flag that indicates the client has been authenticated. + public bool isAuthenticated; + + /// General purpose object to hold authentication data, character selection, tokens, etc. + public object authenticationData; + + /// A server connection is ready after joining the game world. + // TODO move this to ConnectionToClient so the flag only lives on server + // connections? clients could use NetworkClient.ready to avoid redundant + // state. + public bool isReady; + + /// Last time a message was received for this connection. Includes system and user messages. + public float lastMessageTime; + + /// This connection's main object (usually the player object). + public NetworkIdentity identity { get; internal set; } + + /// All NetworkIdentities owned by this connection. Can be main player, pets, etc. + // .owned is now valid both on server and on client. + // IMPORTANT: this needs to be , not . + // fixes a bug where DestroyOwnedObjects wouldn't find the + // netId anymore: https://github.com/vis2k/Mirror/issues/1380 + // Works fine with NetworkIdentity pointers though. + public readonly HashSet owned = new HashSet(); + + // batching from server to client & client to server. + // fewer transport calls give us significantly better performance/scale. + // + // for a 64KB max message transport and 64 bytes/message on average, we + // reduce transport calls by a factor of 1000. + // + // depending on the transport, this can give 10x performance. + // + // Dictionary because we have multiple channels. + protected Dictionary batches = new Dictionary(); + + /// last batch's remote timestamp. not interpolated. useful for NetworkTransform etc. + // for any given NetworkMessage/Rpc/Cmd/OnSerialize, this was the time + // on the REMOTE END when it was sent. + // + // NOTE: this is NOT in NetworkTime, it needs to be per-connection + // because the server receives different batch timestamps from + // different connections. + public double remoteTimeStamp { get; internal set; } + + internal NetworkConnection() + { + // set lastTime to current time when creating connection to make + // sure it isn't instantly kicked for inactivity + lastMessageTime = Time.time; + } + + internal NetworkConnection(int networkConnectionId) : this() + { + connectionId = networkConnectionId; + } + + // TODO if we only have Reliable/Unreliable, then we could initialize + // two batches and avoid this code + protected Batcher GetBatchForChannelId(int channelId) + { + // get existing or create new writer for the channelId + Batcher batch; + if (!batches.TryGetValue(channelId, out batch)) + { + // get max batch size for this channel + int threshold = Transport.active.GetBatchThreshold(channelId); + + // create batcher + batch = new Batcher(threshold); + batches[channelId] = batch; + } + return batch; + } + + // Send stage one: NetworkMessage + /// Send a NetworkMessage to this connection over the given channel. + public void Send(T message, int channelId = Channels.Reliable) + where T : struct, NetworkMessage + { + using (NetworkWriterPooled writer = NetworkWriterPool.Get()) + { + // pack message + NetworkMessages.Pack(message, writer); + + // validate packet size immediately. + // we know how much can fit into one batch at max. + // if it's larger, log an error immediately with the type . + // previously we only logged in Update() when processing batches, + // but there we don't have type information anymore. + int max = NetworkMessages.MaxMessageSize(channelId); + if (writer.Position > max) + { + Debug.LogError($"NetworkConnection.Send: message of type {typeof(T)} with a size of {writer.Position} bytes is larger than the max allowed message size in one batch: {max}.\nThe message was dropped, please make it smaller."); + return; + } + + // send allocation free + NetworkDiagnostics.OnSend(message, channelId, writer.Position, 1); + Send(writer.ToArraySegment(), channelId); + } + } + + // Send stage two: serialized NetworkMessage as ArraySegment + // internal because no one except Mirror should send bytes directly to + // the client. they would be detected as a message. send messages instead. + // => make sure to validate message size before calling Send! + [MethodImpl(MethodImplOptions.AggressiveInlining)] + internal virtual void Send(ArraySegment segment, int channelId = Channels.Reliable) + { + //Debug.Log($"ConnectionSend {this} bytes:{BitConverter.ToString(segment.Array, segment.Offset, segment.Count)}"); + + // add to batch no matter what. + // batching will try to fit as many as possible into MTU. + // but we still allow > MTU, e.g. kcp max packet size 144kb. + // those are simply sent as single batches. + // + // IMPORTANT: do NOT send > batch sized messages directly: + // - data race: large messages would be sent directly. small + // messages would be sent in the batch at the end of frame + // - timestamps: if batching assumes a timestamp, then large + // messages need that too. + // + // NOTE: we ALWAYS batch. it's not optional, because the + // receiver needs timestamps for NT etc. + // + // NOTE: we do NOT ValidatePacketSize here yet. the final packet + // will be the full batch, including timestamp. + GetBatchForChannelId(channelId).AddMessage(segment, NetworkTime.localTime); + } + + // Send stage three: hand off to transport + protected abstract void SendToTransport(ArraySegment segment, int channelId = Channels.Reliable); + + // flush batched messages at the end of every Update. + internal virtual void Update() + { + // go through batches for all channels + // foreach ((int key, Batcher batcher) in batches) // Unity 2020 doesn't support deconstruct yet + foreach (KeyValuePair kvp in batches) + { + // make and send as many batches as necessary from the stored + // messages. + using (NetworkWriterPooled writer = NetworkWriterPool.Get()) + { + // make a batch with our local time (double precision) + while (kvp.Value.GetBatch(writer)) + { + // message size is validated in Send, with test coverage. + // we can send directly without checking again. + ArraySegment segment = writer.ToArraySegment(); + + // send to transport + SendToTransport(segment, kvp.Key); + //UnityEngine.Debug.Log($"sending batch of {writer.Position} bytes for channel={kvp.Key} connId={connectionId}"); + + // reset writer for each new batch + writer.Position = 0; + } + } + } + } + + /// Check if we received a message within the last 'timeout' seconds. + internal virtual bool IsAlive(float timeout) => Time.time - lastMessageTime < timeout; + + /// Disconnects this connection. + // for future reference, here is how Disconnects work in Mirror. + // + // first, there are two types of disconnects: + // * voluntary: the other end simply disconnected + // * involuntary: server disconnects a client by itself + // + // UNET had special (complex) code to handle both cases differently. + // + // Mirror handles both cases the same way: + // * Disconnect is called from TOP to BOTTOM + // NetworkServer/Client -> NetworkConnection -> Transport.Disconnect() + // * Disconnect is handled from BOTTOM to TOP + // Transport.OnDisconnected -> ... + // + // in other words, calling Disconnect() does no cleanup whatsoever. + // it simply asks the transport to disconnect. + // then later the transport events will do the clean up. + public abstract void Disconnect(); + + public override string ToString() => $"connection({connectionId})"; + } +} diff --git a/Assets/Mirror/Core/NetworkConnection.cs.meta b/Assets/Mirror/Core/NetworkConnection.cs.meta new file mode 100644 index 0000000..32c4ba2 --- /dev/null +++ b/Assets/Mirror/Core/NetworkConnection.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 11ea41db366624109af1f0834bcdde2f +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/NetworkConnectionToClient.cs b/Assets/Mirror/Core/NetworkConnectionToClient.cs new file mode 100644 index 0000000..361b00c --- /dev/null +++ b/Assets/Mirror/Core/NetworkConnectionToClient.cs @@ -0,0 +1,220 @@ +using System; +using System.Collections.Generic; +using System.Runtime.CompilerServices; +using UnityEngine; + +namespace Mirror +{ + public class NetworkConnectionToClient : NetworkConnection + { + // rpcs are collected in a buffer, and then flushed out together. + // this way we don't need one NetworkMessage per rpc. + // => prepares for LocalWorldState as well. + // ensure max size when adding! + readonly NetworkWriter reliableRpcs = new NetworkWriter(); + readonly NetworkWriter unreliableRpcs = new NetworkWriter(); + + public virtual string address => Transport.active.ServerGetClientAddress(connectionId); + + /// NetworkIdentities that this connection can see + // TODO move to server's NetworkConnectionToClient? + public readonly HashSet observing = new HashSet(); + + // unbatcher + public Unbatcher unbatcher = new Unbatcher(); + + // server runs a time snapshot interpolation for each client's local time. + // this is necessary for client auth movement to still be smooth on the + // server for host mode. + // TODO move them along server's timeline in the future. + // perhaps with an offset. + // for now, keep compatibility by manually constructing a timeline. + ExponentialMovingAverage driftEma; + ExponentialMovingAverage deliveryTimeEma; // average delivery time (standard deviation gives average jitter) + public double remoteTimeline; + public double remoteTimescale; + double bufferTimeMultiplier = 2; + double bufferTime => NetworkServer.sendInterval * bufferTimeMultiplier; + + // + readonly SortedList snapshots = new SortedList(); + + // Snapshot Buffer size limit to avoid ever growing list memory consumption attacks from clients. + public int snapshotBufferSizeLimit = 64; + + // ping for rtt (round trip time) + // useful for statistics, lag compensation, etc. + double lastPingTime = 0; + internal ExponentialMovingAverage _rtt = new ExponentialMovingAverage(NetworkTime.PingWindowSize); + + /// Round trip time (in seconds) that it takes a message to go server->client->server. + public double rtt => _rtt.Value; + + public NetworkConnectionToClient(int networkConnectionId) + : base(networkConnectionId) + { + // initialize EMA with 'emaDuration' seconds worth of history. + // 1 second holds 'sendRate' worth of values. + // multiplied by emaDuration gives n-seconds. + driftEma = new ExponentialMovingAverage(NetworkServer.sendRate * NetworkClient.snapshotSettings.driftEmaDuration); + deliveryTimeEma = new ExponentialMovingAverage(NetworkServer.sendRate * NetworkClient.snapshotSettings.deliveryTimeEmaDuration); + + // buffer limit should be at least multiplier to have enough in there + snapshotBufferSizeLimit = Mathf.Max((int)NetworkClient.snapshotSettings.bufferTimeMultiplier, snapshotBufferSizeLimit); + } + + public void OnTimeSnapshot(TimeSnapshot snapshot) + { + // protect against ever growing buffer size attacks + if (snapshots.Count >= snapshotBufferSizeLimit) return; + + // (optional) dynamic adjustment + if (NetworkClient.snapshotSettings.dynamicAdjustment) + { + // set bufferTime on the fly. + // shows in inspector for easier debugging :) + bufferTimeMultiplier = SnapshotInterpolation.DynamicAdjustment( + NetworkServer.sendInterval, + deliveryTimeEma.StandardDeviation, + NetworkClient.snapshotSettings.dynamicAdjustmentTolerance + ); + // Debug.Log($"[Server]: {name} delivery std={serverDeliveryTimeEma.StandardDeviation} bufferTimeMult := {bufferTimeMultiplier} "); + } + + // insert into the server buffer & initialize / adjust / catchup + SnapshotInterpolation.InsertAndAdjust( + snapshots, + NetworkClient.snapshotSettings.bufferLimit, + snapshot, + ref remoteTimeline, + ref remoteTimescale, + NetworkServer.sendInterval, + bufferTime, + NetworkClient.snapshotSettings.catchupSpeed, + NetworkClient.snapshotSettings.slowdownSpeed, + ref driftEma, + NetworkClient.snapshotSettings.catchupNegativeThreshold, + NetworkClient.snapshotSettings.catchupPositiveThreshold, + ref deliveryTimeEma + ); + } + + public void UpdateTimeInterpolation() + { + // timeline starts when the first snapshot arrives. + if (snapshots.Count > 0) + { + // progress local timeline. + SnapshotInterpolation.StepTime(Time.unscaledDeltaTime, ref remoteTimeline, remoteTimescale); + + // progress local interpolation. + // TimeSnapshot doesn't interpolate anything. + // this is merely to keep removing older snapshots. + SnapshotInterpolation.StepInterpolation(snapshots, remoteTimeline, out _, out _, out _); + // Debug.Log($"NetworkClient SnapshotInterpolation @ {localTimeline:F2} t={t:F2}"); + } + } + + // Send stage three: hand off to transport + [MethodImpl(MethodImplOptions.AggressiveInlining)] + protected override void SendToTransport(ArraySegment segment, int channelId = Channels.Reliable) => + Transport.active.ServerSend(connectionId, segment, channelId); + + protected virtual void UpdatePing() + { + // localTime (double) instead of Time.time for accuracy over days + if (NetworkTime.localTime >= lastPingTime + NetworkTime.PingInterval) + { + // TODO it would be safer for the server to store the last N + // messages' timestamp and only send a message number. + // This way client's can't just modify the timestamp. + // predictedTime parameter is 0 because the server doesn't predict. + NetworkPingMessage pingMessage = new NetworkPingMessage(NetworkTime.localTime, 0); + Send(pingMessage, Channels.Unreliable); + lastPingTime = NetworkTime.localTime; + } + } + + internal override void Update() + { + UpdatePing(); + base.Update(); + } + + /// Disconnects this connection. + public override void Disconnect() + { + // set not ready and handle clientscene disconnect in any case + // (might be client or host mode here) + isReady = false; + reliableRpcs.Position = 0; + unreliableRpcs.Position = 0; + Transport.active.ServerDisconnect(connectionId); + + // IMPORTANT: NetworkConnection.Disconnect() is NOT called for + // voluntary disconnects from the other end. + // -> so all 'on disconnect' cleanup code needs to be in + // OnTransportDisconnect, where it's called for both voluntary + // and involuntary disconnects! + } + + internal void AddToObserving(NetworkIdentity netIdentity) + { + observing.Add(netIdentity); + + // spawn identity for this conn + NetworkServer.ShowForConnection(netIdentity, this); + } + + internal void RemoveFromObserving(NetworkIdentity netIdentity, bool isDestroyed) + { + observing.Remove(netIdentity); + + if (!isDestroyed) + { + // hide identity for this conn + NetworkServer.HideForConnection(netIdentity, this); + } + } + + internal void RemoveFromObservingsObservers() + { + foreach (NetworkIdentity netIdentity in observing) + { + netIdentity.RemoveObserver(this); + } + observing.Clear(); + } + + internal void AddOwnedObject(NetworkIdentity obj) + { + owned.Add(obj); + } + + internal void RemoveOwnedObject(NetworkIdentity obj) + { + owned.Remove(obj); + } + + internal void DestroyOwnedObjects() + { + // create a copy because the list might be modified when destroying + HashSet tmp = new HashSet(owned); + foreach (NetworkIdentity netIdentity in tmp) + { + if (netIdentity != null) + { + // unspawn scene objects, destroy instantiated objects. + // fixes: https://github.com/MirrorNetworking/Mirror/issues/3538 + if (netIdentity.sceneId != 0) + NetworkServer.UnSpawn(netIdentity.gameObject); + else + NetworkServer.Destroy(netIdentity.gameObject); + } + } + + // clear the hashset because we destroyed them all + owned.Clear(); + } + } +} diff --git a/Assets/Mirror/Core/NetworkConnectionToClient.cs.meta b/Assets/Mirror/Core/NetworkConnectionToClient.cs.meta new file mode 100644 index 0000000..6001a71 --- /dev/null +++ b/Assets/Mirror/Core/NetworkConnectionToClient.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: bb2195f8b29d24f0680a57fde2e9fd09 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/NetworkConnectionToServer.cs b/Assets/Mirror/Core/NetworkConnectionToServer.cs new file mode 100644 index 0000000..496813d --- /dev/null +++ b/Assets/Mirror/Core/NetworkConnectionToServer.cs @@ -0,0 +1,24 @@ +using System; +using System.Runtime.CompilerServices; + +namespace Mirror +{ + public class NetworkConnectionToServer : NetworkConnection + { + // Send stage three: hand off to transport + [MethodImpl(MethodImplOptions.AggressiveInlining)] + protected override void SendToTransport(ArraySegment segment, int channelId = Channels.Reliable) => + Transport.active.ClientSend(segment, channelId); + + /// Disconnects this connection. + public override void Disconnect() + { + // set not ready and handle clientscene disconnect in any case + // (might be client or host mode here) + // TODO remove redundant state. have one source of truth for .ready! + isReady = false; + NetworkClient.ready = false; + Transport.active.ClientDisconnect(); + } + } +} diff --git a/Assets/Mirror/Core/NetworkConnectionToServer.cs.meta b/Assets/Mirror/Core/NetworkConnectionToServer.cs.meta new file mode 100644 index 0000000..3424b58 --- /dev/null +++ b/Assets/Mirror/Core/NetworkConnectionToServer.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 761977cbf38a34ded9dd89de45445675 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/NetworkDiagnostics.cs b/Assets/Mirror/Core/NetworkDiagnostics.cs new file mode 100644 index 0000000..1cdc96f --- /dev/null +++ b/Assets/Mirror/Core/NetworkDiagnostics.cs @@ -0,0 +1,63 @@ +using System; + +namespace Mirror +{ + /// Profiling statistics for tool to subscribe to (profiler etc.) + public static class NetworkDiagnostics + { + /// Describes an outgoing message + public readonly struct MessageInfo + { + /// The message being sent + public readonly NetworkMessage message; + /// channel through which the message was sent + public readonly int channel; + /// how big was the message (does not include transport headers) + public readonly int bytes; + /// How many connections was the message sent to. + public readonly int count; + + internal MessageInfo(NetworkMessage message, int channel, int bytes, int count) + { + this.message = message; + this.channel = channel; + this.bytes = bytes; + this.count = count; + } + } + + /// Event for when Mirror sends a message. Can be subscribed to. + public static event Action OutMessageEvent; + + /// Event for when Mirror receives a message. Can be subscribed to. + public static event Action InMessageEvent; + + // RuntimeInitializeOnLoadMethod -> fast playmode without domain reload + [UnityEngine.RuntimeInitializeOnLoadMethod] + static void ResetStatics() + { + InMessageEvent = null; + OutMessageEvent = null; + } + + internal static void OnSend(T message, int channel, int bytes, int count) + where T : struct, NetworkMessage + { + if (count > 0 && OutMessageEvent != null) + { + MessageInfo outMessage = new MessageInfo(message, channel, bytes, count); + OutMessageEvent?.Invoke(outMessage); + } + } + + internal static void OnReceive(T message, int channel, int bytes) + where T : struct, NetworkMessage + { + if (InMessageEvent != null) + { + MessageInfo inMessage = new MessageInfo(message, channel, bytes, 1); + InMessageEvent?.Invoke(inMessage); + } + } + } +} diff --git a/Assets/Mirror/Core/NetworkDiagnostics.cs.meta b/Assets/Mirror/Core/NetworkDiagnostics.cs.meta new file mode 100644 index 0000000..fe37316 --- /dev/null +++ b/Assets/Mirror/Core/NetworkDiagnostics.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: c3754b39e5f8740fd93f3337b2c4274e +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/NetworkIdentity.cs b/Assets/Mirror/Core/NetworkIdentity.cs new file mode 100644 index 0000000..aed8251 --- /dev/null +++ b/Assets/Mirror/Core/NetworkIdentity.cs @@ -0,0 +1,1390 @@ +using System; +using System.Collections.Generic; +using System.Runtime.CompilerServices; +using Mirror.RemoteCalls; +using UnityEngine; +using UnityEngine.Serialization; + +#if UNITY_EDITOR +using UnityEditor; + +#if UNITY_2021_2_OR_NEWER +using UnityEditor.SceneManagement; +#else +using UnityEditor.Experimental.SceneManagement; +#endif +#endif + +namespace Mirror +{ + // Default = use interest management + // ForceHidden = useful to hide monsters while they respawn etc. + // ForceShown = useful to have score NetworkIdentities that always broadcast + // to everyone etc. + public enum Visibility { Default, ForceHidden, ForceShown } + + public struct NetworkIdentitySerialization + { + // IMPORTANT: int tick avoids floating point inaccuracy over days/weeks + public int tick; + public NetworkWriter ownerWriter; + public NetworkWriter observersWriter; + } + + /// NetworkIdentity identifies objects across the network. + [DisallowMultipleComponent] + // NetworkIdentity.Awake initializes all NetworkComponents. + // let's make sure it's always called before their Awake's. + [DefaultExecutionOrder(-1)] + [AddComponentMenu("Network/Network Identity")] + [HelpURL("https://mirror-networking.gitbook.io/docs/components/network-identity")] + public sealed class NetworkIdentity : MonoBehaviour + { + /// Returns true if running as a client and this object was spawned by a server. + // + // IMPORTANT: + // OnStartClient sets it to true. we NEVER set it to false after. + // otherwise components like Skillbars couldn't use OnDestroy() + // for saving, etc. since isClient may have been reset before + // OnDestroy was called. + // + // we also DO NOT make it dependent on NetworkClient.active or similar. + // we set it, then never change it. that's the user's expectation too. + // + // => fixes https://github.com/vis2k/Mirror/issues/1475 + public bool isClient { get; internal set; } + + /// Returns true if NetworkServer.active and server is not stopped. + // + // IMPORTANT: + // OnStartServer sets it to true. we NEVER set it to false after. + // otherwise components like Skillbars couldn't use OnDestroy() + // for saving, etc. since isServer may have been reset before + // OnDestroy was called. + // + // we also DO NOT make it dependent on NetworkServer.active or similar. + // we set it, then never change it. that's the user's expectation too. + // + // => fixes https://github.com/vis2k/Mirror/issues/1484 + // => fixes https://github.com/vis2k/Mirror/issues/2533 + public bool isServer { get; internal set; } + + /// Return true if this object represents the player on the local machine. + // + // IMPORTANT: + // OnStartLocalPlayer sets it to true. we NEVER set it to false after. + // otherwise components like Skillbars couldn't use OnDestroy() + // for saving, etc. since isLocalPlayer may have been reset before + // OnDestroy was called. + // + // we also DO NOT make it dependent on NetworkClient.localPlayer or similar. + // we set it, then never change it. that's the user's expectation too. + // + // => fixes https://github.com/vis2k/Mirror/issues/2615 + public bool isLocalPlayer { get; internal set; } + + /// True if this object only exists on the server + public bool isServerOnly => isServer && !isClient; + + /// True if this object exists on a client that is not also acting as a server. + public bool isClientOnly => isClient && !isServer; + + /// isOwned is true on the client if this NetworkIdentity is one of the .owned entities of our connection on the server. + // for example: main player & pets are owned. monsters & npcs aren't. + public bool isOwned { get; internal set; } + + // internal so NetworkManager can reset it from StopClient. + internal bool clientStarted; + + /// The set of network connections (players) that can see this object. + public readonly Dictionary observers = + new Dictionary(); + + /// The unique network Id of this object (unique at runtime). + public uint netId { get; internal set; } + + /// Unique identifier for NetworkIdentity objects within a scene, used for spawning scene objects. + // persistent scene id (see AssignSceneID comments) + [FormerlySerializedAs("m_SceneId"), HideInInspector] + public ulong sceneId; + + // assetId used to spawn prefabs across the network. + // originally a Guid, but a 4 byte uint is sufficient + // (as suggested by james) + // + // it's also easier to work with for serialization etc. + // serialized and visible in inspector for easier debugging + [SerializeField, HideInInspector] uint _assetId; + + // The AssetId trick: + // Ideally we would have a serialized 'Guid m_AssetId' but Unity can't + // serialize it because Guid's internal bytes are private + // + // Using just the Guid string would work, but it's 32 chars long and + // would then be sent over the network as 64 instead of 16 bytes + // + // => The solution is to serialize the string internally here and then + // use the real 'Guid' type for everything else via .assetId + public uint assetId + { + get + { +#if UNITY_EDITOR + // old UNET comment: + // This is important because sometimes OnValidate does not run + // (like when adding NetworkIdentity to prefab with no child links) + if (_assetId == 0) + SetupIDs(); +#endif + return _assetId; + } + // assetId is set internally when creating or duplicating a prefab + internal set + { + // should never be empty + if (value == 0) + { + Debug.LogError($"Can not set AssetId to empty guid on NetworkIdentity '{name}', old assetId '{_assetId}'"); + return; + } + + // always set it otherwise. + // for new prefabs, it will set from 0 to N. + // for duplicated prefabs, it will set from N to M. + // either way, it's always set to a valid GUID. + _assetId = value; + // Debug.Log($"Setting AssetId on NetworkIdentity '{name}', new assetId '{value:X4}'"); + } + } + + /// Make this object only exist when the game is running as a server (or host). + [FormerlySerializedAs("m_ServerOnly")] + [Tooltip("Prevents this object from being spawned / enabled on clients")] + public bool serverOnly; + + // Set before Destroy is called so that OnDestroy doesn't try to destroy + // the object again + internal bool destroyCalled; + + /// Client's network connection to the server. This is only valid for player objects on the client. + // TODO change to NetworkConnectionToServer, but might cause some breaking + public NetworkConnection connectionToServer { get; internal set; } + + /// Server's network connection to the client. This is only valid for client-owned objects (including the Player object) on the server. + public NetworkConnectionToClient connectionToClient + { + get => _connectionToClient; + internal set + { + _connectionToClient?.RemoveOwnedObject(this); + _connectionToClient = value; + _connectionToClient?.AddOwnedObject(this); + } + } + NetworkConnectionToClient _connectionToClient; + + // get all NetworkBehaviour components + public NetworkBehaviour[] NetworkBehaviours { get; private set; } + + // to save bandwidth, we send one 64 bit dirty mask + // instead of 1 byte index per dirty component. + // which means we can't allow > 64 components (it's enough). + const int MaxNetworkBehaviours = 64; + + // current visibility + // + // Default = use interest management + // ForceHidden = useful to hide monsters while they respawn etc. + // ForceShown = useful to have score NetworkIdentities that always broadcast + // to everyone etc. + [Tooltip("Visibility can overwrite interest management. ForceHidden can be useful to hide monsters while they respawn. ForceShown can be useful for score NetworkIdentities that should always broadcast to everyone in the world.")] + [FormerlySerializedAs("visible")] + public Visibility visibility = Visibility.Default; + + // Deprecated 2024-01-21 + [HideInInspector] + [Obsolete("Deprecated - Use .visibility instead. This will be removed soon.")] + public Visibility visible + { + get => visibility; + set => visibility = value; + } + + // broadcasting serializes all entities around a player for each player. + // we don't want to serialize one entity twice in the same tick. + // so we cache the last serialization and remember the timestamp so we + // know which Update it was serialized. + // (timestamp is the same while inside Update) + // => this way we don't need to pool thousands of writers either. + // => way easier to store them per object + NetworkIdentitySerialization lastSerialization = new NetworkIdentitySerialization + { + ownerWriter = new NetworkWriter(), + observersWriter = new NetworkWriter() + }; + + // Keep track of all sceneIds to detect scene duplicates + static readonly Dictionary sceneIds = + new Dictionary(); + + // Helper function to handle Command/Rpc + internal void HandleRemoteCall(byte componentIndex, ushort functionHash, RemoteCallType remoteCallType, NetworkReader reader, NetworkConnectionToClient senderConnection = null) + { + // check if unity object has been destroyed + if (this == null) + { + Debug.LogWarning($"{remoteCallType} [{functionHash}] received for deleted object [netId={netId}]"); + return; + } + + // find the right component to invoke the function on + if (componentIndex >= NetworkBehaviours.Length) + { + Debug.LogWarning($"Component [{componentIndex}] not found for [netId={netId}]"); + return; + } + + NetworkBehaviour invokeComponent = NetworkBehaviours[componentIndex]; + if (!RemoteProcedureCalls.Invoke(functionHash, remoteCallType, reader, invokeComponent, senderConnection)) + { + Debug.LogError($"Found no receiver for incoming {remoteCallType} [{functionHash}] on {gameObject.name}, the server and client should have the same NetworkBehaviour instances [netId={netId}]."); + } + } + + // RuntimeInitializeOnLoadMethod -> fast playmode without domain reload + // internal so it can be called from NetworkServer & NetworkClient + [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)] + internal static void ResetStatics() + { + // reset ALL statics + ResetClientStatics(); + ResetServerStatics(); + } + + // reset only client sided statics. + // don't touch server statics when calling StopClient in host mode. + // https://github.com/vis2k/Mirror/issues/2954 + internal static void ResetClientStatics() + { + previousLocalPlayer = null; + clientAuthorityCallback = null; + } + + internal static void ResetServerStatics() + { + nextNetworkId = 1; + } + + /// Gets the NetworkIdentity from the sceneIds dictionary with the corresponding id + public static NetworkIdentity GetSceneIdentity(ulong id) => sceneIds[id]; + + static uint nextNetworkId = 1; + internal static uint GetNextNetworkId() => nextNetworkId++; + + /// Resets nextNetworkId = 1 + public static void ResetNextNetworkId() => nextNetworkId = 1; + + /// The delegate type for the clientAuthorityCallback. + public delegate void ClientAuthorityCallback(NetworkConnectionToClient conn, NetworkIdentity identity, bool authorityState); + + /// A callback that can be populated to be notified when the client-authority state of objects changes. + public static event ClientAuthorityCallback clientAuthorityCallback; + + // hasSpawned should always be false before runtime + [SerializeField, HideInInspector] bool hasSpawned; + public bool SpawnedFromInstantiate { get; private set; } + + // NetworkBehaviour components are initialized in Awake once. + // Changing them at runtime would get client & server out of sync. + // BUT internal so tests can add them after creating the NetworkIdentity + internal void InitializeNetworkBehaviours() + { + // Get all NetworkBehaviour components, including children. + // Some users need NetworkTransform on child bones, etc. + // => Deterministic: https://forum.unity.com/threads/getcomponentsinchildren.4582/#post-33983 + // => Never null. GetComponents returns [] if none found. + // => Include inactive. We need all child components. + NetworkBehaviours = GetComponentsInChildren(true); + ValidateComponents(); + + // initialize each one + for (int i = 0; i < NetworkBehaviours.Length; ++i) + { + NetworkBehaviour component = NetworkBehaviours[i]; + component.netIdentity = this; + component.ComponentIndex = (byte)i; + } + } + + void ValidateComponents() + { + if (NetworkBehaviours == null) + { + Debug.LogError($"NetworkBehaviours array is null on {gameObject.name}!\n" + + $"Typically this can happen when a networked object is a child of a " + + $"non-networked parent that's disabled, preventing Awake on the networked object " + + $"from being invoked, where the NetworkBehaviours array is initialized.", gameObject); + } + else if (NetworkBehaviours.Length > MaxNetworkBehaviours) + { + Debug.LogError($"NetworkIdentity {name} has too many NetworkBehaviour components: only {MaxNetworkBehaviours} NetworkBehaviour components are allowed in order to save bandwidth.", this); + } + } + + // Awake is only called in Play mode. + // internal so we can call it during unit tests too. + internal void Awake() + { + // initialize NetworkBehaviour components. + // Awake() is called immediately after initialization. + // no one can overwrite it because NetworkIdentity is sealed. + // => doing it here is the fastest and easiest solution. + InitializeNetworkBehaviours(); + + if (hasSpawned) + { + Debug.LogError($"{name} has already spawned. Don't call Instantiate for NetworkIdentities that were in the scene since the beginning (aka scene objects). Otherwise the client won't know which object to use for a SpawnSceneObject message."); + SpawnedFromInstantiate = true; + Destroy(gameObject); + } + hasSpawned = true; + } + + void OnValidate() + { + // OnValidate is not called when using Instantiate, so we can use + // it to make sure that hasSpawned is false + hasSpawned = false; + +#if UNITY_EDITOR + DisallowChildNetworkIdentities(); + SetupIDs(); +#endif + } + + // expose our AssetId Guid to uint mapping code in case projects need to map Guids to uint as well. + // this way their projects won't break if we change our mapping algorithm. + // needs to be available at runtime / builds, don't wrap in #if UNITY_EDITOR + public static uint AssetGuidToUint(Guid guid) => (uint)guid.GetHashCode(); // deterministic + +#if UNITY_EDITOR + // child NetworkIdentities are not supported. + // Disallow them and show an error for the user to fix. + // This needs to work for Prefabs & Scene objects, so the previous check + // in NetworkClient.RegisterPrefab is not enough. + void DisallowChildNetworkIdentities() + { +#if UNITY_2020_3_OR_NEWER + NetworkIdentity[] identities = GetComponentsInChildren(true); +#else + NetworkIdentity[] identities = GetComponentsInChildren(); +#endif + if (identities.Length > 1) + { + // always log the next child component so it's easy to fix. + // if there are multiple, then after removing it'll log the next. + Debug.LogError($"'{name}' has another NetworkIdentity component on '{identities[1].name}'. There should only be one NetworkIdentity, and it must be on the root object. Please remove the other one.", this); + } + } + + void AssignAssetID(string path) + { + // only set if not empty. fixes https://github.com/vis2k/Mirror/issues/2765 + if (!string.IsNullOrWhiteSpace(path)) + { + // if we generate the assetId then we MUST be sure to set dirty + // in order to save the prefab object properly. otherwise it + // would be regenerated every time we reopen the prefab. + // -> Undo.RecordObject is the new EditorUtility.SetDirty! + // -> we need to call it before changing. + // + // to verify this, duplicate a prefab and double click to open it. + // add a log message if "_assetId != before_". + // without RecordObject, it'll log every time because it's not saved. + Undo.RecordObject(this, "Assigned AssetId"); + + // uint before = _assetId; + Guid guid = new Guid(AssetDatabase.AssetPathToGUID(path)); + assetId = AssetGuidToUint(guid); + // if (_assetId != before) Debug.Log($"Assigned assetId={assetId} to {name}"); + } + } + + void AssignAssetID(GameObject prefab) => AssignAssetID(AssetDatabase.GetAssetPath(prefab)); + + // persistent sceneId assignment + // (because scene objects have no persistent unique ID in Unity) + // + // original UNET used OnPostProcessScene to assign an index based on + // FindObjectOfType order. + // -> this didn't work because FindObjectOfType order isn't deterministic. + // -> one workaround is to sort them by sibling paths, but it can still + // get out of sync when we open scene2 in editor and we have + // DontDestroyOnLoad objects that messed with the sibling index. + // + // we absolutely need a persistent id. challenges: + // * it needs to be 0 for prefabs + // => we set it to 0 in SetupIDs() if prefab! + // * it needs to be only assigned in edit time, not at runtime because + // only the objects that were in the scene since beginning should have + // a scene id. + // => Application.isPlaying check solves that + // * it needs to detect duplicated sceneIds after duplicating scene + // objects + // => sceneIds dict takes care of that + // * duplicating the whole scene file shouldn't result in duplicate + // scene objects + // => buildIndex is shifted into sceneId for that. + // => if we have no scenes in build index then it doesn't matter + // because by definition a build can't switch to other scenes + // => if we do have scenes in build index then it will be != -1 + // note: the duplicated scene still needs to be opened once for it to + // be set properly + // * scene objects need the correct scene index byte even if the scene's + // build index was changed or a duplicated scene wasn't opened yet. + // => OnPostProcessScene is the only function that gets called for + // each scene before runtime, so this is where we set the scene + // byte. + // * disabled scenes in build settings should result in same scene index + // in editor and in build + // => .gameObject.scene.buildIndex filters out disabled scenes by + // default + // * generated sceneIds absolutely need to set scene dirty and force the + // user to resave. + // => Undo.RecordObject does that perfectly. + // * sceneIds should never be generated temporarily for unopened scenes + // when building, otherwise editor and build get out of sync + // => BuildPipeline.isBuildingPlayer check solves that + void AssignSceneID() + { + // we only ever assign sceneIds at edit time, never at runtime. + // by definition, only the original scene objects should get one. + // -> if we assign at runtime then server and client would generate + // different random numbers! + if (Application.isPlaying) + return; + + // no valid sceneId yet, or duplicate? + bool duplicate = sceneIds.TryGetValue(sceneId, out NetworkIdentity existing) && existing != null && existing != this; + if (sceneId == 0 || duplicate) + { + // clear in any case, because it might have been a duplicate + sceneId = 0; + + // if a scene was never opened and we are building it, then a + // sceneId would be assigned to build but not saved in editor, + // resulting in them getting out of sync. + // => don't ever assign temporary ids. they always need to be + // permanent + // => throw an exception to cancel the build and let the user + // know how to fix it! + if (BuildPipeline.isBuildingPlayer) + throw new InvalidOperationException($"Scene {gameObject.scene.path} needs to be opened and resaved before building, because the scene object {name} has no valid sceneId yet."); + + // if we generate the sceneId then we MUST be sure to set dirty + // in order to save the scene object properly. otherwise it + // would be regenerated every time we reopen the scene, and + // upgrading would be very difficult. + // -> Undo.RecordObject is the new EditorUtility.SetDirty! + // -> we need to call it before changing. + Undo.RecordObject(this, "Generated SceneId"); + + // generate random sceneId part (0x00000000FFFFFFFF) + uint randomId = Utils.GetTrueRandomUInt(); + + // only assign if not a duplicate of an existing scene id + // (small chance, but possible) + duplicate = sceneIds.TryGetValue(randomId, out existing) && existing != null && existing != this; + if (!duplicate) + { + sceneId = randomId; + //Debug.Log($"{name} in scene {gameObject.scene.name} sceneId assigned to:{sceneId:X}"); + } + } + + // add to sceneIds dict no matter what + // -> even if we didn't generate anything new, because we still need + // existing sceneIds in there to check duplicates + sceneIds[sceneId] = this; + } + + // copy scene path hash into sceneId for scene objects. + // this is the only way for scene file duplication to not contain + // duplicate sceneIds as it seems. + // -> sceneId before: 0x00000000AABBCCDD + // -> then we clear the left 4 bytes, so that our 'OR' uses 0x00000000 + // -> then we OR the hash into the 0x00000000 part + // -> buildIndex is not enough, because Editor and Build have different + // build indices if there are disabled scenes in build settings, and + // if no scene is in build settings then Editor and Build have + // different indices too (Editor=0, Build=-1) + // => ONLY USE THIS FROM POSTPROCESSSCENE! + public void SetSceneIdSceneHashPartInternal() + { + // Use `ToLower` to that because BuildPipeline.BuildPlayer is case insensitive but hash is case sensitive + // If the scene in the project is `forest.unity` but `Forest.unity` is given to BuildPipeline then the + // BuildPipeline will use `Forest.unity` for the build and create a different hash than the editor will. + // Using ToLower will mean the hash will be the same for these 2 paths + // Assets/Scenes/Forest.unity + // Assets/Scenes/forest.unity + string scenePath = gameObject.scene.path.ToLower(); + + // get deterministic scene hash + uint pathHash = (uint)scenePath.GetStableHashCode(); + + // shift hash from 0x000000FFFFFFFF to 0xFFFFFFFF00000000 + ulong shiftedHash = (ulong)pathHash << 32; + + // OR into scene id + sceneId = (sceneId & 0xFFFFFFFF) | shiftedHash; + + // log it. this is incredibly useful to debug sceneId issues. + //Debug.Log($"{name} in scene {gameObject.scene.name} scene index hash {pathHash:X} copied into sceneId {sceneId:X}"); + } + + void SetupIDs() + { + // is this a prefab? + if (Utils.IsPrefab(gameObject)) + { + // force 0 for prefabs + sceneId = 0; + AssignAssetID(gameObject); + } + // are we currently in prefab editing mode? aka prefab stage + // => check prefabstage BEFORE SceneObjectWithPrefabParent + // (fixes https://github.com/vis2k/Mirror/issues/976) + // => if we don't check GetCurrentPrefabStage and only check + // GetPrefabStage(gameObject), then the 'else' case where we + // assign a sceneId and clear the assetId would still be + // triggered for prefabs. in other words: if we are in prefab + // stage, do not bother with anything else ever! + else if (PrefabStageUtility.GetCurrentPrefabStage() != null) + { + // when modifying a prefab in prefab stage, Unity calls + // OnValidate for that prefab and for all scene objects based on + // that prefab. + // + // is this GameObject the prefab that we modify, and not just a + // scene object based on the prefab? + // * GetCurrentPrefabStage = 'are we editing ANY prefab?' + // * GetPrefabStage(go) = 'are we editing THIS prefab?' + if (PrefabStageUtility.GetPrefabStage(gameObject) != null) + { + // force 0 for prefabs + sceneId = 0; + //Debug.Log($"{name} scene:{gameObject.scene.name} sceneid reset to 0 because CurrentPrefabStage={PrefabStageUtility.GetCurrentPrefabStage()} PrefabStage={PrefabStageUtility.GetPrefabStage(gameObject)}"); + + // get path from PrefabStage for this prefab +#if UNITY_2020_1_OR_NEWER + string path = PrefabStageUtility.GetPrefabStage(gameObject).assetPath; +#else + string path = PrefabStageUtility.GetPrefabStage(gameObject).prefabAssetPath; +#endif + + AssignAssetID(path); + } + } + // is this a scene object with prefab parent? + else if (Utils.IsSceneObjectWithPrefabParent(gameObject, out GameObject prefab)) + { + AssignSceneID(); + AssignAssetID(prefab); + } + else + { + AssignSceneID(); + + // IMPORTANT: DO NOT clear assetId at runtime! + // => fixes a bug where clicking any of the NetworkIdentity + // properties (like ServerOnly/ForceHidden) at runtime would + // call OnValidate + // => OnValidate gets into this else case here because prefab + // connection isn't known at runtime + // => then we would clear the previously assigned assetId + // => and NetworkIdentity couldn't be spawned on other clients + // anymore because assetId was cleared + if (!EditorApplication.isPlaying) + { + _assetId = 0; + } + // don't log. would show a lot when pressing play in uMMORPG/uSurvival/etc. + //else Debug.Log($"Avoided clearing assetId at runtime for {name} after (probably) clicking any of the NetworkIdentity properties."); + } + } +#endif + + // OnDestroy is called for all SPAWNED NetworkIdentities + // => scene objects aren't destroyed. it's not called for them. + // + // Note: Unity will Destroy all networked objects on Scene Change, so we + // have to handle that here silently. That means we cannot have any + // warning or logging in this method. + void OnDestroy() + { + // Objects spawned from Instantiate are not allowed so are destroyed right away + // we don't want to call NetworkServer.Destroy if this is the case + if (SpawnedFromInstantiate) + return; + + // If false the object has already been unspawned + // if it is still true, then we need to unspawn it + // if destroy is already called don't call it again + if (isServer && !destroyCalled) + { + // Do not add logging to this (see above) + NetworkServer.Destroy(gameObject); + } + + if (isLocalPlayer) + { + // previously there was a bug where isLocalPlayer was + // false in OnDestroy because it was dynamically defined as: + // isLocalPlayer => NetworkClient.localPlayer == this + // we fixed it by setting isLocalPlayer manually and never + // resetting it. + // + // BUT now we need to be aware of a possible data race like in + // our rooms example: + // => GamePlayer is in world + // => player returns to room + // => GamePlayer is destroyed + // => NetworkClient.localPlayer is set to RoomPlayer + // => GamePlayer.OnDestroy is called 1 frame later + // => GamePlayer.OnDestroy 'isLocalPlayer' is true, so here we + // are trying to clear NetworkClient.localPlayer + // => which would overwrite the new RoomPlayer local player + // + // FIXED by simply only clearing if NetworkClient.localPlayer + // still points to US! + // => see also: https://github.com/vis2k/Mirror/issues/2635 + if (NetworkClient.localPlayer == this) + NetworkClient.localPlayer = null; + } + + if (isClient) + { + // ServerChangeScene doesn't send destroy messages. + // some identities may persist in DDOL. + // some are destroyed by scene change. + // if an identity is still in .owned remove it. + // fixes: https://github.com/MirrorNetworking/Mirror/issues/3308 + if (NetworkClient.connection != null) + NetworkClient.connection.owned.Remove(this); + + // if an identity is still in .spawned, remove it too. + // fixes: https://github.com/MirrorNetworking/Mirror/issues/3324 + NetworkClient.spawned.Remove(netId); + } + } + + internal void OnStartServer() + { + foreach (NetworkBehaviour comp in NetworkBehaviours) + { + // an exception in OnStartServer should be caught, so that one + // component's exception doesn't stop all other components from + // being initialized + // => this is what Unity does for Start() etc. too. + // one exception doesn't stop all the other Start() calls! + try + { + comp.OnStartServer(); + } + catch (Exception e) + { + Debug.LogException(e, comp); + } + } + } + + internal void OnStopServer() + { + foreach (NetworkBehaviour comp in NetworkBehaviours) + { + // an exception in OnStartServer should be caught, so that one + // component's exception doesn't stop all other components from + // being initialized + // => this is what Unity does for Start() etc. too. + // one exception doesn't stop all the other Start() calls! + try + { + comp.OnStopServer(); + } + catch (Exception e) + { + Debug.LogException(e, comp); + } + } + } + + internal void OnStartClient() + { + if (clientStarted) return; + + clientStarted = true; + + // Debug.Log($"OnStartClient {gameObject} netId:{netId}"); + foreach (NetworkBehaviour comp in NetworkBehaviours) + { + // an exception in OnStartClient should be caught, so that one + // component's exception doesn't stop all other components from + // being initialized + // => this is what Unity does for Start() etc. too. + // one exception doesn't stop all the other Start() calls! + try + { + // user implemented startup + comp.OnStartClient(); + } + catch (Exception e) + { + Debug.LogException(e, comp); + } + } + } + + internal void OnStopClient() + { + // In case this object was destroyed already don't call + // OnStopClient if OnStartClient hasn't been called. + if (!clientStarted) return; + + foreach (NetworkBehaviour comp in NetworkBehaviours) + { + // an exception in OnStopClient should be caught, so that + // one component's exception doesn't stop all other components + // from being initialized + // => this is what Unity does for Start() etc. too. + // one exception doesn't stop all the other Start() calls! + try + { + comp.OnStopClient(); + } + catch (Exception e) + { + Debug.LogException(e, comp); + } + } + } + + internal static NetworkIdentity previousLocalPlayer = null; + internal void OnStartLocalPlayer() + { + // ensure OnStartLocalPlayer is only called once. + // Room demo would call it multiple times: + // - once from ApplySpawnPayload + // - once from OnObjectSpawnFinished + // + // to reproduce: + // - open room demo, add the 3 scenes to build settings + // - add OnStartLocalPlayer log to RoomPlayer prefab + // - build, run server-only + // - in editor, connect, press ready + // - in server, start game + // - notice multiple OnStartLocalPlayer logs in editor client + // + // explanation: + // we send the spawn message multiple times. Whenever an object changes + // authority, we send the spawn message again for the object. This is + // necessary because we need to reinitialize all variables when + // ownership change due to sync to owner feature. + // Without this static, the second time we get the spawn message we + // would call OnStartLocalPlayer again on the same object + if (previousLocalPlayer == this) + return; + previousLocalPlayer = this; + + foreach (NetworkBehaviour comp in NetworkBehaviours) + { + // an exception in OnStartLocalPlayer should be caught, so that + // one component's exception doesn't stop all other components + // from being initialized + // => this is what Unity does for Start() etc. too. + // one exception doesn't stop all the other Start() calls! + try + { + comp.OnStartLocalPlayer(); + } + catch (Exception e) + { + Debug.LogException(e, comp); + } + } + } + + internal void OnStopLocalPlayer() + { + foreach (NetworkBehaviour comp in NetworkBehaviours) + { + // an exception in OnStopLocalPlayer should be caught, so that + // one component's exception doesn't stop all other components + // from being initialized + // => this is what Unity does for Start() etc. too. + // one exception doesn't stop all the other Start() calls! + try + { + comp.OnStopLocalPlayer(); + } + catch (Exception e) + { + Debug.LogException(e, comp); + } + } + } + + // build dirty mask for server owner & observers (= all dirty components). + // faster to do it in one iteration instead of iterating separately. + (ulong, ulong) ServerDirtyMasks(bool initialState) + { + ulong ownerMask = 0; + ulong observerMask = 0; + + NetworkBehaviour[] components = NetworkBehaviours; + for (int i = 0; i < components.Length; ++i) + { + NetworkBehaviour component = components[i]; + + bool dirty = component.IsDirty(); + ulong nthBit = (1u << i); + + // owner needs to be considered for both SyncModes, because + // Observers mode always includes the Owner. + // + // for initial, it should always sync owner. + // for delta, only for ServerToClient and only if dirty. + // ClientToServer comes from the owner client. + if (initialState || (component.syncDirection == SyncDirection.ServerToClient && dirty)) + ownerMask |= nthBit; + + // observers need to be considered only in Observers mode + // + // for initial, it should always sync to observers. + // for delta, only if dirty. + // SyncDirection is irrelevant, as both are broadcast to + // observers which aren't the owner. + if (component.syncMode == SyncMode.Observers && (initialState || dirty)) + observerMask |= nthBit; + } + + return (ownerMask, observerMask); + } + + // build dirty mask for client. + // server always knows initialState, so we don't need it here. + ulong ClientDirtyMask() + { + ulong mask = 0; + + NetworkBehaviour[] components = NetworkBehaviours; + for (int i = 0; i < components.Length; ++i) + { + // on the client, we need to consider different sync scenarios: + // + // ServerToClient SyncDirection: + // do nothing. + // ClientToServer SyncDirection: + // serialize only if owned. + + // on client, only consider owned components with SyncDirection to server + NetworkBehaviour component = components[i]; + if (isOwned && component.syncDirection == SyncDirection.ClientToServer) + { + // set the n-th bit if dirty + // shifting from small to large numbers is varint-efficient. + if (component.IsDirty()) mask |= (1u << i); + } + } + + return mask; + } + + // check if n-th component is dirty. + // in other words, if it has the n-th bit set in the dirty mask. + [MethodImpl(MethodImplOptions.AggressiveInlining)] + internal static bool IsDirty(ulong mask, int index) + { + ulong nthBit = (ulong)(1 << index); + return (mask & nthBit) != 0; + } + + // serialize components into writer on the server. + // check ownerWritten/observersWritten to know if anything was written + // We pass dirtyComponentsMask into this function so that we can check + // if any Components are dirty before creating writers + internal void SerializeServer(bool initialState, NetworkWriter ownerWriter, NetworkWriter observersWriter) + { + // ensure NetworkBehaviours are valid before usage + ValidateComponents(); + NetworkBehaviour[] components = NetworkBehaviours; + + // check which components are dirty for owner / observers. + // this is quite complicated with SyncMode + SyncDirection. + // see the function for explanation. + // + // instead of writing a 1 byte index per component, + // we limit components to 64 bits and write one ulong instead. + // the ulong is also varint compressed for minimum bandwidth. + (ulong ownerMask, ulong observerMask) = ServerDirtyMasks(initialState); + + // if nothing dirty, then don't even write the mask. + // otherwise, every unchanged object would send a 1 byte dirty mask! + if (ownerMask != 0) Compression.CompressVarUInt(ownerWriter, ownerMask); + if (observerMask != 0) Compression.CompressVarUInt(observersWriter, observerMask); + + // serialize all components + // perf: only iterate if either dirty mask has dirty bits. + if ((ownerMask | observerMask) != 0) + { + for (int i = 0; i < components.Length; ++i) + { + NetworkBehaviour comp = components[i]; + + // is the component dirty for anyone (owner or observers)? + // may be serialized to owner, observer, both, or neither. + // + // OnSerialize should only be called once. + // this is faster, and it cleaner because it may set + // internal state, counters, logs, etc. + // + // previously we always serialized to owner and then copied + // the serialization to observers. however, since + // SyncDirection it's not guaranteed to be in owner anymore. + // so we need to serialize to temporary writer first. + // and then copy as needed. + bool ownerDirty = IsDirty(ownerMask, i); + bool observersDirty = IsDirty(observerMask, i); + if (ownerDirty || observersDirty) + { + // serialize into helper writer + using (NetworkWriterPooled temp = NetworkWriterPool.Get()) + { + comp.Serialize(temp, initialState); + ArraySegment segment = temp.ToArraySegment(); + + // copy to owner / observers as needed + if (ownerDirty) ownerWriter.WriteBytes(segment.Array, segment.Offset, segment.Count); + if (observersDirty) observersWriter.WriteBytes(segment.Array, segment.Offset, segment.Count); + } + + // clear dirty bits for the components that we serialized. + // do not clear for _all_ components, only the ones that + // were dirty and had their syncInterval elapsed. + // + // we don't want to clear bits before the syncInterval + // was elapsed, as then they wouldn't be synced. + // + // only clear for delta, not for full (spawn messages). + // otherwise if a player joins, we serialize monster, + // and shouldn't clear dirty bits not yet synced to + // other players. + if (!initialState) comp.ClearAllDirtyBits(); + } + } + } + } + + // serialize components into writer on the client. + internal void SerializeClient(NetworkWriter writer) + { + // ensure NetworkBehaviours are valid before usage + ValidateComponents(); + NetworkBehaviour[] components = NetworkBehaviours; + + // check which components are dirty. + // this is quite complicated with SyncMode + SyncDirection. + // see the function for explanation. + // + // instead of writing a 1 byte index per component, + // we limit components to 64 bits and write one ulong instead. + // the ulong is also varint compressed for minimum bandwidth. + ulong dirtyMask = ClientDirtyMask(); + + // varint compresses the mask to 1 byte in most cases. + // instead of writing an 8 byte ulong. + // 7 components fit into 1 byte. (previously 7 bytes) + // 11 components fit into 2 bytes. (previously 11 bytes) + // 16 components fit into 3 bytes. (previously 16 bytes) + // TODO imer: server knows amount of comps, write N bytes instead + + // if nothing dirty, then don't even write the mask. + // otherwise, every unchanged object would send a 1 byte dirty mask! + if (dirtyMask != 0) Compression.CompressVarUInt(writer, dirtyMask); + + // serialize all components + // perf: only iterate if dirty mask has dirty bits. + if (dirtyMask != 0) + { + // serialize all components + for (int i = 0; i < components.Length; ++i) + { + NetworkBehaviour comp = components[i]; + + // is this component dirty? + // reuse the mask instead of calling comp.IsDirty() again here. + if (IsDirty(dirtyMask, i)) + // if (isOwned && component.syncDirection == SyncDirection.ClientToServer) + { + // serialize into writer. + // server always knows initialState, we never need to send it + comp.Serialize(writer, false); + + // clear dirty bits for the components that we serialized. + // do not clear for _all_ components, only the ones that + // were dirty and had their syncInterval elapsed. + // + // we don't want to clear bits before the syncInterval + // was elapsed, as then they wouldn't be synced. + comp.ClearAllDirtyBits(); + } + } + } + } + + // deserialize components from the client on the server. + // there's no 'initialState'. server always knows the initial state. + internal bool DeserializeServer(NetworkReader reader) + { + // ensure NetworkBehaviours are valid before usage + ValidateComponents(); + NetworkBehaviour[] components = NetworkBehaviours; + + // first we deserialize the varinted dirty mask + ulong mask = Compression.DecompressVarUInt(reader); + + // now deserialize every dirty component + for (int i = 0; i < components.Length; ++i) + { + // was this one dirty? + if (IsDirty(mask, i)) + { + NetworkBehaviour comp = components[i]; + + // safety check to ensure clients can only modify their own + // ClientToServer components, nothing else. + if (comp.syncDirection == SyncDirection.ClientToServer) + { + // deserialize this component + // server always knows the initial state (initial=false) + // disconnect if failed, to prevent exploits etc. + if (!comp.Deserialize(reader, false)) return false; + + // server received state from the owner client. + // set dirty so it's broadcast to other clients too. + // + // note that we set the _whole_ component as dirty. + // everything will be broadcast to others. + // SetSyncVarDirtyBits() would be nicer, but not all + // components use [SyncVar]s. + comp.SetDirty(); + } + } + } + + // successfully deserialized everything + return true; + } + + // deserialize components from server on the client. + internal void DeserializeClient(NetworkReader reader, bool initialState) + { + // ensure NetworkBehaviours are valid before usage + ValidateComponents(); + NetworkBehaviour[] components = NetworkBehaviours; + + // first we deserialize the varinted dirty mask + ulong mask = Compression.DecompressVarUInt(reader); + + // now deserialize every dirty component + for (int i = 0; i < components.Length; ++i) + { + // was this one dirty? + if (IsDirty(mask, i)) + { + // deserialize this component + NetworkBehaviour comp = components[i]; + comp.Deserialize(reader, initialState); + } + } + } + + // get cached serialization for this tick (or serialize if none yet). + // IMPORTANT: int tick avoids floating point inaccuracy over days/weeks. + // calls SerializeServer, so this function is to be called on server. + internal NetworkIdentitySerialization GetServerSerializationAtTick(int tick) + { + // only rebuild serialization once per tick. reuse otherwise. + // except for tests, where Time.frameCount never increases. + // so during tests, we always rebuild. + // (otherwise [SyncVar] changes would never be serialized in tests) + // + // NOTE: != instead of < because int.max+1 overflows at some point. + if (lastSerialization.tick != tick +#if UNITY_EDITOR + || !Application.isPlaying +#endif + ) + { + // reset + lastSerialization.ownerWriter.Position = 0; + lastSerialization.observersWriter.Position = 0; + + // serialize + SerializeServer(false, + lastSerialization.ownerWriter, + lastSerialization.observersWriter); + + // set tick + lastSerialization.tick = tick; + //Debug.Log($"{name} (netId={netId}) serialized for tick={tickTimeStamp}"); + } + + // return it + return lastSerialization; + } + + internal void AddObserver(NetworkConnectionToClient conn) + { + if (observers.ContainsKey(conn.connectionId)) + { + // if we try to add a connectionId that was already added, then + // we may have generated one that was already in use. + return; + } + + // Debug.Log($"Added observer: {conn.address} added for {gameObject}"); + + // if we previously had no observers, then clear all dirty bits once. + // a monster's health may have changed while it had no observers. + // but that change (= the dirty bits) don't matter as soon as the + // first observer comes. + // -> first observer gets full spawn packet + // -> afterwards it gets delta packet + // => if we don't clear previous dirty bits, observer would get + // the health change because the bit was still set. + // => ultimately this happens because spawn doesn't reset dirty + // bits + // => which happens because spawn happens separately, instead of + // in Broadcast() (which will be changed in the future) + // + // NOTE that NetworkServer.Broadcast previously cleared dirty bits + // for ALL SPAWNED that don't have observers. that was super + // expensive. doing it when adding the first observer has the + // same result, without the O(N) iteration in Broadcast(). + // + // TODO remove this after moving spawning into Broadcast()! + if (observers.Count == 0) + { + ClearAllComponentsDirtyBits(); + } + + observers[conn.connectionId] = conn; + conn.AddToObserving(this); + } + + // clear all component's dirty bits no matter what + internal void ClearAllComponentsDirtyBits() + { + foreach (NetworkBehaviour comp in NetworkBehaviours) + { + comp.ClearAllDirtyBits(); + } + } + + // this is used when a connection is destroyed, since the "observers" property is read-only + internal void RemoveObserver(NetworkConnection conn) + { + observers.Remove(conn.connectionId); + } + + /// Assign control of an object to a client via the client's NetworkConnection. + // This causes hasAuthority to be set on the client that owns the object, + // and NetworkBehaviour.OnStartAuthority will be called on that client. + // This object then will be in the NetworkConnection.clientOwnedObjects + // list for the connection. + // + // Authority can be removed with RemoveClientAuthority. Only one client + // can own an object at any time. This does not need to be called for + // player objects, as their authority is setup automatically. + public bool AssignClientAuthority(NetworkConnectionToClient conn) + { + if (!isServer) + { + Debug.LogError("AssignClientAuthority can only be called on the server for spawned objects."); + return false; + } + + if (conn == null) + { + Debug.LogError($"AssignClientAuthority for {gameObject} owner cannot be null. Use RemoveClientAuthority() instead."); + return false; + } + + if (connectionToClient != null && conn != connectionToClient) + { + Debug.LogError($"AssignClientAuthority for {gameObject} already has an owner. Use RemoveClientAuthority() first."); + return false; + } + + SetClientOwner(conn); + + // The client will match to the existing object + NetworkServer.SendChangeOwnerMessage(this, conn); + + clientAuthorityCallback?.Invoke(conn, this, true); + + return true; + } + + // used when adding players + internal void SetClientOwner(NetworkConnectionToClient conn) + { + // do nothing if it already has an owner + if (connectionToClient != null && conn != connectionToClient) + { + Debug.LogError($"Object {this} netId={netId} already has an owner. Use RemoveClientAuthority() first", this); + return; + } + + // otherwise set the owner connection + connectionToClient = conn; + } + + /// Removes ownership for an object. + // Applies to objects that had authority set by AssignClientAuthority, + // or NetworkServer.Spawn with a NetworkConnection parameter included. + // Authority cannot be removed for player objects. + public void RemoveClientAuthority() + { + if (!isServer) + { + Debug.LogError("RemoveClientAuthority can only be called on the server for spawned objects."); + return; + } + + if (connectionToClient?.identity == this) + { + Debug.LogError("RemoveClientAuthority cannot remove authority for a player object"); + return; + } + + if (connectionToClient != null) + { + clientAuthorityCallback?.Invoke(connectionToClient, this, false); + NetworkConnectionToClient previousOwner = connectionToClient; + connectionToClient = null; + NetworkServer.SendChangeOwnerMessage(this, previousOwner); + } + } + + // Reset is called when the user hits the Reset button in the + // Inspector's context menu or when adding the component the first time. + // This function is only called in editor mode. + // + // Reset() seems to be called only for Scene objects. + // we can't destroy them (they are always in the scene). + // instead we disable them and call Reset(). + // + // Do not reset SyncObjects from Reset + // - Unspawned objects need to retain their list contents + // - They may be respawned, especially players, but others as well. + // + // OLD COMMENT: + // Marks the identity for future reset, this is because we cant reset + // the identity during destroy as people might want to be able to read + // the members inside OnDestroy(), and we have no way of invoking reset + // after OnDestroy is called. + internal void ResetState() + { + hasSpawned = false; + clientStarted = false; + isClient = false; + isServer = false; + //isLocalPlayer = false; <- cleared AFTER ClearLocalPlayer below! + + // remove authority flag. This object may be unspawned, not destroyed, on client. + isOwned = false; + NotifyAuthority(); + + netId = 0; + connectionToServer = null; + connectionToClient = null; + + ClearObservers(); + + // clear local player if it was the local player, + // THEN reset isLocalPlayer AFTERWARDS + if (isLocalPlayer) + { + // only clear NetworkClient.localPlayer IF IT POINTS TO US! + // see OnDestroy() comments. it does the same. + // (https://github.com/vis2k/Mirror/issues/2635) + if (NetworkClient.localPlayer == this) + NetworkClient.localPlayer = null; + } + + previousLocalPlayer = null; + isLocalPlayer = false; + } + + bool hadAuthority; + internal void NotifyAuthority() + { + if (!hadAuthority && isOwned) + OnStartAuthority(); + if (hadAuthority && !isOwned) + OnStopAuthority(); + hadAuthority = isOwned; + } + + internal void OnStartAuthority() + { + foreach (NetworkBehaviour comp in NetworkBehaviours) + { + // an exception in OnStartAuthority should be caught, so that one + // component's exception doesn't stop all other components from + // being initialized + // => this is what Unity does for Start() etc. too. + // one exception doesn't stop all the other Start() calls! + try + { + comp.OnStartAuthority(); + } + catch (Exception e) + { + Debug.LogException(e, comp); + } + } + } + + internal void OnStopAuthority() + { + foreach (NetworkBehaviour comp in NetworkBehaviours) + { + // an exception in OnStopAuthority should be caught, so that one + // component's exception doesn't stop all other components from + // being initialized + // => this is what Unity does for Start() etc. too. + // one exception doesn't stop all the other Start() calls! + try + { + comp.OnStopAuthority(); + } + catch (Exception e) + { + Debug.LogException(e, comp); + } + } + } + + // Called when NetworkIdentity is destroyed + internal void ClearObservers() + { + foreach (NetworkConnectionToClient conn in observers.Values) + { + conn.RemoveFromObserving(this, true); + } + observers.Clear(); + } + } +} diff --git a/Assets/Mirror/Core/NetworkIdentity.cs.meta b/Assets/Mirror/Core/NetworkIdentity.cs.meta new file mode 100644 index 0000000..7b96521 --- /dev/null +++ b/Assets/Mirror/Core/NetworkIdentity.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 9b91ecbcc199f4492b9a91e820070131 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/NetworkLoop.cs b/Assets/Mirror/Core/NetworkLoop.cs new file mode 100644 index 0000000..a9cd490 --- /dev/null +++ b/Assets/Mirror/Core/NetworkLoop.cs @@ -0,0 +1,211 @@ +// our ideal update looks like this: +// transport.process_incoming() +// update_world() +// transport.process_outgoing() +// +// this way we avoid unnecessary latency for low-ish server tick rates. +// for example, if we were to use this tick: +// transport.process_incoming/outgoing() +// update_world() +// +// then anything sent in update_world wouldn't be actually sent out by the +// transport until the next frame. if server runs at 60Hz, then this can add +// 16ms latency for every single packet. +// +// => instead we process incoming, update world, process_outgoing in the same +// frame. it's more clear (no race conditions) and lower latency. +// => we need to add custom Update functions to the Unity engine: +// NetworkEarlyUpdate before Update()/FixedUpdate() +// NetworkLateUpdate after LateUpdate() +// this way the user can update the world in Update/FixedUpdate/LateUpdate +// and networking still runs before/after those functions no matter what! +// => see also: https://docs.unity3d.com/Manual/ExecutionOrder.html +// => update order: +// * we add to the end of EarlyUpdate so it runs after any Unity initializations +// * we add to the end of PreLateUpdate so it runs after LateUpdate(). adding +// to the beginning of PostLateUpdate doesn't actually work. +using System; +using UnityEngine; +using UnityEngine.LowLevel; +using UnityEngine.PlayerLoop; + +namespace Mirror +{ + public static class NetworkLoop + { + // helper enum to add loop to begin/end of subSystemList + internal enum AddMode { Beginning, End } + + // callbacks for others to hook into if they need Early/LateUpdate. + public static Action OnEarlyUpdate; + public static Action OnLateUpdate; + + // RuntimeInitializeOnLoadMethod -> fast playmode without domain reload + [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)] + static void ResetStatics() + { + OnEarlyUpdate = null; + OnLateUpdate = null; + } + + // helper function to find an update function's index in a player loop + // type. this is used for testing to guarantee our functions are added + // at the beginning/end properly. + internal static int FindPlayerLoopEntryIndex(PlayerLoopSystem.UpdateFunction function, PlayerLoopSystem playerLoop, Type playerLoopSystemType) + { + // did we find the type? e.g. EarlyUpdate/PreLateUpdate/etc. + if (playerLoop.type == playerLoopSystemType) + return Array.FindIndex(playerLoop.subSystemList, (elem => elem.updateDelegate == function)); + + // recursively keep looking + if (playerLoop.subSystemList != null) + { + for (int i = 0; i < playerLoop.subSystemList.Length; ++i) + { + int index = FindPlayerLoopEntryIndex(function, playerLoop.subSystemList[i], playerLoopSystemType); + if (index != -1) return index; + } + } + return -1; + } + + // MODIFIED AddSystemToPlayerLoopList from Unity.Entities.ScriptBehaviourUpdateOrder (ECS) + // + // => adds an update function to the Unity internal update type. + // => Unity has different update loops: + // https://medium.com/@thebeardphantom/unity-2018-and-playerloop-5c46a12a677 + // EarlyUpdate + // FixedUpdate + // PreUpdate + // Update + // PreLateUpdate + // PostLateUpdate + // + // function: the custom update function to add + // IMPORTANT: according to a comment in Unity.Entities.ScriptBehaviourUpdateOrder, + // the UpdateFunction can not be virtual because + // Mono 4.6 has problems invoking virtual methods + // as delegates from native! + // ownerType: the .type to fill in so it's obvious who the new function + // belongs to. seems to be mostly for debugging. pass any. + // addMode: prepend or append to update list + internal static bool AddToPlayerLoop(PlayerLoopSystem.UpdateFunction function, Type ownerType, ref PlayerLoopSystem playerLoop, Type playerLoopSystemType, AddMode addMode) + { + // did we find the type? e.g. EarlyUpdate/PreLateUpdate/etc. + if (playerLoop.type == playerLoopSystemType) + { + // debugging + //Debug.Log($"Found playerLoop of type {playerLoop.type} with {playerLoop.subSystemList.Length} Functions:"); + //foreach (PlayerLoopSystem sys in playerLoop.subSystemList) + // Debug.Log($" ->{sys.type}"); + + // make sure the function wasn't added yet. + // with domain reload disabled, it would otherwise be added twice: + // fixes: https://github.com/MirrorNetworking/Mirror/issues/3392 + if (Array.FindIndex(playerLoop.subSystemList, (s => s.updateDelegate == function)) != -1) + { + // loop contains the function, so return true. + return true; + } + + // resize & expand subSystemList to fit one more entry + int oldListLength = (playerLoop.subSystemList != null) ? playerLoop.subSystemList.Length : 0; + Array.Resize(ref playerLoop.subSystemList, oldListLength + 1); + + // IMPORTANT: always insert a FRESH PlayerLoopSystem! + // We CAN NOT resize and then OVERWRITE an entry's type/loop. + // => PlayerLoopSystem has native IntPtr loop members + // => forgetting to clear those would cause undefined behaviour! + // see also: https://github.com/vis2k/Mirror/pull/2652 + PlayerLoopSystem system = new PlayerLoopSystem { + type = ownerType, + updateDelegate = function + }; + + // prepend our custom loop to the beginning + if (addMode == AddMode.Beginning) + { + // shift to the right, write into first array element + Array.Copy(playerLoop.subSystemList, 0, playerLoop.subSystemList, 1, playerLoop.subSystemList.Length - 1); + playerLoop.subSystemList[0] = system; + } + // append our custom loop to the end + else if (addMode == AddMode.End) + { + // simply write into last array element + playerLoop.subSystemList[oldListLength] = system; + } + + // debugging + //Debug.Log($"New playerLoop of type {playerLoop.type} with {playerLoop.subSystemList.Length} Functions:"); + //foreach (PlayerLoopSystem sys in playerLoop.subSystemList) + // Debug.Log($" ->{sys.type}"); + + return true; + } + + // recursively keep looking + if (playerLoop.subSystemList != null) + { + for (int i = 0; i < playerLoop.subSystemList.Length; ++i) + { + if (AddToPlayerLoop(function, ownerType, ref playerLoop.subSystemList[i], playerLoopSystemType, addMode)) + return true; + } + } + return false; + } + + // hook into Unity runtime to actually add our custom functions + [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)] + static void RuntimeInitializeOnLoad() + { + //Debug.Log("Mirror: adding Network[Early/Late]Update to Unity..."); + + // get loop + // 2019 has GetCURRENTPlayerLoop which is safe to use without + // breaking other custom system's custom loops. + // see also: https://github.com/vis2k/Mirror/pull/2627/files + PlayerLoopSystem playerLoop = PlayerLoop.GetCurrentPlayerLoop(); + + // add NetworkEarlyUpdate to the end of EarlyUpdate so it runs after + // any Unity initializations but before the first Update/FixedUpdate + AddToPlayerLoop(NetworkEarlyUpdate, typeof(NetworkLoop), ref playerLoop, typeof(EarlyUpdate), AddMode.End); + + // add NetworkLateUpdate to the end of PreLateUpdate so it runs after + // LateUpdate(). adding to the beginning of PostLateUpdate doesn't + // actually work. + AddToPlayerLoop(NetworkLateUpdate, typeof(NetworkLoop), ref playerLoop, typeof(PreLateUpdate), AddMode.End); + + // set the new loop + PlayerLoop.SetPlayerLoop(playerLoop); + } + + static void NetworkEarlyUpdate() + { + // loop functions run in edit mode and in play mode. + // however, we only want to call NetworkServer/Client in play mode. + if (!Application.isPlaying) return; + + NetworkTime.EarlyUpdate(); + //Debug.Log($"NetworkEarlyUpdate {Time.time}"); + NetworkServer.NetworkEarlyUpdate(); + NetworkClient.NetworkEarlyUpdate(); + // invoke event after mirror has done it's early updating. + OnEarlyUpdate?.Invoke(); + } + + static void NetworkLateUpdate() + { + // loop functions run in edit mode and in play mode. + // however, we only want to call NetworkServer/Client in play mode. + if (!Application.isPlaying) return; + + //Debug.Log($"NetworkLateUpdate {Time.time}"); + // invoke event before mirror does its final late updating. + OnLateUpdate?.Invoke(); + NetworkServer.NetworkLateUpdate(); + NetworkClient.NetworkLateUpdate(); + } + } +} diff --git a/Assets/Mirror/Core/NetworkLoop.cs.meta b/Assets/Mirror/Core/NetworkLoop.cs.meta new file mode 100644 index 0000000..52b6e6a --- /dev/null +++ b/Assets/Mirror/Core/NetworkLoop.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 2c6cec4e279774b919386e05545317b8 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/NetworkManager.cs b/Assets/Mirror/Core/NetworkManager.cs new file mode 100644 index 0000000..905ce55 --- /dev/null +++ b/Assets/Mirror/Core/NetworkManager.cs @@ -0,0 +1,1504 @@ +using System; +using System.Collections.Generic; +using System.Linq; +using UnityEngine; +using UnityEngine.SceneManagement; +using UnityEngine.Serialization; + +namespace Mirror +{ + public enum PlayerSpawnMethod { Random, RoundRobin } + public enum NetworkManagerMode { Offline, ServerOnly, ClientOnly, Host } + public enum HeadlessStartOptions { DoNothing, AutoStartServer, AutoStartClient } + + [DisallowMultipleComponent] + [AddComponentMenu("Network/Network Manager")] + [HelpURL("https://mirror-networking.gitbook.io/docs/components/network-manager")] + public class NetworkManager : MonoBehaviour + { + /// Enable to keep NetworkManager alive when changing scenes. + // This should be set if your game has a single NetworkManager that exists for the lifetime of the process. If there is a NetworkManager in each scene, then this should not be set. + [Header("Configuration")] + [FormerlySerializedAs("m_DontDestroyOnLoad")] + [Tooltip("Should the Network Manager object be persisted through scene changes?")] + public bool dontDestroyOnLoad = true; + + /// Multiplayer games should always run in the background so the network doesn't time out. + [FormerlySerializedAs("m_RunInBackground")] + [Tooltip("Multiplayer games should always run in the background so the network doesn't time out.")] + public bool runInBackground = true; + + /// Should the server auto-start when 'Server Build' is checked in build settings + [Header("Auto-Start Options")] + + [Tooltip("Choose whether Server or Client should auto-start in headless builds")] + public HeadlessStartOptions headlessStartMode = HeadlessStartOptions.DoNothing; + + [Tooltip("Headless Start Mode in Editor\nwhen enabled, headless start mode will be used in editor as well.")] + public bool editorAutoStart; + + /// Server Update frequency, per second. Use around 60Hz for fast paced games like Counter-Strike to minimize latency. Use around 30Hz for games like WoW to minimize computations. Use around 1-10Hz for slow paced games like EVE. + [Tooltip("Server & Client send rate per second. Use 60-100Hz for fast paced games like Counter-Strike to minimize latency. Use around 30Hz for games like WoW to minimize computations. Use around 1-10Hz for slow paced games like EVE.")] + [FormerlySerializedAs("serverTickRate")] + public int sendRate = 60; + + // Deprecated 2023-11-25 + // Using SerializeField and HideInInspector to self-correct for being + // replaced by headlessStartMode. This can be removed in the future. + // See OnValidate() for how we handle this. + [Obsolete("Deprecated - Use headlessStartMode instead.")] + [FormerlySerializedAs("autoStartServerBuild"), SerializeField, HideInInspector] + public bool autoStartServerBuild = true; + + // Deprecated 2023-11-25 + // Using SerializeField and HideInInspector to self-correct for being + // replaced by headlessStartMode. This can be removed in the future. + // See OnValidate() for how we handle this. + [Obsolete("Deprecated - Use headlessStartMode instead.")] + [FormerlySerializedAs("autoConnectClientBuild"), SerializeField, HideInInspector] + public bool autoConnectClientBuild; + + // client send rate follows server send rate to avoid errors for now + /// Client Update frequency, per second. Use around 60Hz for fast paced games like Counter-Strike to minimize latency. Use around 30Hz for games like WoW to minimize computations. Use around 1-10Hz for slow paced games like EVE. + // [Tooltip("Client broadcasts 'sendRate' times per second. Use around 60Hz for fast paced games like Counter-Strike to minimize latency. Use around 30Hz for games like WoW to minimize computations. Use around 1-10Hz for slow paced games like EVE.")] + // public int clientSendRate = 30; // 33 ms + + /// Automatically switch to this scene upon going offline (on start / on disconnect / on shutdown). + [Header("Scene Management")] + [Scene] + [FormerlySerializedAs("m_OfflineScene")] + [Tooltip("Scene that Mirror will switch to when the client or server is stopped")] + public string offlineScene = ""; + + /// Automatically switch to this scene upon going online (after connect/startserver). + [Scene] + [FormerlySerializedAs("m_OnlineScene")] + [Tooltip("Scene that Mirror will switch to when the server is started. Clients will recieve a Scene Message to load the server's current scene when they connect.")] + public string onlineScene = ""; + + // transport layer + [Header("Network Info")] + [Tooltip("Transport component attached to this object that server and client will use to connect")] + public Transport transport; + + /// Server's address for clients to connect to. + [FormerlySerializedAs("m_NetworkAddress")] + [Tooltip("Network Address where the client should connect to the server. Server does not use this for anything.")] + public string networkAddress = "localhost"; + + /// The maximum number of concurrent network connections to support. + [FormerlySerializedAs("m_MaxConnections")] + [Tooltip("Maximum number of concurrent connections.")] + public int maxConnections = 100; + + // Mirror global disconnect inactive option, independent of Transport. + // not all Transports do this properly, and it's easiest to configure this just once. + // this is very useful for some projects, keep it. + [Tooltip("When enabled, the server automatically disconnects inactive connections after the configured timeout.")] + public bool disconnectInactiveConnections; + + [Tooltip("Timeout in seconds for server to automatically disconnect inactive connections if 'disconnectInactiveConnections' is enabled.")] + public float disconnectInactiveTimeout = 60f; + + [Header("Authentication")] + [Tooltip("Authentication component attached to this object")] + public NetworkAuthenticator authenticator; + + /// The default prefab to be used to create player objects on the server. + // Player objects are created in the default handler for AddPlayer() on + // the server. Implementing OnServerAddPlayer overrides this behaviour. + [Header("Player Object")] + [FormerlySerializedAs("m_PlayerPrefab")] + [Tooltip("Prefab of the player object. Prefab must have a Network Identity component. May be an empty game object or a full avatar.")] + public GameObject playerPrefab; + + /// Enable to automatically create player objects on connect and on scene change. + [FormerlySerializedAs("m_AutoCreatePlayer")] + [Tooltip("Should Mirror automatically spawn the player after scene change?")] + public bool autoCreatePlayer = true; + + /// Where to spawn players. + [FormerlySerializedAs("m_PlayerSpawnMethod")] + [Tooltip("Round Robin or Random order of Start Position selection")] + public PlayerSpawnMethod playerSpawnMethod; + + /// Prefabs that can be spawned over the network need to be registered here. + [FormerlySerializedAs("m_SpawnPrefabs"), HideInInspector] + public List spawnPrefabs = new List(); + + /// List of transforms populated by NetworkStartPositions + public static List startPositions = new List(); + public static int startPositionIndex; + + [Header("Security")] + [Tooltip("For security, it is recommended to disconnect a player if a networked action triggers an exception\nThis could prevent components being accessed in an undefined state, which may be an attack vector for exploits.\nHowever, some games may want to allow exceptions in order to not interrupt the player's experience.")] + public bool exceptionsDisconnect = true; // security by default + + [Header("Snapshot Interpolation")] + public SnapshotInterpolationSettings snapshotSettings = new SnapshotInterpolationSettings(); + + [Header("Connection Quality")] + [Tooltip("Method to use for connection quality evaluation.\nSimple: based on rtt and jitter.\nPragmatic: based on snapshot interpolation adjustment.")] + public ConnectionQualityMethod evaluationMethod; + + [Tooltip("Interval in seconds to evaluate connection quality.\nSet to 0 to disable connection quality evaluation.")] + [Range(0, 60)] + [FormerlySerializedAs("connectionQualityInterval")] + public float evaluationInterval = 3; + + [Header("Debug")] + public bool timeInterpolationGui = false; + + /// The one and only NetworkManager + public static NetworkManager singleton { get; internal set; } + + /// Number of active player objects across all connections on the server. + public int numPlayers => NetworkServer.connections.Count(kv => kv.Value.identity != null); + + /// True if the server is running or client is connected/connecting. + public bool isNetworkActive => NetworkServer.active || NetworkClient.active; + + // TODO remove this + // internal for tests + internal static NetworkConnection clientReadyConnection; + + /// True if the client loaded a new scene when connecting to the server. + // This is set before OnClientConnect is called, so it can be checked + // there to perform different logic if a scene load occurred. + protected bool clientLoadedScene; + + // helper enum to know if we started the networkmanager as server/client/host. + // -> this is necessary because when StartHost changes server scene to + // online scene, FinishLoadScene is called and the host client isn't + // connected yet (no need to connect it before server was fully set up). + // in other words, we need this to know which mode we are running in + // during FinishLoadScene. + public NetworkManagerMode mode { get; private set; } + + // virtual so that inheriting classes' OnValidate() can call base.OnValidate() too + public virtual void OnValidate() + { +#pragma warning disable 618 + // autoStartServerBuild and autoConnectClientBuild are now obsolete, but to avoid + // a breaking change we'll set headlessStartMode to what the user had set before. + // + // headlessStartMode defaults to DoNothing, so if the user had neither of these + // set, then it will remain as DoNothing, and if they set headlessStartMode to + // any selection in the inspector it won't get changed back. + if (autoStartServerBuild) + headlessStartMode = HeadlessStartOptions.AutoStartServer; + else if (autoConnectClientBuild) + headlessStartMode = HeadlessStartOptions.AutoStartClient; + + // Setting both to false here prevents this code from fighting with user + // selection in the inspector, and they're both SerialisedField's. + autoStartServerBuild = false; + autoConnectClientBuild = false; +#pragma warning restore 618 + + // always >= 0 + maxConnections = Mathf.Max(maxConnections, 0); + + if (playerPrefab != null && !playerPrefab.TryGetComponent(out NetworkIdentity _)) + { + Debug.LogError("NetworkManager - Player Prefab must have a NetworkIdentity."); + playerPrefab = null; + } + + // This avoids the mysterious "Replacing existing prefab with assetId ... Old prefab 'Player', New prefab 'Player'" warning. + if (playerPrefab != null && spawnPrefabs.Contains(playerPrefab)) + { + Debug.LogWarning("NetworkManager - Player Prefab doesn't need to be in Spawnable Prefabs list too. Removing it."); + spawnPrefabs.Remove(playerPrefab); + } + } + + // virtual so that inheriting classes' Reset() can call base.Reset() too + // Reset only gets called when the component is added or the user resets the component + // Thats why we validate these things that only need to be validated on adding the NetworkManager here + // If we would do it in OnValidate() then it would run this everytime a value changes + public virtual void Reset() + { + // make sure someone doesn't accidentally add another NetworkManager + // need transform.root because when adding to a child, the parent's + // Reset isn't called. + foreach (NetworkManager manager in transform.root.GetComponentsInChildren()) + { + if (manager != this) + { + Debug.LogError($"{name} detected another component of type {typeof(NetworkManager)} in its hierarchy on {manager.name}. There can only be one, please remove one of them."); + // return early so that transport component isn't auto-added + // to the duplicate NetworkManager. + return; + } + } + } + + // virtual so that inheriting classes' Awake() can call base.Awake() too + public virtual void Awake() + { + // Don't allow collision-destroyed second instance to continue. + if (!InitializeSingleton()) return; + + // Apply configuration in Awake once already + ApplyConfiguration(); + + // Set the networkSceneName to prevent a scene reload + // if client connection to server fails. + networkSceneName = offlineScene; + + // setup OnSceneLoaded callback + SceneManager.sceneLoaded += OnSceneLoaded; + } + + // virtual so that inheriting classes' Start() can call base.Start() too + public virtual void Start() + { + // Auto-start headless server or client. + // + // We can't do this in Awake because Awake is for initialization + // and some transports might not be ready until Start. + // + // Auto-starting in Editor is useful for debugging, so that can + // be enabled with editorAutoStart. + if (Utils.IsHeadless()) + { + if (!Application.isEditor || editorAutoStart) + switch (headlessStartMode) + { + case HeadlessStartOptions.AutoStartServer: + StartServer(); + break; + case HeadlessStartOptions.AutoStartClient: + StartClient(); + break; + } + } + } + + // make sure to call base.Update() when overwriting + public virtual void Update() + { + ApplyConfiguration(); + } + + // virtual so that inheriting classes' LateUpdate() can call base.LateUpdate() too + public virtual void LateUpdate() + { + UpdateScene(); + } + + //////////////////////////////////////////////////////////////////////// + + // keep the online scene change check in a separate function. + // only change scene if the requested online scene is not blank, and is not already loaded. + bool IsServerOnlineSceneChangeNeeded() => + !string.IsNullOrWhiteSpace(onlineScene) && + !Utils.IsSceneActive(onlineScene) && + onlineScene != offlineScene; + + // NetworkManager exposes some NetworkServer/Client configuration. + // we apply it every Update() in order to avoid two sources of truth. + // fixes issues where NetworkServer.sendRate was never set because + // NetworkManager.StartServer was never called, etc. + // => all exposed settings should be applied at all times if NM exists. + void ApplyConfiguration() + { + NetworkServer.tickRate = sendRate; + NetworkClient.snapshotSettings = snapshotSettings; + NetworkClient.connectionQualityInterval = evaluationInterval; + NetworkClient.connectionQualityMethod = evaluationMethod; + } + + // full server setup code, without spawning objects yet + void SetupServer() + { + // Debug.Log("NetworkManager SetupServer"); + InitializeSingleton(); + + // apply settings before initializing anything + NetworkServer.disconnectInactiveConnections = disconnectInactiveConnections; + NetworkServer.disconnectInactiveTimeout = disconnectInactiveTimeout; + NetworkServer.exceptionsDisconnect = exceptionsDisconnect; + + if (runInBackground) + Application.runInBackground = true; + + if (authenticator != null) + { + authenticator.OnStartServer(); + authenticator.OnServerAuthenticated.AddListener(OnServerAuthenticated); + } + + ConfigureHeadlessFrameRate(); + + // start listening to network connections + NetworkServer.Listen(maxConnections); + + // this must be after Listen(), since that registers the default message handlers + RegisterServerMessages(); + + // do not call OnStartServer here yet. + // this is up to the caller. different for server-only vs. host mode. + } + + /// Starts the server, listening for incoming connections. + public void StartServer() + { + if (NetworkServer.active) + { + Debug.LogWarning("Server already started."); + return; + } + + mode = NetworkManagerMode.ServerOnly; + + // StartServer is inherently ASYNCHRONOUS (=doesn't finish immediately) + // + // Here is what it does: + // Listen + // if onlineScene: + // LoadSceneAsync + // ... + // FinishLoadSceneServerOnly + // SpawnObjects + // else: + // SpawnObjects + // + // there is NO WAY to make it synchronous because both LoadSceneAsync + // and LoadScene do not finish loading immediately. as long as we + // have the onlineScene feature, it will be asynchronous! + + SetupServer(); + + // call OnStartServer AFTER Listen, so that NetworkServer.active is + // true and we can call NetworkServer.Spawn in OnStartServer + // overrides. + // (useful for loading & spawning stuff from database etc.) + // + // note: there is no risk of someone connecting after Listen() and + // before OnStartServer() because this all runs in one thread + // and we don't start processing connects until Update. + OnStartServer(); + + // scene change needed? then change scene and spawn afterwards. + if (IsServerOnlineSceneChangeNeeded()) + { + ServerChangeScene(onlineScene); + } + // otherwise spawn directly + else + { + NetworkServer.SpawnObjects(); + } + } + + void SetupClient() + { + InitializeSingleton(); + +#pragma warning disable 618 + // Remove when OnConnectionQualityChanged is removed. + NetworkClient.onConnectionQualityChanged += OnConnectionQualityChanged; +#pragma warning restore 618 + + // apply settings before initializing anything + NetworkClient.exceptionsDisconnect = exceptionsDisconnect; + // NetworkClient.sendRate = clientSendRate; + + if (runInBackground) + Application.runInBackground = true; + + if (authenticator != null) + { + authenticator.OnStartClient(); + authenticator.OnClientAuthenticated.AddListener(OnClientAuthenticated); + } + + } + + /// Starts the client, connects it to the server with networkAddress. + public void StartClient() + { + // Do checks and short circuits before setting anything up. + // If / when we retry, we won't have conflict issues. + if (NetworkClient.active) + { + Debug.LogWarning("Client already started."); + return; + } + + if (string.IsNullOrWhiteSpace(networkAddress)) + { + Debug.LogError("Must set the Network Address field in the manager"); + return; + } + + mode = NetworkManagerMode.ClientOnly; + + SetupClient(); + + // In case this is a headless client... + ConfigureHeadlessFrameRate(); + + RegisterClientMessages(); + + NetworkClient.Connect(networkAddress); + + OnStartClient(); + } + + /// Starts the client, connects it to the server via Uri + public void StartClient(Uri uri) + { + if (NetworkClient.active) + { + Debug.LogWarning("Client already started."); + return; + } + + mode = NetworkManagerMode.ClientOnly; + + SetupClient(); + + RegisterClientMessages(); + + // Debug.Log($"NetworkManager StartClient address:{uri}"); + networkAddress = uri.Host; + + NetworkClient.Connect(uri); + + OnStartClient(); + } + + /// Starts a network "host" - a server and client in the same application. + public void StartHost() + { + if (NetworkServer.active || NetworkClient.active) + { + Debug.LogWarning("Server or Client already started."); + return; + } + + mode = NetworkManagerMode.Host; + + // StartHost is inherently ASYNCHRONOUS (=doesn't finish immediately) + // + // Here is what it does: + // Listen + // ConnectHost + // if onlineScene: + // LoadSceneAsync + // ... + // FinishLoadSceneHost + // FinishStartHost + // SpawnObjects + // StartHostClient <= not guaranteed to happen after SpawnObjects if onlineScene is set! + // ClientAuth + // success: server sends changescene msg to client + // else: + // FinishStartHost + // + // there is NO WAY to make it synchronous because both LoadSceneAsync + // and LoadScene do not finish loading immediately. as long as we + // have the onlineScene feature, it will be asynchronous! + + // setup server first + SetupServer(); + + // scene change needed? then change scene and spawn afterwards. + // => BEFORE host client connects. if client auth succeeds then the + // server tells it to load 'onlineScene'. we can't do that if + // server is still in 'offlineScene'. so load on server first. + if (IsServerOnlineSceneChangeNeeded()) + { + // call FinishStartHost after changing scene. + finishStartHostPending = true; + ServerChangeScene(onlineScene); + } + // otherwise call FinishStartHost directly + else + { + FinishStartHost(); + } + } + + // This may be set true in StartHost and is evaluated in FinishStartHost + bool finishStartHostPending; + + // FinishStartHost is guaranteed to be called after the host server was + // fully started and all the asynchronous StartHost magic is finished + // (= scene loading), or immediately if there was no asynchronous magic. + // + // note: we don't really need FinishStartClient/FinishStartServer. the + // host version is enough. + void FinishStartHost() + { + // ConnectHost needs to be called BEFORE SpawnObjects: + // https://github.com/vis2k/Mirror/pull/1249/ + // -> this sets NetworkServer.localConnection. + // -> localConnection needs to be set before SpawnObjects because: + // -> SpawnObjects calls OnStartServer in all NetworkBehaviours + // -> OnStartServer might spawn an object and set [SyncVar(hook="OnColorChanged")] object.color = green; + // -> this calls SyncVar.set (generated by Weaver), which has + // a custom case for host mode (because host mode doesn't + // get OnDeserialize calls, where SyncVar hooks are usually + // called): + // + // if (!SyncVarEqual(value, ref color)) + // { + // if (NetworkServer.localClientActive && !getSyncVarHookGuard(1uL)) + // { + // setSyncVarHookGuard(1uL, value: true); + // OnColorChangedHook(value); + // setSyncVarHookGuard(1uL, value: false); + // } + // SetSyncVar(value, ref color, 1uL); + // } + // + // -> localClientActive needs to be true, otherwise the hook + // isn't called in host mode! + // + // TODO call this after spawnobjects and worry about the syncvar hook fix later? + NetworkClient.ConnectHost(); + + // invoke user callbacks AFTER ConnectHost has set .activeHost. + // this way initialization can properly handle host mode. + // + // fixes: https://github.com/MirrorNetworking/Mirror/issues/3302 + // where [SyncVar] hooks wouldn't be called for objects spawned in + // NetworkManager.OnStartServer, because .activeHost was still false. + // + // TODO is there a risk of someone connecting between Listen() and FinishStartHost()? + OnStartServer(); + + // call OnStartHost AFTER SetupServer. this way we can use + // NetworkServer.Spawn etc. in there too. just like OnStartServer + // is called after the server is actually properly started. + OnStartHost(); + + // server scene was loaded. now spawn all the objects + NetworkServer.SpawnObjects(); + + // connect client and call OnStartClient AFTER server scene was + // loaded and all objects were spawned. + // DO NOT do this earlier. it would cause race conditions where a + // client will do things before the server is even fully started. + //Debug.Log("StartHostClient called"); + SetupClient(); + RegisterClientMessages(); + + // InvokeOnConnected needs to be called AFTER RegisterClientMessages + // (https://github.com/vis2k/Mirror/pull/1249/) + HostMode.InvokeOnConnected(); + + OnStartClient(); + } + + /// This stops both the client and the server that the manager is using. + public void StopHost() + { + OnStopHost(); + StopClient(); + StopServer(); + } + + /// Stops the server from listening and simulating the game. + public void StopServer() + { + // return if already stopped to avoid recursion deadlock + if (!NetworkServer.active) + return; + + if (authenticator != null) + { + authenticator.OnServerAuthenticated.RemoveListener(OnServerAuthenticated); + authenticator.OnStopServer(); + } + + // Get Network Manager out of DDOL before going to offline scene + // to avoid collision and let a fresh Network Manager be created. + // IMPORTANT: .gameObject can be null if StopClient is called from + // OnApplicationQuit or from tests! + if (gameObject != null + && gameObject.scene.name == "DontDestroyOnLoad" + && !string.IsNullOrWhiteSpace(offlineScene) + && SceneManager.GetActiveScene().path != offlineScene) + SceneManager.MoveGameObjectToScene(gameObject, SceneManager.GetActiveScene()); + + OnStopServer(); + + //Debug.Log("NetworkManager StopServer"); + NetworkServer.Shutdown(); + + // set offline mode BEFORE changing scene so that FinishStartScene + // doesn't think we need initialize anything. + mode = NetworkManagerMode.Offline; + + if (!string.IsNullOrWhiteSpace(offlineScene)) + { + ServerChangeScene(offlineScene); + } + + startPositionIndex = 0; + + networkSceneName = ""; + } + + /// Stops and disconnects the client. + public void StopClient() + { + if (mode == NetworkManagerMode.Offline) + return; + + // For Host client, call OnServerDisconnect before NetworkClient.Disconnect + // because we need NetworkServer.localConnection to not be null + // NetworkClient.Disconnect will set it null. + if (mode == NetworkManagerMode.Host) + OnServerDisconnect(NetworkServer.localConnection); + + // ask client -> transport to disconnect. + // handle voluntary and involuntary disconnects in OnClientDisconnect. + // + // StopClient + // NetworkClient.Disconnect + // Transport.Disconnect + // ... + // Transport.OnClientDisconnect + // NetworkClient.OnTransportDisconnect + // NetworkManager.OnClientDisconnect + NetworkClient.Disconnect(); + +#pragma warning disable 618 + // Remove when OnConnectionQualityChanged is removed. + NetworkClient.onConnectionQualityChanged -= OnConnectionQualityChanged; +#pragma warning restore 618 + + // UNET invoked OnDisconnected cleanup immediately. + // let's keep it for now, in case any projects depend on it. + // TODO simply remove this in the future. + OnClientDisconnectInternal(); + } + + // called when quitting the application by closing the window / pressing + // stop in the editor. virtual so that inheriting classes' + // OnApplicationQuit() can call base.OnApplicationQuit() too + public virtual void OnApplicationQuit() + { + // stop client first + // (we want to send the quit packet to the server instead of waiting + // for a timeout) + if (NetworkClient.isConnected) + { + StopClient(); + //Debug.Log("OnApplicationQuit: stopped client"); + } + + // stop server after stopping client (for proper host mode stopping) + if (NetworkServer.active) + { + StopServer(); + //Debug.Log("OnApplicationQuit: stopped server"); + } + + // Call ResetStatics to reset statics and singleton + ResetStatics(); + } + + /// Set the frame rate for a headless builds. Override to disable or modify. + // useful for dedicated servers. + // useful for headless benchmark clients. + public virtual void ConfigureHeadlessFrameRate() + { + if (Utils.IsHeadless()) + { + Application.targetFrameRate = sendRate; + // Debug.Log($"Server Tick Rate set to {Application.targetFrameRate} Hz."); + } + } + + bool InitializeSingleton() + { + if (singleton != null && singleton == this) + return true; + + if (dontDestroyOnLoad) + { + if (singleton != null) + { + Debug.LogWarning("Multiple NetworkManagers detected in the scene. Only one NetworkManager can exist at a time. The duplicate NetworkManager will be destroyed."); + Destroy(gameObject); + + // Return false to not allow collision-destroyed second instance to continue. + return false; + } + //Debug.Log("NetworkManager created singleton (DontDestroyOnLoad)"); + singleton = this; + if (Application.isPlaying) + { + // Force the object to scene root, in case user made it a child of something + // in the scene since DDOL is only allowed for scene root objects + transform.SetParent(null); + DontDestroyOnLoad(gameObject); + } + } + else + { + //Debug.Log("NetworkManager created singleton (ForScene)"); + singleton = this; + } + + // set active transport AFTER setting singleton. + // so only if we didn't destroy ourselves. + + // This tries to avoid missing transport errors and more clearly tells user what to fix. + if (transport == null) + if (TryGetComponent(out Transport newTransport)) + { + Debug.LogWarning($"No Transport assigned to Network Manager - Using {newTransport} found on same object."); + transport = newTransport; + } + else + { + Debug.LogError("No Transport on Network Manager...add a transport and assign it."); + return false; + } + + Transport.active = transport; + return true; + } + + void RegisterServerMessages() + { + NetworkServer.OnConnectedEvent = OnServerConnectInternal; + NetworkServer.OnDisconnectedEvent = OnServerDisconnect; + NetworkServer.OnErrorEvent = OnServerError; + NetworkServer.RegisterHandler(OnServerAddPlayerInternal); + + // Network Server initially registers its own handler for this, so we replace it here. + NetworkServer.ReplaceHandler(OnServerReadyMessageInternal); + } + + void RegisterClientMessages() + { + NetworkClient.OnConnectedEvent = OnClientConnectInternal; + NetworkClient.OnDisconnectedEvent = OnClientDisconnectInternal; + NetworkClient.OnErrorEvent = OnClientError; + // Don't require authentication because server may send NotReadyMessage from ServerChangeScene + NetworkClient.RegisterHandler(OnClientNotReadyMessageInternal, false); + NetworkClient.RegisterHandler(OnClientSceneInternal, false); + + if (playerPrefab != null) + NetworkClient.RegisterPrefab(playerPrefab); + + foreach (GameObject prefab in spawnPrefabs.Where(t => t != null)) + NetworkClient.RegisterPrefab(prefab); + } + + // This is the only way to clear the singleton, so another instance can be created. + // RuntimeInitializeOnLoadMethod -> fast playmode without domain reload + [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)] + public static void ResetStatics() + { + // call StopHost if we have a singleton + if (singleton) + singleton.StopHost(); + + // reset all statics + startPositions.Clear(); + startPositionIndex = 0; + clientReadyConnection = null; + loadingSceneAsync = null; + networkSceneName = string.Empty; + + // and finally (in case it isn't null already)... + singleton = null; + } + + // virtual so that inheriting classes' OnDestroy() can call base.OnDestroy() too + public virtual void OnDestroy() + { + //Debug.Log("NetworkManager destroyed"); + } + + /// The name of the current network scene. + // set by NetworkManager when changing the scene. + // new clients will automatically load this scene. + // Loading a scene manually won't set it. + public static string networkSceneName { get; protected set; } = ""; + + public static AsyncOperation loadingSceneAsync; + + /// Change the server scene and all client's scenes across the network. + // Called automatically if onlineScene or offlineScene are set, but it + // can be called from user code to switch scenes again while the game is + // in progress. This automatically sets clients to be not-ready during + // the change and ready again to participate in the new scene. + public virtual void ServerChangeScene(string newSceneName) + { + if (string.IsNullOrWhiteSpace(newSceneName)) + { + Debug.LogError("ServerChangeScene empty scene name"); + return; + } + + if (NetworkServer.isLoadingScene && newSceneName == networkSceneName) + { + Debug.LogError($"Scene change is already in progress for {newSceneName}"); + return; + } + + // Throw error if called from client + // Allow changing scene while stopping the server + if (!NetworkServer.active && newSceneName != offlineScene) + { + Debug.LogError("ServerChangeScene can only be called on an active server."); + return; + } + + // Debug.Log($"ServerChangeScene {newSceneName}"); + NetworkServer.SetAllClientsNotReady(); + networkSceneName = newSceneName; + + // Let server prepare for scene change + OnServerChangeScene(newSceneName); + + // set server flag to stop processing messages while changing scenes + // it will be re-enabled in FinishLoadScene. + NetworkServer.isLoadingScene = true; + + loadingSceneAsync = SceneManager.LoadSceneAsync(newSceneName); + + // ServerChangeScene can be called when stopping the server + // when this happens the server is not active so does not need to tell clients about the change + if (NetworkServer.active) + { + // notify all clients about the new scene + NetworkServer.SendToAll(new SceneMessage + { + sceneName = newSceneName + }); + } + + startPositionIndex = 0; + startPositions.Clear(); + } + + // This is only set in ClientChangeScene below...never on server. + // We need to check this in OnClientSceneChanged called from FinishLoadSceneClientOnly + // to prevent AddPlayer message after loading/unloading additive scenes + SceneOperation clientSceneOperation = SceneOperation.Normal; + + internal void ClientChangeScene(string newSceneName, SceneOperation sceneOperation = SceneOperation.Normal, bool customHandling = false) + { + if (string.IsNullOrWhiteSpace(newSceneName)) + { + Debug.LogError("ClientChangeScene empty scene name"); + return; + } + + //Debug.Log($"ClientChangeScene newSceneName: {newSceneName} networkSceneName{networkSceneName}"); + + // Let client prepare for scene change + OnClientChangeScene(newSceneName, sceneOperation, customHandling); + + // After calling OnClientChangeScene, exit if server since server is already doing + // the actual scene change, and we don't need to do it for the host client + if (NetworkServer.active) + return; + + // set client flag to stop processing messages while loading scenes. + // otherwise we would process messages and then lose all the state + // as soon as the load is finishing, causing all kinds of bugs + // because of missing state. + // (client may be null after StopClient etc.) + // Debug.Log("ClientChangeScene: pausing handlers while scene is loading to avoid data loss after scene was loaded."); + NetworkClient.isLoadingScene = true; + + // Cache sceneOperation so we know what was requested by the + // Scene message in OnClientChangeScene and OnClientSceneChanged + clientSceneOperation = sceneOperation; + + // scene handling will happen in overrides of OnClientChangeScene and/or OnClientSceneChanged + // Do not call FinishLoadScene here. Custom handler will assign loadingSceneAsync and we need + // to wait for that to finish. UpdateScene already checks for that to be not null and isDone. + if (customHandling) + return; + + switch (sceneOperation) + { + case SceneOperation.Normal: + loadingSceneAsync = SceneManager.LoadSceneAsync(newSceneName); + break; + case SceneOperation.LoadAdditive: + // Ensure additive scene is not already loaded on client by name or path + // since we don't know which was passed in the Scene message + if (!SceneManager.GetSceneByName(newSceneName).IsValid() && !SceneManager.GetSceneByPath(newSceneName).IsValid()) + loadingSceneAsync = SceneManager.LoadSceneAsync(newSceneName, LoadSceneMode.Additive); + else + { + Debug.LogWarning($"Scene {newSceneName} is already loaded"); + + // Reset the flag that we disabled before entering this switch + NetworkClient.isLoadingScene = false; + } + break; + case SceneOperation.UnloadAdditive: + // Ensure additive scene is actually loaded on client by name or path + // since we don't know which was passed in the Scene message + if (SceneManager.GetSceneByName(newSceneName).IsValid() || SceneManager.GetSceneByPath(newSceneName).IsValid()) + loadingSceneAsync = SceneManager.UnloadSceneAsync(newSceneName, UnloadSceneOptions.UnloadAllEmbeddedSceneObjects); + else + { + Debug.LogWarning($"Cannot unload {newSceneName} with UnloadAdditive operation"); + + // Reset the flag that we disabled before entering this switch + NetworkClient.isLoadingScene = false; + } + break; + } + + // don't change the client's current networkSceneName when loading additive scene content + if (sceneOperation == SceneOperation.Normal) + networkSceneName = newSceneName; + } + + // support additive scene loads: + // NetworkScenePostProcess disables all scene objects on load, and + // * NetworkServer.SpawnObjects enables them again on the server when + // calling OnStartServer + // * NetworkClient.PrepareToSpawnSceneObjects enables them again on the + // client after the server sends ObjectSpawnStartedMessage to client + // in SpawnObserversForConnection. this is only called when the + // client joins, so we need to rebuild scene objects manually again + // TODO merge this with FinishLoadScene()? + void OnSceneLoaded(Scene scene, LoadSceneMode mode) + { + if (mode == LoadSceneMode.Additive) + { + if (NetworkServer.active) + { + // TODO only respawn the server objects from that scene later! + NetworkServer.SpawnObjects(); + // Debug.Log($"Respawned Server objects after additive scene load: {scene.name}"); + } + if (NetworkClient.active) + { + NetworkClient.PrepareToSpawnSceneObjects(); + // Debug.Log($"Rebuild Client spawnableObjects after additive scene load: {scene.name}"); + } + } + } + + void UpdateScene() + { + if (loadingSceneAsync != null && loadingSceneAsync.isDone) + { + //Debug.Log($"ClientChangeScene done readyConn {clientReadyConnection}"); + + // try-finally to guarantee loadingSceneAsync being cleared. + // fixes https://github.com/vis2k/Mirror/issues/2517 where if + // FinishLoadScene throws an exception, loadingSceneAsync would + // never be cleared and this code would run every Update. + try + { + FinishLoadScene(); + } + finally + { + loadingSceneAsync.allowSceneActivation = true; + loadingSceneAsync = null; + } + } + } + + protected void FinishLoadScene() + { + // NOTE: this cannot use NetworkClient.allClients[0] - that client may be for a completely different purpose. + + // process queued messages that we received while loading the scene + //Debug.Log("FinishLoadScene: resuming handlers after scene was loading."); + NetworkServer.isLoadingScene = false; + NetworkClient.isLoadingScene = false; + + // host mode? + if (mode == NetworkManagerMode.Host) + { + FinishLoadSceneHost(); + } + // server-only mode? + else if (mode == NetworkManagerMode.ServerOnly) + { + FinishLoadSceneServerOnly(); + } + // client-only mode? + else if (mode == NetworkManagerMode.ClientOnly) + { + FinishLoadSceneClientOnly(); + } + // otherwise we called it after stopping when loading offline scene. + // do nothing then. + } + + // finish load scene part for host mode. makes code easier and is + // necessary for FinishStartHost later. + // (the 3 things have to happen in that exact order) + void FinishLoadSceneHost() + { + // debug message is very important. if we ever break anything then + // it's very obvious to notice. + //Debug.Log("Finished loading scene in host mode."); + + if (clientReadyConnection != null) + { + clientLoadedScene = true; + clientReadyConnection = null; + } + + // do we need to finish a StartHost() call? + // then call FinishStartHost and let it take care of spawning etc. + if (finishStartHostPending) + { + finishStartHostPending = false; + FinishStartHost(); + + // call OnServerSceneChanged + OnServerSceneChanged(networkSceneName); + + // DO NOT call OnClientSceneChanged here. + // the scene change happened because StartHost loaded the + // server's online scene. it has nothing to do with the client. + // this was not meant as a client scene load, so don't call it. + // + // otherwise AddPlayer would be called twice: + // -> once for client OnConnected + // -> once in OnClientSceneChanged + } + // otherwise we just changed a scene in host mode + else + { + // spawn server objects + NetworkServer.SpawnObjects(); + + // call OnServerSceneChanged + OnServerSceneChanged(networkSceneName); + + if (NetworkClient.isConnected) + OnClientSceneChanged(); + } + } + + // finish load scene part for server-only. . makes code easier and is + // necessary for FinishStartServer later. + void FinishLoadSceneServerOnly() + { + // debug message is very important. if we ever break anything then + // it's very obvious to notice. + //Debug.Log("Finished loading scene in server-only mode."); + + NetworkServer.SpawnObjects(); + OnServerSceneChanged(networkSceneName); + } + + // finish load scene part for client-only. makes code easier and is + // necessary for FinishStartClient later. + void FinishLoadSceneClientOnly() + { + // debug message is very important. if we ever break anything then + // it's very obvious to notice. + //Debug.Log("Finished loading scene in client-only mode."); + + if (clientReadyConnection != null) + { + clientLoadedScene = true; + clientReadyConnection = null; + } + + if (NetworkClient.isConnected) + OnClientSceneChanged(); + } + + /// + /// Registers the transform of a game object as a player spawn location. + /// This is done automatically by NetworkStartPosition components, but can be done manually from user script code. + /// + /// Transform to register. + // Static because it's called from NetworkStartPosition::Awake + // and singleton may not exist yet + public static void RegisterStartPosition(Transform start) + { + // Debug.Log($"RegisterStartPosition: {start.gameObject.name} {start.position}"); + startPositions.Add(start); + + // reorder the list so that round-robin spawning uses the start positions + // in hierarchy order. This assumes all objects with NetworkStartPosition + // component are siblings, either in the scene root or together as children + // under a single parent in the scene. + startPositions = startPositions.OrderBy(transform => transform.GetSiblingIndex()).ToList(); + } + + /// Unregister a Transform from start positions. + // Static because it's called from NetworkStartPosition::OnDestroy + // and singleton may not exist yet + public static void UnRegisterStartPosition(Transform start) + { + //Debug.Log($"UnRegisterStartPosition: {start.name} {start.position}"); + startPositions.Remove(start); + } + + /// Get the next NetworkStartPosition based on the selected PlayerSpawnMethod. + public virtual Transform GetStartPosition() + { + // first remove any dead transforms + startPositions.RemoveAll(t => t == null); + + if (startPositions.Count == 0) + return null; + + if (playerSpawnMethod == PlayerSpawnMethod.Random) + { + return startPositions[UnityEngine.Random.Range(0, startPositions.Count)]; + } + else + { + Transform startPosition = startPositions[startPositionIndex]; + startPositionIndex = (startPositionIndex + 1) % startPositions.Count; + return startPosition; + } + } + + void OnServerConnectInternal(NetworkConnectionToClient conn) + { + //Debug.Log("NetworkManager.OnServerConnectInternal"); + + if (authenticator != null) + { + // we have an authenticator - let it handle authentication + authenticator.OnServerAuthenticate(conn); + } + else + { + // authenticate immediately + OnServerAuthenticated(conn); + } + } + + // called after successful authentication + // TODO do the NetworkServer.OnAuthenticated thing from x branch + void OnServerAuthenticated(NetworkConnectionToClient conn) + { + //Debug.Log("NetworkManager.OnServerAuthenticated"); + + // set connection to authenticated + conn.isAuthenticated = true; + + // proceed with the login handshake by calling OnServerConnect + if (networkSceneName != "" && networkSceneName != offlineScene) + { + SceneMessage msg = new SceneMessage() + { + sceneName = networkSceneName + }; + conn.Send(msg); + } + + OnServerConnect(conn); + } + + void OnServerReadyMessageInternal(NetworkConnectionToClient conn, ReadyMessage msg) + { + //Debug.Log("NetworkManager.OnServerReadyMessageInternal"); + OnServerReady(conn); + } + + void OnServerAddPlayerInternal(NetworkConnectionToClient conn, AddPlayerMessage msg) + { + //Debug.Log("NetworkManager.OnServerAddPlayer"); + + if (autoCreatePlayer && playerPrefab == null) + { + Debug.LogError("The PlayerPrefab is empty on the NetworkManager. Please setup a PlayerPrefab object."); + return; + } + + if (autoCreatePlayer && !playerPrefab.TryGetComponent(out NetworkIdentity _)) + { + Debug.LogError("The PlayerPrefab does not have a NetworkIdentity. Please add a NetworkIdentity to the player prefab."); + return; + } + + if (conn.identity != null) + { + Debug.LogError("There is already a player for this connection."); + return; + } + + OnServerAddPlayer(conn); + } + + void OnClientConnectInternal() + { + //Debug.Log("NetworkManager.OnClientConnectInternal"); + + if (authenticator != null) + { + // we have an authenticator - let it handle authentication + authenticator.OnClientAuthenticate(); + } + else + { + // authenticate immediately + OnClientAuthenticated(); + } + } + + // called after successful authentication + void OnClientAuthenticated() + { + //Debug.Log("NetworkManager.OnClientAuthenticated"); + + // set connection to authenticated + NetworkClient.connection.isAuthenticated = true; + + // Set flag to wait for scene change? + if (string.IsNullOrWhiteSpace(onlineScene) || onlineScene == offlineScene || Utils.IsSceneActive(onlineScene)) + { + clientLoadedScene = false; + } + else + { + // Scene message expected from server. + clientLoadedScene = true; + clientReadyConnection = NetworkClient.connection; + } + + // Call virtual method regardless of whether a scene change is expected or not. + OnClientConnect(); + } + + // Transport callback, invoked after client fully disconnected. + // the call order should always be: + // Disconnect() -> ask Transport -> Transport.OnDisconnected -> Cleanup + void OnClientDisconnectInternal() + { + //Debug.Log("NetworkManager.OnClientDisconnectInternal"); + + // Only let this run once. StopClient in Host mode changes to ServerOnly + if (mode == NetworkManagerMode.ServerOnly || mode == NetworkManagerMode.Offline) + return; + + // user callback + OnClientDisconnect(); + + if (authenticator != null) + { + authenticator.OnClientAuthenticated.RemoveListener(OnClientAuthenticated); + authenticator.OnStopClient(); + } + + // set mode BEFORE changing scene so FinishStartScene doesn't re-initialize anything. + // set mode BEFORE NetworkClient.Disconnect so StopClient only runs once. + // set mode BEFORE OnStopClient so StopClient only runs once. + // If we got here from StopClient in Host mode, change to ServerOnly. + // - If StopHost was called, StopServer will put us in Offline mode. + if (mode == NetworkManagerMode.Host) + mode = NetworkManagerMode.ServerOnly; + else + mode = NetworkManagerMode.Offline; + + //Debug.Log("NetworkManager StopClient"); + OnStopClient(); + + // shutdown client + NetworkClient.Shutdown(); + + // Exit here if we're now in ServerOnly mode (StopClient called in Host mode). + if (mode == NetworkManagerMode.ServerOnly) return; + + // Get Network Manager out of DDOL before going to offline scene + // to avoid collision and let a fresh Network Manager be created. + // IMPORTANT: .gameObject can be null if StopClient is called from + // OnApplicationQuit or from tests! + if (gameObject != null + && gameObject.scene.name == "DontDestroyOnLoad" + && !string.IsNullOrWhiteSpace(offlineScene) + && SceneManager.GetActiveScene().path != offlineScene) + SceneManager.MoveGameObjectToScene(gameObject, SceneManager.GetActiveScene()); + + // If StopHost called in Host mode, StopServer will change scenes after this. + // Check loadingSceneAsync to ensure we don't double-invoke the scene change. + // Check if NetworkServer.active because we can get here via Disconnect before server has started to change scenes. + if (!string.IsNullOrWhiteSpace(offlineScene) && !Utils.IsSceneActive(offlineScene) && loadingSceneAsync == null && !NetworkServer.active) + { + ClientChangeScene(offlineScene, SceneOperation.Normal); + } + + networkSceneName = ""; + } + + void OnClientNotReadyMessageInternal(NotReadyMessage msg) + { + //Debug.Log("NetworkManager.OnClientNotReadyMessageInternal"); + NetworkClient.ready = false; + OnClientNotReady(); + + // NOTE: clientReadyConnection is not set here! don't want OnClientConnect to be invoked again after scene changes. + } + + void OnClientSceneInternal(SceneMessage msg) + { + //Debug.Log("NetworkManager.OnClientSceneInternal"); + + // This needs to run for host client too. NetworkServer.active is checked there + if (NetworkClient.isConnected) + { + ClientChangeScene(msg.sceneName, msg.sceneOperation, msg.customHandling); + } + } + + /// Called on the server when a new client connects. + public virtual void OnServerConnect(NetworkConnectionToClient conn) { } + + /// Called on the server when a client disconnects. + // Called by NetworkServer.OnTransportDisconnect! + public virtual void OnServerDisconnect(NetworkConnectionToClient conn) + { + // by default, this function destroys the connection's player. + // can be overwritten for cases like delayed logouts in MMOs to + // avoid players escaping from PvP situations by logging out. + NetworkServer.DestroyPlayerForConnection(conn); + //Debug.Log("OnServerDisconnect: Client disconnected."); + } + + /// Called on the server when a client is ready (= loaded the scene) + public virtual void OnServerReady(NetworkConnectionToClient conn) + { + if (conn.identity == null) + { + // this is now allowed (was not for a while) + //Debug.Log("Ready with no player object"); + } + NetworkServer.SetClientReady(conn); + } + + /// Called on server when a client requests to add the player. Adds playerPrefab by default. Can be overwritten. + // The default implementation for this function creates a new player object from the playerPrefab. + public virtual void OnServerAddPlayer(NetworkConnectionToClient conn) + { + Transform startPos = GetStartPosition(); + GameObject player = startPos != null + ? Instantiate(playerPrefab, startPos.position, startPos.rotation) + : Instantiate(playerPrefab); + + // instantiating a "Player" prefab gives it the name "Player(clone)" + // => appending the connectionId is WAY more useful for debugging! + player.name = $"{playerPrefab.name} [connId={conn.connectionId}]"; + NetworkServer.AddPlayerForConnection(conn, player); + } + + /// Called on server when transport raises an exception. NetworkConnection may be null. + public virtual void OnServerError(NetworkConnectionToClient conn, TransportError error, string reason) { } + + /// Called from ServerChangeScene immediately before SceneManager.LoadSceneAsync is executed + public virtual void OnServerChangeScene(string newSceneName) { } + + /// Called on server after a scene load with ServerChangeScene() is completed. + public virtual void OnServerSceneChanged(string sceneName) { } + + /// Called on the client when connected to a server. By default it sets client as ready and adds a player. + public virtual void OnClientConnect() + { + // OnClientConnect by default calls AddPlayer but it should not do + // that when we have online/offline scenes. so we need the + // clientLoadedScene flag to prevent it. + if (!clientLoadedScene) + { + // Ready/AddPlayer is usually triggered by a scene load completing. + // if no scene was loaded, then Ready/AddPlayer it here instead. + if (!NetworkClient.ready) + NetworkClient.Ready(); + + if (autoCreatePlayer) + NetworkClient.AddPlayer(); + } + } + + /// Called on clients when disconnected from a server. + public virtual void OnClientDisconnect() { } + + // Deprecated 2023-12-05 + /// Deprecated: NetworkClient handles this now. + [Obsolete("NetworkClient handles this now.")] + public virtual void CalculateConnectionQuality() + { + // Moved to NetworkClient + } + + // Deprecated 2023-12-05 + /// Deprecated: NetworkClient handles this now. + [Obsolete("This will be removed. Subscribe to NetworkClient.onConnectionQualityChanged in your own code")] + public virtual void OnConnectionQualityChanged(ConnectionQuality previous, ConnectionQuality current) + { + // logging the change is very useful to track down user's lag reports. + // we want to include as much detail as possible for debugging. + //Debug.Log($"[Mirror] Connection Quality changed from {previous} to {current}:\n rtt={(NetworkTime.rtt * 1000):F1}ms\n rttVar={(NetworkTime.rttVariance * 1000):F1}ms\n bufferTime={(NetworkClient.bufferTime * 1000):F1}ms"); + } + + /// Called on client when transport raises an exception. + public virtual void OnClientError(TransportError error, string reason) { } + + /// Called on clients when a servers tells the client it is no longer ready, e.g. when switching scenes. + public virtual void OnClientNotReady() { } + + /// Called from ClientChangeScene immediately before SceneManager.LoadSceneAsync is executed + // customHandling: indicates if scene loading will be handled through overrides + public virtual void OnClientChangeScene(string newSceneName, SceneOperation sceneOperation, bool customHandling) { } + + /// Called on clients when a scene has completed loaded, when the scene load was initiated by the server. + // Scene changes can cause player objects to be destroyed. The default + // implementation of OnClientSceneChanged in the NetworkManager is to + // add a player object for the connection if no player object exists. + public virtual void OnClientSceneChanged() + { + // always become ready. + if (NetworkClient.connection.isAuthenticated && !NetworkClient.ready) NetworkClient.Ready(); + + // Only call AddPlayer for normal scene changes, not additive load/unload + if (NetworkClient.connection.isAuthenticated && clientSceneOperation == SceneOperation.Normal && autoCreatePlayer && NetworkClient.localPlayer == null) + { + // add player if existing one is null + NetworkClient.AddPlayer(); + } + } + + // Since there are multiple versions of StartServer, StartClient and + // StartHost, to reliably customize their functionality, users would + // need override all the versions. Instead these callbacks are invoked + // from all versions, so users only need to implement this one case. + + /// This is invoked when a host is started. + public virtual void OnStartHost() { } + + /// This is invoked when a server is started - including when a host is started. + public virtual void OnStartServer() { } + + /// This is invoked when the client is started. + public virtual void OnStartClient() { } + + /// This is called when a server is stopped - including when a host is stopped. + public virtual void OnStopServer() { } + + /// This is called when a client is stopped. + public virtual void OnStopClient() { } + + /// This is called when a host is stopped. + public virtual void OnStopHost() { } + + // keep OnGUI even in builds. useful to debug snap interp. + void OnGUI() + { + if (!timeInterpolationGui) return; + NetworkClient.OnGUI(); + } + } +} diff --git a/Assets/Mirror/Core/NetworkManager.cs.meta b/Assets/Mirror/Core/NetworkManager.cs.meta new file mode 100644 index 0000000..0a7564a --- /dev/null +++ b/Assets/Mirror/Core/NetworkManager.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 8aab4c8111b7c411b9b92cf3dbc5bd4e +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/NetworkManagerHUD.cs b/Assets/Mirror/Core/NetworkManagerHUD.cs new file mode 100644 index 0000000..62a126b --- /dev/null +++ b/Assets/Mirror/Core/NetworkManagerHUD.cs @@ -0,0 +1,162 @@ +using UnityEngine; + +namespace Mirror +{ + /// Shows NetworkManager controls in a GUI at runtime. + [DisallowMultipleComponent] + [AddComponentMenu("Network/Network Manager HUD")] + [RequireComponent(typeof(NetworkManager))] + [HelpURL("https://mirror-networking.gitbook.io/docs/components/network-manager-hud")] + public class NetworkManagerHUD : MonoBehaviour + { + NetworkManager manager; + + public int offsetX; + public int offsetY; + + void Awake() + { + manager = GetComponent(); + } + + void OnGUI() + { + // If this width is changed, also change offsetX in GUIConsole::OnGUI + int width = 300; + + GUILayout.BeginArea(new Rect(10 + offsetX, 40 + offsetY, width, 9999)); + + if (!NetworkClient.isConnected && !NetworkServer.active) + StartButtons(); + else + StatusLabels(); + + if (NetworkClient.isConnected && !NetworkClient.ready) + { + if (GUILayout.Button("Client Ready")) + { + // client ready + NetworkClient.Ready(); + if (NetworkClient.localPlayer == null) + NetworkClient.AddPlayer(); + } + } + + StopButtons(); + + GUILayout.EndArea(); + } + + void StartButtons() + { + if (!NetworkClient.active) + { +#if UNITY_WEBGL + // cant be a server in webgl build + if (GUILayout.Button("Single Player")) + { + NetworkServer.dontListen = true; + manager.StartHost(); + } +#else + // Server + Client + if (GUILayout.Button("Host (Server + Client)")) + manager.StartHost(); +#endif + + // Client + IP (+ PORT) + GUILayout.BeginHorizontal(); + + if (GUILayout.Button("Client")) + manager.StartClient(); + + manager.networkAddress = GUILayout.TextField(manager.networkAddress); + // only show a port field if we have a port transport + // we can't have "IP:PORT" in the address field since this only + // works for IPV4:PORT. + // for IPV6:PORT it would be misleading since IPV6 contains ":": + // 2001:0db8:0000:0000:0000:ff00:0042:8329 + if (Transport.active is PortTransport portTransport) + { + // use TryParse in case someone tries to enter non-numeric characters + if (ushort.TryParse(GUILayout.TextField(portTransport.Port.ToString()), out ushort port)) + portTransport.Port = port; + } + + GUILayout.EndHorizontal(); + + // Server Only +#if UNITY_WEBGL + // cant be a server in webgl build + GUILayout.Box("( WebGL cannot be server )"); +#else + if (GUILayout.Button("Server Only")) + manager.StartServer(); +#endif + } + else + { + // Connecting + GUILayout.Label($"Connecting to {manager.networkAddress}.."); + if (GUILayout.Button("Cancel Connection Attempt")) + manager.StopClient(); + } + } + + void StatusLabels() + { + // host mode + // display separately because this always confused people: + // Server: ... + // Client: ... + if (NetworkServer.active && NetworkClient.active) + { + // host mode + GUILayout.Label($"Host: running via {Transport.active}"); + } + else if (NetworkServer.active) + { + // server only + GUILayout.Label($"Server: running via {Transport.active}"); + } + else if (NetworkClient.isConnected) + { + // client only + GUILayout.Label($"Client: connected to {manager.networkAddress} via {Transport.active}"); + } + } + + void StopButtons() + { + if (NetworkServer.active && NetworkClient.isConnected) + { + GUILayout.BeginHorizontal(); +#if UNITY_WEBGL + if (GUILayout.Button("Stop Single Player")) + manager.StopHost(); +#else + // stop host if host mode + if (GUILayout.Button("Stop Host")) + manager.StopHost(); + + // stop client if host mode, leaving server up + if (GUILayout.Button("Stop Client")) + manager.StopClient(); +#endif + GUILayout.EndHorizontal(); + } + else if (NetworkClient.isConnected) + { + // stop client if client-only + if (GUILayout.Button("Stop Client")) + manager.StopClient(); + } + else if (NetworkServer.active) + { + // stop server if server-only + if (GUILayout.Button("Stop Server")) + manager.StopServer(); + } + } + } +} diff --git a/Assets/Mirror/Core/NetworkManagerHUD.cs.meta b/Assets/Mirror/Core/NetworkManagerHUD.cs.meta new file mode 100644 index 0000000..a720b9c --- /dev/null +++ b/Assets/Mirror/Core/NetworkManagerHUD.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 6442dc8070ceb41f094e44de0bf87274 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/NetworkMessage.cs b/Assets/Mirror/Core/NetworkMessage.cs new file mode 100644 index 0000000..7fc387a --- /dev/null +++ b/Assets/Mirror/Core/NetworkMessage.cs @@ -0,0 +1,4 @@ +namespace Mirror +{ + public interface NetworkMessage {} +} diff --git a/Assets/Mirror/Core/NetworkMessage.cs.meta b/Assets/Mirror/Core/NetworkMessage.cs.meta new file mode 100644 index 0000000..73d3d8f --- /dev/null +++ b/Assets/Mirror/Core/NetworkMessage.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: eb04e4848a2e4452aa2dbd7adb801c51 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/NetworkMessages.cs b/Assets/Mirror/Core/NetworkMessages.cs new file mode 100644 index 0000000..7a70d94 --- /dev/null +++ b/Assets/Mirror/Core/NetworkMessages.cs @@ -0,0 +1,210 @@ +using System; +using System.Collections.Generic; +using System.Runtime.CompilerServices; +using System.Text; +using UnityEngine; + +namespace Mirror +{ + // for performance, we (ab)use c# generics to cache the message id in a static field + // this is significantly faster than doing the computation at runtime or looking up cached results via Dictionary + // generic classes have separate static fields per type specification + public static class NetworkMessageId where T : struct, NetworkMessage + { + // automated message id from type hash. + // platform independent via stable hashcode. + // => convenient so we don't need to track messageIds across projects + // => addons can work with each other without knowing their ids before + // => 2 bytes is enough to avoid collisions. + // registering a messageId twice will log a warning anyway. + public static readonly ushort Id = CalculateId(); + + // Gets the 32bit fnv1a hash + // To get it down to 16bit but still reduce hash collisions we cant just cast it to ushort + // Instead we take the highest 16bits of the 32bit hash and fold them with xor into the lower 16bits + // This will create a more uniform 16bit hash, the method is described in: + // http://www.isthe.com/chongo/tech/comp/fnv/ in section "Changing the FNV hash size - xor-folding" + static ushort CalculateId() => typeof(T).FullName.GetStableHashCode16(); + } + + // message packing all in one place, instead of constructing headers in all + // kinds of different places + // + // MsgType (2 bytes) + // Content (ContentSize bytes) + public static class NetworkMessages + { + // size of message id header in bytes + public const int IdSize = sizeof(ushort); + + // Id <> Type lookup for debugging, profiler, etc. + // important when debugging messageId errors! + public static readonly Dictionary Lookup = + new Dictionary(); + + // dump all types for debugging + public static void LogTypes() + { + StringBuilder builder = new StringBuilder(); + builder.AppendLine("NetworkMessageIds:"); + foreach (KeyValuePair kvp in Lookup) + { + builder.AppendLine($" Id={kvp.Key} = {kvp.Value}"); + } + Debug.Log(builder.ToString()); + } + + // max message content size (without header) calculation for convenience + // -> Transport.GetMaxPacketSize is the raw maximum + // -> Every message gets serialized into <> + // -> Every serialized message get put into a batch with one timestamp per batch + // -> Every message in a batch has a varuint size header. + // use the worst case VarUInt size for the largest possible + // message size = int.max. + public static int MaxContentSize(int channelId) + { + // calculate the max possible size that can fit in a batch + int transportMax = Transport.active.GetMaxPacketSize(channelId); + return transportMax - IdSize - Batcher.MaxMessageOverhead(transportMax); + } + + // max message size which includes header + content. + public static int MaxMessageSize(int channelId) => + MaxContentSize(channelId) + IdSize; + + // automated message id from type hash. + // platform independent via stable hashcode. + // => convenient so we don't need to track messageIds across projects + // => addons can work with each other without knowing their ids before + // => 2 bytes is enough to avoid collisions. + // registering a messageId twice will log a warning anyway. + // keep this for convenience. easier to use than NetworkMessageId.Id. + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static ushort GetId() where T : struct, NetworkMessage => + NetworkMessageId.Id; + + // pack message before sending + // -> NetworkWriter passed as arg so that we can use .ToArraySegment + // and do an allocation free send before recycling it. + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static void Pack(T message, NetworkWriter writer) + where T : struct, NetworkMessage + { + writer.WriteUShort(NetworkMessageId.Id); + writer.Write(message); + } + + // read only the message id. + // common function in case we ever change the header size. + public static bool UnpackId(NetworkReader reader, out ushort messageId) + { + // read message type + try + { + messageId = reader.ReadUShort(); + return true; + } + catch (System.IO.EndOfStreamException) + { + messageId = 0; + return false; + } + } + + // version for handlers with channelId + // inline! only exists for 20-30 messages and they call it all the time. + internal static NetworkMessageDelegate WrapHandler(Action handler, bool requireAuthentication, bool exceptionsDisconnect) + where T : struct, NetworkMessage + where C : NetworkConnection + => (conn, reader, channelId) => + { + // protect against DOS attacks if attackers try to send invalid + // data packets to crash the server/client. there are a thousand + // ways to cause an exception in data handling: + // - invalid headers + // - invalid message ids + // - invalid data causing exceptions + // - negative ReadBytesAndSize prefixes + // - invalid utf8 strings + // - etc. + // + // let's catch them all and then disconnect that connection to avoid + // further attacks. + T message = default; + // record start position for NetworkDiagnostics because reader might contain multiple messages if using batching + int startPos = reader.Position; + try + { + if (requireAuthentication && !conn.isAuthenticated) + { + // message requires authentication, but the connection was not authenticated + Debug.LogWarning($"Disconnecting connection: {conn}. Received message {typeof(T)} that required authentication, but the user has not authenticated yet"); + conn.Disconnect(); + return; + } + + //Debug.Log($"ConnectionRecv {conn} msgType:{typeof(T)} content:{BitConverter.ToString(reader.buffer.Array, reader.buffer.Offset, reader.buffer.Count)}"); + + // if it is a value type, just use default(T) + // otherwise allocate a new instance + message = reader.Read(); + } + catch (Exception exception) + { + // should we disconnect on exceptions? + if (exceptionsDisconnect) + { + Debug.LogError($"Disconnecting connection: {conn} because reading a message of type {typeof(T)} caused an Exception. This can happen if the other side accidentally (or an attacker intentionally) sent invalid data. Reason: {exception}"); + conn.Disconnect(); + return; + } + // otherwise log it but allow the connection to keep playing + else + { + Debug.LogError($"Caught an Exception when reading a message from: {conn} of type {typeof(T)}. Reason: {exception}"); + return; + } + } + finally + { + int endPos = reader.Position; + // TODO: Figure out the correct channel + NetworkDiagnostics.OnReceive(message, channelId, endPos - startPos); + } + + // user handler exception should not stop the whole server + try + { + // user implemented handler + handler((C)conn, message, channelId); + } + catch (Exception exception) + { + // should we disconnect on exceptions? + if (exceptionsDisconnect) + { + Debug.LogError($"Disconnecting connection: {conn} because handling a message of type {typeof(T)} caused an Exception. This can happen if the other side accidentally (or an attacker intentionally) sent invalid data. Reason: {exception}"); + conn.Disconnect(); + } + // otherwise log it but allow the connection to keep playing + else + { + Debug.LogError($"Caught an Exception when handling a message from: {conn} of type {typeof(T)}. Reason: {exception}"); + } + } + }; + + // version for handlers without channelId + // TODO obsolete this some day to always use the channelId version. + // all handlers in this version are wrapped with 1 extra action. + [MethodImpl(MethodImplOptions.AggressiveInlining)] + internal static NetworkMessageDelegate WrapHandler(Action handler, bool requireAuthentication, bool exceptionsDisconnect) + where T : struct, NetworkMessage + where C : NetworkConnection + { + // wrap action as channelId version, call original + void Wrapped(C conn, T msg, int _) => handler(conn, msg); + return WrapHandler((Action)Wrapped, requireAuthentication, exceptionsDisconnect); + } + } +} diff --git a/Assets/Mirror/Core/NetworkMessages.cs.meta b/Assets/Mirror/Core/NetworkMessages.cs.meta new file mode 100644 index 0000000..910b75c --- /dev/null +++ b/Assets/Mirror/Core/NetworkMessages.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 2db134099f0df4d96a84ae7a0cd9b4bc +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/NetworkReader.cs b/Assets/Mirror/Core/NetworkReader.cs new file mode 100644 index 0000000..82fb7cd --- /dev/null +++ b/Assets/Mirror/Core/NetworkReader.cs @@ -0,0 +1,249 @@ +using System; +using System.IO; +using System.Runtime.CompilerServices; +using System.Text; +using Unity.Collections.LowLevel.Unsafe; +using UnityEngine; + +namespace Mirror +{ + /// Network Reader for most simple types like floats, ints, buffers, structs, etc. Use NetworkReaderPool.GetReader() to avoid allocations. + // Note: This class is intended to be extremely pedantic, + // and throw exceptions whenever stuff is going slightly wrong. + // The exceptions will be handled in NetworkServer/NetworkClient. + // + // Note that NetworkWriter can be passed in constructor thanks to implicit + // ArraySegment conversion: + // NetworkReader reader = new NetworkReader(writer); + public class NetworkReader + { + // internal buffer + // byte[] pointer would work, but we use ArraySegment to also support + // the ArraySegment constructor + internal ArraySegment buffer; + + /// Next position to read from the buffer + // 'int' is the best type for .Position. 'short' is too small if we send >32kb which would result in negative .Position + // -> converting long to int is fine until 2GB of data (MAX_INT), so we don't have to worry about overflows here + public int Position; + + /// Remaining bytes that can be read, for convenience. + public int Remaining => buffer.Count - Position; + + /// Total buffer capacity, independent of reader position. + public int Capacity => buffer.Count; + + // cache encoding for ReadString instead of creating it with each time + // 1000 readers before: 1MB GC, 30ms + // 1000 readers after: 0.8MB GC, 18ms + // member(!) to avoid static state. + // + // throwOnInvalidBytes is true. + // if false, it would silently ignore the invalid bytes but continue + // with the valid ones, creating strings like "a�������". + // instead, we want to catch it manually and return String.Empty. + // this is safer. see test: ReadString_InvalidUTF8(). + internal readonly UTF8Encoding encoding = new UTF8Encoding(false, true); + + // while allocation free ReadArraySegment is encouraged, + // some functions can allocate a new byte[], List, Texture, etc. + // we should keep a reasonable allocation size limit: + // -> server won't accidentally allocate 2GB on a mobile device + // -> client won't allocate 2GB on server for ClientToServer [SyncVar]s + // -> unlike max string length of 64 KB, we need a larger limit here. + // large enough to not break existing projects, + // small enough to reasonably limit allocation attacks. + // -> we don't know the exact size of ReadList etc. because is + // managed. instead, this is considered a 'collection length' limit. + public const int AllocationLimit = 1024 * 1024 * 16; // 16 MB * sizeof(T) + + public NetworkReader(ArraySegment segment) + { + buffer = segment; + } + +#if !UNITY_2021_3_OR_NEWER + // Unity 2019 doesn't have the implicit byte[] to segment conversion yet + public NetworkReader(byte[] bytes) + { + buffer = new ArraySegment(bytes, 0, bytes.Length); + } +#endif + + // sometimes it's useful to point a reader on another buffer instead of + // allocating a new reader (e.g. NetworkReaderPool) + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void SetBuffer(ArraySegment segment) + { + buffer = segment; + Position = 0; + } + +#if !UNITY_2021_3_OR_NEWER + // Unity 2019 doesn't have the implicit byte[] to segment conversion yet + public void SetBuffer(byte[] bytes) + { + buffer = new ArraySegment(bytes, 0, bytes.Length); + Position = 0; + } +#endif + + // ReadBlittable from DOTSNET + // this is extremely fast, but only works for blittable types. + // => private to make sure nobody accidentally uses it for non-blittable + // + // Benchmark: see NetworkWriter.WriteBlittable! + // + // Note: + // ReadBlittable assumes same endianness for server & client. + // All Unity 2018+ platforms are little endian. + // + // This is not safe to expose to random structs. + // * StructLayout.Sequential is the default, which is safe. + // if the struct contains a reference type, it is converted to Auto. + // but since all structs here are unmanaged blittable, it's safe. + // see also: https://docs.microsoft.com/en-us/dotnet/api/system.runtime.interopservices.layoutkind?view=netframework-4.8#system-runtime-interopservices-layoutkind-sequential + // * StructLayout.Pack depends on CPU word size. + // this may be different 4 or 8 on some ARM systems, etc. + // this is not safe, and would cause bytes/shorts etc. to be padded. + // see also: https://docs.microsoft.com/en-us/dotnet/api/system.runtime.interopservices.structlayoutattribute.pack?view=net-6.0 + // * If we force pack all to '1', they would have no padding which is + // great for bandwidth. but on some android systems, CPU can't read + // unaligned memory. + // see also: https://github.com/vis2k/Mirror/issues/3044 + // * The only option would be to force explicit layout with multiples + // of word size. but this requires lots of weaver checking and is + // still questionable (IL2CPP etc.). + // + // Note: inlining ReadBlittable is enough. don't inline ReadInt etc. + // we don't want ReadBlittable to be copied in place everywhere. + internal unsafe T ReadBlittable() + where T : unmanaged + { + // check if blittable for safety +#if UNITY_EDITOR + if (!UnsafeUtility.IsBlittable(typeof(T))) + { + throw new ArgumentException($"{typeof(T)} is not blittable!"); + } +#endif + + // calculate size + // sizeof(T) gets the managed size at compile time. + // Marshal.SizeOf gets the unmanaged size at runtime (slow). + // => our 1mio writes benchmark is 6x slower with Marshal.SizeOf + // => for blittable types, sizeof(T) is even recommended: + // https://docs.microsoft.com/en-us/dotnet/standard/native-interop/best-practices + int size = sizeof(T); + + // ensure remaining + if (Remaining < size) + { + throw new EndOfStreamException($"ReadBlittable<{typeof(T)}> not enough data in buffer to read {size} bytes: {ToString()}"); + } + + // read blittable + T value; + fixed (byte* ptr = &buffer.Array[buffer.Offset + Position]) + { +#if UNITY_ANDROID + // on some android systems, reading *(T*)ptr throws a NRE if + // the ptr isn't aligned (i.e. if Position is 1,2,3,5, etc.). + // here we have to use memcpy. + // + // => we can't get a pointer of a struct in C# without + // marshalling allocations + // => instead, we stack allocate an array of type T and use that + // => stackalloc avoids GC and is very fast. it only works for + // value types, but all blittable types are anyway. + // + // this way, we can still support blittable reads on android. + // see also: https://github.com/vis2k/Mirror/issues/3044 + // (solution discovered by AIIO, FakeByte, mischa) + T* valueBuffer = stackalloc T[1]; + UnsafeUtility.MemCpy(valueBuffer, ptr, size); + value = valueBuffer[0]; +#else + // cast buffer to a T* pointer and then read from it. + value = *(T*)ptr; +#endif + } + Position += size; + return value; + } + + // blittable'?' template for code reuse + // note: bool isn't blittable. need to read as byte. + [MethodImpl(MethodImplOptions.AggressiveInlining)] + internal T? ReadBlittableNullable() + where T : unmanaged => + ReadByte() != 0 ? ReadBlittable() : default(T?); + + public byte ReadByte() => ReadBlittable(); + + /// Read 'count' bytes into the bytes array + // NOTE: returns byte[] because all reader functions return something. + public byte[] ReadBytes(byte[] bytes, int count) + { + // user may call ReadBytes(ReadInt()). ensure positive count. + if (count < 0) throw new ArgumentOutOfRangeException("ReadBytes requires count >= 0"); + + // check if passed byte array is big enough + if (count > bytes.Length) + { + throw new EndOfStreamException($"ReadBytes can't read {count} + bytes because the passed byte[] only has length {bytes.Length}"); + } + // ensure remaining + if (Remaining < count) + { + throw new EndOfStreamException($"ReadBytesSegment can't read {count} bytes because it would read past the end of the stream. {ToString()}"); + } + + Array.Copy(buffer.Array, buffer.Offset + Position, bytes, 0, count); + Position += count; + return bytes; + } + + /// Read 'count' bytes allocation-free as ArraySegment that points to the internal array. + public ArraySegment ReadBytesSegment(int count) + { + // user may call ReadBytes(ReadInt()). ensure positive count. + if (count < 0) throw new ArgumentOutOfRangeException("ReadBytesSegment requires count >= 0"); + + // ensure remaining + if (Remaining < count) + { + throw new EndOfStreamException($"ReadBytesSegment can't read {count} bytes because it would read past the end of the stream. {ToString()}"); + } + + // return the segment + ArraySegment result = new ArraySegment(buffer.Array, buffer.Offset + Position, count); + Position += count; + return result; + } + + /// Reads any data type that mirror supports. Uses weaver populated Reader(T).read + public T Read() + { + Func readerDelegate = Reader.read; + if (readerDelegate == null) + { + Debug.LogError($"No reader found for {typeof(T)}. Use a type supported by Mirror or define a custom reader extension for {typeof(T)}."); + return default; + } + return readerDelegate(this); + } + + // print the full buffer with position / capacity. + public override string ToString() => + $"[{buffer.ToHexString()} @ {Position}/{Capacity}]"; + } + + /// Helper class that weaver populates with all reader types. + // Note that c# creates a different static variable for each type + // -> Weaver.ReaderWriterProcessor.InitializeReaderAndWriters() populates it + public static class Reader + { + public static Func read; + } +} diff --git a/Assets/Mirror/Core/NetworkReader.cs.meta b/Assets/Mirror/Core/NetworkReader.cs.meta new file mode 100644 index 0000000..65ad3f0 --- /dev/null +++ b/Assets/Mirror/Core/NetworkReader.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 1610f05ec5bd14d6882e689f7372596a +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/NetworkReaderExtensions.cs b/Assets/Mirror/Core/NetworkReaderExtensions.cs new file mode 100644 index 0000000..4493be3 --- /dev/null +++ b/Assets/Mirror/Core/NetworkReaderExtensions.cs @@ -0,0 +1,388 @@ +using System; +using System.Collections.Generic; +using System.IO; +using UnityEngine; + +namespace Mirror +{ + // Mirror's Weaver automatically detects all NetworkReader function types, + // but they do all need to be extensions. + public static class NetworkReaderExtensions + { + public static byte ReadByte(this NetworkReader reader) => reader.ReadBlittable(); + public static byte? ReadByteNullable(this NetworkReader reader) => reader.ReadBlittableNullable(); + + public static sbyte ReadSByte(this NetworkReader reader) => reader.ReadBlittable(); + public static sbyte? ReadSByteNullable(this NetworkReader reader) => reader.ReadBlittableNullable(); + + // bool is not blittable. read as ushort. + public static char ReadChar(this NetworkReader reader) => (char)reader.ReadBlittable(); + public static char? ReadCharNullable(this NetworkReader reader) => (char?)reader.ReadBlittableNullable(); + + // bool is not blittable. read as byte. + public static bool ReadBool(this NetworkReader reader) => reader.ReadBlittable() != 0; + public static bool? ReadBoolNullable(this NetworkReader reader) + { + byte? value = reader.ReadBlittableNullable(); + return value.HasValue ? (value.Value != 0) : default(bool?); + } + + public static short ReadShort(this NetworkReader reader) => (short)reader.ReadUShort(); + public static short? ReadShortNullable(this NetworkReader reader) => reader.ReadBlittableNullable(); + + public static ushort ReadUShort(this NetworkReader reader) => reader.ReadBlittable(); + public static ushort? ReadUShortNullable(this NetworkReader reader) => reader.ReadBlittableNullable(); + + public static int ReadInt(this NetworkReader reader) => reader.ReadBlittable(); + public static int? ReadIntNullable(this NetworkReader reader) => reader.ReadBlittableNullable(); + + public static uint ReadUInt(this NetworkReader reader) => reader.ReadBlittable(); + public static uint? ReadUIntNullable(this NetworkReader reader) => reader.ReadBlittableNullable(); + + public static long ReadLong(this NetworkReader reader) => reader.ReadBlittable(); + public static long? ReadLongNullable(this NetworkReader reader) => reader.ReadBlittableNullable(); + + public static ulong ReadULong(this NetworkReader reader) => reader.ReadBlittable(); + public static ulong? ReadULongNullable(this NetworkReader reader) => reader.ReadBlittableNullable(); + + public static float ReadFloat(this NetworkReader reader) => reader.ReadBlittable(); + public static float? ReadFloatNullable(this NetworkReader reader) => reader.ReadBlittableNullable(); + + public static double ReadDouble(this NetworkReader reader) => reader.ReadBlittable(); + public static double? ReadDoubleNullable(this NetworkReader reader) => reader.ReadBlittableNullable(); + + public static decimal ReadDecimal(this NetworkReader reader) => reader.ReadBlittable(); + public static decimal? ReadDecimalNullable(this NetworkReader reader) => reader.ReadBlittableNullable(); + + /// if an invalid utf8 string is sent + public static string ReadString(this NetworkReader reader) + { + // read number of bytes + ushort size = reader.ReadUShort(); + + // null support, see NetworkWriter + if (size == 0) + return null; + + ushort realSize = (ushort)(size - 1); + + // make sure it's within limits to avoid allocation attacks etc. + if (realSize > NetworkWriter.MaxStringLength) + throw new EndOfStreamException($"NetworkReader.ReadString - Value too long: {realSize} bytes. Limit is: {NetworkWriter.MaxStringLength} bytes"); + + ArraySegment data = reader.ReadBytesSegment(realSize); + + // convert directly from buffer to string via encoding + // throws in case of invalid utf8. + // see test: ReadString_InvalidUTF8() + return reader.encoding.GetString(data.Array, data.Offset, data.Count); + } + + public static byte[] ReadBytes(this NetworkReader reader, int count) + { + // prevent allocation attacks with a reasonable limit. + // server shouldn't allocate too much on client devices. + // client shouldn't allocate too much on server in ClientToServer [SyncVar]s. + if (count > NetworkReader.AllocationLimit) + { + // throw EndOfStream for consistency with ReadBlittable when out of data + throw new EndOfStreamException($"NetworkReader attempted to allocate {count} bytes, which is larger than the allowed limit of {NetworkReader.AllocationLimit} bytes."); + } + + byte[] bytes = new byte[count]; + reader.ReadBytes(bytes, count); + return bytes; + } + + /// if count is invalid + public static byte[] ReadBytesAndSize(this NetworkReader reader) + { + // count = 0 means the array was null + // otherwise count -1 is the length of the array + uint count = reader.ReadUInt(); + // Use checked() to force it to throw OverflowException if data is invalid + return count == 0 ? null : reader.ReadBytes(checked((int)(count - 1u))); + } + // Reads ArraySegment and size header + /// if count is invalid + public static ArraySegment ReadArraySegmentAndSize(this NetworkReader reader) + { + // count = 0 means the array was null + // otherwise count - 1 is the length of the array + uint count = reader.ReadUInt(); + // Use checked() to force it to throw OverflowException if data is invalid + return count == 0 ? default : reader.ReadBytesSegment(checked((int)(count - 1u))); + } + + public static Vector2 ReadVector2(this NetworkReader reader) => reader.ReadBlittable(); + public static Vector2? ReadVector2Nullable(this NetworkReader reader) => reader.ReadBlittableNullable(); + + public static Vector3 ReadVector3(this NetworkReader reader) => reader.ReadBlittable(); + public static Vector3? ReadVector3Nullable(this NetworkReader reader) => reader.ReadBlittableNullable(); + + public static Vector4 ReadVector4(this NetworkReader reader) => reader.ReadBlittable(); + public static Vector4? ReadVector4Nullable(this NetworkReader reader) => reader.ReadBlittableNullable(); + + public static Vector2Int ReadVector2Int(this NetworkReader reader) => reader.ReadBlittable(); + public static Vector2Int? ReadVector2IntNullable(this NetworkReader reader) => reader.ReadBlittableNullable(); + + public static Vector3Int ReadVector3Int(this NetworkReader reader) => reader.ReadBlittable(); + public static Vector3Int? ReadVector3IntNullable(this NetworkReader reader) => reader.ReadBlittableNullable(); + + public static Color ReadColor(this NetworkReader reader) => reader.ReadBlittable(); + public static Color? ReadColorNullable(this NetworkReader reader) => reader.ReadBlittableNullable(); + + public static Color32 ReadColor32(this NetworkReader reader) => reader.ReadBlittable(); + public static Color32? ReadColor32Nullable(this NetworkReader reader) => reader.ReadBlittableNullable(); + + public static Quaternion ReadQuaternion(this NetworkReader reader) => reader.ReadBlittable(); + public static Quaternion? ReadQuaternionNullable(this NetworkReader reader) => reader.ReadBlittableNullable(); + + // Rect is a struct with properties instead of fields + public static Rect ReadRect(this NetworkReader reader) => new Rect(reader.ReadVector2(), reader.ReadVector2()); + public static Rect? ReadRectNullable(this NetworkReader reader) => reader.ReadBool() ? ReadRect(reader) : default(Rect?); + + // Plane is a struct with properties instead of fields + public static Plane ReadPlane(this NetworkReader reader) => new Plane(reader.ReadVector3(), reader.ReadFloat()); + public static Plane? ReadPlaneNullable(this NetworkReader reader) => reader.ReadBool() ? ReadPlane(reader) : default(Plane?); + + // Ray is a struct with properties instead of fields + public static Ray ReadRay(this NetworkReader reader) => new Ray(reader.ReadVector3(), reader.ReadVector3()); + public static Ray? ReadRayNullable(this NetworkReader reader) => reader.ReadBool() ? ReadRay(reader) : default(Ray?); + + // LayerMask is a struct with properties instead of fields + public static LayerMask ReadLayerMask(this NetworkReader reader) + { + // LayerMask doesn't have a constructor that takes an initial value. + // 32 layers as a flags enum, max value of 496, we only need a UShort. + LayerMask layerMask = default; + layerMask.value = reader.ReadUShort(); + return layerMask; + } + + public static LayerMask? ReadLayerMaskNullable(this NetworkReader reader) => reader.ReadBool() ? ReadLayerMask(reader) : default(LayerMask?); + + public static Matrix4x4 ReadMatrix4x4(this NetworkReader reader) => reader.ReadBlittable(); + public static Matrix4x4? ReadMatrix4x4Nullable(this NetworkReader reader) => reader.ReadBlittableNullable(); + + public static Guid ReadGuid(this NetworkReader reader) + { +#if !UNITY_2021_3_OR_NEWER + // Unity 2019 doesn't have Span yet + return new Guid(reader.ReadBytes(16)); +#else + // ReadBlittable(Guid) isn't safe. see ReadBlittable comments. + // Guid is Sequential, but we can't guarantee packing. + if (reader.Remaining >= 16) + { + ReadOnlySpan span = new ReadOnlySpan(reader.buffer.Array, reader.buffer.Offset + reader.Position, 16); + reader.Position += 16; + return new Guid(span); + } + throw new EndOfStreamException($"ReadGuid out of range: {reader}"); +#endif + } + public static Guid? ReadGuidNullable(this NetworkReader reader) => reader.ReadBool() ? ReadGuid(reader) : default(Guid?); + + public static NetworkIdentity ReadNetworkIdentity(this NetworkReader reader) + { + uint netId = reader.ReadUInt(); + if (netId == 0) + return null; + + // NOTE: a netId not being in spawned is common. + // for example, "[SyncVar] NetworkIdentity target" netId would not + // be known on client if the monster walks out of proximity for a + // moment. no need to log any error or warning here. + return Utils.GetSpawnedInServerOrClient(netId); + } + + public static NetworkBehaviour ReadNetworkBehaviour(this NetworkReader reader) + { + // read netId first. + // + // IMPORTANT: if netId != 0, writer always writes componentIndex. + // reusing ReadNetworkIdentity() might return a null NetworkIdentity + // even if netId was != 0 but the identity disappeared on the client, + // resulting in unequal amounts of data being written / read. + // https://github.com/vis2k/Mirror/issues/2972 + uint netId = reader.ReadUInt(); + if (netId == 0) + return null; + + // read component index in any case, BEFORE searching the spawned + // NetworkIdentity by netId. + byte componentIndex = reader.ReadByte(); + + // NOTE: a netId not being in spawned is common. + // for example, "[SyncVar] NetworkIdentity target" netId would not + // be known on client if the monster walks out of proximity for a + // moment. no need to log any error or warning here. + NetworkIdentity identity = Utils.GetSpawnedInServerOrClient(netId); + + return identity != null + ? identity.NetworkBehaviours[componentIndex] + : null; + } + + public static T ReadNetworkBehaviour(this NetworkReader reader) where T : NetworkBehaviour + { + return reader.ReadNetworkBehaviour() as T; + } + + public static NetworkBehaviourSyncVar ReadNetworkBehaviourSyncVar(this NetworkReader reader) + { + uint netId = reader.ReadUInt(); + byte componentIndex = default; + + // if netId is not 0, then index is also sent to read before returning + if (netId != 0) + { + componentIndex = reader.ReadByte(); + } + + return new NetworkBehaviourSyncVar(netId, componentIndex); + } + + public static Transform ReadTransform(this NetworkReader reader) + { + // Don't use null propagation here as it could lead to MissingReferenceException + NetworkIdentity networkIdentity = reader.ReadNetworkIdentity(); + return networkIdentity != null ? networkIdentity.transform : null; + } + + public static GameObject ReadGameObject(this NetworkReader reader) + { + // Don't use null propagation here as it could lead to MissingReferenceException + NetworkIdentity networkIdentity = reader.ReadNetworkIdentity(); + return networkIdentity != null ? networkIdentity.gameObject : null; + } + + // while SyncList is recommended for NetworkBehaviours, + // structs may have .List members which weaver needs to be able to + // fully serialize for NetworkMessages etc. + // note that Weaver/Readers/GenerateReader() handles this manually. + public static List ReadList(this NetworkReader reader) + { + int length = reader.ReadInt(); + + // 'null' is encoded as '-1' + if (length < 0) return null; + + // prevent allocation attacks with a reasonable limit. + // server shouldn't allocate too much on client devices. + // client shouldn't allocate too much on server in ClientToServer [SyncVar]s. + if (length > NetworkReader.AllocationLimit) + { + // throw EndOfStream for consistency with ReadBlittable when out of data + throw new EndOfStreamException($"NetworkReader attempted to allocate a List<{typeof(T)}> {length} elements, which is larger than the allowed limit of {NetworkReader.AllocationLimit}."); + } + + List result = new List(length); + for (int i = 0; i < length; i++) + { + result.Add(reader.Read()); + } + return result; + } + + // while SyncSet is recommended for NetworkBehaviours, + // structs may have .Set members which weaver needs to be able to + // fully serialize for NetworkMessages etc. + // note that Weaver/Readers/GenerateReader() handles this manually. + // TODO writer not found. need to adjust weaver first. see tests. + /* + public static HashSet ReadHashSet(this NetworkReader reader) + { + int length = reader.ReadInt(); + if (length < 0) + return null; + HashSet result = new HashSet(); + for (int i = 0; i < length; i++) + { + result.Add(reader.Read()); + } + return result; + } + */ + + public static T[] ReadArray(this NetworkReader reader) + { + int length = reader.ReadInt(); + + // 'null' is encoded as '-1' + if (length < 0) return null; + + // prevent allocation attacks with a reasonable limit. + // server shouldn't allocate too much on client devices. + // client shouldn't allocate too much on server in ClientToServer [SyncVar]s. + if (length > NetworkReader.AllocationLimit) + { + // throw EndOfStream for consistency with ReadBlittable when out of data + throw new EndOfStreamException($"NetworkReader attempted to allocate an Array<{typeof(T)}> with {length} elements, which is larger than the allowed limit of {NetworkReader.AllocationLimit}."); + } + + // we can't check if reader.Remaining < length, + // because we don't know sizeof(T) since it's a managed type. + // if (length > reader.Remaining) throw new EndOfStreamException($"Received array that is too large: {length}"); + + T[] result = new T[length]; + for (int i = 0; i < length; i++) + { + result[i] = reader.Read(); + } + return result; + } + + public static Uri ReadUri(this NetworkReader reader) + { + string uriString = reader.ReadString(); + return (string.IsNullOrWhiteSpace(uriString) ? null : new Uri(uriString)); + } + + public static Texture2D ReadTexture2D(this NetworkReader reader) + { + // support 'null' textures for [SyncVar]s etc. + // https://github.com/vis2k/Mirror/issues/3144 + short width = reader.ReadShort(); + if (width == -1) return null; + + // read height + short height = reader.ReadShort(); + + // prevent allocation attacks with a reasonable limit. + // server shouldn't allocate too much on client devices. + // client shouldn't allocate too much on server in ClientToServer [SyncVar]s. + // log an error and return default. + // we don't want attackers to be able to trigger exceptions. + int totalSize = width * height; + if (totalSize > NetworkReader.AllocationLimit) + { + Debug.LogWarning($"NetworkReader attempted to allocate a Texture2D with total size (width * height) of {totalSize}, which is larger than the allowed limit of {NetworkReader.AllocationLimit}."); + return null; + } + + Texture2D texture2D = new Texture2D(width, height); + + // read pixel content + Color32[] pixels = reader.ReadArray(); + texture2D.SetPixels32(pixels); + texture2D.Apply(); + return texture2D; + } + + public static Sprite ReadSprite(this NetworkReader reader) + { + // support 'null' textures for [SyncVar]s etc. + // https://github.com/vis2k/Mirror/issues/3144 + Texture2D texture = reader.ReadTexture2D(); + if (texture == null) return null; + + // otherwise create a valid sprite + return Sprite.Create(texture, reader.ReadRect(), reader.ReadVector2()); + } + + public static DateTime ReadDateTime(this NetworkReader reader) => DateTime.FromOADate(reader.ReadDouble()); + public static DateTime? ReadDateTimeNullable(this NetworkReader reader) => reader.ReadBool() ? ReadDateTime(reader) : default(DateTime?); + } +} diff --git a/Assets/Mirror/Core/NetworkReaderExtensions.cs.meta b/Assets/Mirror/Core/NetworkReaderExtensions.cs.meta new file mode 100644 index 0000000..66536c9 --- /dev/null +++ b/Assets/Mirror/Core/NetworkReaderExtensions.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 364a9f7ccd5541e19aa2ae0b81f0b3cf +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/NetworkReaderPool.cs b/Assets/Mirror/Core/NetworkReaderPool.cs new file mode 100644 index 0000000..d50258a --- /dev/null +++ b/Assets/Mirror/Core/NetworkReaderPool.cs @@ -0,0 +1,45 @@ +// API consistent with Microsoft's ObjectPool. +using System; +using System.Runtime.CompilerServices; + +namespace Mirror +{ + /// Pool of NetworkReaders to avoid allocations. + public static class NetworkReaderPool + { + // reuse Pool + // we still wrap it in NetworkReaderPool.Get/Recyle so we can reset the + // position and array before reusing. + static readonly Pool Pool = new Pool( + // byte[] will be assigned in GetReader + () => new NetworkReaderPooled(new byte[]{}), + // initial capacity to avoid allocations in the first few frames + 1000 + ); + + /// Get the next reader in the pool. If pool is empty, creates a new Reader + public static NetworkReaderPooled Get(byte[] bytes) + { + // grab from pool & set buffer + NetworkReaderPooled reader = Pool.Get(); + reader.SetBuffer(bytes); + return reader; + } + + /// Get the next reader in the pool. If pool is empty, creates a new Reader + public static NetworkReaderPooled Get(ArraySegment segment) + { + // grab from pool & set buffer + NetworkReaderPooled reader = Pool.Get(); + reader.SetBuffer(segment); + return reader; + } + + /// Returns a reader to the pool. + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static void Return(NetworkReaderPooled reader) + { + Pool.Return(reader); + } + } +} diff --git a/Assets/Mirror/Core/NetworkReaderPool.cs.meta b/Assets/Mirror/Core/NetworkReaderPool.cs.meta new file mode 100644 index 0000000..2c94768 --- /dev/null +++ b/Assets/Mirror/Core/NetworkReaderPool.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 2bacff63613ad634a98f9e4d15d29dbf +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/NetworkReaderPooled.cs b/Assets/Mirror/Core/NetworkReaderPooled.cs new file mode 100644 index 0000000..5348904 --- /dev/null +++ b/Assets/Mirror/Core/NetworkReaderPooled.cs @@ -0,0 +1,15 @@ +// "NetworkReaderPooled" instead of "PooledNetworkReader" to group files, for +// easier IDE workflow and more elegant code. +using System; + +namespace Mirror +{ + /// Pooled NetworkReader, automatically returned to pool when using 'using' + // TODO make sealed again after removing obsolete NetworkReaderPooled! + public class NetworkReaderPooled : NetworkReader, IDisposable + { + internal NetworkReaderPooled(byte[] bytes) : base(bytes) {} + internal NetworkReaderPooled(ArraySegment segment) : base(segment) {} + public void Dispose() => NetworkReaderPool.Return(this); + } +} diff --git a/Assets/Mirror/Core/NetworkReaderPooled.cs.meta b/Assets/Mirror/Core/NetworkReaderPooled.cs.meta new file mode 100644 index 0000000..4eb6e9d --- /dev/null +++ b/Assets/Mirror/Core/NetworkReaderPooled.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: faafa97c32e44adf8e8888de817a370a +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/NetworkServer.cs b/Assets/Mirror/Core/NetworkServer.cs new file mode 100644 index 0000000..f8d889e --- /dev/null +++ b/Assets/Mirror/Core/NetworkServer.cs @@ -0,0 +1,1981 @@ +using System; +using System.Collections.Generic; +using System.Linq; +using Mirror.RemoteCalls; +using UnityEngine; + +namespace Mirror +{ + /// NetworkServer handles remote connections and has a local connection for a local client. + public static partial class NetworkServer + { + static bool initialized; + public static int maxConnections; + + /// Server Update frequency, per second. Use around 60Hz for fast paced games like Counter-Strike to minimize latency. Use around 30Hz for games like WoW to minimize computations. Use around 1-10Hz for slow paced games like EVE. + // overwritten by NetworkManager (if any) + public static int tickRate = 60; + + // tick rate is in Hz. + // convert to interval in seconds for convenience where needed. + // + // send interval is 1 / sendRate. + // but for tests we need a way to set it to exactly 0. + // 1 / int.max would not be exactly 0, so handel that manually. + public static float tickInterval => tickRate < int.MaxValue ? 1f / tickRate : 0; // for 30 Hz, that's 33ms + + // time & value snapshot interpolation are separate. + // -> time is interpolated globally on NetworkClient / NetworkConnection + // -> value is interpolated per-component, i.e. NetworkTransform. + // however, both need to be on the same send interval. + public static int sendRate => tickRate; + public static float sendInterval => sendRate < int.MaxValue ? 1f / sendRate : 0; // for 30 Hz, that's 33ms + static double lastSendTime; + + /// Connection to host mode client (if any) + public static LocalConnectionToClient localConnection { get; private set; } + + /// Dictionary of all server connections, with connectionId as key + public static Dictionary connections = + new Dictionary(); + + /// Message Handlers dictionary, with messageId as key + internal static Dictionary handlers = + new Dictionary(); + + /// All spawned NetworkIdentities by netId. + // server sees ALL spawned ones. + public static readonly Dictionary spawned = + new Dictionary(); + + /// Single player mode can use dontListen to not accept incoming connections + // see also: https://github.com/vis2k/Mirror/pull/2595 + public static bool dontListen; + + /// active checks if the server has been started either has standalone or as host server. + public static bool active { get; internal set; } + + /// active checks if the server has been started in host mode. + // naming consistent with NetworkClient.activeHost. + public static bool activeHost => localConnection != null; + + // scene loading + public static bool isLoadingScene; + + // interest management component (optional) + // by default, everyone observes everyone + public static InterestManagementBase aoi; + + // For security, it is recommended to disconnect a player if a networked + // action triggers an exception\nThis could prevent components being + // accessed in an undefined state, which may be an attack vector for + // exploits. + // + // However, some games may want to allow exceptions in order to not + // interrupt the player's experience. + public static bool exceptionsDisconnect = true; // security by default + + // Mirror global disconnect inactive option, independent of Transport. + // not all Transports do this properly, and it's easiest to configure this just once. + // this is very useful for some projects, keep it. + public static bool disconnectInactiveConnections; + public static float disconnectInactiveTimeout = 60; + + // OnConnected / OnDisconnected used to be NetworkMessages that were + // invoked. this introduced a bug where external clients could send + // Connected/Disconnected messages over the network causing undefined + // behaviour. + // => public so that custom NetworkManagers can hook into it + public static Action OnConnectedEvent; + public static Action OnDisconnectedEvent; + public static Action OnErrorEvent; + + // keep track of actual achieved tick rate. + // might become lower under heavy load. + // very useful for profiling etc. + // measured over 1s each, same as frame rate. no EMA here. + public static int actualTickRate; + static double actualTickRateStart; // start time when counting + static int actualTickRateCounter; // current counter since start + + // profiling + // includes transport update time, because transport calls handlers etc. + // averaged over 1s by passing 'tickRate' to constructor. + public static TimeSample earlyUpdateDuration; + public static TimeSample lateUpdateDuration; + + // capture full Unity update time from before Early- to after LateUpdate + public static TimeSample fullUpdateDuration; + + /// Starts server and listens to incoming connections with max connections limit. + public static void Listen(int maxConns) + { + Initialize(); + maxConnections = maxConns; + + // only start server if we want to listen + if (!dontListen) + { + Transport.active.ServerStart(); + + if (Transport.active is PortTransport portTransport) + { + if (Utils.IsHeadless()) + { +#if !UNITY_EDITOR + Console.ForegroundColor = ConsoleColor.Green; + Console.WriteLine($"Server listening on port {portTransport.Port}"); + Console.ResetColor(); +#else + Debug.Log($"Server listening on port {portTransport.Port}"); +#endif + } + } + else + Debug.Log("Server started listening"); + } + + active = true; + RegisterMessageHandlers(); + } + + // initialization / shutdown /////////////////////////////////////////// + static void Initialize() + { + if (initialized) + return; + + // safety: ensure Weaving succeded. + // if it silently failed, we would get lots of 'writer not found' + // and other random errors at runtime instead. this is cleaner. + if (!WeaverFuse.Weaved()) + { + // if it failed, throw an exception to early exit all Listen calls. + throw new Exception("NetworkServer won't start because Weaving failed or didn't run."); + } + + // Debug.Log($"NetworkServer Created version {Version.Current}"); + + //Make sure connections are cleared in case any old connections references exist from previous sessions + connections.Clear(); + + // reset Interest Management so that rebuild intervals + // start at 0 when starting again. + if (aoi != null) aoi.ResetState(); + + // reset NetworkTime + NetworkTime.ResetStatics(); + + Debug.Assert(Transport.active != null, "There was no active transport when calling NetworkServer.Listen, If you are calling Listen manually then make sure to set 'Transport.active' first"); + AddTransportHandlers(); + + initialized = true; + + // profiling + earlyUpdateDuration = new TimeSample(sendRate); + lateUpdateDuration = new TimeSample(sendRate); + fullUpdateDuration = new TimeSample(sendRate); + } + + static void AddTransportHandlers() + { + // += so that other systems can also hook into it (i.e. statistics) + Transport.active.OnServerConnected += OnTransportConnected; + Transport.active.OnServerDataReceived += OnTransportData; + Transport.active.OnServerDisconnected += OnTransportDisconnected; + Transport.active.OnServerError += OnTransportError; + } + + /// Shuts down the server and disconnects all clients + // RuntimeInitializeOnLoadMethod -> fast playmode without domain reload + [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)] + public static void Shutdown() + { + if (initialized) + { + DisconnectAll(); + + // stop the server. + // we do NOT call Transport.Shutdown, because someone only + // called NetworkServer.Shutdown. we can't assume that the + // client is supposed to be shut down too! + // + // NOTE: stop no matter what, even if 'dontListen': + // someone might enabled dontListen at runtime. + // but we still need to stop the server. + // fixes https://github.com/vis2k/Mirror/issues/2536 + Transport.active.ServerStop(); + + // transport handlers are hooked into when initializing. + // so only remove them when shutting down. + RemoveTransportHandlers(); + + initialized = false; + } + + // Reset all statics here.... + dontListen = false; + isLoadingScene = false; + lastSendTime = 0; + actualTickRate = 0; + + localConnection = null; + + connections.Clear(); + connectionsCopy.Clear(); + handlers.Clear(); + + // destroy all spawned objects, _then_ set inactive. + // make sure .active is still true before calling this. + // otherwise modifying SyncLists in OnStopServer would throw + // because .IsWritable() check checks if NetworkServer.active. + // https://github.com/MirrorNetworking/Mirror/issues/3344 + CleanupSpawned(); + active = false; + + // sets nextNetworkId to 1 + // sets clientAuthorityCallback to null + // sets previousLocalPlayer to null + NetworkIdentity.ResetStatics(); + + // clear events. someone might have hooked into them before, but + // we don't want to use those hooks after Shutdown anymore. + OnConnectedEvent = null; + OnDisconnectedEvent = null; + OnErrorEvent = null; + + if (aoi != null) aoi.ResetState(); + } + + static void RemoveTransportHandlers() + { + // -= so that other systems can also hook into it (i.e. statistics) + Transport.active.OnServerConnected -= OnTransportConnected; + Transport.active.OnServerDataReceived -= OnTransportData; + Transport.active.OnServerDisconnected -= OnTransportDisconnected; + Transport.active.OnServerError -= OnTransportError; + } + + // Note: NetworkClient.DestroyAllClientObjects does the same on client. + static void CleanupSpawned() + { + // iterate a COPY of spawned. + // DestroyObject removes them from the original collection. + // removing while iterating is not allowed. + foreach (NetworkIdentity identity in spawned.Values.ToList()) + { + if (identity != null) + { + // NetworkServer.Destroy resets if scene object, destroys if prefab. + Destroy(identity.gameObject); + } + } + + spawned.Clear(); + } + + internal static void RegisterMessageHandlers() + { + RegisterHandler(OnClientReadyMessage); + RegisterHandler(OnCommandMessage); + RegisterHandler(NetworkTime.OnServerPing, false); + RegisterHandler(NetworkTime.OnServerPong, false); + RegisterHandler(OnEntityStateMessage, true); + RegisterHandler(OnTimeSnapshotMessage, true); + } + + // remote calls //////////////////////////////////////////////////////// + // Handle command from specific player, this could be one of multiple + // players on a single client + // default ready handler. + static void OnClientReadyMessage(NetworkConnectionToClient conn, ReadyMessage msg) + { + // Debug.Log($"Default handler for ready message from {conn}"); + SetClientReady(conn); + } + + static void OnCommandMessage(NetworkConnectionToClient conn, CommandMessage msg, int channelId) + { + if (!conn.isReady) + { + // Clients may be set NotReady due to scene change or other game logic by user, e.g. respawning. + // Ignore commands that may have been in flight before client received NotReadyMessage message. + // Unreliable messages may be out of order, so don't spam warnings for those. + if (channelId == Channels.Reliable) + { + // Attempt to identify the target object, component, and method to narrow down the cause of the error. + if (spawned.TryGetValue(msg.netId, out NetworkIdentity netIdentity)) + if (msg.componentIndex < netIdentity.NetworkBehaviours.Length && netIdentity.NetworkBehaviours[msg.componentIndex] is NetworkBehaviour component) + if (RemoteProcedureCalls.GetFunctionMethodName(msg.functionHash, out string methodName)) + { + Debug.LogWarning($"Command {methodName} received for {netIdentity.name} [netId={msg.netId}] component {component.name} [index={msg.componentIndex}] when client not ready.\nThis may be ignored if client intentionally set NotReady."); + return; + } + + Debug.LogWarning("Command received while client is not ready.\nThis may be ignored if client intentionally set NotReady."); + } + return; + } + + if (!spawned.TryGetValue(msg.netId, out NetworkIdentity identity)) + { + // over reliable channel, commands should always come after spawn. + // over unreliable, they might come in before the object was spawned. + // for example, NetworkTransform. + // let's not spam the console for unreliable out of order messages. + if (channelId == Channels.Reliable) + Debug.LogWarning($"Spawned object not found when handling Command message {identity.name} netId={msg.netId}"); + return; + } + + // Commands can be for player objects, OR other objects with client-authority + // -> so if this connection's controller has a different netId then + // only allow the command if clientAuthorityOwner + bool requiresAuthority = RemoteProcedureCalls.CommandRequiresAuthority(msg.functionHash); + if (requiresAuthority && identity.connectionToClient != conn) + { + // Attempt to identify the component and method to narrow down the cause of the error. + if (msg.componentIndex < identity.NetworkBehaviours.Length && identity.NetworkBehaviours[msg.componentIndex] is NetworkBehaviour component) + if (RemoteProcedureCalls.GetFunctionMethodName(msg.functionHash, out string methodName)) + { + Debug.LogWarning($"Command {methodName} received for {identity.name} [netId={msg.netId}] component {component.name} [index={msg.componentIndex}] without authority"); + return; + } + + Debug.LogWarning($"Command received for {identity.name} [netId={msg.netId}] without authority"); + return; + } + + // Debug.Log($"OnCommandMessage for netId:{msg.netId} conn:{conn}"); + + using (NetworkReaderPooled networkReader = NetworkReaderPool.Get(msg.payload)) + identity.HandleRemoteCall(msg.componentIndex, msg.functionHash, RemoteCallType.Command, networkReader, conn); + } + + // client to server broadcast ////////////////////////////////////////// + // for client's owned ClientToServer components. + static void OnEntityStateMessage(NetworkConnectionToClient connection, EntityStateMessage message) + { + // need to validate permissions carefully. + // an attacker may attempt to modify a not-owned or not-ClientToServer component. + + // valid netId? + if (spawned.TryGetValue(message.netId, out NetworkIdentity identity) && identity != null) + { + // owned by the connection? + if (identity.connectionToClient == connection) + { + using (NetworkReaderPooled reader = NetworkReaderPool.Get(message.payload)) + { + // DeserializeServer checks permissions internally. + // failure to deserialize disconnects to prevent exploits. + if (!identity.DeserializeServer(reader)) + { + if (exceptionsDisconnect) + { + Debug.LogError($"Server failed to deserialize client state for {identity.name} with netId={identity.netId}, Disconnecting."); + connection.Disconnect(); + } + else + Debug.LogWarning($"Server failed to deserialize client state for {identity.name} with netId={identity.netId}."); + } + } + } + // An attacker may attempt to modify another connection's entity + // This could also be a race condition of message in flight when + // RemoveClientAuthority is called, so not malicious. + // Don't disconnect, just log the warning. + else + Debug.LogWarning($"EntityStateMessage from {connection} for {identity.name} without authority."); + } + // no warning. don't spam server logs. + // else Debug.LogWarning($"Did not find target for sync message for {message.netId} . Note: this can be completely normal because UDP messages may arrive out of order, so this message might have arrived after a Destroy message."); + } + + // client sends TimeSnapshotMessage every sendInterval. + // batching already includes the remoteTimestamp. + // we simply insert it on-message here. + // => only for reliable channel. unreliable would always arrive earlier. + static void OnTimeSnapshotMessage(NetworkConnectionToClient connection, TimeSnapshotMessage _) + { + // insert another snapshot for snapshot interpolation. + // before calling OnDeserialize so components can use + // NetworkTime.time and NetworkTime.timeStamp. + + // TODO validation? + // maybe we shouldn't allow timeline to deviate more than a certain %. + // for now, this is only used for client authority movement. + + // Unity 2019 doesn't have Time.timeAsDouble yet + // + // NetworkTime uses unscaled time and ignores Time.timeScale. + // fixes Time.timeScale getting server & client time out of sync: + // https://github.com/MirrorNetworking/Mirror/issues/3409 + connection.OnTimeSnapshot(new TimeSnapshot(connection.remoteTimeStamp, NetworkTime.localTime)); + } + + // connections ///////////////////////////////////////////////////////// + /// Add a connection and setup callbacks. Returns true if not added yet. + public static bool AddConnection(NetworkConnectionToClient conn) + { + if (!connections.ContainsKey(conn.connectionId)) + { + // connection cannot be null here or conn.connectionId + // would throw NRE + connections[conn.connectionId] = conn; + return true; + } + // already a connection with this id + return false; + } + + /// Removes a connection by connectionId. Returns true if removed. + public static bool RemoveConnection(int connectionId) => + connections.Remove(connectionId); + + // called by LocalClient to add itself. don't call directly. + // TODO consider internal setter instead? + internal static void SetLocalConnection(LocalConnectionToClient conn) + { + if (localConnection != null) + { + Debug.LogError("Local Connection already exists"); + return; + } + + localConnection = conn; + } + + // removes local connection to client + internal static void RemoveLocalConnection() + { + if (localConnection != null) + { + localConnection.Disconnect(); + localConnection = null; + } + RemoveConnection(0); + } + + /// True if we have external connections (that are not host) + public static bool HasExternalConnections() + { + // any connections? + if (connections.Count > 0) + { + // only host connection? + if (connections.Count == 1 && localConnection != null) + return false; + + // otherwise we have real external connections + return true; + } + return false; + } + + // send //////////////////////////////////////////////////////////////// + /// Send a message to all clients, even those that haven't joined the world yet (non ready) + public static void SendToAll(T message, int channelId = Channels.Reliable, bool sendToReadyOnly = false) + where T : struct, NetworkMessage + { + if (!active) + { + Debug.LogWarning("Can not send using NetworkServer.SendToAll(T msg) because NetworkServer is not active"); + return; + } + + // Debug.Log($"Server.SendToAll {typeof(T)}"); + using (NetworkWriterPooled writer = NetworkWriterPool.Get()) + { + // pack message only once + NetworkMessages.Pack(message, writer); + ArraySegment segment = writer.ToArraySegment(); + + // validate packet size immediately. + // we know how much can fit into one batch at max. + // if it's larger, log an error immediately with the type . + // previously we only logged in Update() when processing batches, + // but there we don't have type information anymore. + int max = NetworkMessages.MaxMessageSize(channelId); + if (writer.Position > max) + { + Debug.LogError($"NetworkServer.SendToAll: message of type {typeof(T)} with a size of {writer.Position} bytes is larger than the max allowed message size in one batch: {max}.\nThe message was dropped, please make it smaller."); + return; + } + + // filter and then send to all internet connections at once + // -> makes code more complicated, but is HIGHLY worth it to + // avoid allocations, allow for multicast, etc. + int count = 0; + foreach (NetworkConnectionToClient conn in connections.Values) + { + if (sendToReadyOnly && !conn.isReady) + continue; + + count++; + conn.Send(segment, channelId); + } + + NetworkDiagnostics.OnSend(message, channelId, segment.Count, count); + } + } + + /// Send a message to all clients which have joined the world (are ready). + // TODO put rpcs into NetworkServer.Update WorldState packet, then finally remove SendToReady! + public static void SendToReady(T message, int channelId = Channels.Reliable) + where T : struct, NetworkMessage + { + if (!active) + { + Debug.LogWarning("Can not send using NetworkServer.SendToReady(T msg) because NetworkServer is not active"); + return; + } + + SendToAll(message, channelId, true); + } + + // this is like SendToReadyObservers - but it doesn't check the ready flag on the connection. + // this is used for ObjectDestroy messages. + static void SendToObservers(NetworkIdentity identity, T message, int channelId = Channels.Reliable) + where T : struct, NetworkMessage + { + // Debug.Log($"Server.SendToObservers {typeof(T)}"); + if (identity == null || identity.observers.Count == 0) + return; + + using (NetworkWriterPooled writer = NetworkWriterPool.Get()) + { + // pack message into byte[] once + NetworkMessages.Pack(message, writer); + ArraySegment segment = writer.ToArraySegment(); + + // validate packet size immediately. + // we know how much can fit into one batch at max. + // if it's larger, log an error immediately with the type . + // previously we only logged in Update() when processing batches, + // but there we don't have type information anymore. + int max = NetworkMessages.MaxMessageSize(channelId); + if (writer.Position > max) + { + Debug.LogError($"NetworkServer.SendToObservers: message of type {typeof(T)} with a size of {writer.Position} bytes is larger than the max allowed message size in one batch: {max}.\nThe message was dropped, please make it smaller."); + return; + } + + foreach (NetworkConnectionToClient conn in identity.observers.Values) + { + conn.Send(segment, channelId); + } + + NetworkDiagnostics.OnSend(message, channelId, segment.Count, identity.observers.Count); + } + } + + /// Send a message to only clients which are ready with option to include the owner of the object identity + // TODO obsolete this later. it's not used anymore + public static void SendToReadyObservers(NetworkIdentity identity, T message, bool includeOwner = true, int channelId = Channels.Reliable) + where T : struct, NetworkMessage + { + // Debug.Log($"Server.SendToReady {typeof(T)}"); + if (identity == null || identity.observers.Count == 0) + return; + + using (NetworkWriterPooled writer = NetworkWriterPool.Get()) + { + // pack message only once + NetworkMessages.Pack(message, writer); + ArraySegment segment = writer.ToArraySegment(); + + // validate packet size immediately. + // we know how much can fit into one batch at max. + // if it's larger, log an error immediately with the type . + // previously we only logged in Update() when processing batches, + // but there we don't have type information anymore. + int max = NetworkMessages.MaxMessageSize(channelId); + if (writer.Position > max) + { + Debug.LogError($"NetworkServer.SendToReadyObservers: message of type {typeof(T)} with a size of {writer.Position} bytes is larger than the max allowed message size in one batch: {max}.\nThe message was dropped, please make it smaller."); + return; + } + + int count = 0; + foreach (NetworkConnectionToClient conn in identity.observers.Values) + { + bool isOwner = conn == identity.connectionToClient; + if ((!isOwner || includeOwner) && conn.isReady) + { + count++; + conn.Send(segment, channelId); + } + } + + NetworkDiagnostics.OnSend(message, channelId, segment.Count, count); + } + } + + /// Send a message to only clients which are ready including the owner of the NetworkIdentity + // TODO obsolete this later. it's not used anymore + public static void SendToReadyObservers(NetworkIdentity identity, T message, int channelId) + where T : struct, NetworkMessage + { + SendToReadyObservers(identity, message, true, channelId); + } + + // transport events //////////////////////////////////////////////////// + // called by transport + static void OnTransportConnected(int connectionId) + { + // Debug.Log($"Server accepted client:{connectionId}"); + + // connectionId needs to be != 0 because 0 is reserved for local player + // note that some transports like kcp generate connectionId by + // hashing which can be < 0 as well, so we need to allow < 0! + if (connectionId == 0) + { + Debug.LogError($"Server.HandleConnect: invalid connectionId: {connectionId} . Needs to be != 0, because 0 is reserved for local player."); + Transport.active.ServerDisconnect(connectionId); + return; + } + + // connectionId not in use yet? + if (connections.ContainsKey(connectionId)) + { + Transport.active.ServerDisconnect(connectionId); + // Debug.Log($"Server connectionId {connectionId} already in use...kicked client"); + return; + } + + // are more connections allowed? if not, kick + // (it's easier to handle this in Mirror, so Transports can have + // less code and third party transport might not do that anyway) + // (this way we could also send a custom 'tooFull' message later, + // Transport can't do that) + if (connections.Count < maxConnections) + { + // add connection + NetworkConnectionToClient conn = new NetworkConnectionToClient(connectionId); + OnConnected(conn); + } + else + { + // kick + Transport.active.ServerDisconnect(connectionId); + // Debug.Log($"Server full, kicked client {connectionId}"); + } + } + + internal static void OnConnected(NetworkConnectionToClient conn) + { + // Debug.Log($"Server accepted client:{conn}"); + + // add connection and invoke connected event + AddConnection(conn); + OnConnectedEvent?.Invoke(conn); + } + + static bool UnpackAndInvoke(NetworkConnectionToClient connection, NetworkReader reader, int channelId) + { + if (NetworkMessages.UnpackId(reader, out ushort msgType)) + { + // try to invoke the handler for that message + if (handlers.TryGetValue(msgType, out NetworkMessageDelegate handler)) + { + handler.Invoke(connection, reader, channelId); + connection.lastMessageTime = Time.time; + return true; + } + else + { + // message in a batch are NOT length prefixed to save bandwidth. + // every message needs to be handled and read until the end. + // otherwise it would overlap into the next message. + // => need to warn and disconnect to avoid undefined behaviour. + // => WARNING, not error. can happen if attacker sends random data. + Debug.LogWarning($"Unknown message id: {msgType} for connection: {connection}. This can happen if no handler was registered for this message."); + // simply return false. caller is responsible for disconnecting. + //connection.Disconnect(); + return false; + } + } + else + { + // => WARNING, not error. can happen if attacker sends random data. + Debug.LogWarning($"Invalid message header for connection: {connection}."); + // simply return false. caller is responsible for disconnecting. + //connection.Disconnect(); + return false; + } + } + + // called by transport + internal static void OnTransportData(int connectionId, ArraySegment data, int channelId) + { + if (connections.TryGetValue(connectionId, out NetworkConnectionToClient connection)) + { + // client might batch multiple messages into one packet. + // feed it to the Unbatcher. + // NOTE: we don't need to associate a channelId because we + // always process all messages in the batch. + if (!connection.unbatcher.AddBatch(data)) + { + if (exceptionsDisconnect) + { + Debug.LogError($"NetworkServer: received message from connectionId:{connectionId} was too short (messages should start with message id). Disconnecting."); + connection.Disconnect(); + } + else + Debug.LogWarning($"NetworkServer: received message from connectionId:{connectionId} was too short (messages should start with message id)."); + + return; + } + + // process all messages in the batch. + // only while NOT loading a scene. + // if we get a scene change message, then we need to stop + // processing. otherwise we might apply them to the old scene. + // => fixes https://github.com/vis2k/Mirror/issues/2651 + // + // NOTE: if scene starts loading, then the rest of the batch + // would only be processed when OnTransportData is called + // the next time. + // => consider moving processing to NetworkEarlyUpdate. + while (!isLoadingScene && + connection.unbatcher.GetNextMessage(out ArraySegment message, out double remoteTimestamp)) + { + using (NetworkReaderPooled reader = NetworkReaderPool.Get(message)) + { + // enough to read at least header size? + if (reader.Remaining >= NetworkMessages.IdSize) + { + // make remoteTimeStamp available to the user + connection.remoteTimeStamp = remoteTimestamp; + + // handle message + if (!UnpackAndInvoke(connection, reader, channelId)) + { + // warn, disconnect and return if failed + // -> warning because attackers might send random data + // -> messages in a batch aren't length prefixed. + // failing to read one would cause undefined + // behaviour for every message afterwards. + // so we need to disconnect. + // -> return to avoid the below unbatches.count error. + // we already disconnected and handled it. + if (exceptionsDisconnect) + { + Debug.LogError($"NetworkServer: failed to unpack and invoke message. Disconnecting {connectionId}."); + connection.Disconnect(); + } + else + Debug.LogWarning($"NetworkServer: failed to unpack and invoke message from connectionId:{connectionId}."); + + return; + } + } + // otherwise disconnect + else + { + if (exceptionsDisconnect) + { + Debug.LogError($"NetworkServer: received message from connectionId:{connectionId} was too short (messages should start with message id). Disconnecting."); + connection.Disconnect(); + } + else + Debug.LogWarning($"NetworkServer: received message from connectionId:{connectionId} was too short (messages should start with message id)."); + + return; + } + } + } + + // if we weren't interrupted by a scene change, + // then all batched messages should have been processed now. + // otherwise batches would silently grow. + // we need to log an error to avoid debugging hell. + // + // EXAMPLE: https://github.com/vis2k/Mirror/issues/2882 + // -> UnpackAndInvoke silently returned because no handler for id + // -> Reader would never be read past the end + // -> Batch would never be retired because end is never reached + // + // NOTE: prefixing every message in a batch with a length would + // avoid ever not reading to the end. for extra bandwidth. + // + // IMPORTANT: always keep this check to detect memory leaks. + // this took half a day to debug last time. + if (!isLoadingScene && connection.unbatcher.BatchesCount > 0) + { + Debug.LogError($"Still had {connection.unbatcher.BatchesCount} batches remaining after processing, even though processing was not interrupted by a scene change. This should never happen, as it would cause ever growing batches.\nPossible reasons:\n* A message didn't deserialize as much as it serialized\n*There was no message handler for a message id, so the reader wasn't read until the end."); + } + } + else Debug.LogError($"HandleData Unknown connectionId:{connectionId}"); + } + + // called by transport + // IMPORTANT: often times when disconnecting, we call this from Mirror + // too because we want to remove the connection and handle + // the disconnect immediately. + // => which is fine as long as we guarantee it only runs once + // => which we do by removing the connection! + internal static void OnTransportDisconnected(int connectionId) + { + // Debug.Log($"Server disconnect client:{connectionId}"); + if (connections.TryGetValue(connectionId, out NetworkConnectionToClient conn)) + { + RemoveConnection(connectionId); + // Debug.Log($"Server lost client:{connectionId}"); + + // NetworkManager hooks into OnDisconnectedEvent to make + // DestroyPlayerForConnection(conn) optional, e.g. for PvP MMOs + // where players shouldn't be able to escape combat instantly. + if (OnDisconnectedEvent != null) + { + OnDisconnectedEvent.Invoke(conn); + } + // if nobody hooked into it, then simply call DestroyPlayerForConnection + else + { + DestroyPlayerForConnection(conn); + } + } + } + + // transport errors are forwarded to high level + static void OnTransportError(int connectionId, TransportError error, string reason) + { + // transport errors will happen. logging a warning is enough. + // make sure the user does not panic. + Debug.LogWarning($"Server Transport Error for connId={connectionId}: {error}: {reason}. This is fine."); + // try get connection. passes null otherwise. + connections.TryGetValue(connectionId, out NetworkConnectionToClient conn); + OnErrorEvent?.Invoke(conn, error, reason); + } + + /// Destroys all of the connection's owned objects on the server. + // This is used when a client disconnects, to remove the players for + // that client. This also destroys non-player objects that have client + // authority set for this connection. + public static void DestroyPlayerForConnection(NetworkConnectionToClient conn) + { + // destroy all objects owned by this connection, including the player object + conn.DestroyOwnedObjects(); + // remove connection from all of its observing entities observers + // fixes https://github.com/vis2k/Mirror/issues/2737 + // -> cleaning those up in NetworkConnection.Disconnect is NOT enough + // because voluntary disconnects from the other end don't call + // NetworkConnection.Disconnect() + conn.RemoveFromObservingsObservers(); + conn.identity = null; + } + + // message handlers //////////////////////////////////////////////////// + /// Register a handler for message type T. Most should require authentication. + // TODO obsolete this some day to always use the channelId version. + // all handlers in this version are wrapped with 1 extra action. + public static void RegisterHandler(Action handler, bool requireAuthentication = true) + where T : struct, NetworkMessage + { + ushort msgType = NetworkMessageId.Id; + if (handlers.ContainsKey(msgType)) + { + Debug.LogWarning($"NetworkServer.RegisterHandler replacing handler for {typeof(T).FullName}, id={msgType}. If replacement is intentional, use ReplaceHandler instead to avoid this warning."); + } + + // register Id <> Type in lookup for debugging. + NetworkMessages.Lookup[msgType] = typeof(T); + + handlers[msgType] = NetworkMessages.WrapHandler(handler, requireAuthentication, exceptionsDisconnect); + } + + /// Register a handler for message type T. Most should require authentication. + // This version passes channelId to the handler. + public static void RegisterHandler(Action handler, bool requireAuthentication = true) + where T : struct, NetworkMessage + { + ushort msgType = NetworkMessageId.Id; + if (handlers.ContainsKey(msgType)) + { + Debug.LogWarning($"NetworkServer.RegisterHandler replacing handler for {typeof(T).FullName}, id={msgType}. If replacement is intentional, use ReplaceHandler instead to avoid this warning."); + } + + // register Id <> Type in lookup for debugging. + NetworkMessages.Lookup[msgType] = typeof(T); + + handlers[msgType] = NetworkMessages.WrapHandler(handler, requireAuthentication, exceptionsDisconnect); + } + + /// Replace a handler for message type T. Most should require authentication. + public static void ReplaceHandler(Action handler, bool requireAuthentication = true) + where T : struct, NetworkMessage + { + ReplaceHandler((_, value) => { handler(value); }, requireAuthentication); + } + + /// Replace a handler for message type T. Most should require authentication. + public static void ReplaceHandler(Action handler, bool requireAuthentication = true) + where T : struct, NetworkMessage + { + ushort msgType = NetworkMessageId.Id; + + // register Id <> Type in lookup for debugging. + NetworkMessages.Lookup[msgType] = typeof(T); + + handlers[msgType] = NetworkMessages.WrapHandler(handler, requireAuthentication, exceptionsDisconnect); + } + + /// Replace a handler for message type T. Most should require authentication. + public static void ReplaceHandler(Action handler, bool requireAuthentication = true) + where T : struct, NetworkMessage + { + ushort msgType = NetworkMessageId.Id; + + // register Id <> Type in lookup for debugging. + NetworkMessages.Lookup[msgType] = typeof(T); + + handlers[msgType] = NetworkMessages.WrapHandler(handler, requireAuthentication, exceptionsDisconnect); + } + + /// Unregister a handler for a message type T. + public static void UnregisterHandler() + where T : struct, NetworkMessage + { + ushort msgType = NetworkMessageId.Id; + handlers.Remove(msgType); + } + + /// Clears all registered message handlers. + public static void ClearHandlers() => handlers.Clear(); + + internal static bool GetNetworkIdentity(GameObject go, out NetworkIdentity identity) + { + if (!go.TryGetComponent(out identity)) + { + Debug.LogError($"GameObject {go.name} doesn't have NetworkIdentity."); + return false; + } + return true; + } + + // disconnect ////////////////////////////////////////////////////////// + /// Disconnect all connections, including the local connection. + // synchronous: handles disconnect events and cleans up fully before returning! + public static void DisconnectAll() + { + // disconnect and remove all connections. + // we can not use foreach here because if + // conn.Disconnect -> Transport.ServerDisconnect calls + // OnDisconnect -> NetworkServer.OnDisconnect(connectionId) + // immediately then OnDisconnect would remove the connection while + // we are iterating here. + // see also: https://github.com/vis2k/Mirror/issues/2357 + // this whole process should be simplified some day. + // until then, let's copy .Values to avoid InvalidOperationException. + // note that this is only called when stopping the server, so the + // copy is no performance problem. + foreach (NetworkConnectionToClient conn in connections.Values.ToList()) + { + // disconnect via connection->transport + conn.Disconnect(); + + // we want this function to be synchronous: handle disconnect + // events and clean up fully before returning. + // -> OnTransportDisconnected can safely be called without + // waiting for the Transport's callback. + // -> it has checks to only run once. + + // call OnDisconnected unless local player in host mod + // TODO unnecessary check? + if (conn.connectionId != NetworkConnection.LocalConnectionId) + OnTransportDisconnected(conn.connectionId); + } + + // cleanup + connections.Clear(); + localConnection = null; + // this used to set active=false. + // however, then Shutdown can't properly destroy objects: + // https://github.com/MirrorNetworking/Mirror/issues/3344 + // "DisconnectAll" should only disconnect all, not set inactive. + // active = false; + } + + // add/remove/replace player /////////////////////////////////////////// + /// Called by server after AddPlayer message to add the player for the connection. + // When a player is added for a connection, the client for that + // connection is made ready automatically. The player object is + // automatically spawned, so you do not need to call NetworkServer.Spawn + // for that object. This function is used for "adding" a player, not for + // "replacing" the player on a connection. If there is already a player + // on this playerControllerId for this connection, this will fail. + public static bool AddPlayerForConnection(NetworkConnectionToClient conn, GameObject player, uint assetId) + { + if (GetNetworkIdentity(player, out NetworkIdentity identity)) + { + identity.assetId = assetId; + } + return AddPlayerForConnection(conn, player); + } + + /// Called by server after AddPlayer message to add the player for the connection. + // When a player is added for a connection, the client for that + // connection is made ready automatically. The player object is + // automatically spawned, so you do not need to call NetworkServer.Spawn + // for that object. This function is used for "adding" a player, not for + // "replacing" the player on a connection. If there is already a player + // on this playerControllerId for this connection, this will fail. + public static bool AddPlayerForConnection(NetworkConnectionToClient conn, GameObject player) + { + if (!player.TryGetComponent(out NetworkIdentity identity)) + { + Debug.LogWarning($"AddPlayer: player GameObject has no NetworkIdentity. Please add a NetworkIdentity to {player}"); + return false; + } + + // cannot have a player object in "Add" version + if (conn.identity != null) + { + Debug.Log("AddPlayer: player object already exists"); + return false; + } + + // make sure we have a controller before we call SetClientReady + // because the observers will be rebuilt only if we have a controller + conn.identity = identity; + + // Set the connection on the NetworkIdentity on the server, NetworkIdentity.SetLocalPlayer is not called on the server (it is on clients) + identity.SetClientOwner(conn); + + // special case, we are in host mode, set hasAuthority to true so that all overrides see it + if (conn is LocalConnectionToClient) + { + identity.isOwned = true; + NetworkClient.InternalAddPlayer(identity); + } + + // set ready if not set yet + SetClientReady(conn); + + // Debug.Log($"Adding new playerGameObject object netId: {identity.netId} asset ID: {identity.assetId}"); + + Respawn(identity); + return true; + } + + /// Replaces connection's player object. The old object is not destroyed. + // This does NOT change the ready state of the connection, so it can + // safely be used while changing scenes. + public static bool ReplacePlayerForConnection(NetworkConnectionToClient conn, GameObject player, bool keepAuthority = false) + { + if (!player.TryGetComponent(out NetworkIdentity identity)) + { + Debug.LogError($"ReplacePlayer: playerGameObject has no NetworkIdentity. Please add a NetworkIdentity to {player}"); + return false; + } + + if (identity.connectionToClient != null && identity.connectionToClient != conn) + { + Debug.LogError($"Cannot replace player for connection. New player is already owned by a different connection{player}"); + return false; + } + + //NOTE: there can be an existing player + //Debug.Log("NetworkServer ReplacePlayer"); + + NetworkIdentity previousPlayer = conn.identity; + + conn.identity = identity; + + // Set the connection on the NetworkIdentity on the server, NetworkIdentity.SetLocalPlayer is not called on the server (it is on clients) + identity.SetClientOwner(conn); + + // special case, we are in host mode, set hasAuthority to true so that all overrides see it + if (conn is LocalConnectionToClient) + { + identity.isOwned = true; + NetworkClient.InternalAddPlayer(identity); + } + + // add connection to observers AFTER the playerController was set. + // by definition, there is nothing to observe if there is no player + // controller. + // + // IMPORTANT: do this in AddPlayerForConnection & ReplacePlayerForConnection! + SpawnObserversForConnection(conn); + + //Debug.Log($"Replacing playerGameObject object netId:{player.GetComponent().netId} asset ID {player.GetComponent().assetId}"); + + Respawn(identity); + + if (keepAuthority) + { + // This needs to be sent to clear isLocalPlayer on + // client while keeping hasAuthority true + SendChangeOwnerMessage(previousPlayer, conn); + } + else + { + // This clears both isLocalPlayer and hasAuthority on client + previousPlayer.RemoveClientAuthority(); + } + + return true; + } + + /// Replaces connection's player object. The old object is not destroyed. + // This does NOT change the ready state of the connection, so it can + // safely be used while changing scenes. + public static bool ReplacePlayerForConnection(NetworkConnectionToClient conn, GameObject player, uint assetId, bool keepAuthority = false) + { + if (GetNetworkIdentity(player, out NetworkIdentity identity)) + { + identity.assetId = assetId; + } + return ReplacePlayerForConnection(conn, player, keepAuthority); + } + + /// Removes the player object from the connection + // destroyServerObject: Indicates whether the server object should be destroyed + public static void RemovePlayerForConnection(NetworkConnectionToClient conn, bool destroyServerObject) + { + if (conn.identity != null) + { + if (destroyServerObject) + Destroy(conn.identity.gameObject); + else + UnSpawn(conn.identity.gameObject); + + conn.identity = null; + } + //else Debug.Log($"Connection {conn} has no identity"); + } + + // ready /////////////////////////////////////////////////////////////// + /// Flags client connection as ready (=joined world). + // When a client has signaled that it is ready, this method tells the + // server that the client is ready to receive spawned objects and state + // synchronization updates. This is usually called in a handler for the + // SYSTEM_READY message. If there is not specific action a game needs to + // take for this message, relying on the default ready handler function + // is probably fine, so this call wont be needed. + public static void SetClientReady(NetworkConnectionToClient conn) + { + // Debug.Log($"SetClientReadyInternal for conn:{conn}"); + + // set ready + conn.isReady = true; + + // client is ready to start spawning objects + if (conn.identity != null) + SpawnObserversForConnection(conn); + } + + static void SpawnObserversForConnection(NetworkConnectionToClient conn) + { + //Debug.Log($"Spawning {spawned.Count} objects for conn {conn}"); + + if (!conn.isReady) + { + // client needs to finish initializing before we can spawn objects + // otherwise it would not find them. + return; + } + + // let connection know that we are about to start spawning... + conn.Send(new ObjectSpawnStartedMessage()); + + // add connection to each nearby NetworkIdentity's observers, which + // internally sends a spawn message for each one to the connection. + foreach (NetworkIdentity identity in spawned.Values) + { + // try with far away ones in ummorpg! + if (identity.gameObject.activeSelf) //TODO this is different + { + //Debug.Log($"Sending spawn message for current server objects name:{identity.name} netId:{identity.netId} sceneId:{identity.sceneId:X}"); + + // we need to support three cases: + // - legacy system (identity has .visibility) + // - new system (networkserver has .aoi) + // - default case: no .visibility and no .aoi means add all + // connections by default) + // + // ForceHidden/ForceShown overwrite all systems so check it + // first! + + // ForceShown: add no matter what + if (identity.visibility == Visibility.ForceShown) + { + identity.AddObserver(conn); + } + // ForceHidden: don't show no matter what + else if (identity.visibility == Visibility.ForceHidden) + { + // do nothing + } + // default: legacy system / new system / no system support + else if (identity.visibility == Visibility.Default) + { + // aoi system + if (aoi != null) + { + // call OnCheckObserver + if (aoi.OnCheckObserver(identity, conn)) + identity.AddObserver(conn); + } + // no system: add all observers by default + else + { + identity.AddObserver(conn); + } + } + } + } + + // let connection know that we finished spawning, so it can call + // OnStartClient on each one (only after all were spawned, which + // is how Unity's Start() function works too) + conn.Send(new ObjectSpawnFinishedMessage()); + } + + /// Marks the client of the connection to be not-ready. + // Clients that are not ready do not receive spawned objects or state + // synchronization updates. They client can be made ready again by + // calling SetClientReady(). + public static void SetClientNotReady(NetworkConnectionToClient conn) + { + conn.isReady = false; + conn.RemoveFromObservingsObservers(); + conn.Send(new NotReadyMessage()); + } + + /// Marks all connected clients as no longer ready. + // All clients will no longer be sent state synchronization updates. The + // player's clients can call ClientManager.Ready() again to re-enter the + // ready state. This is useful when switching scenes. + public static void SetAllClientsNotReady() + { + foreach (NetworkConnectionToClient conn in connections.Values) + { + SetClientNotReady(conn); + } + } + + // show / hide for connection ////////////////////////////////////////// + internal static void ShowForConnection(NetworkIdentity identity, NetworkConnection conn) + { + if (conn.isReady) + SendSpawnMessage(identity, conn); + } + + internal static void HideForConnection(NetworkIdentity identity, NetworkConnection conn) + { + ObjectHideMessage msg = new ObjectHideMessage + { + netId = identity.netId + }; + conn.Send(msg); + } + + // spawning //////////////////////////////////////////////////////////// + internal static void SendSpawnMessage(NetworkIdentity identity, NetworkConnection conn) + { + if (identity.serverOnly) return; + + //Debug.Log($"Server SendSpawnMessage: name:{identity.name} sceneId:{identity.sceneId:X} netid:{identity.netId}"); + + // one writer for owner, one for observers + using (NetworkWriterPooled ownerWriter = NetworkWriterPool.Get(), observersWriter = NetworkWriterPool.Get()) + { + bool isOwner = identity.connectionToClient == conn; + ArraySegment payload = CreateSpawnMessagePayload(isOwner, identity, ownerWriter, observersWriter); + SpawnMessage message = new SpawnMessage + { + netId = identity.netId, + isLocalPlayer = conn.identity == identity, + isOwner = isOwner, + sceneId = identity.sceneId, + assetId = identity.assetId, + // use local values for VR support + position = identity.transform.localPosition, + rotation = identity.transform.localRotation, + scale = identity.transform.localScale, + payload = payload + }; + conn.Send(message); + } + } + + static ArraySegment CreateSpawnMessagePayload(bool isOwner, NetworkIdentity identity, NetworkWriterPooled ownerWriter, NetworkWriterPooled observersWriter) + { + // Only call SerializeAll if there are NetworkBehaviours + if (identity.NetworkBehaviours.Length == 0) + { + return default; + } + + // serialize all components with initialState = true + // (can be null if has none) + identity.SerializeServer(true, ownerWriter, observersWriter); + + // convert to ArraySegment to avoid reader allocations + // if nothing was written, .ToArraySegment returns an empty segment. + ArraySegment ownerSegment = ownerWriter.ToArraySegment(); + ArraySegment observersSegment = observersWriter.ToArraySegment(); + + // use owner segment if 'conn' owns this identity, otherwise + // use observers segment + ArraySegment payload = isOwner ? ownerSegment : observersSegment; + + return payload; + } + + internal static void SendChangeOwnerMessage(NetworkIdentity identity, NetworkConnectionToClient conn) + { + // Don't send if identity isn't spawned or only exists on server + if (identity.netId == 0 || identity.serverOnly) return; + + // Don't send if conn doesn't have the identity spawned yet + // May be excluded from the client by interest management + if (!conn.observing.Contains(identity)) return; + + //Debug.Log($"Server SendChangeOwnerMessage: name={identity.name} netid={identity.netId}"); + + conn.Send(new ChangeOwnerMessage + { + netId = identity.netId, + isOwner = identity.connectionToClient == conn, + isLocalPlayer = conn.identity == identity + }); + } + + // check NetworkIdentity parent before spawning it. + // - without parent, they are spawned + // - with parent, only if the parent is active in hierarchy + // + // note that active parents may have inactive parents of their own. + // we need to check .activeInHierarchy. + // + // fixes: https://github.com/MirrorNetworking/Mirror/issues/3330 + // https://github.com/vis2k/Mirror/issues/2778 + static bool ValidParent(NetworkIdentity identity) => + identity.transform.parent == null || + identity.transform.parent.gameObject.activeInHierarchy; + + /// Spawns NetworkIdentities in the scene on the server. + // NetworkIdentity objects in a scene are disabled by default. Calling + // SpawnObjects() causes these scene objects to be enabled and spawned. + // It is like calling NetworkServer.Spawn() for each of them. + public static bool SpawnObjects() + { + // only if server active + if (!active) + return false; + + // find all NetworkIdentities in the scene. + // all of them are disabled because of NetworkScenePostProcess. + NetworkIdentity[] identities = Resources.FindObjectsOfTypeAll(); + + // first pass: activate all scene objects + foreach (NetworkIdentity identity in identities) + { + // only spawn scene objects which haven't been spawned yet. + // SpawnObjects may be called multiple times for additive scenes. + // https://github.com/MirrorNetworking/Mirror/issues/3318 + // + // note that we even activate objects under inactive parents. + // while they are not spawned, they do need to be activated + // in order to be spawned later. so here, we don't check parents. + // https://github.com/MirrorNetworking/Mirror/issues/3330 + if (Utils.IsSceneObject(identity) && identity.netId == 0) + { + // Debug.Log($"SpawnObjects sceneId:{identity.sceneId:X} name:{identity.gameObject.name}"); + identity.gameObject.SetActive(true); + } + } + + // second pass: spawn all scene objects + foreach (NetworkIdentity identity in identities) + { + // scene objects may be children of inactive parents. + // users would put them under disabled parents to 'deactivate' them. + // those should not be used by Mirror at all. + // fixes: https://github.com/MirrorNetworking/Mirror/issues/3330 + // https://github.com/vis2k/Mirror/issues/2778 + if (Utils.IsSceneObject(identity) && identity.netId == 0 && ValidParent(identity)) + { + // pass connection so that authority is not lost when server loads a scene + // https://github.com/vis2k/Mirror/pull/2987 + Spawn(identity.gameObject, identity.connectionToClient); + } + } + + return true; + } + + /// Spawns an object and also assigns Client Authority to the specified client. + // This is the same as calling NetworkIdentity.AssignClientAuthority on the spawned object. + public static void Spawn(GameObject obj, GameObject ownerPlayer) + { + if (!ownerPlayer.TryGetComponent(out NetworkIdentity identity)) + { + Debug.LogError("Player object has no NetworkIdentity"); + return; + } + + if (identity.connectionToClient == null) + { + Debug.LogError("Player object is not a player."); + return; + } + + Spawn(obj, identity.connectionToClient); + } + + static void Respawn(NetworkIdentity identity) + { + if (identity.netId == 0) + { + // If the object has not been spawned, then do a full spawn and update observers + Spawn(identity.gameObject, identity.connectionToClient); + } + else + { + // otherwise just replace his data + SendSpawnMessage(identity, identity.connectionToClient); + } + } + + /// Spawn the given game object on all clients which are ready. + // This will cause a new object to be instantiated from the registered + // prefab, or from a custom spawn function. + public static void Spawn(GameObject obj, NetworkConnection ownerConnection = null) + { + SpawnObject(obj, ownerConnection); + } + + /// Spawns an object and also assigns Client Authority to the specified client. + // This is the same as calling NetworkIdentity.AssignClientAuthority on the spawned object. + public static void Spawn(GameObject obj, uint assetId, NetworkConnection ownerConnection = null) + { + if (GetNetworkIdentity(obj, out NetworkIdentity identity)) + { + identity.assetId = assetId; + } + SpawnObject(obj, ownerConnection); + } + + static void SpawnObject(GameObject obj, NetworkConnection ownerConnection) + { + // verify if we can spawn this + if (Utils.IsPrefab(obj)) + { + Debug.LogError($"GameObject {obj.name} is a prefab, it can't be spawned. Instantiate it first.", obj); + return; + } + + if (!active) + { + Debug.LogError($"SpawnObject for {obj}, NetworkServer is not active. Cannot spawn objects without an active server.", obj); + return; + } + + if (!obj.TryGetComponent(out NetworkIdentity identity)) + { + Debug.LogError($"SpawnObject {obj} has no NetworkIdentity. Please add a NetworkIdentity to {obj}", obj); + return; + } + + if (identity.SpawnedFromInstantiate) + { + // Using Instantiate on SceneObject is not allowed, so stop spawning here + // NetworkIdentity.Awake already logs error, no need to log a second error here + return; + } + + // Spawn should only be called once per netId. + // calling it twice would lead to undefined behaviour. + // https://github.com/MirrorNetworking/Mirror/pull/3205 + if (spawned.ContainsKey(identity.netId)) + { + Debug.LogWarning($"{identity.name} [netId={identity.netId}] was already spawned.", identity.gameObject); + return; + } + + identity.connectionToClient = (NetworkConnectionToClient)ownerConnection; + + // special case to make sure hasAuthority is set + // on start server in host mode + if (ownerConnection is LocalConnectionToClient) + identity.isOwned = true; + + // NetworkServer.Unspawn sets object as inactive. + // NetworkServer.Spawn needs to set them active again in case they were previously unspawned / inactive. + identity.gameObject.SetActive(true); + + // only call OnStartServer if not spawned yet. + // check used to be in NetworkIdentity. may not be necessary anymore. + if (!identity.isServer && identity.netId == 0) + { + // configure NetworkIdentity + // this may be called in host mode, so we need to initialize + // isLocalPlayer/isClient flags too. + identity.isLocalPlayer = NetworkClient.localPlayer == identity; + identity.isClient = NetworkClient.active; + identity.isServer = true; + identity.netId = NetworkIdentity.GetNextNetworkId(); + + // add to spawned (after assigning netId) + spawned[identity.netId] = identity; + + // callback after all fields were set + identity.OnStartServer(); + } + + // Debug.Log($"SpawnObject instance ID {identity.netId} asset ID {identity.assetId}"); + + if (aoi) + { + // This calls user code which might throw exceptions + // We don't want this to leave us in bad state + try + { + aoi.OnSpawned(identity); + } + catch (Exception e) + { + Debug.LogException(e); + } + } + + RebuildObservers(identity, true); + } + + /// This takes an object that has been spawned and un-spawns it. + // The object will be removed from clients that it was spawned on, or + // the custom spawn handler function on the client will be called for + // the object. + // Unlike when calling NetworkServer.Destroy(), on the server the object + // will NOT be destroyed. This allows the server to re-use the object, + // even spawn it again later. + public static void UnSpawn(GameObject obj) + { + // Debug.Log($"DestroyObject instance:{identity.netId}"); + + // NetworkServer.Unspawn should only be called on server or host. + // on client, show a warning to explain what it does. + if (!active) + { + Debug.LogWarning("NetworkServer.Unspawn() called without an active server. Servers can only destroy while active, clients can only ask the server to destroy (for example, with a [Command]), after which the server may decide to destroy the object and broadcast the change to all clients."); + return; + } + + if (obj == null) + { + Debug.Log("NetworkServer.Unspawn(): object is null"); + return; + } + + if (!GetNetworkIdentity(obj, out NetworkIdentity identity)) + { + return; + } + + // only call OnRebuildObservers while active, + // not while shutting down + // (https://github.com/vis2k/Mirror/issues/2977) + if (active && aoi) + { + // This calls user code which might throw exceptions + // We don't want this to leave us in bad state + try + { + aoi.OnDestroyed(identity); + } + catch (Exception e) + { + Debug.LogException(e); + } + } + + // remove from NetworkServer (this) dictionary + spawned.Remove(identity.netId); + + identity.connectionToClient?.RemoveOwnedObject(identity); + + // send object destroy message to all observers, clear observers + SendToObservers(identity, new ObjectDestroyMessage + { + netId = identity.netId + }); + identity.ClearObservers(); + + // in host mode, call OnStopClient/OnStopLocalPlayer manually + if (NetworkClient.active && activeHost) + { + if (identity.isLocalPlayer) + identity.OnStopLocalPlayer(); + + identity.OnStopClient(); + // The object may have been spawned with host client ownership, + // e.g. a pet so we need to clear hasAuthority and call + // NotifyAuthority which invokes OnStopAuthority if hasAuthority. + identity.isOwned = false; + identity.NotifyAuthority(); + + // remove from NetworkClient dictionary + NetworkClient.connection.owned.Remove(identity); + NetworkClient.spawned.Remove(identity.netId); + } + + // we are on the server. call OnStopServer. + identity.OnStopServer(); + + // finally reset the state and deactivate it + identity.ResetState(); + identity.gameObject.SetActive(false); + } + + // destroy ///////////////////////////////////////////////////////////// + /// Destroys this object and corresponding objects on all clients. + // In some cases it is useful to remove an object but not delete it on + // the server. For that, use NetworkServer.UnSpawn() instead of + // NetworkServer.Destroy(). + public static void Destroy(GameObject obj) + { + // NetworkServer.Destroy should only be called on server or host. + // on client, show a warning to explain what it does. + if (!active) + { + Debug.LogWarning("NetworkServer.Destroy() called without an active server. Servers can only destroy while active, clients can only ask the server to destroy (for example, with a [Command]), after which the server may decide to destroy the object and broadcast the change to all clients."); + return; + } + + if (obj == null) + { + Debug.Log("NetworkServer.Destroy(): object is null"); + return; + } + + // first, we unspawn it on clients and server + UnSpawn(obj); + + // additionally, if it's a prefab then we destroy it completely. + // we never destroy scene objects on server or on client, since once + // they are gone, they are gone forever and can't be instantiate again. + // for example, server may Destroy() a scene object and once a match + // restarts, the scene objects would be gone from the new match. + if (GetNetworkIdentity(obj, out NetworkIdentity identity) && + identity.sceneId == 0) + { + identity.destroyCalled = true; + + // Destroy if application is running + if (Application.isPlaying) + { + UnityEngine.Object.Destroy(obj); + } + // Destroy can't be used in Editor during tests. use DestroyImmediate. + else + { + GameObject.DestroyImmediate(obj); + } + } + } + + // interest management ///////////////////////////////////////////////// + // Helper function to add all server connections as observers. + // This is used if none of the components provides their own + // OnRebuildObservers function. + // rebuild observers default method (no AOI) - adds all connections + static void RebuildObserversDefault(NetworkIdentity identity, bool initialize) + { + // only add all connections when rebuilding the first time. + // second time we just keep them without rebuilding anything. + if (initialize) + { + // not force hidden? + if (identity.visibility != Visibility.ForceHidden) + { + AddAllReadyServerConnectionsToObservers(identity); + } + } + } + + internal static void AddAllReadyServerConnectionsToObservers(NetworkIdentity identity) + { + // add all server connections + foreach (NetworkConnectionToClient conn in connections.Values) + { + // only if authenticated (don't send to people during logins) + if (conn.isReady) + identity.AddObserver(conn); + } + + // add local host connection (if any) + if (localConnection != null && localConnection.isReady) + { + identity.AddObserver(localConnection); + } + } + + // RebuildObservers does a local rebuild for the NetworkIdentity. + // This causes the set of players that can see this object to be rebuild. + // + // IMPORTANT: + // => global rebuild would be more simple, BUT + // => local rebuild is way faster for spawn/despawn because we can + // simply rebuild a select NetworkIdentity only + // => having both .observers and .observing is necessary for local + // rebuilds + // + // in other words, this is the perfect solution even though it's not + // completely simple (due to .observers & .observing) + // + // Mirror maintains .observing automatically in the background. best of + // both worlds without any worrying now! + public static void RebuildObservers(NetworkIdentity identity, bool initialize) + { + // if there is no interest management system, + // or if 'force shown' then add all connections + if (aoi == null || identity.visibility == Visibility.ForceShown) + { + RebuildObserversDefault(identity, initialize); + } + // otherwise let interest management system rebuild + else + { + aoi.Rebuild(identity, initialize); + } + } + + + // broadcasting //////////////////////////////////////////////////////// + // helper function to get the right serialization for a connection + static NetworkWriter SerializeForConnection(NetworkIdentity identity, NetworkConnectionToClient connection) + { + // get serialization for this entity (cached) + // IMPORTANT: int tick avoids floating point inaccuracy over days/weeks + NetworkIdentitySerialization serialization = identity.GetServerSerializationAtTick(Time.frameCount); + + // is this entity owned by this connection? + bool owned = identity.connectionToClient == connection; + + // send serialized data + // owner writer if owned + if (owned) + { + // was it dirty / did we actually serialize anything? + if (serialization.ownerWriter.Position > 0) + return serialization.ownerWriter; + } + // observers writer if not owned + else + { + // was it dirty / did we actually serialize anything? + if (serialization.observersWriter.Position > 0) + return serialization.observersWriter; + } + + // nothing was serialized + return null; + } + + // helper function to broadcast the world to a connection + static void BroadcastToConnection(NetworkConnectionToClient connection) + { + // for each entity that this connection is seeing + foreach (NetworkIdentity identity in connection.observing) + { + // make sure it's not null or destroyed. + // (which can happen if someone uses + // GameObject.Destroy instead of + // NetworkServer.Destroy) + if (identity != null) + { + // get serialization for this entity viewed by this connection + // (if anything was serialized this time) + NetworkWriter serialization = SerializeForConnection(identity, connection); + if (serialization != null) + { + EntityStateMessage message = new EntityStateMessage + { + netId = identity.netId, + payload = serialization.ToArraySegment() + }; + connection.Send(message); + } + } + // spawned list should have no null entries because we + // always call Remove in OnObjectDestroy everywhere. + // if it does have null then someone used + // GameObject.Destroy instead of NetworkServer.Destroy. + else Debug.LogWarning($"Found 'null' entry in observing list for connectionId={connection.connectionId}. Please call NetworkServer.Destroy to destroy networked objects. Don't use GameObject.Destroy."); + } + } + + // helper function to check a connection for inactivity and disconnect if necessary + // returns true if disconnected + static bool DisconnectIfInactive(NetworkConnectionToClient connection) + { + // check for inactivity + if (disconnectInactiveConnections && + !connection.IsAlive(disconnectInactiveTimeout)) + { + Debug.LogWarning($"Disconnecting {connection} for inactivity!"); + connection.Disconnect(); + return true; + } + return false; + } + + // NetworkLateUpdate called after any Update/FixedUpdate/LateUpdate + // (we add this to the UnityEngine in NetworkLoop) + // internal for tests + internal static readonly List connectionsCopy = + new List(); + + static void Broadcast() + { + // copy all connections into a helper collection so that + // OnTransportDisconnected can be called while iterating. + // -> OnTransportDisconnected removes from the collection + // -> which would throw 'can't modify while iterating' errors + // => see also: https://github.com/vis2k/Mirror/issues/2739 + // (copy nonalloc) + // TODO remove this when we move to 'lite' transports with only + // socket send/recv later. + connectionsCopy.Clear(); + connections.Values.CopyTo(connectionsCopy); + + // go through all connections + foreach (NetworkConnectionToClient connection in connectionsCopy) + { + // check for inactivity. disconnects if necessary. + if (DisconnectIfInactive(connection)) + continue; + + // has this connection joined the world yet? + // for each READY connection: + // pull in UpdateVarsMessage for each entity it observes + if (connection.isReady) + { + // send time for snapshot interpolation every sendInterval. + // BroadcastToConnection() may not send if nothing is new. + // + // sent over unreliable. + // NetworkTime / Transform both use unreliable. + // + // make sure Broadcast() is only called every sendInterval, + // even if targetFrameRate isn't set in host mode (!) + // (done via AccurateInterval) + connection.Send(new TimeSnapshotMessage(), Channels.Unreliable); + + // broadcast world state to this connection + BroadcastToConnection(connection); + } + + // update connection to flush out batched messages + connection.Update(); + } + + // TODO this is way too slow because we iterate ALL spawned :/ + // TODO this is way too complicated :/ + // to understand what this tries to prevent, consider this example: + // monster has health=100 + // we change health=200, dirty bit is set + // player comes in range, gets full serialization spawn packet. + // next Broadcast(), player gets the health=200 change because dirty bit was set. + // + // this code clears all dirty bits if no players are around to prevent it. + // BUT there are two issues: + // 1. what if a playerB was around the whole time? + // 2. why don't we handle broadcast and spawn packets both HERE? + // handling spawn separately is why we need this complex magic + // + // see test: DirtyBitsAreClearedForSpawnedWithoutObservers() + // see test: SyncObjectChanges_DontGrowWithoutObservers() + // + // PAUL: we also do this to avoid ever growing SyncList .changes + //ClearSpawnedDirtyBits(); + // + // this was moved to NetworkIdentity.AddObserver! + // same result, but no more O(N) loop in here! + // TODO remove this comment after moving spawning into Broadcast()! + } + + // update ////////////////////////////////////////////////////////////// + // NetworkEarlyUpdate called before any Update/FixedUpdate + // (we add this to the UnityEngine in NetworkLoop) + internal static void NetworkEarlyUpdate() + { + // measure update time for profiling. + if (active) + { + earlyUpdateDuration.Begin(); + fullUpdateDuration.Begin(); + } + + // process all incoming messages first before updating the world + if (Transport.active != null) + Transport.active.ServerEarlyUpdate(); + + // step each connection's local time interpolation in early update. + foreach (NetworkConnectionToClient connection in connections.Values) + connection.UpdateTimeInterpolation(); + + if (active) earlyUpdateDuration.End(); + } + + internal static void NetworkLateUpdate() + { + if (active) + { + // measure update time for profiling. + lateUpdateDuration.Begin(); + + // only broadcast world if active + // broadcast every sendInterval. + // AccurateInterval to avoid update frequency inaccuracy issues: + // https://github.com/vis2k/Mirror/pull/3153 + // + // for example, host mode server doesn't set .targetFrameRate. + // Broadcast() would be called every tick. + // snapshots might be sent way too often, etc. + // + // during tests, we always call Broadcast() though. + // + // also important for syncInterval=0 components like + // NetworkTransform, so they can sync on same interval as time + // snapshots _but_ not every single tick. + // Unity 2019 doesn't have Time.timeAsDouble yet + if (!Application.isPlaying || AccurateInterval.Elapsed(NetworkTime.localTime, sendInterval, ref lastSendTime)) + Broadcast(); + } + + // process all outgoing messages after updating the world + // (even if not active. still want to process disconnects etc.) + if (Transport.active != null) + Transport.active.ServerLateUpdate(); + + // measure actual tick rate every second. + if (active) + { + ++actualTickRateCounter; + + // NetworkTime.localTime has defines for 2019 / 2020 compatibility + if (NetworkTime.localTime >= actualTickRateStart + 1) + { + // calculate avg by exact elapsed time. + // assuming 1s wouldn't be accurate, usually a few more ms passed. + float elapsed = (float)(NetworkTime.localTime - actualTickRateStart); + actualTickRate = Mathf.RoundToInt(actualTickRateCounter / elapsed); + actualTickRateStart = NetworkTime.localTime; + actualTickRateCounter = 0; + } + + // measure total update time. including transport. + // because in early update, transport update calls handlers. + lateUpdateDuration.End(); + fullUpdateDuration.End(); + } + } + } +} diff --git a/Assets/Mirror/Core/NetworkServer.cs.meta b/Assets/Mirror/Core/NetworkServer.cs.meta new file mode 100644 index 0000000..9861342 --- /dev/null +++ b/Assets/Mirror/Core/NetworkServer.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: a5f5ec068f5604c32b160bc49ee97b75 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/NetworkStartPosition.cs b/Assets/Mirror/Core/NetworkStartPosition.cs new file mode 100644 index 0000000..e11029b --- /dev/null +++ b/Assets/Mirror/Core/NetworkStartPosition.cs @@ -0,0 +1,21 @@ +using UnityEngine; + +namespace Mirror +{ + /// Start position for player spawning, automatically registers itself in the NetworkManager. + [DisallowMultipleComponent] + [AddComponentMenu("Network/Network Start Position")] + [HelpURL("https://mirror-networking.gitbook.io/docs/components/network-start-position")] + public class NetworkStartPosition : MonoBehaviour + { + public void Awake() + { + NetworkManager.RegisterStartPosition(transform); + } + + public void OnDestroy() + { + NetworkManager.UnRegisterStartPosition(transform); + } + } +} diff --git a/Assets/Mirror/Core/NetworkStartPosition.cs.meta b/Assets/Mirror/Core/NetworkStartPosition.cs.meta new file mode 100644 index 0000000..ae9ab89 --- /dev/null +++ b/Assets/Mirror/Core/NetworkStartPosition.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 41f84591ce72545258ea98cb7518d8b9 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/NetworkTime.cs b/Assets/Mirror/Core/NetworkTime.cs new file mode 100644 index 0000000..6319970 --- /dev/null +++ b/Assets/Mirror/Core/NetworkTime.cs @@ -0,0 +1,243 @@ +// NetworkTime now uses NetworkClient's snapshot interpolated timeline. +// this gives ideal results & ensures everything is on the same timeline. +// previously, NetworkTransforms were on separate timelines. +// +// however, some of the old NetworkTime code remains for ping time (rtt). +// some users may still be using that. +using System; +using System.Runtime.CompilerServices; +using UnityEngine; +#if !UNITY_2020_3_OR_NEWER +using Stopwatch = System.Diagnostics.Stopwatch; +#endif + +namespace Mirror +{ + /// Synchronizes server time to clients. + public static class NetworkTime + { + /// Ping message interval, used to calculate latency / RTT and predicted time. + // 2s was enough to get a good average RTT. + // for prediction, we want to react to latency changes more rapidly. + const float DefaultPingInterval = 0.1f; // for resets + public static float PingInterval = DefaultPingInterval; + + /// Average out the last few results from Ping + // const because it's used immediately in _rtt constructor. + public const int PingWindowSize = 50; // average over 50 * 100ms = 5s + + static double lastPingTime; + + static ExponentialMovingAverage _rtt = new ExponentialMovingAverage(PingWindowSize); + + /// Returns double precision clock time _in this system_, unaffected by the network. +#if UNITY_2020_3_OR_NEWER + public static double localTime + { + // NetworkTime uses unscaled time and ignores Time.timeScale. + // fixes Time.timeScale getting server & client time out of sync: + // https://github.com/MirrorNetworking/Mirror/issues/3409 + [MethodImpl(MethodImplOptions.AggressiveInlining)] + get => Time.unscaledTimeAsDouble; + } +#else + // need stopwatch for older Unity versions, but it's quite slow. + // CAREFUL: unlike Time.time, the stopwatch time is not a FRAME time. + // it changes during the frame, so we have an extra step to "cache" it in EarlyUpdate. + static readonly Stopwatch stopwatch = new Stopwatch(); + static NetworkTime() => stopwatch.Start(); + static double localFrameTime; + public static double localTime => localFrameTime; +#endif + + /// The time in seconds since the server started. + // via global NetworkClient snapshot interpolated timeline (if client). + // on server, this is simply Time.timeAsDouble. + // + // I measured the accuracy of float and I got this: + // for the same day, accuracy is better than 1 ms + // after 1 day, accuracy goes down to 7 ms + // after 10 days, accuracy is 61 ms + // after 30 days , accuracy is 238 ms + // after 60 days, accuracy is 454 ms + // in other words, if the server is running for 2 months, + // and you cast down to float, then the time will jump in 0.4s intervals. + public static double time + { + [MethodImpl(MethodImplOptions.AggressiveInlining)] + get => NetworkServer.active + ? localTime + : NetworkClient.localTimeline; + } + + // prediction ////////////////////////////////////////////////////////// + // NetworkTime.time is server time, behind by bufferTime. + // for prediction, we want server time, ahead by latency. + // so that client inputs at predictedTime=2 arrive on server at time=2. + // the more accurate this is, the more closesly will corrections be + // be applied and the less jitter we will see. + // + // we'll use a two step process to calculate predicted time: + // 1. move snapshot interpolated time to server time, without being behind by bufferTime + // 2. constantly send this time to server (included in ping message) + // server replies with how far off it was. + // client averages that offset and applies it to predictedTime to get ever closer. + // + // this is also very easy to test & verify: + // - add LatencySimulation with 50ms latency + // - log predictionError on server in OnServerPing, see if it gets closer to 0 + // + // credits: FakeByte, imer, NinjaKickja, mischa + // const because it's used immediately in _predictionError constructor. + + static int PredictionErrorWindowSize = 20; // average over 20 * 100ms = 2s + static ExponentialMovingAverage _predictionErrorUnadjusted = new ExponentialMovingAverage(PredictionErrorWindowSize); + public static double predictionErrorUnadjusted => _predictionErrorUnadjusted.Value; + public static double predictionErrorAdjusted { get; private set; } // for debugging + + /// Predicted timeline in order for client inputs to be timestamped with the exact time when they will most likely arrive on the server. This is the basis for all prediction like PredictedRigidbody. + // on client, this is based on localTime (aka Time.time) instead of the snapshot interpolated timeline. + // this gives much better and immediately accurate results. + // -> snapshot interpolation timeline tries to emulate a server timeline without hard offset corrections. + // -> predictedTime does have hard offset corrections, so might as well use Time.time directly for this. + // + // note that predictedTime over unreliable is enough! + // even with reliable components, it gives better results than if we were + // to implemented predictedTime over reliable channel. + public static double predictedTime + { + [MethodImpl(MethodImplOptions.AggressiveInlining)] + get => NetworkServer.active + ? localTime // server always uses it's own timeline + : localTime + predictionErrorUnadjusted; // add the offset that the server told us we are off by + } + //////////////////////////////////////////////////////////////////////// + + /// Clock difference in seconds between the client and the server. Always 0 on server. + // original implementation used 'client - server' time. keep it this way. + // TODO obsolete later. people shouldn't worry about this. + public static double offset => localTime - time; + + /// Round trip time (in seconds) that it takes a message to go client->server->client. + public static double rtt => _rtt.Value; + + /// Round trip time variance aka jitter, in seconds. + // "rttVariance" instead of "rttVar" for consistency with older versions. + public static double rttVariance => _rtt.Variance; + + // RuntimeInitializeOnLoadMethod -> fast playmode without domain reload + [RuntimeInitializeOnLoadMethod] + public static void ResetStatics() + { + PingInterval = DefaultPingInterval; + lastPingTime = 0; + _rtt = new ExponentialMovingAverage(PingWindowSize); +#if !UNITY_2020_3_OR_NEWER + stopwatch.Restart(); +#endif + } + + internal static void UpdateClient() + { + // localTime (double) instead of Time.time for accuracy over days + if (localTime >= lastPingTime + PingInterval) + SendPing(); + } + + // Separate method so we can call it from NetworkClient directly. + internal static void SendPing() + { + // send raw predicted time without the offset applied yet. + // we then apply the offset to it after. + NetworkPingMessage pingMessage = new NetworkPingMessage + ( + localTime, + predictedTime + ); + NetworkClient.Send(pingMessage, Channels.Unreliable); + lastPingTime = localTime; + } + + // client rtt calculation ////////////////////////////////////////////// + // executed at the server when we receive a ping message + // reply with a pong containing the time from the client + // and time from the server + internal static void OnServerPing(NetworkConnectionToClient conn, NetworkPingMessage message) + { + // calculate the prediction offset that the client needs to apply to unadjusted time to reach server time. + // this will be sent back to client for corrections. + double unadjustedError = localTime - message.localTime; + + // to see how well the client's final prediction worked, compare with adjusted time. + // this is purely for debugging. + // >0 means: server is ... seconds ahead of client's prediction (good if small) + // <0 means: server is ... seconds behind client's prediction. + // in other words, client is predicting too far ahead (not good) + double adjustedError = localTime - message.predictedTimeAdjusted; + // Debug.Log($"[Server] unadjustedError:{(unadjustedError*1000):F1}ms adjustedError:{(adjustedError*1000):F1}ms"); + + // Debug.Log($"OnServerPing conn:{conn}"); + NetworkPongMessage pongMessage = new NetworkPongMessage + ( + message.localTime, + unadjustedError, + adjustedError + ); + conn.Send(pongMessage, Channels.Unreliable); + } + + // Executed at the client when we receive a Pong message + // find out how long it took since we sent the Ping + // and update time offset & prediction offset. + internal static void OnClientPong(NetworkPongMessage message) + { + // prevent attackers from sending timestamps which are in the future + if (message.localTime > localTime) return; + + // how long did this message take to come back + double newRtt = localTime - message.localTime; + _rtt.Add(newRtt); + + // feed unadjusted prediction error into our exponential moving average + // store adjusted prediction error for debug / GUI purposes + _predictionErrorUnadjusted.Add(message.predictionErrorUnadjusted); + predictionErrorAdjusted = message.predictionErrorAdjusted; + // Debug.Log($"[Client] predictionError avg={(_predictionErrorUnadjusted.Value*1000):F1} ms"); + } + + // server rtt calculation ////////////////////////////////////////////// + // Executed at the client when we receive a ping message from the server. + // in other words, this is for server sided ping + rtt calculation. + // reply with a pong containing the time from the server + internal static void OnClientPing(NetworkPingMessage message) + { + // Debug.Log($"OnClientPing conn:{conn}"); + NetworkPongMessage pongMessage = new NetworkPongMessage + ( + message.localTime, + 0, 0 // server doesn't predict + ); + NetworkClient.Send(pongMessage, Channels.Unreliable); + } + + // Executed at the server when we receive a Pong message back. + // find out how long it took since we sent the Ping + // and update time offset + internal static void OnServerPong(NetworkConnectionToClient conn, NetworkPongMessage message) + { + // prevent attackers from sending timestamps which are in the future + if (message.localTime > localTime) return; + + // how long did this message take to come back + double newRtt = localTime - message.localTime; + conn._rtt.Add(newRtt); + } + + internal static void EarlyUpdate() + { +#if !UNITY_2020_3_OR_NEWER + localFrameTime = stopwatch.Elapsed.TotalSeconds; +#endif + } + } +} diff --git a/Assets/Mirror/Core/NetworkTime.cs.meta b/Assets/Mirror/Core/NetworkTime.cs.meta new file mode 100644 index 0000000..1dc9e0a --- /dev/null +++ b/Assets/Mirror/Core/NetworkTime.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 09a0c241fc4a5496dbf4a0ab6e9a312c +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/NetworkWriter.cs b/Assets/Mirror/Core/NetworkWriter.cs new file mode 100644 index 0000000..7ecf126 --- /dev/null +++ b/Assets/Mirror/Core/NetworkWriter.cs @@ -0,0 +1,249 @@ +using System; +using System.Runtime.CompilerServices; +using System.Text; +using Unity.Collections.LowLevel.Unsafe; +using UnityEngine; + +namespace Mirror +{ + /// Network Writer for most simple types like floats, ints, buffers, structs, etc. Use NetworkWriterPool.GetReader() to avoid allocations. + public class NetworkWriter + { + // the limit of ushort is so we can write string size prefix as only 2 bytes. + // -1 so we can still encode 'null' into it too. + public const ushort MaxStringLength = ushort.MaxValue - 1; + + // create writer immediately with it's own buffer so no one can mess with it and so that we can resize it. + // note: BinaryWriter allocates too much, so we only use a MemoryStream + // => 1500 bytes by default because on average, most packets will be <= MTU + public const int DefaultCapacity = 1500; + internal byte[] buffer = new byte[DefaultCapacity]; + + /// Next position to write to the buffer + public int Position; + + /// Current capacity. Automatically resized if necessary. + public int Capacity => buffer.Length; + + // cache encoding for WriteString instead of creating it each time. + // 1000 readers before: 1MB GC, 30ms + // 1000 readers after: 0.8MB GC, 18ms + // not(!) static for thread safety. + // + // throwOnInvalidBytes is true. + // writer should throw and user should fix if this ever happens. + // unlike reader, which needs to expect it to happen from attackers. + internal readonly UTF8Encoding encoding = new UTF8Encoding(false, true); + + /// Reset both the position and length of the stream + // Leaves the capacity the same so that we can reuse this writer without + // extra allocations + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void Reset() + { + Position = 0; + } + + // NOTE that our runtime resizing comes at no extra cost because: + // 1. 'has space' checks are necessary even for fixed sized writers. + // 2. all writers will eventually be large enough to stop resizing. + [MethodImpl(MethodImplOptions.AggressiveInlining)] + internal void EnsureCapacity(int value) + { + if (buffer.Length < value) + { + int capacity = Math.Max(value, buffer.Length * 2); + Array.Resize(ref buffer, capacity); + } + } + + /// Copies buffer until 'Position' to a new array. + // Try to use ToArraySegment instead to avoid allocations! + public byte[] ToArray() + { + byte[] data = new byte[Position]; + Array.ConstrainedCopy(buffer, 0, data, 0, Position); + return data; + } + + /// Returns allocation-free ArraySegment until 'Position'. + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public ArraySegment ToArraySegment() => + new ArraySegment(buffer, 0, Position); + + // implicit conversion for convenience + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static implicit operator ArraySegment(NetworkWriter w) => + w.ToArraySegment(); + + // WriteBlittable from DOTSNET. + // this is extremely fast, but only works for blittable types. + // + // Benchmark: + // WriteQuaternion x 100k, Macbook Pro 2015 @ 2.2Ghz, Unity 2018 LTS (debug mode) + // + // | Median | Min | Max | Avg | Std | (ms) + // before | 30.35 | 29.86 | 48.99 | 32.54 | 4.93 | + // blittable* | 5.69 | 5.52 | 27.51 | 7.78 | 5.65 | + // + // * without IsBlittable check + // => 4-6x faster! + // + // WriteQuaternion x 100k, Macbook Pro 2015 @ 2.2Ghz, Unity 2020.1 (release mode) + // + // | Median | Min | Max | Avg | Std | (ms) + // before | 9.41 | 8.90 | 23.02 | 10.72 | 3.07 | + // blittable* | 1.48 | 1.40 | 16.03 | 2.60 | 2.71 | + // + // * without IsBlittable check + // => 6x faster! + // + // Note: + // WriteBlittable assumes same endianness for server & client. + // All Unity 2018+ platforms are little endian. + // => run NetworkWriterTests.BlittableOnThisPlatform() to verify! + // + // This is not safe to expose to random structs. + // * StructLayout.Sequential is the default, which is safe. + // if the struct contains a reference type, it is converted to Auto. + // but since all structs here are unmanaged blittable, it's safe. + // see also: https://docs.microsoft.com/en-us/dotnet/api/system.runtime.interopservices.layoutkind?view=netframework-4.8#system-runtime-interopservices-layoutkind-sequential + // * StructLayout.Pack depends on CPU word size. + // this may be different 4 or 8 on some ARM systems, etc. + // this is not safe, and would cause bytes/shorts etc. to be padded. + // see also: https://docs.microsoft.com/en-us/dotnet/api/system.runtime.interopservices.structlayoutattribute.pack?view=net-6.0 + // * If we force pack all to '1', they would have no padding which is + // great for bandwidth. but on some android systems, CPU can't read + // unaligned memory. + // see also: https://github.com/vis2k/Mirror/issues/3044 + // * The only option would be to force explicit layout with multiples + // of word size. but this requires lots of weaver checking and is + // still questionable (IL2CPP etc.). + // + // Note: inlining WriteBlittable is enough. don't inline WriteInt etc. + // we don't want WriteBlittable to be copied in place everywhere. + internal unsafe void WriteBlittable(T value) + where T : unmanaged + { + // check if blittable for safety +#if UNITY_EDITOR + if (!UnsafeUtility.IsBlittable(typeof(T))) + { + Debug.LogError($"{typeof(T)} is not blittable!"); + return; + } +#endif + // calculate size + // sizeof(T) gets the managed size at compile time. + // Marshal.SizeOf gets the unmanaged size at runtime (slow). + // => our 1mio writes benchmark is 6x slower with Marshal.SizeOf + // => for blittable types, sizeof(T) is even recommended: + // https://docs.microsoft.com/en-us/dotnet/standard/native-interop/best-practices + int size = sizeof(T); + + // ensure capacity + // NOTE that our runtime resizing comes at no extra cost because: + // 1. 'has space' checks are necessary even for fixed sized writers. + // 2. all writers will eventually be large enough to stop resizing. + EnsureCapacity(Position + size); + + // write blittable + fixed (byte* ptr = &buffer[Position]) + { +#if UNITY_ANDROID + // on some android systems, assigning *(T*)ptr throws a NRE if + // the ptr isn't aligned (i.e. if Position is 1,2,3,5, etc.). + // here we have to use memcpy. + // + // => we can't get a pointer of a struct in C# without + // marshalling allocations + // => instead, we stack allocate an array of type T and use that + // => stackalloc avoids GC and is very fast. it only works for + // value types, but all blittable types are anyway. + // + // this way, we can still support blittable reads on android. + // see also: https://github.com/vis2k/Mirror/issues/3044 + // (solution discovered by AIIO, FakeByte, mischa) + T* valueBuffer = stackalloc T[1]{value}; + UnsafeUtility.MemCpy(ptr, valueBuffer, size); +#else + // cast buffer to T* pointer, then assign value to the area + *(T*)ptr = value; +#endif + } + Position += size; + } + + // blittable'?' template for code reuse + [MethodImpl(MethodImplOptions.AggressiveInlining)] + internal void WriteBlittableNullable(T? value) + where T : unmanaged + { + // bool isn't blittable. write as byte. + WriteByte((byte)(value.HasValue ? 0x01 : 0x00)); + + // only write value if exists. saves bandwidth. + if (value.HasValue) + WriteBlittable(value.Value); + } + + public void WriteByte(byte value) => WriteBlittable(value); + + // for byte arrays with consistent size, where the reader knows how many to read + // (like a packet opcode that's always the same) + public void WriteBytes(byte[] array, int offset, int count) + { + EnsureCapacity(Position + count); + Array.ConstrainedCopy(array, offset, this.buffer, Position, count); + Position += count; + } + // write an unsafe byte* array. + // useful for bit tree compression, etc. + public unsafe bool WriteBytes(byte* ptr, int offset, int size) + { + EnsureCapacity(Position + size); + + fixed (byte* destination = &buffer[Position]) + { + // write 'size' bytes at position + // 10 mio writes: 868ms + // Array.Copy(value.Array, value.Offset, buffer, Position, value.Count); + // 10 mio writes: 775ms + // Buffer.BlockCopy(value.Array, value.Offset, buffer, Position, value.Count); + // 10 mio writes: 637ms + UnsafeUtility.MemCpy(destination, ptr + offset, size); + } + + Position += size; + return true; + } + + /// Writes any type that mirror supports. Uses weaver populated Writer(T).write. + public void Write(T value) + { + Action writeDelegate = Writer.write; + if (writeDelegate == null) + { + Debug.LogError($"No writer found for {typeof(T)}. This happens either if you are missing a NetworkWriter extension for your custom type, or if weaving failed. Try to reimport a script to weave again."); + } + else + { + writeDelegate(this, value); + } + } + + // print with buffer content for easier debugging. + // [content, position / capacity]. + // showing "position / space" would be too confusing. + public override string ToString() => + $"[{ToArraySegment().ToHexString()} @ {Position}/{Capacity}]"; + } + + /// Helper class that weaver populates with all writer types. + // Note that c# creates a different static variable for each type + // -> Weaver.ReaderWriterProcessor.InitializeReaderAndWriters() populates it + public static class Writer + { + public static Action write; + } +} diff --git a/Assets/Mirror/Core/NetworkWriter.cs.meta b/Assets/Mirror/Core/NetworkWriter.cs.meta new file mode 100644 index 0000000..c938496 --- /dev/null +++ b/Assets/Mirror/Core/NetworkWriter.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 48d2207bcef1f4477b624725f075f9bd +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/NetworkWriterExtensions.cs b/Assets/Mirror/Core/NetworkWriterExtensions.cs new file mode 100644 index 0000000..fef9f61 --- /dev/null +++ b/Assets/Mirror/Core/NetworkWriterExtensions.cs @@ -0,0 +1,430 @@ +using System; +using System.Collections.Generic; +using UnityEngine; + +namespace Mirror +{ + // Mirror's Weaver automatically detects all NetworkWriter function types, + // but they do all need to be extensions. + public static class NetworkWriterExtensions + { + public static void WriteByte(this NetworkWriter writer, byte value) => writer.WriteBlittable(value); + public static void WriteByteNullable(this NetworkWriter writer, byte? value) => writer.WriteBlittableNullable(value); + + public static void WriteSByte(this NetworkWriter writer, sbyte value) => writer.WriteBlittable(value); + public static void WriteSByteNullable(this NetworkWriter writer, sbyte? value) => writer.WriteBlittableNullable(value); + + // char is not blittable. convert to ushort. + public static void WriteChar(this NetworkWriter writer, char value) => writer.WriteBlittable((ushort)value); + public static void WriteCharNullable(this NetworkWriter writer, char? value) => writer.WriteBlittableNullable((ushort?)value); + + // bool is not blittable. convert to byte. + public static void WriteBool(this NetworkWriter writer, bool value) => writer.WriteBlittable((byte)(value ? 1 : 0)); + public static void WriteBoolNullable(this NetworkWriter writer, bool? value) => writer.WriteBlittableNullable(value.HasValue ? ((byte)(value.Value ? 1 : 0)) : new byte?()); + + public static void WriteShort(this NetworkWriter writer, short value) => writer.WriteBlittable(value); + public static void WriteShortNullable(this NetworkWriter writer, short? value) => writer.WriteBlittableNullable(value); + + public static void WriteUShort(this NetworkWriter writer, ushort value) => writer.WriteBlittable(value); + public static void WriteUShortNullable(this NetworkWriter writer, ushort? value) => writer.WriteBlittableNullable(value); + + public static void WriteInt(this NetworkWriter writer, int value) => writer.WriteBlittable(value); + public static void WriteIntNullable(this NetworkWriter writer, int? value) => writer.WriteBlittableNullable(value); + + public static void WriteUInt(this NetworkWriter writer, uint value) => writer.WriteBlittable(value); + public static void WriteUIntNullable(this NetworkWriter writer, uint? value) => writer.WriteBlittableNullable(value); + + public static void WriteLong(this NetworkWriter writer, long value) => writer.WriteBlittable(value); + public static void WriteLongNullable(this NetworkWriter writer, long? value) => writer.WriteBlittableNullable(value); + + public static void WriteULong(this NetworkWriter writer, ulong value) => writer.WriteBlittable(value); + public static void WriteULongNullable(this NetworkWriter writer, ulong? value) => writer.WriteBlittableNullable(value); + + public static void WriteFloat(this NetworkWriter writer, float value) => writer.WriteBlittable(value); + public static void WriteFloatNullable(this NetworkWriter writer, float? value) => writer.WriteBlittableNullable(value); + + public static void WriteDouble(this NetworkWriter writer, double value) => writer.WriteBlittable(value); + public static void WriteDoubleNullable(this NetworkWriter writer, double? value) => writer.WriteBlittableNullable(value); + + public static void WriteDecimal(this NetworkWriter writer, decimal value) => writer.WriteBlittable(value); + public static void WriteDecimalNullable(this NetworkWriter writer, decimal? value) => writer.WriteBlittableNullable(value); + + public static void WriteString(this NetworkWriter writer, string value) + { + // write 0 for null support, increment real size by 1 + // (note: original HLAPI would write "" for null strings, but if a + // string is null on the server then it should also be null + // on the client) + if (value == null) + { + writer.WriteUShort(0); + return; + } + + // WriteString copies into the buffer manually. + // need to ensure capacity here first, manually. + int maxSize = writer.encoding.GetMaxByteCount(value.Length); + writer.EnsureCapacity(writer.Position + 2 + maxSize); // 2 bytes position + N bytes encoding + + // encode it into the buffer first. + // reserve 2 bytes for header after we know how much was written. + int written = writer.encoding.GetBytes(value, 0, value.Length, writer.buffer, writer.Position + 2); + + // check if within max size, otherwise Reader can't read it. + if (written > NetworkWriter.MaxStringLength) + throw new IndexOutOfRangeException($"NetworkWriter.WriteString - Value too long: {written} bytes. Limit: {NetworkWriter.MaxStringLength} bytes"); + + // .Position is unchanged, so fill in the size header now. + // we already ensured that max size fits into ushort.max-1. + writer.WriteUShort(checked((ushort)(written + 1))); // Position += 2 + + // now update position by what was written above + writer.Position += written; + } + + // Weaver needs a write function with just one byte[] parameter + // (we don't name it .Write(byte[]) because it's really a WriteBytesAndSize since we write size / null info too) + public static void WriteBytesAndSize(this NetworkWriter writer, byte[] buffer) + { + // buffer might be null, so we can't use .Length in that case + writer.WriteBytesAndSize(buffer, 0, buffer != null ? buffer.Length : 0); + } + + // for byte arrays with dynamic size, where the reader doesn't know how many will come + // (like an inventory with different items etc.) + public static void WriteBytesAndSize(this NetworkWriter writer, byte[] buffer, int offset, int count) + { + // null is supported because [SyncVar]s might be structs with null byte[] arrays + // write 0 for null array, increment normal size by 1 to save bandwidth + // (using size=-1 for null would limit max size to 32kb instead of 64kb) + if (buffer == null) + { + writer.WriteUInt(0u); + return; + } + writer.WriteUInt(checked((uint)count) + 1u); + writer.WriteBytes(buffer, offset, count); + } + + // writes ArraySegment of byte (most common type) and size header + public static void WriteArraySegmentAndSize(this NetworkWriter writer, ArraySegment segment) + { + writer.WriteBytesAndSize(segment.Array, segment.Offset, segment.Count); + } + + // writes ArraySegment of any type, and size header + public static void WriteArraySegment(this NetworkWriter writer, ArraySegment segment) + { + int length = segment.Count; + writer.WriteInt(length); + for (int i = 0; i < length; i++) + { + writer.Write(segment.Array[segment.Offset + i]); + } + } + + public static void WriteVector2(this NetworkWriter writer, Vector2 value) => writer.WriteBlittable(value); + public static void WriteVector2Nullable(this NetworkWriter writer, Vector2? value) => writer.WriteBlittableNullable(value); + + public static void WriteVector3(this NetworkWriter writer, Vector3 value) => writer.WriteBlittable(value); + public static void WriteVector3Nullable(this NetworkWriter writer, Vector3? value) => writer.WriteBlittableNullable(value); + + public static void WriteVector4(this NetworkWriter writer, Vector4 value) => writer.WriteBlittable(value); + public static void WriteVector4Nullable(this NetworkWriter writer, Vector4? value) => writer.WriteBlittableNullable(value); + + public static void WriteVector2Int(this NetworkWriter writer, Vector2Int value) => writer.WriteBlittable(value); + public static void WriteVector2IntNullable(this NetworkWriter writer, Vector2Int? value) => writer.WriteBlittableNullable(value); + + public static void WriteVector3Int(this NetworkWriter writer, Vector3Int value) => writer.WriteBlittable(value); + public static void WriteVector3IntNullable(this NetworkWriter writer, Vector3Int? value) => writer.WriteBlittableNullable(value); + + public static void WriteColor(this NetworkWriter writer, Color value) => writer.WriteBlittable(value); + public static void WriteColorNullable(this NetworkWriter writer, Color? value) => writer.WriteBlittableNullable(value); + + public static void WriteColor32(this NetworkWriter writer, Color32 value) => writer.WriteBlittable(value); + public static void WriteColor32Nullable(this NetworkWriter writer, Color32? value) => writer.WriteBlittableNullable(value); + + public static void WriteQuaternion(this NetworkWriter writer, Quaternion value) => writer.WriteBlittable(value); + public static void WriteQuaternionNullable(this NetworkWriter writer, Quaternion? value) => writer.WriteBlittableNullable(value); + + // Rect is a struct with properties instead of fields + public static void WriteRect(this NetworkWriter writer, Rect value) + { + writer.WriteVector2(value.position); + writer.WriteVector2(value.size); + } + public static void WriteRectNullable(this NetworkWriter writer, Rect? value) + { + writer.WriteBool(value.HasValue); + if (value.HasValue) + writer.WriteRect(value.Value); + } + + // Plane is a struct with properties instead of fields + public static void WritePlane(this NetworkWriter writer, Plane value) + { + writer.WriteVector3(value.normal); + writer.WriteFloat(value.distance); + } + public static void WritePlaneNullable(this NetworkWriter writer, Plane? value) + { + writer.WriteBool(value.HasValue); + if (value.HasValue) + writer.WritePlane(value.Value); + } + + // Ray is a struct with properties instead of fields + public static void WriteRay(this NetworkWriter writer, Ray value) + { + writer.WriteVector3(value.origin); + writer.WriteVector3(value.direction); + } + public static void WriteRayNullable(this NetworkWriter writer, Ray? value) + { + writer.WriteBool(value.HasValue); + if (value.HasValue) + writer.WriteRay(value.Value); + } + + // LayerMask is a struct with properties instead of fields + public static void WriteLayerMask(this NetworkWriter writer, LayerMask layerMask) + { + // 32 layers as a flags enum, max value of 496, we only need a UShort. + writer.WriteUShort((ushort)layerMask.value); + } + public static void WriteLayerMaskNullable(this NetworkWriter writer, LayerMask? layerMask) + { + writer.WriteBool(layerMask.HasValue); + if (layerMask.HasValue) + writer.WriteLayerMask(layerMask.Value); + } + + public static void WriteMatrix4x4(this NetworkWriter writer, Matrix4x4 value) => writer.WriteBlittable(value); + public static void WriteMatrix4x4Nullable(this NetworkWriter writer, Matrix4x4? value) => writer.WriteBlittableNullable(value); + + public static void WriteGuid(this NetworkWriter writer, Guid value) + { +#if !UNITY_2021_3_OR_NEWER + // Unity 2019 doesn't have Span yet + byte[] data = value.ToByteArray(); + writer.WriteBytes(data, 0, data.Length); +#else + // WriteBlittable(Guid) isn't safe. see WriteBlittable comments. + // Guid is Sequential, but we can't guarantee packing. + // TryWriteBytes is safe and allocation free. + writer.EnsureCapacity(writer.Position + 16); + value.TryWriteBytes(new Span(writer.buffer, writer.Position, 16)); + writer.Position += 16; +#endif + } + public static void WriteGuidNullable(this NetworkWriter writer, Guid? value) + { + writer.WriteBool(value.HasValue); + if (value.HasValue) + writer.WriteGuid(value.Value); + } + + public static void WriteNetworkIdentity(this NetworkWriter writer, NetworkIdentity value) + { + if (value == null) + { + writer.WriteUInt(0); + return; + } + + // users might try to use unspawned / prefab GameObjects in + // rpcs/cmds/syncvars/messages. they would be null on the other + // end, and it might not be obvious why. let's make it obvious. + // https://github.com/vis2k/Mirror/issues/2060 + // + // => warning (instead of exception) because we also use a warning + // if a GameObject doesn't have a NetworkIdentity component etc. + if (value.netId == 0) + Debug.LogWarning($"Attempted to serialize unspawned GameObject: {value.name}. Prefabs and unspawned GameObjects would always be null on the other side. Please spawn it before using it in [SyncVar]s/Rpcs/Cmds/NetworkMessages etc."); + + writer.WriteUInt(value.netId); + } + + public static void WriteNetworkBehaviour(this NetworkWriter writer, NetworkBehaviour value) + { + if (value == null) + { + writer.WriteUInt(0); + return; + } + + // users might try to use unspawned / prefab NetworkBehaviours in + // rpcs/cmds/syncvars/messages. they would be null on the other + // end, and it might not be obvious why. let's make it obvious. + // https://github.com/vis2k/Mirror/issues/2060 + // and more recently https://github.com/MirrorNetworking/Mirror/issues/3399 + // + // => warning (instead of exception) because we also use a warning + // when writing an unspawned NetworkIdentity + if (value.netId == 0) + { + Debug.LogWarning($"Attempted to serialize unspawned NetworkBehaviour: of type {value.GetType()} on GameObject {value.name}. Prefabs and unspawned GameObjects would always be null on the other side. Please spawn it before using it in [SyncVar]s/Rpcs/Cmds/NetworkMessages etc."); + writer.WriteUInt(0); + return; + } + + writer.WriteUInt(value.netId); + writer.WriteByte(value.ComponentIndex); + } + + public static void WriteTransform(this NetworkWriter writer, Transform value) + { + if (value == null) + { + writer.WriteUInt(0); + return; + } + if (value.TryGetComponent(out NetworkIdentity identity)) + { + writer.WriteUInt(identity.netId); + } + else + { + // if users attempt to pass a transform without NetworkIdentity + // to a [Command] or [SyncVar], it should show an obvious warning. + Debug.LogWarning($"Attempted to sync a Transform ({value}) which isn't networked. Transforms without a NetworkIdentity component can't be synced."); + writer.WriteUInt(0); + } + } + + public static void WriteGameObject(this NetworkWriter writer, GameObject value) + { + if (value == null) + { + writer.WriteUInt(0); + return; + } + + // warn if the GameObject doesn't have a NetworkIdentity, + if (!value.TryGetComponent(out NetworkIdentity identity)) + Debug.LogWarning($"Attempted to sync a GameObject ({value}) which isn't networked. GameObject without a NetworkIdentity component can't be synced."); + + // serialize the correct amount of data in any case to make sure + // that the other end can read the expected amount of data too. + writer.WriteNetworkIdentity(identity); + } + + // while SyncList is recommended for NetworkBehaviours, + // structs may have .List members which weaver needs to be able to + // fully serialize for NetworkMessages etc. + // note that Weaver/Writers/GenerateWriter() handles this manually. + public static void WriteList(this NetworkWriter writer, List list) + { + // 'null' is encoded as '-1' + if (list is null) + { + writer.WriteInt(-1); + return; + } + + // check if within max size, otherwise Reader can't read it. + if (list.Count > NetworkReader.AllocationLimit) + throw new IndexOutOfRangeException($"NetworkWriter.WriteList - List<{typeof(T)}> too big: {list.Count} elements. Limit: {NetworkReader.AllocationLimit}"); + + writer.WriteInt(list.Count); + for (int i = 0; i < list.Count; i++) + writer.Write(list[i]); + } + + // while SyncSet is recommended for NetworkBehaviours, + // structs may have .Set members which weaver needs to be able to + // fully serialize for NetworkMessages etc. + // note that Weaver/Writers/GenerateWriter() handles this manually. + // TODO writer not found. need to adjust weaver first. see tests. + /* + public static void WriteHashSet(this NetworkWriter writer, HashSet hashSet) + { + if (hashSet is null) + { + writer.WriteInt(-1); + return; + } + writer.WriteInt(hashSet.Count); + foreach (T item in hashSet) + writer.Write(item); + } + */ + + public static void WriteArray(this NetworkWriter writer, T[] array) + { + // 'null' is encoded as '-1' + if (array is null) + { + writer.WriteInt(-1); + return; + } + + // check if within max size, otherwise Reader can't read it. + if (array.Length > NetworkReader.AllocationLimit) + throw new IndexOutOfRangeException($"NetworkWriter.WriteArray - Array<{typeof(T)}> too big: {array.Length} elements. Limit: {NetworkReader.AllocationLimit}"); + + writer.WriteInt(array.Length); + for (int i = 0; i < array.Length; i++) + writer.Write(array[i]); + } + + public static void WriteUri(this NetworkWriter writer, Uri uri) + { + writer.WriteString(uri?.ToString()); + } + + public static void WriteTexture2D(this NetworkWriter writer, Texture2D texture2D) + { + // TODO allocation protection when sending textures to server. + // currently can allocate 32k x 32k x 4 byte = 3.8 GB + + // support 'null' textures for [SyncVar]s etc. + // https://github.com/vis2k/Mirror/issues/3144 + // simply send -1 for width. + if (texture2D == null) + { + writer.WriteShort(-1); + return; + } + + // check if within max size, otherwise Reader can't read it. + int totalSize = texture2D.width * texture2D.height; + if (totalSize > NetworkReader.AllocationLimit) + throw new IndexOutOfRangeException($"NetworkWriter.WriteTexture2D - Texture2D total size (width*height) too big: {totalSize}. Limit: {NetworkReader.AllocationLimit}"); + + // write dimensions first so reader can create the texture with size + // 32k x 32k short is more than enough + writer.WriteShort((short)texture2D.width); + writer.WriteShort((short)texture2D.height); + writer.WriteArray(texture2D.GetPixels32()); + } + + public static void WriteSprite(this NetworkWriter writer, Sprite sprite) + { + // support 'null' textures for [SyncVar]s etc. + // https://github.com/vis2k/Mirror/issues/3144 + // simply send a 'null' for texture content. + if (sprite == null) + { + writer.WriteTexture2D(null); + return; + } + + writer.WriteTexture2D(sprite.texture); + writer.WriteRect(sprite.rect); + writer.WriteVector2(sprite.pivot); + } + + public static void WriteDateTime(this NetworkWriter writer, DateTime dateTime) + { + writer.WriteDouble(dateTime.ToOADate()); + } + + public static void WriteDateTimeNullable(this NetworkWriter writer, DateTime? dateTime) + { + writer.WriteBool(dateTime.HasValue); + if (dateTime.HasValue) + writer.WriteDouble(dateTime.Value.ToOADate()); + } + } +} diff --git a/Assets/Mirror/Core/NetworkWriterExtensions.cs.meta b/Assets/Mirror/Core/NetworkWriterExtensions.cs.meta new file mode 100644 index 0000000..9bbdaf0 --- /dev/null +++ b/Assets/Mirror/Core/NetworkWriterExtensions.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 94259792df2a404892c3e2377f58d0cb +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/NetworkWriterPool.cs b/Assets/Mirror/Core/NetworkWriterPool.cs new file mode 100644 index 0000000..5eefa2a --- /dev/null +++ b/Assets/Mirror/Core/NetworkWriterPool.cs @@ -0,0 +1,37 @@ +// API consistent with Microsoft's ObjectPool. +using System.Runtime.CompilerServices; + +namespace Mirror +{ + /// Pool of NetworkWriters to avoid allocations. + public static class NetworkWriterPool + { + // reuse Pool + // we still wrap it in NetworkWriterPool.Get/Recycle so we can reset the + // position before reusing. + // this is also more consistent with NetworkReaderPool where we need to + // assign the internal buffer before reusing. + static readonly Pool Pool = new Pool( + () => new NetworkWriterPooled(), + // initial capacity to avoid allocations in the first few frames + // 1000 * 1200 bytes = around 1 MB. + 1000 + ); + + /// Get a writer from the pool. Creates new one if pool is empty. + public static NetworkWriterPooled Get() + { + // grab from pool & reset position + NetworkWriterPooled writer = Pool.Get(); + writer.Reset(); + return writer; + } + + /// Return a writer to the pool. + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static void Return(NetworkWriterPooled writer) + { + Pool.Return(writer); + } + } +} diff --git a/Assets/Mirror/Core/NetworkWriterPool.cs.meta b/Assets/Mirror/Core/NetworkWriterPool.cs.meta new file mode 100644 index 0000000..19d2bb7 --- /dev/null +++ b/Assets/Mirror/Core/NetworkWriterPool.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 3f34b53bea38e4f259eb8dc211e4fdb6 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/NetworkWriterPooled.cs b/Assets/Mirror/Core/NetworkWriterPooled.cs new file mode 100644 index 0000000..5ac371d --- /dev/null +++ b/Assets/Mirror/Core/NetworkWriterPooled.cs @@ -0,0 +1,13 @@ +// "NetworkWriterPooled" instead of "PooledNetworkWriter" to group files, for +// easier IDE workflow and more elegant code. +using System; + +namespace Mirror +{ + /// Pooled NetworkWriter, automatically returned to pool when using 'using' + // TODO make sealed again after removing obsolete NetworkWriterPooled! + public class NetworkWriterPooled : NetworkWriter, IDisposable + { + public void Dispose() => NetworkWriterPool.Return(this); + } +} diff --git a/Assets/Mirror/Core/NetworkWriterPooled.cs.meta b/Assets/Mirror/Core/NetworkWriterPooled.cs.meta new file mode 100644 index 0000000..5571d6f --- /dev/null +++ b/Assets/Mirror/Core/NetworkWriterPooled.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: a9fab936bf3c4716a452d94ad5ecbebe +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/PortTransport.cs b/Assets/Mirror/Core/PortTransport.cs new file mode 100644 index 0000000..19a7dfd --- /dev/null +++ b/Assets/Mirror/Core/PortTransport.cs @@ -0,0 +1,13 @@ +// convenience interface for transports which use a port. +// useful for cases where someone wants to 'just set the port' independent of +// which transport it is. +// +// note that not all transports have ports, but most do. + +namespace Mirror +{ + public interface PortTransport + { + ushort Port { get; set; } + } +} diff --git a/Assets/Mirror/Core/PortTransport.cs.meta b/Assets/Mirror/Core/PortTransport.cs.meta new file mode 100644 index 0000000..3f96d30 --- /dev/null +++ b/Assets/Mirror/Core/PortTransport.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: f7c7c2820d7974cb28c7bfe9aae890a0 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/Prediction.meta b/Assets/Mirror/Core/Prediction.meta new file mode 100644 index 0000000..83fb83b --- /dev/null +++ b/Assets/Mirror/Core/Prediction.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: 7e8e801f9c7f4b858d9a6c162e64ca84 +timeCreated: 1694005962 \ No newline at end of file diff --git a/Assets/Mirror/Core/Prediction/Prediction.cs b/Assets/Mirror/Core/Prediction/Prediction.cs new file mode 100644 index 0000000..55204f5 --- /dev/null +++ b/Assets/Mirror/Core/Prediction/Prediction.cs @@ -0,0 +1,176 @@ +// standalone, easy to test algorithms for prediction +using System.Collections.Generic; +using UnityEngine; + +namespace Mirror +{ + // prediction may capture Rigidbody3D/2D/etc. state + // have a common interface. + public interface PredictedState + { + double timestamp { get; } + + // use Vector3 for both Rigidbody3D and Rigidbody2D, that's fine + Vector3 position { get; set; } + Vector3 positionDelta { get; set; } + + Quaternion rotation { get; set; } + Quaternion rotationDelta { get; set; } + + Vector3 velocity { get; set; } + Vector3 velocityDelta { get; set; } + + Vector3 angularVelocity { get; set; } + Vector3 angularVelocityDelta { get; set; } + } + + public static class Prediction + { + // get the two states closest to a given timestamp. + // those can be used to interpolate the exact state at that time. + public static bool Sample( + SortedList history, + double timestamp, // current server time + out T before, + out T after, + out int afterIndex, + out double t) // interpolation factor + { + before = default; + after = default; + t = 0; + afterIndex = -1; + + // can't sample an empty history + // interpolation needs at least two entries. + // can't Lerp(A, A, 1.5). dist(A, A) * 1.5 is always 0. + if (history.Count < 2) { + return false; + } + + // older than oldest + if (timestamp < history.Keys[0]) { + return false; + } + + // iterate through the history + // TODO this needs to be faster than O(N) + // search around that area. + // should be O(1) most of the time, unless sampling was off. + int index = 0; // manually count when iterating. easier than for-int loop. + KeyValuePair prev = new KeyValuePair(); + foreach (KeyValuePair entry in history) { + // exact match? + if (timestamp == entry.Key) + { + before = entry.Value; + after = entry.Value; + afterIndex = index; + t = Mathd.InverseLerp(entry.Key, entry.Key, timestamp); + return true; + } + + // did we check beyond timestamp? then return the previous two. + if (entry.Key > timestamp) + { + before = prev.Value; + after = entry.Value; + afterIndex = index; + t = Mathd.InverseLerp(prev.Key, entry.Key, timestamp); + return true; + } + + // remember the last + prev = entry; + index += 1; + } + + return false; + } + + // inserts a server state into the client's history. + // readjust the deltas of the states after the inserted one. + // returns the corrected final position. + public static T CorrectHistory( + SortedList stateHistory, + int stateHistoryLimit, + T corrected, // corrected state with timestamp + T before, // state in history before the correction + T after, // state in history after the correction + int afterIndex) // index of the 'after' value so we don't need to find it again here + where T: PredictedState + { + // respect the limit + // TODO unit test to check if it respects max size + if (stateHistory.Count >= stateHistoryLimit) + stateHistory.RemoveAt(0); + + // insert the corrected state into the history, or overwrite if already exists + stateHistory[corrected.timestamp] = corrected; + + // the entry behind the inserted one still has the delta from (before, after). + // we need to correct it to (corrected, after). + // + // for example: + // before: (t=1.0, delta=10, position=10) + // after: (t=3.0, delta=20, position=30) + // + // then we insert: + // corrected: (t=2.5, delta=__, position=25) + // + // previous delta was from t=1.0 to t=3.0 => 2.0 + // inserted delta is from t=2.5 to t=3.0 => 0.5 + // multiplier is 0.5 / 2.0 = 0.25 + // multiply 'after.delta(20)' by 0.25 to get the new 'after.delta(5) + // + // so the new history is: + // before: (t=1.0, delta=10, position=10) + // corrected: (t=2.5, delta=__, position=25) + // after: (t=3.0, delta= 5, position=__) + // + // so when we apply the correction, the new after.position would be: + // corrected.position(25) + after.delta(5) = 30 + // + double previousDeltaTime = after.timestamp - before.timestamp; // 3.0 - 1.0 = 2.0 + double correctedDeltaTime = after.timestamp - corrected.timestamp; // 3.0 - 2.5 = 0.5 + + // fix multiplier becoming NaN if previousDeltaTime is 0: + // double multiplier = correctedDeltaTime / previousDeltaTime; + double multiplier = previousDeltaTime != 0 ? correctedDeltaTime / previousDeltaTime : 0; // 0.5 / 2.0 = 0.25 + + // recalculate 'after.delta' with the multiplier + after.positionDelta = Vector3.Lerp(Vector3.zero, after.positionDelta, (float)multiplier); + after.velocityDelta = Vector3.Lerp(Vector3.zero, after.velocityDelta, (float)multiplier); + after.angularVelocityDelta = Vector3.Lerp(Vector3.zero, after.angularVelocityDelta, (float)multiplier); + // Quaternions always need to be normalized in order to be a valid rotation after operations + after.rotationDelta = Quaternion.Slerp(Quaternion.identity, after.rotationDelta, (float)multiplier).normalized; + + // changes aren't saved until we overwrite them in the history + stateHistory[after.timestamp] = after; + + // second step: readjust all absolute values by rewinding client's delta moves on top of it. + T last = corrected; + for (int i = afterIndex; i < stateHistory.Count; ++i) + { + double key = stateHistory.Keys[i]; + T entry = stateHistory.Values[i]; + + // correct absolute position based on last + delta. + entry.position = last.position + entry.positionDelta; + entry.velocity = last.velocity + entry.velocityDelta; + entry.angularVelocity = last.angularVelocity + entry.angularVelocityDelta; + // Quaternions always need to be normalized in order to be a valid rotation after operations + entry.rotation = (entry.rotationDelta * last.rotation).normalized; // quaternions add delta by multiplying in this order + + // save the corrected entry into history. + stateHistory[key] = entry; + + // save last + last = entry; + } + + // third step: return the final recomputed state. + return last; + } + } +} diff --git a/Assets/Mirror/Core/Prediction/Prediction.cs.meta b/Assets/Mirror/Core/Prediction/Prediction.cs.meta new file mode 100644 index 0000000..196bd46 --- /dev/null +++ b/Assets/Mirror/Core/Prediction/Prediction.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 216d494d910445ea8a7acc7c889212d5 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/RemoteCalls.cs b/Assets/Mirror/Core/RemoteCalls.cs new file mode 100644 index 0000000..5dbe52f --- /dev/null +++ b/Assets/Mirror/Core/RemoteCalls.cs @@ -0,0 +1,151 @@ +using System; +using System.Collections.Generic; +using UnityEngine; + +namespace Mirror.RemoteCalls +{ + // invoke type for Cmd/Rpc + public enum RemoteCallType { Command, ClientRpc } + + // remote call function delegate + public delegate void RemoteCallDelegate(NetworkBehaviour obj, NetworkReader reader, NetworkConnectionToClient senderConnection); + + class Invoker + { + // GameObjects might have multiple components of TypeA.CommandA(). + // when invoking, we check if 'TypeA' is an instance of the type. + // the hash itself isn't enough because we wouldn't know which component + // to invoke it on if there are multiple of the same type. + public Type componentType; + public RemoteCallType callType; + public RemoteCallDelegate function; + public bool cmdRequiresAuthority; + + public bool AreEqual(Type componentType, RemoteCallType remoteCallType, RemoteCallDelegate invokeFunction) => + this.componentType == componentType && + this.callType == remoteCallType && + this.function == invokeFunction; + } + + /// Used to help manage remote calls for NetworkBehaviours + public static class RemoteProcedureCalls + { + public const string InvokeRpcPrefix = "InvokeUserCode_"; + + // one lookup for all remote calls. + // allows us to easily add more remote call types without duplicating code. + // note: do not clear those with [RuntimeInitializeOnLoad] + // + // IMPORTANT: cmd/rpc functions are identified via **HASHES**. + // an index would requires half the bandwidth, but introduces issues + // where static constructors are lazily called, so index order isn't + // guaranteed. keep hashes to avoid: + // https://github.com/vis2k/Mirror/pull/3135 + // https://github.com/vis2k/Mirror/issues/3138 + // BUT: 2 byte hash is enough if we check for collisions. that's what we + // do for NetworkMessage as well. + static readonly Dictionary remoteCallDelegates = new Dictionary(); + + static bool CheckIfDelegateExists(Type componentType, RemoteCallType remoteCallType, RemoteCallDelegate func, ushort functionHash) + { + if (remoteCallDelegates.ContainsKey(functionHash)) + { + // something already registered this hash. + // it's okay if it was the same function. + Invoker oldInvoker = remoteCallDelegates[functionHash]; + if (oldInvoker.AreEqual(componentType, remoteCallType, func)) + { + return true; + } + + // otherwise notify user. there is a rare chance of string + // hash collisions. + Debug.LogError($"Function {oldInvoker.componentType}.{oldInvoker.function.GetMethodName()} and {componentType}.{func.GetMethodName()} have the same hash. Please rename one of them. To save bandwidth, we only use 2 bytes for the hash, which has a small chance of collisions."); + } + + return false; + } + + // pass full function name to avoid ClassA.Func & ClassB.Func collisions + internal static ushort RegisterDelegate(Type componentType, string functionFullName, RemoteCallType remoteCallType, RemoteCallDelegate func, bool cmdRequiresAuthority = true) + { + // type+func so Inventory.RpcUse != Equipment.RpcUse + ushort hash = (ushort)(functionFullName.GetStableHashCode() & 0xFFFF); + + if (CheckIfDelegateExists(componentType, remoteCallType, func, hash)) + return hash; + + remoteCallDelegates[hash] = new Invoker + { + callType = remoteCallType, + componentType = componentType, + function = func, + cmdRequiresAuthority = cmdRequiresAuthority + }; + return hash; + } + + // pass full function name to avoid ClassA.Func <-> ClassB.Func collisions + // need to pass componentType to support invoking on GameObjects with + // multiple components of same type with same remote call. + public static void RegisterCommand(Type componentType, string functionFullName, RemoteCallDelegate func, bool requiresAuthority) => + RegisterDelegate(componentType, functionFullName, RemoteCallType.Command, func, requiresAuthority); + + // pass full function name to avoid ClassA.Func <-> ClassB.Func collisions + // need to pass componentType to support invoking on GameObjects with + // multiple components of same type with same remote call. + public static void RegisterRpc(Type componentType, string functionFullName, RemoteCallDelegate func) => + RegisterDelegate(componentType, functionFullName, RemoteCallType.ClientRpc, func); + + // to clean up tests + internal static void RemoveDelegate(ushort hash) => + remoteCallDelegates.Remove(hash); + + internal static bool GetFunctionMethodName(ushort functionHash, out string methodName) + { + if (remoteCallDelegates.TryGetValue(functionHash, out Invoker invoker)) + { + methodName = invoker.function.GetMethodName().Replace(InvokeRpcPrefix, ""); + return true; + } + methodName = ""; + return false; + } + + // note: no need to throw an error if not found. + // an attacker might just try to call a cmd with an rpc's hash etc. + // returning false is enough. + static bool GetInvokerForHash(ushort functionHash, RemoteCallType remoteCallType, out Invoker invoker) => + remoteCallDelegates.TryGetValue(functionHash, out invoker) && + invoker != null && + invoker.callType == remoteCallType; + + // InvokeCmd/Rpc Delegate can all use the same function here + internal static bool Invoke(ushort functionHash, RemoteCallType remoteCallType, NetworkReader reader, NetworkBehaviour component, NetworkConnectionToClient senderConnection = null) + { + // IMPORTANT: we check if the message's componentIndex component is + // actually of the right type. prevents attackers trying + // to invoke remote calls on wrong components. + if (GetInvokerForHash(functionHash, remoteCallType, out Invoker invoker) && + invoker.componentType.IsInstanceOfType(component)) + { + // invoke function on this component + invoker.function(component, reader, senderConnection); + return true; + } + return false; + } + + // check if the command 'requiresAuthority' which is set in the attribute + internal static bool CommandRequiresAuthority(ushort cmdHash) => + GetInvokerForHash(cmdHash, RemoteCallType.Command, out Invoker invoker) && + invoker.cmdRequiresAuthority; + + /// Gets the handler function by hash. Useful for profilers and debuggers. + public static RemoteCallDelegate GetDelegate(ushort functionHash) => + remoteCallDelegates.TryGetValue(functionHash, out Invoker invoker) + ? invoker.function + : null; + } +} + diff --git a/Assets/Mirror/Core/RemoteCalls.cs.meta b/Assets/Mirror/Core/RemoteCalls.cs.meta new file mode 100644 index 0000000..62b3288 --- /dev/null +++ b/Assets/Mirror/Core/RemoteCalls.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: d2cdbcbd1e377d6408a91acbec31ba16 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/SnapshotInterpolation.meta b/Assets/Mirror/Core/SnapshotInterpolation.meta new file mode 100644 index 0000000..85ac9a9 --- /dev/null +++ b/Assets/Mirror/Core/SnapshotInterpolation.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: 4468e736f87964eaebb9d55fc3e132f7 +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/SnapshotInterpolation/Snapshot.cs b/Assets/Mirror/Core/SnapshotInterpolation/Snapshot.cs new file mode 100644 index 0000000..6b8ba8a --- /dev/null +++ b/Assets/Mirror/Core/SnapshotInterpolation/Snapshot.cs @@ -0,0 +1,17 @@ +// Snapshot interface so we can reuse it for all kinds of systems. +// for example, NetworkTransform, NetworkRigidbody, CharacterController etc. +// NOTE: we use '' and 'where T : Snapshot' to avoid boxing. +// List would cause allocations through boxing. +namespace Mirror +{ + public interface Snapshot + { + // the remote timestamp (when it was sent by the remote) + double remoteTime { get; set; } + + // the local timestamp (when it was received on our end) + // technically not needed for basic snapshot interpolation. + // only for dynamic buffer time adjustment. + double localTime { get; set; } + } +} diff --git a/Assets/Mirror/Core/SnapshotInterpolation/Snapshot.cs.meta b/Assets/Mirror/Core/SnapshotInterpolation/Snapshot.cs.meta new file mode 100644 index 0000000..24eedd7 --- /dev/null +++ b/Assets/Mirror/Core/SnapshotInterpolation/Snapshot.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 12afea28fdb94154868a0a3b7a9df55b +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/SnapshotInterpolation/SnapshotInterpolation.cs b/Assets/Mirror/Core/SnapshotInterpolation/SnapshotInterpolation.cs new file mode 100644 index 0000000..2d1a2fc --- /dev/null +++ b/Assets/Mirror/Core/SnapshotInterpolation/SnapshotInterpolation.cs @@ -0,0 +1,390 @@ +// snapshot interpolation V2 by mischa +// +// Unity independent to be engine agnostic & easy to test. +// boxing: in C#, uses does not box! passing the interface would box! +// +// credits: +// glenn fiedler: https://gafferongames.com/post/snapshot_interpolation/ +// fholm: netcode streams +// fakebyte: standard deviation for dynamic adjustment +// ninjakicka: math & debugging +using System.Collections.Generic; +using System.Runtime.CompilerServices; + +namespace Mirror +{ + public static class SortedListExtensions + { + // removes the first 'amount' elements from the sorted list + public static void RemoveRange(this SortedList list, int amount) + { + // remove the first element 'amount' times. + // handles -1 and > count safely. + for (int i = 0; i < amount && i < list.Count; ++i) + list.RemoveAt(0); + } + } + + public static class SnapshotInterpolation + { + // calculate timescale for catch-up / slow-down + // note that negative threshold should be <0. + // caller should verify (i.e. Unity OnValidate). + // improves branch prediction. + public static double Timescale( + double drift, // how far we are off from bufferTime + double catchupSpeed, // in % [0,1] + double slowdownSpeed, // in % [0,1] + double absoluteCatchupNegativeThreshold, // in seconds (careful, we may run out of snapshots) + double absoluteCatchupPositiveThreshold) // in seconds + { + // if the drift time is too large, it means we are behind more time. + // so we need to speed up the timescale. + // note the threshold should be sendInterval * catchupThreshold. + if (drift > absoluteCatchupPositiveThreshold) + { + // localTimeline += 0.001; // too simple, this would ping pong + return 1 + catchupSpeed; // n% faster + } + + // if the drift time is too small, it means we are ahead of time. + // so we need to slow down the timescale. + // note the threshold should be sendInterval * catchupThreshold. + if (drift < absoluteCatchupNegativeThreshold) + { + // localTimeline -= 0.001; // too simple, this would ping pong + return 1 - slowdownSpeed; // n% slower + } + + // keep constant timescale while within threshold. + // this way we have perfectly smooth speed most of the time. + return 1; + } + + // calculate dynamic buffer time adjustment + public static double DynamicAdjustment( + double sendInterval, + double jitterStandardDeviation, + double dynamicAdjustmentTolerance) + { + // jitter is equal to delivery time standard variation. + // delivery time is made up of 'sendInterval+jitter'. + // .Average would be dampened by the constant sendInterval + // .StandardDeviation is the changes in 'jitter' that we want + // so add it to send interval again. + double intervalWithJitter = sendInterval + jitterStandardDeviation; + + // how many multiples of sendInterval is that? + // we want to convert to bufferTimeMultiplier later. + double multiples = intervalWithJitter / sendInterval; + + // add the tolerance + double safezone = multiples + dynamicAdjustmentTolerance; + // UnityEngine.Debug.Log($"sendInterval={sendInterval:F3} jitter std={jitterStandardDeviation:F3} => that is ~{multiples:F1} x sendInterval + {dynamicAdjustmentTolerance} => dynamic bufferTimeMultiplier={safezone}"); + return safezone; + } + + // helper function to insert a snapshot if it doesn't exist yet. + // extra function so we can use it for both cases: + // NetworkClient global timeline insertions & adjustments via Insert. + // NetworkBehaviour local insertion without any time adjustments. + public static bool InsertIfNotExists( + SortedList buffer, // snapshot buffer + int bufferLimit, // don't grow infinitely + T snapshot) // the newly received snapshot + where T : Snapshot + { + // slow clients may not be able to process incoming snapshots fast enough. + // infinitely growing snapshots would make it even worse. + // for example, run NetworkRigidbodyBenchmark while deep profiling client. + // the client just grows and reallocates the buffer forever. + if (buffer.Count >= bufferLimit) return false; + + // SortedList does not allow duplicates. + // we don't need to check ContainsKey (which is expensive). + // simply add and compare count before/after for the return value. + + //if (buffer.ContainsKey(snapshot.remoteTime)) return false; // too expensive + // buffer.Add(snapshot.remoteTime, snapshot); // throws if key exists + + int before = buffer.Count; + buffer[snapshot.remoteTime] = snapshot; // overwrites if key exists + return buffer.Count > before; + } + + // clamp timeline for cases where it gets too far behind. + // for example, a client app may go into the background and get updated + // with 1hz for a while. by the time it's back it's at least 30 frames + // behind, possibly more if the transport also queues up. In this + // scenario, at 1% catch up it took around 20+ seconds to finally catch + // up. For these kinds of scenarios it will be better to snap / clamp. + // + // to reproduce, try snapshot interpolation demo and press the button to + // simulate the client timeline at multiple seconds behind. it'll take + // a long time to catch up if the timeline is a long time behind. + public static double TimelineClamp( + double localTimeline, + double bufferTime, + double latestRemoteTime) + { + // we want local timeline to always be 'bufferTime' behind remote. + double targetTime = latestRemoteTime - bufferTime; + + // we define a boundary of 'bufferTime' around the target time. + // this is where catchup / slowdown will happen. + // outside of the area, we clamp. + double lowerBound = targetTime - bufferTime; // how far behind we can get + double upperBound = targetTime + bufferTime; // how far ahead we can get + return Mathd.Clamp(localTimeline, lowerBound, upperBound); + } + + // call this for every received snapshot. + // adds / inserts it to the list & initializes local time if needed. + public static void InsertAndAdjust( + SortedList buffer, // snapshot buffer + int bufferLimit, // don't grow infinitely + T snapshot, // the newly received snapshot + ref double localTimeline, // local interpolation time based on server time + ref double localTimescale, // timeline multiplier to apply catchup / slowdown over time + float sendInterval, // for debugging + double bufferTime, // offset for buffering + double catchupSpeed, // in % [0,1] + double slowdownSpeed, // in % [0,1] + ref ExponentialMovingAverage driftEma, // for catchup / slowdown + float catchupNegativeThreshold, // in % of sendInteral (careful, we may run out of snapshots) + float catchupPositiveThreshold, // in % of sendInterval + ref ExponentialMovingAverage deliveryTimeEma) // for dynamic buffer time adjustment + where T : Snapshot + { + // first snapshot? + // initialize local timeline. + // we want it to be behind by 'offset'. + // + // note that the first snapshot may be a lagging packet. + // so we would always be behind by that lag. + // this requires catchup later. + if (buffer.Count == 0) + localTimeline = snapshot.remoteTime - bufferTime; + + // insert into the buffer. + // + // note that we might insert it between our current interpolation + // which is fine, it adds another data point for accuracy. + // + // note that insert may be called twice for the same key. + // by default, this would throw. + // need to handle it silently. + if (InsertIfNotExists(buffer, bufferLimit, snapshot)) + { + // dynamic buffer adjustment needs delivery interval jitter + if (buffer.Count >= 2) + { + // note that this is not entirely accurate for scrambled inserts. + // + // we always use the last two, not what we just inserted + // even if we were to use the diff for what we just inserted, + // a scrambled insert would still not be 100% accurate: + // => assume a buffer of AC, with delivery time C-A + // => we then insert B, with delivery time B-A + // => but then technically the first C-A wasn't correct, + // as it would have to be C-B + // + // in practice, scramble is rare and won't make much difference + double previousLocalTime = buffer.Values[buffer.Count - 2].localTime; + double lastestLocalTime = buffer.Values[buffer.Count - 1].localTime; + + // this is the delivery time since last snapshot + double localDeliveryTime = lastestLocalTime - previousLocalTime; + + // feed the local delivery time to the EMA. + // this is what the original stream did too. + // our final dynamic buffer adjustment is different though. + // we use standard deviation instead of average. + deliveryTimeEma.Add(localDeliveryTime); + } + + // adjust timescale to catch up / slow down after each insertion + // because that is when we add new values to our EMA. + + // we want localTimeline to be about 'bufferTime' behind. + // for that, we need the delivery time EMA. + // snapshots may arrive out of order, we can not use last-timeline. + // we need to use the inserted snapshot's time - timeline. + double latestRemoteTime = snapshot.remoteTime; + + // ensure timeline stays within a reasonable bound behind/ahead. + localTimeline = TimelineClamp(localTimeline, bufferTime, latestRemoteTime); + + // calculate timediff after localTimeline override changes + double timeDiff = latestRemoteTime - localTimeline; + + // next, calculate average of a few seconds worth of timediffs. + // this gives smoother results. + // + // to calculate the average, we could simply loop through the + // last 'n' seconds worth of timediffs, but: + // - our buffer may only store a few snapshots (bufferTime) + // - looping through seconds worth of snapshots every time is + // expensive + // + // to solve this, we use an exponential moving average. + // https://en.wikipedia.org/wiki/Moving_average#Exponential_moving_average + // which is basically fancy math to do the same but faster. + // additionally, it allows us to look at more timeDiff values + // than we sould have access to in our buffer :) + driftEma.Add(timeDiff); + + // timescale depends on driftEma. + // driftEma only changes when inserting. + // therefore timescale only needs to be calculated when inserting. + // saves CPU cycles in Update. + + // next up, calculate how far we are currently away from bufferTime + double drift = driftEma.Value - bufferTime; + + // convert relative thresholds to absolute values based on sendInterval + double absoluteNegativeThreshold = sendInterval * catchupNegativeThreshold; + double absolutePositiveThreshold = sendInterval * catchupPositiveThreshold; + + // next, set localTimescale to catchup consistently in Update(). + // we quantize between default/catchup/slowdown, + // this way we have 'default' speed most of the time(!). + // and only catch up / slow down for a little bit occasionally. + // a consistent multiplier would never be exactly 1.0. + localTimescale = Timescale(drift, catchupSpeed, slowdownSpeed, absoluteNegativeThreshold, absolutePositiveThreshold); + + // debug logging + // UnityEngine.Debug.Log($"sendInterval={sendInterval:F3} bufferTime={bufferTime:F3} drift={drift:F3} driftEma={driftEma.Value:F3} timescale={localTimescale:F3} deliveryIntervalEma={deliveryTimeEma.Value:F3}"); + } + } + + // sample snapshot buffer to find the pair around the given time. + // returns indices so we can use it with RemoveRange to clear old snaps. + // make sure to use use buffer.Values[from/to], not buffer[from/to]. + // make sure to only call this is we have > 0 snapshots. + public static void Sample( + SortedList buffer, // snapshot buffer + double localTimeline, // local interpolation time based on server time + out int from, // the snapshot <= time + out int to, // the snapshot >= time + out double t) // interpolation factor + where T : Snapshot + { + from = -1; + to = -1; + t = 0; + + // sample from [0,count-1] so we always have two at 'i' and 'i+1'. + for (int i = 0; i < buffer.Count - 1; ++i) + { + // is local time between these two? + T first = buffer.Values[i]; + T second = buffer.Values[i + 1]; + if (localTimeline >= first.remoteTime && + localTimeline <= second.remoteTime) + { + // use these two snapshots + from = i; + to = i + 1; + t = Mathd.InverseLerp(first.remoteTime, second.remoteTime, localTimeline); + return; + } + } + + // didn't find two snapshots around local time. + // so pick either the first or last, depending on which is closer. + + // oldest snapshot ahead of local time? + if (buffer.Values[0].remoteTime > localTimeline) + { + from = to = 0; + t = 0; + } + // otherwise initialize both to the last one + else + { + from = to = buffer.Count - 1; + t = 0; + } + } + + // progress local timeline every update. + // + // ONLY CALL IF SNAPSHOTS.COUNT > 0! + // + // decoupled from Step for easier testing and so we can progress + // time only once in NetworkClient, while stepping for each component. + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static void StepTime( + double deltaTime, // engine delta time (unscaled) + ref double localTimeline, // local interpolation time based on server time + double localTimescale) // catchup / slowdown is applied to time every update) + { + // move local forward in time, scaled with catchup / slowdown applied + localTimeline += deltaTime * localTimescale; + } + + // sample, clear old. + // call this every update. + // + // ONLY CALL IF SNAPSHOTS.COUNT > 0! + // + // returns true if there is anything to apply (requires at least 1 snap) + // from/to/t are out parameters instead of an interpolated 'computed'. + // this allows us to store from/to/t globally (i.e. in NetworkClient) + // and have each component apply the interpolation manually. + // besides, passing "Func Interpolate" would allocate anyway. + public static void StepInterpolation( + SortedList buffer, // snapshot buffer + double localTimeline, // local interpolation time based on server time + out T fromSnapshot, // we interpolate 'from' this snapshot + out T toSnapshot, // 'to' this snapshot + out double t) // at ratio 't' [0,1] + where T : Snapshot + { + // check this in caller: + // nothing to do if there are no snapshots at all yet + // if (buffer.Count == 0) return false; + + // sample snapshot buffer at local interpolation time + Sample(buffer, localTimeline, out int from, out int to, out t); + + // save from/to + fromSnapshot = buffer.Values[from]; + toSnapshot = buffer.Values[to]; + + // remove older snapshots that we definitely don't need anymore. + // after(!) using the indices. + // + // if we have 3 snapshots and we are between 2nd and 3rd: + // from = 1, to = 2 + // then we need to remove the first one, which is exactly 'from'. + // because 'from-1' = 0 would remove none. + buffer.RemoveRange(from); + } + + // update time, sample, clear old. + // call this every update. + // + // ONLY CALL IF SNAPSHOTS.COUNT > 0! + // + // returns true if there is anything to apply (requires at least 1 snap) + // from/to/t are out parameters instead of an interpolated 'computed'. + // this allows us to store from/to/t globally (i.e. in NetworkClient) + // and have each component apply the interpolation manually. + // besides, passing "Func Interpolate" would allocate anyway. + public static void Step( + SortedList buffer, // snapshot buffer + double deltaTime, // engine delta time (unscaled) + ref double localTimeline, // local interpolation time based on server time + double localTimescale, // catchup / slowdown is applied to time every update + out T fromSnapshot, // we interpolate 'from' this snapshot + out T toSnapshot, // 'to' this snapshot + out double t) // at ratio 't' [0,1] + where T : Snapshot + { + StepTime(deltaTime, ref localTimeline, localTimescale); + StepInterpolation(buffer, localTimeline, out fromSnapshot, out toSnapshot, out t); + } + } +} diff --git a/Assets/Mirror/Core/SnapshotInterpolation/SnapshotInterpolation.cs.meta b/Assets/Mirror/Core/SnapshotInterpolation/SnapshotInterpolation.cs.meta new file mode 100644 index 0000000..244c5fb --- /dev/null +++ b/Assets/Mirror/Core/SnapshotInterpolation/SnapshotInterpolation.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 72c16070d85334011853813488ab1431 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/SnapshotInterpolation/SnapshotInterpolationSettings.cs b/Assets/Mirror/Core/SnapshotInterpolation/SnapshotInterpolationSettings.cs new file mode 100644 index 0000000..74feae4 --- /dev/null +++ b/Assets/Mirror/Core/SnapshotInterpolation/SnapshotInterpolationSettings.cs @@ -0,0 +1,70 @@ +// snapshot interpolation settings struct. +// can easily be exposed in Unity inspectors. +using System; +using UnityEngine; + +namespace Mirror +{ + // class so we can define defaults easily + [Serializable] + public class SnapshotInterpolationSettings + { + // decrease bufferTime at runtime to see the catchup effect. + // increase to see slowdown. + // 'double' so we can have very precise dynamic adjustment without rounding + [Header("Buffering")] + [Tooltip("Local simulation is behind by sendInterval * multiplier seconds.\n\nThis guarantees that we always have enough snapshots in the buffer to mitigate lags & jitter.\n\nIncrease this if the simulation isn't smooth. By default, it should be around 2.")] + public double bufferTimeMultiplier = 2; + + [Tooltip("If a client can't process snapshots fast enough, don't store too many.")] + public int bufferLimit = 32; + + // catchup ///////////////////////////////////////////////////////////// + // catchup thresholds in 'frames'. + // half a frame might be too aggressive. + [Header("Catchup / Slowdown")] + [Tooltip("Slowdown begins when the local timeline is moving too fast towards remote time. Threshold is in frames worth of snapshots.\n\nThis needs to be negative.\n\nDon't modify unless you know what you are doing.")] + public float catchupNegativeThreshold = -1; // careful, don't want to run out of snapshots + + [Tooltip("Catchup begins when the local timeline is moving too slow and getting too far away from remote time. Threshold is in frames worth of snapshots.\n\nThis needs to be positive.\n\nDon't modify unless you know what you are doing.")] + public float catchupPositiveThreshold = 1; + + [Tooltip("Local timeline acceleration in % while catching up.")] + [Range(0, 1)] + public double catchupSpeed = 0.02f; // see snap interp demo. 1% is too slow. + + [Tooltip("Local timeline slowdown in % while slowing down.")] + [Range(0, 1)] + public double slowdownSpeed = 0.04f; // slow down a little faster so we don't encounter empty buffer (= jitter) + + [Tooltip("Catchup/Slowdown is adjusted over n-second exponential moving average.")] + public int driftEmaDuration = 1; // shouldn't need to modify this, but expose it anyway + + // dynamic buffer time adjustment ////////////////////////////////////// + // dynamically adjusts bufferTimeMultiplier for smooth results. + // to understand how this works, try this manually: + // + // - disable dynamic adjustment + // - set jitter = 0.2 (20% is a lot!) + // - notice some stuttering + // - disable interpolation to see just how much jitter this really is(!) + // - enable interpolation again + // - manually increase bufferTimeMultiplier to 3-4 + // ... the cube slows down (blue) until it's smooth + // - with dynamic adjustment enabled, it will set 4 automatically + // ... the cube slows down (blue) until it's smooth as well + // + // note that 20% jitter is extreme. + // for this to be perfectly smooth, set the safety tolerance to '2'. + // but realistically this is not necessary, and '1' is enough. + [Header("Dynamic Adjustment")] + [Tooltip("Automatically adjust bufferTimeMultiplier for smooth results.\nSets a low multiplier on stable connections, and a high multiplier on jittery connections.")] + public bool dynamicAdjustment = true; + + [Tooltip("Safety buffer that is always added to the dynamic bufferTimeMultiplier adjustment.")] + public float dynamicAdjustmentTolerance = 1; // 1 is realistically just fine, 2 is very very safe even for 20% jitter. can be half a frame too. (see above comments) + + [Tooltip("Dynamic adjustment is computed over n-second exponential moving average standard deviation.")] + public int deliveryTimeEmaDuration = 2; // 1-2s recommended to capture average delivery time + } +} diff --git a/Assets/Mirror/Core/SnapshotInterpolation/SnapshotInterpolationSettings.cs.meta b/Assets/Mirror/Core/SnapshotInterpolation/SnapshotInterpolationSettings.cs.meta new file mode 100644 index 0000000..5cc16e4 --- /dev/null +++ b/Assets/Mirror/Core/SnapshotInterpolation/SnapshotInterpolationSettings.cs.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: f955b76b7956417088c03992b3622dc9 +timeCreated: 1678507210 \ No newline at end of file diff --git a/Assets/Mirror/Core/SnapshotInterpolation/TimeSnapshot.cs b/Assets/Mirror/Core/SnapshotInterpolation/TimeSnapshot.cs new file mode 100644 index 0000000..5bfdd3a --- /dev/null +++ b/Assets/Mirror/Core/SnapshotInterpolation/TimeSnapshot.cs @@ -0,0 +1,15 @@ +namespace Mirror +{ + // empty snapshot that is only used to progress client's local timeline. + public struct TimeSnapshot : Snapshot + { + public double remoteTime { get; set; } + public double localTime { get; set; } + + public TimeSnapshot(double remoteTime, double localTime) + { + this.remoteTime = remoteTime; + this.localTime = localTime; + } + } +} diff --git a/Assets/Mirror/Core/SnapshotInterpolation/TimeSnapshot.cs.meta b/Assets/Mirror/Core/SnapshotInterpolation/TimeSnapshot.cs.meta new file mode 100644 index 0000000..5e37981 --- /dev/null +++ b/Assets/Mirror/Core/SnapshotInterpolation/TimeSnapshot.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: afe2b5ed49634971a2aec720ad74e5cd +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/SyncDictionary.cs b/Assets/Mirror/Core/SyncDictionary.cs new file mode 100644 index 0000000..70ba9fd --- /dev/null +++ b/Assets/Mirror/Core/SyncDictionary.cs @@ -0,0 +1,326 @@ +using System.Collections; +using System.Collections.Generic; + +namespace Mirror +{ + public class SyncIDictionary : SyncObject, IDictionary, IReadOnlyDictionary + { + public delegate void SyncDictionaryChanged(Operation op, TKey key, TValue item); + + protected readonly IDictionary objects; + + public int Count => objects.Count; + public bool IsReadOnly => !IsWritable(); + public event SyncDictionaryChanged Callback; + + public enum Operation : byte + { + OP_ADD, + OP_CLEAR, + OP_REMOVE, + OP_SET + } + + struct Change + { + internal Operation operation; + internal TKey key; + internal TValue item; + } + + // list of changes. + // -> insert/delete/clear is only ONE change + // -> changing the same slot 10x causes 10 changes. + // -> note that this grows until next sync(!) + // TODO Dictionary to avoid ever growing changes / redundant changes! + readonly List changes = new List(); + + // how many changes we need to ignore + // this is needed because when we initialize the list, + // we might later receive changes that have already been applied + // so we need to skip them + int changesAhead; + + public override void Reset() + { + changes.Clear(); + changesAhead = 0; + objects.Clear(); + } + + public ICollection Keys => objects.Keys; + + public ICollection Values => objects.Values; + + IEnumerable IReadOnlyDictionary.Keys => objects.Keys; + + IEnumerable IReadOnlyDictionary.Values => objects.Values; + + // throw away all the changes + // this should be called after a successful sync + public override void ClearChanges() => changes.Clear(); + + public SyncIDictionary(IDictionary objects) + { + this.objects = objects; + } + + void AddOperation(Operation op, TKey key, TValue item, bool checkAccess) + { + if (checkAccess && IsReadOnly) + { + throw new System.InvalidOperationException("SyncDictionaries can only be modified by the owner."); + } + + Change change = new Change + { + operation = op, + key = key, + item = item + }; + + if (IsRecording()) + { + changes.Add(change); + OnDirty?.Invoke(); + } + + Callback?.Invoke(op, key, item); + } + + public override void OnSerializeAll(NetworkWriter writer) + { + // if init, write the full list content + writer.WriteUInt((uint)objects.Count); + + foreach (KeyValuePair syncItem in objects) + { + writer.Write(syncItem.Key); + writer.Write(syncItem.Value); + } + + // all changes have been applied already + // thus the client will need to skip all the pending changes + // or they would be applied again. + // So we write how many changes are pending + writer.WriteUInt((uint)changes.Count); + } + + public override void OnSerializeDelta(NetworkWriter writer) + { + // write all the queued up changes + writer.WriteUInt((uint)changes.Count); + + for (int i = 0; i < changes.Count; i++) + { + Change change = changes[i]; + writer.WriteByte((byte)change.operation); + + switch (change.operation) + { + case Operation.OP_ADD: + case Operation.OP_SET: + writer.Write(change.key); + writer.Write(change.item); + break; + case Operation.OP_REMOVE: + writer.Write(change.key); + break; + case Operation.OP_CLEAR: + break; + } + } + } + + public override void OnDeserializeAll(NetworkReader reader) + { + // if init, write the full list content + int count = (int)reader.ReadUInt(); + + objects.Clear(); + changes.Clear(); + + for (int i = 0; i < count; i++) + { + TKey key = reader.Read(); + TValue obj = reader.Read(); + objects.Add(key, obj); + } + + // We will need to skip all these changes + // the next time the list is synchronized + // because they have already been applied + changesAhead = (int)reader.ReadUInt(); + } + + public override void OnDeserializeDelta(NetworkReader reader) + { + int changesCount = (int)reader.ReadUInt(); + + for (int i = 0; i < changesCount; i++) + { + Operation operation = (Operation)reader.ReadByte(); + + // apply the operation only if it is a new change + // that we have not applied yet + bool apply = changesAhead == 0; + TKey key = default; + TValue item = default; + + switch (operation) + { + case Operation.OP_ADD: + case Operation.OP_SET: + key = reader.Read(); + item = reader.Read(); + if (apply) + { + // add dirty + changes. + // ClientToServer needs to set dirty in server OnDeserialize. + // no access check: server OnDeserialize can always + // write, even for ClientToServer (for broadcasting). + if (ContainsKey(key)) + { + objects[key] = item; // assign after ContainsKey check + AddOperation(Operation.OP_SET, key, item, false); + } + else + { + objects[key] = item; // assign after ContainsKey check + AddOperation(Operation.OP_ADD, key, item, false); + } + } + break; + + case Operation.OP_CLEAR: + if (apply) + { + objects.Clear(); + // add dirty + changes. + // ClientToServer needs to set dirty in server OnDeserialize. + // no access check: server OnDeserialize can always + // write, even for ClientToServer (for broadcasting). + AddOperation(Operation.OP_CLEAR, default, default, false); + } + break; + + case Operation.OP_REMOVE: + key = reader.Read(); + if (apply) + { + if (objects.TryGetValue(key, out item)) + { + // add dirty + changes. + // ClientToServer needs to set dirty in server OnDeserialize. + // no access check: server OnDeserialize can always + // write, even for ClientToServer (for broadcasting). + objects.Remove(key); + AddOperation(Operation.OP_REMOVE, key, item, false); + } + } + break; + } + + if (!apply) + { + // we just skipped this change + changesAhead--; + } + } + } + + public void Clear() + { + objects.Clear(); + AddOperation(Operation.OP_CLEAR, default, default, true); + } + + public bool ContainsKey(TKey key) => objects.ContainsKey(key); + + public bool Remove(TKey key) + { + if (objects.TryGetValue(key, out TValue item) && objects.Remove(key)) + { + AddOperation(Operation.OP_REMOVE, key, item, true); + return true; + } + return false; + } + + public TValue this[TKey i] + { + get => objects[i]; + set + { + if (ContainsKey(i)) + { + objects[i] = value; + AddOperation(Operation.OP_SET, i, value, true); + } + else + { + objects[i] = value; + AddOperation(Operation.OP_ADD, i, value, true); + } + } + } + + public bool TryGetValue(TKey key, out TValue value) => objects.TryGetValue(key, out value); + + public void Add(TKey key, TValue value) + { + objects.Add(key, value); + AddOperation(Operation.OP_ADD, key, value, true); + } + + public void Add(KeyValuePair item) => Add(item.Key, item.Value); + + public bool Contains(KeyValuePair item) + { + return TryGetValue(item.Key, out TValue val) && EqualityComparer.Default.Equals(val, item.Value); + } + + public void CopyTo(KeyValuePair[] array, int arrayIndex) + { + if (arrayIndex < 0 || arrayIndex > array.Length) + { + throw new System.ArgumentOutOfRangeException(nameof(arrayIndex), "Array Index Out of Range"); + } + if (array.Length - arrayIndex < Count) + { + throw new System.ArgumentException("The number of items in the SyncDictionary is greater than the available space from arrayIndex to the end of the destination array"); + } + + int i = arrayIndex; + foreach (KeyValuePair item in objects) + { + array[i] = item; + i++; + } + } + + public bool Remove(KeyValuePair item) + { + bool result = objects.Remove(item.Key); + if (result) + { + AddOperation(Operation.OP_REMOVE, item.Key, item.Value, true); + } + return result; + } + + public IEnumerator> GetEnumerator() => objects.GetEnumerator(); + + IEnumerator IEnumerable.GetEnumerator() => objects.GetEnumerator(); + } + + public class SyncDictionary : SyncIDictionary + { + public SyncDictionary() : base(new Dictionary()) {} + public SyncDictionary(IEqualityComparer eq) : base(new Dictionary(eq)) {} + public SyncDictionary(IDictionary d) : base(new Dictionary(d)) {} + public new Dictionary.ValueCollection Values => ((Dictionary)objects).Values; + public new Dictionary.KeyCollection Keys => ((Dictionary)objects).Keys; + public new Dictionary.Enumerator GetEnumerator() => ((Dictionary)objects).GetEnumerator(); + } +} diff --git a/Assets/Mirror/Core/SyncDictionary.cs.meta b/Assets/Mirror/Core/SyncDictionary.cs.meta new file mode 100644 index 0000000..1c20b57 --- /dev/null +++ b/Assets/Mirror/Core/SyncDictionary.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 4b346c49cfdb668488a364c3023590e2 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/SyncList.cs b/Assets/Mirror/Core/SyncList.cs new file mode 100644 index 0000000..8b70eed --- /dev/null +++ b/Assets/Mirror/Core/SyncList.cs @@ -0,0 +1,420 @@ +using System; +using System.Collections; +using System.Collections.Generic; + +namespace Mirror +{ + public class SyncList : SyncObject, IList, IReadOnlyList + { + public delegate void SyncListChanged(Operation op, int itemIndex, T oldItem, T newItem); + + readonly IList objects; + readonly IEqualityComparer comparer; + + public int Count => objects.Count; + public bool IsReadOnly => !IsWritable(); + public event SyncListChanged Callback; + + public enum Operation : byte + { + OP_ADD, + OP_CLEAR, + OP_INSERT, + OP_REMOVEAT, + OP_SET + } + + struct Change + { + internal Operation operation; + internal int index; + internal T item; + } + + // list of changes. + // -> insert/delete/clear is only ONE change + // -> changing the same slot 10x caues 10 changes. + // -> note that this grows until next sync(!) + readonly List changes = new List(); + + // how many changes we need to ignore + // this is needed because when we initialize the list, + // we might later receive changes that have already been applied + // so we need to skip them + int changesAhead; + + public SyncList() : this(EqualityComparer.Default) {} + + public SyncList(IEqualityComparer comparer) + { + this.comparer = comparer ?? EqualityComparer.Default; + objects = new List(); + } + + public SyncList(IList objects, IEqualityComparer comparer = null) + { + this.comparer = comparer ?? EqualityComparer.Default; + this.objects = objects; + } + + // throw away all the changes + // this should be called after a successful sync + public override void ClearChanges() => changes.Clear(); + + public override void Reset() + { + changes.Clear(); + changesAhead = 0; + objects.Clear(); + } + + void AddOperation(Operation op, int itemIndex, T oldItem, T newItem, bool checkAccess) + { + if (checkAccess && IsReadOnly) + { + throw new InvalidOperationException("Synclists can only be modified by the owner."); + } + + Change change = new Change + { + operation = op, + index = itemIndex, + item = newItem + }; + + if (IsRecording()) + { + changes.Add(change); + OnDirty?.Invoke(); + } + + Callback?.Invoke(op, itemIndex, oldItem, newItem); + } + + public override void OnSerializeAll(NetworkWriter writer) + { + // if init, write the full list content + writer.WriteUInt((uint)objects.Count); + + for (int i = 0; i < objects.Count; i++) + { + T obj = objects[i]; + writer.Write(obj); + } + + // all changes have been applied already + // thus the client will need to skip all the pending changes + // or they would be applied again. + // So we write how many changes are pending + writer.WriteUInt((uint)changes.Count); + } + + public override void OnSerializeDelta(NetworkWriter writer) + { + // write all the queued up changes + writer.WriteUInt((uint)changes.Count); + + for (int i = 0; i < changes.Count; i++) + { + Change change = changes[i]; + writer.WriteByte((byte)change.operation); + + switch (change.operation) + { + case Operation.OP_ADD: + writer.Write(change.item); + break; + + case Operation.OP_CLEAR: + break; + + case Operation.OP_REMOVEAT: + writer.WriteUInt((uint)change.index); + break; + + case Operation.OP_INSERT: + case Operation.OP_SET: + writer.WriteUInt((uint)change.index); + writer.Write(change.item); + break; + } + } + } + + public override void OnDeserializeAll(NetworkReader reader) + { + // if init, write the full list content + int count = (int)reader.ReadUInt(); + + objects.Clear(); + changes.Clear(); + + for (int i = 0; i < count; i++) + { + T obj = reader.Read(); + objects.Add(obj); + } + + // We will need to skip all these changes + // the next time the list is synchronized + // because they have already been applied + changesAhead = (int)reader.ReadUInt(); + } + + public override void OnDeserializeDelta(NetworkReader reader) + { + int changesCount = (int)reader.ReadUInt(); + + for (int i = 0; i < changesCount; i++) + { + Operation operation = (Operation)reader.ReadByte(); + + // apply the operation only if it is a new change + // that we have not applied yet + bool apply = changesAhead == 0; + int index = 0; + T oldItem = default; + T newItem = default; + + switch (operation) + { + case Operation.OP_ADD: + newItem = reader.Read(); + if (apply) + { + index = objects.Count; + objects.Add(newItem); + // add dirty + changes. + // ClientToServer needs to set dirty in server OnDeserialize. + // no access check: server OnDeserialize can always + // write, even for ClientToServer (for broadcasting). + AddOperation(Operation.OP_ADD, objects.Count - 1, default, newItem, false); + } + break; + + case Operation.OP_CLEAR: + if (apply) + { + objects.Clear(); + // add dirty + changes. + // ClientToServer needs to set dirty in server OnDeserialize. + // no access check: server OnDeserialize can always + // write, even for ClientToServer (for broadcasting). + AddOperation(Operation.OP_CLEAR, 0, default, default, false); + } + break; + + case Operation.OP_INSERT: + index = (int)reader.ReadUInt(); + newItem = reader.Read(); + if (apply) + { + objects.Insert(index, newItem); + // add dirty + changes. + // ClientToServer needs to set dirty in server OnDeserialize. + // no access check: server OnDeserialize can always + // write, even for ClientToServer (for broadcasting). + AddOperation(Operation.OP_INSERT, index, default, newItem, false); + } + break; + + case Operation.OP_REMOVEAT: + index = (int)reader.ReadUInt(); + if (apply) + { + oldItem = objects[index]; + objects.RemoveAt(index); + // add dirty + changes. + // ClientToServer needs to set dirty in server OnDeserialize. + // no access check: server OnDeserialize can always + // write, even for ClientToServer (for broadcasting). + AddOperation(Operation.OP_REMOVEAT, index, oldItem, default, false); + } + break; + + case Operation.OP_SET: + index = (int)reader.ReadUInt(); + newItem = reader.Read(); + if (apply) + { + oldItem = objects[index]; + objects[index] = newItem; + // add dirty + changes. + // ClientToServer needs to set dirty in server OnDeserialize. + // no access check: server OnDeserialize can always + // write, even for ClientToServer (for broadcasting). + AddOperation(Operation.OP_SET, index, oldItem, newItem, false); + } + break; + } + + if (!apply) + { + // we just skipped this change + changesAhead--; + } + } + } + + public void Add(T item) + { + objects.Add(item); + AddOperation(Operation.OP_ADD, objects.Count - 1, default, item, true); + } + + public void AddRange(IEnumerable range) + { + foreach (T entry in range) + { + Add(entry); + } + } + + public void Clear() + { + objects.Clear(); + AddOperation(Operation.OP_CLEAR, 0, default, default, true); + } + + public bool Contains(T item) => IndexOf(item) >= 0; + + public void CopyTo(T[] array, int index) => objects.CopyTo(array, index); + + public int IndexOf(T item) + { + for (int i = 0; i < objects.Count; ++i) + if (comparer.Equals(item, objects[i])) + return i; + return -1; + } + + public int FindIndex(Predicate match) + { + for (int i = 0; i < objects.Count; ++i) + if (match(objects[i])) + return i; + return -1; + } + + public T Find(Predicate match) + { + int i = FindIndex(match); + return (i != -1) ? objects[i] : default; + } + + public List FindAll(Predicate match) + { + List results = new List(); + for (int i = 0; i < objects.Count; ++i) + if (match(objects[i])) + results.Add(objects[i]); + return results; + } + + public void Insert(int index, T item) + { + objects.Insert(index, item); + AddOperation(Operation.OP_INSERT, index, default, item, true); + } + + public void InsertRange(int index, IEnumerable range) + { + foreach (T entry in range) + { + Insert(index, entry); + index++; + } + } + + public bool Remove(T item) + { + int index = IndexOf(item); + bool result = index >= 0; + if (result) + { + RemoveAt(index); + } + return result; + } + + public void RemoveAt(int index) + { + T oldItem = objects[index]; + objects.RemoveAt(index); + AddOperation(Operation.OP_REMOVEAT, index, oldItem, default, true); + } + + public int RemoveAll(Predicate match) + { + List toRemove = new List(); + for (int i = 0; i < objects.Count; ++i) + if (match(objects[i])) + toRemove.Add(objects[i]); + + foreach (T entry in toRemove) + { + Remove(entry); + } + + return toRemove.Count; + } + + public T this[int i] + { + get => objects[i]; + set + { + if (!comparer.Equals(objects[i], value)) + { + T oldItem = objects[i]; + objects[i] = value; + AddOperation(Operation.OP_SET, i, oldItem, value, true); + } + } + } + + public Enumerator GetEnumerator() => new Enumerator(this); + + IEnumerator IEnumerable.GetEnumerator() => new Enumerator(this); + + IEnumerator IEnumerable.GetEnumerator() => new Enumerator(this); + + // default Enumerator allocates. we need a custom struct Enumerator to + // not allocate on the heap. + // (System.Collections.Generic.List source code does the same) + // + // benchmark: + // uMMORPG with 800 monsters, Skills.GetHealthBonus() which runs a + // foreach on skills SyncList: + // before: 81.2KB GC per frame + // after: 0KB GC per frame + // => this is extremely important for MMO scale networking + public struct Enumerator : IEnumerator + { + readonly SyncList list; + int index; + public T Current { get; private set; } + + public Enumerator(SyncList list) + { + this.list = list; + index = -1; + Current = default; + } + + public bool MoveNext() + { + if (++index >= list.Count) + { + return false; + } + Current = list[index]; + return true; + } + + public void Reset() => index = -1; + object IEnumerator.Current => Current; + public void Dispose() {} + } + } +} diff --git a/Assets/Mirror/Core/SyncList.cs.meta b/Assets/Mirror/Core/SyncList.cs.meta new file mode 100644 index 0000000..088ef1e --- /dev/null +++ b/Assets/Mirror/Core/SyncList.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 744fc71f748fe40d5940e04bf42b29f3 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/SyncObject.cs b/Assets/Mirror/Core/SyncObject.cs new file mode 100644 index 0000000..405e240 --- /dev/null +++ b/Assets/Mirror/Core/SyncObject.cs @@ -0,0 +1,53 @@ +using System; + +namespace Mirror +{ + /// SyncObjects sync state between server and client. E.g. SyncLists. + // SyncObject should be a class (instead of an interface) for a few reasons: + // * NetworkBehaviour stores SyncObjects in a list. structs would be a copy + // and OnSerialize would use the copy instead of the original struct. + // * Obsolete functions like Flush() don't need to be defined by each type + // * OnDirty/IsRecording etc. default functions can be defined once here + // for example, handling 'OnDirty wasn't initialized' with a default + // function that throws an exception will be useful for SyncVar + public abstract class SyncObject + { + /// Used internally to set owner NetworkBehaviour's dirty mask bit when changed. + public Action OnDirty; + + /// Used internally to check if we are currently tracking changes. + // prevents ever growing .changes lists: + // if a monster has no observers but we keep modifying a SyncObject, + // then the changes would never be flushed and keep growing, + // because OnSerialize isn't called without observers. + // => Func so we can set it to () => observers.Count > 0 + // without depending on NetworkComponent/NetworkIdentity here. + // => virtual so it simply always records by default + public Func IsRecording = () => true; + + // SyncList/Set/etc. shouldn't be modifiable if not owned. + // otherwise they would silently get out of sync. + // need a lambda because InitSyncObject is called in ctor, when + // 'isClient' etc. aren't initialized yet. + public Func IsWritable = () => true; + + /// Discard all the queued changes + // Consider the object fully synchronized with clients + public abstract void ClearChanges(); + + /// Write a full copy of the object + public abstract void OnSerializeAll(NetworkWriter writer); + + /// Write the changes made to the object since last sync + public abstract void OnSerializeDelta(NetworkWriter writer); + + /// Reads a full copy of the object + public abstract void OnDeserializeAll(NetworkReader reader); + + /// Reads the changes made to the object since last sync + public abstract void OnDeserializeDelta(NetworkReader reader); + + /// Resets the SyncObject so that it can be re-used + public abstract void Reset(); + } +} diff --git a/Assets/Mirror/Core/SyncObject.cs.meta b/Assets/Mirror/Core/SyncObject.cs.meta new file mode 100644 index 0000000..736c651 --- /dev/null +++ b/Assets/Mirror/Core/SyncObject.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: ae226d17a0c844041aa24cc2c023dd49 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/SyncSet.cs b/Assets/Mirror/Core/SyncSet.cs new file mode 100644 index 0000000..13d4302 --- /dev/null +++ b/Assets/Mirror/Core/SyncSet.cs @@ -0,0 +1,352 @@ +using System; +using System.Collections; +using System.Collections.Generic; + +namespace Mirror +{ + public class SyncSet : SyncObject, ISet + { + public delegate void SyncSetChanged(Operation op, T item); + + protected readonly ISet objects; + + public int Count => objects.Count; + public bool IsReadOnly => !IsWritable(); + public event SyncSetChanged Callback; + + public enum Operation : byte + { + OP_ADD, + OP_CLEAR, + OP_REMOVE + } + + struct Change + { + internal Operation operation; + internal T item; + } + + // list of changes. + // -> insert/delete/clear is only ONE change + // -> changing the same slot 10x caues 10 changes. + // -> note that this grows until next sync(!) + // TODO Dictionary to avoid ever growing changes / redundant changes! + readonly List changes = new List(); + + // how many changes we need to ignore + // this is needed because when we initialize the list, + // we might later receive changes that have already been applied + // so we need to skip them + int changesAhead; + + public SyncSet(ISet objects) + { + this.objects = objects; + } + + public override void Reset() + { + changes.Clear(); + changesAhead = 0; + objects.Clear(); + } + + // throw away all the changes + // this should be called after a successful sync + public override void ClearChanges() => changes.Clear(); + + void AddOperation(Operation op, T item, bool checkAccess) + { + if (checkAccess && IsReadOnly) + { + throw new InvalidOperationException("SyncSets can only be modified by the owner."); + } + + Change change = new Change + { + operation = op, + item = item + }; + + if (IsRecording()) + { + changes.Add(change); + OnDirty?.Invoke(); + } + + Callback?.Invoke(op, item); + } + + void AddOperation(Operation op, bool checkAccess) => AddOperation(op, default, checkAccess); + + public override void OnSerializeAll(NetworkWriter writer) + { + // if init, write the full list content + writer.WriteUInt((uint)objects.Count); + + foreach (T obj in objects) + { + writer.Write(obj); + } + + // all changes have been applied already + // thus the client will need to skip all the pending changes + // or they would be applied again. + // So we write how many changes are pending + writer.WriteUInt((uint)changes.Count); + } + + public override void OnSerializeDelta(NetworkWriter writer) + { + // write all the queued up changes + writer.WriteUInt((uint)changes.Count); + + for (int i = 0; i < changes.Count; i++) + { + Change change = changes[i]; + writer.WriteByte((byte)change.operation); + + switch (change.operation) + { + case Operation.OP_ADD: + writer.Write(change.item); + break; + + case Operation.OP_CLEAR: + break; + + case Operation.OP_REMOVE: + writer.Write(change.item); + break; + } + } + } + + public override void OnDeserializeAll(NetworkReader reader) + { + // if init, write the full list content + int count = (int)reader.ReadUInt(); + + objects.Clear(); + changes.Clear(); + + for (int i = 0; i < count; i++) + { + T obj = reader.Read(); + objects.Add(obj); + } + + // We will need to skip all these changes + // the next time the list is synchronized + // because they have already been applied + changesAhead = (int)reader.ReadUInt(); + } + + public override void OnDeserializeDelta(NetworkReader reader) + { + int changesCount = (int)reader.ReadUInt(); + + for (int i = 0; i < changesCount; i++) + { + Operation operation = (Operation)reader.ReadByte(); + + // apply the operation only if it is a new change + // that we have not applied yet + bool apply = changesAhead == 0; + T item = default; + + switch (operation) + { + case Operation.OP_ADD: + item = reader.Read(); + if (apply) + { + objects.Add(item); + // add dirty + changes. + // ClientToServer needs to set dirty in server OnDeserialize. + // no access check: server OnDeserialize can always + // write, even for ClientToServer (for broadcasting). + AddOperation(Operation.OP_ADD, item, false); + } + break; + + case Operation.OP_CLEAR: + if (apply) + { + objects.Clear(); + // add dirty + changes. + // ClientToServer needs to set dirty in server OnDeserialize. + // no access check: server OnDeserialize can always + // write, even for ClientToServer (for broadcasting). + AddOperation(Operation.OP_CLEAR, false); + } + break; + + case Operation.OP_REMOVE: + item = reader.Read(); + if (apply) + { + objects.Remove(item); + // add dirty + changes. + // ClientToServer needs to set dirty in server OnDeserialize. + // no access check: server OnDeserialize can always + // write, even for ClientToServer (for broadcasting). + AddOperation(Operation.OP_REMOVE, item, false); + } + break; + } + + if (!apply) + { + // we just skipped this change + changesAhead--; + } + } + } + + public bool Add(T item) + { + if (objects.Add(item)) + { + AddOperation(Operation.OP_ADD, item, true); + return true; + } + return false; + } + + void ICollection.Add(T item) + { + if (objects.Add(item)) + { + AddOperation(Operation.OP_ADD, item, true); + } + } + + public void Clear() + { + objects.Clear(); + AddOperation(Operation.OP_CLEAR, true); + } + + public bool Contains(T item) => objects.Contains(item); + + public void CopyTo(T[] array, int index) => objects.CopyTo(array, index); + + public bool Remove(T item) + { + if (objects.Remove(item)) + { + AddOperation(Operation.OP_REMOVE, item, true); + return true; + } + return false; + } + + public IEnumerator GetEnumerator() => objects.GetEnumerator(); + + IEnumerator IEnumerable.GetEnumerator() => GetEnumerator(); + + public void ExceptWith(IEnumerable other) + { + if (other == this) + { + Clear(); + return; + } + + // remove every element in other from this + foreach (T element in other) + { + Remove(element); + } + } + + public void IntersectWith(IEnumerable other) + { + if (other is ISet otherSet) + { + IntersectWithSet(otherSet); + } + else + { + HashSet otherAsSet = new HashSet(other); + IntersectWithSet(otherAsSet); + } + } + + void IntersectWithSet(ISet otherSet) + { + List elements = new List(objects); + + foreach (T element in elements) + { + if (!otherSet.Contains(element)) + { + Remove(element); + } + } + } + + public bool IsProperSubsetOf(IEnumerable other) => objects.IsProperSubsetOf(other); + + public bool IsProperSupersetOf(IEnumerable other) => objects.IsProperSupersetOf(other); + + public bool IsSubsetOf(IEnumerable other) => objects.IsSubsetOf(other); + + public bool IsSupersetOf(IEnumerable other) => objects.IsSupersetOf(other); + + public bool Overlaps(IEnumerable other) => objects.Overlaps(other); + + public bool SetEquals(IEnumerable other) => objects.SetEquals(other); + + // custom implementation so we can do our own Clear/Add/Remove for delta + public void SymmetricExceptWith(IEnumerable other) + { + if (other == this) + { + Clear(); + } + else + { + foreach (T element in other) + { + if (!Remove(element)) + { + Add(element); + } + } + } + } + + // custom implementation so we can do our own Clear/Add/Remove for delta + public void UnionWith(IEnumerable other) + { + if (other != this) + { + foreach (T element in other) + { + Add(element); + } + } + } + } + + public class SyncHashSet : SyncSet + { + public SyncHashSet() : this(EqualityComparer.Default) {} + public SyncHashSet(IEqualityComparer comparer) : base(new HashSet(comparer ?? EqualityComparer.Default)) {} + + // allocation free enumerator + public new HashSet.Enumerator GetEnumerator() => ((HashSet)objects).GetEnumerator(); + } + + public class SyncSortedSet : SyncSet + { + public SyncSortedSet() : this(Comparer.Default) {} + public SyncSortedSet(IComparer comparer) : base(new SortedSet(comparer ?? Comparer.Default)) {} + + // allocation free enumerator + public new SortedSet.Enumerator GetEnumerator() => ((SortedSet)objects).GetEnumerator(); + } +} diff --git a/Assets/Mirror/Core/SyncSet.cs.meta b/Assets/Mirror/Core/SyncSet.cs.meta new file mode 100644 index 0000000..6eeef1c --- /dev/null +++ b/Assets/Mirror/Core/SyncSet.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 8a31599d9f9dd4ef9999f7b9707c832c +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/Threading.meta b/Assets/Mirror/Core/Threading.meta new file mode 100644 index 0000000..037993e --- /dev/null +++ b/Assets/Mirror/Core/Threading.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: 752fcafbee1ec45c9a43c0cf65da39de +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/Threading/ConcurrentNetworkWriterPool.cs b/Assets/Mirror/Core/Threading/ConcurrentNetworkWriterPool.cs new file mode 100644 index 0000000..c0bc926 --- /dev/null +++ b/Assets/Mirror/Core/Threading/ConcurrentNetworkWriterPool.cs @@ -0,0 +1,45 @@ +// API consistent with Microsoft's ObjectPool. +// thread safe. +using System.Runtime.CompilerServices; + +namespace Mirror +{ + public static class ConcurrentNetworkWriterPool + { + // initial capacity to avoid allocations in the first few frames + // 1000 * 1200 bytes = around 1 MB. + public const int InitialCapacity = 1000; + + + // reuse ConcurrentPool + // we still wrap it in NetworkWriterPool.Get/Recycle so we can reset the + // position before reusing. + // this is also more consistent with NetworkReaderPool where we need to + // assign the internal buffer before reusing. + static readonly ConcurrentPool pool = + new ConcurrentPool( + // new object function + () => new ConcurrentNetworkWriterPooled(), + // initial capacity to avoid allocations in the first few frames + // 1000 * 1200 bytes = around 1 MB. + InitialCapacity + ); + + // pool size access for debugging & tests + public static int Count => pool.Count; + + public static ConcurrentNetworkWriterPooled Get() + { + // grab from pool & reset position + ConcurrentNetworkWriterPooled writer = pool.Get(); + writer.Position = 0; + return writer; + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static void Return(ConcurrentNetworkWriterPooled writer) + { + pool.Return(writer); + } + } +} diff --git a/Assets/Mirror/Core/Threading/ConcurrentNetworkWriterPool.cs.meta b/Assets/Mirror/Core/Threading/ConcurrentNetworkWriterPool.cs.meta new file mode 100644 index 0000000..e973dad --- /dev/null +++ b/Assets/Mirror/Core/Threading/ConcurrentNetworkWriterPool.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: fdf46e334f52400c854c9732f6fcf005 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/Threading/ConcurrentNetworkWriterPooled.cs b/Assets/Mirror/Core/Threading/ConcurrentNetworkWriterPooled.cs new file mode 100644 index 0000000..ccb1e47 --- /dev/null +++ b/Assets/Mirror/Core/Threading/ConcurrentNetworkWriterPooled.cs @@ -0,0 +1,11 @@ +using System; + +namespace Mirror +{ + /// Pooled (not threadsafe) NetworkWriter used from Concurrent pool (thread safe). Automatically returned to concurrent pool when using 'using' + // TODO make sealed again after removing obsolete NetworkWriterPooled! + public class ConcurrentNetworkWriterPooled : NetworkWriter, IDisposable + { + public void Dispose() => ConcurrentNetworkWriterPool.Return(this); + } +} diff --git a/Assets/Mirror/Core/Threading/ConcurrentNetworkWriterPooled.cs.meta b/Assets/Mirror/Core/Threading/ConcurrentNetworkWriterPooled.cs.meta new file mode 100644 index 0000000..52a333e --- /dev/null +++ b/Assets/Mirror/Core/Threading/ConcurrentNetworkWriterPooled.cs.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: 9163d963b36b4e389318f312bfd8e488 +timeCreated: 1691485295 \ No newline at end of file diff --git a/Assets/Mirror/Core/Threading/ConcurrentPool.cs b/Assets/Mirror/Core/Threading/ConcurrentPool.cs new file mode 100644 index 0000000..eeac0cc --- /dev/null +++ b/Assets/Mirror/Core/Threading/ConcurrentPool.cs @@ -0,0 +1,44 @@ +// Pool to avoid allocations (from libuv2k) +// API consistent with Microsoft's ObjectPool. +// concurrent for thread safe access. +// +// currently not in use. keep it in case we need it again. +using System; +using System.Collections.Concurrent; +using System.Runtime.CompilerServices; + +namespace Mirror +{ + public class ConcurrentPool + { + // Mirror is single threaded, no need for concurrent collections + // concurrent bag is for items who's order doesn't matter. + // just about right for our use case here. + readonly ConcurrentBag objects = new ConcurrentBag(); + + // some types might need additional parameters in their constructor, so + // we use a Func generator + readonly Func objectGenerator; + + public ConcurrentPool(Func objectGenerator, int initialCapacity) + { + this.objectGenerator = objectGenerator; + + // allocate an initial pool so we have fewer (if any) + // allocations in the first few frames (or seconds). + for (int i = 0; i < initialCapacity; ++i) + objects.Add(objectGenerator()); + } + + // take an element from the pool, or create a new one if empty + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public T Get() => objects.TryTake(out T obj) ? obj : objectGenerator(); + + // return an element to the pool + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void Return(T item) => objects.Add(item); + + // count to see how many objects are in the pool. useful for tests. + public int Count => objects.Count; + } +} diff --git a/Assets/Mirror/Core/Threading/ConcurrentPool.cs.meta b/Assets/Mirror/Core/Threading/ConcurrentPool.cs.meta new file mode 100644 index 0000000..40e966a --- /dev/null +++ b/Assets/Mirror/Core/Threading/ConcurrentPool.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: ed304bd790ff478ca37233f66d04d1c6 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/Threading/ThreadLog.cs b/Assets/Mirror/Core/Threading/ThreadLog.cs new file mode 100644 index 0000000..36dca5f --- /dev/null +++ b/Assets/Mirror/Core/Threading/ThreadLog.cs @@ -0,0 +1,112 @@ +// threaded Debug.Log support (mischa 2022) +// +// Editor shows Debug.Logs from different threads. +// Builds don't show Debug.Logs from different threads. +// +// need to hook into logMessageReceivedThreaded to receive them in builds too. +using System.Collections.Concurrent; +using System.Threading; +using UnityEngine; + +namespace Mirror +{ + public static class ThreadLog + { + // queue log messages from threads + struct LogEntry + { + public int threadId; + public LogType type; + public string message; + public string stackTrace; + + public LogEntry(int threadId, LogType type, string message, string stackTrace) + { + this.threadId = threadId; + this.type = type; + this.message = message; + this.stackTrace = stackTrace; + } + } + + // ConcurrentQueue allocations are fine here. + // logs allocate anywway. + static readonly ConcurrentQueue logs = + new ConcurrentQueue(); + + // main thread id + static int mainThreadId; + +#if !UNITY_EDITOR + // Editor as of Unity 2021 does log threaded messages. + // only builds don't. + // do nothing in editor, otherwise we would log twice. + // before scene load ensures thread logs are all caught. + // otherwise some component's Awake may be called before we hooked it up. + // for example, ThreadedTransport's early logs wouldn't be caught. + [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)] + static void Initialize() + { + + // set main thread id + mainThreadId = Thread.CurrentThread.ManagedThreadId; + + // receive threaded log calls + Application.logMessageReceivedThreaded -= OnLog; // remove old first. TODO unnecessary? + Application.logMessageReceivedThreaded += OnLog; + + // process logs on main thread Update + NetworkLoop.OnLateUpdate -= OnLateUpdate; // remove old first. TODO unnecessary? + NetworkLoop.OnLateUpdate += OnLateUpdate; + + // log for debugging + Debug.Log("ThreadLog initialized."); + } +#endif + + static bool IsMainThread() => + Thread.CurrentThread.ManagedThreadId == mainThreadId; + + // callback runs on the same thread where the Debug.Log is called. + // we can use this to buffer messages for main thread here. + static void OnLog(string message, string stackTrace, LogType type) + { + // only enqueue messages from other threads. + // otherwise OnLateUpdate main thread logging would be enqueued + // as well, causing deadlock. + if (IsMainThread()) return; + + // queue for logging from main thread later + logs.Enqueue(new LogEntry(Thread.CurrentThread.ManagedThreadId, type, message, stackTrace)); + } + + static void OnLateUpdate() + { + // process queued logs on main thread + while (logs.TryDequeue(out LogEntry entry)) + { + switch (entry.type) + { + // add [Thread#] prefix to make it super obvious where this log message comes from. + // some projects may see unexpected messages that were previously hidden, + // since Unity wouldn't log them without ThreadLog.cs. + case LogType.Log: + Debug.Log($"[Thread{entry.threadId}] {entry.message}\n{entry.stackTrace}"); + break; + case LogType.Warning: + Debug.LogWarning($"[Thread{entry.threadId}] {entry.message}\n{entry.stackTrace}"); + break; + case LogType.Error: + Debug.LogError($"[Thread{entry.threadId}] {entry.message}\n{entry.stackTrace}"); + break; + case LogType.Exception: + Debug.LogError($"[Thread{entry.threadId}] {entry.message}\n{entry.stackTrace}"); + break; + case LogType.Assert: + Debug.LogAssertion($"[Thread{entry.threadId}] {entry.message}\n{entry.stackTrace}"); + break; + } + } + } + } +} diff --git a/Assets/Mirror/Core/Threading/ThreadLog.cs.meta b/Assets/Mirror/Core/Threading/ThreadLog.cs.meta new file mode 100644 index 0000000..bd0d5dd --- /dev/null +++ b/Assets/Mirror/Core/Threading/ThreadLog.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 22360406b3844808b0a305486758a703 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/Threading/WorkerThread.cs b/Assets/Mirror/Core/Threading/WorkerThread.cs new file mode 100644 index 0000000..4b037c0 --- /dev/null +++ b/Assets/Mirror/Core/Threading/WorkerThread.cs @@ -0,0 +1,165 @@ +// worker thread for Unity (mischa 2022) +// thread with proper exception handling, profling, init, cleanup, etc. for Unity. +// use this from main thread. +using System; +using System.Diagnostics; +using System.Threading; +using UnityEngine.Profiling; +using Debug = UnityEngine.Debug; + +namespace Mirror +{ + public class WorkerThread + { + readonly Thread thread; + + protected volatile bool active; + + // stopwatch so we don't need to use Unity's Time (engine independent) + readonly Stopwatch watch = new Stopwatch(); + + // callbacks need to be set after constructor. + // inheriting classes can't pass their member funcs to base ctor. + // don't set them while the thread is running! + public Action Init; + public Action Tick; + public Action Cleanup; + + public WorkerThread(string identifier) + { + // start the thread wrapped in safety guard + // if main application terminates, this thread needs to terminate too + thread = new Thread( + () => Guard(identifier) + ); + thread.IsBackground = true; + } + + public void Start() + { + // only if thread isn't already running + if (thread.IsAlive) + { + Debug.LogWarning("WorkerThread is still active, can't start it again."); + return; + } + + active = true; + thread.Start(); + } + + // signal the thread to stop gracefully. + // returns immediately, but the thread may take a while to stop. + // may be overwritten to clear more flags like 'computing' etc. + public virtual void SignalStop() => active = false; + + // wait for the thread to fully stop + public bool StopBlocking(float timeout) + { + // only if alive + if (!thread.IsAlive) return true; + + // double precision for long running servers. + watch.Restart(); + + // signal to stop + SignalStop(); + + // wait while thread is still alive + while (IsAlive) + { + // simply wait.. + Thread.Sleep(0); + + // deadlock detection + if (watch.Elapsed.TotalSeconds >= timeout) + { + // force kill all threads as last resort to stop them. + // return false to indicate deadlock. + Interrupt(); + return false; + } + } + return true; + } + + public bool IsAlive => thread.IsAlive; + + // signal an interrupt in the thread. + // this function is very safe to use. + // https://stackoverflow.com/questions/5950994/thread-abort-vs-thread-interrupt + // + // note this does not always kill the thread: + // "If this thread is not currently blocked in a wait, sleep, or join + // state, it will be interrupted when it next begins to block." + // https://docs.microsoft.com/en-us/dotnet/api/system.threading.thread.interrupt?view=net-6.0 + // + // in other words, "while (true) {}" wouldn't throw an interrupt exception. + // and that's _okay_. using interrupt is safe & best practice. + // => Unity still aborts deadlocked threads on script reload. + // => and we catch + warn on AbortException. + public void Interrupt() => thread.Interrupt(); + + // thread constructor needs callbacks. + // always define them, and make them call actions. + // those can be set at any time. + void OnInit() => Init?.Invoke(); + void OnTick() => Tick?.Invoke(); + void OnCleanup() => Cleanup?.Invoke(); + + // guarded wrapper for thread code. + // catches exceptions which would otherwise be silent. + // shows in Unity profiler. + // etc. + public void Guard(string identifier) + { + try + { + // log when work begins = thread starts. + // very important for debugging threads. + Debug.Log($"{identifier}: started."); + + // show this thread in Unity profiler + Profiler.BeginThreadProfiling("Mirror Worker Threads", $"{identifier}"); + + // run init once + OnInit(); + + // run thread func while active + while (active) + { + OnTick(); + } + } + // Thread.Interrupt() will gracefully raise a InterruptedException. + catch (ThreadInterruptedException) + { + Debug.Log($"{identifier}: interrupted. That's okay."); + } + // Unity domain reload will cause a ThreadAbortException. + // for example, when saving a changed script while in play mode. + catch (ThreadAbortException) + { + Debug.LogWarning($"{identifier}: aborted. This may happen after domain reload. That's okay."); + } + catch (Exception e) + { + Debug.LogException(e); + } + finally + { + // run cleanup (if any) + active = false; + OnCleanup(); + + // remove this thread from Unity profiler + Profiler.EndThreadProfiling(); + + // log when work ends = thread terminates. + // very important for debugging threads. + // 'finally' to log no matter what (even if exceptions) + Debug.Log($"{identifier}: ended."); + } + } + } +} diff --git a/Assets/Mirror/Core/Threading/WorkerThread.cs.meta b/Assets/Mirror/Core/Threading/WorkerThread.cs.meta new file mode 100644 index 0000000..7427cd4 --- /dev/null +++ b/Assets/Mirror/Core/Threading/WorkerThread.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 605fa1d7e32f40a08e5549bb43fc5c07 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/Tools.meta b/Assets/Mirror/Core/Tools.meta new file mode 100644 index 0000000..8319cae --- /dev/null +++ b/Assets/Mirror/Core/Tools.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: d9c73cc2749d43268600b80df0b55c4d +timeCreated: 1667486812 \ No newline at end of file diff --git a/Assets/Mirror/Core/Tools/AccurateInterval.cs b/Assets/Mirror/Core/Tools/AccurateInterval.cs new file mode 100644 index 0000000..9d2ce0e --- /dev/null +++ b/Assets/Mirror/Core/Tools/AccurateInterval.cs @@ -0,0 +1,86 @@ +// accurate interval from Mirror II. +// for sync / send intervals where it matters. +// does not(!) do catch-up. +// +// first, let's understand the problem. +// say we need an interval of 10 Hz, so every 100ms in Update we do: +// if (Time.time >= lastTime + interval) +// { +// lastTime = Time.time; +// ... +// } +// +// this seems fine, but actually Time.time will always be a few ms beyond +// the interval. but since lastTime is reset to Time.time, the remainder +// is always ignored away. +// with fixed tickRate servers (say 30 Hz), the remainder is significant! +// +// in practice if we have a 30 Hz tickRate server with a 30 Hz sendRate, +// the above way to measure the interval would result in a 18-19 Hz sendRate! +// => this is not just a little off. this is _way_ off, by almost half. +// => displaying actual + target tick/send rate will show this very easily. +// +// we need an accurate way to measure intervals for where it matters. +// and it needs to be testable to guarantee results. +using System.Runtime.CompilerServices; + +namespace Mirror +{ + public static class AccurateInterval + { + // static func instead of storing interval + lastTime struct. + // + don't need to initialize struct ctor with interval in Awake + // + allows for interval changes at runtime too + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static bool Elapsed(double time, double interval, ref double lastTime) + { + // enough time elapsed? + if (time < lastTime + interval) + return false; + + // naive implementation: + //lastTime = time; + + // accurate but doesn't handle heavy load situations: + //lastTime += interval; + + // heavy load edge case: + // * interval is 100ms + // * server is under heavy load, Updates slow down to 1/s + // * Elapsed(1.000) returns true. + // technically 10 intervals have elapsed. + // * server recovers to normal, Updates are every 10ms again + // * Elapsed(1.010) should return false again until 1.100. + // + // increasing lastTime by interval would require 10 more calls + // to ever catch up again: + // lastTime += interval + // + // as result, the next 10 calls to Elapsed would return true. + // Elapsed(1.001) => true + // Elapsed(1.002) => true + // Elapsed(1.003) => true + // ... + // even though technically the delta was not >= interval. + // + // this would keep the server under heavy load, and it may never + // catch-up. this is not ideal for large virtual worlds. + // + // instead, we want to skip multiples of 'interval' and only + // keep the remainder. + // + // see also: AccurateIntervalTests.Slowdown() + + // easy to understand: + //double elapsed = time - lastTime; + //double remainder = elapsed % interval; + //lastTime = time - remainder; + + // easier: set to rounded multiples of interval (fholm). + // long to match double time. + long multiplier = (long)(time / interval); + lastTime = multiplier * interval; + return true; + } + } +} diff --git a/Assets/Mirror/Core/Tools/AccurateInterval.cs.meta b/Assets/Mirror/Core/Tools/AccurateInterval.cs.meta new file mode 100644 index 0000000..a58184d --- /dev/null +++ b/Assets/Mirror/Core/Tools/AccurateInterval.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: c1b18064e25046f28b88db65a4012ec1 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/Tools/Compression.cs b/Assets/Mirror/Core/Tools/Compression.cs new file mode 100644 index 0000000..d04b566 --- /dev/null +++ b/Assets/Mirror/Core/Tools/Compression.cs @@ -0,0 +1,556 @@ +// Quaternion compression from DOTSNET +using System; +using System.Runtime.CompilerServices; +using UnityEngine; + +namespace Mirror +{ + /// Functions to Compress Quaternions and Floats + public static class Compression + { + // divide by precision (functions backported from Mirror II) + // for example, 0.1 cm precision converts '5.0f' float to '50' long. + // + // 'long' instead of 'int' to allow for large enough worlds. + // value / precision exceeds int.max range too easily. + // Convert.ToInt32/64 would throw. + // https://github.com/vis2k/DOTSNET/issues/59 + // + // 'long' and 'int' will result in the same bandwidth though. + // for example, ScaleToLong(10.5, 0.1) = 105. + // int: 0x00000069 + // long: 0x0000000000000069 + // delta compression will reduce both to 1 byte. + // + // returns + // 'true' if scaling was possible within 'long' bounds. + // 'false' if clamping was necessary. + // never throws. checking result is optional. + public static bool ScaleToLong(float value, float precision, out long result) + { + // user might try to pass precision = 0 to disable rounding. + // this is not supported. + // throw to make the user fix this immediately. + // otherwise we would have to reinterpret-cast if ==0 etc. + // this function should be kept simple. + // if rounding isn't wanted, this function shouldn't be called. + if (precision == 0) throw new DivideByZeroException($"ScaleToLong: precision=0 would cause null division. If rounding isn't wanted, don't call this function."); + + // catch OverflowException if value/precision > long.max. + // attackers should never be able to throw exceptions. + try + { + result = Convert.ToInt64(value / precision); + return true; + } + // clamp to .max/.min. + // returning '0' would make far away entities reset to origin. + // returning 'max' would keep them stuck at the end of the world. + // the latter is much easier to debug. + catch (OverflowException) + { + result = value > 0 ? long.MaxValue : long.MinValue; + return false; + } + } + + // returns + // 'true' if scaling was possible within 'long' bounds. + // 'false' if clamping was necessary. + // never throws. checking result is optional. + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static bool ScaleToLong(Vector3 value, float precision, out long x, out long y, out long z) + { + // attempt to convert every component. + // do not return early if one conversion returned 'false'. + // the return value is optional. always attempt to convert all. + bool result = true; + result &= ScaleToLong(value.x, precision, out x); + result &= ScaleToLong(value.y, precision, out y); + result &= ScaleToLong(value.z, precision, out z); + return result; + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static bool ScaleToLong(Vector3 value, float precision, out Vector3Long quantized) + { + quantized = Vector3Long.zero; + return ScaleToLong(value, precision, out quantized.x, out quantized.y, out quantized.z); + } + + // multiple by precision. + // for example, 0.1 cm precision converts '50' long to '5.0f' float. + public static float ScaleToFloat(long value, float precision) + { + // user might try to pass precision = 0 to disable rounding. + // this is not supported. + // throw to make the user fix this immediately. + // otherwise we would have to reinterpret-cast if ==0 etc. + // this function should be kept simple. + // if rounding isn't wanted, this function shouldn't be called. + if (precision == 0) throw new DivideByZeroException($"ScaleToLong: precision=0 would cause null division. If rounding isn't wanted, don't call this function."); + + return value * precision; + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static Vector3 ScaleToFloat(long x, long y, long z, float precision) + { + Vector3 v; + v.x = ScaleToFloat(x, precision); + v.y = ScaleToFloat(y, precision); + v.z = ScaleToFloat(z, precision); + return v; + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static Vector3 ScaleToFloat(Vector3Long value, float precision) => + ScaleToFloat(value.x, value.y, value.z, precision); + + // scale a float within min/max range to an ushort between min/max range + // note: can also use this for byte range from byte.MinValue to byte.MaxValue + public static ushort ScaleFloatToUShort(float value, float minValue, float maxValue, ushort minTarget, ushort maxTarget) + { + // note: C# ushort - ushort => int, hence so many casts + // max ushort - min ushort only fits into something bigger + int targetRange = maxTarget - minTarget; + float valueRange = maxValue - minValue; + float valueRelative = value - minValue; + return (ushort)(minTarget + (ushort)(valueRelative / valueRange * targetRange)); + } + + // scale an ushort within min/max range to a float between min/max range + // note: can also use this for byte range from byte.MinValue to byte.MaxValue + public static float ScaleUShortToFloat(ushort value, ushort minValue, ushort maxValue, float minTarget, float maxTarget) + { + // note: C# ushort - ushort => int, hence so many casts + float targetRange = maxTarget - minTarget; + ushort valueRange = (ushort)(maxValue - minValue); + ushort valueRelative = (ushort)(value - minValue); + return minTarget + (valueRelative / (float)valueRange * targetRange); + } + + // quaternion compression ////////////////////////////////////////////// + // smallest three: https://gafferongames.com/post/snapshot_compression/ + // compresses 16 bytes quaternion into 4 bytes + + // helper function to find largest absolute element + // returns the index of the largest one + public static int LargestAbsoluteComponentIndex(Vector4 value, out float largestAbs, out Vector3 withoutLargest) + { + // convert to abs + Vector4 abs = new Vector4(Mathf.Abs(value.x), Mathf.Abs(value.y), Mathf.Abs(value.z), Mathf.Abs(value.w)); + + // set largest to first abs (x) + largestAbs = abs.x; + withoutLargest = new Vector3(value.y, value.z, value.w); + int largestIndex = 0; + + // compare to the others, starting at second value + // performance for 100k calls + // for-loop: 25ms + // manual checks: 22ms + if (abs.y > largestAbs) + { + largestIndex = 1; + largestAbs = abs.y; + withoutLargest = new Vector3(value.x, value.z, value.w); + } + if (abs.z > largestAbs) + { + largestIndex = 2; + largestAbs = abs.z; + withoutLargest = new Vector3(value.x, value.y, value.w); + } + if (abs.w > largestAbs) + { + largestIndex = 3; + largestAbs = abs.w; + withoutLargest = new Vector3(value.x, value.y, value.z); + } + + return largestIndex; + } + + const float QuaternionMinRange = -0.707107f; + const float QuaternionMaxRange = 0.707107f; + const ushort TenBitsMax = 0b11_1111_1111; + + // note: assumes normalized quaternions + public static uint CompressQuaternion(Quaternion q) + { + // note: assuming normalized quaternions is enough. no need to force + // normalize here. we already normalize when decompressing. + + // find the largest component index [0,3] + value + int largestIndex = LargestAbsoluteComponentIndex(new Vector4(q.x, q.y, q.z, q.w), out float _, out Vector3 withoutLargest); + + // from here on, we work with the 3 components without largest! + + // "You might think you need to send a sign bit for [largest] in + // case it is negative, but you don’t, because you can make + // [largest] always positive by negating the entire quaternion if + // [largest] is negative. in quaternion space (x,y,z,w) and + // (-x,-y,-z,-w) represent the same rotation." + if (q[largestIndex] < 0) + withoutLargest = -withoutLargest; + + // put index & three floats into one integer. + // => index is 2 bits (4 values require 2 bits to store them) + // => the three floats are between [-0.707107,+0.707107] because: + // "If v is the absolute value of the largest quaternion + // component, the next largest possible component value occurs + // when two components have the same absolute value and the + // other two components are zero. The length of that quaternion + // (v,v,0,0) is 1, therefore v^2 + v^2 = 1, 2v^2 = 1, + // v = 1/sqrt(2). This means you can encode the smallest three + // components in [-0.707107,+0.707107] instead of [-1,+1] giving + // you more precision with the same number of bits." + // => the article recommends storing each float in 9 bits + // => our uint has 32 bits, so we might as well store in (32-2)/3=10 + // 10 bits max value: 1023=0x3FF (use OSX calc to flip 10 bits) + ushort aScaled = ScaleFloatToUShort(withoutLargest.x, QuaternionMinRange, QuaternionMaxRange, 0, TenBitsMax); + ushort bScaled = ScaleFloatToUShort(withoutLargest.y, QuaternionMinRange, QuaternionMaxRange, 0, TenBitsMax); + ushort cScaled = ScaleFloatToUShort(withoutLargest.z, QuaternionMinRange, QuaternionMaxRange, 0, TenBitsMax); + + // now we just need to pack them into one integer + // -> index is 2 bit and needs to be shifted to 31..32 + // -> a is 10 bit and needs to be shifted 20..30 + // -> b is 10 bit and needs to be shifted 10..20 + // -> c is 10 bit and needs to be at 0..10 + return (uint)(largestIndex << 30 | aScaled << 20 | bScaled << 10 | cScaled); + } + + // Quaternion normalizeSAFE from ECS math.normalizesafe() + // => useful to produce valid quaternions even if client sends invalid + // data + [MethodImpl(MethodImplOptions.AggressiveInlining)] + static Quaternion QuaternionNormalizeSafe(Quaternion value) + { + // The smallest positive normal number representable in a float. + const float FLT_MIN_NORMAL = 1.175494351e-38F; + + Vector4 v = new Vector4(value.x, value.y, value.z, value.w); + float length = Vector4.Dot(v, v); + return length > FLT_MIN_NORMAL + ? value.normalized + : Quaternion.identity; + } + + // note: gives normalized quaternions + public static Quaternion DecompressQuaternion(uint data) + { + // get cScaled which is at 0..10 and ignore the rest + ushort cScaled = (ushort)(data & TenBitsMax); + + // get bScaled which is at 10..20 and ignore the rest + ushort bScaled = (ushort)((data >> 10) & TenBitsMax); + + // get aScaled which is at 20..30 and ignore the rest + ushort aScaled = (ushort)((data >> 20) & TenBitsMax); + + // get 2 bit largest index, which is at 31..32 + int largestIndex = (int)(data >> 30); + + // scale back to floats + float a = ScaleUShortToFloat(aScaled, 0, TenBitsMax, QuaternionMinRange, QuaternionMaxRange); + float b = ScaleUShortToFloat(bScaled, 0, TenBitsMax, QuaternionMinRange, QuaternionMaxRange); + float c = ScaleUShortToFloat(cScaled, 0, TenBitsMax, QuaternionMinRange, QuaternionMaxRange); + + // calculate the omitted component based on a²+b²+c²+d²=1 + float d = Mathf.Sqrt(1 - a*a - b*b - c*c); + + // reconstruct based on largest index + Vector4 value; + switch (largestIndex) + { + case 0: value = new Vector4(d, a, b, c); break; + case 1: value = new Vector4(a, d, b, c); break; + case 2: value = new Vector4(a, b, d, c); break; + default: value = new Vector4(a, b, c, d); break; + } + + // ECS Rotation only works with normalized quaternions. + // make sure that's always the case here to avoid ECS bugs where + // everything stops moving if the quaternion isn't normalized. + // => NormalizeSafe returns a normalized quaternion even if we pass + // in NaN from deserializing invalid values! + return QuaternionNormalizeSafe(new Quaternion(value.x, value.y, value.z, value.w)); + } + + // varint compression ////////////////////////////////////////////////// + // helper function to predict varint size for a given number. + // useful when checking if a message + size header will fit, etc. + public static int VarUIntSize(ulong value) + { + if (value <= 240) + return 1; + if (value <= 2287) + return 2; + if (value <= 67823) + return 3; + if (value <= 16777215) + return 4; + if (value <= 4294967295) + return 5; + if (value <= 1099511627775) + return 6; + if (value <= 281474976710655) + return 7; + if (value <= 72057594037927935) + return 8; + return 9; + } + + // helper function to predict varint size for a given number. + // useful when checking if a message + size header will fit, etc. + public static int VarIntSize(long value) + { + // CompressVarInt zigzags it first + ulong zigzagged = (ulong)((value >> 63) ^ (value << 1)); + return VarUIntSize(zigzagged); + } + + // compress ulong varint. + // same result for ulong, uint, ushort and byte. only need one function. + // NOT an extension. otherwise weaver might accidentally use it. + public static void CompressVarUInt(NetworkWriter writer, ulong value) + { + // straight forward implementation: + // keep this for understanding & debugging. + /* + if (value <= 240) + { + writer.WriteByte((byte)value); + return; + } + if (value <= 2287) + { + writer.WriteByte((byte)(((value - 240) >> 8) + 241)); + writer.WriteByte((byte)((value - 240) & 0xFF)); + return; + } + if (value <= 67823) + { + writer.WriteByte((byte)249); + writer.WriteByte((byte)((value - 2288) >> 8)); + writer.WriteByte((byte)((value - 2288) & 0xFF)); + return; + } + if (value <= 16777215) + { + writer.WriteByte((byte)250); + writer.WriteByte((byte)(value & 0xFF)); + writer.WriteByte((byte)((value >> 8) & 0xFF)); + writer.WriteByte((byte)((value >> 16) & 0xFF)); + return; + } + if (value <= 4294967295) + { + writer.WriteByte((byte)251); + writer.WriteByte((byte)(value & 0xFF)); + writer.WriteByte((byte)((value >> 8) & 0xFF)); + writer.WriteByte((byte)((value >> 16) & 0xFF)); + writer.WriteByte((byte)((value >> 24) & 0xFF)); + return; + } + if (value <= 1099511627775) + { + writer.WriteByte((byte)252); + writer.WriteByte((byte)(value & 0xFF)); + writer.WriteByte((byte)((value >> 8) & 0xFF)); + writer.WriteByte((byte)((value >> 16) & 0xFF)); + writer.WriteByte((byte)((value >> 24) & 0xFF)); + writer.WriteByte((byte)((value >> 32) & 0xFF)); + return; + } + if (value <= 281474976710655) + { + writer.WriteByte((byte)253); + writer.WriteByte((byte)(value & 0xFF)); + writer.WriteByte((byte)((value >> 8) & 0xFF)); + writer.WriteByte((byte)((value >> 16) & 0xFF)); + writer.WriteByte((byte)((value >> 24) & 0xFF)); + writer.WriteByte((byte)((value >> 32) & 0xFF)); + writer.WriteByte((byte)((value >> 40) & 0xFF)); + return; + } + if (value <= 72057594037927935) + { + writer.WriteByte((byte)254); + writer.WriteByte((byte)(value & 0xFF)); + writer.WriteByte((byte)((value >> 8) & 0xFF)); + writer.WriteByte((byte)((value >> 16) & 0xFF)); + writer.WriteByte((byte)((value >> 24) & 0xFF)); + writer.WriteByte((byte)((value >> 32) & 0xFF)); + writer.WriteByte((byte)((value >> 40) & 0xFF)); + writer.WriteByte((byte)((value >> 48) & 0xFF)); + return; + } + + // all others + { + writer.WriteByte((byte)255); + writer.WriteByte((byte)(value & 0xFF)); + writer.WriteByte((byte)((value >> 8) & 0xFF)); + writer.WriteByte((byte)((value >> 16) & 0xFF)); + writer.WriteByte((byte)((value >> 24) & 0xFF)); + writer.WriteByte((byte)((value >> 32) & 0xFF)); + writer.WriteByte((byte)((value >> 40) & 0xFF)); + writer.WriteByte((byte)((value >> 48) & 0xFF)); + writer.WriteByte((byte)((value >> 56) & 0xFF)); + } + */ + + // faster implementation writes multiple bytes at once. + // avoids extra Space, WriteBlittable overhead. + // VarInt is in hot path, performance matters here. + if (value <= 240) + { + byte a = (byte)value; + writer.WriteByte(a); + return; + } + if (value <= 2287) + { + byte a = (byte)(((value - 240) >> 8) + 241); + byte b = (byte)((value - 240) & 0xFF); + writer.WriteUShort((ushort)(b << 8 | a)); + return; + } + if (value <= 67823) + { + byte a = (byte)249; + byte b = (byte)((value - 2288) >> 8); + byte c = (byte)((value - 2288) & 0xFF); + writer.WriteByte(a); + writer.WriteUShort((ushort)(c << 8 | b)); + return; + } + if (value <= 16777215) + { + byte a = (byte)250; + uint b = (uint)(value << 8); + writer.WriteUInt(b | a); + return; + } + if (value <= 4294967295) + { + byte a = (byte)251; + uint b = (uint)value; + writer.WriteByte(a); + writer.WriteUInt(b); + return; + } + if (value <= 1099511627775) + { + byte a = (byte)252; + byte b = (byte)(value & 0xFF); + uint c = (uint)(value >> 8); + writer.WriteUShort((ushort)(b << 8 | a)); + writer.WriteUInt(c); + return; + } + if (value <= 281474976710655) + { + byte a = (byte)253; + byte b = (byte)(value & 0xFF); + byte c = (byte)((value >> 8) & 0xFF); + uint d = (uint)(value >> 16); + writer.WriteByte(a); + writer.WriteUShort((ushort)(c << 8 | b)); + writer.WriteUInt(d); + return; + } + if (value <= 72057594037927935) + { + byte a = 254; + ulong b = value << 8; + writer.WriteULong(b | a); + return; + } + + // all others + { + writer.WriteByte(255); + writer.WriteULong(value); + } + } + + // zigzag encoding https://gist.github.com/mfuerstenau/ba870a29e16536fdbaba + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static void CompressVarInt(NetworkWriter writer, long i) + { + ulong zigzagged = (ulong)((i >> 63) ^ (i << 1)); + CompressVarUInt(writer, zigzagged); + } + + // NOT an extension. otherwise weaver might accidentally use it. + public static ulong DecompressVarUInt(NetworkReader reader) + { + byte a0 = reader.ReadByte(); + if (a0 < 241) + { + return a0; + } + + byte a1 = reader.ReadByte(); + if (a0 <= 248) + { + return 240 + ((a0 - (ulong)241) << 8) + a1; + } + + byte a2 = reader.ReadByte(); + if (a0 == 249) + { + return 2288 + ((ulong)a1 << 8) + a2; + } + + byte a3 = reader.ReadByte(); + if (a0 == 250) + { + return a1 + (((ulong)a2) << 8) + (((ulong)a3) << 16); + } + + byte a4 = reader.ReadByte(); + if (a0 == 251) + { + return a1 + (((ulong)a2) << 8) + (((ulong)a3) << 16) + (((ulong)a4) << 24); + } + + byte a5 = reader.ReadByte(); + if (a0 == 252) + { + return a1 + (((ulong)a2) << 8) + (((ulong)a3) << 16) + (((ulong)a4) << 24) + (((ulong)a5) << 32); + } + + byte a6 = reader.ReadByte(); + if (a0 == 253) + { + return a1 + (((ulong)a2) << 8) + (((ulong)a3) << 16) + (((ulong)a4) << 24) + (((ulong)a5) << 32) + (((ulong)a6) << 40); + } + + byte a7 = reader.ReadByte(); + if (a0 == 254) + { + return a1 + (((ulong)a2) << 8) + (((ulong)a3) << 16) + (((ulong)a4) << 24) + (((ulong)a5) << 32) + (((ulong)a6) << 40) + (((ulong)a7) << 48); + } + + byte a8 = reader.ReadByte(); + if (a0 == 255) + { + return a1 + (((ulong)a2) << 8) + (((ulong)a3) << 16) + (((ulong)a4) << 24) + (((ulong)a5) << 32) + (((ulong)a6) << 40) + (((ulong)a7) << 48) + (((ulong)a8) << 56); + } + + throw new IndexOutOfRangeException($"DecompressVarInt failure: {a0}"); + } + + // zigzag decoding https://gist.github.com/mfuerstenau/ba870a29e16536fdbaba + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static long DecompressVarInt(NetworkReader reader) + { + ulong data = DecompressVarUInt(reader); + return ((long)(data >> 1)) ^ -((long)data & 1); + } + } +} diff --git a/Assets/Mirror/Core/Tools/Compression.cs.meta b/Assets/Mirror/Core/Tools/Compression.cs.meta new file mode 100644 index 0000000..e35474b --- /dev/null +++ b/Assets/Mirror/Core/Tools/Compression.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 5c28963f9c4b97e418252a55500fb91e +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/Tools/DeltaCompression.cs b/Assets/Mirror/Core/Tools/DeltaCompression.cs new file mode 100644 index 0000000..a59370a --- /dev/null +++ b/Assets/Mirror/Core/Tools/DeltaCompression.cs @@ -0,0 +1,38 @@ +// manual delta compression for some types. +// varint(b-a) +// Mirror can't use Mirror II's bit-tree delta compression. +using System.Runtime.CompilerServices; + +namespace Mirror +{ + public static class DeltaCompression + { + // delta (usually small), then zigzag varint to support +- changes + // parameter order: (last, current) makes most sense (Q3 does this too). + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static void Compress(NetworkWriter writer, long last, long current) => + Compression.CompressVarInt(writer, current - last); + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static long Decompress(NetworkReader reader, long last) => + last + Compression.DecompressVarInt(reader); + + // delta (usually small), then zigzag varint to support +- changes + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static void Compress(NetworkWriter writer, Vector3Long last, Vector3Long current) + { + Compress(writer, last.x, current.x); + Compress(writer, last.y, current.y); + Compress(writer, last.z, current.z); + } + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static Vector3Long Decompress(NetworkReader reader, Vector3Long last) + { + long x = Decompress(reader, last.x); + long y = Decompress(reader, last.y); + long z = Decompress(reader, last.z); + return new Vector3Long(x, y, z); + } + } +} diff --git a/Assets/Mirror/Core/Tools/DeltaCompression.cs.meta b/Assets/Mirror/Core/Tools/DeltaCompression.cs.meta new file mode 100644 index 0000000..a7b2c8b --- /dev/null +++ b/Assets/Mirror/Core/Tools/DeltaCompression.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 6b8f3fffcb4754c15bc5ed4c33e2497b +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/Tools/ExponentialMovingAverage.cs b/Assets/Mirror/Core/Tools/ExponentialMovingAverage.cs new file mode 100644 index 0000000..674abb8 --- /dev/null +++ b/Assets/Mirror/Core/Tools/ExponentialMovingAverage.cs @@ -0,0 +1,53 @@ +// N-day EMA implementation from Mirror with a few changes (struct etc.) +// it calculates an exponential moving average roughly equivalent to the last n observations +// https://en.wikipedia.org/wiki/Moving_average#Exponential_moving_average +using System; + +namespace Mirror +{ + public struct ExponentialMovingAverage + { + readonly double alpha; + bool initialized; + + public double Value; + public double Variance; + public double StandardDeviation; // absolute value, see test + + public ExponentialMovingAverage(int n) + { + // standard N-day EMA alpha calculation + alpha = 2.0 / (n + 1); + initialized = false; + Value = 0; + Variance = 0; + StandardDeviation = 0; + } + + public void Add(double newValue) + { + // simple algorithm for EMA described here: + // https://en.wikipedia.org/wiki/Moving_average#Exponentially_weighted_moving_variance_and_standard_deviation + if (initialized) + { + double delta = newValue - Value; + Value += alpha * delta; + Variance = (1 - alpha) * (Variance + alpha * delta * delta); + StandardDeviation = Math.Sqrt(Variance); + } + else + { + Value = newValue; + initialized = true; + } + } + + public void Reset() + { + initialized = false; + Value = 0; + Variance = 0; + StandardDeviation = 0; + } + } +} diff --git a/Assets/Mirror/Core/Tools/ExponentialMovingAverage.cs.meta b/Assets/Mirror/Core/Tools/ExponentialMovingAverage.cs.meta new file mode 100644 index 0000000..d0d8210 --- /dev/null +++ b/Assets/Mirror/Core/Tools/ExponentialMovingAverage.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 05e858cbaa54b4ce4a48c8c7f50c1914 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/Tools/Extensions.cs b/Assets/Mirror/Core/Tools/Extensions.cs new file mode 100644 index 0000000..196be4b --- /dev/null +++ b/Assets/Mirror/Core/Tools/Extensions.cs @@ -0,0 +1,112 @@ +using System; +using System.Collections.Concurrent; +using System.Collections.Generic; +using System.Runtime.CompilerServices; +using UnityEngine; + +namespace Mirror +{ + public static class Extensions + { + public static string ToHexString(this ArraySegment segment) => + BitConverter.ToString(segment.Array, segment.Offset, segment.Count); + + // string.GetHashCode is not guaranteed to be the same on all + // machines, but we need one that is the same on all machines. + // Uses fnv1a as hash function for more uniform distribution http://www.isthe.com/chongo/tech/comp/fnv/ + // Tests: https://softwareengineering.stackexchange.com/questions/49550/which-hashing-algorithm-is-best-for-uniqueness-and-speed + // NOTE: Do not call this from hot path because it's slow O(N) for long method names. + // - As of 2012-02-16 There are 2 design-time callers (weaver) and 1 runtime caller that caches. + public static int GetStableHashCode(this string text) + { + unchecked + { + uint hash = 0x811c9dc5; + uint prime = 0x1000193; + + for (int i = 0; i < text.Length; ++i) + { + byte value = (byte)text[i]; + hash = hash ^ value; + hash *= prime; + } + + //UnityEngine.Debug.Log($"Created stable hash {(ushort)hash} for {text}"); + return (int)hash; + } + } + + // smaller version of our GetStableHashCode. + // careful, this significantly increases chance of collisions. + public static ushort GetStableHashCode16(this string text) + { + // deterministic hash + int hash = GetStableHashCode(text); + + // Gets the 32bit fnv1a hash + // To get it down to 16bit but still reduce hash collisions we cant just cast it to ushort + // Instead we take the highest 16bits of the 32bit hash and fold them with xor into the lower 16bits + // This will create a more uniform 16bit hash, the method is described in: + // http://www.isthe.com/chongo/tech/comp/fnv/ in section "Changing the FNV hash size - xor-folding" + return (ushort)((hash >> 16) ^ hash); + } + + // previously in DotnetCompatibility.cs + // leftover from the UNET days. supposedly for windows store? + internal static string GetMethodName(this Delegate func) + { +#if NETFX_CORE + return func.GetMethodInfo().Name; +#else + return func.Method.Name; +#endif + } + + // helper function to copy to List + // C# only provides CopyTo(T[]) + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static void CopyTo(this IEnumerable source, List destination) + { + // foreach allocates. use AddRange. + destination.AddRange(source); + } + +#if !UNITY_2021_OR_NEWER + // Unity 2020 and earlier don't have Queue.TryDequeue which we need for batching. + public static bool TryDequeue(this Queue source, out T element) + { + if (source.Count > 0) + { + element = source.Dequeue(); + return true; + } + + element = default; + return false; + } +#endif + +#if !UNITY_2021_OR_NEWER + // Unity 2020 and earlier don't have ConcurrentQueue.Clear which we need for ThreadedTransport. + public static void Clear(this ConcurrentQueue source) + { + // while count > 0 risks deadlock if other thread write at the same time. + // our safest solution is a best-effort approach to clear 'Count' once. + int count = source.Count; // get it only once + for (int i = 0; i < count; ++i) + { + source.TryDequeue(out _); + } + } +#endif + +#if !UNITY_2021_3_OR_NEWER + // Unity 2021.2 and earlier don't have transform.GetPositionAndRotation which we use for performance in some places + public static void GetPositionAndRotation(this Transform transform, out Vector3 position, out Quaternion rotation) + { + position = transform.position; + rotation = transform.rotation; + } +#endif + } +} diff --git a/Assets/Mirror/Core/Tools/Extensions.cs.meta b/Assets/Mirror/Core/Tools/Extensions.cs.meta new file mode 100644 index 0000000..c2a18b7 --- /dev/null +++ b/Assets/Mirror/Core/Tools/Extensions.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: decf32fd053744d18f35712b7a6f5116 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/Tools/Mathd.cs b/Assets/Mirror/Core/Tools/Mathd.cs new file mode 100644 index 0000000..374471a --- /dev/null +++ b/Assets/Mirror/Core/Tools/Mathd.cs @@ -0,0 +1,32 @@ +// 'double' precision variants for some of Unity's Mathf functions. +using System.Runtime.CompilerServices; + +namespace Mirror +{ + public static class Mathd + { + // Unity 2020 doesn't have Math.Clamp yet. + /// Clamps value between 0 and 1 and returns value. + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static double Clamp(double value, double min, double max) + { + if (value < min) return min; + if (value > max) return max; + return value; + } + + /// Clamps value between 0 and 1 and returns value. + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static double Clamp01(double value) => Clamp(value, 0, 1); + + /// Calculates the linear parameter t that produces the interpolant value within the range [a, b]. + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static double InverseLerp(double a, double b, double value) => + a != b ? Clamp01((value - a) / (b - a)) : 0; + + /// Linearly interpolates between a and b by t with no limit to t. + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static double LerpUnclamped(double a, double b, double t) => + a + (b - a) * t; + } +} diff --git a/Assets/Mirror/Core/Tools/Mathd.cs.meta b/Assets/Mirror/Core/Tools/Mathd.cs.meta new file mode 100644 index 0000000..927c55a --- /dev/null +++ b/Assets/Mirror/Core/Tools/Mathd.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 5f74084b91c74df2839b426c4a381373 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/Tools/Pool.cs b/Assets/Mirror/Core/Tools/Pool.cs new file mode 100644 index 0000000..e204575 --- /dev/null +++ b/Assets/Mirror/Core/Tools/Pool.cs @@ -0,0 +1,40 @@ +// Pool to avoid allocations (from libuv2k) +// API consistent with Microsoft's ObjectPool. +using System; +using System.Collections.Generic; +using System.Runtime.CompilerServices; + +namespace Mirror +{ + public class Pool + { + // Mirror is single threaded, no need for concurrent collections. + // stack increases the chance that a reused writer remains in cache. + readonly Stack objects = new Stack(); + + // some types might need additional parameters in their constructor, so + // we use a Func generator + readonly Func objectGenerator; + + public Pool(Func objectGenerator, int initialCapacity) + { + this.objectGenerator = objectGenerator; + + // allocate an initial pool so we have fewer (if any) + // allocations in the first few frames (or seconds). + for (int i = 0; i < initialCapacity; ++i) + objects.Push(objectGenerator()); + } + + // take an element from the pool, or create a new one if empty + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public T Get() => objects.Count > 0 ? objects.Pop() : objectGenerator(); + + // return an element to the pool + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public void Return(T item) => objects.Push(item); + + // count to see how many objects are in the pool. useful for tests. + public int Count => objects.Count; + } +} diff --git a/Assets/Mirror/Core/Tools/Pool.cs.meta b/Assets/Mirror/Core/Tools/Pool.cs.meta new file mode 100644 index 0000000..7d12a20 --- /dev/null +++ b/Assets/Mirror/Core/Tools/Pool.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 845bb05fa349344c3811022f4f15dfbc +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/Tools/Readme.txt b/Assets/Mirror/Core/Tools/Readme.txt new file mode 100644 index 0000000..09bd920 --- /dev/null +++ b/Assets/Mirror/Core/Tools/Readme.txt @@ -0,0 +1 @@ +Standalone algorithms & structs to help build Mirror. \ No newline at end of file diff --git a/Assets/Mirror/Core/Tools/Readme.txt.meta b/Assets/Mirror/Core/Tools/Readme.txt.meta new file mode 100644 index 0000000..5536ca7 --- /dev/null +++ b/Assets/Mirror/Core/Tools/Readme.txt.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: da033671de7d49e0838223a997c56bf1 +timeCreated: 1667486850 \ No newline at end of file diff --git a/Assets/Mirror/Core/Tools/TimeSample.cs b/Assets/Mirror/Core/Tools/TimeSample.cs new file mode 100644 index 0000000..111e971 --- /dev/null +++ b/Assets/Mirror/Core/Tools/TimeSample.cs @@ -0,0 +1,61 @@ +// TimeSample from Mirror II. +// simple profiling sample, averaged for display in statistics. +// usable in builds without unitiy profiler overhead etc. +// +// .average may safely be called from main thread while Begin/End is in another. +// i.e. worker threads, transport, etc. +using System.Diagnostics; +using System.Threading; + +namespace Mirror +{ + public struct TimeSample + { + // UnityEngine.Time isn't thread safe. use stopwatch instead. + readonly Stopwatch watch; + + // remember when Begin was called + double beginTime; + + // keep accumulating times over the given interval. + // (not readonly. we modify its contents.) + ExponentialMovingAverage ema; + + // average in seconds. + // code often runs in sub-millisecond time. float is more precise. + // + // set with Interlocked for thread safety. + // can be read from main thread while sampling happens in other thread. + public double average; // THREAD SAFE + + // average over N begin/end captures + public TimeSample(int n) + { + watch = new Stopwatch(); + watch.Start(); + ema = new ExponentialMovingAverage(n); + beginTime = 0; + average = 0; + } + + // begin is called before the code to be sampled + public void Begin() + { + // remember when Begin was called. + // keep StopWatch running so we can average over the given interval. + beginTime = watch.Elapsed.TotalSeconds; + // Debug.Log($"Begin @ {beginTime:F4}"); + } + + // end is called after the code to be sampled + public void End() + { + // add duration in seconds to accumulated durations + double elapsed = watch.Elapsed.TotalSeconds - beginTime; + ema.Add(elapsed); + + // expose new average thread safely + Interlocked.Exchange(ref average, ema.Value); + } + } +} diff --git a/Assets/Mirror/Core/Tools/TimeSample.cs.meta b/Assets/Mirror/Core/Tools/TimeSample.cs.meta new file mode 100644 index 0000000..83e5ede --- /dev/null +++ b/Assets/Mirror/Core/Tools/TimeSample.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 26c32f6429554546a88d800c846c74ed +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/Tools/Utils.cs b/Assets/Mirror/Core/Tools/Utils.cs new file mode 100644 index 0000000..406484f --- /dev/null +++ b/Assets/Mirror/Core/Tools/Utils.cs @@ -0,0 +1,222 @@ +using System; +using System.Runtime.CompilerServices; +using System.Security.Cryptography; +using UnityEngine; +using UnityEngine.Rendering; +using UnityEngine.SceneManagement; + +namespace Mirror +{ + // Handles network messages on client and server + public delegate void NetworkMessageDelegate(NetworkConnection conn, NetworkReader reader, int channelId); + + // Handles requests to spawn objects on the client + public delegate GameObject SpawnDelegate(Vector3 position, uint assetId); + + public delegate GameObject SpawnHandlerDelegate(SpawnMessage msg); + + // Handles requests to unspawn objects on the client + public delegate void UnSpawnDelegate(GameObject spawned); + + // channels are const ints instead of an enum so people can add their own + // channels (can't extend an enum otherwise). + // + // note that Mirror is slowly moving towards quake style networking which + // will only require reliable for handshake, and unreliable for the rest. + // so eventually we can change this to an Enum and transports shouldn't + // add custom channels anymore. + public static class Channels + { + public const int Reliable = 0; // ordered + public const int Unreliable = 1; // unordered + } + + public static class Utils + { + // detect headless / dedicated server mode + // SystemInfo.graphicsDeviceType is never null in the editor. + // UNITY_SERVER works in builds for all Unity versions 2019 LTS and later. + // For Unity 2019 / 2020, there is no way to detect Server Build checkbox + // state in Build Settings, so they never auto-start headless server / client. + // UNITY_SERVER works in the editor in Unity 2021 LTS and later + // because that's when Dedicated Server platform was added. + // It is intentional for editor play mode to auto-start headless server / client + // when Dedicated Server platform is selected in the editor so that editor + // acts like a headless build to every extent possible for testing / debugging. + public static bool IsHeadless() => +#if UNITY_SERVER + true; +#else + SystemInfo.graphicsDeviceType == GraphicsDeviceType.Null; +#endif + + // detect WebGL mode + public const bool IsWebGL = +#if UNITY_WEBGL + true; +#else + false; +#endif + + // detect Debug mode + public const bool IsDebug = +#if DEBUG + true; +#else + false; +#endif + + public static uint GetTrueRandomUInt() + { + // use Crypto RNG to avoid having time based duplicates + using (RNGCryptoServiceProvider rng = new RNGCryptoServiceProvider()) + { + byte[] bytes = new byte[4]; + rng.GetBytes(bytes); + return BitConverter.ToUInt32(bytes, 0); + } + } + + public static bool IsPrefab(GameObject obj) + { +#if UNITY_EDITOR + return UnityEditor.PrefabUtility.IsPartOfPrefabAsset(obj); +#else + return false; +#endif + } + + // simplified IsSceneObject check from Mirror II + public static bool IsSceneObject(NetworkIdentity identity) + { + // original UNET / Mirror still had the IsPersistent check. + // it never fires though. even for Prefabs dragged to the Scene. + // (see Scene Objects example scene.) + // #if UNITY_EDITOR + // if (UnityEditor.EditorUtility.IsPersistent(identity.gameObject)) + // return false; + // #endif + + return identity.gameObject.hideFlags != HideFlags.NotEditable && + identity.gameObject.hideFlags != HideFlags.HideAndDontSave && + identity.sceneId != 0; + } + + public static bool IsSceneObjectWithPrefabParent(GameObject gameObject, out GameObject prefab) + { + prefab = null; + +#if UNITY_EDITOR + if (!UnityEditor.PrefabUtility.IsPartOfPrefabInstance(gameObject)) + { + return false; + } + prefab = UnityEditor.PrefabUtility.GetCorrespondingObjectFromSource(gameObject); +#endif + + if (prefab == null) + { + Debug.LogError($"Failed to find prefab parent for scene object [name:{gameObject.name}]"); + return false; + } + return true; + } + + // is a 2D point in screen? (from ummorpg) + // (if width = 1024, then indices from 0..1023 are valid (=1024 indices) + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static bool IsPointInScreen(Vector2 point) => + 0 <= point.x && point.x < Screen.width && + 0 <= point.y && point.y < Screen.height; + + // pretty print bytes as KB/MB/GB/etc. from DOTSNET + // long to support > 2GB + // divides by floats to return "2.5MB" etc. + public static string PrettyBytes(long bytes) + { + // bytes + if (bytes < 1024) + return $"{bytes} B"; + // kilobytes + else if (bytes < 1024L * 1024L) + return $"{(bytes / 1024f):F2} KB"; + // megabytes + else if (bytes < 1024 * 1024L * 1024L) + return $"{(bytes / (1024f * 1024f)):F2} MB"; + // gigabytes + return $"{(bytes / (1024f * 1024f * 1024f)):F2} GB"; + } + + // pretty print seconds as hours:minutes:seconds(.milliseconds/100)s. + // double for long running servers. + public static string PrettySeconds(double seconds) + { + TimeSpan t = TimeSpan.FromSeconds(seconds); + string res = ""; + if (t.Days > 0) res += $"{t.Days}d"; + if (t.Hours > 0) res += $"{(res.Length > 0 ? " " : "")}{t.Hours}h"; + if (t.Minutes > 0) res += $"{(res.Length > 0 ? " " : "")}{t.Minutes}m"; + // 0.5s, 1.5s etc. if any milliseconds. 1s, 2s etc. if any seconds + if (t.Milliseconds > 0) res += $"{(res.Length > 0 ? " " : "")}{t.Seconds}.{(t.Milliseconds / 100)}s"; + else if (t.Seconds > 0) res += $"{(res.Length > 0 ? " " : "")}{t.Seconds}s"; + // if the string is still empty because the value was '0', then at least + // return the seconds instead of returning an empty string + return res != "" ? res : "0s"; + } + + // universal .spawned function + public static NetworkIdentity GetSpawnedInServerOrClient(uint netId) + { + // server / host mode: use the one from server. + // host mode has access to all spawned. + if (NetworkServer.active) + { + NetworkServer.spawned.TryGetValue(netId, out NetworkIdentity entry); + return entry; + } + + // client + if (NetworkClient.active) + { + NetworkClient.spawned.TryGetValue(netId, out NetworkIdentity entry); + return entry; + } + + return null; + } + + // keep a GUI window in screen. + // for example. if it's at x=1000 and screen is resized to w=500, + // it won't get lost in the invisible area etc. + public static Rect KeepInScreen(Rect rect) + { + // ensure min + rect.x = Math.Max(rect.x, 0); + rect.y = Math.Max(rect.y, 0); + + // ensure max + rect.x = Math.Min(rect.x, Screen.width - rect.width); + rect.y = Math.Min(rect.y, Screen.width - rect.height); + + return rect; + } + + // create local connections pair and connect them + public static void CreateLocalConnections( + out LocalConnectionToClient connectionToClient, + out LocalConnectionToServer connectionToServer) + { + connectionToServer = new LocalConnectionToServer(); + connectionToClient = new LocalConnectionToClient(); + connectionToServer.connectionToClient = connectionToClient; + connectionToClient.connectionToServer = connectionToServer; + } + + public static bool IsSceneActive(string scene) + { + Scene activeScene = SceneManager.GetActiveScene(); + return activeScene.path == scene || + activeScene.name == scene; + } + } +} diff --git a/Assets/Mirror/Core/Tools/Utils.cs.meta b/Assets/Mirror/Core/Tools/Utils.cs.meta new file mode 100644 index 0000000..7cf1557 --- /dev/null +++ b/Assets/Mirror/Core/Tools/Utils.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: b530ce39098b54374a29ad308c8e4554 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/Tools/Vector3Long.cs b/Assets/Mirror/Core/Tools/Vector3Long.cs new file mode 100644 index 0000000..d54a46c --- /dev/null +++ b/Assets/Mirror/Core/Tools/Vector3Long.cs @@ -0,0 +1,125 @@ +#pragma warning disable CS0659 // 'Vector3Long' overrides Object.Equals(object o) but does not override Object.GetHashCode() +#pragma warning disable CS0661 // 'Vector3Long' defines operator == or operator != but does not override Object.GetHashCode() + +// Vector3Long by mischa (based on game engine project) +using System; +using System.Runtime.CompilerServices; + +namespace Mirror +{ + public struct Vector3Long + { + public long x; + public long y; + public long z; + + public static readonly Vector3Long zero = new Vector3Long(0, 0, 0); + public static readonly Vector3Long one = new Vector3Long(1, 1, 1); + public static readonly Vector3Long forward = new Vector3Long(0, 0, 1); + public static readonly Vector3Long back = new Vector3Long(0, 0, -1); + public static readonly Vector3Long left = new Vector3Long(-1, 0, 0); + public static readonly Vector3Long right = new Vector3Long(1, 0, 0); + public static readonly Vector3Long up = new Vector3Long(0, 1, 0); + public static readonly Vector3Long down = new Vector3Long(0, -1, 0); + + // constructor ///////////////////////////////////////////////////////// + public Vector3Long(long x, long y, long z) + { + this.x = x; + this.y = y; + this.z = z; + } + + // operators /////////////////////////////////////////////////////////// + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static Vector3Long operator +(Vector3Long a, Vector3Long b) => + new Vector3Long(a.x + b.x, a.y + b.y, a.z + b.z); + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static Vector3Long operator -(Vector3Long a, Vector3Long b) => + new Vector3Long(a.x - b.x, a.y - b.y, a.z - b.z); + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static Vector3Long operator -(Vector3Long v) => + new Vector3Long(-v.x, -v.y, -v.z); + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static Vector3Long operator *(Vector3Long a, long n) => + new Vector3Long(a.x * n, a.y * n, a.z * n); + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static Vector3Long operator *(long n, Vector3Long a) => + new Vector3Long(a.x * n, a.y * n, a.z * n); + + // == returns true if approximately equal (with epsilon). + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static bool operator ==(Vector3Long a, Vector3Long b) => + a.x == b.x && + a.y == b.y && + a.z == b.z; + + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public static bool operator !=(Vector3Long a, Vector3Long b) => !(a == b); + + // NO IMPLICIT System.Numerics.Vector3Long conversion because double<->float + // would silently lose precision in large worlds. + + // [i] component index. useful for iterating all components etc. + public long this[int index] + { + [MethodImpl(MethodImplOptions.AggressiveInlining)] + get + { + switch (index) + { + case 0: return x; + case 1: return y; + case 2: return z; + default: throw new IndexOutOfRangeException($"Vector3Long[{index}] out of range."); + } + } + [MethodImpl(MethodImplOptions.AggressiveInlining)] + set + { + switch (index) + { + case 0: + x = value; + break; + case 1: + y = value; + break; + case 2: + z = value; + break; + default: throw new IndexOutOfRangeException($"Vector3Long[{index}] out of range."); + } + } + } + + // instance functions ////////////////////////////////////////////////// + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public override string ToString() => $"({x} {y} {z})"; + + // equality //////////////////////////////////////////////////////////// + // implement Equals & HashCode explicitly for performance. + // calling .Equals (instead of "==") checks for exact equality. + // (API compatibility) + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public bool Equals(Vector3Long other) => + x == other.x && y == other.y && z == other.z; + + // Equals(object) can reuse Equals(Vector4) + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public override bool Equals(object other) => + other is Vector3Long vector4 && Equals(vector4); + +#if UNITY_2021_3_OR_NEWER + // Unity 2019/2020 don't have HashCode.Combine yet. + // this is only to avoid reflection. without defining, it works too. + // default generated by rider + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public override int GetHashCode() => HashCode.Combine(x, y, z); +#endif + } +} diff --git a/Assets/Mirror/Core/Tools/Vector3Long.cs.meta b/Assets/Mirror/Core/Tools/Vector3Long.cs.meta new file mode 100644 index 0000000..2239765 --- /dev/null +++ b/Assets/Mirror/Core/Tools/Vector3Long.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 18efa4e349254185ad257401dd24628b +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/Transport.cs b/Assets/Mirror/Core/Transport.cs new file mode 100644 index 0000000..7e0716d --- /dev/null +++ b/Assets/Mirror/Core/Transport.cs @@ -0,0 +1,191 @@ +// For future reference, here is what Transports need to do in Mirror: +// +// Connecting: +// * Transports are responsible to call either OnConnected || OnDisconnected +// in a certain time after a Connect was called. It can not end in limbo. +// +// Disconnecting: +// * Connections might disconnect voluntarily by the other end. +// * Connections might be disconnect involuntarily by the server. +// * Either way, Transports need to detect it and call OnDisconnected. +// +// Timeouts: +// * Transports should expose a configurable timeout +// * Transports are responsible for calling OnDisconnected after a timeout +// +// Channels: +// * Default channel is Reliable, as in reliable ordered (OR DISCONNECT) +// * Where possible, Unreliable should be supported (unordered, no guarantee) +// +// Other: +// * Transports functions are all bound to the main thread. +// (Transports can use other threads in the background if they manage them) +// * Transports should only process messages while the component is enabled. +// +using System; +using UnityEngine; + +namespace Mirror +{ + /// Abstract transport layer component + public abstract class Transport : MonoBehaviour + { + /// The current transport used by Mirror. + public static Transport active; + + /// Is this transport available in the current platform? + public abstract bool Available(); + + // client ////////////////////////////////////////////////////////////// + /// Called by Transport when the client connected to the server. + public Action OnClientConnected; + + /// Called by Transport when the client received a message from the server. + public Action, int> OnClientDataReceived; + + /// Called by Transport when the client sent a message to the server. + // Transports are responsible for calling it because: + // - groups it together with OnReceived responsibility + // - allows transports to decide if anything was sent or not + // - allows transports to decide the actual used channel (i.e. tcp always sending reliable) + public Action, int> OnClientDataSent; + + /// Called by Transport when the client encountered an error. + public Action OnClientError; + + /// Called by Transport when the client disconnected from the server. + public Action OnClientDisconnected; + + // server ////////////////////////////////////////////////////////////// + /// Called by Transport when a new client connected to the server. + public Action OnServerConnected; + + /// Called by Transport when the server received a message from a client. + public Action, int> OnServerDataReceived; + + /// Called by Transport when the server sent a message to a client. + // Transports are responsible for calling it because: + // - groups it together with OnReceived responsibility + // - allows transports to decide if anything was sent or not + // - allows transports to decide the actual used channel (i.e. tcp always sending reliable) + public Action, int> OnServerDataSent; + + /// Called by Transport when a server's connection encountered a problem. + /// If a Disconnect will also be raised, raise the Error first. + public Action OnServerError; + + /// Called by Transport when a client disconnected from the server. + public Action OnServerDisconnected; + + // client functions //////////////////////////////////////////////////// + /// True if the client is currently connected to the server. + public abstract bool ClientConnected(); + + /// Connects the client to the server at the address. + public abstract void ClientConnect(string address); + + /// Connects the client to the server at the Uri. + public virtual void ClientConnect(Uri uri) + { + // By default, to keep backwards compatibility, just connect to the host + // in the uri + ClientConnect(uri.Host); + } + + /// Sends a message to the server over the given channel. + // The ArraySegment is only valid until returning. Copy if needed. + public abstract void ClientSend(ArraySegment segment, int channelId = Channels.Reliable); + + /// Disconnects the client from the server + public abstract void ClientDisconnect(); + + // server functions //////////////////////////////////////////////////// + /// Returns server address as Uri. + // Useful for NetworkDiscovery. + public abstract Uri ServerUri(); + + /// True if the server is currently listening for connections. + public abstract bool ServerActive(); + + /// Start listening for connections. + public abstract void ServerStart(); + + /// Send a message to a client over the given channel. + public abstract void ServerSend(int connectionId, ArraySegment segment, int channelId = Channels.Reliable); + + /// Disconnect a client from the server. + public abstract void ServerDisconnect(int connectionId); + + /// Get a client's address on the server. + // Can be useful for Game Master IP bans etc. + public abstract string ServerGetClientAddress(int connectionId); + + /// Stop listening and disconnect all connections. + public abstract void ServerStop(); + + /// Maximum message size for the given channel. + // Different channels often have different sizes, ranging from MTU to + // several megabytes. + // + // Needs to return a value at all times, even if the Transport isn't + // running or available because it's needed for initializations. + public abstract int GetMaxPacketSize(int channelId = Channels.Reliable); + + /// Recommended Batching threshold for this transport. + // Uses GetMaxPacketSize by default. + // Some transports like kcp support large max packet sizes which should + // not be used for batching all the time because they end up being too + // slow (head of line blocking etc.). + public virtual int GetBatchThreshold(int channelId = Channels.Reliable) + { + return GetMaxPacketSize(channelId); + } + + // block Update & LateUpdate to show warnings if Transports still use + // them instead of using + // Client/ServerEarlyUpdate: to process incoming messages + // Client/ServerLateUpdate: to process outgoing messages + // those are called by NetworkClient/Server at the right time. + // + // allows transports to implement the proper network update order of: + // process_incoming() + // update_world() + // process_outgoing() + // + // => see NetworkLoop.cs for detailed explanations! +#pragma warning disable UNT0001 // Empty Unity message + public void Update() {} + public void LateUpdate() {} +#pragma warning restore UNT0001 // Empty Unity message + + /// + /// NetworkLoop NetworkEarly/LateUpdate were added for a proper network + /// update order. the goal is to: + /// process_incoming() + /// update_world() + /// process_outgoing() + /// in order to avoid unnecessary latency and data races. + /// + // => split into client and server parts so that we can cleanly call + // them from NetworkClient/Server + // => VIRTUAL for now so we can take our time to convert transports + // without breaking anything. + public virtual void ClientEarlyUpdate() {} + public virtual void ServerEarlyUpdate() {} + public virtual void ClientLateUpdate() {} + public virtual void ServerLateUpdate() {} + + /// Shut down the transport, both as client and server + public abstract void Shutdown(); + + /// Called by Unity when quitting. Inheriting Transports should call base for proper Shutdown. + public virtual void OnApplicationQuit() + { + // stop transport (e.g. to shut down threads) + // (when pressing Stop in the Editor, Unity keeps threads alive + // until we press Start again. so if Transports use threads, we + // really want them to end now and not after next start) + Shutdown(); + } + } +} diff --git a/Assets/Mirror/Core/Transport.cs.meta b/Assets/Mirror/Core/Transport.cs.meta new file mode 100644 index 0000000..55072e1 --- /dev/null +++ b/Assets/Mirror/Core/Transport.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: cfffcac25d6d64ced9de620159e221b8 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/TransportError.cs b/Assets/Mirror/Core/TransportError.cs new file mode 100644 index 0000000..b452015 --- /dev/null +++ b/Assets/Mirror/Core/TransportError.cs @@ -0,0 +1,17 @@ +// Mirror transport error code enum. +// most transport implementations should use a subset of this, +// and then translate the transport error codes to mirror error codes. +namespace Mirror +{ + public enum TransportError : byte + { + DnsResolve, // failed to resolve a host name + Refused, // connection refused by other end. server full etc. + Timeout, // ping timeout or dead link + Congestion, // more messages than transport / network can process + InvalidReceive, // recv invalid packet (possibly intentional attack) + InvalidSend, // user tried to send invalid data + ConnectionClosed, // connection closed voluntarily or lost involuntarily + Unexpected // unexpected error / exception, requires fix. + } +} diff --git a/Assets/Mirror/Core/TransportError.cs.meta b/Assets/Mirror/Core/TransportError.cs.meta new file mode 100644 index 0000000..d1d0fa0 --- /dev/null +++ b/Assets/Mirror/Core/TransportError.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: ce162bdedd704db9b8c35d163f0c1d54 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Core/WeaverFuse.cs b/Assets/Mirror/Core/WeaverFuse.cs new file mode 100644 index 0000000..f850323 --- /dev/null +++ b/Assets/Mirror/Core/WeaverFuse.cs @@ -0,0 +1,22 @@ +// safety fuse for weaver to flip. +// runtime can check this to ensure weaving succeded. +// otherwise running server/client would give lots of random 'writer not found' etc. errors. +// this is much cleaner. +// +// note that ILPostProcessor errors already block entering playmode. +// however, issues could still stop the weaving from running at all. +// WeaverFuse can check if it actually ran. +namespace Mirror +{ + public static class WeaverFuse + { + // this trick only works for ILPostProcessor. + // CompilationFinishedHook can't weaver Mirror.dll. + public static bool Weaved() => +#if UNITY_2020_3_OR_NEWER + false; +#else + true; +#endif + } +} diff --git a/Assets/Mirror/Core/WeaverFuse.cs.meta b/Assets/Mirror/Core/WeaverFuse.cs.meta new file mode 100644 index 0000000..c5a9e7b --- /dev/null +++ b/Assets/Mirror/Core/WeaverFuse.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 4de3dfbcbd2e41fcac947c04bcac52c9 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {fileID: 2800000, guid: 7453abfe9e8b2c04a8a47eb536fe21eb, type: 3} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor.meta b/Assets/Mirror/Editor.meta new file mode 100644 index 0000000..f679511 --- /dev/null +++ b/Assets/Mirror/Editor.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: 2539267b6934a4026a505690a1e1eda2 +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/AndroidManifestHelper.cs b/Assets/Mirror/Editor/AndroidManifestHelper.cs new file mode 100644 index 0000000..c76359a --- /dev/null +++ b/Assets/Mirror/Editor/AndroidManifestHelper.cs @@ -0,0 +1,113 @@ +// Android NetworkDiscovery Multicast fix +// https://github.com/vis2k/Mirror/pull/2887 +using UnityEditor; +using UnityEngine; +using UnityEditor.Build; +using UnityEditor.Build.Reporting; +using System.Xml; +using System.IO; +#if UNITY_ANDROID +using UnityEditor.Android; +#endif + + +[InitializeOnLoad] +public class AndroidManifestHelper : IPreprocessBuildWithReport, IPostprocessBuildWithReport +#if UNITY_ANDROID + , IPostGenerateGradleAndroidProject +#endif +{ + public int callbackOrder { get { return 99999; } } + +#if UNITY_ANDROID + public void OnPostGenerateGradleAndroidProject(string path) + { + string manifestFolder = Path.Combine(path, "src/main"); + string sourceFile = manifestFolder + "/AndroidManifest.xml"; + // Load android manifest file + XmlDocument doc = new XmlDocument(); + doc.Load(sourceFile); + + string androidNamepsaceURI; + XmlElement element = (XmlElement)doc.SelectSingleNode("/manifest"); + if (element == null) + { + UnityEngine.Debug.LogError("Could not find manifest tag in android manifest."); + return; + } + + // Get android namespace URI from the manifest + androidNamepsaceURI = element.GetAttribute("xmlns:android"); + if (string.IsNullOrEmpty(androidNamepsaceURI)) + { + UnityEngine.Debug.LogError("Could not find Android Namespace in manifest."); + return; + } + AddOrRemoveTag(doc, + androidNamepsaceURI, + "/manifest", + "uses-permission", + "android.permission.CHANGE_WIFI_MULTICAST_STATE", + true, + false); + AddOrRemoveTag(doc, + androidNamepsaceURI, + "/manifest", + "uses-permission", + "android.permission.INTERNET", + true, + false); + doc.Save(sourceFile); + } +#endif + + static void AddOrRemoveTag(XmlDocument doc, string @namespace, string path, string elementName, string name, bool required, bool modifyIfFound, params string[] attrs) // name, value pairs + { + var nodes = doc.SelectNodes(path + "/" + elementName); + XmlElement element = null; + foreach (XmlElement e in nodes) + { + if (name == null || name == e.GetAttribute("name", @namespace)) + { + element = e; + break; + } + } + + if (required) + { + if (element == null) + { + var parent = doc.SelectSingleNode(path); + element = doc.CreateElement(elementName); + element.SetAttribute("name", @namespace, name); + parent.AppendChild(element); + } + + for (int i = 0; i < attrs.Length; i += 2) + { + if (modifyIfFound || string.IsNullOrEmpty(element.GetAttribute(attrs[i], @namespace))) + { + if (attrs[i + 1] != null) + { + element.SetAttribute(attrs[i], @namespace, attrs[i + 1]); + } + else + { + element.RemoveAttribute(attrs[i], @namespace); + } + } + } + } + else + { + if (element != null && modifyIfFound) + { + element.ParentNode.RemoveChild(element); + } + } + } + + public void OnPostprocessBuild(BuildReport report) {} + public void OnPreprocessBuild(BuildReport report) {} +} diff --git a/Assets/Mirror/Editor/AndroidManifestHelper.cs.meta b/Assets/Mirror/Editor/AndroidManifestHelper.cs.meta new file mode 100644 index 0000000..1281aea --- /dev/null +++ b/Assets/Mirror/Editor/AndroidManifestHelper.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 80cc70189403d7444bbffd185ca28462 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/EditorHelper.cs b/Assets/Mirror/Editor/EditorHelper.cs new file mode 100644 index 0000000..c3551ab --- /dev/null +++ b/Assets/Mirror/Editor/EditorHelper.cs @@ -0,0 +1,41 @@ +using System.Collections.Generic; +using System.IO; +using UnityEditor; +using UnityEngine; + +namespace Mirror +{ + public static class EditorHelper + { + public static string FindPath() + { + string typeName = typeof(T).Name; + + string[] guidsFound = AssetDatabase.FindAssets($"t:Script {typeName}"); + if (guidsFound.Length >= 1 && !string.IsNullOrWhiteSpace(guidsFound[0])) + { + if (guidsFound.Length > 1) + { + Debug.LogWarning($"Found more than one{typeName}"); + } + + string path = AssetDatabase.GUIDToAssetPath(guidsFound[0]); + return Path.GetDirectoryName(path); + } + else + { + Debug.LogError($"Could not find path of {typeName}"); + return string.Empty; + } + } + + + public static IEnumerable IterateOverProject(string filter) + { + foreach (string guid in AssetDatabase.FindAssets(filter)) + { + yield return AssetDatabase.GUIDToAssetPath(guid); + } + } + } +} diff --git a/Assets/Mirror/Editor/EditorHelper.cs.meta b/Assets/Mirror/Editor/EditorHelper.cs.meta new file mode 100644 index 0000000..a1cd814 --- /dev/null +++ b/Assets/Mirror/Editor/EditorHelper.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: dba787f167ff29c4288532af1ec3584c +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Icon.meta b/Assets/Mirror/Editor/Icon.meta new file mode 100644 index 0000000..7338187 --- /dev/null +++ b/Assets/Mirror/Editor/Icon.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: b5f1356ad059a1243910a4e82cd68c5f +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Icon/MirrorIcon.png b/Assets/Mirror/Editor/Icon/MirrorIcon.png new file mode 100644 index 0000000000000000000000000000000000000000..1be896157a63edfe96735948eeb145381697d551 GIT binary patch literal 138247 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 b}aI>P^u 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 all public and private fields for a type + // deepestBaseType: Stops at this base type (exclusive) + public static IEnumerable GetAllFields(Type type, Type deepestBaseType) + { + const BindingFlags publicFields = BindingFlags.Public | BindingFlags.Instance; + const BindingFlags privateFields = BindingFlags.NonPublic | BindingFlags.Instance; + + // get public fields (includes fields from base type) + FieldInfo[] allPublicFields = type.GetFields(publicFields); + foreach (FieldInfo field in allPublicFields) + { + yield return field; + } + + // get private fields in current type, then move to base type + while (type != null) + { + FieldInfo[] allPrivateFields = type.GetFields(privateFields); + foreach (FieldInfo field in allPrivateFields) + { + yield return field; + } + + type = type.BaseType; + + // stop early + if (type == deepestBaseType) + { + break; + } + } + } + + public static bool IsSyncVar(this FieldInfo field) + { + object[] fieldMarkers = field.GetCustomAttributes(typeof(SyncVarAttribute), true); + return fieldMarkers.Length > 0; + } + + public static bool IsSerializeField(this FieldInfo field) + { + object[] fieldMarkers = field.GetCustomAttributes(typeof(SerializeField), true); + return fieldMarkers.Length > 0; + } + + public static bool IsVisibleField(this FieldInfo field) + { + return field.IsPublic || IsSerializeField(field); + } + + public static bool ImplementsInterface(this FieldInfo field) + { + return typeof(T).IsAssignableFrom(field.FieldType); + } + + public static bool HasShowInInspector(this FieldInfo field) + { + object[] fieldMarkers = field.GetCustomAttributes(typeof(ShowInInspectorAttribute), true); + return fieldMarkers.Length > 0; + } + + // checks if SyncObject is public or has our custom [ShowInInspector] field + public static bool IsVisibleSyncObject(this FieldInfo field) + { + return field.IsPublic || HasShowInInspector(field); + } + } +} diff --git a/Assets/Mirror/Editor/InspectorHelper.cs.meta b/Assets/Mirror/Editor/InspectorHelper.cs.meta new file mode 100644 index 0000000..852ff71 --- /dev/null +++ b/Assets/Mirror/Editor/InspectorHelper.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 047c894c2a5ccc1438b7e59302f62744 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Mirror.Editor.asmdef b/Assets/Mirror/Editor/Mirror.Editor.asmdef new file mode 100644 index 0000000..651b8fe --- /dev/null +++ b/Assets/Mirror/Editor/Mirror.Editor.asmdef @@ -0,0 +1,19 @@ +{ + "name": "Mirror.Editor", + "rootNamespace": "", + "references": [ + "GUID:30817c1a0e6d646d99c048fc403f5979", + "GUID:1d0b9d21c3ff546a4aa32399dfd33474" + ], + "includePlatforms": [ + "Editor" + ], + "excludePlatforms": [], + "allowUnsafeCode": false, + "overrideReferences": false, + "precompiledReferences": [], + "autoReferenced": true, + "defineConstraints": [], + "versionDefines": [], + "noEngineReferences": false +} \ No newline at end of file diff --git a/Assets/Mirror/Editor/Mirror.Editor.asmdef.meta b/Assets/Mirror/Editor/Mirror.Editor.asmdef.meta new file mode 100644 index 0000000..e2e6f2a --- /dev/null +++ b/Assets/Mirror/Editor/Mirror.Editor.asmdef.meta @@ -0,0 +1,7 @@ +fileFormatVersion: 2 +guid: 1c7c33eb5480dd24c9e29a8250c1a775 +AssemblyDefinitionImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/NetworkBehaviourInspector.cs b/Assets/Mirror/Editor/NetworkBehaviourInspector.cs new file mode 100644 index 0000000..52c56d6 --- /dev/null +++ b/Assets/Mirror/Editor/NetworkBehaviourInspector.cs @@ -0,0 +1,104 @@ +using System; +using System.Reflection; +using UnityEditor; +using UnityEngine; + +namespace Mirror +{ + [CustomEditor(typeof(NetworkBehaviour), true)] + [CanEditMultipleObjects] + public class NetworkBehaviourInspector : Editor + { + bool syncsAnything; + SyncObjectCollectionsDrawer syncObjectCollectionsDrawer; + + // does this type sync anything? otherwise we don't need to show syncInterval + bool SyncsAnything(Type scriptClass) + { + // check for all SyncVar fields, they don't have to be visible + foreach (FieldInfo field in InspectorHelper.GetAllFields(scriptClass, typeof(NetworkBehaviour))) + { + if (field.IsSyncVar()) + { + return true; + } + } + + // has OnSerialize that is not in NetworkBehaviour? + // then it either has a syncvar or custom OnSerialize. either way + // this means we have something to sync. + MethodInfo method = scriptClass.GetMethod("OnSerialize"); + if (method != null && method.DeclaringType != typeof(NetworkBehaviour)) + { + return true; + } + + // SyncObjects are serialized in NetworkBehaviour.OnSerialize, which + // is always there even if we don't use SyncObjects. so we need to + // search for SyncObjects manually. + // Any SyncObject should be added to syncObjects when unity creates an + // object so we can check length of list so see if sync objects exists + return ((NetworkBehaviour)serializedObject.targetObject).HasSyncObjects(); + } + + void OnEnable() + { + // sometimes target is null. just return early. + if (target == null) return; + + // If target's base class is changed from NetworkBehaviour to MonoBehaviour + // then Unity temporarily keep using this Inspector causing things to break + if (!(target is NetworkBehaviour)) { return; } + + Type scriptClass = target.GetType(); + + syncObjectCollectionsDrawer = new SyncObjectCollectionsDrawer(serializedObject.targetObject); + + syncsAnything = SyncsAnything(scriptClass); + } + + public override void OnInspectorGUI() + { + DrawDefaultInspector(); + DrawSyncObjectCollections(); + DrawDefaultSyncSettings(); + } + + // Draws Sync Objects that are IEnumerable + protected void DrawSyncObjectCollections() + { + // Need this check in case OnEnable returns early + if (syncObjectCollectionsDrawer == null) return; + + syncObjectCollectionsDrawer.Draw(); + } + + // Draws SyncSettings if the NetworkBehaviour has anything to sync + protected void DrawDefaultSyncSettings() + { + // does it sync anything? then show extra properties + // (no need to show it if the class only has Cmds/Rpcs and no sync) + if (!syncsAnything) + { + return; + } + + EditorGUILayout.Space(); + EditorGUILayout.LabelField("Sync Settings", EditorStyles.boldLabel); + + // sync direction + SerializedProperty syncDirection = serializedObject.FindProperty("syncDirection"); + EditorGUILayout.PropertyField(syncDirection); + + // sync mdoe: only show for ServerToClient components + if (syncDirection.enumValueIndex == (int)SyncDirection.ServerToClient) + EditorGUILayout.PropertyField(serializedObject.FindProperty("syncMode")); + + // sync interval + EditorGUILayout.PropertyField(serializedObject.FindProperty("syncInterval")); + + // apply + serializedObject.ApplyModifiedProperties(); + } + } +} diff --git a/Assets/Mirror/Editor/NetworkBehaviourInspector.cs.meta b/Assets/Mirror/Editor/NetworkBehaviourInspector.cs.meta new file mode 100644 index 0000000..78d9fa8 --- /dev/null +++ b/Assets/Mirror/Editor/NetworkBehaviourInspector.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: f02853db46b6346e4866594a96c3b0e7 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/NetworkInformationPreview.cs b/Assets/Mirror/Editor/NetworkInformationPreview.cs new file mode 100644 index 0000000..ec0a01e --- /dev/null +++ b/Assets/Mirror/Editor/NetworkInformationPreview.cs @@ -0,0 +1,305 @@ +using System.Collections.Generic; +using UnityEditor; +using UnityEngine; + +namespace Mirror +{ + [CustomPreview(typeof(GameObject))] + class NetworkInformationPreview : ObjectPreview + { + struct NetworkIdentityInfo + { + public GUIContent name; + public GUIContent value; + } + + struct NetworkBehaviourInfo + { + // This is here just so we can check if it's enabled/disabled + public NetworkBehaviour behaviour; + public GUIContent name; + } + + class Styles + { + public GUIStyle labelStyle = new GUIStyle(EditorStyles.label); + public GUIStyle componentName = new GUIStyle(EditorStyles.boldLabel); + public GUIStyle disabledName = new GUIStyle(EditorStyles.miniLabel); + + public Styles() + { + Color fontColor = new Color(0.7f, 0.7f, 0.7f); + labelStyle.padding.right += 20; + labelStyle.normal.textColor = fontColor; + labelStyle.active.textColor = fontColor; + labelStyle.focused.textColor = fontColor; + labelStyle.hover.textColor = fontColor; + labelStyle.onNormal.textColor = fontColor; + labelStyle.onActive.textColor = fontColor; + labelStyle.onFocused.textColor = fontColor; + labelStyle.onHover.textColor = fontColor; + + componentName.normal.textColor = fontColor; + componentName.active.textColor = fontColor; + componentName.focused.textColor = fontColor; + componentName.hover.textColor = fontColor; + componentName.onNormal.textColor = fontColor; + componentName.onActive.textColor = fontColor; + componentName.onFocused.textColor = fontColor; + componentName.onHover.textColor = fontColor; + + disabledName.normal.textColor = fontColor; + disabledName.active.textColor = fontColor; + disabledName.focused.textColor = fontColor; + disabledName.hover.textColor = fontColor; + disabledName.onNormal.textColor = fontColor; + disabledName.onActive.textColor = fontColor; + disabledName.onFocused.textColor = fontColor; + disabledName.onHover.textColor = fontColor; + } + } + + GUIContent title; + Styles styles = new Styles(); + + public override GUIContent GetPreviewTitle() + { + if (title == null) + { + title = new GUIContent("Network Information"); + } + return title; + } + + public override bool HasPreviewGUI() + { + // need to check if target is null to stop MissingReferenceException + return target != null && target is GameObject gameObject && gameObject.GetComponent() != null; + } + + public override void OnPreviewGUI(Rect r, GUIStyle background) + { + if (Event.current.type != EventType.Repaint) + return; + + if (target == null) + return; + + GameObject targetGameObject = target as GameObject; + + if (targetGameObject == null) + return; + + NetworkIdentity identity = targetGameObject.GetComponent(); + + if (identity == null) + return; + + if (styles == null) + styles = new Styles(); + + + // padding + RectOffset previewPadding = new RectOffset(-5, -5, -5, -5); + Rect paddedr = previewPadding.Add(r); + + //Centering + float initialX = paddedr.x + 10; + float Y = paddedr.y + 10; + + Y = DrawNetworkIdentityInfo(identity, initialX, Y); + + Y = DrawNetworkBehaviors(identity, initialX, Y); + + Y = DrawObservers(identity, initialX, Y); + + _ = DrawOwner(identity, initialX, Y); + + } + + float DrawNetworkIdentityInfo(NetworkIdentity identity, float initialX, float Y) + { + IEnumerable infos = GetNetworkIdentityInfo(identity); + // Get required label size for the names of the information values we're going to show + // There are two columns, one with label for the name of the info and the next for the value + Vector2 maxNameLabelSize = new Vector2(140, 16); + Vector2 maxValueLabelSize = GetMaxNameLabelSize(infos); + + Rect labelRect = new Rect(initialX, Y, maxNameLabelSize.x, maxNameLabelSize.y); + Rect idLabelRect = new Rect(maxNameLabelSize.x, Y, maxValueLabelSize.x, maxValueLabelSize.y); + + foreach (NetworkIdentityInfo info in infos) + { + GUI.Label(labelRect, info.name, styles.labelStyle); + GUI.Label(idLabelRect, info.value, styles.componentName); + labelRect.y += labelRect.height; + labelRect.x = initialX; + idLabelRect.y += idLabelRect.height; + } + + return labelRect.y; + } + + float DrawNetworkBehaviors(NetworkIdentity identity, float initialX, float Y) + { + IEnumerable behavioursInfo = GetNetworkBehaviorInfo(identity); + + // Show behaviours list in a different way than the name/value pairs above + Vector2 maxBehaviourLabelSize = GetMaxBehaviourLabelSize(behavioursInfo); + Rect behaviourRect = new Rect(initialX, Y + 10, maxBehaviourLabelSize.x, maxBehaviourLabelSize.y); + + GUI.Label(behaviourRect, new GUIContent("Network Behaviours"), styles.labelStyle); + // indent names + behaviourRect.x += 20; + behaviourRect.y += behaviourRect.height; + + foreach (NetworkBehaviourInfo info in behavioursInfo) + { + if (info.behaviour == null) + { + // could be the case in the editor after existing play mode. + continue; + } + + GUI.Label(behaviourRect, info.name, info.behaviour.enabled ? styles.componentName : styles.disabledName); + behaviourRect.y += behaviourRect.height; + Y = behaviourRect.y; + } + + return Y; + } + + float DrawObservers(NetworkIdentity identity, float initialX, float Y) + { + if (identity.observers.Count > 0) + { + Rect observerRect = new Rect(initialX, Y + 10, 200, 20); + + GUI.Label(observerRect, new GUIContent("Network observers"), styles.labelStyle); + // indent names + observerRect.x += 20; + observerRect.y += observerRect.height; + + foreach (KeyValuePair kvp in identity.observers) + { + GUI.Label(observerRect, $"{kvp.Value.address}:{kvp.Value}", styles.componentName); + observerRect.y += observerRect.height; + Y = observerRect.y; + } + } + + return Y; + } + + float DrawOwner(NetworkIdentity identity, float initialX, float Y) + { + if (identity.connectionToClient != null) + { + Rect ownerRect = new Rect(initialX, Y + 10, 400, 20); + GUI.Label(ownerRect, new GUIContent($"Client Authority: {identity.connectionToClient}"), styles.labelStyle); + Y += ownerRect.height; + } + return Y; + } + + // Get the maximum size used by the value of information items + Vector2 GetMaxNameLabelSize(IEnumerable infos) + { + Vector2 maxLabelSize = Vector2.zero; + foreach (NetworkIdentityInfo info in infos) + { + Vector2 labelSize = styles.labelStyle.CalcSize(info.value); + if (maxLabelSize.x < labelSize.x) + { + maxLabelSize.x = labelSize.x; + } + if (maxLabelSize.y < labelSize.y) + { + maxLabelSize.y = labelSize.y; + } + } + return maxLabelSize; + } + + Vector2 GetMaxBehaviourLabelSize(IEnumerable behavioursInfo) + { + Vector2 maxLabelSize = Vector2.zero; + foreach (NetworkBehaviourInfo behaviour in behavioursInfo) + { + Vector2 labelSize = styles.labelStyle.CalcSize(behaviour.name); + if (maxLabelSize.x < labelSize.x) + { + maxLabelSize.x = labelSize.x; + } + if (maxLabelSize.y < labelSize.y) + { + maxLabelSize.y = labelSize.y; + } + } + return maxLabelSize; + } + + IEnumerable GetNetworkIdentityInfo(NetworkIdentity identity) + { + List infos = new List + { + GetAssetId(identity), + GetString("Scene ID", identity.sceneId.ToString("X")) + }; + + if (Application.isPlaying) + { + infos.Add(GetString("Network ID", identity.netId.ToString())); + infos.Add(GetBoolean("Is Client", identity.isClient)); + infos.Add(GetBoolean("Is Server", identity.isServer)); + infos.Add(GetBoolean("Is Owned", identity.isOwned)); + infos.Add(GetBoolean("Is Local Player", identity.isLocalPlayer)); + } + return infos; + } + + IEnumerable GetNetworkBehaviorInfo(NetworkIdentity identity) + { + List behaviourInfos = new List(); + + NetworkBehaviour[] behaviours = identity.GetComponents(); + foreach (NetworkBehaviour behaviour in behaviours) + { + behaviourInfos.Add(new NetworkBehaviourInfo + { + name = new GUIContent(behaviour.GetType().FullName), + behaviour = behaviour + }); + } + return behaviourInfos; + } + + NetworkIdentityInfo GetAssetId(NetworkIdentity identity) + { + string assetId = identity.assetId.ToString(); + if (string.IsNullOrWhiteSpace(assetId)) + { + assetId = ""; + } + return GetString("Asset ID", assetId); + } + + static NetworkIdentityInfo GetString(string name, string value) + { + return new NetworkIdentityInfo + { + name = new GUIContent(name), + value = new GUIContent(value) + }; + } + + static NetworkIdentityInfo GetBoolean(string name, bool value) + { + return new NetworkIdentityInfo + { + name = new GUIContent(name), + value = new GUIContent((value ? "Yes" : "No")) + }; + } + } +} diff --git a/Assets/Mirror/Editor/NetworkInformationPreview.cs.meta b/Assets/Mirror/Editor/NetworkInformationPreview.cs.meta new file mode 100644 index 0000000..9bf2de4 --- /dev/null +++ b/Assets/Mirror/Editor/NetworkInformationPreview.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 51a99294efe134232932c34606737356 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/NetworkManagerEditor.cs b/Assets/Mirror/Editor/NetworkManagerEditor.cs new file mode 100644 index 0000000..82b2b1b --- /dev/null +++ b/Assets/Mirror/Editor/NetworkManagerEditor.cs @@ -0,0 +1,181 @@ +using System; +using System.Collections.Generic; +using System.Linq; +using UnityEditor; +using UnityEditorInternal; +using UnityEngine; + +namespace Mirror +{ + [CustomEditor(typeof(NetworkManager), true)] + [CanEditMultipleObjects] + public class NetworkManagerEditor : Editor + { + SerializedProperty spawnListProperty; + ReorderableList spawnList; + protected NetworkManager networkManager; + + protected void Init() + { + if (spawnList == null) + { + networkManager = target as NetworkManager; + spawnListProperty = serializedObject.FindProperty("spawnPrefabs"); + spawnList = new ReorderableList(serializedObject, spawnListProperty) + { + drawHeaderCallback = DrawHeader, + drawElementCallback = DrawChild, + onReorderCallback = Changed, + onRemoveCallback = RemoveButton, + onChangedCallback = Changed, + onAddCallback = AddButton, + // this uses a 16x16 icon. other sizes make it stretch. + elementHeight = 16 + }; + } + } + + public override void OnInspectorGUI() + { + Init(); + DrawDefaultInspector(); + EditorGUI.BeginChangeCheck(); + spawnList.DoLayoutList(); + if (EditorGUI.EndChangeCheck()) + { + serializedObject.ApplyModifiedProperties(); + } + + if (GUILayout.Button("Populate Spawnable Prefabs")) + { + ScanForNetworkIdentities(); + } + } + + void ScanForNetworkIdentities() + { + List identities = new List(); + bool cancelled = false; + try + { + string[] paths = EditorHelper.IterateOverProject("t:prefab").ToArray(); + int count = 0; + foreach (string path in paths) + { + // ignore test & example prefabs. + // users sometimes keep the folders in their projects. + if (path.Contains("Mirror/Tests/") || + path.Contains("Mirror/Examples/")) + { + continue; + } + + if (EditorUtility.DisplayCancelableProgressBar("Searching for NetworkIdentities..", + $"Scanned {count}/{paths.Length} prefabs. Found {identities.Count} new ones", + count / (float)paths.Length)) + { + cancelled = true; + break; + } + + count++; + + NetworkIdentity ni = AssetDatabase.LoadAssetAtPath(path); + if (!ni) + { + continue; + } + + if (!networkManager.spawnPrefabs.Contains(ni.gameObject)) + { + identities.Add(ni.gameObject); + } + + } + } + finally + { + + EditorUtility.ClearProgressBar(); + if (!cancelled) + { + // RecordObject is needed for "*" to show up in Scene. + // however, this only saves List.Count without the entries. + Undo.RecordObject(networkManager, "NetworkManager: populated prefabs"); + + // add the entries + networkManager.spawnPrefabs.AddRange(identities); + + // sort alphabetically for better UX + networkManager.spawnPrefabs = networkManager.spawnPrefabs.OrderBy(go => go.name).ToList(); + + // SetDirty is required to save the individual entries properly. + EditorUtility.SetDirty(target); + } + // Loading assets might use a lot of memory, so try to unload them after + Resources.UnloadUnusedAssets(); + } + } + + static void DrawHeader(Rect headerRect) + { + GUI.Label(headerRect, "Registered Spawnable Prefabs:"); + } + + internal void DrawChild(Rect r, int index, bool isActive, bool isFocused) + { + SerializedProperty prefab = spawnListProperty.GetArrayElementAtIndex(index); + GameObject go = (GameObject)prefab.objectReferenceValue; + + GUIContent label; + if (go == null) + { + label = new GUIContent("Empty", "Drag a prefab with a NetworkIdentity here"); + } + else + { + NetworkIdentity identity = go.GetComponent(); + label = new GUIContent(go.name, identity != null ? $"AssetId: [{identity.assetId}]" : "No Network Identity"); + } + + GameObject newGameObject = (GameObject)EditorGUI.ObjectField(r, label, go, typeof(GameObject), false); + + if (newGameObject != go) + { + if (newGameObject != null && !newGameObject.GetComponent()) + { + Debug.LogError($"Prefab {newGameObject} cannot be added as spawnable as it doesn't have a NetworkIdentity."); + return; + } + prefab.objectReferenceValue = newGameObject; + } + } + + internal void Changed(ReorderableList list) + { + EditorUtility.SetDirty(target); + } + + internal void AddButton(ReorderableList list) + { + spawnListProperty.arraySize += 1; + list.index = spawnListProperty.arraySize - 1; + + SerializedProperty obj = spawnListProperty.GetArrayElementAtIndex(spawnListProperty.arraySize - 1); + obj.objectReferenceValue = null; + + spawnList.index = spawnList.count - 1; + + Changed(list); + } + + internal void RemoveButton(ReorderableList list) + { + spawnListProperty.DeleteArrayElementAtIndex(spawnList.index); + if (list.index >= spawnListProperty.arraySize) + { + list.index = spawnListProperty.arraySize - 1; + } + } + } +} diff --git a/Assets/Mirror/Editor/NetworkManagerEditor.cs.meta b/Assets/Mirror/Editor/NetworkManagerEditor.cs.meta new file mode 100644 index 0000000..7fe8dbc --- /dev/null +++ b/Assets/Mirror/Editor/NetworkManagerEditor.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 519712eb07f7a44039df57664811c2c5 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/NetworkScenePostProcess.cs b/Assets/Mirror/Editor/NetworkScenePostProcess.cs new file mode 100644 index 0000000..2fa07d6 --- /dev/null +++ b/Assets/Mirror/Editor/NetworkScenePostProcess.cs @@ -0,0 +1,98 @@ +using System.Collections.Generic; +using System.Linq; +using UnityEditor; +using UnityEditor.Callbacks; +using UnityEngine; + +namespace Mirror +{ + public class NetworkScenePostProcess : MonoBehaviour + { + [PostProcessScene] + public static void OnPostProcessScene() + { + // find all NetworkIdentities in all scenes + // => can't limit it to GetActiveScene() because that wouldn't work + // for additive scene loads (the additively loaded scene is never + // the active scene) + // => ignore DontDestroyOnLoad scene! this avoids weird situations + // like in NetworkZones when we destroy the local player and + // load another scene afterwards, yet the local player is still + // in the FindObjectsOfType result with scene=DontDestroyOnLoad + // for some reason + // => OfTypeAll so disabled objects are included too + // => Unity 2019 returns prefabs here too, so filter them out. + IEnumerable identities = Resources.FindObjectsOfTypeAll() + .Where(identity => identity.gameObject.hideFlags != HideFlags.NotEditable && + identity.gameObject.hideFlags != HideFlags.HideAndDontSave && + identity.gameObject.scene.name != "DontDestroyOnLoad" && + !Utils.IsPrefab(identity.gameObject)); + + foreach (NetworkIdentity identity in identities) + { + // if we had a [ConflictComponent] attribute that would be better than this check. + // also there is no context about which scene this is in. + if (identity.GetComponent() != null) + Debug.LogError("NetworkManager has a NetworkIdentity component. This will cause the NetworkManager object to be disabled, so it is not recommended."); + + // not spawned before? + // OnPostProcessScene is called after additive scene loads too, + // and we don't want to set main scene's objects inactive again + if (!identity.isClient && !identity.isServer) + { + // valid scene object? + // otherwise it might be an unopened scene that still has null + // sceneIds. builds are interrupted if they contain 0 sceneIds, + // but it's still possible that we call LoadScene in Editor + // for a previously unopened scene. + // (and only do SetActive if this was actually a scene object) + if (identity.sceneId != 0) + { + PrepareSceneObject(identity); + } + // throwing an exception would only show it for one object + // because this function would return afterwards. + else + { + // there are two cases where sceneId == 0: + // * if we have a prefab open in the prefab scene + // * if an unopened scene needs resaving + // show a proper error message in both cases so the user + // knows what to do. + string path = identity.gameObject.scene.path; + if (string.IsNullOrWhiteSpace(path)) + Debug.LogError($"{identity.name} is currently open in Prefab Edit Mode. Please open the actual scene before launching Mirror."); + else + Debug.LogError($"Scene {path} needs to be opened and resaved, because the scene object {identity.name} has no valid sceneId yet."); + + // either way we shouldn't continue. nothing good will + // happen when trying to launch with invalid sceneIds. + EditorApplication.isPlaying = false; + } + } + } + } + + static void PrepareSceneObject(NetworkIdentity identity) + { + // set scene hash + identity.SetSceneIdSceneHashPartInternal(); + + // spawnable scene objects are force disabled on scene load to + // ensure Start/Update/etc. aren't called until actually spawned. + // + // note: NetworkIdentity.OnDisable adds itself to the + // spawnableObjects dictionary (only if sceneId != 0) + identity.gameObject.SetActive(false); + + // safety check for prefabs with more than one NetworkIdentity + GameObject prefabGO = PrefabUtility.GetCorrespondingObjectFromSource(identity.gameObject); + if (prefabGO) + { + GameObject prefabRootGO = prefabGO.transform.root.gameObject; + if (prefabRootGO != null && prefabRootGO.GetComponentsInChildren().Length > 1) + Debug.LogWarning($"Prefab {prefabRootGO.name} has several NetworkIdentity components attached to itself or its children, this is not supported."); + } + } + } +} diff --git a/Assets/Mirror/Editor/NetworkScenePostProcess.cs.meta b/Assets/Mirror/Editor/NetworkScenePostProcess.cs.meta new file mode 100644 index 0000000..b567cc9 --- /dev/null +++ b/Assets/Mirror/Editor/NetworkScenePostProcess.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: a3ec1c414d821444a9e77f18a2c130ea +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/ReadOnlyDrawer.cs b/Assets/Mirror/Editor/ReadOnlyDrawer.cs new file mode 100644 index 0000000..4a09707 --- /dev/null +++ b/Assets/Mirror/Editor/ReadOnlyDrawer.cs @@ -0,0 +1,19 @@ +using UnityEngine; +using UnityEditor; + +namespace Mirror +{ + [CustomPropertyDrawer(typeof(ReadOnlyAttribute))] + public class ReadOnlyDrawer : PropertyDrawer + { + public override void OnGUI(Rect position, SerializedProperty property, GUIContent label) + { + // Cache the current GUI enabled state + bool prevGuiEnabledState = GUI.enabled; + + GUI.enabled = false; + EditorGUI.PropertyField(position, property, label, true); + GUI.enabled = prevGuiEnabledState; + } + } +} diff --git a/Assets/Mirror/Editor/ReadOnlyDrawer.cs.meta b/Assets/Mirror/Editor/ReadOnlyDrawer.cs.meta new file mode 100644 index 0000000..eb6eb0f --- /dev/null +++ b/Assets/Mirror/Editor/ReadOnlyDrawer.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 22f17bdd21f104c41bc175937fefbdec +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/SceneDrawer.cs b/Assets/Mirror/Editor/SceneDrawer.cs new file mode 100644 index 0000000..f391684 --- /dev/null +++ b/Assets/Mirror/Editor/SceneDrawer.cs @@ -0,0 +1,47 @@ +using UnityEditor; +using UnityEngine; + +namespace Mirror +{ + [CustomPropertyDrawer(typeof(SceneAttribute))] + public class SceneDrawer : PropertyDrawer + { + public override void OnGUI(Rect position, SerializedProperty property, GUIContent label) + { + if (property.propertyType == SerializedPropertyType.String) + { + SceneAsset sceneObject = AssetDatabase.LoadAssetAtPath(property.stringValue); + + if (sceneObject == null && !string.IsNullOrWhiteSpace(property.stringValue)) + { + // try to load it from the build settings for legacy compatibility + sceneObject = GetBuildSettingsSceneObject(property.stringValue); + } + if (sceneObject == null && !string.IsNullOrWhiteSpace(property.stringValue)) + { + Debug.LogError($"Could not find scene {property.stringValue} in {property.propertyPath}, assign the proper scenes in your NetworkManager"); + } + SceneAsset scene = (SceneAsset)EditorGUI.ObjectField(position, label, sceneObject, typeof(SceneAsset), true); + + property.stringValue = AssetDatabase.GetAssetPath(scene); + } + else + { + EditorGUI.LabelField(position, label.text, "Use [Scene] with strings."); + } + } + + protected SceneAsset GetBuildSettingsSceneObject(string sceneName) + { + foreach (EditorBuildSettingsScene buildScene in EditorBuildSettings.scenes) + { + SceneAsset sceneAsset = AssetDatabase.LoadAssetAtPath(buildScene.path); + if (sceneAsset!= null && sceneAsset.name == sceneName) + { + return sceneAsset; + } + } + return null; + } + } +} diff --git a/Assets/Mirror/Editor/SceneDrawer.cs.meta b/Assets/Mirror/Editor/SceneDrawer.cs.meta new file mode 100644 index 0000000..6a996dc --- /dev/null +++ b/Assets/Mirror/Editor/SceneDrawer.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: b24704a46211b4ea294aba8f58715cea +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/SyncObjectCollectionsDrawer.cs b/Assets/Mirror/Editor/SyncObjectCollectionsDrawer.cs new file mode 100644 index 0000000..2c95bcf --- /dev/null +++ b/Assets/Mirror/Editor/SyncObjectCollectionsDrawer.cs @@ -0,0 +1,83 @@ +// helper class for NetworkBehaviourInspector to draw all enumerable SyncObjects +// (SyncList/Set/Dictionary) +// 'SyncObjectCollectionsDrawer' is a nicer name than 'IEnumerableSyncObjectsDrawer' +using System.Collections; +using System.Collections.Generic; +using System.Reflection; +using UnityEditor; + +namespace Mirror +{ + class SyncObjectCollectionField + { + public bool visible; + public readonly FieldInfo field; + public readonly string label; + + public SyncObjectCollectionField(FieldInfo field) + { + this.field = field; + visible = false; + label = $"{field.Name} [{field.FieldType.Name}]"; + } + } + + public class SyncObjectCollectionsDrawer + { + readonly UnityEngine.Object targetObject; + readonly List syncObjectCollectionFields; + + public SyncObjectCollectionsDrawer(UnityEngine.Object targetObject) + { + this.targetObject = targetObject; + syncObjectCollectionFields = new List(); + foreach (FieldInfo field in InspectorHelper.GetAllFields(targetObject.GetType(), typeof(NetworkBehaviour))) + { + // only draw SyncObjects that are IEnumerable (SyncList/Set/Dictionary) + if (field.IsVisibleSyncObject() && + field.ImplementsInterface() && + field.ImplementsInterface()) + { + syncObjectCollectionFields.Add(new SyncObjectCollectionField(field)); + } + } + } + + public void Draw() + { + if (syncObjectCollectionFields.Count == 0) { return; } + + EditorGUILayout.Space(); + EditorGUILayout.LabelField("Sync Collections", EditorStyles.boldLabel); + + for (int i = 0; i < syncObjectCollectionFields.Count; i++) + { + DrawSyncObjectCollection(syncObjectCollectionFields[i]); + } + } + + void DrawSyncObjectCollection(SyncObjectCollectionField syncObjectCollectionField) + { + syncObjectCollectionField.visible = EditorGUILayout.Foldout(syncObjectCollectionField.visible, syncObjectCollectionField.label); + if (syncObjectCollectionField.visible) + { + using (new EditorGUI.IndentLevelScope()) + { + object fieldValue = syncObjectCollectionField.field.GetValue(targetObject); + if (fieldValue is IEnumerable syncObject) + { + int index = 0; + foreach (object item in syncObject) + { + string itemValue = item != null ? item.ToString() : "NULL"; + string itemLabel = $"Element {index}"; + EditorGUILayout.LabelField(itemLabel, itemValue); + + index++; + } + } + } + } + } + } +} diff --git a/Assets/Mirror/Editor/SyncObjectCollectionsDrawer.cs.meta b/Assets/Mirror/Editor/SyncObjectCollectionsDrawer.cs.meta new file mode 100644 index 0000000..44ba75d --- /dev/null +++ b/Assets/Mirror/Editor/SyncObjectCollectionsDrawer.cs.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: 6f90afab12e04f0e945d83e9d38308a3 +timeCreated: 1632556645 \ No newline at end of file diff --git a/Assets/Mirror/Editor/SyncVarAttributeDrawer.cs b/Assets/Mirror/Editor/SyncVarAttributeDrawer.cs new file mode 100644 index 0000000..2356a5e --- /dev/null +++ b/Assets/Mirror/Editor/SyncVarAttributeDrawer.cs @@ -0,0 +1,28 @@ +using UnityEditor; +using UnityEngine; + +namespace Mirror +{ + [CustomPropertyDrawer(typeof(SyncVarAttribute))] + public class SyncVarAttributeDrawer : PropertyDrawer + { + static readonly GUIContent syncVarIndicatorContent = new GUIContent("SyncVar", "This variable has been marked with the [SyncVar] attribute."); + + public override void OnGUI(Rect position, SerializedProperty property, GUIContent label) + { + Vector2 syncVarIndicatorRect = EditorStyles.miniLabel.CalcSize(syncVarIndicatorContent); + float valueWidth = position.width - syncVarIndicatorRect.x; + + Rect valueRect = new Rect(position.x, position.y, valueWidth, position.height); + Rect labelRect = new Rect(position.x + valueWidth, position.y, syncVarIndicatorRect.x, position.height); + + EditorGUI.PropertyField(valueRect, property, label, true); + GUI.Label(labelRect, syncVarIndicatorContent, EditorStyles.miniLabel); + } + + public override float GetPropertyHeight(SerializedProperty property, GUIContent label) + { + return EditorGUI.GetPropertyHeight(property); + } + } +} diff --git a/Assets/Mirror/Editor/SyncVarAttributeDrawer.cs.meta b/Assets/Mirror/Editor/SyncVarAttributeDrawer.cs.meta new file mode 100644 index 0000000..6311f1d --- /dev/null +++ b/Assets/Mirror/Editor/SyncVarAttributeDrawer.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 27821afc81c4d064d8348fbeb00c0ce8 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Weaver.meta b/Assets/Mirror/Editor/Weaver.meta new file mode 100644 index 0000000..121fbf4 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: d9f8e6274119b4ce29e498cfb8aca8a4 +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Weaver/AssemblyInfo.cs b/Assets/Mirror/Editor/Weaver/AssemblyInfo.cs new file mode 100644 index 0000000..08b43f5 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/AssemblyInfo.cs @@ -0,0 +1,3 @@ +using System.Runtime.CompilerServices; + +[assembly: InternalsVisibleTo("Mirror.Tests")] diff --git a/Assets/Mirror/Editor/Weaver/AssemblyInfo.cs.meta b/Assets/Mirror/Editor/Weaver/AssemblyInfo.cs.meta new file mode 100644 index 0000000..d356af8 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/AssemblyInfo.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 929924d95663264478d4238d4910d22e +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Weaver/EntryPoint.meta b/Assets/Mirror/Editor/Weaver/EntryPoint.meta new file mode 100644 index 0000000..81827c5 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/EntryPoint.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: 251338e67afb4cefa38da924f8c50a6e +timeCreated: 1628851818 \ No newline at end of file diff --git a/Assets/Mirror/Editor/Weaver/EntryPoint/CompilationFinishedHook.cs b/Assets/Mirror/Editor/Weaver/EntryPoint/CompilationFinishedHook.cs new file mode 100644 index 0000000..b5db851 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/EntryPoint/CompilationFinishedHook.cs @@ -0,0 +1,188 @@ +// for Unity 2020+ we use ILPostProcessor. +// only automatically invoke it for older versions. +#if !UNITY_2020_3_OR_NEWER +using System; +using System.Collections.Generic; +using System.IO; +using System.Linq; +using Mono.CecilX; +using UnityEditor; +using UnityEditor.Compilation; +using UnityEngine; +using UnityAssembly = UnityEditor.Compilation.Assembly; + +namespace Mirror.Weaver +{ + public static class CompilationFinishedHook + { + // needs to be the same as Weaver.MirrorAssemblyName! + const string MirrorRuntimeAssemblyName = "Mirror"; + const string MirrorWeaverAssemblyName = "Mirror.Weaver"; + + // global weaver define so that tests can use it + internal static Weaver weaver; + + // delegate for subscription to Weaver warning messages + public static Action OnWeaverWarning; + // delete for subscription to Weaver error messages + public static Action OnWeaverError; + + // controls whether Weaver errors are reported direct to the Unity console (tests enable this) + public static bool UnityLogEnabled = true; + + [InitializeOnLoadMethod] + public static void OnInitializeOnLoad() + { + CompilationPipeline.assemblyCompilationFinished += OnCompilationFinished; + + // We only need to run this once per session + // after that, all assemblies will be weaved by the event + if (!SessionState.GetBool("MIRROR_WEAVED", false)) + { + // reset session flag + SessionState.SetBool("MIRROR_WEAVED", true); + SessionState.SetBool("MIRROR_WEAVE_SUCCESS", true); + + WeaveExistingAssemblies(); + } + } + + public static void WeaveExistingAssemblies() + { + foreach (UnityAssembly assembly in CompilationPipeline.GetAssemblies()) + { + if (File.Exists(assembly.outputPath)) + { + OnCompilationFinished(assembly.outputPath, new CompilerMessage[0]); + } + } + + EditorUtility.RequestScriptReload(); + } + + static Assembly FindCompilationPipelineAssembly(string assemblyName) => + CompilationPipeline.GetAssemblies().First(assembly => assembly.name == assemblyName); + + static bool CompilerMessagesContainError(CompilerMessage[] messages) => + messages.Any(msg => msg.type == CompilerMessageType.Error); + + public static void OnCompilationFinished(string assemblyPath, CompilerMessage[] messages) + { + // Do nothing if there were compile errors on the target + if (CompilerMessagesContainError(messages)) + { + Debug.Log("Weaver: stop because compile errors on target"); + return; + } + + // Should not run on the editor only assemblies (test ones still need to be weaved) + if (assemblyPath.Contains("-Editor") || + (assemblyPath.Contains(".Editor") && !assemblyPath.Contains(".Tests"))) + { + return; + } + + // skip Mirror.dll because CompilationFinishedHook can't weave itself. + // this would cause a sharing violation. + // skip Mirror.Weaver.dll too. + string assemblyName = Path.GetFileNameWithoutExtension(assemblyPath); + if (assemblyName == MirrorRuntimeAssemblyName || assemblyName == MirrorWeaverAssemblyName) + { + return; + } + + // find Mirror.dll + Assembly mirrorAssembly = FindCompilationPipelineAssembly(MirrorRuntimeAssemblyName); + if (mirrorAssembly == null) + { + Debug.LogError("Failed to find Mirror runtime assembly"); + return; + } + + string mirrorRuntimeDll = mirrorAssembly.outputPath; + if (!File.Exists(mirrorRuntimeDll)) + { + // this is normal, it happens with any assembly that is built before mirror + // such as unity packages or your own assemblies + // those don't need to be weaved + // if any assembly depends on mirror, then it will be built after + return; + } + + // find UnityEngine.CoreModule.dll + string unityEngineCoreModuleDLL = UnityEditorInternal.InternalEditorUtility.GetEngineCoreModuleAssemblyPath(); + if (string.IsNullOrEmpty(unityEngineCoreModuleDLL)) + { + Debug.LogError("Failed to find UnityEngine assembly"); + return; + } + + HashSet dependencyPaths = GetDependencyPaths(assemblyPath); + dependencyPaths.Add(Path.GetDirectoryName(mirrorRuntimeDll)); + dependencyPaths.Add(Path.GetDirectoryName(unityEngineCoreModuleDLL)); + + if (!WeaveFromFile(assemblyPath, dependencyPaths.ToArray())) + { + // Set false...will be checked in \Editor\EnterPlayModeSettingsCheck.CheckSuccessfulWeave() + SessionState.SetBool("MIRROR_WEAVE_SUCCESS", false); + if (UnityLogEnabled) Debug.LogError($"Weaving failed for {assemblyPath}"); + } + } + + static HashSet GetDependencyPaths(string assemblyPath) + { + // build directory list for later asm/symbol resolving using CompilationPipeline refs + HashSet dependencyPaths = new HashSet + { + Path.GetDirectoryName(assemblyPath) + }; + foreach (Assembly assembly in CompilationPipeline.GetAssemblies()) + { + if (assembly.outputPath == assemblyPath) + { + foreach (string reference in assembly.compiledAssemblyReferences) + { + dependencyPaths.Add(Path.GetDirectoryName(reference)); + } + } + } + + return dependencyPaths; + } + // helper function to invoke Weaver with an AssemblyDefinition from a + // file path, with dependencies added. + static bool WeaveFromFile(string assemblyPath, string[] dependencies) + { + // resolve assembly from stream + using (DefaultAssemblyResolver asmResolver = new DefaultAssemblyResolver()) + using (AssemblyDefinition assembly = AssemblyDefinition.ReadAssembly(assemblyPath, new ReaderParameters{ ReadWrite = true, ReadSymbols = true, AssemblyResolver = asmResolver })) + { + // add this assembly's path and unity's assembly path + asmResolver.AddSearchDirectory(Path.GetDirectoryName(assemblyPath)); + asmResolver.AddSearchDirectory(Helpers.UnityEngineDllDirectoryName()); + + // add dependencies + if (dependencies != null) + { + foreach (string path in dependencies) + { + asmResolver.AddSearchDirectory(path); + } + } + + // create weaver with logger + weaver = new Weaver(new CompilationFinishedLogger()); + if (weaver.Weave(assembly, asmResolver, out bool modified)) + { + // write changes to file if modified + if (modified) + assembly.Write(new WriterParameters{WriteSymbols = true}); + + return true; + } + return false; + } + } + } +} +#endif diff --git a/Assets/Mirror/Editor/Weaver/EntryPoint/CompilationFinishedHook.cs.meta b/Assets/Mirror/Editor/Weaver/EntryPoint/CompilationFinishedHook.cs.meta new file mode 100644 index 0000000..ed537ab --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/EntryPoint/CompilationFinishedHook.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: de2aeb2e8068f421a9a1febe408f7051 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Weaver/EntryPoint/CompilationFinishedLogger.cs b/Assets/Mirror/Editor/Weaver/EntryPoint/CompilationFinishedLogger.cs new file mode 100644 index 0000000..e053404 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/EntryPoint/CompilationFinishedLogger.cs @@ -0,0 +1,31 @@ +// logger for compilation finished hook. +// where we need a callback and Debug.Log. +// for Unity 2020+ we use ILPostProcessor. +#if !UNITY_2020_3_OR_NEWER +using Mono.CecilX; +using UnityEngine; + +namespace Mirror.Weaver +{ + public class CompilationFinishedLogger : Logger + { + public void Warning(string message) => Warning(message, null); + public void Warning(string message, MemberReference mr) + { + if (mr != null) message = $"{message} (at {mr})"; + + if (CompilationFinishedHook.UnityLogEnabled) Debug.LogWarning(message); + CompilationFinishedHook.OnWeaverWarning?.Invoke(message); + } + + public void Error(string message) => Error(message, null); + public void Error(string message, MemberReference mr) + { + if (mr != null) message = $"{message} (at {mr})"; + + if (CompilationFinishedHook.UnityLogEnabled) Debug.LogError(message); + CompilationFinishedHook.OnWeaverError?.Invoke(message); + } + } +} +#endif diff --git a/Assets/Mirror/Editor/Weaver/EntryPoint/CompilationFinishedLogger.cs.meta b/Assets/Mirror/Editor/Weaver/EntryPoint/CompilationFinishedLogger.cs.meta new file mode 100644 index 0000000..f8c7139 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/EntryPoint/CompilationFinishedLogger.cs.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: 47026732f0fa475c94bd1dd41f1de559 +timeCreated: 1629379868 \ No newline at end of file diff --git a/Assets/Mirror/Editor/Weaver/EntryPoint/EnterPlayModeHook.cs b/Assets/Mirror/Editor/Weaver/EntryPoint/EnterPlayModeHook.cs new file mode 100644 index 0000000..5dffa97 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/EntryPoint/EnterPlayModeHook.cs @@ -0,0 +1,44 @@ +#if !UNITY_2020_3_OR_NEWER +// make sure we weaved successfully when entering play mode. +using UnityEditor; +using UnityEngine; + +namespace Mirror +{ + public class EnterPlayModeSettingsCheck : MonoBehaviour + { + [InitializeOnLoadMethod] + static void OnInitializeOnLoad() + { + // Hook this event to see if we have a good weave every time + // user attempts to enter play mode or tries to do a build + EditorApplication.playModeStateChanged += OnPlayModeStateChanged; + } + + static void OnPlayModeStateChanged(PlayModeStateChange state) + { + // Per Unity docs, this fires "when exiting edit mode before the Editor is in play mode". + // This doesn't fire when closing the editor. + if (state == PlayModeStateChange.ExitingEditMode) + { + // Check if last weave result was successful + if (!SessionState.GetBool("MIRROR_WEAVE_SUCCESS", false)) + { + // Last weave result was a failure...try to weave again + // Faults will show in the console that may have been cleared by "Clear on Play" + SessionState.SetBool("MIRROR_WEAVE_SUCCESS", true); + Weaver.CompilationFinishedHook.WeaveExistingAssemblies(); + + // Did that clear things up for us? + if (!SessionState.GetBool("MIRROR_WEAVE_SUCCESS", false)) + { + // Nope, still failed, and console has the issues logged + Debug.LogError("Can't enter play mode until weaver issues are resolved."); + EditorApplication.isPlaying = false; + } + } + } + } + } +} +#endif diff --git a/Assets/Mirror/Editor/Weaver/EntryPoint/EnterPlayModeHook.cs.meta b/Assets/Mirror/Editor/Weaver/EntryPoint/EnterPlayModeHook.cs.meta new file mode 100644 index 0000000..eca31e3 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/EntryPoint/EnterPlayModeHook.cs.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: b73d0f106ba84aa983baa5142b08a0a9 +timeCreated: 1628851346 \ No newline at end of file diff --git a/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor.meta b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor.meta new file mode 100644 index 0000000..6ef7bf3 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: 09082db63d1d48d9ab91320165c1b684 +timeCreated: 1628859005 \ No newline at end of file diff --git a/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/CompiledAssemblyFromFile.cs b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/CompiledAssemblyFromFile.cs new file mode 100644 index 0000000..e4d9de2 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/CompiledAssemblyFromFile.cs @@ -0,0 +1,31 @@ +// tests use WeaveAssembler, which uses AssemblyBuilder to Build(). +// afterwards ILPostProcessor weaves the build. +// this works on windows, but build() does not run ILPP on mac atm. +// we need to manually invoke ILPP with an assembly from file. +// +// this is in Weaver folder becuase CompilationPipeline can only be accessed +// from assemblies with the name "Unity.*.CodeGen" +using System.IO; +using Unity.CompilationPipeline.Common.ILPostProcessing; + +namespace Mirror.Weaver +{ + public class CompiledAssemblyFromFile : ICompiledAssembly + { + readonly string assemblyPath; + + public string Name => Path.GetFileNameWithoutExtension(assemblyPath); + public string[] References { get; set; } + public string[] Defines { get; set; } + public InMemoryAssembly InMemoryAssembly { get; } + + public CompiledAssemblyFromFile(string assemblyPath) + { + this.assemblyPath = assemblyPath; + byte[] peData = File.ReadAllBytes(assemblyPath); + string pdbFileName = Path.GetFileNameWithoutExtension(assemblyPath) + ".pdb"; + byte[] pdbData = File.ReadAllBytes(Path.Combine(Path.GetDirectoryName(assemblyPath), pdbFileName)); + InMemoryAssembly = new InMemoryAssembly(peData, pdbData); + } + } +} diff --git a/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/CompiledAssemblyFromFile.cs.meta b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/CompiledAssemblyFromFile.cs.meta new file mode 100644 index 0000000..1e5091e --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/CompiledAssemblyFromFile.cs.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: 9009d1db4ed44f6694a92bf8ad7738e9 +timeCreated: 1630129423 \ No newline at end of file diff --git a/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorAssemblyResolver.cs b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorAssemblyResolver.cs new file mode 100644 index 0000000..2b6b325 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorAssemblyResolver.cs @@ -0,0 +1,199 @@ +// based on paul's resolver from +// https://github.com/MirageNet/Mirage/commit/def64cd1db525398738f057b3d1eb1fe8afc540c?branch=def64cd1db525398738f057b3d1eb1fe8afc540c&diff=split +// +// an assembly resolver's job is to open an assembly in case we want to resolve +// a type from it. +// +// for example, while weaving MyGame.dll: if we want to resolve ArraySegment, +// then we need to open and resolve from another assembly (CoreLib). +// +// using DefaultAssemblyResolver with ILPostProcessor throws Exceptions in +// WeaverTypes.cs when resolving anything, for example: +// ArraySegment in Mirror.Tests.Dll. +// +// we need a custom resolver for ILPostProcessor. +#if UNITY_2020_3_OR_NEWER +using System; +using System.Collections.Concurrent; +using System.IO; +using System.Linq; +using System.Threading; +using Mono.CecilX; +using Unity.CompilationPipeline.Common.ILPostProcessing; + +namespace Mirror.Weaver +{ + class ILPostProcessorAssemblyResolver : IAssemblyResolver + { + readonly string[] assemblyReferences; + + // originally we used Dictionary + lock. + // Resolve() is called thousands of times for large projects. + // ILPostProcessor is multithreaded, so best to use ConcurrentDictionary without the lock here. + readonly ConcurrentDictionary assemblyCache = + new ConcurrentDictionary(); + + // Resolve() calls FindFile() every time. + // thousands of times for String => mscorlib alone in large projects. + // cache the results! ILPostProcessor is multithreaded, so use a ConcurrentDictionary here. + readonly ConcurrentDictionary fileNameCache = + new ConcurrentDictionary(); + + readonly ICompiledAssembly compiledAssembly; + AssemblyDefinition selfAssembly; + + readonly Logger Log; + + public ILPostProcessorAssemblyResolver(ICompiledAssembly compiledAssembly, Logger Log) + { + this.compiledAssembly = compiledAssembly; + assemblyReferences = compiledAssembly.References; + this.Log = Log; + } + + public void Dispose() + { + Dispose(true); + GC.SuppressFinalize(this); + } + + protected virtual void Dispose(bool disposing) + { + // Cleanup + } + + public AssemblyDefinition Resolve(AssemblyNameReference name) => + Resolve(name, new ReaderParameters(ReadingMode.Deferred)); + + // here is an example on when this is called: + // Player : NetworkBehaviour has a [SyncVar] of type String. + // Weaver's SyncObjectInitializer checks if ImplementsSyncObject() + // which needs to resolve the type 'String' from mscorlib. + // Resolve() lives in CecilX.MetadataResolver.Resolve() + // which calls assembly_resolver.Resolve(). + // which uses our ILPostProcessorAssemblyResolver here. + // + // for large projects, this is called thousands of times for mscorlib alone. + // initially ILPostProcessorAssemblyResolver took 30x longer than with CompilationFinishedHook. + // we need to cache and speed up everything we can here! + public AssemblyDefinition Resolve(AssemblyNameReference name, ReaderParameters parameters) + { + if (name.Name == compiledAssembly.Name) + return selfAssembly; + + // cache FindFile. + // in large projects, this is called thousands(!) of times for String=>mscorlib alone. + // reduces a single String=>mscorlib resolve from 0.771ms to 0.015ms. + // => 50x improvement in TypeReference.Resolve() speed! + // => 22x improvement in Weaver speed! + if (!fileNameCache.TryGetValue(name.Name, out string fileName)) + { + fileName = FindFile(name.Name); + fileNameCache.TryAdd(name.Name, fileName); + } + + if (fileName == null) + { + // returning null will throw exceptions in our weaver where. + // let's make it obvious why we returned null for easier debugging. + // NOTE: if this fails for "System.Private.CoreLib": + // ILPostProcessorReflectionImporter fixes it! + Log.Warning($"ILPostProcessorAssemblyResolver.Resolve: Failed to find file for {name}"); + return null; + } + + // try to get cached assembly by filename + writetime + DateTime lastWriteTime = File.GetLastWriteTime(fileName); + string cacheKey = fileName + lastWriteTime; + if (assemblyCache.TryGetValue(cacheKey, out AssemblyDefinition result)) + return result; + + // otherwise resolve and cache a new assembly + parameters.AssemblyResolver = this; + MemoryStream ms = MemoryStreamFor(fileName); + + string pdb = fileName + ".pdb"; + if (File.Exists(pdb)) + parameters.SymbolStream = MemoryStreamFor(pdb); + + AssemblyDefinition assemblyDefinition = AssemblyDefinition.ReadAssembly(ms, parameters); + assemblyCache.TryAdd(cacheKey, assemblyDefinition); + return assemblyDefinition; + } + + // find assemblyname in assembly's references + string FindFile(string name) + { + // perhaps the type comes from a .dll or .exe + // check both in one call without Linq instead of iterating twice like originally + foreach (string r in assemblyReferences) + { + if (Path.GetFileNameWithoutExtension(r) == name) + return r; + } + + // this is called thousands(!) of times. + // constructing strings only once saves ~0.1ms per call for mscorlib. + string dllName = name + ".dll"; + + // Unfortunately the current ICompiledAssembly API only provides direct references. + // It is very much possible that a postprocessor ends up investigating a type in a directly + // referenced assembly, that contains a field that is not in a directly referenced assembly. + // if we don't do anything special for that situation, it will fail to resolve. We should fix this + // in the ILPostProcessing API. As a workaround, we rely on the fact here that the indirect references + // are always located next to direct references, so we search in all directories of direct references we + // got passed, and if we find the file in there, we resolve to it. + foreach (string parentDir in assemblyReferences.Select(Path.GetDirectoryName).Distinct()) + { + string candidate = Path.Combine(parentDir, dllName); + if (File.Exists(candidate)) + return candidate; + } + + return null; + } + + // open file as MemoryStream. + // ILPostProcessor is multithreaded. + // retry a few times in case another thread is still accessing the file. + static MemoryStream MemoryStreamFor(string fileName) + { + return Retry(10, TimeSpan.FromSeconds(1), () => + { + byte[] byteArray; + using (FileStream fs = new FileStream(fileName, FileMode.Open, FileAccess.Read, FileShare.ReadWrite)) + { + byteArray = new byte[fs.Length]; + int readLength = fs.Read(byteArray, 0, (int)fs.Length); + if (readLength != fs.Length) + throw new InvalidOperationException("File read length is not full length of file."); + } + + return new MemoryStream(byteArray); + }); + } + + static MemoryStream Retry(int retryCount, TimeSpan waitTime, Func func) + { + try + { + return func(); + } + catch (IOException) + { + if (retryCount == 0) + throw; + Console.WriteLine($"Caught IO Exception, trying {retryCount} more times"); + Thread.Sleep(waitTime); + return Retry(retryCount - 1, waitTime, func); + } + } + + // if the CompiledAssembly's AssemblyDefinition is known, we can add it + public void SetAssemblyDefinitionForCompiledAssembly(AssemblyDefinition assemblyDefinition) + { + selfAssembly = assemblyDefinition; + } + } +} +#endif diff --git a/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorAssemblyResolver.cs.meta b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorAssemblyResolver.cs.meta new file mode 100644 index 0000000..07289dd --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorAssemblyResolver.cs.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: 0b3e94696e22440ead0b3a42411bbe14 +timeCreated: 1629693784 \ No newline at end of file diff --git a/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorFromFile.cs b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorFromFile.cs new file mode 100644 index 0000000..6a70641 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorFromFile.cs @@ -0,0 +1,53 @@ +// helper function to use ILPostProcessor for an assembly from file. +// we keep this in Weaver folder because we can access CompilationPipleine here. +// in tests folder we can't, unless we rename to "Unity.*.CodeGen", +// but then tests wouldn't be weaved anymore. +#if UNITY_2020_3_OR_NEWER +using System; +using System.IO; +using Unity.CompilationPipeline.Common.Diagnostics; +using Unity.CompilationPipeline.Common.ILPostProcessing; + +namespace Mirror.Weaver +{ + public static class ILPostProcessorFromFile + { + // read, weave, write file via ILPostProcessor + public static void ILPostProcessFile(string assemblyPath, string[] references, Action OnWarning, Action OnError) + { + // we COULD Weave() with a test logger manually. + // but for test result consistency on all platforms, + // let's invoke the ILPostProcessor here too. + CompiledAssemblyFromFile assembly = new CompiledAssemblyFromFile(assemblyPath); + assembly.References = references; + + // create ILPP and check WillProcess like Unity would. + ILPostProcessorHook ilpp = new ILPostProcessorHook(); + if (ilpp.WillProcess(assembly)) + { + //Debug.Log($"Will Process: {assembly.Name}"); + + // process it like Unity would + ILPostProcessResult result = ilpp.Process(assembly); + + // handle the error messages like Unity would + foreach (DiagnosticMessage message in result.Diagnostics) + { + if (message.DiagnosticType == DiagnosticType.Warning) + { + OnWarning(message.MessageData); + } + else if (message.DiagnosticType == DiagnosticType.Error) + { + OnError(message.MessageData); + } + } + + // save the weaved assembly to file. + // some tests open it and check for certain IL code. + File.WriteAllBytes(assemblyPath, result.InMemoryAssembly.PeData); + } + } + } +} +#endif diff --git a/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorFromFile.cs.meta b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorFromFile.cs.meta new file mode 100644 index 0000000..e06dfa7 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorFromFile.cs.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: 2a4b115486b74d27a9540f3c39ae2d46 +timeCreated: 1630152191 \ No newline at end of file diff --git a/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorHook.cs b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorHook.cs new file mode 100644 index 0000000..0cfb433 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorHook.cs @@ -0,0 +1,143 @@ +// hook via ILPostProcessor from Unity 2020.3+ +// (2020.1 has errors https://github.com/vis2k/Mirror/issues/2912) +#if UNITY_2020_3_OR_NEWER +// Unity.CompilationPipeline reference is only resolved if assembly name is +// Unity.*.CodeGen: +// https://forum.unity.com/threads/how-does-unity-do-codegen-and-why-cant-i-do-it-myself.853867/#post-5646937 +using System.IO; +using System.Linq; +// to use Mono.CecilX here, we need to 'override references' in the +// Unity.Mirror.CodeGen assembly definition file in the Editor, and add CecilX. +// otherwise we get a reflection exception with 'file not found: CecilX'. +using Mono.CecilX; +using Mono.CecilX.Cil; +using Unity.CompilationPipeline.Common.ILPostProcessing; +// IMPORTANT: 'using UnityEngine' does not work in here. +// Unity gives "(0,0): error System.Security.SecurityException: ECall methods must be packaged into a system module." +//using UnityEngine; + +namespace Mirror.Weaver +{ + public class ILPostProcessorHook : ILPostProcessor + { + // from CompilationFinishedHook + const string MirrorRuntimeAssemblyName = "Mirror"; + + // ILPostProcessor is invoked by Unity. + // we can not tell it to ignore certain assemblies before processing. + // add a 'ignore' define for convenience. + // => WeaverTests/WeaverAssembler need it to avoid Unity running it + public const string IgnoreDefine = "ILPP_IGNORE"; + + // we can't use Debug.Log in ILPP, so we need a custom logger + ILPostProcessorLogger Log = new ILPostProcessorLogger(); + + // ??? + public override ILPostProcessor GetInstance() => this; + + // check if assembly has the 'ignore' define + static bool HasDefine(ICompiledAssembly assembly, string define) => + assembly.Defines != null && + assembly.Defines.Contains(define); + + // process Mirror, or anything that references Mirror + public override bool WillProcess(ICompiledAssembly compiledAssembly) + { + // compiledAssembly.References are file paths: + // Library/Bee/artifacts/200b0aE.dag/Mirror.CompilerSymbols.dll + // Assets/Mirror/Plugins/Mono.Cecil/Mono.CecilX.dll + // /Applications/Unity/Hub/Editor/2021.2.0b6_apple_silicon/Unity.app/Contents/NetStandard/ref/2.1.0/netstandard.dll + // + // log them to see: + // foreach (string reference in compiledAssembly.References) + // LogDiagnostics($"{compiledAssembly.Name} references {reference}"); + bool relevant = compiledAssembly.Name == MirrorRuntimeAssemblyName || + compiledAssembly.References.Any(filePath => Path.GetFileNameWithoutExtension(filePath) == MirrorRuntimeAssemblyName); + bool ignore = HasDefine(compiledAssembly, IgnoreDefine); + return relevant && !ignore; + } + + public override ILPostProcessResult Process(ICompiledAssembly compiledAssembly) + { + //Log.Warning($"Processing {compiledAssembly.Name}"); + + // load the InMemoryAssembly peData into a MemoryStream + byte[] peData = compiledAssembly.InMemoryAssembly.PeData; + //LogDiagnostics($" peData.Length={peData.Length} bytes"); + using (MemoryStream stream = new MemoryStream(peData)) + using (ILPostProcessorAssemblyResolver asmResolver = new ILPostProcessorAssemblyResolver(compiledAssembly, Log)) + { + // we need to load symbols. otherwise we get: + // "(0,0): error Mono.CecilX.Cil.SymbolsNotFoundException: No symbol found for file: " + using (MemoryStream symbols = new MemoryStream(compiledAssembly.InMemoryAssembly.PdbData)) + { + ReaderParameters readerParameters = new ReaderParameters{ + SymbolStream = symbols, + ReadWrite = true, + ReadSymbols = true, + AssemblyResolver = asmResolver, + // custom reflection importer to fix System.Private.CoreLib + // not being found in custom assembly resolver above. + ReflectionImporterProvider = new ILPostProcessorReflectionImporterProvider() + }; + using (AssemblyDefinition asmDef = AssemblyDefinition.ReadAssembly(stream, readerParameters)) + { + // resolving a Mirror.dll type like NetworkServer while + // weaving Mirror.dll does not work. it throws a + // NullReferenceException in WeaverTypes.ctor + // when Resolve() is called on the first Mirror type. + // need to add the AssemblyDefinition itself to use. + asmResolver.SetAssemblyDefinitionForCompiledAssembly(asmDef); + + // weave this assembly. + Weaver weaver = new Weaver(Log); + if (weaver.Weave(asmDef, asmResolver, out bool modified)) + { + //Log.Warning($"Weaving succeeded for: {compiledAssembly.Name}"); + + // write if modified + if (modified) + { + // when weaving Mirror.dll with ILPostProcessor, + // Weave() -> WeaverTypes -> resolving the first + // type in Mirror.dll adds a reference to + // Mirror.dll even though we are in Mirror.dll. + // -> this would throw an exception: + // "Mirror references itself" and not compile + // -> need to detect and fix manually here + if (asmDef.MainModule.AssemblyReferences.Any(r => r.Name == asmDef.Name.Name)) + { + asmDef.MainModule.AssemblyReferences.Remove(asmDef.MainModule.AssemblyReferences.First(r => r.Name == asmDef.Name.Name)); + //Log.Warning($"fixed self referencing Assembly: {asmDef.Name.Name}"); + } + + MemoryStream peOut = new MemoryStream(); + MemoryStream pdbOut = new MemoryStream(); + WriterParameters writerParameters = new WriterParameters + { + SymbolWriterProvider = new PortablePdbWriterProvider(), + SymbolStream = pdbOut, + WriteSymbols = true + }; + + asmDef.Write(peOut, writerParameters); + + InMemoryAssembly inMemory = new InMemoryAssembly(peOut.ToArray(), pdbOut.ToArray()); + return new ILPostProcessResult(inMemory, Log.Logs); + } + } + // if anything during Weave() fails, we log an error. + // don't need to indicate 'weaving failed' again. + // in fact, this would break tests only expecting certain errors. + //else Log.Error($"Weaving failed for: {compiledAssembly.Name}"); + } + } + } + + // always return an ILPostProcessResult with Logs. + // otherwise we won't see Logs if weaving failed. + return new ILPostProcessResult(compiledAssembly.InMemoryAssembly, Log.Logs); + } + } +} +#endif diff --git a/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorHook.cs.meta b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorHook.cs.meta new file mode 100644 index 0000000..9d7e0a2 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorHook.cs.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: 5f113eb695b348b5b28cd85358c8959a +timeCreated: 1628859074 \ No newline at end of file diff --git a/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorLogger.cs b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorLogger.cs new file mode 100644 index 0000000..e8595fd --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorLogger.cs @@ -0,0 +1,68 @@ +using System.Collections.Generic; +using Mono.CecilX; +using Unity.CompilationPipeline.Common.Diagnostics; + +namespace Mirror.Weaver +{ + public class ILPostProcessorLogger : Logger + { + // can't Debug.Log in ILPostProcessor. need to add to this list. + internal List Logs = new List(); + + void Add(string message, DiagnosticType logType) + { + Logs.Add(new DiagnosticMessage + { + // TODO add file etc. for double click opening later? + DiagnosticType = logType, // doesn't have .Log + File = null, + Line = 0, + Column = 0, + MessageData = message + }); + } + + public void LogDiagnostics(string message, DiagnosticType logType = DiagnosticType.Warning) + { + // TODO IN-44868 FIX IS IN 2021.3.32f1, 2022.3.11f1, 2023.2.0b13 and 2023.3.0a8 + // DiagnosticMessage can't display \n for some reason. + // it just cuts it off and we don't see any stack trace. + // so let's replace all line breaks so we get the stack trace. + // (Unity 2021.2.0b6 apple silicon) + //message = message.Replace("\n", "/"); + + // lets break it into several messages instead so it's easier readable + string[] lines = message.Split('\n'); + + // if it's just one line, simply log it + if (lines.Length == 1) + { + // tests assume exact message log. + // don't include 'Weaver: ...' or similar. + Add($"{message}", logType); + } + // for multiple lines, log each line separately with start/end indicators + else + { + // first line with Weaver: ... first + Add("----------------------------------------------", logType); + foreach (string line in lines) Add(line, logType); + Add("----------------------------------------------", logType); + } + } + + public void Warning(string message) => Warning(message, null); + public void Warning(string message, MemberReference mr) + { + if (mr != null) message = $"{message} (at {mr})"; + LogDiagnostics(message, DiagnosticType.Warning); + } + + public void Error(string message) => Error(message, null); + public void Error(string message, MemberReference mr) + { + if (mr != null) message = $"{message} (at {mr})"; + LogDiagnostics(message, DiagnosticType.Error); + } + } +} diff --git a/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorLogger.cs.meta b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorLogger.cs.meta new file mode 100644 index 0000000..8bb72e0 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorLogger.cs.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: e7b56e7826664e34a415e4b70d958f2a +timeCreated: 1629533154 \ No newline at end of file diff --git a/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorReflectionImporter.cs b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorReflectionImporter.cs new file mode 100644 index 0000000..e15c103 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorReflectionImporter.cs @@ -0,0 +1,36 @@ +// based on paul's resolver from +// https://github.com/MirageNet/Mirage/commit/def64cd1db525398738f057b3d1eb1fe8afc540c?branch=def64cd1db525398738f057b3d1eb1fe8afc540c&diff=split +// +// ILPostProcessorAssemblyRESOLVER does not find the .dll file for: +// "System.Private.CoreLib" +// we need this custom reflection importer to fix that. +using System.Linq; +using System.Reflection; +using Mono.CecilX; + +namespace Mirror.Weaver +{ + internal class ILPostProcessorReflectionImporter : DefaultReflectionImporter + { + const string SystemPrivateCoreLib = "System.Private.CoreLib"; + readonly AssemblyNameReference fixedCoreLib; + + public ILPostProcessorReflectionImporter(ModuleDefinition module) : base(module) + { + // find the correct library for "System.Private.CoreLib". + // either mscorlib or netstandard. + // defaults to System.Private.CoreLib if not found. + fixedCoreLib = module.AssemblyReferences.FirstOrDefault(a => a.Name == "mscorlib" || a.Name == "netstandard" || a.Name == SystemPrivateCoreLib); + } + + public override AssemblyNameReference ImportReference(AssemblyName name) + { + // System.Private.CoreLib? + if (name.Name == SystemPrivateCoreLib && fixedCoreLib != null) + return fixedCoreLib; + + // otherwise import as usual + return base.ImportReference(name); + } + } +} diff --git a/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorReflectionImporter.cs.meta b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorReflectionImporter.cs.meta new file mode 100644 index 0000000..d361e21 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorReflectionImporter.cs.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: 6403a7e3b3ae4e009ae282f111d266e0 +timeCreated: 1629709256 \ No newline at end of file diff --git a/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorReflectionImporterProvider.cs b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorReflectionImporterProvider.cs new file mode 100644 index 0000000..7358e1b --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorReflectionImporterProvider.cs @@ -0,0 +1,16 @@ +// based on paul's resolver from +// https://github.com/MirageNet/Mirage/commit/def64cd1db525398738f057b3d1eb1fe8afc540c?branch=def64cd1db525398738f057b3d1eb1fe8afc540c&diff=split +// +// ILPostProcessorAssemblyRESOLVER does not find the .dll file for: +// "System.Private.CoreLib" +// we need this custom reflection importer to fix that. +using Mono.CecilX; + +namespace Mirror.Weaver +{ + internal class ILPostProcessorReflectionImporterProvider : IReflectionImporterProvider + { + public IReflectionImporter GetReflectionImporter(ModuleDefinition module) => + new ILPostProcessorReflectionImporter(module); + } +} diff --git a/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorReflectionImporterProvider.cs.meta b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorReflectionImporterProvider.cs.meta new file mode 100644 index 0000000..d9b6f6b --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/EntryPointILPostProcessor/ILPostProcessorReflectionImporterProvider.cs.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: a1003b568bad4e69b961c4c81d5afd96 +timeCreated: 1629709223 \ No newline at end of file diff --git a/Assets/Mirror/Editor/Weaver/Extensions.cs b/Assets/Mirror/Editor/Weaver/Extensions.cs new file mode 100644 index 0000000..566a51a --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Extensions.cs @@ -0,0 +1,359 @@ +using System; +using System.Collections.Generic; +using System.Linq; +using Mono.CecilX; + +namespace Mirror.Weaver +{ + public static class Extensions + { + public static bool Is(this TypeReference td, Type type) => + type.IsGenericType + ? td.GetElementType().FullName == type.FullName + : td.FullName == type.FullName; + + // check if 'td' is exactly of type T. + // it does not check if any base type is of , only the specific type. + // for example: + // NetworkConnection Is NetworkConnection: true + // NetworkConnectionToClient Is NetworkConnection: false + public static bool Is(this TypeReference td) => Is(td, typeof(T)); + + // check if 'tr' is derived from T. + // it does not check if 'tr' is exactly T. + // for example: + // NetworkConnection IsDerivedFrom: false + // NetworkConnectionToClient IsDerivedFrom: true + public static bool IsDerivedFrom(this TypeReference tr) => IsDerivedFrom(tr, typeof(T)); + + public static bool IsDerivedFrom(this TypeReference tr, Type baseClass) + { + TypeDefinition td = tr.Resolve(); + if (!td.IsClass) + return false; + + // are ANY parent classes of baseClass? + TypeReference parent = td.BaseType; + + if (parent == null) + return false; + + if (parent.Is(baseClass)) + return true; + + if (parent.CanBeResolved()) + return IsDerivedFrom(parent.Resolve(), baseClass); + + return false; + } + + public static TypeReference GetEnumUnderlyingType(this TypeDefinition td) + { + foreach (FieldDefinition field in td.Fields) + { + if (!field.IsStatic) + return field.FieldType; + } + throw new ArgumentException($"Invalid enum {td.FullName}"); + } + + public static bool ImplementsInterface(this TypeDefinition td) + { + TypeDefinition typedef = td; + + while (typedef != null) + { + if (typedef.Interfaces.Any(iface => iface.InterfaceType.Is())) + return true; + + try + { + TypeReference parent = typedef.BaseType; + typedef = parent?.Resolve(); + } + catch (AssemblyResolutionException) + { + // this can happen for plugins. + //Console.WriteLine("AssemblyResolutionException: "+ ex.ToString()); + break; + } + } + + return false; + } + + public static bool IsMultidimensionalArray(this TypeReference tr) => + tr is ArrayType arrayType && arrayType.Rank > 1; + + // Does type use netId as backing field + public static bool IsNetworkIdentityField(this TypeReference tr) => + tr.Is() || + tr.Is() || + // handle both NetworkBehaviour and inheritors. + // fixes: https://github.com/MirrorNetworking/Mirror/issues/2939 + tr.IsDerivedFrom() || + tr.Is(); + + public static bool CanBeResolved(this TypeReference parent) + { + while (parent != null) + { + if (parent.Scope.Name == "Windows") + { + return false; + } + + if (parent.Scope.Name == "mscorlib") + { + TypeDefinition resolved = parent.Resolve(); + return resolved != null; + } + + try + { + parent = parent.Resolve().BaseType; + } + catch + { + return false; + } + } + return true; + } + + // Makes T => Variable and imports function + public static MethodReference MakeGeneric(this MethodReference generic, ModuleDefinition module, TypeReference variableReference) + { + GenericInstanceMethod instance = new GenericInstanceMethod(generic); + instance.GenericArguments.Add(variableReference); + + MethodReference readFunc = module.ImportReference(instance); + return readFunc; + } + + // Given a method of a generic class such as ArraySegment`T.get_Count, + // and a generic instance such as ArraySegment`int + // Creates a reference to the specialized method ArraySegment`int`.get_Count + // Note that calling ArraySegment`T.get_Count directly gives an invalid IL error + public static MethodReference MakeHostInstanceGeneric(this MethodReference self, ModuleDefinition module, GenericInstanceType instanceType) + { + MethodReference reference = new MethodReference(self.Name, self.ReturnType, instanceType) + { + CallingConvention = self.CallingConvention, + HasThis = self.HasThis, + ExplicitThis = self.ExplicitThis + }; + + foreach (ParameterDefinition parameter in self.Parameters) + reference.Parameters.Add(new ParameterDefinition(parameter.ParameterType)); + + foreach (GenericParameter generic_parameter in self.GenericParameters) + reference.GenericParameters.Add(new GenericParameter(generic_parameter.Name, reference)); + + return module.ImportReference(reference); + } + + // needed for NetworkBehaviour support + // https://github.com/vis2k/Mirror/pull/3073/ + public static FieldReference MakeHostInstanceGeneric(this FieldReference self) + { + var declaringType = new GenericInstanceType(self.DeclaringType); + foreach (var parameter in self.DeclaringType.GenericParameters) + { + declaringType.GenericArguments.Add(parameter); + } + return new FieldReference(self.Name, self.FieldType, declaringType); + } + + // Given a field of a generic class such as Writer.write, + // and a generic instance such as ArraySegment`int + // Creates a reference to the specialized method ArraySegment`int`.get_Count + // Note that calling ArraySegment`T.get_Count directly gives an invalid IL error + public static FieldReference SpecializeField(this FieldReference self, ModuleDefinition module, GenericInstanceType instanceType) + { + FieldReference reference = new FieldReference(self.Name, self.FieldType, instanceType); + return module.ImportReference(reference); + } + + public static CustomAttribute GetCustomAttribute(this ICustomAttributeProvider method) + { + return method.CustomAttributes.FirstOrDefault(ca => ca.AttributeType.Is()); + } + + public static bool HasCustomAttribute(this ICustomAttributeProvider attributeProvider) + { + return attributeProvider.CustomAttributes.Any(attr => attr.AttributeType.Is()); + } + + public static T GetField(this CustomAttribute ca, string field, T defaultValue) + { + foreach (CustomAttributeNamedArgument customField in ca.Fields) + if (customField.Name == field) + return (T)customField.Argument.Value; + return defaultValue; + } + + public static MethodDefinition GetMethod(this TypeDefinition td, string methodName) + { + return td.Methods.FirstOrDefault(method => method.Name == methodName); + } + + public static List GetMethods(this TypeDefinition td, string methodName) + { + return td.Methods.Where(method => method.Name == methodName).ToList(); + } + + public static MethodDefinition GetMethodInBaseType(this TypeDefinition td, string methodName) + { + TypeDefinition typedef = td; + while (typedef != null) + { + foreach (MethodDefinition md in typedef.Methods) + { + if (md.Name == methodName) + return md; + } + + try + { + TypeReference parent = typedef.BaseType; + typedef = parent?.Resolve(); + } + catch (AssemblyResolutionException) + { + // this can happen for plugins. + break; + } + } + + return null; + } + + // Finds public fields in type and base type + public static IEnumerable FindAllPublicFields(this TypeReference variable) + { + return FindAllPublicFields(variable.Resolve()); + } + + // Finds public fields in type and base type + public static IEnumerable FindAllPublicFields(this TypeDefinition typeDefinition) + { + while (typeDefinition != null) + { + foreach (FieldDefinition field in typeDefinition.Fields) + { + // ignore static, private, protected fields + // fixes: https://github.com/MirrorNetworking/Mirror/issues/3485 + // credit: James Frowen + if (field.IsStatic || field.IsPrivate || field.IsFamily) + continue; + + // also ignore internal fields + // we dont want to create different writers for this type if they are in current dll or another dll + // so we have to ignore internal in all cases + if (field.IsAssembly) + continue; + + if (field.IsNotSerialized) + continue; + + yield return field; + } + + try + { + typeDefinition = typeDefinition.BaseType?.Resolve(); + } + catch (AssemblyResolutionException) + { + break; + } + } + } + + public static bool ContainsClass(this ModuleDefinition module, string nameSpace, string className) => + module.GetTypes().Any(td => td.Namespace == nameSpace && + td.Name == className); + + + public static AssemblyNameReference FindReference(this ModuleDefinition module, string referenceName) + { + foreach (AssemblyNameReference reference in module.AssemblyReferences) + { + if (reference.Name == referenceName) + return reference; + } + return null; + } + + // Takes generic arguments from child class and applies them to parent reference, if possible + // eg makes `Base` in Child : Base have `int` instead of `T` + // Originally by James-Frowen under MIT + // https://github.com/MirageNet/Mirage/commit/cf91e1d54796866d2cf87f8e919bb5c681977e45 + public static TypeReference ApplyGenericParameters(this TypeReference parentReference, + TypeReference childReference) + { + // If the parent is not generic, we got nothing to apply + if (!parentReference.IsGenericInstance) + return parentReference; + + GenericInstanceType parentGeneric = (GenericInstanceType)parentReference; + // make new type so we can replace the args on it + // resolve it so we have non-generic instance (eg just instance with instead of ) + // if we don't cecil will make it double generic (eg INVALID IL) + GenericInstanceType generic = new GenericInstanceType(parentReference.Resolve()); + foreach (TypeReference arg in parentGeneric.GenericArguments) + generic.GenericArguments.Add(arg); + + for (int i = 0; i < generic.GenericArguments.Count; i++) + { + // if arg is not generic + // eg List would be int so not generic. + // But List would be T so is generic + if (!generic.GenericArguments[i].IsGenericParameter) + continue; + + // get the generic name, eg T + string name = generic.GenericArguments[i].Name; + // find what type T is, eg turn it into `int` if `List` + TypeReference arg = FindMatchingGenericArgument(childReference, name); + + // import just to be safe + TypeReference imported = parentReference.Module.ImportReference(arg); + // set arg on generic, parent ref will be Base instead of just Base + generic.GenericArguments[i] = imported; + } + + return generic; + } + + // Finds the type reference for a generic parameter with the provided name in the child reference + // Originally by James-Frowen under MIT + // https://github.com/MirageNet/Mirage/commit/cf91e1d54796866d2cf87f8e919bb5c681977e45 + static TypeReference FindMatchingGenericArgument(TypeReference childReference, string paramName) + { + TypeDefinition def = childReference.Resolve(); + // child class must be generic if we are in this part of the code + // eg Child : Base <--- child must have generic if Base has T + // vs Child : Base <--- wont be here if Base has int (we check if T exists before calling this) + if (!def.HasGenericParameters) + throw new InvalidOperationException( + "Base class had generic parameters, but could not find them in child class"); + + // go through parameters in child class, and find the generic that matches the name + for (int i = 0; i < def.GenericParameters.Count; i++) + { + GenericParameter param = def.GenericParameters[i]; + if (param.Name == paramName) + { + GenericInstanceType generic = (GenericInstanceType)childReference; + // return generic arg with same index + return generic.GenericArguments[i]; + } + } + + // this should never happen, if it does it means that this code is bugged + throw new InvalidOperationException("Did not find matching generic"); + } + } +} diff --git a/Assets/Mirror/Editor/Weaver/Extensions.cs.meta b/Assets/Mirror/Editor/Weaver/Extensions.cs.meta new file mode 100644 index 0000000..78660f9 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Extensions.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 562a5cf0254cc45738e9aa549a7100b2 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Weaver/Helpers.cs b/Assets/Mirror/Editor/Weaver/Helpers.cs new file mode 100644 index 0000000..56b7385 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Helpers.cs @@ -0,0 +1,26 @@ +using System.IO; +using System.Linq; +using System.Reflection; +using Mono.CecilX; + +namespace Mirror.Weaver +{ + static class Helpers + { + // This code is taken from SerializationWeaver + public static string UnityEngineDllDirectoryName() + { + string directoryName = Path.GetDirectoryName(Assembly.GetExecutingAssembly().CodeBase); + return directoryName?.Replace(@"file:\", ""); + } + + public static bool IsEditorAssembly(AssemblyDefinition currentAssembly) + { + // we want to add the [InitializeOnLoad] attribute if it's available + // -> usually either 'UnityEditor' or 'UnityEditor.CoreModule' + return currentAssembly.MainModule.AssemblyReferences.Any(assemblyReference => + assemblyReference.Name.StartsWith(nameof(UnityEditor)) + ); + } + } +} diff --git a/Assets/Mirror/Editor/Weaver/Helpers.cs.meta b/Assets/Mirror/Editor/Weaver/Helpers.cs.meta new file mode 100644 index 0000000..231f539 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Helpers.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 6c4ed76daf48547c5abb7c58f8d20886 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Weaver/Logger.cs b/Assets/Mirror/Editor/Weaver/Logger.cs new file mode 100644 index 0000000..8be978f --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Logger.cs @@ -0,0 +1,13 @@ +using Mono.CecilX; + +namespace Mirror.Weaver +{ + // not static, because ILPostProcessor is multithreaded + public interface Logger + { + void Warning(string message); + void Warning(string message, MemberReference mr); + void Error(string message); + void Error(string message, MemberReference mr); + } +} diff --git a/Assets/Mirror/Editor/Weaver/Logger.cs.meta b/Assets/Mirror/Editor/Weaver/Logger.cs.meta new file mode 100644 index 0000000..3f62978 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Logger.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 2a21c60c40a4c4d679c2b71a7c40882e +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Weaver/Processors.meta b/Assets/Mirror/Editor/Weaver/Processors.meta new file mode 100644 index 0000000..eb719b4 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Processors.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: e538d627280d2471b8c72fdea822ca49 +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Weaver/Processors/CommandProcessor.cs b/Assets/Mirror/Editor/Weaver/Processors/CommandProcessor.cs new file mode 100644 index 0000000..db2d5af --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Processors/CommandProcessor.cs @@ -0,0 +1,130 @@ +using Mono.CecilX; +using Mono.CecilX.Cil; + +namespace Mirror.Weaver +{ + // Processes [Command] methods in NetworkBehaviour + public static class CommandProcessor + { + /* + // generates code like: + public void CmdThrust(float thrusting, int spin) + { + NetworkWriterPooled writer = NetworkWriterPool.Get(); + writer.Write(thrusting); + writer.WritePackedUInt32((uint)spin); + base.SendCommandInternal(cmdName, cmdHash, writer, channel); + NetworkWriterPool.Return(writer); + } + + public void CallCmdThrust(float thrusting, int spin) + { + // whatever the user was doing before + } + + Originally HLAPI put the send message code inside the Call function + and then proceeded to replace every call to CmdTrust with CallCmdTrust + + This method moves all the user's code into the "CallCmd" method + and replaces the body of the original method with the send message code. + This way we do not need to modify the code anywhere else, and this works + correctly in dependent assemblies + */ + public static MethodDefinition ProcessCommandCall(WeaverTypes weaverTypes, Writers writers, Logger Log, TypeDefinition td, MethodDefinition md, CustomAttribute commandAttr, ref bool WeavingFailed) + { + MethodDefinition cmd = MethodProcessor.SubstituteMethod(Log, td, md, ref WeavingFailed); + + ILProcessor worker = md.Body.GetILProcessor(); + + NetworkBehaviourProcessor.WriteSetupLocals(worker, weaverTypes); + + // NetworkWriter writer = new NetworkWriter(); + NetworkBehaviourProcessor.WriteGetWriter(worker, weaverTypes); + + // write all the arguments that the user passed to the Cmd call + if (!NetworkBehaviourProcessor.WriteArguments(worker, writers, Log, md, RemoteCallType.Command, ref WeavingFailed)) + return null; + + int channel = commandAttr.GetField("channel", 0); + bool requiresAuthority = commandAttr.GetField("requiresAuthority", true); + + // invoke internal send and return + // load 'base.' to call the SendCommand function with + worker.Emit(OpCodes.Ldarg_0); + // pass full function name to avoid ClassA.Func <-> ClassB.Func collisions + worker.Emit(OpCodes.Ldstr, md.FullName); + // pass the function hash so we don't have to compute it at runtime + // otherwise each GetStableHash call requires O(N) complexity. + // noticeable for long function names: + // https://github.com/MirrorNetworking/Mirror/issues/3375 + worker.Emit(OpCodes.Ldc_I4, md.FullName.GetStableHashCode()); + // writer + worker.Emit(OpCodes.Ldloc_0); + worker.Emit(OpCodes.Ldc_I4, channel); + // requiresAuthority ? 1 : 0 + worker.Emit(requiresAuthority ? OpCodes.Ldc_I4_1 : OpCodes.Ldc_I4_0); + worker.Emit(OpCodes.Call, weaverTypes.sendCommandInternal); + + NetworkBehaviourProcessor.WriteReturnWriter(worker, weaverTypes); + + worker.Emit(OpCodes.Ret); + return cmd; + } + + /* + // generates code like: + protected static void InvokeCmdCmdThrust(NetworkBehaviour obj, NetworkReader reader, NetworkConnection senderConnection) + { + if (!NetworkServer.active) + { + return; + } + ((ShipControl)obj).CmdThrust(reader.ReadSingle(), (int)reader.ReadPackedUInt32()); + } + */ + public static MethodDefinition ProcessCommandInvoke(WeaverTypes weaverTypes, Readers readers, Logger Log, TypeDefinition td, MethodDefinition method, MethodDefinition cmdCallFunc, ref bool WeavingFailed) + { + string cmdName = Weaver.GenerateMethodName(RemoteCalls.RemoteProcedureCalls.InvokeRpcPrefix, method); + + MethodDefinition cmd = new MethodDefinition(cmdName, + MethodAttributes.Family | MethodAttributes.Static | MethodAttributes.HideBySig, + weaverTypes.Import(typeof(void))); + + ILProcessor worker = cmd.Body.GetILProcessor(); + Instruction label = worker.Create(OpCodes.Nop); + + NetworkBehaviourProcessor.WriteServerActiveCheck(worker, weaverTypes, method.Name, label, "Command"); + + // setup for reader + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Castclass, td); + + if (!NetworkBehaviourProcessor.ReadArguments(method, readers, Log, worker, RemoteCallType.Command, ref WeavingFailed)) + return null; + + AddSenderConnection(method, worker); + + // invoke actual command function + worker.Emit(OpCodes.Callvirt, cmdCallFunc); + worker.Emit(OpCodes.Ret); + + NetworkBehaviourProcessor.AddInvokeParameters(weaverTypes, cmd.Parameters); + + td.Methods.Add(cmd); + return cmd; + } + + static void AddSenderConnection(MethodDefinition method, ILProcessor worker) + { + foreach (ParameterDefinition param in method.Parameters) + { + if (NetworkBehaviourProcessor.IsSenderConnection(param, RemoteCallType.Command)) + { + // NetworkConnection is 3nd arg (arg0 is "obj" not "this" because method is static) + // example: static void InvokeCmdCmdSendCommand(NetworkBehaviour obj, NetworkReader reader, NetworkConnection connection) + worker.Emit(OpCodes.Ldarg_2); + } + } + } + } +} diff --git a/Assets/Mirror/Editor/Weaver/Processors/CommandProcessor.cs.meta b/Assets/Mirror/Editor/Weaver/Processors/CommandProcessor.cs.meta new file mode 100644 index 0000000..20c3e15 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Processors/CommandProcessor.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 73f6c9cdbb9e54f65b3a0a35cc8e55c2 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Weaver/Processors/MethodProcessor.cs b/Assets/Mirror/Editor/Weaver/Processors/MethodProcessor.cs new file mode 100644 index 0000000..8a4c581 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Processors/MethodProcessor.cs @@ -0,0 +1,139 @@ +using Mono.CecilX; +using Mono.CecilX.Cil; + +namespace Mirror.Weaver +{ + public static class MethodProcessor + { + const string RpcPrefix = "UserCode_"; + + // For a function like + // [ClientRpc] void RpcTest(int value), + // Weaver substitutes the method and moves the code to a new method: + // UserCode_RpcTest(int value) <- contains original code + // RpcTest(int value) <- serializes parameters, sends the message + // + // Note that all the calls to the method remain untouched. + // FixRemoteCallToBaseMethod replaces them afterwards. + public static MethodDefinition SubstituteMethod(Logger Log, TypeDefinition td, MethodDefinition md, ref bool WeavingFailed) + { + string newName = Weaver.GenerateMethodName(RpcPrefix, md); + + MethodDefinition cmd = new MethodDefinition(newName, md.Attributes, md.ReturnType); + + // force the substitute method to be protected. + // -> public would show in the Inspector for UnityEvents as + // User_CmdUsePotion() etc. but the user shouldn't use those. + // -> private would not allow inheriting classes to call it, see + // OverrideVirtualWithBaseCallsBothVirtualAndBase test. + // -> IL has no concept of 'protected', it's called IsFamily there. + cmd.IsPublic = false; + cmd.IsFamily = true; + + // add parameters + foreach (ParameterDefinition pd in md.Parameters) + { + cmd.Parameters.Add(new ParameterDefinition(pd.Name, ParameterAttributes.None, pd.ParameterType)); + } + + // swap bodies + (cmd.Body, md.Body) = (md.Body, cmd.Body); + + // Move over all the debugging information + foreach (SequencePoint sequencePoint in md.DebugInformation.SequencePoints) + cmd.DebugInformation.SequencePoints.Add(sequencePoint); + md.DebugInformation.SequencePoints.Clear(); + + foreach (CustomDebugInformation customInfo in md.CustomDebugInformations) + cmd.CustomDebugInformations.Add(customInfo); + md.CustomDebugInformations.Clear(); + + (md.DebugInformation.Scope, cmd.DebugInformation.Scope) = (cmd.DebugInformation.Scope, md.DebugInformation.Scope); + + td.Methods.Add(cmd); + + FixRemoteCallToBaseMethod(Log, td, cmd, ref WeavingFailed); + return cmd; + } + + // For a function like + // [ClientRpc] void RpcTest(int value), + // Weaver substitutes the method and moves the code to a new method: + // UserCode_RpcTest(int value) <- contains original code + // RpcTest(int value) <- serializes parameters, sends the message + // + // FixRemoteCallToBaseMethod replaces all calls to + // RpcTest(value) + // with + // UserCode_RpcTest(value) + public static void FixRemoteCallToBaseMethod(Logger Log, TypeDefinition type, MethodDefinition method, ref bool WeavingFailed) + { + string callName = method.Name; + + // Cmd/rpc start with Weaver.RpcPrefix + // e.g. CallCmdDoSomething + if (!callName.StartsWith(RpcPrefix)) + return; + + // e.g. CmdDoSomething + string baseRemoteCallName = method.Name.Substring(RpcPrefix.Length); + + foreach (Instruction instruction in method.Body.Instructions) + { + // is this instruction a Call to a method? + // if yes, output the method so we can check it. + if (IsCallToMethod(instruction, out MethodDefinition calledMethod)) + { + // when considering if 'calledMethod' is a call to 'method', + // we originally compared .Name. + // + // to fix IL2CPP build bugs with overloaded Rpcs, we need to + // generated rpc names like + // RpcTest(string value) => RpcTestString(strig value) + // RpcTest(int value) => RpcTestInt(int value) + // to make them unique. + // + // calledMethod.Name is still "RpcTest", so we need to + // convert this to the generated name as well before comparing. + string calledMethodName_Generated = Weaver.GenerateMethodName("", calledMethod); + if (calledMethodName_Generated == baseRemoteCallName) + { + TypeDefinition baseType = type.BaseType.Resolve(); + MethodDefinition baseMethod = baseType.GetMethodInBaseType(callName); + + if (baseMethod == null) + { + Log.Error($"Could not find base method for {callName}", method); + WeavingFailed = true; + return; + } + + if (!baseMethod.IsVirtual) + { + Log.Error($"Could not find base method that was virtual {callName}", method); + WeavingFailed = true; + return; + } + + instruction.Operand = baseMethod; + } + } + } + } + + static bool IsCallToMethod(Instruction instruction, out MethodDefinition calledMethod) + { + if (instruction.OpCode == OpCodes.Call && + instruction.Operand is MethodDefinition method) + { + calledMethod = method; + return true; + } + else + { + calledMethod = null; + return false; + } + } + } +} diff --git a/Assets/Mirror/Editor/Weaver/Processors/MethodProcessor.cs.meta b/Assets/Mirror/Editor/Weaver/Processors/MethodProcessor.cs.meta new file mode 100644 index 0000000..3c81894 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Processors/MethodProcessor.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 661e1af528e3441f79e1552fb5ec4e0e +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Weaver/Processors/MonoBehaviourProcessor.cs b/Assets/Mirror/Editor/Weaver/Processors/MonoBehaviourProcessor.cs new file mode 100644 index 0000000..e88c5d6 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Processors/MonoBehaviourProcessor.cs @@ -0,0 +1,56 @@ +using Mono.CecilX; + +namespace Mirror.Weaver +{ + // only shows warnings in case we use SyncVars etc. for MonoBehaviour. + static class MonoBehaviourProcessor + { + public static void Process(Logger Log, TypeDefinition td, ref bool WeavingFailed) + { + ProcessSyncVars(Log, td, ref WeavingFailed); + ProcessMethods(Log, td, ref WeavingFailed); + } + + static void ProcessSyncVars(Logger Log, TypeDefinition td, ref bool WeavingFailed) + { + // find syncvars + foreach (FieldDefinition fd in td.Fields) + { + if (fd.HasCustomAttribute()) + { + Log.Error($"SyncVar {fd.Name} must be inside a NetworkBehaviour. {td.Name} is not a NetworkBehaviour", fd); + WeavingFailed = true; + } + + if (SyncObjectInitializer.ImplementsSyncObject(fd.FieldType)) + { + Log.Error($"{fd.Name} is a SyncObject and must be inside a NetworkBehaviour. {td.Name} is not a NetworkBehaviour", fd); + WeavingFailed = true; + } + } + } + + static void ProcessMethods(Logger Log, TypeDefinition td, ref bool WeavingFailed) + { + // find command and RPC functions + foreach (MethodDefinition md in td.Methods) + { + if (md.HasCustomAttribute()) + { + Log.Error($"Command {md.Name} must be declared inside a NetworkBehaviour", md); + WeavingFailed = true; + } + if (md.HasCustomAttribute()) + { + Log.Error($"ClientRpc {md.Name} must be declared inside a NetworkBehaviour", md); + WeavingFailed = true; + } + if (md.HasCustomAttribute()) + { + Log.Error($"TargetRpc {md.Name} must be declared inside a NetworkBehaviour", md); + WeavingFailed = true; + } + } + } + } +} diff --git a/Assets/Mirror/Editor/Weaver/Processors/MonoBehaviourProcessor.cs.meta b/Assets/Mirror/Editor/Weaver/Processors/MonoBehaviourProcessor.cs.meta new file mode 100644 index 0000000..ef3f5f4 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Processors/MonoBehaviourProcessor.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 35c16722912b64af894e4f6668f2e54c +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Weaver/Processors/NetworkBehaviourProcessor.cs b/Assets/Mirror/Editor/Weaver/Processors/NetworkBehaviourProcessor.cs new file mode 100644 index 0000000..47f1b94 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Processors/NetworkBehaviourProcessor.cs @@ -0,0 +1,1055 @@ +using System.Collections.Generic; +using Mono.CecilX; +using Mono.CecilX.Cil; + +namespace Mirror.Weaver +{ + public enum RemoteCallType + { + Command, + ClientRpc, + TargetRpc + } + + // processes SyncVars, Cmds, Rpcs, etc. of NetworkBehaviours + class NetworkBehaviourProcessor + { + AssemblyDefinition assembly; + WeaverTypes weaverTypes; + SyncVarAccessLists syncVarAccessLists; + SyncVarAttributeProcessor syncVarAttributeProcessor; + Writers writers; + Readers readers; + Logger Log; + + List syncVars = new List(); + List syncObjects = new List(); + // + Dictionary syncVarNetIds = new Dictionary(); + // - Every syncvar with a hook has a new field created to store the Action delegate so we don't allocate on every hook invocation + // This dictionary maps each syncvar field to the field that will store the hook method delegate instance, and the method from which the delegate instance is constructed from + Dictionary syncVarHookDelegates = new Dictionary(); + readonly List commands = new List(); + readonly List clientRpcs = new List(); + readonly List targetRpcs = new List(); + readonly List commandInvocationFuncs = new List(); + readonly List clientRpcInvocationFuncs = new List(); + readonly List targetRpcInvocationFuncs = new List(); + + readonly TypeDefinition netBehaviourSubclass; + + public struct CmdResult + { + public MethodDefinition method; + public bool requiresAuthority; + } + + public struct ClientRpcResult + { + public MethodDefinition method; + public bool includeOwner; + } + + public NetworkBehaviourProcessor(AssemblyDefinition assembly, WeaverTypes weaverTypes, SyncVarAccessLists syncVarAccessLists, Writers writers, Readers readers, Logger Log, TypeDefinition td) + { + this.assembly = assembly; + this.weaverTypes = weaverTypes; + this.syncVarAccessLists = syncVarAccessLists; + this.writers = writers; + this.readers = readers; + this.Log = Log; + syncVarAttributeProcessor = new SyncVarAttributeProcessor(assembly, weaverTypes, syncVarAccessLists, Log); + netBehaviourSubclass = td; + } + + // return true if modified + public bool Process(ref bool WeavingFailed) + { + // only process once + if (WasProcessed(netBehaviourSubclass)) + { + return false; + } + + MarkAsProcessed(netBehaviourSubclass); + + // deconstruct tuple and set fields + (syncVars, syncVarNetIds, syncVarHookDelegates) = syncVarAttributeProcessor.ProcessSyncVars(netBehaviourSubclass, ref WeavingFailed); + + syncObjects = SyncObjectProcessor.FindSyncObjectsFields(writers, readers, Log, netBehaviourSubclass, ref WeavingFailed); + + ProcessMethods(ref WeavingFailed); + if (WeavingFailed) + { + // originally Process returned true in every case, except if already processed. + // maybe return false here in the future. + return true; + } + + // inject initializations into static & instance constructor + InjectIntoStaticConstructor(ref WeavingFailed); + InjectIntoInstanceConstructor(ref WeavingFailed); + + GenerateSerialization(ref WeavingFailed); + if (WeavingFailed) + { + // originally Process returned true in every case, except if already processed. + // maybe return false here in the future. + return true; + } + + GenerateDeSerialization(ref WeavingFailed); + return true; + } + + /* + generates code like: + if (!NetworkClient.active) + Debug.LogError((object) "Command function CmdRespawn called on server."); + + which is used in InvokeCmd, InvokeRpc, etc. + */ + public static void WriteClientActiveCheck(ILProcessor worker, WeaverTypes weaverTypes, string mdName, Instruction label, string errString) + { + // client active check + worker.Emit(OpCodes.Call, weaverTypes.NetworkClientGetActive); + worker.Emit(OpCodes.Brtrue, label); + + worker.Emit(OpCodes.Ldstr, $"{errString} {mdName} called on server."); + worker.Emit(OpCodes.Call, weaverTypes.logErrorReference); + worker.Emit(OpCodes.Ret); + worker.Append(label); + } + /* + generates code like: + if (!NetworkServer.active) + Debug.LogError((object) "Command CmdMsgWhisper called on client."); + */ + public static void WriteServerActiveCheck(ILProcessor worker, WeaverTypes weaverTypes, string mdName, Instruction label, string errString) + { + // server active check + worker.Emit(OpCodes.Call, weaverTypes.NetworkServerGetActive); + worker.Emit(OpCodes.Brtrue, label); + + worker.Emit(OpCodes.Ldstr, $"{errString} {mdName} called on client."); + worker.Emit(OpCodes.Call, weaverTypes.logErrorReference); + worker.Emit(OpCodes.Ret); + worker.Append(label); + } + + public static void WriteSetupLocals(ILProcessor worker, WeaverTypes weaverTypes) + { + worker.Body.InitLocals = true; + worker.Body.Variables.Add(new VariableDefinition(weaverTypes.Import())); + } + + public static void WriteGetWriter(ILProcessor worker, WeaverTypes weaverTypes) + { + // create writer + worker.Emit(OpCodes.Call, weaverTypes.GetWriterReference); + worker.Emit(OpCodes.Stloc_0); + } + + public static void WriteReturnWriter(ILProcessor worker, WeaverTypes weaverTypes) + { + // NetworkWriterPool.Recycle(writer); + worker.Emit(OpCodes.Ldloc_0); + worker.Emit(OpCodes.Call, weaverTypes.ReturnWriterReference); + } + + public static bool WriteArguments(ILProcessor worker, Writers writers, Logger Log, MethodDefinition method, RemoteCallType callType, ref bool WeavingFailed) + { + // write each argument + // example result + /* + writer.WritePackedInt32(someNumber); + writer.WriteNetworkIdentity(someTarget); + */ + + bool skipFirst = callType == RemoteCallType.TargetRpc + && TargetRpcProcessor.HasNetworkConnectionParameter(method); + + // arg of calling function, arg 0 is "this" so start counting at 1 + int argNum = 1; + foreach (ParameterDefinition param in method.Parameters) + { + // NetworkConnection is not sent via the NetworkWriter so skip it here + // skip first for NetworkConnection in TargetRpc + if (argNum == 1 && skipFirst) + { + argNum += 1; + continue; + } + // skip SenderConnection in Command + if (IsSenderConnection(param, callType)) + { + argNum += 1; + continue; + } + + MethodReference writeFunc = writers.GetWriteFunc(param.ParameterType, ref WeavingFailed); + if (writeFunc == null) + { + Log.Error($"{method.Name} has invalid parameter {param}", method); + WeavingFailed = true; + return false; + } + + // use built-in writer func on writer object + // NetworkWriter object + worker.Emit(OpCodes.Ldloc_0); + // add argument to call + worker.Emit(OpCodes.Ldarg, argNum); + // call writer extension method + worker.Emit(OpCodes.Call, writeFunc); + argNum += 1; + } + return true; + } + + #region mark / check type as processed + public const string ProcessedFunctionName = "Weaved"; + + // check if the type has a "Weaved" function already + public static bool WasProcessed(TypeDefinition td) + { + return td.GetMethod(ProcessedFunctionName) != null; + } + + // add the Weaved() function which returns true. + // can be called at runtime and from tests to check if weaving succeeded. + public void MarkAsProcessed(TypeDefinition td) + { + if (!WasProcessed(td)) + { + // add a function: + // public override bool MirrorProcessed() { return true; } + // ReuseSlot means 'override'. + MethodDefinition versionMethod = new MethodDefinition( + ProcessedFunctionName, + MethodAttributes.Public | MethodAttributes.Virtual | MethodAttributes.ReuseSlot, + weaverTypes.Import(typeof(bool))); + ILProcessor worker = versionMethod.Body.GetILProcessor(); + worker.Emit(OpCodes.Ldc_I4_1); + worker.Emit(OpCodes.Ret); + td.Methods.Add(versionMethod); + } + } + #endregion + + // helper function to remove 'Ret' from the end of the method if 'Ret' + // is the last instruction. + // returns false if there was an issue + static bool RemoveFinalRetInstruction(MethodDefinition method) + { + // remove the return opcode from end of function. will add our own later. + if (method.Body.Instructions.Count != 0) + { + Instruction retInstr = method.Body.Instructions[method.Body.Instructions.Count - 1]; + if (retInstr.OpCode == OpCodes.Ret) + { + method.Body.Instructions.RemoveAt(method.Body.Instructions.Count - 1); + return true; + } + return false; + } + + // we did nothing, but there was no error. + return true; + } + + // we need to inject several initializations into NetworkBehaviour cctor + void InjectIntoStaticConstructor(ref bool WeavingFailed) + { + if (commands.Count == 0 && clientRpcs.Count == 0 && targetRpcs.Count == 0) + return; + + // find static constructor + MethodDefinition cctor = netBehaviourSubclass.GetMethod(".cctor"); + bool cctorFound = cctor != null; + if (cctor != null) + { + // remove the return opcode from end of function. will add our own later. + if (!RemoveFinalRetInstruction(cctor)) + { + Log.Error($"{netBehaviourSubclass.Name} has invalid class constructor", cctor); + WeavingFailed = true; + return; + } + } + else + { + // make one! + cctor = new MethodDefinition(".cctor", MethodAttributes.Private | + MethodAttributes.HideBySig | + MethodAttributes.SpecialName | + MethodAttributes.RTSpecialName | + MethodAttributes.Static, + weaverTypes.Import(typeof(void))); + } + + ILProcessor cctorWorker = cctor.Body.GetILProcessor(); + + // register all commands in cctor + for (int i = 0; i < commands.Count; ++i) + { + CmdResult cmdResult = commands[i]; + GenerateRegisterCommandDelegate(cctorWorker, weaverTypes.registerCommandReference, commandInvocationFuncs[i], cmdResult); + } + + // register all client rpcs in cctor + for (int i = 0; i < clientRpcs.Count; ++i) + { + ClientRpcResult clientRpcResult = clientRpcs[i]; + GenerateRegisterRemoteDelegate(cctorWorker, weaverTypes.registerRpcReference, clientRpcInvocationFuncs[i], clientRpcResult.method.FullName); + } + + // register all target rpcs in cctor + for (int i = 0; i < targetRpcs.Count; ++i) + { + GenerateRegisterRemoteDelegate(cctorWorker, weaverTypes.registerRpcReference, targetRpcInvocationFuncs[i], targetRpcs[i].FullName); + } + + // add final 'Ret' instruction to cctor + cctorWorker.Append(cctorWorker.Create(OpCodes.Ret)); + if (!cctorFound) + { + netBehaviourSubclass.Methods.Add(cctor); + } + + // in case class had no cctor, it might have BeforeFieldInit, so injected cctor would be called too late + netBehaviourSubclass.Attributes &= ~TypeAttributes.BeforeFieldInit; + } + + // we need to inject several initializations into NetworkBehaviour ctor + void InjectIntoInstanceConstructor(ref bool WeavingFailed) + { + if ((syncObjects.Count == 0) && (syncVarHookDelegates.Count == 0)) + return; + + // find instance constructor + MethodDefinition ctor = netBehaviourSubclass.GetMethod(".ctor"); + if (ctor == null) + { + Log.Error($"{netBehaviourSubclass.Name} has invalid constructor", netBehaviourSubclass); + WeavingFailed = true; + return; + } + + // remove the return opcode from end of function. will add our own later. + if (!RemoveFinalRetInstruction(ctor)) + { + Log.Error($"{netBehaviourSubclass.Name} has invalid constructor", ctor); + WeavingFailed = true; + return; + } + + ILProcessor ctorWorker = ctor.Body.GetILProcessor(); + + // initialize all sync objects in ctor + foreach (FieldDefinition fd in syncObjects) + { + SyncObjectInitializer.GenerateSyncObjectInitializer(ctorWorker, weaverTypes, fd); + } + + // initialize all delegate fields in ctor + foreach(KeyValuePair entry in syncVarHookDelegates) + { + FieldDefinition syncVarField = entry.Key; + (FieldDefinition hookDelegate, MethodDefinition hookMethod) = entry.Value; + syncVarAttributeProcessor.GenerateSyncVarHookDelegateInitializer(ctorWorker, syncVarField, hookDelegate, hookMethod); + } + + // add final 'Ret' instruction to ctor + ctorWorker.Append(ctorWorker.Create(OpCodes.Ret)); + } + + /* + // This generates code like: + NetworkBehaviour.RegisterCommandDelegate(base.GetType(), "CmdThrust", new NetworkBehaviour.CmdDelegate(ShipControl.InvokeCmdCmdThrust)); + */ + + // pass full function name to avoid ClassA.Func <-> ClassB.Func collisions + void GenerateRegisterRemoteDelegate(ILProcessor worker, MethodReference registerMethod, MethodDefinition func, string functionFullName) + { + worker.Emit(OpCodes.Ldtoken, netBehaviourSubclass); + worker.Emit(OpCodes.Call, weaverTypes.getTypeFromHandleReference); + worker.Emit(OpCodes.Ldstr, functionFullName); + worker.Emit(OpCodes.Ldnull); + worker.Emit(OpCodes.Ldftn, func); + + worker.Emit(OpCodes.Newobj, weaverTypes.RemoteCallDelegateConstructor); + // + worker.Emit(OpCodes.Call, registerMethod); + } + + void GenerateRegisterCommandDelegate(ILProcessor worker, MethodReference registerMethod, MethodDefinition func, CmdResult cmdResult) + { + // pass full function name to avoid ClassA.Func <-> ClassB.Func collisions + string cmdName = cmdResult.method.FullName; + bool requiresAuthority = cmdResult.requiresAuthority; + + worker.Emit(OpCodes.Ldtoken, netBehaviourSubclass); + worker.Emit(OpCodes.Call, weaverTypes.getTypeFromHandleReference); + worker.Emit(OpCodes.Ldstr, cmdName); + worker.Emit(OpCodes.Ldnull); + worker.Emit(OpCodes.Ldftn, func); + + worker.Emit(OpCodes.Newobj, weaverTypes.RemoteCallDelegateConstructor); + + // requiresAuthority ? 1 : 0 + worker.Emit(requiresAuthority ? OpCodes.Ldc_I4_1 : OpCodes.Ldc_I4_0); + + worker.Emit(OpCodes.Call, registerMethod); + } + + void GenerateSerialization(ref bool WeavingFailed) + { + const string SerializeMethodName = "SerializeSyncVars"; + if (netBehaviourSubclass.GetMethod(SerializeMethodName) != null) + return; + + if (syncVars.Count == 0) + { + // no synvars, no need for custom OnSerialize + return; + } + + MethodDefinition serialize = new MethodDefinition(SerializeMethodName, + MethodAttributes.Public | MethodAttributes.Virtual | MethodAttributes.HideBySig, + weaverTypes.Import(typeof(void))); + + serialize.Parameters.Add(new ParameterDefinition("writer", ParameterAttributes.None, weaverTypes.Import())); + serialize.Parameters.Add(new ParameterDefinition("forceAll", ParameterAttributes.None, weaverTypes.Import())); + ILProcessor worker = serialize.Body.GetILProcessor(); + + serialize.Body.InitLocals = true; + + // base.SerializeSyncVars(writer, forceAll); + MethodReference baseSerialize = Resolvers.TryResolveMethodInParents(netBehaviourSubclass.BaseType, assembly, SerializeMethodName); + if (baseSerialize != null) + { + // base + worker.Emit(OpCodes.Ldarg_0); + // writer + worker.Emit(OpCodes.Ldarg_1); + // forceAll + worker.Emit(OpCodes.Ldarg_2); + worker.Emit(OpCodes.Call, baseSerialize); + } + + // Generates: + // if (forceAll) + // { + // writer.WriteInt(health); + // ... + // } + Instruction initialStateLabel = worker.Create(OpCodes.Nop); + // forceAll + worker.Emit(OpCodes.Ldarg_2); // load 'forceAll' flag + worker.Emit(OpCodes.Brfalse, initialStateLabel); // start the 'if forceAll' branch + + // generates write.Write(syncVar) for each SyncVar in forceAll case + foreach (FieldDefinition syncVarDef in syncVars) + { + FieldReference syncVar = syncVarDef; + if (netBehaviourSubclass.HasGenericParameters) + { + syncVar = syncVarDef.MakeHostInstanceGeneric(); + } + // Generates a writer call for each sync variable + // writer + worker.Emit(OpCodes.Ldarg_1); + // this + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldfld, syncVar); + MethodReference writeFunc; + // For NBs we always need to use the default NetworkBehaviour write func + // since the reader counter part uses that exact layout which is not easy to change + // without introducing more edge cases + // effectively this disallows custom NB-type writers/readers on SyncVars + // see: https://github.com/MirrorNetworking/Mirror/issues/2680 + if (syncVar.FieldType.IsDerivedFrom()) + { + writeFunc = writers.GetWriteFunc(weaverTypes.Import(), ref WeavingFailed); + } + else + { + writeFunc = writers.GetWriteFunc(syncVar.FieldType, ref WeavingFailed); + } + + if (writeFunc != null) + { + worker.Emit(OpCodes.Call, writeFunc); + } + else + { + Log.Error($"{syncVar.Name} has unsupported type. Use a supported Mirror type instead", syncVar); + WeavingFailed = true; + return; + } + } + + // if (forceAll) then always return at the end of the 'if' case + worker.Emit(OpCodes.Ret); + + // end the 'if' case for "if (forceAll)" + worker.Append(initialStateLabel); + + //////////////////////////////////////////////////////////////////// + + // write dirty bits before the data fields + // Generates: writer.WritePackedUInt64 (base.get_syncVarDirtyBits ()); + // writer + worker.Emit(OpCodes.Ldarg_1); + // base + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldfld, weaverTypes.NetworkBehaviourDirtyBitsReference); + MethodReference writeUint64Func = writers.GetWriteFunc(weaverTypes.Import(), ref WeavingFailed); + worker.Emit(OpCodes.Call, writeUint64Func); + + // generate a writer call for any dirty variable in this class + + // start at number of syncvars in parent + int dirtyBit = syncVarAccessLists.GetSyncVarStart(netBehaviourSubclass.BaseType.FullName); + foreach (FieldDefinition syncVarDef in syncVars) + { + FieldReference syncVar = syncVarDef; + if (netBehaviourSubclass.HasGenericParameters) + { + syncVar = syncVarDef.MakeHostInstanceGeneric(); + } + Instruction varLabel = worker.Create(OpCodes.Nop); + + // Generates: if ((base.get_syncVarDirtyBits() & 1uL) != 0uL) + // base + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldfld, weaverTypes.NetworkBehaviourDirtyBitsReference); + // 8 bytes = long + worker.Emit(OpCodes.Ldc_I8, 1L << dirtyBit); + worker.Emit(OpCodes.And); + worker.Emit(OpCodes.Brfalse, varLabel); + + // Generates a call to the writer for that field + // writer + worker.Emit(OpCodes.Ldarg_1); + // base + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldfld, syncVar); + + MethodReference writeFunc; + // For NBs we always need to use the default NetworkBehaviour write func + // since the reader counter part uses that exact layout which is not easy to change + // without introducing more edge cases + // effectively this disallows custom NB-type writers/readers on SyncVars + // see: https://github.com/MirrorNetworking/Mirror/issues/2680 + if (syncVar.FieldType.IsDerivedFrom()) + { + writeFunc = writers.GetWriteFunc(weaverTypes.Import(), ref WeavingFailed); + } + else + { + writeFunc = writers.GetWriteFunc(syncVar.FieldType, ref WeavingFailed); + } + + if (writeFunc != null) + { + worker.Emit(OpCodes.Call, writeFunc); + } + else + { + Log.Error($"{syncVar.Name} has unsupported type. Use a supported Mirror type instead", syncVar); + WeavingFailed = true; + return; + } + + worker.Append(varLabel); + dirtyBit += 1; + } + + // add a log message if needed for debugging + //worker.Emit(OpCodes.Ldstr, $"Injected Serialize {netBehaviourSubclass.Name}"); + //worker.Emit(OpCodes.Call, WeaverTypes.logErrorReference); + + // generate: return + worker.Emit(OpCodes.Ret); + netBehaviourSubclass.Methods.Add(serialize); + } + + void DeserializeField(FieldDefinition syncVar, ILProcessor worker, ref bool WeavingFailed) + { + // put 'this.' onto stack for 'this.syncvar' below + worker.Append(worker.Create(OpCodes.Ldarg_0)); + + // push 'ref T this.field' + worker.Emit(OpCodes.Ldarg_0); + // if the netbehaviour class is generic, we need to make the field reference generic as well for correct IL + if (netBehaviourSubclass.HasGenericParameters) + { + worker.Emit(OpCodes.Ldflda, syncVar.MakeHostInstanceGeneric()); + } + else + { + worker.Emit(OpCodes.Ldflda, syncVar); + } + + // If a hook exists, then we need to load the hook delegate on the stack + // The hook delegate is created once in the constructor and stored in an instance field + // We load the delegate from this instance field to avoid instantiating a new delegate instance every time (drastically reduces allocations) + if(syncVarHookDelegates.TryGetValue(syncVar, out (FieldDefinition hookDelegateField, MethodDefinition) value)) + { + // A hook exists. Push this.hookDelegateField onto the stack + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldfld, value.hookDelegateField); + } + else + { + // No hook exists. Push 'null' as hook + worker.Emit(OpCodes.Ldnull); + } + + // call GeneratedSyncVarDeserialize. + // special cases for GameObject/NetworkIdentity/NetworkBehaviour + // passing netId too for persistence. + if (syncVar.FieldType.Is()) + { + // reader + worker.Emit(OpCodes.Ldarg_1); + + // GameObject setter needs one more parameter: netId field ref + FieldDefinition netIdField = syncVarNetIds[syncVar]; + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldflda, netIdField); + worker.Emit(OpCodes.Call, weaverTypes.generatedSyncVarDeserialize_GameObject); + } + else if (syncVar.FieldType.Is()) + { + // reader + worker.Emit(OpCodes.Ldarg_1); + + // NetworkIdentity deserialize needs one more parameter: netId field ref + FieldDefinition netIdField = syncVarNetIds[syncVar]; + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldflda, netIdField); + worker.Emit(OpCodes.Call, weaverTypes.generatedSyncVarDeserialize_NetworkIdentity); + } + // handle both NetworkBehaviour and inheritors. + // fixes: https://github.com/MirrorNetworking/Mirror/issues/2939 + else if (syncVar.FieldType.IsDerivedFrom() || syncVar.FieldType.Is()) + { + // reader + worker.Emit(OpCodes.Ldarg_1); + + // NetworkIdentity deserialize needs one more parameter: netId field ref + // (actually its a NetworkBehaviourSyncVar type) + FieldDefinition netIdField = syncVarNetIds[syncVar]; + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldflda, netIdField); + // make generic version of GeneratedSyncVarSetter_NetworkBehaviour + MethodReference getFunc = weaverTypes.generatedSyncVarDeserialize_NetworkBehaviour_T.MakeGeneric(assembly.MainModule, syncVar.FieldType); + worker.Emit(OpCodes.Call, getFunc); + } + else + { + // T value = reader.ReadT(); + // this is still in IL because otherwise weaver generated + // readers/writers don't seem to work in tests. + // besides, this also avoids reader.Read overhead. + MethodReference readFunc = readers.GetReadFunc(syncVar.FieldType, ref WeavingFailed); + if (readFunc == null) + { + Log.Error($"{syncVar.Name} has unsupported type. Use a supported Mirror type instead", syncVar); + WeavingFailed = true; + return; + } + // reader. for 'reader.Read()' below + worker.Emit(OpCodes.Ldarg_1); + // reader.Read() + worker.Emit(OpCodes.Call, readFunc); + + // make generic version of GeneratedSyncVarDeserialize + MethodReference generic = weaverTypes.generatedSyncVarDeserialize.MakeGeneric(assembly.MainModule, syncVar.FieldType); + worker.Emit(OpCodes.Call, generic); + } + } + + void GenerateDeSerialization(ref bool WeavingFailed) + { + const string DeserializeMethodName = "DeserializeSyncVars"; + if (netBehaviourSubclass.GetMethod(DeserializeMethodName) != null) + return; + + if (syncVars.Count == 0) + { + // no synvars, no need for custom OnDeserialize + return; + } + + MethodDefinition serialize = new MethodDefinition(DeserializeMethodName, + MethodAttributes.Public | MethodAttributes.Virtual | MethodAttributes.HideBySig, + weaverTypes.Import(typeof(void))); + + serialize.Parameters.Add(new ParameterDefinition("reader", ParameterAttributes.None, weaverTypes.Import())); + serialize.Parameters.Add(new ParameterDefinition("initialState", ParameterAttributes.None, weaverTypes.Import())); + ILProcessor serWorker = serialize.Body.GetILProcessor(); + // setup local for dirty bits + serialize.Body.InitLocals = true; + VariableDefinition dirtyBitsLocal = new VariableDefinition(weaverTypes.Import()); + serialize.Body.Variables.Add(dirtyBitsLocal); + + MethodReference baseDeserialize = Resolvers.TryResolveMethodInParents(netBehaviourSubclass.BaseType, assembly, DeserializeMethodName); + if (baseDeserialize != null) + { + // base + serWorker.Append(serWorker.Create(OpCodes.Ldarg_0)); + // reader + serWorker.Append(serWorker.Create(OpCodes.Ldarg_1)); + // initialState + serWorker.Append(serWorker.Create(OpCodes.Ldarg_2)); + serWorker.Append(serWorker.Create(OpCodes.Call, baseDeserialize)); + } + + // Generates: if (initialState); + Instruction initialStateLabel = serWorker.Create(OpCodes.Nop); + + serWorker.Append(serWorker.Create(OpCodes.Ldarg_2)); + serWorker.Append(serWorker.Create(OpCodes.Brfalse, initialStateLabel)); + + foreach (FieldDefinition syncVar in syncVars) + { + DeserializeField(syncVar, serWorker, ref WeavingFailed); + } + + serWorker.Append(serWorker.Create(OpCodes.Ret)); + + // Generates: end if (initialState); + serWorker.Append(initialStateLabel); + + // get dirty bits + serWorker.Append(serWorker.Create(OpCodes.Ldarg_1)); + serWorker.Append(serWorker.Create(OpCodes.Call, readers.GetReadFunc(weaverTypes.Import(), ref WeavingFailed))); + serWorker.Append(serWorker.Create(OpCodes.Stloc_0)); + + // conditionally read each syncvar + // start at number of syncvars in parent + int dirtyBit = syncVarAccessLists.GetSyncVarStart(netBehaviourSubclass.BaseType.FullName); + foreach (FieldDefinition syncVar in syncVars) + { + Instruction varLabel = serWorker.Create(OpCodes.Nop); + + // check if dirty bit is set + serWorker.Append(serWorker.Create(OpCodes.Ldloc_0)); + serWorker.Append(serWorker.Create(OpCodes.Ldc_I8, 1L << dirtyBit)); + serWorker.Append(serWorker.Create(OpCodes.And)); + serWorker.Append(serWorker.Create(OpCodes.Brfalse, varLabel)); + + DeserializeField(syncVar, serWorker, ref WeavingFailed); + + serWorker.Append(varLabel); + dirtyBit += 1; + } + + // add a log message if needed for debugging + //serWorker.Append(serWorker.Create(OpCodes.Ldstr, $"Injected Deserialize {netBehaviourSubclass.Name}")); + //serWorker.Append(serWorker.Create(OpCodes.Call, WeaverTypes.logErrorReference)); + + serWorker.Append(serWorker.Create(OpCodes.Ret)); + netBehaviourSubclass.Methods.Add(serialize); + } + + public static bool ReadArguments(MethodDefinition method, Readers readers, Logger Log, ILProcessor worker, RemoteCallType callType, ref bool WeavingFailed) + { + // read each argument + // example result + /* + CallCmdDoSomething(reader.ReadPackedInt32(), reader.ReadNetworkIdentity()); + */ + + bool skipFirst = callType == RemoteCallType.TargetRpc + && TargetRpcProcessor.HasNetworkConnectionParameter(method); + + // arg of calling function, arg 0 is "this" so start counting at 1 + int argNum = 1; + foreach (ParameterDefinition param in method.Parameters) + { + // NetworkConnection is not sent via the NetworkWriter so skip it here + // skip first for NetworkConnection in TargetRpc + if (argNum == 1 && skipFirst) + { + argNum += 1; + continue; + } + // skip SenderConnection in Command + if (IsSenderConnection(param, callType)) + { + argNum += 1; + continue; + } + + + MethodReference readFunc = readers.GetReadFunc(param.ParameterType, ref WeavingFailed); + + if (readFunc == null) + { + Log.Error($"{method.Name} has invalid parameter {param}. Unsupported type {param.ParameterType}, use a supported Mirror type instead", method); + WeavingFailed = true; + return false; + } + + worker.Emit(OpCodes.Ldarg_1); + worker.Emit(OpCodes.Call, readFunc); + + // conversion.. is this needed? + if (param.ParameterType.Is()) + { + worker.Emit(OpCodes.Conv_R4); + } + else if (param.ParameterType.Is()) + { + worker.Emit(OpCodes.Conv_R8); + } + } + return true; + } + + public static void AddInvokeParameters(WeaverTypes weaverTypes, ICollection collection) + { + collection.Add(new ParameterDefinition("obj", ParameterAttributes.None, weaverTypes.Import())); + collection.Add(new ParameterDefinition("reader", ParameterAttributes.None, weaverTypes.Import())); + // senderConnection is only used for commands but NetworkBehaviour.CmdDelegate is used for all remote calls + collection.Add(new ParameterDefinition("senderConnection", ParameterAttributes.None, weaverTypes.Import())); + } + + // check if a Command/TargetRpc/Rpc function & parameters are valid for weaving + public bool ValidateRemoteCallAndParameters(MethodDefinition method, RemoteCallType callType, ref bool WeavingFailed) + { + if (method.IsStatic) + { + Log.Error($"{method.Name} must not be static", method); + WeavingFailed = true; + return false; + } + + return ValidateFunction(method, ref WeavingFailed) && + ValidateParameters(method, callType, ref WeavingFailed); + } + + // check if a Command/TargetRpc/Rpc function is valid for weaving + bool ValidateFunction(MethodReference md, ref bool WeavingFailed) + { + if (md.ReturnType.Is()) + { + Log.Error($"{md.Name} cannot be a coroutine", md); + WeavingFailed = true; + return false; + } + if (!md.ReturnType.Is(typeof(void))) + { + Log.Error($"{md.Name} cannot return a value. Make it void instead", md); + WeavingFailed = true; + return false; + } + if (md.HasGenericParameters) + { + Log.Error($"{md.Name} cannot have generic parameters", md); + WeavingFailed = true; + return false; + } + return true; + } + + // check if all Command/TargetRpc/Rpc function's parameters are valid for weaving + bool ValidateParameters(MethodReference method, RemoteCallType callType, ref bool WeavingFailed) + { + for (int i = 0; i < method.Parameters.Count; ++i) + { + ParameterDefinition param = method.Parameters[i]; + if (!ValidateParameter(method, param, callType, i == 0, ref WeavingFailed)) + { + return false; + } + } + return true; + } + + // validate parameters for a remote function call like Rpc/Cmd + bool ValidateParameter(MethodReference method, ParameterDefinition param, RemoteCallType callType, bool firstParam, ref bool WeavingFailed) + { + // need to check this before any type lookups since those will fail since generic types don't resolve + if (param.ParameterType.IsGenericParameter) + { + Log.Error($"{method.Name} cannot have generic parameters", method); + WeavingFailed = true; + return false; + } + + bool isNetworkConnection = param.ParameterType.Is(); + bool isSenderConnection = IsSenderConnection(param, callType); + + if (param.IsOut) + { + Log.Error($"{method.Name} cannot have out parameters", method); + WeavingFailed = true; + return false; + } + + // if not SenderConnection And not TargetRpc NetworkConnection first param + if (!isSenderConnection && isNetworkConnection && !(callType == RemoteCallType.TargetRpc && firstParam)) + { + if (callType == RemoteCallType.Command) + { + Log.Error($"{method.Name} has invalid parameter {param}, Cannot pass NetworkConnections. Instead use 'NetworkConnectionToClient conn = null' to get the sender's connection on the server", method); + } + else + { + Log.Error($"{method.Name} has invalid parameter {param}. Cannot pass NetworkConnections", method); + } + WeavingFailed = true; + return false; + } + + // sender connection can be optional + if (param.IsOptional && !isSenderConnection) + { + Log.Error($"{method.Name} cannot have optional parameters", method); + WeavingFailed = true; + return false; + } + + return true; + } + + public static bool IsSenderConnection(ParameterDefinition param, RemoteCallType callType) + { + if (callType != RemoteCallType.Command) + { + return false; + } + + TypeReference type = param.ParameterType; + + return type.Is() + || type.Resolve().IsDerivedFrom(); + } + + void ProcessMethods(ref bool WeavingFailed) + { + HashSet names = new HashSet(); + + // copy the list of methods because we will be adding methods in the loop + List methods = new List(netBehaviourSubclass.Methods); + // find command and RPC functions + foreach (MethodDefinition md in methods) + { + foreach (CustomAttribute ca in md.CustomAttributes) + { + if (ca.AttributeType.Is()) + { + ProcessCommand(names, md, ca, ref WeavingFailed); + break; + } + + if (ca.AttributeType.Is()) + { + ProcessTargetRpc(names, md, ca, ref WeavingFailed); + break; + } + + if (ca.AttributeType.Is()) + { + ProcessClientRpc(names, md, ca, ref WeavingFailed); + break; + } + } + } + } + + void ProcessClientRpc(HashSet names, MethodDefinition md, CustomAttribute clientRpcAttr, ref bool WeavingFailed) + { + if (md.IsAbstract) + { + Log.Error("Abstract ClientRpc are currently not supported, use virtual method instead", md); + WeavingFailed = true; + return; + } + + if (!ValidateRemoteCallAndParameters(md, RemoteCallType.ClientRpc, ref WeavingFailed)) + { + return; + } + + bool includeOwner = clientRpcAttr.GetField("includeOwner", true); + + names.Add(md.Name); + clientRpcs.Add(new ClientRpcResult + { + method = md, + includeOwner = includeOwner + }); + + MethodDefinition rpcCallFunc = RpcProcessor.ProcessRpcCall(weaverTypes, writers, Log, netBehaviourSubclass, md, clientRpcAttr, ref WeavingFailed); + // need null check here because ProcessRpcCall returns null if it can't write all the args + if (rpcCallFunc == null) { return; } + + MethodDefinition rpcFunc = RpcProcessor.ProcessRpcInvoke(weaverTypes, writers, readers, Log, netBehaviourSubclass, md, rpcCallFunc, ref WeavingFailed); + if (rpcFunc != null) + { + clientRpcInvocationFuncs.Add(rpcFunc); + } + } + + void ProcessTargetRpc(HashSet names, MethodDefinition md, CustomAttribute targetRpcAttr, ref bool WeavingFailed) + { + if (md.IsAbstract) + { + Log.Error("Abstract TargetRpc are currently not supported, use virtual method instead", md); + WeavingFailed = true; + return; + } + + if (!ValidateRemoteCallAndParameters(md, RemoteCallType.TargetRpc, ref WeavingFailed)) + return; + + names.Add(md.Name); + targetRpcs.Add(md); + + MethodDefinition rpcCallFunc = TargetRpcProcessor.ProcessTargetRpcCall(weaverTypes, writers, Log, netBehaviourSubclass, md, targetRpcAttr, ref WeavingFailed); + + MethodDefinition rpcFunc = TargetRpcProcessor.ProcessTargetRpcInvoke(weaverTypes, readers, Log, netBehaviourSubclass, md, rpcCallFunc, ref WeavingFailed); + if (rpcFunc != null) + { + targetRpcInvocationFuncs.Add(rpcFunc); + } + } + + void ProcessCommand(HashSet names, MethodDefinition md, CustomAttribute commandAttr, ref bool WeavingFailed) + { + if (md.IsAbstract) + { + Log.Error("Abstract Commands are currently not supported, use virtual method instead", md); + WeavingFailed = true; + return; + } + + if (!ValidateRemoteCallAndParameters(md, RemoteCallType.Command, ref WeavingFailed)) + return; + + bool requiresAuthority = commandAttr.GetField("requiresAuthority", true); + + names.Add(md.Name); + commands.Add(new CmdResult + { + method = md, + requiresAuthority = requiresAuthority + }); + + MethodDefinition cmdCallFunc = CommandProcessor.ProcessCommandCall(weaverTypes, writers, Log, netBehaviourSubclass, md, commandAttr, ref WeavingFailed); + + MethodDefinition cmdFunc = CommandProcessor.ProcessCommandInvoke(weaverTypes, readers, Log, netBehaviourSubclass, md, cmdCallFunc, ref WeavingFailed); + if (cmdFunc != null) + { + commandInvocationFuncs.Add(cmdFunc); + } + } + } +} diff --git a/Assets/Mirror/Editor/Weaver/Processors/NetworkBehaviourProcessor.cs.meta b/Assets/Mirror/Editor/Weaver/Processors/NetworkBehaviourProcessor.cs.meta new file mode 100644 index 0000000..67c27dc --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Processors/NetworkBehaviourProcessor.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 8118d606be3214e5d99943ec39530dd8 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Weaver/Processors/ReaderWriterProcessor.cs b/Assets/Mirror/Editor/Weaver/Processors/ReaderWriterProcessor.cs new file mode 100644 index 0000000..280240c --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Processors/ReaderWriterProcessor.cs @@ -0,0 +1,216 @@ +// finds all readers and writers and register them +using System.Linq; +using Mono.CecilX; +using Mono.CecilX.Cil; +using Mono.CecilX.Rocks; +using UnityEngine; + +namespace Mirror.Weaver +{ + public static class ReaderWriterProcessor + { + public static bool Process(AssemblyDefinition CurrentAssembly, IAssemblyResolver resolver, Logger Log, Writers writers, Readers readers, ref bool WeavingFailed) + { + // find NetworkReader/Writer extensions from Mirror.dll first. + // and NetworkMessage custom writer/reader extensions. + // NOTE: do not include this result in our 'modified' return value, + // otherwise Unity crashes when running tests + ProcessMirrorAssemblyClasses(CurrentAssembly, resolver, Log, writers, readers, ref WeavingFailed); + + // find readers/writers in the assembly we are in right now. + return ProcessAssemblyClasses(CurrentAssembly, CurrentAssembly, writers, readers, ref WeavingFailed); + } + + static void ProcessMirrorAssemblyClasses(AssemblyDefinition CurrentAssembly, IAssemblyResolver resolver, Logger Log, Writers writers, Readers readers, ref bool WeavingFailed) + { + // find Mirror.dll in assembly's references. + // those are guaranteed to be resolvable and correct. + // after all, it references them :) + AssemblyNameReference mirrorAssemblyReference = CurrentAssembly.MainModule.FindReference(Weaver.MirrorAssemblyName); + if (mirrorAssemblyReference != null) + { + // resolve the assembly to load the AssemblyDefinition. + // we need to search all types in it. + // if we only were to resolve one known type like in WeaverTypes, + // then we wouldn't need it. + AssemblyDefinition mirrorAssembly = resolver.Resolve(mirrorAssemblyReference); + if (mirrorAssembly != null) + { + ProcessAssemblyClasses(CurrentAssembly, mirrorAssembly, writers, readers, ref WeavingFailed); + } + else Log.Error($"Failed to resolve {mirrorAssemblyReference}"); + } + else Log.Error("Failed to find Mirror AssemblyNameReference. Can't register Mirror.dll readers/writers."); + } + + static bool ProcessAssemblyClasses(AssemblyDefinition CurrentAssembly, AssemblyDefinition assembly, Writers writers, Readers readers, ref bool WeavingFailed) + { + bool modified = false; + foreach (TypeDefinition klass in assembly.MainModule.Types) + { + // extension methods only live in static classes + // static classes are represented as sealed and abstract + if (klass.IsAbstract && klass.IsSealed) + { + // if assembly has any declared writers then it is "modified" + modified |= LoadDeclaredWriters(CurrentAssembly, klass, writers); + modified |= LoadDeclaredReaders(CurrentAssembly, klass, readers); + } + } + + foreach (TypeDefinition klass in assembly.MainModule.Types) + { + // if assembly has any network message then it is modified + modified |= LoadMessageReadWriter(CurrentAssembly.MainModule, writers, readers, klass, ref WeavingFailed); + } + return modified; + } + + static bool LoadMessageReadWriter(ModuleDefinition module, Writers writers, Readers readers, TypeDefinition klass, ref bool WeavingFailed) + { + bool modified = false; + if (!klass.IsAbstract && !klass.IsInterface && klass.ImplementsInterface()) + { + readers.GetReadFunc(module.ImportReference(klass), ref WeavingFailed); + writers.GetWriteFunc(module.ImportReference(klass), ref WeavingFailed); + modified = true; + } + + foreach (TypeDefinition td in klass.NestedTypes) + { + modified |= LoadMessageReadWriter(module, writers, readers, td, ref WeavingFailed); + } + return modified; + } + + static bool LoadDeclaredWriters(AssemblyDefinition currentAssembly, TypeDefinition klass, Writers writers) + { + // register all the writers in this class. Skip the ones with wrong signature + bool modified = false; + foreach (MethodDefinition method in klass.Methods) + { + if (method.Parameters.Count != 2) + continue; + + if (!method.Parameters[0].ParameterType.Is()) + continue; + + if (!method.ReturnType.Is(typeof(void))) + continue; + + if (!method.HasCustomAttribute()) + continue; + + if (method.HasGenericParameters) + continue; + + TypeReference dataType = method.Parameters[1].ParameterType; + writers.Register(dataType, currentAssembly.MainModule.ImportReference(method)); + modified = true; + } + return modified; + } + + static bool LoadDeclaredReaders(AssemblyDefinition currentAssembly, TypeDefinition klass, Readers readers) + { + // register all the reader in this class. Skip the ones with wrong signature + bool modified = false; + foreach (MethodDefinition method in klass.Methods) + { + if (method.Parameters.Count != 1) + continue; + + if (!method.Parameters[0].ParameterType.Is()) + continue; + + if (method.ReturnType.Is(typeof(void))) + continue; + + if (!method.HasCustomAttribute()) + continue; + + if (method.HasGenericParameters) + continue; + + readers.Register(method.ReturnType, currentAssembly.MainModule.ImportReference(method)); + modified = true; + } + return modified; + } + + // helper function to add [RuntimeInitializeOnLoad] attribute to method + static void AddRuntimeInitializeOnLoadAttribute(AssemblyDefinition assembly, WeaverTypes weaverTypes, MethodDefinition method) + { + // NOTE: previously we used reflection because according paul, + // 'weaving Mirror.dll caused unity to rebuild all dlls but in wrong + // order, which breaks rewired' + // it's not obvious why importing an attribute via reflection instead + // of cecil would break anything. let's use cecil. + + // to add a CustomAttribute, we need the attribute's constructor. + // in this case, there are two: empty, and RuntimeInitializeOnLoadType. + // we want the last one, with the type parameter. + MethodDefinition ctor = weaverTypes.runtimeInitializeOnLoadMethodAttribute.GetConstructors().Last(); + //MethodDefinition ctor = weaverTypes.runtimeInitializeOnLoadMethodAttribute.GetConstructors().First(); + // using ctor directly throws: ArgumentException: Member 'System.Void UnityEditor.InitializeOnLoadMethodAttribute::.ctor()' is declared in another module and needs to be imported + // we need to import it first. + CustomAttribute attribute = new CustomAttribute(assembly.MainModule.ImportReference(ctor)); + // add the RuntimeInitializeLoadType.BeforeSceneLoad argument to ctor + attribute.ConstructorArguments.Add(new CustomAttributeArgument(weaverTypes.Import(), RuntimeInitializeLoadType.BeforeSceneLoad)); + method.CustomAttributes.Add(attribute); + } + + // helper function to add [InitializeOnLoad] attribute to method + // (only works in Editor assemblies. check IsEditorAssembly first.) + static void AddInitializeOnLoadAttribute(AssemblyDefinition assembly, WeaverTypes weaverTypes, MethodDefinition method) + { + // NOTE: previously we used reflection because according paul, + // 'weaving Mirror.dll caused unity to rebuild all dlls but in wrong + // order, which breaks rewired' + // it's not obvious why importing an attribute via reflection instead + // of cecil would break anything. let's use cecil. + + // to add a CustomAttribute, we need the attribute's constructor. + // in this case, there's only one - and it's an empty constructor. + MethodDefinition ctor = weaverTypes.initializeOnLoadMethodAttribute.GetConstructors().First(); + // using ctor directly throws: ArgumentException: Member 'System.Void UnityEditor.InitializeOnLoadMethodAttribute::.ctor()' is declared in another module and needs to be imported + // we need to import it first. + CustomAttribute attribute = new CustomAttribute(assembly.MainModule.ImportReference(ctor)); + method.CustomAttributes.Add(attribute); + } + + // adds Mirror.GeneratedNetworkCode.InitReadWriters() method that + // registers all generated writers into Mirror.Writer static class. + // -> uses [RuntimeInitializeOnLoad] attribute so it's invoke at runtime + // -> uses [InitializeOnLoad] if UnityEditor is referenced so it works + // in Editor and in tests too + // + // use ILSpy to see the result (it's in the DLL's 'Mirror' namespace) + public static void InitializeReaderAndWriters(AssemblyDefinition currentAssembly, WeaverTypes weaverTypes, Writers writers, Readers readers, TypeDefinition GeneratedCodeClass) + { + MethodDefinition initReadWriters = new MethodDefinition("InitReadWriters", MethodAttributes.Public | + MethodAttributes.Static, + weaverTypes.Import(typeof(void))); + + // add [RuntimeInitializeOnLoad] in any case + AddRuntimeInitializeOnLoadAttribute(currentAssembly, weaverTypes, initReadWriters); + + // add [InitializeOnLoad] if UnityEditor is referenced + if (Helpers.IsEditorAssembly(currentAssembly)) + { + AddInitializeOnLoadAttribute(currentAssembly, weaverTypes, initReadWriters); + } + + // fill function body with reader/writer initializers + ILProcessor worker = initReadWriters.Body.GetILProcessor(); + // for debugging: add a log to see if initialized on load + //worker.Emit(OpCodes.Ldstr, $"[InitReadWriters] called!"); + //worker.Emit(OpCodes.Call, Weaver.weaverTypes.logWarningReference); + writers.InitializeWriters(worker); + readers.InitializeReaders(worker); + worker.Emit(OpCodes.Ret); + + GeneratedCodeClass.Methods.Add(initReadWriters); + } + } +} diff --git a/Assets/Mirror/Editor/Weaver/Processors/ReaderWriterProcessor.cs.meta b/Assets/Mirror/Editor/Weaver/Processors/ReaderWriterProcessor.cs.meta new file mode 100644 index 0000000..c14d6fa --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Processors/ReaderWriterProcessor.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: f3263602f0a374ecd8d08588b1fc2f76 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Weaver/Processors/RpcProcessor.cs b/Assets/Mirror/Editor/Weaver/Processors/RpcProcessor.cs new file mode 100644 index 0000000..ca2d7b9 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Processors/RpcProcessor.cs @@ -0,0 +1,104 @@ +using Mono.CecilX; +using Mono.CecilX.Cil; + +namespace Mirror.Weaver +{ + // Processes [Rpc] methods in NetworkBehaviour + public static class RpcProcessor + { + public static MethodDefinition ProcessRpcInvoke(WeaverTypes weaverTypes, Writers writers, Readers readers, Logger Log, TypeDefinition td, MethodDefinition md, MethodDefinition rpcCallFunc, ref bool WeavingFailed) + { + string rpcName = Weaver.GenerateMethodName(RemoteCalls.RemoteProcedureCalls.InvokeRpcPrefix, md); + + MethodDefinition rpc = new MethodDefinition(rpcName, MethodAttributes.Family | MethodAttributes.Static | MethodAttributes.HideBySig, + weaverTypes.Import(typeof(void))); + + ILProcessor worker = rpc.Body.GetILProcessor(); + Instruction label = worker.Create(OpCodes.Nop); + + NetworkBehaviourProcessor.WriteClientActiveCheck(worker, weaverTypes, md.Name, label, "RPC"); + + // setup for reader + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Castclass, td); + + if (!NetworkBehaviourProcessor.ReadArguments(md, readers, Log, worker, RemoteCallType.ClientRpc, ref WeavingFailed)) + return null; + + // invoke actual command function + worker.Emit(OpCodes.Callvirt, rpcCallFunc); + worker.Emit(OpCodes.Ret); + + NetworkBehaviourProcessor.AddInvokeParameters(weaverTypes, rpc.Parameters); + td.Methods.Add(rpc); + return rpc; + } + + /* + * generates code like: + + public void RpcTest (int param) + { + NetworkWriter writer = new NetworkWriter (); + writer.WritePackedUInt32((uint)param); + base.SendRPCInternal(typeof(class),"RpcTest", writer, 0); + } + public void CallRpcTest (int param) + { + // whatever the user did before + } + + Originally HLAPI put the send message code inside the Call function + and then proceeded to replace every call to RpcTest with CallRpcTest + + This method moves all the user's code into the "CallRpc" method + and replaces the body of the original method with the send message code. + This way we do not need to modify the code anywhere else, and this works + correctly in dependent assemblies + */ + public static MethodDefinition ProcessRpcCall(WeaverTypes weaverTypes, Writers writers, Logger Log, TypeDefinition td, MethodDefinition md, CustomAttribute clientRpcAttr, ref bool WeavingFailed) + { + MethodDefinition rpc = MethodProcessor.SubstituteMethod(Log, td, md, ref WeavingFailed); + + ILProcessor worker = md.Body.GetILProcessor(); + + NetworkBehaviourProcessor.WriteSetupLocals(worker, weaverTypes); + + // add a log message if needed for debugging + //worker.Emit(OpCodes.Ldstr, $"Call ClientRpc function {md.Name}"); + //worker.Emit(OpCodes.Call, WeaverTypes.logErrorReference); + + NetworkBehaviourProcessor.WriteGetWriter(worker, weaverTypes); + + // write all the arguments that the user passed to the Rpc call + if (!NetworkBehaviourProcessor.WriteArguments(worker, writers, Log, md, RemoteCallType.ClientRpc, ref WeavingFailed)) + return null; + + int channel = clientRpcAttr.GetField("channel", 0); + bool includeOwner = clientRpcAttr.GetField("includeOwner", true); + + // invoke SendInternal and return + // this + worker.Emit(OpCodes.Ldarg_0); + // pass full function name to avoid ClassA.Func <-> ClassB.Func collisions + worker.Emit(OpCodes.Ldstr, md.FullName); + // pass the function hash so we don't have to compute it at runtime + // otherwise each GetStableHash call requires O(N) complexity. + // noticeable for long function names: + // https://github.com/MirrorNetworking/Mirror/issues/3375 + worker.Emit(OpCodes.Ldc_I4, md.FullName.GetStableHashCode()); + // writer + worker.Emit(OpCodes.Ldloc_0); + worker.Emit(OpCodes.Ldc_I4, channel); + // includeOwner ? 1 : 0 + worker.Emit(includeOwner ? OpCodes.Ldc_I4_1 : OpCodes.Ldc_I4_0); + worker.Emit(OpCodes.Callvirt, weaverTypes.sendRpcInternal); + + NetworkBehaviourProcessor.WriteReturnWriter(worker, weaverTypes); + + worker.Emit(OpCodes.Ret); + + return rpc; + } + } +} diff --git a/Assets/Mirror/Editor/Weaver/Processors/RpcProcessor.cs.meta b/Assets/Mirror/Editor/Weaver/Processors/RpcProcessor.cs.meta new file mode 100644 index 0000000..22375ba --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Processors/RpcProcessor.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: a3cb7051ff41947e59bba58bdd2b73fc +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Weaver/Processors/ServerClientAttributeProcessor.cs b/Assets/Mirror/Editor/Weaver/Processors/ServerClientAttributeProcessor.cs new file mode 100644 index 0000000..a0b7739 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Processors/ServerClientAttributeProcessor.cs @@ -0,0 +1,163 @@ +// Injects server/client active checks for [Server/Client] attributes +using Mono.CecilX; +using Mono.CecilX.Cil; + +namespace Mirror.Weaver +{ + static class ServerClientAttributeProcessor + { + public static bool Process(WeaverTypes weaverTypes, Logger Log, TypeDefinition td, ref bool WeavingFailed) + { + bool modified = false; + foreach (MethodDefinition md in td.Methods) + { + modified |= ProcessSiteMethod(weaverTypes, Log, md, ref WeavingFailed); + } + + foreach (TypeDefinition nested in td.NestedTypes) + { + modified |= Process(weaverTypes, Log, nested, ref WeavingFailed); + } + return modified; + } + + static bool ProcessSiteMethod(WeaverTypes weaverTypes, Logger Log, MethodDefinition md, ref bool WeavingFailed) + { + if (md.Name == ".cctor" || + md.Name == NetworkBehaviourProcessor.ProcessedFunctionName || + md.Name.StartsWith(RemoteCalls.RemoteProcedureCalls.InvokeRpcPrefix)) + return false; + + if (md.IsAbstract) + { + if (HasServerClientAttribute(md)) + { + Log.Error("Server or Client Attributes can't be added to abstract method. Server and Client Attributes are not inherited so they need to be applied to the override methods instead.", md); + WeavingFailed = true; + } + return false; + } + + if (md.Body != null && md.Body.Instructions != null) + { + return ProcessMethodAttributes(weaverTypes, md); + } + return false; + } + + public static bool HasServerClientAttribute(MethodDefinition md) + { + foreach (CustomAttribute attr in md.CustomAttributes) + { + switch (attr.Constructor.DeclaringType.ToString()) + { + case "Mirror.ServerAttribute": + case "Mirror.ServerCallbackAttribute": + case "Mirror.ClientAttribute": + case "Mirror.ClientCallbackAttribute": + return true; + default: + break; + } + } + return false; + } + + public static bool ProcessMethodAttributes(WeaverTypes weaverTypes, MethodDefinition md) + { + if (md.HasCustomAttribute()) + InjectServerGuard(weaverTypes, md, true); + else if (md.HasCustomAttribute()) + InjectServerGuard(weaverTypes, md, false); + else if (md.HasCustomAttribute()) + InjectClientGuard(weaverTypes, md, true); + else if (md.HasCustomAttribute()) + InjectClientGuard(weaverTypes, md, false); + else + return false; + + return true; + } + + static void InjectServerGuard(WeaverTypes weaverTypes, MethodDefinition md, bool logWarning) + { + ILProcessor worker = md.Body.GetILProcessor(); + Instruction top = md.Body.Instructions[0]; + + worker.InsertBefore(top, worker.Create(OpCodes.Call, weaverTypes.NetworkServerGetActive)); + worker.InsertBefore(top, worker.Create(OpCodes.Brtrue, top)); + if (logWarning) + { + worker.InsertBefore(top, worker.Create(OpCodes.Ldstr, $"[Server] function '{md.FullName}' called when server was not active")); + worker.InsertBefore(top, worker.Create(OpCodes.Call, weaverTypes.logWarningReference)); + } + InjectGuardParameters(md, worker, top); + InjectGuardReturnValue(md, worker, top); + worker.InsertBefore(top, worker.Create(OpCodes.Ret)); + } + + static void InjectClientGuard(WeaverTypes weaverTypes, MethodDefinition md, bool logWarning) + { + ILProcessor worker = md.Body.GetILProcessor(); + Instruction top = md.Body.Instructions[0]; + + worker.InsertBefore(top, worker.Create(OpCodes.Call, weaverTypes.NetworkClientGetActive)); + worker.InsertBefore(top, worker.Create(OpCodes.Brtrue, top)); + if (logWarning) + { + worker.InsertBefore(top, worker.Create(OpCodes.Ldstr, $"[Client] function '{md.FullName}' called when client was not active")); + worker.InsertBefore(top, worker.Create(OpCodes.Call, weaverTypes.logWarningReference)); + } + + InjectGuardParameters(md, worker, top); + InjectGuardReturnValue(md, worker, top); + worker.InsertBefore(top, worker.Create(OpCodes.Ret)); + } + + // this is required to early-out from a function with "ref" or "out" parameters + static void InjectGuardParameters(MethodDefinition md, ILProcessor worker, Instruction top) + { + int offset = md.Resolve().IsStatic ? 0 : 1; + for (int index = 0; index < md.Parameters.Count; index++) + { + ParameterDefinition param = md.Parameters[index]; + if (param.IsOut) + { + // this causes IL2CPP build issues with generic out parameters: + // https://github.com/MirrorNetworking/Mirror/issues/3482 + // TypeReference elementType = param.ParameterType.GetElementType(); + // + // instead we need to use ElementType not GetElementType() + // GetElementType() will get the element type of the inner elementType + // which will return wrong type for arrays and generic + // credit: JamesFrowen + ByReferenceType byRefType = (ByReferenceType)param.ParameterType; + TypeReference elementType = byRefType.ElementType; + + md.Body.Variables.Add(new VariableDefinition(elementType)); + md.Body.InitLocals = true; + + worker.InsertBefore(top, worker.Create(OpCodes.Ldarg, index + offset)); + worker.InsertBefore(top, worker.Create(OpCodes.Ldloca_S, (byte)(md.Body.Variables.Count - 1))); + worker.InsertBefore(top, worker.Create(OpCodes.Initobj, elementType)); + worker.InsertBefore(top, worker.Create(OpCodes.Ldloc, md.Body.Variables.Count - 1)); + worker.InsertBefore(top, worker.Create(OpCodes.Stobj, elementType)); + } + } + } + + // this is required to early-out from a function with a return value. + static void InjectGuardReturnValue(MethodDefinition md, ILProcessor worker, Instruction top) + { + if (!md.ReturnType.Is(typeof(void))) + { + md.Body.Variables.Add(new VariableDefinition(md.ReturnType)); + md.Body.InitLocals = true; + + worker.InsertBefore(top, worker.Create(OpCodes.Ldloca_S, (byte)(md.Body.Variables.Count - 1))); + worker.InsertBefore(top, worker.Create(OpCodes.Initobj, md.ReturnType)); + worker.InsertBefore(top, worker.Create(OpCodes.Ldloc, md.Body.Variables.Count - 1)); + } + } + } +} diff --git a/Assets/Mirror/Editor/Weaver/Processors/ServerClientAttributeProcessor.cs.meta b/Assets/Mirror/Editor/Weaver/Processors/ServerClientAttributeProcessor.cs.meta new file mode 100644 index 0000000..5a5451d --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Processors/ServerClientAttributeProcessor.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 024f251bf693bb345b90b9177892d534 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Weaver/Processors/SyncObjectInitializer.cs b/Assets/Mirror/Editor/Weaver/Processors/SyncObjectInitializer.cs new file mode 100644 index 0000000..a174403 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Processors/SyncObjectInitializer.cs @@ -0,0 +1,39 @@ +using Mono.CecilX; +using Mono.CecilX.Cil; + +namespace Mirror.Weaver +{ + public static class SyncObjectInitializer + { + // generates code like: + // this.InitSyncObject(m_sizes); + public static void GenerateSyncObjectInitializer(ILProcessor worker, WeaverTypes weaverTypes, FieldDefinition fd) + { + // register syncobject in network behaviour + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldfld, fd); + worker.Emit(OpCodes.Call, weaverTypes.InitSyncObjectReference); + } + + public static bool ImplementsSyncObject(TypeReference typeRef) + { + try + { + // value types cant inherit from SyncObject + if (typeRef.IsValueType) + { + return false; + } + + return typeRef.Resolve().IsDerivedFrom(); + } + catch + { + // sometimes this will fail if we reference a weird library that can't be resolved, so we just swallow that exception and return false + } + + return false; + } + } +} diff --git a/Assets/Mirror/Editor/Weaver/Processors/SyncObjectInitializer.cs.meta b/Assets/Mirror/Editor/Weaver/Processors/SyncObjectInitializer.cs.meta new file mode 100644 index 0000000..22f976e --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Processors/SyncObjectInitializer.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: d02219b00b3674e59a2151f41e791688 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Weaver/Processors/SyncObjectProcessor.cs b/Assets/Mirror/Editor/Weaver/Processors/SyncObjectProcessor.cs new file mode 100644 index 0000000..8143e86 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Processors/SyncObjectProcessor.cs @@ -0,0 +1,90 @@ +using System.Collections.Generic; +using Mono.CecilX; + +namespace Mirror.Weaver +{ + public static class SyncObjectProcessor + { + // ulong = 64 bytes + const int SyncObjectsLimit = 64; + + // Finds SyncObjects fields in a type + // Type should be a NetworkBehaviour + public static List FindSyncObjectsFields(Writers writers, Readers readers, Logger Log, TypeDefinition td, ref bool WeavingFailed) + { + List syncObjects = new List(); + + foreach (FieldDefinition fd in td.Fields) + { + if (fd.FieldType.IsGenericParameter || fd.ContainsGenericParameter) + { + // can't call .Resolve on generic ones + continue; + } + + if (fd.FieldType.Resolve().IsDerivedFrom()) + { + if (fd.IsStatic) + { + Log.Error($"{fd.Name} cannot be static", fd); + WeavingFailed = true; + continue; + } + + // SyncObjects always needs to be readonly to guarantee. + // Weaver calls InitSyncObject on them for dirty bits etc. + // Reassigning at runtime would cause undefined behaviour. + // (C# 'readonly' is called 'initonly' in IL code.) + // + // NOTE: instead of forcing readonly, we could also scan all + // instructions for SyncObject assignments. this would + // make unit tests very difficult though. + if (!fd.IsInitOnly) + { + // just a warning for now. + // many people might still use non-readonly SyncObjects. + Log.Warning($"{fd.Name} should have a 'readonly' keyword in front of the variable because {typeof(SyncObject)}s always need to be initialized by the Weaver.", fd); + + // only log, but keep weaving. no need to break projects. + //WeavingFailed = true; + } + + GenerateReadersAndWriters(writers, readers, fd.FieldType, ref WeavingFailed); + + syncObjects.Add(fd); + } + } + + // SyncObjects dirty mask is 64 bit. can't sync more than 64. + if (syncObjects.Count > 64) + { + Log.Error($"{td.Name} has > {SyncObjectsLimit} SyncObjects (SyncLists etc). Consider refactoring your class into multiple components", td); + WeavingFailed = true; + } + + + return syncObjects; + } + + // Generates serialization methods for synclists + static void GenerateReadersAndWriters(Writers writers, Readers readers, TypeReference tr, ref bool WeavingFailed) + { + if (tr is GenericInstanceType genericInstance) + { + foreach (TypeReference argument in genericInstance.GenericArguments) + { + if (!argument.IsGenericParameter) + { + readers.GetReadFunc(argument, ref WeavingFailed); + writers.GetWriteFunc(argument, ref WeavingFailed); + } + } + } + + if (tr != null) + { + GenerateReadersAndWriters(writers, readers, tr.Resolve().BaseType, ref WeavingFailed); + } + } + } +} diff --git a/Assets/Mirror/Editor/Weaver/Processors/SyncObjectProcessor.cs.meta b/Assets/Mirror/Editor/Weaver/Processors/SyncObjectProcessor.cs.meta new file mode 100644 index 0000000..0efe434 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Processors/SyncObjectProcessor.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 78f71efc83cde4917b7d21efa90bcc9a +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Weaver/Processors/SyncVarAttributeAccessReplacer.cs b/Assets/Mirror/Editor/Weaver/Processors/SyncVarAttributeAccessReplacer.cs new file mode 100644 index 0000000..73a9526 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Processors/SyncVarAttributeAccessReplacer.cs @@ -0,0 +1,206 @@ +// [SyncVar] int health; +// is replaced with: +// public int Networkhealth { get; set; } properties. +// this class processes all access to 'health' and replaces it with 'Networkhealth' +using System; +using Mono.CecilX; +using Mono.CecilX.Cil; + +namespace Mirror.Weaver +{ + public static class SyncVarAttributeAccessReplacer + { + // process the module + public static void Process(Logger Log, ModuleDefinition moduleDef, SyncVarAccessLists syncVarAccessLists) + { + DateTime startTime = DateTime.Now; + + // process all classes in this module + foreach (TypeDefinition td in moduleDef.Types) + { + if (td.IsClass) + { + ProcessClass(Log, syncVarAccessLists, td); + } + } + + Console.WriteLine($" ProcessSitesModule {moduleDef.Name} elapsed time:{(DateTime.Now - startTime)}"); + } + + static void ProcessClass(Logger Log, SyncVarAccessLists syncVarAccessLists, TypeDefinition td) + { + //Console.WriteLine($" ProcessClass {td}"); + + // process all methods in this class + foreach (MethodDefinition md in td.Methods) + { + ProcessMethod(Log, syncVarAccessLists, md); + } + + // processes all nested classes in this class recursively + foreach (TypeDefinition nested in td.NestedTypes) + { + ProcessClass(Log, syncVarAccessLists, nested); + } + } + + static void ProcessMethod(Logger Log, SyncVarAccessLists syncVarAccessLists, MethodDefinition md) + { + // process all references to replaced members with properties + //Log.Warning($" ProcessSiteMethod {md}"); + + // skip static constructor, "MirrorProcessed", "InvokeUserCode_" + if (md.Name == ".cctor" || + md.Name == NetworkBehaviourProcessor.ProcessedFunctionName || + md.Name.StartsWith(RemoteCalls.RemoteProcedureCalls.InvokeRpcPrefix)) + return; + + // skip abstract + if (md.IsAbstract) + { + return; + } + + // go through all instructions of this method + if (md.Body != null && md.Body.Instructions != null) + { + for (int i = 0; i < md.Body.Instructions.Count;) + { + Instruction instr = md.Body.Instructions[i]; + i += ProcessInstruction(Log, syncVarAccessLists, md, instr, i); + } + } + } + + static int ProcessInstruction(Logger Log, SyncVarAccessLists syncVarAccessLists, MethodDefinition md, Instruction instr, int iCount) + { + // stfld (sets value of a field)? + if (instr.OpCode == OpCodes.Stfld) + { + // operand is a FieldDefinition in the same assembly? + if (instr.Operand is FieldDefinition opFieldst) + { + ProcessSetInstruction(syncVarAccessLists, md, instr, opFieldst); + } + // operand is a FieldReference in another assembly? + // this is not supported just yet. + // compilation error is better than silently failing SyncVar serialization at runtime. + // https://github.com/MirrorNetworking/Mirror/issues/3525 + else if (instr.Operand is FieldReference opFieldstRef) + { + // resolve it from the other assembly + FieldDefinition field = opFieldstRef.Resolve(); + + // [SyncVar]? + if (field.HasCustomAttribute()) + { + // ILPostProcessor would need to Process() the assembly's + // references before processing this one. + // we can not control the order. + // instead, Log an error to suggest adding a SetSyncVar(value) function. + // this is a very easy solution for a very rare edge case. + Log.Error($"'[SyncVar] {opFieldstRef.DeclaringType.Name}.{opFieldstRef.Name}' in '{field.Module.Name}' is modified by '{md.FullName}' in '{md.Module.Name}'. Modifying a [SyncVar] from another assembly is not supported. Please add a: 'public void Set{opFieldstRef.Name}(value) {{ this.{opFieldstRef.Name} = value; }}' method in '{opFieldstRef.DeclaringType.Name}' and call this function from '{md.FullName}' instead."); + } + } + } + + // ldfld (load value of a field)? + if (instr.OpCode == OpCodes.Ldfld) + { + // operand is a FieldDefinition in the same assembly? + if (instr.Operand is FieldDefinition opFieldld) + { + // this instruction gets the value of a field. cache the field reference. + ProcessGetInstruction(syncVarAccessLists, md, instr, opFieldld); + } + } + + // ldflda (load field address aka reference) + if (instr.OpCode == OpCodes.Ldflda) + { + // operand is a FieldDefinition in the same assembly? + if (instr.Operand is FieldDefinition opFieldlda) + { + // watch out for initobj instruction + // see https://github.com/vis2k/Mirror/issues/696 + return ProcessLoadAddressInstruction(syncVarAccessLists, md, instr, opFieldlda, iCount); + } + } + + // we processed one instruction (instr) + return 1; + } + + // replaces syncvar write access with the NetworkXYZ.set property calls + static void ProcessSetInstruction(SyncVarAccessLists syncVarAccessLists, MethodDefinition md, Instruction i, FieldDefinition opField) + { + // don't replace property call sites in constructors + if (md.Name == ".ctor") + return; + + // does it set a field that we replaced? + if (syncVarAccessLists.replacementSetterProperties.TryGetValue(opField, out MethodDefinition replacement)) + { + //replace with property + //Log.Warning($" replacing {md.Name}:{i}", opField); + i.OpCode = OpCodes.Call; + i.Operand = replacement; + //Log.Warning($" replaced {md.Name}:{i}", opField); + } + } + + // replaces syncvar read access with the NetworkXYZ.get property calls + static void ProcessGetInstruction(SyncVarAccessLists syncVarAccessLists, MethodDefinition md, Instruction i, FieldDefinition opField) + { + // don't replace property call sites in constructors + if (md.Name == ".ctor") + return; + + // does it set a field that we replaced? + if (syncVarAccessLists.replacementGetterProperties.TryGetValue(opField, out MethodDefinition replacement)) + { + //replace with property + //Log.Warning($" replacing {md.Name}:{i}"); + i.OpCode = OpCodes.Call; + i.Operand = replacement; + //Log.Warning($" replaced {md.Name}:{i}"); + } + } + + static int ProcessLoadAddressInstruction(SyncVarAccessLists syncVarAccessLists, MethodDefinition md, Instruction instr, FieldDefinition opField, int iCount) + { + // don't replace property call sites in constructors + if (md.Name == ".ctor") + return 1; + + // does it set a field that we replaced? + if (syncVarAccessLists.replacementSetterProperties.TryGetValue(opField, out MethodDefinition replacement)) + { + // we have a replacement for this property + // is the next instruction a initobj? + Instruction nextInstr = md.Body.Instructions[iCount + 1]; + + if (nextInstr.OpCode == OpCodes.Initobj) + { + // we need to replace this code with: + // var tmp = new MyStruct(); + // this.set_Networkxxxx(tmp); + ILProcessor worker = md.Body.GetILProcessor(); + VariableDefinition tmpVariable = new VariableDefinition(opField.FieldType); + md.Body.Variables.Add(tmpVariable); + + worker.InsertBefore(instr, worker.Create(OpCodes.Ldloca, tmpVariable)); + worker.InsertBefore(instr, worker.Create(OpCodes.Initobj, opField.FieldType)); + worker.InsertBefore(instr, worker.Create(OpCodes.Ldloc, tmpVariable)); + worker.InsertBefore(instr, worker.Create(OpCodes.Call, replacement)); + + worker.Remove(instr); + worker.Remove(nextInstr); + return 4; + } + } + + return 1; + } + } +} diff --git a/Assets/Mirror/Editor/Weaver/Processors/SyncVarAttributeAccessReplacer.cs.meta b/Assets/Mirror/Editor/Weaver/Processors/SyncVarAttributeAccessReplacer.cs.meta new file mode 100644 index 0000000..e8c2500 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Processors/SyncVarAttributeAccessReplacer.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: d48f1ab125e9940a995603796bccc59e +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Weaver/Processors/SyncVarAttributeProcessor.cs b/Assets/Mirror/Editor/Weaver/Processors/SyncVarAttributeProcessor.cs new file mode 100644 index 0000000..76e3ac7 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Processors/SyncVarAttributeProcessor.cs @@ -0,0 +1,515 @@ +using System; +using System.Collections.Generic; +using System.Linq; +using Mono.CecilX; +using Mono.CecilX.Cil; +using Mono.CecilX.Rocks; + +namespace Mirror.Weaver +{ + // Processes [SyncVar] attribute fields in NetworkBehaviour + // not static, because ILPostProcessor is multithreaded + public class SyncVarAttributeProcessor + { + // ulong = 64 bytes + const int SyncVarLimit = 64; + + AssemblyDefinition assembly; + WeaverTypes weaverTypes; + SyncVarAccessLists syncVarAccessLists; + Logger Log; + + string HookParameterMessage(string hookName, TypeReference ValueType) => + $"void {hookName}({ValueType} oldValue, {ValueType} newValue)"; + + public SyncVarAttributeProcessor(AssemblyDefinition assembly, WeaverTypes weaverTypes, SyncVarAccessLists syncVarAccessLists, Logger Log) + { + this.assembly = assembly; + this.weaverTypes = weaverTypes; + this.syncVarAccessLists = syncVarAccessLists; + this.Log = Log; + } + + // Get hook method if any + public MethodDefinition GetHookMethod(TypeDefinition td, FieldDefinition syncVar, ref bool WeavingFailed) + { + CustomAttribute syncVarAttr = syncVar.GetCustomAttribute(); + + if (syncVarAttr == null) + return null; + + string hookFunctionName = syncVarAttr.GetField("hook", null); + + if (hookFunctionName == null) + return null; + + return FindHookMethod(td, syncVar, hookFunctionName, ref WeavingFailed); + } + + // Create a field definition for a field that will store the Action delegate instance for the syncvar hook method (only instantiate delegate once) + public FieldDefinition CreateNewActionFieldDefinitionFromHookMethod(FieldDefinition syncVarField) + { + TypeReference actionRef = assembly.MainModule.ImportReference(typeof(Action<,>)); + GenericInstanceType syncVarHookActionDelegateType = actionRef.MakeGenericInstanceType(syncVarField.FieldType, syncVarField.FieldType); + string syncVarHookDelegateFieldName = $"_Mirror_SyncVarHookDelegate_{syncVarField.Name}"; + return new FieldDefinition(syncVarHookDelegateFieldName, FieldAttributes.Public, syncVarHookActionDelegateType); + } + + // push hook from GetHookMethod() onto the stack as a new Action. + // allows for reuse without handling static/virtual cases every time. + // perf warning: it is recommended to use this method only when generating IL to create a new Action() in order to store it into a field + // avoid using this to emit IL to instantiate a new action instance every single time one is needed for the same method + public void GenerateNewActionFromHookMethod(FieldDefinition syncVar, ILProcessor worker, MethodDefinition hookMethod) + { + // IL_000a: ldarg.0 + // IL_000b: ldftn instance void Mirror.Examples.Tanks.Tank::ExampleHook(int32, int32) + // IL_0011: newobj instance void class [netstandard]System.Action`2::.ctor(object, native int) + + // we support static hooks and instance hooks. + if (hookMethod.IsStatic) + { + // for static hooks, we need to push 'null' first. + // we can't just push nothing. + // stack would get out of balance because we already pushed + // other stuff above. + worker.Emit(OpCodes.Ldnull); + } + else + { + // for instance hooks, we need to push 'this.' first. + worker.Emit(OpCodes.Ldarg_0); + } + + MethodReference hookMethodReference; + // if the network behaviour class is generic, we need to make the method reference generic for correct IL + if (hookMethod.DeclaringType.HasGenericParameters) + { + hookMethodReference = hookMethod.MakeHostInstanceGeneric(hookMethod.Module, hookMethod.DeclaringType.MakeGenericInstanceType(hookMethod.DeclaringType.GenericParameters.ToArray())); + } + else + { + hookMethodReference = hookMethod; + } + + // we support regular and virtual hook functions. + if (hookMethod.IsVirtual) + { + // for virtual / overwritten hooks, we need different IL. + // this is from simply testing Action = VirtualHook; in C#. + worker.Emit(OpCodes.Dup); + worker.Emit(OpCodes.Ldvirtftn, hookMethodReference); + } + else + { + worker.Emit(OpCodes.Ldftn, hookMethodReference); + } + + // call 'new Action()' constructor to convert the function to an action + // we need to make an instance of the generic Action. + TypeReference actionRef = assembly.MainModule.ImportReference(typeof(Action<,>)); + GenericInstanceType genericInstance = actionRef.MakeGenericInstanceType(syncVar.FieldType, syncVar.FieldType); + worker.Emit(OpCodes.Newobj, weaverTypes.ActionT_T.MakeHostInstanceGeneric(assembly.MainModule, genericInstance)); + } + + // generates CIL to set an Action instance field to a new Action(hookMethod) + // this.hookDelegate = new Action(HookMethod); + public void GenerateSyncVarHookDelegateInitializer(ILProcessor worker, FieldDefinition syncVar, FieldDefinition hookDelegate, MethodDefinition hookMethod) + { + // push this + worker.Emit(OpCodes.Ldarg_0); + // push new Action(hookMethod) + GenerateNewActionFromHookMethod(syncVar, worker, hookMethod); + // set field + worker.Emit(OpCodes.Stfld, hookDelegate); + } + + MethodDefinition FindHookMethod(TypeDefinition td, FieldDefinition syncVar, string hookFunctionName, ref bool WeavingFailed) + { + List methods = td.GetMethods(hookFunctionName); + + List methodsWith2Param = new List(methods.Where(m => m.Parameters.Count == 2)); + + if (methodsWith2Param.Count == 0) + { + Log.Error($"Could not find hook for '{syncVar.Name}', hook name '{hookFunctionName}'. " + + $"Method signature should be {HookParameterMessage(hookFunctionName, syncVar.FieldType)}", + syncVar); + WeavingFailed = true; + + return null; + } + + foreach (MethodDefinition method in methodsWith2Param) + { + if (MatchesParameters(syncVar, method)) + { + return method; + } + } + + Log.Error($"Wrong type for Parameter in hook for '{syncVar.Name}', hook name '{hookFunctionName}'. " + + $"Method signature should be {HookParameterMessage(hookFunctionName, syncVar.FieldType)}", + syncVar); + WeavingFailed = true; + + return null; + } + + bool MatchesParameters(FieldDefinition syncVar, MethodDefinition method) + { + // matches void onValueChange(T oldValue, T newValue) + return method.Parameters[0].ParameterType.FullName == syncVar.FieldType.FullName && + method.Parameters[1].ParameterType.FullName == syncVar.FieldType.FullName; + } + + public MethodDefinition GenerateSyncVarGetter(FieldDefinition fd, string originalName, FieldDefinition netFieldId) + { + //Create the get method + MethodDefinition get = new MethodDefinition( + $"get_Network{originalName}", MethodAttributes.Public | + MethodAttributes.SpecialName | + MethodAttributes.HideBySig, + fd.FieldType); + + ILProcessor worker = get.Body.GetILProcessor(); + + FieldReference fr; + if (fd.DeclaringType.HasGenericParameters) + { + fr = fd.MakeHostInstanceGeneric(); + } + else + { + fr = fd; + } + + FieldReference netIdFieldReference = null; + if (netFieldId != null) + { + if (netFieldId.DeclaringType.HasGenericParameters) + { + netIdFieldReference = netFieldId.MakeHostInstanceGeneric(); + } + else + { + netIdFieldReference = netFieldId; + } + } + + // [SyncVar] GameObject? + if (fd.FieldType.Is()) + { + // return this.GetSyncVarGameObject(ref field, uint netId); + // this. + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldfld, netIdFieldReference); + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldflda, fr); + worker.Emit(OpCodes.Call, weaverTypes.getSyncVarGameObjectReference); + worker.Emit(OpCodes.Ret); + } + // [SyncVar] NetworkIdentity? + else if (fd.FieldType.Is()) + { + // return this.GetSyncVarNetworkIdentity(ref field, uint netId); + // this. + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldfld, netIdFieldReference); + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldflda, fr); + worker.Emit(OpCodes.Call, weaverTypes.getSyncVarNetworkIdentityReference); + worker.Emit(OpCodes.Ret); + } + // handle both NetworkBehaviour and inheritors. + // fixes: https://github.com/MirrorNetworking/Mirror/issues/2939 + else if (fd.FieldType.IsDerivedFrom() || fd.FieldType.Is()) + { + // return this.GetSyncVarNetworkBehaviour(ref field, uint netId); + // this. + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldfld, netIdFieldReference); + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldflda, fr); + MethodReference getFunc = weaverTypes.getSyncVarNetworkBehaviourReference.MakeGeneric(assembly.MainModule, fd.FieldType); + worker.Emit(OpCodes.Call, getFunc); + worker.Emit(OpCodes.Ret); + } + // [SyncVar] int, string, etc. + else + { + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldfld, fr); + worker.Emit(OpCodes.Ret); + } + + get.Body.Variables.Add(new VariableDefinition(fd.FieldType)); + get.Body.InitLocals = true; + get.SemanticsAttributes = MethodSemanticsAttributes.Getter; + + return get; + } + + // for [SyncVar] health, weaver generates + // + // NetworkHealth + // { + // get => health; + // set => GeneratedSyncVarSetter(...) + // } + // + // the setter used to be manually IL generated, but we moved it to C# :) + public MethodDefinition GenerateSyncVarSetter(TypeDefinition td, FieldDefinition fd, string originalName, long dirtyBit, FieldDefinition netFieldId, Dictionary syncVarHookDelegates, ref bool WeavingFailed) + { + //Create the set method + MethodDefinition set = new MethodDefinition($"set_Network{originalName}", MethodAttributes.Public | + MethodAttributes.SpecialName | + MethodAttributes.HideBySig, + weaverTypes.Import(typeof(void))); + + ILProcessor worker = set.Body.GetILProcessor(); + FieldReference fr; + if (fd.DeclaringType.HasGenericParameters) + { + fr = fd.MakeHostInstanceGeneric(); + } + else + { + fr = fd; + } + + FieldReference netIdFieldReference = null; + if (netFieldId != null) + { + if (netFieldId.DeclaringType.HasGenericParameters) + { + netIdFieldReference = netFieldId.MakeHostInstanceGeneric(); + } + else + { + netIdFieldReference = netFieldId; + } + } + + // if (!SyncVarEqual(value, ref playerData)) + Instruction endOfMethod = worker.Create(OpCodes.Nop); + + // NOTE: SyncVar...Equal functions are static. + // don't Emit Ldarg_0 aka 'this'. + + // call WeaverSyncVarSetter(T value, ref T field, ulong dirtyBit, Action OnChanged = null) + // IL_0000: ldarg.0 + // IL_0001: ldarg.1 + // IL_0002: ldarg.0 + // IL_0003: ldflda int32 Mirror.Examples.Tanks.Tank::health + // IL_0008: ldc.i4.1 + // IL_0009: conv.i8 + // IL_000a: ldnull + // IL_000b: call instance void [Mirror]Mirror.NetworkBehaviour::GeneratedSyncVarSetter(!!0, !!0&, uint64, class [netstandard]System.Action`2) + // IL_0010: ret + + // 'this.' for the call + worker.Emit(OpCodes.Ldarg_0); + + // first push 'value' + worker.Emit(OpCodes.Ldarg_1); + + // push 'ref T this.field' + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldflda, fr); + + // push the dirty bit for this SyncVar + worker.Emit(OpCodes.Ldc_I8, dirtyBit); + + // hook? then push 'this.HookDelegate' onto stack + MethodDefinition hookMethod = GetHookMethod(td, fd, ref WeavingFailed); + if (hookMethod != null) + { + // Create the field that will store a single instance of the hook as a delegate (field will be set in constructor) + FieldDefinition hookActionDelegateField = CreateNewActionFieldDefinitionFromHookMethod(fd); + syncVarHookDelegates[fd] = (hookActionDelegateField, hookMethod); + + // push this.hookActionDelegateField + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldfld, hookActionDelegateField); + } + // otherwise push 'null' as hook + else + { + worker.Emit(OpCodes.Ldnull); + } + + // call GeneratedSyncVarSetter. + // special cases for GameObject/NetworkIdentity/NetworkBehaviour + // passing netId too for persistence. + if (fd.FieldType.Is()) + { + // GameObject setter needs one more parameter: netId field ref + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldflda, netIdFieldReference); + worker.Emit(OpCodes.Call, weaverTypes.generatedSyncVarSetter_GameObject); + } + else if (fd.FieldType.Is()) + { + // NetworkIdentity setter needs one more parameter: netId field ref + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldflda, netIdFieldReference); + worker.Emit(OpCodes.Call, weaverTypes.generatedSyncVarSetter_NetworkIdentity); + } + // handle both NetworkBehaviour and inheritors. + // fixes: https://github.com/MirrorNetworking/Mirror/issues/2939 + else if (fd.FieldType.IsDerivedFrom() || fd.FieldType.Is()) + { + // NetworkIdentity setter needs one more parameter: netId field ref + // (actually its a NetworkBehaviourSyncVar type) + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldflda, netIdFieldReference); + // make generic version of GeneratedSyncVarSetter_NetworkBehaviour + MethodReference getFunc = weaverTypes.generatedSyncVarSetter_NetworkBehaviour_T.MakeGeneric(assembly.MainModule, fd.FieldType); + worker.Emit(OpCodes.Call, getFunc); + } + else + { + // make generic version of GeneratedSyncVarSetter + MethodReference generic = weaverTypes.generatedSyncVarSetter.MakeGeneric(assembly.MainModule, fd.FieldType); + worker.Emit(OpCodes.Call, generic); + } + + worker.Append(endOfMethod); + + worker.Emit(OpCodes.Ret); + + set.Parameters.Add(new ParameterDefinition("value", ParameterAttributes.In, fd.FieldType)); + set.SemanticsAttributes = MethodSemanticsAttributes.Setter; + + return set; + } + + public void ProcessSyncVar(TypeDefinition td, FieldDefinition fd, Dictionary syncVarNetIds, Dictionary syncVarHookDelegates, long dirtyBit, ref bool WeavingFailed) + { + string originalName = fd.Name; + + // GameObject/NetworkIdentity SyncVars have a new field for netId + FieldDefinition netIdField = null; + // NetworkBehaviour has different field type than other NetworkIdentityFields + // handle both NetworkBehaviour and inheritors. + // fixes: https://github.com/MirrorNetworking/Mirror/issues/2939 + if (fd.FieldType.IsDerivedFrom() || fd.FieldType.Is()) + { + netIdField = new FieldDefinition($"___{fd.Name}NetId", + FieldAttributes.Family, // needs to be protected for generic classes, otherwise access isn't allowed + weaverTypes.Import()); + netIdField.DeclaringType = td; + + syncVarNetIds[fd] = netIdField; + } + else if (fd.FieldType.IsNetworkIdentityField()) + { + netIdField = new FieldDefinition($"___{fd.Name}NetId", + FieldAttributes.Family, // needs to be protected for generic classes, otherwise access isn't allowed + weaverTypes.Import()); + netIdField.DeclaringType = td; + + syncVarNetIds[fd] = netIdField; + } + + MethodDefinition get = GenerateSyncVarGetter(fd, originalName, netIdField); + MethodDefinition set = GenerateSyncVarSetter(td, fd, originalName, dirtyBit, netIdField, syncVarHookDelegates, ref WeavingFailed); + + //NOTE: is property even needed? Could just use a setter function? + //create the property + PropertyDefinition propertyDefinition = new PropertyDefinition($"Network{originalName}", PropertyAttributes.None, fd.FieldType) + { + GetMethod = get, + SetMethod = set + }; + + //add the methods and property to the type. + td.Methods.Add(get); + td.Methods.Add(set); + td.Properties.Add(propertyDefinition); + syncVarAccessLists.replacementSetterProperties[fd] = set; + + // replace getter field if GameObject/NetworkIdentity so it uses + // netId instead + // -> only for GameObjects, otherwise an int syncvar's getter would + // end up in recursion. + if (fd.FieldType.IsNetworkIdentityField()) + { + syncVarAccessLists.replacementGetterProperties[fd] = get; + } + } + + public (List syncVars, Dictionary syncVarNetIds, Dictionary syncVarHookDelegates) ProcessSyncVars(TypeDefinition td, ref bool WeavingFailed) + { + List syncVars = new List(); + Dictionary syncVarNetIds = new Dictionary(); + Dictionary syncVarHookDelegates = new Dictionary(); + + // the mapping of dirtybits to sync-vars is implicit in the order of the fields here. this order is recorded in m_replacementProperties. + // start assigning syncvars at the place the base class stopped, if any + int dirtyBitCounter = syncVarAccessLists.GetSyncVarStart(td.BaseType.FullName); + + // find syncvars + foreach (FieldDefinition fd in td.Fields) + { + if (fd.HasCustomAttribute()) + { + if ((fd.Attributes & FieldAttributes.Static) != 0) + { + Log.Error($"{fd.Name} cannot be static", fd); + WeavingFailed = true; + continue; + } + + if (fd.FieldType.IsGenericParameter) + { + Log.Error($"{fd.Name} has generic type. Generic SyncVars are not supported", fd); + WeavingFailed = true; + continue; + } + + if (SyncObjectInitializer.ImplementsSyncObject(fd.FieldType)) + { + Log.Warning($"{fd.Name} has [SyncVar] attribute. SyncLists should not be marked with SyncVar", fd); + } + else + { + syncVars.Add(fd); + + ProcessSyncVar(td, fd, syncVarNetIds, syncVarHookDelegates, 1L << dirtyBitCounter, ref WeavingFailed); + dirtyBitCounter += 1; + + if (dirtyBitCounter > SyncVarLimit) + { + Log.Error($"{td.Name} has > {SyncVarLimit} SyncVars. Consider refactoring your class into multiple components", td); + WeavingFailed = true; + continue; + } + } + } + } + + // add all the new SyncVar __netId fields + foreach (FieldDefinition fd in syncVarNetIds.Values) + { + td.Fields.Add(fd); + } + + // add all of the new SyncVar Action fields + foreach((FieldDefinition hookDelegateInstanceField, MethodDefinition) entry in syncVarHookDelegates.Values) + { + td.Fields.Add(entry.hookDelegateInstanceField); + } + + // include parent class syncvars + // fixes: https://github.com/MirrorNetworking/Mirror/issues/3457 + int parentSyncVarCount = syncVarAccessLists.GetSyncVarStart(td.BaseType.FullName); + syncVarAccessLists.SetNumSyncVars(td.FullName, parentSyncVarCount + syncVars.Count); + + return (syncVars, syncVarNetIds, syncVarHookDelegates); + } + } +} diff --git a/Assets/Mirror/Editor/Weaver/Processors/SyncVarAttributeProcessor.cs.meta b/Assets/Mirror/Editor/Weaver/Processors/SyncVarAttributeProcessor.cs.meta new file mode 100644 index 0000000..982f768 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Processors/SyncVarAttributeProcessor.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: f52c39bddd95d42b88f9cd554dfd9198 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Weaver/Processors/TargetRpcProcessor.cs b/Assets/Mirror/Editor/Weaver/Processors/TargetRpcProcessor.cs new file mode 100644 index 0000000..8d56040 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Processors/TargetRpcProcessor.cs @@ -0,0 +1,159 @@ +using Mono.CecilX; +using Mono.CecilX.Cil; + +namespace Mirror.Weaver +{ + // Processes [TargetRpc] methods in NetworkBehaviour + public static class TargetRpcProcessor + { + // helper functions to check if the method has a NetworkConnection parameter + public static bool HasNetworkConnectionParameter(MethodDefinition md) + { + if (md.Parameters.Count > 0) + { + // we need to allow both NetworkConnection, and inheriting types. + // NetworkBehaviour.SendTargetRpc takes a NetworkConnection parameter. + // fixes https://github.com/vis2k/Mirror/issues/3290 + TypeReference type = md.Parameters[0].ParameterType; + return type.Is() || + type.IsDerivedFrom(); + } + return false; + } + + public static MethodDefinition ProcessTargetRpcInvoke(WeaverTypes weaverTypes, Readers readers, Logger Log, TypeDefinition td, MethodDefinition md, MethodDefinition rpcCallFunc, ref bool WeavingFailed) + { + string trgName = Weaver.GenerateMethodName(RemoteCalls.RemoteProcedureCalls.InvokeRpcPrefix, md); + + MethodDefinition rpc = new MethodDefinition(trgName, MethodAttributes.Family | + MethodAttributes.Static | + MethodAttributes.HideBySig, + weaverTypes.Import(typeof(void))); + + ILProcessor worker = rpc.Body.GetILProcessor(); + Instruction label = worker.Create(OpCodes.Nop); + + NetworkBehaviourProcessor.WriteClientActiveCheck(worker, weaverTypes, md.Name, label, "TargetRPC"); + + // setup for reader + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Castclass, td); + + // NetworkConnection parameter is optional + if (HasNetworkConnectionParameter(md)) + { + // TargetRpcs are sent from server to client. + // on server, we currently support two types: + // TargetRpc(NetworkConnection) + // TargetRpc(NetworkConnectionToClient) + // however, it's always a connection to client. + // in the future, only NetworkConnectionToClient will be supported. + // explicit typing helps catch issues at compile time. + // + // on client, InvokeTargetRpc calls the original code. + // we need to fill in the NetworkConnection parameter. + // NetworkClient.connection is always a connection to server. + // + // we used to pass NetworkClient.connection as the TargetRpc parameter. + // which caused: https://github.com/MirrorNetworking/Mirror/issues/3455 + // when the parameter is defined as a NetworkConnectionToClient. + // + // a client's connection never fits into a NetworkConnectionToClient. + // we need to always pass null here. + worker.Emit(OpCodes.Ldnull); + } + + // process reader parameters and skip first one if first one is NetworkConnection + if (!NetworkBehaviourProcessor.ReadArguments(md, readers, Log, worker, RemoteCallType.TargetRpc, ref WeavingFailed)) + return null; + + // invoke actual command function + worker.Emit(OpCodes.Callvirt, rpcCallFunc); + worker.Emit(OpCodes.Ret); + + NetworkBehaviourProcessor.AddInvokeParameters(weaverTypes, rpc.Parameters); + td.Methods.Add(rpc); + return rpc; + } + + /* generates code like: + public void TargetTest (NetworkConnection conn, int param) + { + NetworkWriter writer = new NetworkWriter (); + writer.WritePackedUInt32 ((uint)param); + base.SendTargetRPCInternal (conn, typeof(class), "TargetTest", val); + } + public void CallTargetTest (NetworkConnection conn, int param) + { + // whatever the user did before + } + + or if optional: + public void TargetTest (int param) + { + NetworkWriter writer = new NetworkWriter (); + writer.WritePackedUInt32 ((uint)param); + base.SendTargetRPCInternal (null, typeof(class), "TargetTest", val); + } + public void CallTargetTest (int param) + { + // whatever the user did before + } + + Originally HLAPI put the send message code inside the Call function + and then proceeded to replace every call to TargetTest with CallTargetTest + + This method moves all the user's code into the "CallTargetRpc" method + and replaces the body of the original method with the send message code. + This way we do not need to modify the code anywhere else, and this works + correctly in dependent assemblies + + */ + public static MethodDefinition ProcessTargetRpcCall(WeaverTypes weaverTypes, Writers writers, Logger Log, TypeDefinition td, MethodDefinition md, CustomAttribute targetRpcAttr, ref bool WeavingFailed) + { + MethodDefinition rpc = MethodProcessor.SubstituteMethod(Log, td, md, ref WeavingFailed); + + ILProcessor worker = md.Body.GetILProcessor(); + + NetworkBehaviourProcessor.WriteSetupLocals(worker, weaverTypes); + + NetworkBehaviourProcessor.WriteGetWriter(worker, weaverTypes); + + // write all the arguments that the user passed to the TargetRpc call + // (skip first one if first one is NetworkConnection) + if (!NetworkBehaviourProcessor.WriteArguments(worker, writers, Log, md, RemoteCallType.TargetRpc, ref WeavingFailed)) + return null; + + // invoke SendInternal and return + // this + worker.Emit(OpCodes.Ldarg_0); + if (HasNetworkConnectionParameter(md)) + { + // connection + worker.Emit(OpCodes.Ldarg_1); + } + else + { + // null + worker.Emit(OpCodes.Ldnull); + } + // pass full function name to avoid ClassA.Func <-> ClassB.Func collisions + worker.Emit(OpCodes.Ldstr, md.FullName); + // pass the function hash so we don't have to compute it at runtime + // otherwise each GetStableHash call requires O(N) complexity. + // noticeable for long function names: + // https://github.com/MirrorNetworking/Mirror/issues/3375 + worker.Emit(OpCodes.Ldc_I4, md.FullName.GetStableHashCode()); + // writer + worker.Emit(OpCodes.Ldloc_0); + worker.Emit(OpCodes.Ldc_I4, targetRpcAttr.GetField("channel", 0)); + worker.Emit(OpCodes.Callvirt, weaverTypes.sendTargetRpcInternal); + + NetworkBehaviourProcessor.WriteReturnWriter(worker, weaverTypes); + + worker.Emit(OpCodes.Ret); + + return rpc; + } + } +} diff --git a/Assets/Mirror/Editor/Weaver/Processors/TargetRpcProcessor.cs.meta b/Assets/Mirror/Editor/Weaver/Processors/TargetRpcProcessor.cs.meta new file mode 100644 index 0000000..0ff7cc5 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Processors/TargetRpcProcessor.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: fb3ce6c6f3f2942ae88178b86f5a8282 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Weaver/Readers.cs b/Assets/Mirror/Editor/Weaver/Readers.cs new file mode 100644 index 0000000..33941d9 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Readers.cs @@ -0,0 +1,385 @@ +using System; +using System.Collections.Generic; +using Mono.CecilX; +using Mono.CecilX.Cil; +// to use Mono.CecilX.Rocks here, we need to 'override references' in the +// Unity.Mirror.CodeGen assembly definition file in the Editor, and add CecilX.Rocks. +// otherwise we get an unknown import exception. +using Mono.CecilX.Rocks; + +namespace Mirror.Weaver +{ + // not static, because ILPostProcessor is multithreaded + public class Readers + { + // Readers are only for this assembly. + // can't be used from another assembly, otherwise we will get: + // "System.ArgumentException: Member ... is declared in another module and needs to be imported" + AssemblyDefinition assembly; + WeaverTypes weaverTypes; + TypeDefinition GeneratedCodeClass; + Logger Log; + + Dictionary readFuncs = + new Dictionary(new TypeReferenceComparer()); + + public Readers(AssemblyDefinition assembly, WeaverTypes weaverTypes, TypeDefinition GeneratedCodeClass, Logger Log) + { + this.assembly = assembly; + this.weaverTypes = weaverTypes; + this.GeneratedCodeClass = GeneratedCodeClass; + this.Log = Log; + } + + internal void Register(TypeReference dataType, MethodReference methodReference) + { + if (readFuncs.ContainsKey(dataType)) + { + // TODO enable this again later. + // Reader has some obsolete functions that were renamed. + // Don't want weaver warnings for all of them. + //Log.Warning($"Registering a Read method for {dataType.FullName} when one already exists", methodReference); + } + + // we need to import type when we Initialize Readers so import here in case it is used anywhere else + TypeReference imported = assembly.MainModule.ImportReference(dataType); + readFuncs[imported] = methodReference; + } + + void RegisterReadFunc(TypeReference typeReference, MethodDefinition newReaderFunc) + { + Register(typeReference, newReaderFunc); + GeneratedCodeClass.Methods.Add(newReaderFunc); + } + + // Finds existing reader for type, if non exists trys to create one + public MethodReference GetReadFunc(TypeReference variable, ref bool WeavingFailed) + { + if (readFuncs.TryGetValue(variable, out MethodReference foundFunc)) + return foundFunc; + + TypeReference importedVariable = assembly.MainModule.ImportReference(variable); + return GenerateReader(importedVariable, ref WeavingFailed); + } + + MethodReference GenerateReader(TypeReference variableReference, ref bool WeavingFailed) + { + // Arrays are special, if we resolve them, we get the element type, + // so the following ifs might choke on it for scriptable objects + // or other objects that require a custom serializer + // thus check if it is an array and skip all the checks. + if (variableReference.IsArray) + { + if (variableReference.IsMultidimensionalArray()) + { + Log.Error($"{variableReference.Name} is an unsupported type. Multidimensional arrays are not supported", variableReference); + WeavingFailed = true; + return null; + } + + return GenerateReadCollection(variableReference, variableReference.GetElementType(), nameof(NetworkReaderExtensions.ReadArray), ref WeavingFailed); + } + + TypeDefinition variableDefinition = variableReference.Resolve(); + + // check if the type is completely invalid + if (variableDefinition == null) + { + Log.Error($"{variableReference.Name} is not a supported type", variableReference); + WeavingFailed = true; + return null; + } + else if (variableReference.IsByReference) + { + // error?? + Log.Error($"Cannot pass type {variableReference.Name} by reference", variableReference); + WeavingFailed = true; + return null; + } + + // use existing func for known types + if (variableDefinition.IsEnum) + { + return GenerateEnumReadFunc(variableReference, ref WeavingFailed); + } + else if (variableDefinition.Is(typeof(ArraySegment<>))) + { + return GenerateArraySegmentReadFunc(variableReference, ref WeavingFailed); + } + else if (variableDefinition.Is(typeof(List<>))) + { + GenericInstanceType genericInstance = (GenericInstanceType)variableReference; + TypeReference elementType = genericInstance.GenericArguments[0]; + + return GenerateReadCollection(variableReference, elementType, nameof(NetworkReaderExtensions.ReadList), ref WeavingFailed); + } + // handle both NetworkBehaviour and inheritors. + // fixes: https://github.com/MirrorNetworking/Mirror/issues/2939 + else if (variableReference.IsDerivedFrom() || variableReference.Is()) + { + return GetNetworkBehaviourReader(variableReference); + } + + // check if reader generation is applicable on this type + if (variableDefinition.IsDerivedFrom()) + { + Log.Error($"Cannot generate reader for component type {variableReference.Name}. Use a supported type or provide a custom reader", variableReference); + WeavingFailed = true; + return null; + } + if (variableReference.Is()) + { + Log.Error($"Cannot generate reader for {variableReference.Name}. Use a supported type or provide a custom reader", variableReference); + WeavingFailed = true; + return null; + } + if (variableReference.Is()) + { + Log.Error($"Cannot generate reader for {variableReference.Name}. Use a supported type or provide a custom reader", variableReference); + WeavingFailed = true; + return null; + } + if (variableDefinition.HasGenericParameters) + { + Log.Error($"Cannot generate reader for generic variable {variableReference.Name}. Use a supported type or provide a custom reader", variableReference); + WeavingFailed = true; + return null; + } + if (variableDefinition.IsInterface) + { + Log.Error($"Cannot generate reader for interface {variableReference.Name}. Use a supported type or provide a custom reader", variableReference); + WeavingFailed = true; + return null; + } + if (variableDefinition.IsAbstract) + { + Log.Error($"Cannot generate reader for abstract class {variableReference.Name}. Use a supported type or provide a custom reader", variableReference); + WeavingFailed = true; + return null; + } + + return GenerateClassOrStructReadFunction(variableReference, ref WeavingFailed); + } + + MethodReference GetNetworkBehaviourReader(TypeReference variableReference) + { + // uses generic ReadNetworkBehaviour rather than having weaver create one for each NB + MethodReference generic = weaverTypes.readNetworkBehaviourGeneric; + + MethodReference readFunc = generic.MakeGeneric(assembly.MainModule, variableReference); + + // register function so it is added to Reader + // use Register instead of RegisterWriteFunc because this is not a generated function + Register(variableReference, readFunc); + + return readFunc; + } + + MethodDefinition GenerateEnumReadFunc(TypeReference variable, ref bool WeavingFailed) + { + MethodDefinition readerFunc = GenerateReaderFunction(variable); + + ILProcessor worker = readerFunc.Body.GetILProcessor(); + + worker.Emit(OpCodes.Ldarg_0); + + TypeReference underlyingType = variable.Resolve().GetEnumUnderlyingType(); + MethodReference underlyingFunc = GetReadFunc(underlyingType, ref WeavingFailed); + + worker.Emit(OpCodes.Call, underlyingFunc); + worker.Emit(OpCodes.Ret); + return readerFunc; + } + + MethodDefinition GenerateArraySegmentReadFunc(TypeReference variable, ref bool WeavingFailed) + { + GenericInstanceType genericInstance = (GenericInstanceType)variable; + TypeReference elementType = genericInstance.GenericArguments[0]; + + MethodDefinition readerFunc = GenerateReaderFunction(variable); + + ILProcessor worker = readerFunc.Body.GetILProcessor(); + + // $array = reader.Read<[T]>() + ArrayType arrayType = elementType.MakeArrayType(); + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Call, GetReadFunc(arrayType, ref WeavingFailed)); + + // return new ArraySegment($array); + worker.Emit(OpCodes.Newobj, weaverTypes.ArraySegmentConstructorReference.MakeHostInstanceGeneric(assembly.MainModule, genericInstance)); + worker.Emit(OpCodes.Ret); + return readerFunc; + } + + MethodDefinition GenerateReaderFunction(TypeReference variable) + { + string functionName = $"_Read_{variable.FullName}"; + + // create new reader for this type + MethodDefinition readerFunc = new MethodDefinition(functionName, + MethodAttributes.Public | + MethodAttributes.Static | + MethodAttributes.HideBySig, + variable); + + readerFunc.Parameters.Add(new ParameterDefinition("reader", ParameterAttributes.None, weaverTypes.Import())); + readerFunc.Body.InitLocals = true; + RegisterReadFunc(variable, readerFunc); + + return readerFunc; + } + + MethodDefinition GenerateReadCollection(TypeReference variable, TypeReference elementType, string readerFunction, ref bool WeavingFailed) + { + MethodDefinition readerFunc = GenerateReaderFunction(variable); + // generate readers for the element + GetReadFunc(elementType, ref WeavingFailed); + + ModuleDefinition module = assembly.MainModule; + TypeReference readerExtensions = module.ImportReference(typeof(NetworkReaderExtensions)); + MethodReference listReader = Resolvers.ResolveMethod(readerExtensions, assembly, Log, readerFunction, ref WeavingFailed); + + GenericInstanceMethod methodRef = new GenericInstanceMethod(listReader); + methodRef.GenericArguments.Add(elementType); + + // generates + // return reader.ReadList(); + + ILProcessor worker = readerFunc.Body.GetILProcessor(); + worker.Emit(OpCodes.Ldarg_0); // reader + worker.Emit(OpCodes.Call, methodRef); // Read + + worker.Emit(OpCodes.Ret); + + return readerFunc; + } + + MethodDefinition GenerateClassOrStructReadFunction(TypeReference variable, ref bool WeavingFailed) + { + MethodDefinition readerFunc = GenerateReaderFunction(variable); + + // create local for return value + readerFunc.Body.Variables.Add(new VariableDefinition(variable)); + + ILProcessor worker = readerFunc.Body.GetILProcessor(); + + TypeDefinition td = variable.Resolve(); + + if (!td.IsValueType) + GenerateNullCheck(worker, ref WeavingFailed); + + CreateNew(variable, worker, td, ref WeavingFailed); + ReadAllFields(variable, worker, ref WeavingFailed); + + worker.Emit(OpCodes.Ldloc_0); + worker.Emit(OpCodes.Ret); + return readerFunc; + } + + void GenerateNullCheck(ILProcessor worker, ref bool WeavingFailed) + { + // if (!reader.ReadBoolean()) { + // return null; + // } + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Call, GetReadFunc(weaverTypes.Import(), ref WeavingFailed)); + + Instruction labelEmptyArray = worker.Create(OpCodes.Nop); + worker.Emit(OpCodes.Brtrue, labelEmptyArray); + // return null + worker.Emit(OpCodes.Ldnull); + worker.Emit(OpCodes.Ret); + worker.Append(labelEmptyArray); + } + + // Initialize the local variable with a new instance + void CreateNew(TypeReference variable, ILProcessor worker, TypeDefinition td, ref bool WeavingFailed) + { + if (variable.IsValueType) + { + // structs are created with Initobj + worker.Emit(OpCodes.Ldloca, 0); + worker.Emit(OpCodes.Initobj, variable); + } + else if (td.IsDerivedFrom()) + { + GenericInstanceMethod genericInstanceMethod = new GenericInstanceMethod(weaverTypes.ScriptableObjectCreateInstanceMethod); + genericInstanceMethod.GenericArguments.Add(variable); + worker.Emit(OpCodes.Call, genericInstanceMethod); + worker.Emit(OpCodes.Stloc_0); + } + else + { + // classes are created with their constructor + MethodDefinition ctor = Resolvers.ResolveDefaultPublicCtor(variable); + if (ctor == null) + { + Log.Error($"{variable.Name} can't be deserialized because it has no default constructor. Don't use {variable.Name} in [SyncVar]s, Rpcs, Cmds, etc.", variable); + WeavingFailed = true; + return; + } + + MethodReference ctorRef = assembly.MainModule.ImportReference(ctor); + + worker.Emit(OpCodes.Newobj, ctorRef); + worker.Emit(OpCodes.Stloc_0); + } + } + + void ReadAllFields(TypeReference variable, ILProcessor worker, ref bool WeavingFailed) + { + foreach (FieldDefinition field in variable.FindAllPublicFields()) + { + // mismatched ldloca/ldloc for struct/class combinations is invalid IL, which causes crash at runtime + OpCode opcode = variable.IsValueType ? OpCodes.Ldloca : OpCodes.Ldloc; + worker.Emit(opcode, 0); + MethodReference readFunc = GetReadFunc(field.FieldType, ref WeavingFailed); + if (readFunc != null) + { + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Call, readFunc); + } + else + { + Log.Error($"{field.Name} has an unsupported type", field); + WeavingFailed = true; + } + FieldReference fieldRef = assembly.MainModule.ImportReference(field); + + worker.Emit(OpCodes.Stfld, fieldRef); + } + } + + // Save a delegate for each one of the readers into Reader.read + internal void InitializeReaders(ILProcessor worker) + { + ModuleDefinition module = assembly.MainModule; + + TypeReference genericReaderClassRef = module.ImportReference(typeof(Reader<>)); + + System.Reflection.FieldInfo fieldInfo = typeof(Reader<>).GetField(nameof(Reader.read)); + FieldReference fieldRef = module.ImportReference(fieldInfo); + TypeReference networkReaderRef = module.ImportReference(typeof(NetworkReader)); + TypeReference funcRef = module.ImportReference(typeof(Func<,>)); + MethodReference funcConstructorRef = module.ImportReference(typeof(Func<,>).GetConstructors()[0]); + + foreach (KeyValuePair kvp in readFuncs) + { + TypeReference targetType = kvp.Key; + MethodReference readFunc = kvp.Value; + + // create a Func delegate + worker.Emit(OpCodes.Ldnull); + worker.Emit(OpCodes.Ldftn, readFunc); + GenericInstanceType funcGenericInstance = funcRef.MakeGenericInstanceType(networkReaderRef, targetType); + MethodReference funcConstructorInstance = funcConstructorRef.MakeHostInstanceGeneric(assembly.MainModule, funcGenericInstance); + worker.Emit(OpCodes.Newobj, funcConstructorInstance); + + // save it in Reader.read + GenericInstanceType genericInstance = genericReaderClassRef.MakeGenericInstanceType(targetType); + FieldReference specializedField = fieldRef.SpecializeField(assembly.MainModule, genericInstance); + worker.Emit(OpCodes.Stsfld, specializedField); + } + } + } +} diff --git a/Assets/Mirror/Editor/Weaver/Readers.cs.meta b/Assets/Mirror/Editor/Weaver/Readers.cs.meta new file mode 100644 index 0000000..838ff59 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Readers.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: be40277098a024539bf63d0205cae824 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Weaver/Resolvers.cs b/Assets/Mirror/Editor/Weaver/Resolvers.cs new file mode 100644 index 0000000..0af32ca --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Resolvers.cs @@ -0,0 +1,126 @@ +// all the resolve functions for the weaver +// NOTE: these functions should be made extensions, but right now they still +// make heavy use of Weaver.fail and we'd have to check each one's return +// value for null otherwise. +// (original FieldType.Resolve returns null if not found too, so +// exceptions would be a bit inconsistent here) +using Mono.CecilX; + +namespace Mirror.Weaver +{ + public static class Resolvers + { + public static MethodReference ResolveMethod(TypeReference tr, AssemblyDefinition assembly, Logger Log, string name, ref bool WeavingFailed) + { + if (tr == null) + { + Log.Error($"Cannot resolve method {name} without a class"); + WeavingFailed = true; + return null; + } + MethodReference method = ResolveMethod(tr, assembly, Log, m => m.Name == name, ref WeavingFailed); + if (method == null) + { + Log.Error($"Method not found with name {name} in type {tr.Name}", tr); + WeavingFailed = true; + } + return method; + } + + public static MethodReference ResolveMethod(TypeReference t, AssemblyDefinition assembly, Logger Log, System.Func predicate, ref bool WeavingFailed) + { + foreach (MethodDefinition methodRef in t.Resolve().Methods) + { + if (predicate(methodRef)) + { + return assembly.MainModule.ImportReference(methodRef); + } + } + + Log.Error($"Method not found in type {t.Name}", t); + WeavingFailed = true; + return null; + } + + public static FieldReference ResolveField(TypeReference tr, AssemblyDefinition assembly, Logger Log, string name, ref bool WeavingFailed) + { + if (tr == null) + { + Log.Error($"Cannot resolve Field {name} without a class"); + WeavingFailed = true; + return null; + } + FieldReference field = ResolveField(tr, assembly, Log, m => m.Name == name, ref WeavingFailed); + if (field == null) + { + Log.Error($"Field not found with name {name} in type {tr.Name}", tr); + WeavingFailed = true; + } + return field; + } + + public static FieldReference ResolveField(TypeReference t, AssemblyDefinition assembly, Logger Log, System.Func predicate, ref bool WeavingFailed) + { + foreach (FieldDefinition fieldRef in t.Resolve().Fields) + { + if (predicate(fieldRef)) + { + return assembly.MainModule.ImportReference(fieldRef); + } + } + + Log.Error($"Field not found in type {t.Name}", t); + WeavingFailed = true; + return null; + } + + public static MethodReference TryResolveMethodInParents(TypeReference tr, AssemblyDefinition assembly, string name) + { + if (tr == null) + { + return null; + } + foreach (MethodDefinition methodDef in tr.Resolve().Methods) + { + if (methodDef.Name == name) + { + MethodReference methodRef = methodDef; + if (tr.IsGenericInstance) + { + methodRef = methodRef.MakeHostInstanceGeneric(tr.Module, (GenericInstanceType)tr); + } + return assembly.MainModule.ImportReference(methodRef); + } + } + + // Could not find the method in this class, try the parent + return TryResolveMethodInParents(tr.Resolve().BaseType.ApplyGenericParameters(tr), assembly, name); + } + + public static MethodDefinition ResolveDefaultPublicCtor(TypeReference variable) + { + foreach (MethodDefinition methodRef in variable.Resolve().Methods) + { + if (methodRef.Name == ".ctor" && + methodRef.Resolve().IsPublic && + methodRef.Parameters.Count == 0) + { + return methodRef; + } + } + return null; + } + + public static MethodReference ResolveProperty(TypeReference tr, AssemblyDefinition assembly, string name) + { + foreach (PropertyDefinition pd in tr.Resolve().Properties) + { + if (pd.Name == name) + { + return assembly.MainModule.ImportReference(pd.GetMethod); + } + } + return null; + } + } +} diff --git a/Assets/Mirror/Editor/Weaver/Resolvers.cs.meta b/Assets/Mirror/Editor/Weaver/Resolvers.cs.meta new file mode 100644 index 0000000..f4f6602 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Resolvers.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 3039a59c76aec43c797ad66930430367 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Weaver/SyncVarAccessLists.cs b/Assets/Mirror/Editor/Weaver/SyncVarAccessLists.cs new file mode 100644 index 0000000..fa7a682 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/SyncVarAccessLists.cs @@ -0,0 +1,32 @@ +// tracks SyncVar read/write access when processing NetworkBehaviour, +// to later be replaced by SyncVarAccessReplacer. +using System.Collections.Generic; +using Mono.CecilX; + +namespace Mirror.Weaver +{ + // This data is flushed each time - if we are run multiple times in the same process/domain + public class SyncVarAccessLists + { + // setter functions that replace [SyncVar] member variable references. dict + public Dictionary replacementSetterProperties = + new Dictionary(); + + // getter functions that replace [SyncVar] member variable references. dict + public Dictionary replacementGetterProperties = + new Dictionary(); + + // amount of SyncVars per class. dict + // necessary for SyncVar dirty bits, where inheriting classes start + // their dirty bits at base class SyncVar amount. + public Dictionary numSyncVars = new Dictionary(); + + public int GetSyncVarStart(string className) => + numSyncVars.TryGetValue(className, out int value) ? value : 0; + + public void SetNumSyncVars(string className, int num) + { + numSyncVars[className] = num; + } + } +} diff --git a/Assets/Mirror/Editor/Weaver/SyncVarAccessLists.cs.meta b/Assets/Mirror/Editor/Weaver/SyncVarAccessLists.cs.meta new file mode 100644 index 0000000..9a4da44 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/SyncVarAccessLists.cs.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: 6905230c3c4c4e158760065a93380e83 +timeCreated: 1629348618 \ No newline at end of file diff --git a/Assets/Mirror/Editor/Weaver/TypeReferenceComparer.cs b/Assets/Mirror/Editor/Weaver/TypeReferenceComparer.cs new file mode 100644 index 0000000..e3c31d5 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/TypeReferenceComparer.cs @@ -0,0 +1,15 @@ +using System.Collections.Generic; +using Mono.CecilX; + +namespace Mirror.Weaver +{ + // Compares TypeReference using FullName + public class TypeReferenceComparer : IEqualityComparer + { + public bool Equals(TypeReference x, TypeReference y) => + x.FullName == y.FullName; + + public int GetHashCode(TypeReference obj) => + obj.FullName.GetHashCode(); + } +} diff --git a/Assets/Mirror/Editor/Weaver/TypeReferenceComparer.cs.meta b/Assets/Mirror/Editor/Weaver/TypeReferenceComparer.cs.meta new file mode 100644 index 0000000..890b4dc --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/TypeReferenceComparer.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 55eb9eb8794946f4da7ad39788c9920b +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Weaver/Unity.Mirror.CodeGen.asmdef b/Assets/Mirror/Editor/Weaver/Unity.Mirror.CodeGen.asmdef new file mode 100644 index 0000000..987382c --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Unity.Mirror.CodeGen.asmdef @@ -0,0 +1,21 @@ +{ + "name": "Unity.Mirror.CodeGen", + "rootNamespace": "", + "references": [ + "GUID:30817c1a0e6d646d99c048fc403f5979" + ], + "includePlatforms": [ + "Editor" + ], + "excludePlatforms": [], + "allowUnsafeCode": true, + "overrideReferences": true, + "precompiledReferences": [ + "Mono.CecilX.dll", + "Mono.CecilX.Rocks.dll" + ], + "autoReferenced": false, + "defineConstraints": [], + "versionDefines": [], + "noEngineReferences": false +} \ No newline at end of file diff --git a/Assets/Mirror/Editor/Weaver/Unity.Mirror.CodeGen.asmdef.meta b/Assets/Mirror/Editor/Weaver/Unity.Mirror.CodeGen.asmdef.meta new file mode 100644 index 0000000..b65a0cd --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Unity.Mirror.CodeGen.asmdef.meta @@ -0,0 +1,7 @@ +fileFormatVersion: 2 +guid: 1d0b9d21c3ff546a4aa32399dfd33474 +AssemblyDefinitionImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Weaver/Weaver.cs b/Assets/Mirror/Editor/Weaver/Weaver.cs new file mode 100644 index 0000000..3aef7b8 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Weaver.cs @@ -0,0 +1,267 @@ +using System; +using System.Collections.Generic; +using System.Diagnostics; +using Mono.CecilX; +using Mono.CecilX.Cil; +using Mono.CecilX.Rocks; + +namespace Mirror.Weaver +{ + // not static, because ILPostProcessor is multithreaded + internal class Weaver + { + // generated code class + public const string GeneratedCodeNamespace = "Mirror"; + public const string GeneratedCodeClassName = "GeneratedNetworkCode"; + TypeDefinition GeneratedCodeClass; + + // for resolving Mirror.dll in ReaderWriterProcessor, we need to know + // Mirror.dll name + public const string MirrorAssemblyName = "Mirror"; + + WeaverTypes weaverTypes; + SyncVarAccessLists syncVarAccessLists; + AssemblyDefinition CurrentAssembly; + Writers writers; + Readers readers; + + // in case of weaver errors, we don't stop immediately. + // we log all errors and then eventually return false if + // weaving has failed. + // this way the user can fix multiple errors at once, instead of having + // to fix -> recompile -> fix -> recompile for one error at a time. + bool WeavingFailed; + + // logger functions can be set from the outside. + // for example, Debug.Log or ILPostProcessor Diagnostics log for + // multi threaded logging. + public Logger Log; + + // remote actions now support overloads, + // -> but IL2CPP doesnt like it when two generated methods + // -> have the same signature, + // -> so, append the signature to the generated method name, + // -> to create a unique name + // Example: + // RpcTeleport(Vector3 position) -> InvokeUserCode_RpcTeleport__Vector3() + // RpcTeleport(Vector3 position, Quaternion rotation) -> InvokeUserCode_RpcTeleport__Vector3Quaternion() + // fixes https://github.com/vis2k/Mirror/issues/3060 + public static string GenerateMethodName(string initialPrefix, MethodDefinition md) + { + initialPrefix += md.Name; + + for (int i = 0; i < md.Parameters.Count; ++i) + { + // with __ so it's more obvious that this is the parameter suffix. + // otherwise RpcTest(int) => RpcTestInt(int) which is not obvious. + initialPrefix += $"__{md.Parameters[i].ParameterType.Name}"; + } + + return initialPrefix; + } + + public Weaver(Logger Log) + { + this.Log = Log; + } + + // returns 'true' if modified (=if we did anything) + bool WeaveNetworkBehavior(TypeDefinition td) + { + if (!td.IsClass) + return false; + + if (!td.IsDerivedFrom()) + { + if (td.IsDerivedFrom()) + MonoBehaviourProcessor.Process(Log, td, ref WeavingFailed); + return false; + } + + // process this and base classes from parent to child order + + List behaviourClasses = new List(); + + TypeDefinition parent = td; + while (parent != null) + { + if (parent.Is()) + { + break; + } + + try + { + behaviourClasses.Insert(0, parent); + parent = parent.BaseType.Resolve(); + } + catch (AssemblyResolutionException) + { + // this can happen for plugins. + //Console.WriteLine("AssemblyResolutionException: "+ ex.ToString()); + break; + } + } + + bool modified = false; + foreach (TypeDefinition behaviour in behaviourClasses) + { + modified |= new NetworkBehaviourProcessor(CurrentAssembly, weaverTypes, syncVarAccessLists, writers, readers, Log, behaviour).Process(ref WeavingFailed); + } + return modified; + } + + bool WeaveModule(ModuleDefinition moduleDefinition) + { + bool modified = false; + + Stopwatch watch = Stopwatch.StartNew(); + watch.Start(); + + // ModuleDefinition.Types only finds top level types. + // GetAllTypes recursively finds all nested types as well. + // fixes nested types not being weaved, for example: + // class Parent { // ModuleDefinition.Types finds this + // class Child { // .Types.NestedTypes finds this + // class GrandChild {} // only GetAllTypes finds this too + // } + // } + // note this is not about inheritance, only about type definitions. + // see test: NetworkBehaviourTests.DeeplyNested() + foreach (TypeDefinition td in moduleDefinition.GetAllTypes()) + { + if (td.IsClass && td.BaseType.CanBeResolved()) + { + modified |= WeaveNetworkBehavior(td); + modified |= ServerClientAttributeProcessor.Process(weaverTypes, Log, td, ref WeavingFailed); + } + } + + watch.Stop(); + Console.WriteLine($"Weave behaviours and messages took {watch.ElapsedMilliseconds} milliseconds"); + + return modified; + } + + void CreateGeneratedCodeClass() + { + // create "Mirror.GeneratedNetworkCode" class which holds all + // Readers and Writers + GeneratedCodeClass = new TypeDefinition(GeneratedCodeNamespace, GeneratedCodeClassName, + TypeAttributes.BeforeFieldInit | TypeAttributes.Class | TypeAttributes.AnsiClass | TypeAttributes.Public | TypeAttributes.AutoClass | TypeAttributes.Abstract | TypeAttributes.Sealed, + weaverTypes.Import()); + } + + void ToggleWeaverFuse() + { + // // find Weaved() function + MethodDefinition func = weaverTypes.weaverFuseMethod.Resolve(); + // // change return 0 to return 1 + + ILProcessor worker = func.Body.GetILProcessor(); + func.Body.Instructions[0] = worker.Create(OpCodes.Ldc_I4_1); + } + + // Weave takes an AssemblyDefinition to be compatible with both old and + // new weavers: + // * old takes a filepath, new takes a in-memory byte[] + // * old uses DefaultAssemblyResolver with added dependencies paths, + // new uses ...? + // + // => assembly: the one we are currently weaving (MyGame.dll) + // => resolver: useful in case we need to resolve any of the assembly's + // assembly.MainModule.AssemblyReferences. + // -> we can resolve ANY of them given that the resolver + // works properly (need custom one for ILPostProcessor) + // -> IMPORTANT: .Resolve() takes an AssemblyNameReference. + // those from assembly.MainModule.AssemblyReferences are + // guaranteed to be resolve-able. + // Parsing from a string for Library/.../Mirror.dll + // would not be guaranteed to be resolve-able because + // for ILPostProcessor we can't assume where Mirror.dll + // is etc. + public bool Weave(AssemblyDefinition assembly, IAssemblyResolver resolver, out bool modified) + { + WeavingFailed = false; + modified = false; + try + { + CurrentAssembly = assembly; + + // fix "No writer found for ..." error + // https://github.com/vis2k/Mirror/issues/2579 + // -> when restarting Unity, weaver would try to weave a DLL + // again + // -> resulting in two GeneratedNetworkCode classes (see ILSpy) + // -> the second one wouldn't have all the writer types setup + if (CurrentAssembly.MainModule.ContainsClass(GeneratedCodeNamespace, GeneratedCodeClassName)) + { + //Log.Warning($"Weaver: skipping {CurrentAssembly.Name} because already weaved"); + return true; + } + + weaverTypes = new WeaverTypes(CurrentAssembly, Log, ref WeavingFailed); + + // weaverTypes are needed for CreateGeneratedCodeClass + CreateGeneratedCodeClass(); + + // WeaverList depends on WeaverTypes setup because it uses Import + syncVarAccessLists = new SyncVarAccessLists(); + + // initialize readers & writers with this assembly. + // we need to do this in every Process() call. + // otherwise we would get + // "System.ArgumentException: Member ... is declared in another module and needs to be imported" + // errors when still using the previous module's reader/writer funcs. + writers = new Writers(CurrentAssembly, weaverTypes, GeneratedCodeClass, Log); + readers = new Readers(CurrentAssembly, weaverTypes, GeneratedCodeClass, Log); + + Stopwatch rwstopwatch = Stopwatch.StartNew(); + // Need to track modified from ReaderWriterProcessor too because it could find custom read/write functions or create functions for NetworkMessages + modified = ReaderWriterProcessor.Process(CurrentAssembly, resolver, Log, writers, readers, ref WeavingFailed); + rwstopwatch.Stop(); + Console.WriteLine($"Find all reader and writers took {rwstopwatch.ElapsedMilliseconds} milliseconds"); + + ModuleDefinition moduleDefinition = CurrentAssembly.MainModule; + Console.WriteLine($"Script Module: {moduleDefinition.Name}"); + + modified |= WeaveModule(moduleDefinition); + + if (WeavingFailed) + { + return false; + } + + if (modified) + { + SyncVarAttributeAccessReplacer.Process(Log, moduleDefinition, syncVarAccessLists); + + // add class that holds read/write functions + moduleDefinition.Types.Add(GeneratedCodeClass); + + ReaderWriterProcessor.InitializeReaderAndWriters(CurrentAssembly, weaverTypes, writers, readers, GeneratedCodeClass); + + // DO NOT WRITE here. + // CompilationFinishedHook writes to the file. + // ILPostProcessor writes to in-memory assembly. + // it depends on the caller. + //CurrentAssembly.Write(new WriterParameters{ WriteSymbols = true }); + } + + // if weaving succeeded, switch on the Weaver Fuse in Mirror.dll + if (CurrentAssembly.Name.Name == MirrorAssemblyName) + { + ToggleWeaverFuse(); + } + + return true; + } + catch (Exception e) + { + Log.Error($"Exception :{e}"); + WeavingFailed = true; + return false; + } + } + } +} diff --git a/Assets/Mirror/Editor/Weaver/Weaver.cs.meta b/Assets/Mirror/Editor/Weaver/Weaver.cs.meta new file mode 100644 index 0000000..0ea2dfe --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Weaver.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: de160f52931054064852f2afd7e7a86f +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Weaver/WeaverExceptions.cs b/Assets/Mirror/Editor/Weaver/WeaverExceptions.cs new file mode 100644 index 0000000..efedd27 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/WeaverExceptions.cs @@ -0,0 +1,26 @@ +using System; +using System.Runtime.Serialization; +using Mono.CecilX; + +namespace Mirror.Weaver +{ + [Serializable] + public abstract class WeaverException : Exception + { + public MemberReference MemberReference { get; } + + protected WeaverException(string message, MemberReference member) : base(message) + { + MemberReference = member; + } + + protected WeaverException(SerializationInfo serializationInfo, StreamingContext streamingContext) : base(serializationInfo, streamingContext) {} + } + + [Serializable] + public class GenerateWriterException : WeaverException + { + public GenerateWriterException(string message, MemberReference member) : base(message, member) {} + protected GenerateWriterException(SerializationInfo serializationInfo, StreamingContext streamingContext) : base(serializationInfo, streamingContext) {} + } +} diff --git a/Assets/Mirror/Editor/Weaver/WeaverExceptions.cs.meta b/Assets/Mirror/Editor/Weaver/WeaverExceptions.cs.meta new file mode 100644 index 0000000..68643b2 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/WeaverExceptions.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 8aaaf6193bad7424492677f8e81f1b30 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Weaver/WeaverTypes.cs b/Assets/Mirror/Editor/Weaver/WeaverTypes.cs new file mode 100644 index 0000000..aa0d42d --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/WeaverTypes.cs @@ -0,0 +1,171 @@ +using System; +using Mono.CecilX; +using UnityEditor; +using UnityEngine; + +namespace Mirror.Weaver +{ + // not static, because ILPostProcessor is multithreaded + public class WeaverTypes + { + public MethodReference ScriptableObjectCreateInstanceMethod; + + public FieldReference NetworkBehaviourDirtyBitsReference; + public MethodReference GetWriterReference; + public MethodReference ReturnWriterReference; + + public MethodReference NetworkClientConnectionReference; + + public MethodReference RemoteCallDelegateConstructor; + + public MethodReference NetworkServerGetActive; + public MethodReference NetworkClientGetActive; + + // custom attribute types + public MethodReference InitSyncObjectReference; + + // array segment + public MethodReference ArraySegmentConstructorReference; + + // Action for SyncVar Hooks + public MethodReference ActionT_T; + + // syncvar + public MethodReference generatedSyncVarSetter; + public MethodReference generatedSyncVarSetter_GameObject; + public MethodReference generatedSyncVarSetter_NetworkIdentity; + public MethodReference generatedSyncVarSetter_NetworkBehaviour_T; + public MethodReference generatedSyncVarDeserialize; + public MethodReference generatedSyncVarDeserialize_GameObject; + public MethodReference generatedSyncVarDeserialize_NetworkIdentity; + public MethodReference generatedSyncVarDeserialize_NetworkBehaviour_T; + public MethodReference getSyncVarGameObjectReference; + public MethodReference getSyncVarNetworkIdentityReference; + public MethodReference getSyncVarNetworkBehaviourReference; + public MethodReference registerCommandReference; + public MethodReference registerRpcReference; + public MethodReference getTypeFromHandleReference; + public MethodReference logErrorReference; + public MethodReference logWarningReference; + public MethodReference sendCommandInternal; + public MethodReference sendRpcInternal; + public MethodReference sendTargetRpcInternal; + + public MethodReference readNetworkBehaviourGeneric; + + public TypeReference weaverFuseType; + public MethodReference weaverFuseMethod; + + // attributes + public TypeDefinition initializeOnLoadMethodAttribute; + public TypeDefinition runtimeInitializeOnLoadMethodAttribute; + + AssemblyDefinition assembly; + + public TypeReference Import() => Import(typeof(T)); + + public TypeReference Import(Type t) => assembly.MainModule.ImportReference(t); + + // constructor resolves the types and stores them in fields + public WeaverTypes(AssemblyDefinition assembly, Logger Log, ref bool WeavingFailed) + { + // system types + this.assembly = assembly; + + TypeReference ArraySegmentType = Import(typeof(ArraySegment<>)); + ArraySegmentConstructorReference = Resolvers.ResolveMethod(ArraySegmentType, assembly, Log, ".ctor", ref WeavingFailed); + + TypeReference ActionType = Import(typeof(Action<,>)); + ActionT_T = Resolvers.ResolveMethod(ActionType, assembly, Log, ".ctor", ref WeavingFailed); + + weaverFuseType = Import(typeof(WeaverFuse)); + weaverFuseMethod = Resolvers.ResolveMethod(weaverFuseType, assembly, Log, "Weaved", ref WeavingFailed); + + TypeReference NetworkServerType = Import(typeof(NetworkServer)); + NetworkServerGetActive = Resolvers.ResolveMethod(NetworkServerType, assembly, Log, "get_active", ref WeavingFailed); + + TypeReference NetworkClientType = Import(typeof(NetworkClient)); + NetworkClientGetActive = Resolvers.ResolveMethod(NetworkClientType, assembly, Log, "get_active", ref WeavingFailed); + NetworkClientConnectionReference = Resolvers.ResolveMethod(NetworkClientType, assembly, Log, "get_connection", ref WeavingFailed); + + TypeReference NetworkBehaviourType = Import(); + + NetworkBehaviourDirtyBitsReference = Resolvers.ResolveField(NetworkBehaviourType, assembly, Log, "syncVarDirtyBits", ref WeavingFailed); + + generatedSyncVarSetter = Resolvers.ResolveMethod(NetworkBehaviourType, assembly, Log, "GeneratedSyncVarSetter", ref WeavingFailed); + generatedSyncVarSetter_GameObject = Resolvers.ResolveMethod(NetworkBehaviourType, assembly, Log, "GeneratedSyncVarSetter_GameObject", ref WeavingFailed); + generatedSyncVarSetter_NetworkIdentity = Resolvers.ResolveMethod(NetworkBehaviourType, assembly, Log, "GeneratedSyncVarSetter_NetworkIdentity", ref WeavingFailed); + generatedSyncVarSetter_NetworkBehaviour_T = Resolvers.ResolveMethod(NetworkBehaviourType, assembly, Log, "GeneratedSyncVarSetter_NetworkBehaviour", ref WeavingFailed); + + generatedSyncVarDeserialize_GameObject = Resolvers.ResolveMethod(NetworkBehaviourType, assembly, Log, "GeneratedSyncVarDeserialize_GameObject", ref WeavingFailed); + generatedSyncVarDeserialize = Resolvers.ResolveMethod(NetworkBehaviourType, assembly, Log, "GeneratedSyncVarDeserialize", ref WeavingFailed); + generatedSyncVarDeserialize_NetworkIdentity = Resolvers.ResolveMethod(NetworkBehaviourType, assembly, Log, "GeneratedSyncVarDeserialize_NetworkIdentity", ref WeavingFailed); + generatedSyncVarDeserialize_NetworkBehaviour_T = Resolvers.ResolveMethod(NetworkBehaviourType, assembly, Log, "GeneratedSyncVarDeserialize_NetworkBehaviour", ref WeavingFailed); + + getSyncVarGameObjectReference = Resolvers.ResolveMethod(NetworkBehaviourType, assembly, Log, "GetSyncVarGameObject", ref WeavingFailed); + getSyncVarNetworkIdentityReference = Resolvers.ResolveMethod(NetworkBehaviourType, assembly, Log, "GetSyncVarNetworkIdentity", ref WeavingFailed); + getSyncVarNetworkBehaviourReference = Resolvers.ResolveMethod(NetworkBehaviourType, assembly, Log, "GetSyncVarNetworkBehaviour", ref WeavingFailed); + + sendCommandInternal = Resolvers.ResolveMethod(NetworkBehaviourType, assembly, Log, "SendCommandInternal", ref WeavingFailed); + sendRpcInternal = Resolvers.ResolveMethod(NetworkBehaviourType, assembly, Log, "SendRPCInternal", ref WeavingFailed); + sendTargetRpcInternal = Resolvers.ResolveMethod(NetworkBehaviourType, assembly, Log, "SendTargetRPCInternal", ref WeavingFailed); + + InitSyncObjectReference = Resolvers.ResolveMethod(NetworkBehaviourType, assembly, Log, "InitSyncObject", ref WeavingFailed); + + TypeReference RemoteProcedureCallsType = Import(typeof(RemoteCalls.RemoteProcedureCalls)); + registerCommandReference = Resolvers.ResolveMethod(RemoteProcedureCallsType, assembly, Log, "RegisterCommand", ref WeavingFailed); + registerRpcReference = Resolvers.ResolveMethod(RemoteProcedureCallsType, assembly, Log, "RegisterRpc", ref WeavingFailed); + + TypeReference RemoteCallDelegateType = Import(); + RemoteCallDelegateConstructor = Resolvers.ResolveMethod(RemoteCallDelegateType, assembly, Log, ".ctor", ref WeavingFailed); + + TypeReference ScriptableObjectType = Import(); + ScriptableObjectCreateInstanceMethod = Resolvers.ResolveMethod( + ScriptableObjectType, assembly, Log, + md => md.Name == "CreateInstance" && md.HasGenericParameters, + ref WeavingFailed); + + TypeReference unityDebug = Import(typeof(UnityEngine.Debug)); + // these have multiple methods with same name, so need to check parameters too + logErrorReference = Resolvers.ResolveMethod(unityDebug, assembly, Log, md => + md.Name == "LogError" && + md.Parameters.Count == 1 && + md.Parameters[0].ParameterType.FullName == typeof(object).FullName, + ref WeavingFailed); + + logWarningReference = Resolvers.ResolveMethod(unityDebug, assembly, Log, md => + md.Name == "LogWarning" && + md.Parameters.Count == 1 && + md.Parameters[0].ParameterType.FullName == typeof(object).FullName, + ref WeavingFailed); + + TypeReference typeType = Import(typeof(Type)); + getTypeFromHandleReference = Resolvers.ResolveMethod(typeType, assembly, Log, "GetTypeFromHandle", ref WeavingFailed); + + TypeReference NetworkWriterPoolType = Import(typeof(NetworkWriterPool)); + GetWriterReference = Resolvers.ResolveMethod(NetworkWriterPoolType, assembly, Log, "Get", ref WeavingFailed); + ReturnWriterReference = Resolvers.ResolveMethod(NetworkWriterPoolType, assembly, Log, "Return", ref WeavingFailed); + + TypeReference readerExtensions = Import(typeof(NetworkReaderExtensions)); + readNetworkBehaviourGeneric = Resolvers.ResolveMethod(readerExtensions, assembly, Log, (md => + { + return md.Name == nameof(NetworkReaderExtensions.ReadNetworkBehaviour) && + md.HasGenericParameters; + }), + ref WeavingFailed); + + // [InitializeOnLoadMethod] + // 'UnityEditor' is not available in builds. + // we can only import this attribute if we are in an Editor assembly. + if (Helpers.IsEditorAssembly(assembly)) + { + TypeReference initializeOnLoadMethodAttributeRef = Import(typeof(InitializeOnLoadMethodAttribute)); + initializeOnLoadMethodAttribute = initializeOnLoadMethodAttributeRef.Resolve(); + } + + // [RuntimeInitializeOnLoadMethod] + TypeReference runtimeInitializeOnLoadMethodAttributeRef = Import(typeof(RuntimeInitializeOnLoadMethodAttribute)); + runtimeInitializeOnLoadMethodAttribute = runtimeInitializeOnLoadMethodAttributeRef.Resolve(); + } + } +} diff --git a/Assets/Mirror/Editor/Weaver/WeaverTypes.cs.meta b/Assets/Mirror/Editor/Weaver/WeaverTypes.cs.meta new file mode 100644 index 0000000..d71c33f --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/WeaverTypes.cs.meta @@ -0,0 +1,3 @@ +fileFormatVersion: 2 +guid: 2585961bf7fe4c10a9143f4087efdf6f +timeCreated: 1596486854 \ No newline at end of file diff --git a/Assets/Mirror/Editor/Weaver/Writers.cs b/Assets/Mirror/Editor/Weaver/Writers.cs new file mode 100644 index 0000000..8311a26 --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Writers.cs @@ -0,0 +1,341 @@ +using System; +using System.Collections.Generic; +using Mono.CecilX; +using Mono.CecilX.Cil; +// to use Mono.CecilX.Rocks here, we need to 'override references' in the +// Unity.Mirror.CodeGen assembly definition file in the Editor, and add CecilX.Rocks. +// otherwise we get an unknown import exception. +using Mono.CecilX.Rocks; + +namespace Mirror.Weaver +{ + // not static, because ILPostProcessor is multithreaded + public class Writers + { + // Writers are only for this assembly. + // can't be used from another assembly, otherwise we will get: + // "System.ArgumentException: Member ... is declared in another module and needs to be imported" + AssemblyDefinition assembly; + WeaverTypes weaverTypes; + TypeDefinition GeneratedCodeClass; + Logger Log; + + Dictionary writeFuncs = + new Dictionary(new TypeReferenceComparer()); + + public Writers(AssemblyDefinition assembly, WeaverTypes weaverTypes, TypeDefinition GeneratedCodeClass, Logger Log) + { + this.assembly = assembly; + this.weaverTypes = weaverTypes; + this.GeneratedCodeClass = GeneratedCodeClass; + this.Log = Log; + } + + public void Register(TypeReference dataType, MethodReference methodReference) + { + if (writeFuncs.ContainsKey(dataType)) + { + // TODO enable this again later. + // Writer has some obsolete functions that were renamed. + // Don't want weaver warnings for all of them. + //Log.Warning($"Registering a Write method for {dataType.FullName} when one already exists", methodReference); + } + + // we need to import type when we Initialize Writers so import here in case it is used anywhere else + TypeReference imported = assembly.MainModule.ImportReference(dataType); + writeFuncs[imported] = methodReference; + } + + void RegisterWriteFunc(TypeReference typeReference, MethodDefinition newWriterFunc) + { + Register(typeReference, newWriterFunc); + GeneratedCodeClass.Methods.Add(newWriterFunc); + } + + // Finds existing writer for type, if non exists trys to create one + public MethodReference GetWriteFunc(TypeReference variable, ref bool WeavingFailed) + { + if (writeFuncs.TryGetValue(variable, out MethodReference foundFunc)) + return foundFunc; + + // this try/catch will be removed in future PR and make `GetWriteFunc` throw instead + try + { + TypeReference importedVariable = assembly.MainModule.ImportReference(variable); + return GenerateWriter(importedVariable, ref WeavingFailed); + } + catch (GenerateWriterException e) + { + Log.Error(e.Message, e.MemberReference); + WeavingFailed = true; + return null; + } + } + + //Throws GenerateWriterException when writer could not be generated for type + MethodReference GenerateWriter(TypeReference variableReference, ref bool WeavingFailed) + { + if (variableReference.IsByReference) + { + throw new GenerateWriterException($"Cannot pass {variableReference.Name} by reference", variableReference); + } + + // Arrays are special, if we resolve them, we get the element type, + // e.g. int[] resolves to int + // therefore process this before checks below + if (variableReference.IsArray) + { + if (variableReference.IsMultidimensionalArray()) + { + throw new GenerateWriterException($"{variableReference.Name} is an unsupported type. Multidimensional arrays are not supported", variableReference); + } + TypeReference elementType = variableReference.GetElementType(); + return GenerateCollectionWriter(variableReference, elementType, nameof(NetworkWriterExtensions.WriteArray), ref WeavingFailed); + } + + if (variableReference.Resolve()?.IsEnum ?? false) + { + // serialize enum as their base type + return GenerateEnumWriteFunc(variableReference, ref WeavingFailed); + } + + // check for collections + if (variableReference.Is(typeof(ArraySegment<>))) + { + GenericInstanceType genericInstance = (GenericInstanceType)variableReference; + TypeReference elementType = genericInstance.GenericArguments[0]; + + return GenerateCollectionWriter(variableReference, elementType, nameof(NetworkWriterExtensions.WriteArraySegment), ref WeavingFailed); + } + if (variableReference.Is(typeof(List<>))) + { + GenericInstanceType genericInstance = (GenericInstanceType)variableReference; + TypeReference elementType = genericInstance.GenericArguments[0]; + + return GenerateCollectionWriter(variableReference, elementType, nameof(NetworkWriterExtensions.WriteList), ref WeavingFailed); + } + + // handle both NetworkBehaviour and inheritors. + // fixes: https://github.com/MirrorNetworking/Mirror/issues/2939 + if (variableReference.IsDerivedFrom() || variableReference.Is()) + { + return GetNetworkBehaviourWriter(variableReference); + } + + // check for invalid types + TypeDefinition variableDefinition = variableReference.Resolve(); + if (variableDefinition == null) + { + throw new GenerateWriterException($"{variableReference.Name} is not a supported type. Use a supported type or provide a custom writer", variableReference); + } + if (variableDefinition.IsDerivedFrom()) + { + throw new GenerateWriterException($"Cannot generate writer for component type {variableReference.Name}. Use a supported type or provide a custom writer", variableReference); + } + if (variableReference.Is()) + { + throw new GenerateWriterException($"Cannot generate writer for {variableReference.Name}. Use a supported type or provide a custom writer", variableReference); + } + if (variableReference.Is()) + { + throw new GenerateWriterException($"Cannot generate writer for {variableReference.Name}. Use a supported type or provide a custom writer", variableReference); + } + if (variableDefinition.HasGenericParameters) + { + throw new GenerateWriterException($"Cannot generate writer for generic type {variableReference.Name}. Use a supported type or provide a custom writer", variableReference); + } + if (variableDefinition.IsInterface) + { + throw new GenerateWriterException($"Cannot generate writer for interface {variableReference.Name}. Use a supported type or provide a custom writer", variableReference); + } + if (variableDefinition.IsAbstract) + { + throw new GenerateWriterException($"Cannot generate writer for abstract class {variableReference.Name}. Use a supported type or provide a custom writer", variableReference); + } + + // generate writer for class/struct + return GenerateClassOrStructWriterFunction(variableReference, ref WeavingFailed); + } + + MethodReference GetNetworkBehaviourWriter(TypeReference variableReference) + { + // all NetworkBehaviours can use the same write function + if (writeFuncs.TryGetValue(weaverTypes.Import(), out MethodReference func)) + { + // register function so it is added to writer + // use Register instead of RegisterWriteFunc because this is not a generated function + Register(variableReference, func); + + return func; + } + else + { + // this exception only happens if mirror is missing the WriteNetworkBehaviour method + throw new MissingMethodException($"Could not find writer for NetworkBehaviour"); + } + } + + MethodDefinition GenerateEnumWriteFunc(TypeReference variable, ref bool WeavingFailed) + { + MethodDefinition writerFunc = GenerateWriterFunc(variable); + + ILProcessor worker = writerFunc.Body.GetILProcessor(); + + MethodReference underlyingWriter = GetWriteFunc(variable.Resolve().GetEnumUnderlyingType(), ref WeavingFailed); + + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldarg_1); + worker.Emit(OpCodes.Call, underlyingWriter); + + worker.Emit(OpCodes.Ret); + return writerFunc; + } + + MethodDefinition GenerateWriterFunc(TypeReference variable) + { + string functionName = $"_Write_{variable.FullName}"; + // create new writer for this type + MethodDefinition writerFunc = new MethodDefinition(functionName, + MethodAttributes.Public | + MethodAttributes.Static | + MethodAttributes.HideBySig, + weaverTypes.Import(typeof(void))); + + writerFunc.Parameters.Add(new ParameterDefinition("writer", ParameterAttributes.None, weaverTypes.Import())); + writerFunc.Parameters.Add(new ParameterDefinition("value", ParameterAttributes.None, variable)); + writerFunc.Body.InitLocals = true; + + RegisterWriteFunc(variable, writerFunc); + return writerFunc; + } + + MethodDefinition GenerateClassOrStructWriterFunction(TypeReference variable, ref bool WeavingFailed) + { + MethodDefinition writerFunc = GenerateWriterFunc(variable); + + ILProcessor worker = writerFunc.Body.GetILProcessor(); + + if (!variable.Resolve().IsValueType) + WriteNullCheck(worker, ref WeavingFailed); + + if (!WriteAllFields(variable, worker, ref WeavingFailed)) + return null; + + worker.Emit(OpCodes.Ret); + return writerFunc; + } + + void WriteNullCheck(ILProcessor worker, ref bool WeavingFailed) + { + // if (value == null) + // { + // writer.WriteBoolean(false); + // return; + // } + // + + Instruction labelNotNull = worker.Create(OpCodes.Nop); + worker.Emit(OpCodes.Ldarg_1); + worker.Emit(OpCodes.Brtrue, labelNotNull); + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldc_I4_0); + worker.Emit(OpCodes.Call, GetWriteFunc(weaverTypes.Import(), ref WeavingFailed)); + worker.Emit(OpCodes.Ret); + worker.Append(labelNotNull); + + // write.WriteBoolean(true); + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldc_I4_1); + worker.Emit(OpCodes.Call, GetWriteFunc(weaverTypes.Import(), ref WeavingFailed)); + } + + // Find all fields in type and write them + bool WriteAllFields(TypeReference variable, ILProcessor worker, ref bool WeavingFailed) + { + foreach (FieldDefinition field in variable.FindAllPublicFields()) + { + MethodReference writeFunc = GetWriteFunc(field.FieldType, ref WeavingFailed); + // need this null check till later PR when GetWriteFunc throws exception instead + if (writeFunc == null) { return false; } + + FieldReference fieldRef = assembly.MainModule.ImportReference(field); + + worker.Emit(OpCodes.Ldarg_0); + worker.Emit(OpCodes.Ldarg_1); + worker.Emit(OpCodes.Ldfld, fieldRef); + worker.Emit(OpCodes.Call, writeFunc); + } + + return true; + } + + MethodDefinition GenerateCollectionWriter(TypeReference variable, TypeReference elementType, string writerFunction, ref bool WeavingFailed) + { + + MethodDefinition writerFunc = GenerateWriterFunc(variable); + + MethodReference elementWriteFunc = GetWriteFunc(elementType, ref WeavingFailed); + MethodReference intWriterFunc = GetWriteFunc(weaverTypes.Import(), ref WeavingFailed); + + // need this null check till later PR when GetWriteFunc throws exception instead + if (elementWriteFunc == null) + { + Log.Error($"Cannot generate writer for {variable}. Use a supported type or provide a custom writer", variable); + WeavingFailed = true; + return writerFunc; + } + + ModuleDefinition module = assembly.MainModule; + TypeReference readerExtensions = module.ImportReference(typeof(NetworkWriterExtensions)); + MethodReference collectionWriter = Resolvers.ResolveMethod(readerExtensions, assembly, Log, writerFunction, ref WeavingFailed); + + GenericInstanceMethod methodRef = new GenericInstanceMethod(collectionWriter); + methodRef.GenericArguments.Add(elementType); + + // generates + // reader.WriteArray(array); + + ILProcessor worker = writerFunc.Body.GetILProcessor(); + worker.Emit(OpCodes.Ldarg_0); // writer + worker.Emit(OpCodes.Ldarg_1); // collection + + worker.Emit(OpCodes.Call, methodRef); // WriteArray + + worker.Emit(OpCodes.Ret); + + return writerFunc; + } + + // Save a delegate for each one of the writers into Writer{T}.write + internal void InitializeWriters(ILProcessor worker) + { + ModuleDefinition module = assembly.MainModule; + + TypeReference genericWriterClassRef = module.ImportReference(typeof(Writer<>)); + + System.Reflection.FieldInfo fieldInfo = typeof(Writer<>).GetField(nameof(Writer.write)); + FieldReference fieldRef = module.ImportReference(fieldInfo); + TypeReference networkWriterRef = module.ImportReference(typeof(NetworkWriter)); + TypeReference actionRef = module.ImportReference(typeof(Action<,>)); + MethodReference actionConstructorRef = module.ImportReference(typeof(Action<,>).GetConstructors()[0]); + + foreach (KeyValuePair kvp in writeFuncs) + { + TypeReference targetType = kvp.Key; + MethodReference writeFunc = kvp.Value; + + // create a Action delegate + worker.Emit(OpCodes.Ldnull); + worker.Emit(OpCodes.Ldftn, writeFunc); + GenericInstanceType actionGenericInstance = actionRef.MakeGenericInstanceType(networkWriterRef, targetType); + MethodReference actionRefInstance = actionConstructorRef.MakeHostInstanceGeneric(assembly.MainModule, actionGenericInstance); + worker.Emit(OpCodes.Newobj, actionRefInstance); + + // save it in Writer.write + GenericInstanceType genericInstance = genericWriterClassRef.MakeGenericInstanceType(targetType); + FieldReference specializedField = fieldRef.SpecializeField(assembly.MainModule, genericInstance); + worker.Emit(OpCodes.Stsfld, specializedField); + } + } + } +} diff --git a/Assets/Mirror/Editor/Weaver/Writers.cs.meta b/Assets/Mirror/Editor/Weaver/Writers.cs.meta new file mode 100644 index 0000000..3769f7f --- /dev/null +++ b/Assets/Mirror/Editor/Weaver/Writers.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: a90060ad76ea044aba613080dd922709 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Editor/Welcome.cs b/Assets/Mirror/Editor/Welcome.cs new file mode 100644 index 0000000..14e57bc --- /dev/null +++ b/Assets/Mirror/Editor/Welcome.cs @@ -0,0 +1,23 @@ +// Shows either a welcome message, only once per session. +#if UNITY_EDITOR +using UnityEditor; +using UnityEngine; + +namespace Mirror +{ + static class Welcome + { + [InitializeOnLoadMethod] + static void OnInitializeOnLoad() + { + // InitializeOnLoad is called on start and after each rebuild, + // but we only want to show this once per editor session. + if (!SessionState.GetBool("MIRROR_WELCOME", false)) + { + SessionState.SetBool("MIRROR_WELCOME", true); + Debug.Log("Mirror | mirror-networking.com | discord.gg/N9QVxbM"); + } + } + } +} +#endif diff --git a/Assets/Mirror/Editor/Welcome.cs.meta b/Assets/Mirror/Editor/Welcome.cs.meta new file mode 100644 index 0000000..9062df0 --- /dev/null +++ b/Assets/Mirror/Editor/Welcome.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 180619c3887314f56bf396769c0a23ee +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Notice.txt b/Assets/Mirror/Notice.txt new file mode 100644 index 0000000..5eeaf88 --- /dev/null +++ b/Assets/Mirror/Notice.txt @@ -0,0 +1,123 @@ +This asset is governed by the Asset Store EULA; however, the following +components are governed by the licenses indicated below: + +-------------------------------------------------------------------------------- +-------------------------------------------------------------------------------- +-------------------------------------------------------------------------------- + +Mirror +MIT License + +Copyright (c) 2015, Unity Technologies +Copyright (c) 2019, vis2k, Paul and Contributors + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. + +-------------------------------------------------------------------------------- +-------------------------------------------------------------------------------- +-------------------------------------------------------------------------------- + +kcp2k +MIT License + +Copyright (c) 2016 limpo1989 +Copyright (c) 2020 Paul Pacheco +Copyright (c) 2020 Lymdun +Copyright (c) 2020 vis2k + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + +-------------------------------------------------------------------------------- +-------------------------------------------------------------------------------- +-------------------------------------------------------------------------------- + +Mono.Cecil +MIT License + +Copyright (c) 2008 - 2015 Jb Evain +Copyright (c) 2008 - 2011 Novell, Inc. + +https://github.com/jbevain/cecil + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +"Software"), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND +NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE +LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION +OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION +WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +-------------------------------------------------------------------------------- +-------------------------------------------------------------------------------- +-------------------------------------------------------------------------------- + +Telepathy +MIT License + +Copyright (c) 2018, vis2k + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. + + +-------------------------------------------------------------------------------- +-------------------------------------------------------------------------------- +-------------------------------------------------------------------------------- \ No newline at end of file diff --git a/Assets/Mirror/Notice.txt.meta b/Assets/Mirror/Notice.txt.meta new file mode 100644 index 0000000..3281bd8 --- /dev/null +++ b/Assets/Mirror/Notice.txt.meta @@ -0,0 +1,7 @@ +fileFormatVersion: 2 +guid: 1a7b49ad188074707b004e7bb8824857 +TextScriptImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Plugins.meta b/Assets/Mirror/Plugins.meta new file mode 100644 index 0000000..9504239 --- /dev/null +++ b/Assets/Mirror/Plugins.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: 05eb4061e2eb94061b9a08c918fff99b +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Plugins/BouncyCastle.meta b/Assets/Mirror/Plugins/BouncyCastle.meta new file mode 100644 index 0000000..e064e80 --- /dev/null +++ b/Assets/Mirror/Plugins/BouncyCastle.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: 31ff83bf6d2e72542adcbe2c21383f4a +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Assets/Mirror/Plugins/BouncyCastle/BouncyCastle.Cryptography.dll b/Assets/Mirror/Plugins/BouncyCastle/BouncyCastle.Cryptography.dll new file mode 100644 index 0000000000000000000000000000000000000000..9d9b6ac33cf72032845c705effc87341911f0b31 GIT binary patch literal 6954264 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

R+F83~b0b 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ⅆ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

v$cr!^O=D{sjz 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

9&SC!B2Fe(3k7FN7qw-xl^Fa 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%0Aq0h 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 z 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%0AKZckPw@ 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 oN0C25 z^fz;_)PW2}FRZkByDf| z)ZU+pyh>Yh9;K47C;p+bjC9Ni(S)LjREfFSGt>t);~qs(oJvdixv@#CXi7t*DMd10 z#qZ7Lv3x#z>V3=Uky9^SCN;-bU@i{aM8&-phjP}h+Vkl6wYomlQ3Y?{;9jn*58PNM zXe`P=ke)-J?+?>8&9x{i7m6y3Co&qL?8>SIZACzF@|7 zt7hDvLJ9=A-*OS8H66E-IvUoo@tR9T+Ov zIYiZvQoKQL=*`ANwV8Xz&_`GS2v-ItfP!l6$NT;)_lI#M%WLQ*SF4q;)+lMy0{Il;*4jcQ?h&?AX(l z(fNE5YEV`HHL#kKP#xE>mP8!&VI|ww+cDWz_St?z__$p;m!{F3q#b1W`2w$QX{r*8 zyV?G@Mp7U7sY~E-fQJRExyGEn#=*J{BWvKH3ehvOv=2@+L?+iJ@LGlFl%YpVw}x?h z3>`Bon+;XEU*ovN2KEbrUcXW_O4EY&%55^P19rzEw=3X6b{{E3dL9}kZ5v_w2&*qQ zQsdWcF-8b_yNc{3@ta&t6*YzbPe%00@C7*(F)I;LPJBUqIY-VHG>DP*kK)|w-25A& zrl=1=I_8Av5wx)3tZ~v_FFb>`=E|xn{dQA`ZUOR4&ZCp~zZ;u!hPJFKTs#!Nm=wr` zNJI0(4~g&Rz~h(9f>xKG9tsfFaPaoHaWa`s1Sg)!lpXAPlj$a$$;phUp%^`bP~45O z&;xZ!@^zJ_@OIrr#v^DxclGMyZJHxZ(3 z7)!)c{=>_P+}Vi_n{s#mZlL&032AlraOiS)VP`SYdh__Eq6>{t!_~xTiP7+v6g4+) zUjgN^>j=WHQD9Z-bTjEStV#uSHExS>lZ^Y(xShr&z{4!MgN-{F$mLuGU1&bM_fZX~ME3Z^gdvVJ>3dnfnQK?|JfM+;3KJb8gn3%`P7egTaQ zzr2h6^g_1hR;tcQX=?Qf1?Yo1iZT`m%2}owN6s>c=Un5(Hv{J>gLsRL?!hh>@kZz@ zRyQ(&)J{@VrnSsq@!bS|AwKxx%cK6-LrA$~*owO@eo;}lHVg0@BU~=}dX4yaWW0(E z)OD<`d_%MuCu|bxR-l4hov&gmE^orc?d6txljRl%^Dpi*Ecnm!ZzgT4D8HPQNw-uc z{?({VdZ4?a&Dh(!-_^n%aipTXSm_J5?U`_Z`kU@#(|yBq&yG-y&89nNo_MD-DIIGw zu{R96azUrNEBdj8q7|rp3B40vo(kHNs_33{MW0}WETLam`Yy^;D<`mzm(VQZY8Yzz zm|Cf7ad);7yE&GNB$=s}Imorg$D%NQDUkA^Nc zMAMbaT&HM3A4Q`Lm0hXa1E#wh_w*$WFVOY)O=D@h^={UdGdQ@dF8tKge{r<78{x=wrFKMroWD90iAOwSwRA#4pR0!94($d-~ZBeamPTPKez1LNV&sBupp3 zWzYfmf%js4kUXi_n8?RIJ zPz`vMl3m^oZ3anedA3~kl$PY6 zX}FKcT+&!QS38UMkR_!rO;qmkI~9F*hobhrqN;!4bd#-o2vnERv;7jN8KaTlIxzYG zuN`$~lrT$wAFZ<8tQ`d^<#~4L5@On4C{Nh0>CZQdlP5`LKEo~+`(|QkVv;7 z^|vy&;W&Qb4JD2d@2)WU%zcd);9R}ols{X~A;#Y(Ei8jN0!@e9`Rn}Ln$DnJ&~UE+ zc;wcE@_pIG??~IgmvG&%ua(e0afbj1_d%}LQ8{1#5Z#B^7imp&czW z`U+CdTvKo#F=}seO>iIB^=^1wMk^{aK~bGly>}QxFOwD7{>F*42UhS>^&~0NEdQcn z+WyoY`gC9gUdq67h}0fR-|P+AkU$4vFGL%Fj&l0kuZOvk#5+$|-^=f6J%^O;MXh>t z)nn+*e2N@j;T`w}zeEV#Od5m{)5+o6`h1Ey*OA)Fr0WcIHM#2oIqZo8%OTR(@YeGw z9h=-;2v>vg^-GL0alY#6Ek@S@xnCIkZ`|%WQu{HgJsNG7bsHMGr6=l=xwJkq=EUf& zqy+j4oJT_&V)qIUp+^USiU6HI-Vta`V!3}{FU$V~Uj(^w$@0I3=Sff|?l=glhSirt zF^cQX{S@OQr^ThYEMklQ?qQ66nIvC2W>DAQ?ol#59+mG+V-#8yV!vnxEypU&SIO9A0Z!| zk-iAUOUUK7J2>2R!L7QRIMn5%KTrl;zfyj=H-nZglJl7?zY%J{-L1&-8v;4+Ta3b( zIo+)_{8nv>?7L%hq=CF8kV(J2C$B+d(&ioV?i)CGAl=Iz_#Oa zyfS{(kLA*F*5MHP(P~*+Wcgn;7T;W!e+zt;t|YU3II#oNe~O?OrC%d&%i-4q3rTD- zx(atD#9o!6$~_5P;cmS^x#X$JJyt}yGiZNq=bGi0!P%n3I}z(TK_dd>QSqQ$@N0cD zMD7k6@Vv;~LHAxQTqbqfDO}7-DCavTT0&X=kr;7_XZg>d-MX^R@~^>aM9|5w=6ok= zPijVg89d8hj1xPN`#(ik`!paL!Y!gRzI<^AznA(zC_wc);mZx?R=p(Ug6}W;N?G9@ z`rvFV+dtk=+xXJp^f23>-BP(ie@p7K{o71qYp~DYXUjEjA#4vM(~BZc7U%X;N22*1$kWLuvd2!ag2eh*u$p*11gkLYXd# zmKk?X;Q7p?H;QNv_@cO?mjd5#CRGbUW7HF)fZMsoXlqR!X*S?Sl#Drz(7Odaj=Z^k z8N->HqPfN;7&mN)c(zgHUTxin6dP9Q<9G+YYW`!h;v>1un)@)647e0l~xEBx0lGju&@cGjy>HQcx8mqBSFv0q%_PBdodm))8JrS!|Oj7+dqa}hK1to zW7}!AyiNC;;u>v-U%ERSWcw*-kHz8#cu zIf1p08wulS5zD(dAMsh}*w1)l8C=dBIX~t>aLH753-&#XzJ(`C=AP!5^90Sqe()HF zI*o7hXgr6}`#)>6eP7lz$&`Ln(SXg0)*Dv}eoV14r?DdSS!R;H&W6+L%XR!)9?bDE zDih2-GUuH@`tZ$856wc|S*N#PdmR2$lJ;0$%a%bf(1yy)fb8I-bAnF10e4U}-s! zs|-s1kJ9qr%Ak*xL59VGWXVZZ81 z@_aeU@<*-L9bcK}1WD<-HF}m`&2ky8uOs2uT(MO{Y+3$D8-1pk+=N_ZA7i=Kn`vy_ zdkKnB_v>UwkTc$+mdit!2W14Vmn+^(w%6I>9c}UU&lPVymU|zqN!DE3$Ny8jz1e$ZKvmNIknB+GiGmDE_(ym-dIb0eM|j{T&W+* za&CPpE$4h?HOXRIZLxiuE4EQ=rHIwcO%_`;SIvxNIgR7|dHcv_*ufTC&s?!hWGjDI zs!o_(+gy3O19BO(?l{pDM!#MiVw7`DQ`OSE(MFnvxzcz=#%`nTh$M?K-wa_cah z;;qtt{tnjsj*HPxfj2Kk`=3=#y?HTPkHZ&)b@pteC6iWSr!C|^j<+C0i1>=xxU)1?T-{0lFg`#s$l4KsgnwG4bI zz}&P<@r#Pa`^-6SviMKcYZ{}uSY5lbm>9KMfm1C;YT2XR@a4+MPmO|#-1`FZo#BB9OzqX?W1a+~`iu zzTYh;Sny(<5>E$CbI~?jsAuW(=pmByWs>`iNI54y_=BJrH9#AZTiFrpagHH<9<|3g z$&WxWx*k3Nu~%e1(#KrFNx4xGBll}=dl4I6JT_EzopM)WAK*f9&m$-y+_UmErTU#= zjK0I!nACJlc>SEG9CwM^;B11^qBrb4TAB)%aEhy~Ch1ZO$+V&zY8qT3x!WukGSX5* zYu_$CC9m8?x#Z-wlH=m1M)5duA{R$)Imufo=z6r+?sRDSLVSb099wpGKisRG_~y1A z-lAdjZ#7)`UBXuWyJh!Y!GBIm#M0v44VBcV{$uL%YPdG;`i$J-mv0|5RdEi#RB|>U zsKJ4yv^{49Uc|g*TAfp+_2$uu8}xNlcdJg?Ux(&`a90<;0yp}E_&Wkgf$P)Klhq0= z1pOmK?@!eftoU2ecY*I8-;UTFo5K~Pr-W#7Bay>z33(!{OU(qv`o>6vWmWZRMGNOMXwK6 zGzfcNw~Ea6ued?Ek%orO6ApdfovNbO%IIAib?JWb7T-~!j_~4LRSH^r6t~)?-9MhF zuL8$QBVKRu+FEP%mOV{Nau>c)lyUN>;H40J1+hoZ^5I#J@+4u7h=%MLUi~i@hyeu zBiv4q5#)Y+Gv!*glv;h(h{qc*mm0$p_?_Mm{Zo6vh&f5ldOg~TIY8#Tnz$X<7?yK# zA131q7I0bqkgLUmi+LMw;K(=H{S3v^;=bN)hLQYK2PLz>~Cl6c+CIH^I`_Z`ae&tNIW9gI>QHM9{aURIvH;(KnIv7&%~(zSya zEyqmk@{4;4ee~|atMJ1u3odw2t)l=L1i$Gu25JIj0F7Z;Y%BFis4UB`_F@GgY3 zrsjA--l1%N3cg~J5$^c_W%>0QNgIk$6SO)fCwG(G+u%7-qiM3<#c6JE_sz@kYZ>ky zsGFm5o-IznJsIKRCzSD?(3htsgLK#rF2-Hl(xob_McN4x2$Ib zXgM~PILprSF6k31?p;%dFpj{NE8LeGCbr{D3Igk3`Ea7I9P@IdOpyt(e z>#(?-=#H~mos{V1>;R|SudOw zS{rrN=(JRkn}4M~-U&{x@ghS|AMtrBL{nR;+**`|Xf*K@=`Hjat-)*{Wu+P(J%QOk z=2eyR=(~9bR~^f59VrqGpcD_KH@YuHg~G^7$bK_Nm3Q(;;D~wxxZ!; z-T1FT#pSx31U&KO>;%rPpdlpl4OL0XNt`&rn zNR(s~{>_)UWwkY3YIXT{uuk;o1>@QU=aL@Hw)#!7I*-?2yjJ7ATl;=|e95G@g45>s zI1~>(ANOxHLKLs_Emaa|KH5u8t}W`)&CVez^1I%Zd=0;h`wX|MABQE-Qbzh>hesdZ zBcn1-1Th}$#Y~LT=P>+8Y&kc#0vy@_*66RXmH1jdzF$2bR~7A9?$(B;3X1XFU$@f7 zjTD^gZe+_B0LhKtv;Pl!Zyso4_5A^_bI*0nWXzn$rNMk$j#-6J89IiW%*qfVvqE_c zsgx#-QV|)Fq>#$2M8-nq43&^fA%xz~-fOS*oVeX@zu)iszJI;{eV(<4XYIY$UVH7e zr?AWtgaf{9l|4_vXd1*bQp}+NdZIb@`C3kc@-_x-i=~N4I00y5xka>7A>e# zvmc3X+!@}G`)Y{JD{7#&?U)>58JW2Tzp0X~68lvmG}MK%kBsf-rPw=T`f3P!5jkFP zDg`eyIExH-b35xRMC~wl;l6L|HTHs;{f-8ODB$mq@)uS9gcpy5(|{MOz&K9=<^j36 z9C(vPt-h=d1ux*l{PtVI&L`c%A&-iOiTG8V5N;jf8W)=yUa)sW*NI=iBd@*G=>+V` z;oA7}9OsN12o?Q#9=#c#2@ZarG89C*2QoJ1e z>%<5d=t;K8yR=8Pn zz;3yi$mt1J_aQo1PeQLp&L$rE`7NxK@d}!v(TavB>J1CU%sC^} zqm{|GTZ&9x`d-kMT+(}ft}L_%uolDh(q8-Yw~Dp}@~o&JeE-gVRy4b~$ic#qlJnrw zLR&OSXhGcvy7=G9P>>>zdQQG^K7~Nmf;z=a?z~8>)LL5c;Bjz0-lMy&lNt*CX66;= zZ2vI&#USi?g2eK^hfNr_Sql`ZL-eP{<2p5Or6k^LbVQ(=3@yt)(qs)NUen0R543{X zIYH|OoL)Ps1+@{BJiaf?IW8>|=y5YT=d%1=`?r|?8BWNsKkPVki$Nh;UR7G!j3iw0 z^ve-&ZzPse{HCiJHQ={pn(5v7EiXZe$#;lmZ4Wz#<6Tx1#4~9N+qA(*7o3}Y7km9U z?P}NujIQOGYppnPffjwAr70N8V!n*~@vRl)64XYZ|GHy+(Cn4O8GY5AG9JZz^L{ti zu6e)Ppm?9}z1N91rDI*OrP^cMFJ(*F-642!dUJ_jC%P5I_%;vt`+J+S7QMF3;a$fb zYqq4X;KaH?xN#ejXle~QaejzO+ZtN#RxWU(CfbN~qL~qJ?FRbqbZ%ZF4Qeu8I#V!b z=dpH4DM1tJ2^s_rIP?nky)r5ak3XaJ8gH1!3k{J_Pjfc=^f^UF?9*pt_USVktmApz z4WdB`Y1$^(7s>IyyIoKfP5YJOs-$`xO6uKIiDWo1x-*ds2aEE{ zU`3+qFsTjkutca6##yr`wT0i@6T4)0c{!o57p3Msu7|J-ozWk)1o<&WG5^C9P8;*b z!0I!7CgzVqJVxaak5MgWWq4$?g~^ZCE0_bhE3t*Y-Feho`1=)=slhq3H=weW1LGH9 z6s(qtes=Kue|O<@fIGox?tj57ALYfp zGrB$)_yh-NPnp|N>^k#G8%v$>D|5+rs{ik3MVVnlJ4k3NUucpG-*Uq`Hm&@`6A0a& zMlRz23sI1t@tSh~HMdy)Z*!I&5K{kS{6B)6gZ{fvYi+)>Hy}gs_3=1pB&QKtAwq>d zW&ZGH1ons+{vy=!9XW%#4QDOQ3D96fO!ePt&Gnb+FT^=CQ_rdX3WtJtI3o*xrwPSq zg}eC}iJbE4Kev{wJjVRLV9gmF7V~>RqqAN!W0~;|22vNHGBxD{Kvvh^BJ^$@mZ8de zqOUSFcizF4{#&20l;D&Bz1~E4fMri$1L1JY@=pba0Yxm@Hf-bAR>WlHnXqA{h%Z-vTzkwSi zWBw;@q>K4G+(;MmyN{7^P_!BL-C(RRuQA5^Ze&Ik%yGaAv>EeqEm!|-4&whi>TYAKqgXpTcI)q{a~-XebO0i)y#cy$%+;n9%l+~)Am!y0A@E2J~^WBJ97 z2yDVNsBt%QzzD(Ud9)j&jT+j@g_=7MWv*e?H8`Fbi5Z!Zn2{NY8JUroQHig4ZxrUC z7vLweQYZ69kJ?-i&DBsX#xLEN9HIZ|s1_lSgZLVk@eQYDbSyjKq|T$$Zj|&WtJ^v6 z(X(!p3`RPf<#ry!5CzsqU|G)im`9S}zqnlkz1GMx>5iNN{OAh~#D|v)=!b@WQ8=(@T1-&?3 z&~og==g^CvF-oELokf8=CDgWv<9VyxEWIDAv|JlmwNAUKg*VNuiNsqd>F4sg=KP!H zZ1UrOtcRSkzP}4{%IGxYl#ysS_UClA(rLy8o^`Zn7@}^L7K}Y(%82K$M!&i?3ej(vtMQGMMv56d4y|HNkzwBr{4Yj>!1BO;3xi_* zbj-UMJ>e{U>;rI?KKk=Do{pHG2b#q6Yp z5xTHfcpi0F&~t8QNQ4SzmT@M7rZ}Z3T6PRmU+@>9Ol}N~*Dt{gXge%7mghZ+uD_pk zNr;|958%*1BfU3Jyy9KpXXSMW83TC#hDpJ@HaP8~UGg$eFn12*UUJ52fokgJf7?g# z-^(vvi;CYOLdH97Br!r8;e9g*cfn1^E%&HDoO{P^<`EW|QnFQLJW69MZLQAug4S>3 z)@%gETaJS#W%KQl7k9!3}S#;1*#ks8U4 zZ(pg?cv&-b{~S2LJr>{MHW#3no?6Ae@Hwm__+?z?;1Tuj#^#G|y2DwtY1L%>SY~<; zYdvEVniVX}E7Q?>xET-fXWoOvPAAtd)6#zt`>M5RqY#-|ucgg=&(cab@lfYN33R@i8?mkiU@t+P>>=*e^2pG|G<8lM%?;A+N(zh z9v5UZ2+__7yeBY1gHV5_ynG`ruamT$D&7UzLlCmJr?UP-DB=tKv4GTf~GeS6!gJ})04RW#vw@4!4SP`^SgH5lXj@=nTT&Kb2mNDneK7D z0xN}1-v_xw=}om&YPglw2vv8s8E&+2GKu@qT~7{Mc{V){s}YcAM$)^(ajPwf*=2UJ z0X7%wgKyDi3<^e^2pw>?XoQaHX#b~<_G2*SnSVqmFKUQ;{B0=P-|d&mx{lpKJv%M@ z6CO)(qFS#QnO$1Yz@KSf%ZpWC>#E3>d&Jk zZhh6G`pAK4FGB_xc{K&q*7;j*MUOiV8tzzi=dCGC(pog(HfN9r`LaBbE zw^)YYC05_?vbG{u?H%{HVZ)U-=3i@L#{83-LS`7)&q&v`5C@Zfs!qHn9f8$jsFk8S7!5ZFA9Ad=tz<&~R=xB;^>9TTowj zwjky&X(+VhHiBS+*fzpD!FdFg#yrooTg-3KNKkVvFPy|KbRf=Ta=h~u1yx2mrj6+! z2n(Z*wn|f!sU)=anqoBG(%`fQO0eYMo+sD$WBw3$SUA+Yl))&NSqH5k^Rk$~#d)4! z^E=k!06>B8kPFsI&Z-|4%)IIW@Kl>z7-g6B$j1 z|BBJIy&^)lJ;#k)9{q^j z7(64r+uia7uVgjRYuC<&QvE^hR>zn>8aqf#*>cgFgJs+gQpi8z$J!p|<{(R5Nv!vF7*;ueg zB=ZPq{a{9aB9XNjEHbUD$ylM}TDx$aXv{yspOMZ8-SA)LFFW>maIY{g)H1qPNAbPu zW&g%Z4NcPZvy{X>jyhfZXa7!&lV?sU35N@za(LmY1k{6mb$ zS%SE6tccLe?2bcU(fm&9e|u@XVOqAXHJLx$a=1tQAj2_tG41Bjsoz+hVV5{7&7-#1 z-NvCA8%aDfUuW8THDs>)Jv7K}&^;QdTBW@D4u4%NT59FH%mMV~R6%uh4QQl0;}oK) zt)=%&QeShhuV4mlN;eV_^B;6pOU!>?$K=UMJM3s7THVf7l?G~ck>Zh6JPI}|5EUeobDUSJ*HD0hoDA*HY z>~roF!M-Y4x%lUt4fpXoD%v?4o!^Y${A4XKOuI00n%P8{Rx6TOYM7Qn?oA5Z(5mB=)+GRo-Yje>$Rl%rf-MM%nvTQPB$ zs7Zm{!r;pIN+bH;0Hr5#pw5 z_?iv(iTV;D?ydyQNJ$2gHwhD|w(C(bzliGWv}EW3=v~%?32wItX2;M&ruA`mHuMmq zlF%EBRzMFi$_PI-qjAtfjAla*F**!CwLy?mw6qyR@n#r$qv15gzB^)Q@wz>b_MOm< zrj#M_T?(FMGVP-F0Mn{W>#Hp-QWxYLvL)hvWJ<)yl!%cj5hL?owl?LzxE)pP`wVK| zmsI<{sp^uxYNMY~tG*)2YI2VGzFPImG~Tg@gx;s|MyM?>V;*zQW251ok>Q?^;hvG< zp2t<;K0?BMgoJzSE_d8VNVtcO%yEU=mmT*J67C};+~Xvs#uM%%B-}?xxR20}8n16< zE@gz?ccqL_=T1y3NjK;YoYOgZuYH7u6qgjE2q+HanDXQ(ZI76J*Q}qqScD-sV6CtG7FNoov?%R zJF%t4Y!&qGL5XK%m-#DHjB5xlz&foGqDvmXP#dD9P8WMr{A;#aSYQ1Jof9wjE8Q6X zpL#%Aav#Xwzs)86e)NCI&uAL17o%wy8BN3Jzs-I6e=~ZG|GRRvp!7K~`t;xQU-RF8 z>d7%bAN+bIH0IxkxjmyfP7B2R-<=kSZ~g!Ie@*Q&2c~uznesBaR==hRG#A#a+${kAcK>Ah z@nU*<59_sPZzF5Co!p(ui}`XYFGAUyhUu`iGR|TKblRfa&NGIyDC1=Yx#ql#zrpOY zz_Vfc11azpqC*~qamw_v&E*+lDuW?pq!Ig=5GM|;yUY+rF3iElIJ zi@!5OX?bwPzQX+_>J3fH&no^?yrJN1{=m+OkeN&J`cYNbG>qQFE&)clv75!9Kwd)j zBrsb+X5EjGS@&Zkc6Nwl=UIrvvP2x{Vv}EBt3;@08Y5U*`AV8;j2=g zYEns&1Mxjzti@<=Y!!^>@Yb-8!kmF&WNd0ie>D{}bD*H^BLr1@Pf!u`cuw&uMlilx zX>E6roCP|XX3|-7q4V+<;xfpeNee3t^Fc;AZxmFdxr9Ci&$|hY`PrZ2(GP2j7~hPP z@QjMBxl>1F9Nh69Zl}1#g#Oq@>Y&fJf-*WEMa=K(?g&8rt>K(;%0NBQ1#goSdut1l zwKkl$o4c&hkfvl2AiuDa}cH9o|Mo_8hXEm?*BwWn``LTEhTM-DiXR= zLvPiz{ijOk3=Pe$q4QyZGFO8%^r+@swJL|=4HQ?RD2;aIh*CGDy`W{w>goVD?&v@M zQ0_bHKfc$03{vh7YiLtVJ3_f%sG&tPbcJ$1Mnf-X&h;Jl8L%6d&!n4uxpF#v=5THq z+~R@R1n)n%mX?85;#6%mNQ6h%h6Zb6I7OT!vzYogSz=DW<6Pw_xl?DoqF|Nm5Hu^> z7Q0d;g`Bv?Sr6>;$z>(cp!`7C$BucjkwmO+y1P3PY0*BuX*rQXKL|1wGRHIeijmxm zhj+hWcQUPhVTrc@a}B07LJcvJ-L8px7hKvLnEkPwLVV4Mdh1mpnRj?O^z0Eq6Auge zpK=xRUo0b@yJz7g;l4E(@>du&6!Yh5==&PFAAO5MH)!Y@4c!9iNxzW%gxwQ%V zB0m!^iR8lP)J+OVSRU3OkV1FQ6ITBhNebx|>8FTN@4whCj?&C4f;uT$s^}3#XBBN# z^nycJ|Lw)?8~=(@P#Yp)Ufex4!5tscEAWP@=3>?yjQk-#ta3A2sXORC!>0?M@akMHlI^>E`FUXKVc=yY3g`4Lb2ObFr9))1@n==x) zowAOgAcgV18D8KwtHft1;`4i@D34KTy`FN+n>6)h^-I84#2 zXg`h$)2)`)5T`lr0E*JsL0kt>8VQYLY9mTJ5Ahruz6HhdkO9rwV`s4 zgGaYx=ag9!z)f*`5@@PLe8>)29}hT`y)&5#B|4Crpb$!~QO43v=5WpT%Qz=?A=hVMC=a@Oc+b5xg=ccLI78 zb?>WrRO%qtsYi`7C(>&B-zQg~M7DpJ_qMrqFSqCV3nV8g>HE96#&Of$fe@`j+Eo7y z?3rb>?H8eKKcC=e9Ua1(P(R`17E<8t)#VAa&2qoold_$e5~kk@nNprsB>Nq46N#q1 zvpH<{tI|rm5Sd)|*-(=UqtU%(7syCOwR4KrJGzQ*H%XhnMuo!klg;nzG&l|ZD?CT( zUF<;IVQsx}ie6PzzpsRrRaDKPpkAVM{65xy0fOdoJSW=vI|8n-(-8W=oRdqN`;*G^ z<$Jhx*-mJ@ONhs{HbLvEEcyrE(_umx2`?d%`b*LKS)-KHS-8K@QP63J z@P>IOrltCc4n^rcMg25Iai#t5>oiJ@G?z}Ab55l_tLTYuq-DNS)Kk%Wik2&Ct!RRx zBZ@v!bXrksyx+sJ(N$4DMdKCCRy0Y`;|?X$rO9FX9qpE^_t;>at$3I&freF&j(FF@ z&c!=66o+??isj9s98PWW*e<^xn@(MwJJtkcF_(yG|^=Pq6>(LRHpGOhL3wD2E z)Zl#&BH2+YgTBSBH3sJc7)@(0X!qNKiuV(Aw5*`F+6j8&O+kmStBG@&haE?ZzMU&5 zZ$?2+O%zn7sc>+-iJ)bQy1yHCxoizd3N)6ZmC^ssxrJ$A8itZLKy8GnT^~VLo(fYl zOEdLsS|&`}J{FyrjCiJAN~)~kmPl6{5o+yf1M60~GV)ni8fV7G;B9&$sb@c}k@2aYZSx1t#8L{+1VMpSCHEV@}6b z!OXDS?v!n30zGGQnf)i*3?X~(+XR~;4{FlXxJSoe1u-fIead6XxkrS*Ysf$gr^P+vUtqtjjkgdZw(+JwvO6cx4A8i)KC&rxpM~vI*rZ(> zV*3j3yY|4YWE*-HtP!I@!qmti*c%wnxmUDRB=JIV@eYg&(Q4!pqE)bDk}S%0SZ2Zv z4oK}*!zpaTUx=Eyb2cG(NpR~d{)-(^4tez9A^vZot;u!BFOfPA_U{X zjQK~4InZ@iq3!z<=sHVl2ftZ9i=IKw#em>@#ZK89E$z#P!c@j0v4PpXGP~PS{b_h# zts+A4vSDjTltnrEC0OLyH?vJV&-x>(*j(-(Afc0T@LB!fzP<=$`&8Pa6ZVF3s|I>} z*G2B<;1Jd(w^2ewR?aqc4^a*L1E(`z5s4T&T2kBt%Xf!u)h-&k0k>%JKQ?L3o3bU+ zBx|=1IU}nmC3-S1c-8MM&IS8G9j6}c?!|o{XByJw>S0~u``vjAVI%5)175N~Q8HI% z%riVkC;>D^!;yl~wvNKfD@xn1w3{Y#C}!oTgIjIAh?c^=$@!$@C*bK|&rS+zlE=$G zK9^d%LA|Rl)Dv5@S6->{RvQ?_{5u_uXZelsw|FbO2gYAROZCgGPjJZCj!c_Vmn@3; z6Sqlz#cT5H1m_2_>x#X}kA5Mjz*yOjxdCk+%ynb<2cI=!Wahez%t;V~(68WSG6*jV zjNyBzu+yX`c(b(A&@@I)@xJ;v)(2s_a)$3fOeXWbq)8hfv<22pIcNDBPCZ}qH|WV5 z5~wZG;@l@*i!`zuUqi<*>KYDG{c#w#7!|@;%V+_1M>E<2@3}+p$uJtN@eW{oW7>@v z?HQfK_{QjcjDw7pOcHb*_8Bql7<}-I3TwP8r~{^T$9T!;l+t=(jnB|LYCSrEIsxIt z+!rDnJHM2kT=@jASKtkWE8?+{6O1?++g?1@F-R;+;=#Q#W6p)K$NU2~+z(Hnt`h17~PK(hm6iadovo2SudkxjGT-vVus6T5#}F^ z=8h8773E;sXPDK50XX zFXc;Zxi(V$cQ1r(z2IhmXM{FKY3E^wnOaNrzk`*)=v$?|rMY+*O*!_d*2mvTYHG==`b3Uy#DAlk`Md&+f`LeHD_JS2TmUp_pmXljAjr@%eJ-$Jocs zKCNWjP0DCL^sYg;Ke00ZH`PD4OneW+AumRrQ~fa7oYA%tg3jVbQl=GsjcH*!$1ya# zSc~!+xet?^jSN!}tZH%S%~K_p0=op=hVhc~%LEN#5capP4%5T7yp>a>Hy)eGDMC~a zBeBtSxM#6(0u8iC{ubW~se2?vfz49SLCXaFGU%(us(RGsxAiRRx)8mM+0zJ1o1|#` zO`;FXNcRLnv0EgS$6DNHemkSE-VP1#mYdVX_l2zB%A`&82X7QqYN?=+5HSw@3YwbH zH=j%B08KIXh=dM>eb4buKwB_s2c5&{yOx4_4U%|A6+K;3Xmj%j%F;_xjOZ@^Na`%1 zn=$rq&b<~$Xm!jwnDzkXjf@)oEb#`QPMP+pq8Y=5wi>5RICOz42iFzbYlpUnX`HRA zjF}QFiVqzR4xYE6CHjUOnu=K})2<8?^dQCnLrd1a8s8qB?`OG6^?i(6M#5743s{e5 zv=p~#Fv?g<;!XHX&|eyF;l~p107g1av1+oQziLW~m*xp=k;Yr|4%6bL_*!ZANO}eC z0!H65W3opjXTZB^%VuP9A`os_a*|l`KS*Nl%aWpHjQg8M!M#kfuEDngzhiSY{oGhV zxPyI)jDA-zlCT|C0{8VzLn!=V=rgk{y1NHko7mp~^dV^Qxw&{Dx`4Fi-e1gEVaf14 zR8ye^*q%(p=**}UQhZ|nyS`eO7FqP!Ag)uCcY?e;F)&9Wt+1iy&1}PgXDyy@EXwId zXOC)Qw!>|dR73RI?--9*BQ1q=GMetRPpV&Gi_mU`T$xbRecKRivN<1y-rWj>^B8&lnc`@7R^&6~vfLri{jrZ?TU{{H@k+cHmat65s7L-SInk3K#OAGYwVvq0f z!VYK59C$_*fd;u^<9!O#*8lQ6LA>`Z(o`k)6|yK-x}!OPlKF{zatel3V3T z_3zWMaokjq#GZ;$6_r&~>PCr|M^S#aCW3p)-;>ZHiq1_F+OQ3R`cG%%Q5bF6%W^7h zi5=pgnR>?h#Wk%Op*_>Xc9itg-t{PuakC?Udqt4;MT~Fe3>IWo$7zw05KS5=qwd=d z8Q%kLgRoo;M(-YM(M`~LW_0$*Afx|0GNB_7iZj89xHrzCL0^Yx0uc59^_E^M7Qp|7 z(+E8YtBN)7#4=dH!awkGH25&mj`fN?d`nf7PTtA1RDaPKsqxJ%m>1lbHCW_emTH>H zs%dW2)~Y{DQal9R&bn#lZGvubwBWvL_=4(jXo&7n`*h~bLVMZi`&9qY?L6;J^(QO( zv?S||6nf}Gte@EW>rsH0=3z79MtNU1T2s?rbeD^Z4(um&9l@yetB%WodR} z;q7$32ah^$YFH8wz$*@!zogX36G#29)(|#x`p@+vxXw7d0CB7r5U_Oag z9kw2)eNkz5q1~7kf*devpgH@>{bZ%h-XJ+&Qgn;vQciQ}sc4v@Wg4${1^L^B6Ov!9 zWGUNr$RG34e5S-Za+jc8iu#R|cqQ6N=(nnEGj);BZ`_WBR6jFxlgT-m=Kp|QjgXvV z>pA(%%23c3qz8DkW{~uh#qiFUwAgh3`CDpJ)XNyAFM&eT4?ShAMQxx7*(x{!8DeyU zlR8ej@o#CP^e|4XZcT%>^KZ1Y9C_sB26%MvQ$1(?f^rY?SB&=UrP9M|WeJe`D z{pee#hdh;bPo*8N03qIwmaBgoPq+$Ez>EAhLU*+jyLeDtZb6(MD$OWDr7_DY17B&N zOFViCUPNOfMJf3hECYl_sY%8Ji#*B+WHfpy<-SxL_o9*T0uE-@rY$2h^^*`CL5Y&- zy0_UQmrOZ;%&v%JnudOP!iJg`Yglsn{synOtph1ryuM1m^~E)3R~(wzrnojV$R%jEfcBq|xl`8gf;SYLobumtfW|0~{qJMw@hs1a zdvgt;twU^um((#JL^1|o1XHVC?mkJTuiY5s#i8yvW5SlNX!&@#4^pHb8sw4}c47g` zbNW5S#4Gwgif8;tyl2OFgc+HAUyRJFWsEk%Rw-d~HvVF!nOD4Sva~E&F;j<($M0z~ zH@TaYJyhtb1S*SoybF$LcVGvdLGdrZrgiT9$9~d3(t16t!XMZxgdU0$K_TR2{~_^0 zb}wht(&VL_5Cw0G$s1%L>X9{pK0?FuoxC+|iA)b=PR-nuLrqrmdlZF+XalV3m00&l44)5%m1ecyy8Q)wU`qb9(Xy3O{FdGKR0y1Y;R zaeW8gE#gsm^!Ph$ybj3pd&Vb`$)V`|Ll$Il^?8{jc%IniR>j0Q&$q z-cppKnGH4T&MhrkoFJTb!EMA3*s_HXdY}F873|IHW>Htz{H7_8L9r+UpW-_K*I7} zVcRlTqms9$QvKm-XE##|`F*A3QcHSq4zWfW9N?VUMjCGGpfy$$M_TkKP6>^*Xt=A% zRR7l1!f6-K4A0nQ3tuE7v-6QSu1>dl!c63tRE^S9p!&d}NiN#I=H+ zbMvTF|G3gp@i(ruTQM#$nyB%Xg*cQ~H<>?~Z+TP>{qh-Gw&bsPw}L+`I$Kbl{(`E)kIA7|!ng&_=F+l^(ryv7wTgt6 z(475WB{X{l;b76tg68Cw6vOukTAxcoAHoav{I`mlw&Mn&HG= z4n2CBLt}pL?`0k^V28xJ6|1EjFC%<{j6P8GsFtJm{Stc4NB5)90X0YyP1Af?6~GHTD(PJ)tOY9=)*V5jG!*`J<}>G8slv5DD}X6nnRy}SB=pWyz|Yd zOD74<3`>=159mKKuM}EtSnC|R5Z1au9^DTq>1{3K46q%C0%6avqv8HoN5dY&C)kFI z+FOD+mvfj8GkU#&Aah?3)7E0NXVd`RWJc3r^D{CxFEKiChoIT8xtNxMwH-#4dPv$z zu%DSW*ZBpaw79m^!QLs7q6|g@j&~Mz9isz{1g%oE?1<2Ahqc7o7aYBDA^37KnoqQNO zKrKy163nQQWWDG9LSeh^j8}Tyt-vk(v6*-!DN0?mwX$d(lu-1h*1=5J7F=t!)=C{r z(3*TnQ&iJB4e6}h>_FtSoj#FVE;W%{UV%rBL%+%`wA(I8ifiZ2QEH}o<5q`IUdYP< ztD8OnFN|uVY;2dDKY`q?Me0=>pkB2- zZwdD^HS`>Ita6>M{z%XV8gI3Rw!yw2j#pp*(L!_nUehktwBKvma~gU~Lz6UZ0nIsw z=6th;9@4byHSHnIIise%tfALy+PgHgvgTY(LwjmyOAUQMLx*bU5DgvcLRsN*o{0mhR4%eH>M>C#st8~D5=_OOf;TY3Hv zK_&(F=`QNsnwWv52`>RZEmC}&^JHO94E*DqV)KYFC87^|v|(`qWwvM*)_`(YWOgBO zzZ~|y>>)5R$!UZ9s+`5X7Mo%*cD5SX@TllyIbS<*i>y(Zk(hm7eQ*ZGoVmqmtf!@H zL4JKR3eQ2#pJ1%zx@xnDtxb>K#NY1I(VjhH!GFg#mAQueH+}zol-|G$mnA#U&)acA zi)qi{To$7m10~*}B%yt(@%m`I&oN)+6s=YBlWP9bT_iN{alg4m`tL)9CFcyPX`WSD zDWy$PS{0=&R$42iwNu(zMIR`-L*orsT0W(ngvHI}xVwPxJPX>JX}Phpi_wkPjmF5F z-DG6Wb22h#JQeJ7T9p}vbH%iM`PiT{rb{YH8Io{n$yHE4`Sy3)c zyF_W1G{pc#ziWQim6DuGY1&sb?N&|UYrN_jZ=dEeQd4}ZsHCQ-rl_OlcR}Ng)6m{Z zdrIRiRMbx6J+?vG{J5@2oL?`r0g8HPXl|ty(X_8AZM?>7sk9CnZ>Q2WX}p?ByF=qG zSK302cPG}*x!oo`DfOIVlAso)1>K~yhm`jIn-Y2gXEHgLLrN>7@h1Ez|5&A=nKZP} zDhbW8Pjcyivqqd>Wt^>IbZ2I%zw;|4#ZNy-XiZI#OH*{Yn^Sm{);ftfLs`IT`EJ`~ zztl~tsXM|VGwUwU1-Lt*7~&<;#vZ&Pkw{bU+6a4H0^dX6o!PKRyfennU@RV3PzQt; zbEc3jqlXfOwl-00IPulPnsaNy*yHh_j1}fg1CLh6951{#l-F1m!Y(!*2ajHIqYKW+ zex5+d;2!%kxAP7I>~r};d|!sfX$_6XqxIczdfC>?vyhx}K)GmY0dgZ}Sy*#dr!e=0 zb6WF0Cy%h^taK%t%cZ6vs%lYvtP62Gb9%t!lIovApD~tT3Jp~IFJ-=JWt~kNR}|LJ zVM=SLGBjhIqz!9d&4twR)_RRtv5jNuo3ZXKGA|QvGJIxtJ?+ z_KQnt&T2X23%XOs?*8qCHcKtR<9&s;$k~Lcesi46;hfDGa?Wp=j+g!K5n47yHL=T) z`oTS_U*ovw7b>{n&o;tcKu&NeS(Gni1C8H1uFs`Ntogpz2iwWmfqc^o`Kw zYk8BK3$31}D7jq9@pL~4-K^{JbMznSTMFeeb9qz!^7UlqUrA@FbI}{QCSTAtN>+5p zwPmWG1#?NRgP+Gsih>t}zsJ;{^R0SkvUQMnO|kxA{*mg}$7&Gg@|gDNN?74#4yNPQ zNk+xpKCLJYb4g$Idmbk6r=2y1og(O zgK4We3hk7lvX}>O=*jkiwyl>Gtu$?IMfsie6{W)1XU=JFQd)VX9eR>OQ~jY^rFO@` z8^9^Z`2bS=DDGx9wT2ZPm9+{*C0+?dSrr{EBB3FropQ8Pe;?-d+zKzN7I<9I3DrK| zD%z)dXthJ0u2*0W)o{`6=A;0R0m1lI!L5nJuW*Q##|ZKWrw!44ioO`YH29E*2s%Am z&{P-d>6(ofw`TKX^1)MX+7kQgFpBeDjbYG8JnoBqfSX4!OJ!OxHlA%FwDx@jT^YeB zepMj{#`9VjLqn8ru+-!_++Jhy!>JyO5N6a3QG4i4(=s7i>p~#|SeY_q3oME#<-?fF z@>g6@Fv1SO34IO?<{yvWC$w7>m6;;6kd7&}6=l|(Q_$vIL%T5=+zihr?wo?Rn=J*i zV#2Fw!#|O^xU`W+*Hse_+Mt?(WF5z&;-9kjD1OzlNO$(MdDLg5*d+}xk{C~53*YN0 z+VOU`QzuHfyGl96yd!8(H|bmFj|uIbWt(fS2p zy4#{Et-^EDvl z*#*b;nkjW}ZkQtlbXXeBWYRID-+U*Yg6rkzq?D>sub(f;upAkCP#;Rl_7Zj=~hQ>MhXO%>5q=!_>y+V%Em^zh-TW z(Z)x(Z1LO&JfB-5evn<*E5z3D&CU}OqFS&7&CUz#1nea3)#BN%pz2}?G67OT}Gy4>E(=lqCrpTu$Uenj(kR!SN2l)fGkW-zMCTQ#4W0!)li_Qq)ONbw#-ql~(jC-Y?_& z+oWi(qJ_{+9QwMV84lrv)ne?Wi%>&PdcdYTq{nB$zACda|L@}kuRO`yPEqOytC=|n z>4-g6t>JZQ4ZouP(`ITlztB!;3*59vn|Gu{VuiC!jwT-H3y#3m~mo?ry8t+bxcUt3Z)OdY0 zULlRQ%Eg1m+roPru?O-lx!Z8qCs-M@Iy;zwi_OLN0T^2#N?-1h*6MUX&^{gCYGS

TlGul6LP)f_`2t@?5dH&}uaj+QD5y`}k`?n>q{ntFq)= z38xnLZv|eF&=uHu#W>o0;%sT|bGD73BG zj}rR}ZFxCCZ)krTq$#eb4E3KZ@p9vK4(4>Vwr@`LxgEPGJb#1}n;h@lT&AV^h4zRo z&?Tp!4w%ET_0XiW*b(L?6Q+&E%!^SkMFSj)Qi07}K1K!WI5&OtG zT3h8wSmtbR1feg%SI@MckhY7BXVzhRSS0JPSlhvj#n@rELl+j5;SVoFx!EH2g`=14 zz*vS;QP?HLE7jF-?vrU>!B@q!Z;+O`s!;%~kGjSk?AVpa<@MmrWAwuWsg3R$It-R2 zhu*AG*BSfpm=@J|Md1x)+7PAX)p$=S?Xc2XD($=DlD3Z0mMCqu(#ktdJql_!vA@)0 z$Et$fhPL23*ztu}|C`YITpPhGp(SPsyi2d$Uw9Rwkg473KukOHC!;9sRZqayFhyrcHyi zGwPw^^aH9l`syfNSWy*?H%#q_S{nL`hBi}FTJuZQcp*hox=T4KRucY#m9D-^nf9O7 z#-83FxqPAjUD;V^r*tKKrJ_+9FT2LuprLOoY7V~z*HGgx1ihhY@7J_DG{r1MZ8dEx zO*>W7KBQ@X))WgBb?3vXo&NV8c)+$*re4r%D?I%4k_EoryvIj@>pj(N`GAEiVc#V09OtrZPZv|2eGr~Hl5|1MMRS1ZqV zDW?}65KcF03g2;x7j!?C8_*jZ;M&C=>x`_g;8Uq7=-qpHtl)bW*z00KSvyK7UJi77 zK5^54^TdRx(ygM4h33W4euw|cjD8r^)L-mr`#z!m;+^U*&a3|7ROc_o{SiHwd%P-s zhOJ!C{@{|sn{rmXY70_?m;9XsnbR=5=Cuudb%fR4Jyd(&1Fss7&bu+DjIp7=06lHd zN6>oDSwzsR6D-OEZTmVS5la9_DtMw!Wfgob`n>FlqQ{Nc}VqUPz#~Ece~C99hx6Tq0>-oI8%n7&;H}-nA)$ zG4w?@(%}_)clr@NRn#+kH0%5zZFK%Yp$%1kT}73WFA>T$zDv4LO zr|+YbdA{`S#!4%zv`SN?r7K|HCAaFO8w8D1)O>^F^1IU7>I`GB(&{NK_g+acWRIZT zMFst-bAyCpLc8%TK`k}KNlj6*y@cl0c#rA4v61r?r26;5=VmM@>{5PO%JFt?Nn1oc zK!sGdS5@?cj;7UgtbJmoNcPMXf;K2Rt>}7}HQs8CH$&r%)X<+abhCz5($M!c^m%8MM(MqqwXNaoWi)Z>1x@f4b{l~1r= z9k_>@eRKReL#K@iw90a7Ub5iO^60;2Bw#_tJ83rWO1;96_%DhlHsLtcxyK3VFt7*=k1weMA= z<dzPuBH)3W+bi0lWBQZaZJOiM@UI)^;kFiYlJu@NFK zmz_1@QBU_@PXhu&1LNyh4oHD>~`U#CdTmM6ypB=jrg~+ICwTSut|5JtSwZ zJ$;V_yN24!iy`L3mysN-&0dkeRk}+!s8nCj4GyLK-_x&%jHkkmFg+zoLts7Z0Wa9| zzA3>X>@nKMZHZUfU^DQVq1hE1paVz|KSvDiV6WiIs^G8vW!@-vjfdzt?EL1JN`m)E z%&Q-~W+<Y75_KpFL_E< z0nGkbwqw^h8g>Ny!tH^TJ&bQgHgN0JFllL7qw+{Gg?h9cp(d>twVlQ55FOcA+HUnV65-g(p% z?N!=?vei>*Kk201qq*=vQU$}oi$EDH>IY=>c=|GlnF(xG9yMfa43Rlo$~~_D#yqq3 z8KSQ+1ImJ&<6EH}bom&q#;46|ZQQ&{@Y!%ubkA{|oMU*l)2yXu`cm@&*M?-mByY_dFsNL)knEX#E_g zcsXnp=Z6vdPpPYGTgIcGvn1NS!0YU$S43z*GOx2oXeDO;rhi0eH}>W+>IvV7LGiNt z_x&Iy7tDV#pJpu|)RpW9@n|4CvwW+-Lk?l}{vTwQ-!;npsA%dWMY3NYUc$_a7v|lJ z|M~tBSO80SK8QO5F>_@du@Ux5QH+=I|0oAdV^*smLy(eWD`Cbu| z;V-UhL(MCd4K1p<829g5wBW3y9glb%dIR=aaoPy9GNWT^$Nv0)(8~4{3n1U8VRvF= zbv}Nj4JZDW$o#w%X2;ySuYK1IH*l%F*0G3;YGdG|eH*CEI=Z|iES0wD&hu}G} zX#>d)(4)@A^ys4uqD9T?n4I4|H1Cx`+o1nQt|YWBn&PPPvdqPcza!7Q>BD2K zd2?eBMy6E%vd0=E)xV{gpf$RG?TZcakDt&U%>9wiWzG5rte`UOC0Ou`a$u}rbQ`<@ zj4}+C&@vdUm^M_?{stLh+UmuE*5Je((;B@fxop?acQwU)^iYoX_-H|$jtCk&NzyhO zE3}6@32pgLLVFy2+T`L<=`JjjQMw^F??#JK$5q@4QH*emU~jCJepL9VtlaiFAYPL0 z8`qjOJN-U$34j3z^m_q8-BWxSRT zXld1z`J3UzBXbgo_1ccl!fsz=lM^B@QRsF)c{&@2y=6Zu&E&#*vXOe|gOv~y$|nR( zC?gZfDBv%!i~?&(ET||2p7L(aI~b)`?v~N-CEcIXp`FY*E9yLS-@`)7qvys}CJF6B zO>u{M#V=}#scuJ9)V_Se)n58iSlY4Y}35~pX<6`TV3~iP1pE3>w4Zi_2fUPE2yi&Else=>!g%;J&42l{kx?WLuft0+=y^?deR6!k;)>&!wmDWIM z&nv3eO46=U+7PA9R9ZWw?N!<|rRCCp>`>Y{jkiQ;$5u#rS1lJ*ex;xc8k$XMKWe-i zHT3c_N%5f4Zq;}VlvY$}Pb;mH($*>MU8T)Zny<8OurgS7_vaO~rINHlAEgyl+6<*l zR9ZqlNqbglFKE15m9|!Ci8cE4~xK#{L#AH1fV;$hWI#Z*TWR8EiRF0MwpEA~=b`P-i( z&s`dej5@!c*- z@fr5laVZC#6xzuoiMP0)ph<5^=%JQUju*8DoLAaur4?0FQ2R_pr43VB7NuoS+Qdcj z-yB*8#peqL<&;)WX+@P5QQBsBg}7`}l)veUo>vr7l%(i{woz53)lyU{K&_=VqKfh< zN>$WTQ9VVi6!lP4SJB!9Qr?OkHWsPSrPE(scMm4>d=T-s^qVy)-Kx*o8us&JK}J-%Ug;r`M*3H?&z z9dtI0M_n=`+7sp;edAWO@J<{&80_sX1e@RZGSXi)kJ3K311u$U!yKZ)uz^!Td6yFn zvuJu{BHyB^j}tv%(M#3I-o=#?ijIVL)zbbtBWY{oCVJk|w$~6^k2ZJ>)Y2B;P4tFE zw;UsS+oDnhBt?gl67SNxL{n|(6!5}n|5_&;Ok9L|v7z-LS92^XbWu2+^$3x93os?L z?E&H7&a9Z-S=xxkM4wtTvcH7JK9yYZcM-G^Rv(vlS7xHcHpSMV5}Kj2gjW7d`1||` zDMwYbKJ#3cFz2#qi=u2?yH|2z?Zwh^TfCf2g}+IC>w{~35j4?d+@aIeEkQ4Jp7l-F$<;Sv`?H9t_or{#&X}aljO1# zHOV~x1bx7@He98oI$Dr<-mySZ^jRx33=6I{K0_<;-;7U!+k7wjFXz0YpwKFIkQCna zf=&(;^v+V@{_&OMYN#-@Ez8T>pGljy{840g za7a6A(QnY^%wN5)CBN@cBJTS&(N{~^61^4{o~NMCaLZ&@eKivLh5N6EcH`by3-ZF8 zwuVHMwz+it6AP^tb&pDZ1@D&H-Jf4-{LcasFY=AhLQSL&@_;|i`F{M3+xJ!UT1Ks) z(HU(hAlh*d`VrISq!3lM9K3W{^1Js5(X8#!svK{&%E2D=UzXyZ(3aJ0+Kb?Ywf9BT zeH}~NHAdpiLSNuISdALz{C52$64CxCY1Jk*i0aw2J)z+^-euHABTI`wHn{ayp{H;U z{i+#J6C0WZWovFxUX+~UWrDTNoVEguTeUto;JSJmEp5DwouxhY z443?>cNA0*w01Vd;!(o$SCDb$^cUpP*@jL+@9t(%A81kL<@A>lFIHXtmWuI%<$erm zl51lm`YPu){b!Nl4rpJl$A{VZgEoedJ^lS8A*1*T}$ba8JO>*c>&`2x?vmn{r0~VpY+(thy6p5XVy5baT zugC2k_P={qN+~lyUvY^Z%ql$B4iSy8@s>hfIPF8(B;FXb5&!pQ)D_E6W9SWz_mkF3 z-bLi>&d1hCYYj&0bG%z&;f=BXxD9=kX9TGWq&McgPk6~QTUs>}bUUa01Ulzwo3_}W zf=c}={AH^q^)drAuG80`BY2d|iZOttWXB2lN2w7S4?TeEZ~dc^-(>uQ|N8{SU(V(D zO;Vx@u#j1oJU>)g;pAH3phJF15k^{Wqi*1e?eULQcHe}w^FMBca8Q0w6fXgKB`!=-E0zSoHj zHx~b8*_c~U_`40Ni#a%Yr{sJR9B@4s&LSz2AZuKrr+}EhTF8a})(GPkhaNyVShIe8 zKtd0rhS(lIxm;-XqBgiM97AhOu=UdRqU4eR+M9FPc3x;Dq4~KFzN$TWd1IkfM-Slq zcA!pqBz`j@X>-E%=GJ-);~>{TTht_@m(XWec3aMt6f@CoTnFz!qjN7Siq_{+zWBb3 zc{S%sykaOhhh|0Z;U4t}#%a!FH+m0SWG|yc{NJovwt@?#eRn{zIhWQyNxTSp8JF!Z z^k2@e#3O=UM@@2yff*!T41J6Lu^-%XifQ-r1`5-r2E3{trUngpH$j+oEA58y5^C;6G(9RwOO!+f4kpkR zg42HLR736(LvCV*R4dq*ifmV`1~YA5~Y>jj>#e7m)}bx z7gOU`=X~rRbH1r1&ePe@Jjc1U;?oK*+*+@rydnB~?e;>=h3L)-VHyaOMD-oQEsrIM zF08Zf2|pmUwioMprq;r=|6!2>a}Ur3TL(|pC%OXU(d4n%{f-rUkMg+Ct7#@)h{`_~ zqQ*rHY6iqPpV^P|WyMTe-hMq!kXh7b3f?_Lyf96BAxxJoZRj`P+0tG;kU-&x32oF= zUN~Pk6ubUxXq5nc&9@0*hvOW`sm*2eXzbsx=-9`YH(FE`p3l`5^~B9a>nz%tF_AV~ zwCQuaAZby3oN#0AzrH9Zy?eaO<-ki)Te+@0`ttyn5^rN+FAn#p)!D+7$?}|-H%$3& zFx-EhKamPs^l!^sWOV}7v%I8L%AiEUdxj~y{abqFNTxP8+m{>hlBsO1Fl|8ZPNpYk zpu9HiEGPHL`Z7T>Er$FRyDG)zb=)!@nOza4yx3V;1UHx3T<-I+huP{4^X7pWg+kOH z`*_S=Sm>8aB3E-yWAB@ljRGz|%zY}4`x&KGz*$<;10aR(kPBU^p-s@z zrLf~GM0FLthSLpSdxn+)UVDR*=+Qz6R1JSiqNftDKh~nzp+u?+lwx0~eGu{fJIJGN zG1fLj&bXfeb|RxM9akPL1qY37=mBsL<9KJFMNxmu!FuK8?A-D*IvxyB zD`*v*#hc0Pn@q=WdyQ$!WJ*G98-(+~pNZ6=5}a1qS%Remcj%ts{GeZQ3vE2cEt57x zA3T9w_f{r1`Jt2*M^ovQ=R_9D@qvEINnpu6%A&@qj)N0BR>tuLDbetiP^<(YCMU|o3W=m81xl1 zjTyn>cbU!mh^RYK;J(+Yf?jw_&^Fje9Qs;SK^LwQ)EJf#hdu{uoly(eLyYF*?*_&H zZS@JFhwR_Z!X9T7R@C+vrp2ddi2wGpDH;zXhYIfzw70l~=2lv%(GvRdbU{-$3YtAc z(5uS@nX>UePNQs$3YQerf0o31XRe?Q69wI-Ij=7*DY`4CF-4|^IOlF71bu-TVp>&L zmW)2v|GupyI-MY)`!R>$c#Z1I-~NCsGi@X6Y(@=~t5mcl(;h1$Xk%MJUu(&?X-(ez zyM(?2p9iPC!{ry>GN#=I+m@LR?aj!vFQdWGP>f7VGn!IKXdUVZI^Iao2~AN0a=sDSRY8lxBc3Tg+bW7czb4$EC-xRd&7D3fC=PsIaWz6oFgSRxlXEZ-^OE`y` zTf!ak1sNG<+8k&BMjMj^b%8!$+L!37jIP7XhEYZ3rLyw!v~ti=IT+JUQutb;&y^O_ z+DOv0b4yE#;~H91^XnCp(A{Vs=B0lrM#*GOaxKkn#(i@~l$nRd(>_fN(H`icWJ<=2 z?+K)jZ}al#3*&5?Kdz|CCHNREEt}FhE4oEP&zF_7W=}4ssI91oq5+B;E9&VGtR;-Z z)2tOa20NGehEp?}eI6X-r#dLt%Rpf|*(*d-ERs7`v48no$nGEx+xG{}Im58NKggr$ zbel^~_F9dthI;w(JI zC(;_sV$6%~iS+CnY`5dh8$W@DS=z443FHHLWM(@i9`0mYBDtjGWgCfkSz>uHExHnj zQ*5-zr0DG#nxx=R^L{+;VICno=Q_qU8Q;?8W~eR5CDq>u`;XCZ>_0UqnOfcpzm&DU z%p1lB zF@j3Z5Onv4jBxAF+63Yj?2$FW$;KnKSt4-zGWJ^R1$nGyTo{>aTwyP!aSh}I7 z(hWVAZs?!sh7v3i?onxRl_A~GEa`^kOgA)dx}gQr4K0>#s5#xlB}%Ku-<)n}xpYG- zr5jo`-OyU;hTfiTXoGY^?@l-Lo^(T7r5oBN-O!HdhIUCev`4z3ebNmbkZ$NB>4rY0 zp;t@0(IBI2XaQ(y?#UHlKlAD8o|R=Ri$aI-ShgHGjL}bta_Vw7cJ1<6t-}t5s2)5C z<`z(RO;<3A*Rj{*d|6eD;;DXx@52t6`y&j^qX!;Kpckw+U;|D@FfWhbl!2KERWZ9;KIp z$K)qbr}^m=?1N{4aDUD_IEe{#bsg-mb+88ay)t_AA>2}BX*HV(I(8pMAxm4X@%n4L zM2+{Oi^u=?29`&vKLj?{RQxy9|Jf5{yf}vD(eJ-Wy^JRDuT9P<{+Fi)!dime@6py@ zutyy!a5Dhpz|g`}7(Q-;;!D&QehYINGu8j|ZoF-7(I|LH42q9uTECqQH6>?cO3uiX zoRKLxBU5rlrsRxF$r+iF8x;SK-s zdLX*HF$O=-_4?ZzCE%Ueq8rnL8!mID&Y|6QT9T1wlfw6ypuTSw9^jR{JN z=js}7oyJS698EReK8=@F+1hHnV;V25^7htvS2SK)bud)pWpzHcn4ea?tk8IMG+tVD zwNc~Ut?~YC{au1*hufnJ=JAXsP8YOlj-Y>A&zYU?Fy>d&{AOr=n>D|G+aCEfzdJO) z`I_He&F|l~Te9ZYT=QF@`5o2#{%!kK(fqn-e!DflOPb%mm4mvPUq8+7u;!N;HafS_ zzm=C}n&0D^-&xHszvlOE<*J?L_l)M3fH?$nmF)846@-tW;r@U0@9Q9bG{{svf!5p6 zVDJxQQGDogSV{WUhL%F8LGYa8u2WtK$&Ixb(;j?Bt)a#I1-W>vjrqy&y_j(|<{!C( z5v;7n33glv(ZUbp<{Lx%6fNk{?42R1VE-{VCZjlQlvUN^bJ+(F&)*;LS}nGt-|2@L z#fJ{9nm`Fy#ls6dPvC`CAhu~%AO){9tOjD*7E3d}haF1$$jsH>;0OLQy!i(EXc=P4Sb=qpY8HD;d~kQR5z zBke3}>q!b&f-Z$ek{0*9y0lnH8ZLKn3C|&V<%%AkViK@4ZF_zg1&)8!RR}jWxQnLZC2E9VTksDmP{QXO?i=DGTj`K6vlg0 z(Ej5Y&G{w`-Gln#oY!c6n-mrKQbK2X3AEqZwvu0bJr_oP=7bhjW3_hME0S8nOL-Qm%a z-fYWaZfSXQ#4__j_y3FNuyj6rv$XT+d0=-=Po{ zz*~I}*E#E~_c>v$*AMqI&yQW9tE;QKtGny^pVq3o%w+{?rOMT{as`cH zQ_zy(U-ybZPpCKE)L5eKKmICdiUG()ooAl>U;0ZOQEDBB6UEh=Nrw2Rr1~q&S;eVU z!~U=04AB~IRH(5y;~v%P?iKMEBcAUTu+o6~&lC zf2n`nA&st@_sYL$G^4-Nzy1*W*ORe-rN7j_UX1HjGAUNIO?L0^D%EG6(?a@>7Y@w=P&|8dPNB{A;(%9co!GFD2G zl<5#tyd9BL2!7Q*BJ&}RI2)07Ag(BLufTsv{&UB%_9dS9=Me2!%D!X@+%!OjDG?R$ zPTTXidd(qba?EvHQLC8cQYML?TUufTa?T+(u++sh{~Ab65qBSzHA!rJ))Jc`xkZAM zBvGO@p3_0{h*>OYSZ6@VMkW6G!=~6RV-86j%dBi1_H|v<T#sXFCK{qwc%YNLCPfYc`G~% zgcK0D@B{&ED7TC1TtJMIGD+xdFCdOd3F}-)Tw>96E+i(FQ}xj`yj!ef(KReg0r)S= zDP0dMqoS-(y#JEBvHsM9U9qxugzo`@4w%2Pg*#I6Il8%NANVw{vj(E;m-T6GOk zL=?prbV8(w!o5t96H-)^W~s(fOjM4<6hKUIQCo^?Ll@~wh(;Xq#TTY1ikK4OY!%8m zSzPRHi87FqqD<9LszL4(Bc)6d?iIYF2q`DdvwU^c5KSTFMek~qYLfW!5A*~nQ=}w` z@36{bJ4gkQ%5r5j)=q;|6zP!|N>xc@SEqcE1jY1&R2G+%$m5H)q6)qsq?quitRjLM zB&t=PL8>aExD>VRBOp~pqlml+sV;gc@u%Q!nU0;B_%e&~NfP&AP54QO!7oEd$r5jE zvcxngTck{m)u*P&QmLd|vnZc~5qTY{YKhjhDCewTb)Rc*~UIMqN>iMIWbiMKzW`F_*Ixsp^V` zEDvE!P|}*^D(=7D$5>of^kjJu>+UHT%+eS8{X?10i%N_o5E_x{iWw}={-R|rr<(GW zYUjFQJxk-MT6S})62mRd=X;JRJ<=3wWLal*J|^zGrToLPBPO}($ks5{FE_;JGNu?y zZ%C$;l`N+}#`>q&?{&pRmW*VKY%=C1%kG#2byd!tF|HnzF?X{Jj!79QnZ{+LIxb_{ zvP?zHuMn)@M>|_&3TKQZu0!gH^-{8eWjHEtOUYDXtgC7Z`+kb~nWgs#)vEQxbtSP; zw4PXir%cgNw7xjb(z3cbgVYzN@Wcu+M%Jr1Ga%>s;#NfRLmm+H6*0x6A%>)ZSi>^p z0b9gD8j76}DG6yLPP0tGekW-xZb->A?mB}p1M;9K*obn@G*%<$s*s1o<5DJxZsko; z2hv1LmXeI;u%>7rWhYDX%9w?LG!;jrsH3|rBwnC6{HLTVq`7FJMBGydZ*)Uih~X@{ z4O@tnO8n7p;#snc*}!t=f|jjP!n0Ki;p3@Gw4Gauwo=px`6TjbDKc4TJRAyXB`&eh zm`P=|7Hu(OL!(XeOZa+PN-vg8ZSkAlkcY+KNDSrkh*;Z1rJ|UrkT&8=7QY=9Po^+KEO@1^!DCkD|rigR~cISVk?z^F~Mq(K`}D zsXB@{G(M%GnDvlOqKT4N>77OEh|mbxS#*!cmq^t`9F&q3+`tON+aX=WF)87Z(pB76 zF|pp;RTOSUrK|o-ef3dMgGKk=ZsI(P?!Au*r@2Z+LVdNnD8Zt8Zx2yNO4xgQinc7e z_x2L=RjNRby}iX!7CqAT7He6ay{5+1-Xfc231kmS?=7xNnIu*{WQikE2DeZ(oQl42 zQpzQkAF$skrjN+iQpJqNO58N|_7QDa^w`@+^iUG$vA2&H!=lIDKH?2drN`brVgbkK zvA2&{&N2Gf=_58NiH$#fME_Q@KC!E~z9OAPk3W4yzBa1PH%1xq`mnF)DkU>m{iG?+ zgZ;!>DQZkOhb`?V4oXpD!X+ui+EPC1c>f#HU(}0;sE1=r^p`S8oXUl7*D$UQ6vtJJ zsE%t|C1<6CeQcn(&M|sR2Z|c)WLdH6-hm>XrT0a(PX~&wEG@@caw`Ukfl|V8W1!f? zqOTzbiSsPFeFlkT9m4H$@#i41G9rbfY>+ZZOhSw0#FjoOYILMjlf)yC0+6RfZB4KhVZDW9>-9Ab%bkf+7YNDSrkjL6rSa!wKyQxo#6D8aHH(g-qG)Rhum zj}4(D_%GAZ=eQxFwT#I$8sXZwHBt=`Tcu|{BF^_P!JIm*%>TX7jOL!4#Vinp6?L0%KrST>$EL{J|y zq{8l_>XWN4e&qs^Ebe33gR6r3AgQ7e%LIH4SRL}F*d!%v)p=r%647L*C9iwuiDN7S zkC@^Cq?#xEzEoC{e2Pf-gY(7RT7Jg+**M-ltXl_kforg&1OD%77!&kA;9tb0~U z6&8IxpDyaK=A<`{ifk}fhhM&FgBivukBuH-#&JR;Q2?}>*8 z2>h27=rhRsqMH&!pPSwnPq64~(f7r;h|t-5shGo}&)v(!M-icO_j2*Il<-WwLL6t& zXX+0`wZ~(3vFek{*p55A0?KN8QeEXKJh5%RH^&Z7JLO0kf|e9w~pG>%coTJbweL)@p#fvgkOK-!8VL9z(4LBz4pQSd(GGcid?>?qhI zrYVVC>1`74N8}@<+9cLSgs${9i}XRNEPZru5t~@(jQ~0-w}@|8#$Hp$^5^0QmQ^fU z#U+*zO>MCjWql!XJgIUf*#gNFl_T;EBwMs*ad2j&8txE>S#)dc6c-}$9b)!~TM?o5 z*)Iw|6}H$3$hV>j3$@s9ki#M)B3B?sM41GcD%OU_L}ewhHasRCjtI>k9uwUoLh}hf zh%rz9XB++~X0hnr@}tsf2Nh z#lZXz-4_^!GmP>{@=HPGpubiRU%4n$DJrjcZ`k^p);CmJi&4ZbFdu|;~CGfWJ7vFd}9Jj2|PQc ze0<~eh)_O(@ea$PS5!VZjFl{}Lnxn|##Skl#C4p72T6$=PVJK{Ua4k@QIK3lB`M+l z%5Bt=qW0G~#N;;msu;f^?sH#(Mq{?sP9zk^u=b!H~3P}m;e3wxsB2?C0#vf9$Vl(XpjDJ*&f8&NJ z@BRuH-gA_5l7IJ2yfK1SEnpO4`HW|}3L3>(_CnC-L_wn=OBvj0(!4|=qZvyb2#r65 zjJ7O?UR6EwZlf#9c?k8)yNy09wU*-=3R2j3hNTr`nUpas3-Ns&O<%NIOI&%Ek%r_EM*}y{uD9RvAkd2mh~xW&}yF4KC2*9 zpQ6TImLxvniW!Gl=JOF(%s9cKkCfuZuPpjVDQ^71G8|WfROb@LKP=-QROb=~tt3XJ zH{|_Q(#Xfs6+-)~q)~!p5UxdOCa{!Ij%6%_M%q$Fb(S?2&h6NWdyRT5yC9!RX(A;{ zj!5(r=02m&3sm|PF$87NoM&mHDa$lmZ)`=X(neR7Cb-5XDPugv@&;0olr_dmNfxs( z)@4D;88cbxW?Et|q=K=4rBw>nx? z<*0hLRl``z(gs4~VGUz5OHPidX?(>}jALpVyIHEChBVICGQMMJ2BC4jmhltIsuyTJ zm|jBsg(Vw8M?r1l5=))YDyEKcouw0mV(J(M)&`><^~n{UGdJ?E9Dq=ds%sQusXa#J zbH7oBr=G>u3PNE@SjLx3g$y&AM`ST%gwZP^ z%OKAi&qZVBicK?1#)S z&PL=gWTsJUlE8l|=i`t!jE)gG1DRz^j>zwj6k}&Zu0m3cg0F=6+=RSobc~4E&=7Nt zX)JWbm;>^bF+U>tAq$L*h{Qn_8e1Y#60*qH81 zH-s!P;vy0cdDnO_B5fe=83S2%jmGm_$WmikM0!D%8yOLK9P)v&m*u+wrg$3ip>Zi9 z!yz9V`6jFSP|Rq^Dx*e3CPLO3U0Hs@@5M}qtT)C*WH#heBRwMXA)gsLBeDdt*|-{! z6_C%3VpCMQbd_^~w{X6NoHy=aN%;;>10ffT3K3}n z`Q50`(iFe5(-Lygc$}qbORRMTxnvBB2*q4B#z_fht^Y7mIp&!%w&;wQKa2$t=?S@F zoQlX3kUx!zGgO_&Uo^!~$lpdCmbU0EV<0z-gDhQ<^Hj)fDO ze5La103k}5(^%HIrZ|U~QYNLrwS=Q*=R$e7ku5I$M-0sxU6Zm_=94Cp_hIG3CU}?M z+!T>ph`G=Fh2?FIDQ#Ye2*s2!ud^(hsPZXmcArJ{NfQTH%9%5@{H0>bo2e0b?m;0c zn5S5%KT~}wn&%@zWmPguB&(czJgV}kY?g}%#Z)nyvmD)R$x))J*)<|&V_d!*IB4FD5kMFHzE}Cpm~vnTH`LrL*|``#6g;x zc~eyB)EX4i%q$rZifLh1mlC!{E3>tf@UEnl*)bydkYy{gM?~)PaFt~~Aw@lbx)=!Y zh&e=xx=tv8vf7&Cq@;**Q*d7eX=iR?8GR0`exkp3G_zUSZbGZ)z%z04D$609cj_Tk z7t>3n?Me|OjUkVkMIzD+@|amIB9B0Nn(<2fZuq_G0m!+J`7p;E;C%X+y;+{dd#O~P ze&#Tiwp_yj<|{1yIpzs-4$JjSJm*JQgUlrn=>~byTp=ZF=cmliq@)Sj%Y6{@l$jZk z#~}&kE*9F$PeGnG4@YDOjERUD9#YD(RGd&{JbK|+5`8~^LoazPhEX!^Pr5bJi84*e~#x&EY^fXb6Q@v>B zjYxUKj5SNJH0OL?HY-Pj@)>W|my#%!)DmJU%9>!-m`gc_eKpanFC}c}M03_WicxRD zx%8JwzrBe6E82gjo}(q2S6RBngw}pswjkJ7-pCq7b!W>2v6S-GsDbeaXHoN=DxR8OdkXD2`GM+ zc|9sQ(fiF(i&f0!J8I4<)f~vOhX(QEqv+cVo=5{Ajtb;5tyQVAIe1hK6#hTA%Cd-SBR6dK$ ziSMbH^gUYgyssn)v=Y#fN^gXWZ_DrOH#r&RBn z3s{b`ylo5o8h;QAgj#tYgMW$I18VEtT#ulQ_?0y?e`7lUY66tRL&dB z#h<8{<2ak2MXJxt?Da}U{e`E}kS*rKjZ);i`X7+3=1nD{CCa)1*=A1rOr58ubt(1V8f+U(Afqp>Y}RJJ*pW&2h2zTXaW7R$5PgH-ws)89e)gh$gZv%Zw@ zXxe2qQ6iqhv6B;J?J_5_P<@I(4w`>{`=9kWWL{@EfW1=|F^A1A$Nsad~xCaW<|9uob_VapzP%FXH%W54mPeX6ZK&Zzn-+ zm{WeEm=tk8&V$cEY%5*LB=K5XJk7wr1=f`F6cd)7!o;1iB5~LIux!h za#%H`L{mK=MeVOdl$FCukP_yT*SaDlMbyD4alDBTd98xKQ_hKE<8)KJj#T-qDwmYp zK#wBHZw>x~BtXvFS!*QA&k)*QWvz)y#9Ko!bC6Sra@N6X z_y@di^Sn@V%N4E5N`eG@3G+8%Dq6Q$D&Sj4B{~11RI0^j+bdcHBSPC=$tn>M+V(0| zg^19$SF>tGgtong)mTcnrM0b=Qj%jWU&nehl8Q>NYxRo=m43f9JR($jed~vaQ0Wb< zvk{@v8(9xtr|k+`{voTAl(0TctbtO(mTzihO35IhMdk-`p-iFUI@zw<; zVo*%}Q4-r<@s|0IOcm(;6>sHa(fgvA7006YMKh~{60!Cl%w(YWX4V5YWIo~~_GuRO zU`wmBlyHBwvU){?TCBA-C?eEik66PZLM_(TdNCr@V(qQTQo{D>WWA-r`3$h;vFNksQPTypD2mFY4EhQ zT}qmucYD4=&QDw4vwYLVl=6&qiKX&rA>~=C$sH;yO(b+xF@vpXELCx}Lir4_669!+ zCMIyqQ0rqU$-?8DhgsWLmgAcLd!!m}ealjjW1hFpvm~EUF(YvaNaIkl7~TWt0;C#k z4Q5Ga8E+kCNrkkZiRWGxeIG@sK4Y0`mBV`pdiX(wSvBLyeJWbGTDI1()WM7*rJ8MRWYNcRiuHw*@SVvtYrBexZE2ddlSOZ7 znze^TZ)uvfUrM;8Y1R=IJtEDszUNeWOXpc9S@f39vwmgKTRP9Wq$IYb^R2&F^p-BP zZnNkuecST!ypzs5dP^5ub(9z+*U&!iT1};d+n#QST|WZBBmH(KCnvJRG%~vAciEvYRj{$#NOnMe?TWS6TE?u+K_k(MQ2P>s=+W<9(mC zhD9F*2d%A~N*@IWtz9hoC^%>xWzk2$LF+8%qmTD*t?MlM%IdJ?__Xa=u@T^~Rggs= z7e}r8SoCr6y;X}vpUr=?nn($+Qhu@?mJ*(Yk6Znvs1~DAPgpN05oIs~OlP8#)|*QF zk8!xs+4Ge3HcNv8T9$Jv{l4ERYqgZ{$US8pX3;hL#kws;?bBh{%V({E0o5YWfAOFt zN6~XuF)85)dCuz3qFd~OwNOg9-!E7zIYy7zzgszTs8-c2f7znnK8{|~UbUW9Vw}Wi zO#gP(nkhx)OlOckt<;Fn{NbP0!idoP;WcZilyLs=y0uD5nqNMzDeN6W{9|oUBHQ@| zZ2Lb}c0|TQZd%t^Xe*{d?pStCs#luqnaL2tE)bCg5Zf*jk>wE2p1|@g*5qCf$!RCE ztnH7lpdq>JwUK{lYM+)xOm%y>l<>HyX{SmFdtEI%lSTKsy7t9?ji>W!C2 z?1@s&81$ZJTN#7O;J+;Aza%Ry4cpl}S!Um_t|5_%<=3@%dtavNewRv> z#4+vdX)JB=B$VpY-d@R)h5kGUd%3-RoMkbdjXsNfI@r|;sC){v!%=`#o$N*|G_uJ% zDf52b|L-o@UmQu%WOON>FPu6DK(@lifgjF*yHkjhLF zccY!BKpwR_7E<+bN2u$uZuUBsH*haQz4tMDKg)+K-R+A~Qp9Hb63|TK)5A9IrhHPw zpZS&avJ0?KOe$jf*cJa3)8B6Vub9W}F8_)dWDk;}-VUX0f65*rB~1*eV#?_nE=-cwJvpS9nJ2)!XN*j^lwg{a{$J2N8hK}OhTS>8=o`HZsvj0imoc)`Yt zl&DvlpqP)5YP4NO%4Bi%6V*3fvsl<dy=A+dBqdq) zmiGf(W7~^4M)#K8_RKOWmF^q+?U`js5(U*cA8L5eey|)#Si?j1P$_4Ov$@s$;URk@ zi|)OL?5|i3a?CM1n}tfJ-g3iC(8WHL(H|-@-!q&KLuaFY9#%=qP|BAWF`CP7z-xtLGx@|YFs7l|n8&_VCJN7gd zvkuk_fe0s+rNkV(|0`t!%LTk6L}EC{SR9Tq9Z^Z;e1u~xr;L=ahPE@3V~RY8K978C z$FHnXJ&aMSJ;ZbJv6RO9Km8%TGmvFeU95Ty37m;61rakIlGAyYpR5aS{%BI+@A-}FJhv%qNKA+<{Y+0N#|QBsx|r{RY~U$DOp07Rm#B& z;iy+u>~8d4C$|!LCq-r5>(H+OAx7x3N;?&$oC$s%fw`R=crxPDV)+B|J~p+C^MI7F z<;yuuIYzfwIj6Z2gIbJIm2=ue#E!?2;B;ouZCKIi!J^x+qSHSj`H`wptbJ%pNh-(W zZ}f0#=PEIwRxN>;s#;<#UtNns+kOn(97Dvpb{vkqb_!kCG8gDc33^=&wx zOecPyYO$KmQ?kzC{;K5+lcM(5NaS40nJGo>FWQRQ&U_ZV6?L3tEP5;II_s6h_GvvQ zlVkK&)N}T6jNXcR&d(g9x1yf&2gm5Gc)+o%QBTMedMh4q?vkQqthgr&Q zv;@_)X>1SbJ|7IDAQ!Q$r(zdsBI?B?+ecHtss_TfUvM zSIU{#sMXFnz%fULs!^+*b5zC1eL+V`d*=j;-WMI5vn(_4rW1{{9h{3SBUw5+*I4x4 z>EzsExsJE)o1zUnJ9c&2OJ|H%I8_%XCrdY$uCaZg_u!*3(e2YsOKcBz*Am-W3O;W-cp&`y5PNkp74|OiFT*cd%bpJlgq16&8=NTWU zXOY94Wi0gusCRpYJAPdile;#?9;6!Kl+dyczaNgR7~#}sNpC^V8F4r2%w_o$LaD|$ z9qX%nX5(6v&iG@Trg%e@N?(NM!YZaeOZT7fJ*bRni?>rKrd3Riu`K>o$85mtF~z(Q z6M8~Hl7M#^R6aCgN%B}s@KFyWMSNb)7L8EnF-|2ZY7f%>8tc@S61M6~P9rI)V)j5w zG)Jm&&ISChzEhx76P@c3q2~pYoVLv=CM)&?JkiOJGD)=fMD5eb&c&7#6YkT=j@gPN zEPaYoNJ{vuKgnq%B}wQf`%|6iQnF%C45vDCIaTjYs;sHbUKZV>raIMHQ(2S52k+>Z zt}MSc#5+0IqN&asEH$1{F*BX5EQR)~bIMGo#=|O~4D={^Q|>iqF-uGID3UjvJddcD zIP@s`E7_^Zau0fxeDdgYXZaG>3A6`OoZ%f+stYNq|D-rGSr*}}NACotIHI$P8NCBf zt|4hoOO_irRrSDD%ySZ?B#VPM3-^aCa56aN&F)xf1F7C|j&)V}EJw~%db+crhmul! zRHi$1dMeqxRJBIBbDm`t_9VRlnC?{Rqhj{*R=n@5?Msp((#qIk7)pQN`B6%EpR&x! z-;ZL#ez?pj5)tZA%bhY(!oKl=Q&mc$IQN@spA3h76M*iQ3-naSSBBG^CFfswHv>m* zhBJ_*A^PEH)aOH|L;tXJ+V+o~$E1Wc{MdOu67w=reeArV#Lrh>9q%ihIV?ZoNTH*9 zrL&Bs-$X5+Ntq<>{RO|^g?v^z*;2y!-c?S40bzY+AZC?QEh6+}cD2(eB6JL{aoS2z zb8)kgYOS+V#rS$Hly%OJEL*0kS>kohKT5<)u380aos;WvS-PLAf-Pr~*Ev;LYQ1g9 zFC5o7?OC2Xpk`&)Im4BR64%h<;_+IKNsI~hxI8RE+3iP^9 z8=MhJjMwMkYYXJF!FiR1);^*Y2tRewq=ajaeCjNck|c_t&NMIjsguF-25MLcveDVd z`Ox|av|7Sv&NmUEwGp;BmpB#8ey>C6UpO}-vIVlu899))D@)Fqe*?*K5+m|0B-=@m z5}p}%IIAM^Gh%i)ML{{R?Zm+XJ ziJBX1hVQMM%!u3tIpFM#NNLD-4nC;FR!kBXP(#`~N1XyJx02PnT1tv2P}&j~A^$iVRE$W*b{Wkvi{*U5 z@-rkCM7ZCuG{BY?h8XSvmMRz_sSMLS#!~u8C6;@dWjsbmim~0_S^nlV4IK9`mY(g^ zN*XSHxI@-i_Ko{cmgnY*NDW91cf&}ENfxPSji!)1?p2nrx0<32B%fPnl*~tNI~{}h z-R2SLf|$G9xk~)0FR6Ey3b-p+#$qLeo`@;nu4ie#N3CdA!2MjOLQH=d^BoJVs6fYQ z0rxD6UK^o+`wvTJZ0VCSmG^?Ip|8i@0&WGCW-q9fT?@DkSoEk~!0o0aHmVnJ6IgVQ zD&UUdRG*E09hwVdW#scoOh|sZIz`YX@dVX5a4aQI^bq7S>_}uLl zloI9~=Z-^b(yVM}+&4Xk(&OC4c#ogtxy$%s19Fes@nw<}xyl@U<5R@#&yv^z=l21a zF>|M}>{x*BDv+v}JBNkV!J7#w?tZ{RYvqxYaKB)obIN>3N%xSHaKtX<{uB|~(o*iP z5$T0zwfDMzO9{8Mv|DgI)j3N{eiUC)V%y8Q)ukl)Z@r_QA(nURNl~emqV)1^6DgU- zxj9%>2~xow$Z{Qb6YC(A+zgg%#B7%G9m^U=t!i7vJt8H`DBHpo-yo)ndyHiiWUrK; zSQcHwc~Ht3mWq&LQZ7izG!8XaYd%zQFR@g`x-=(c%oUamK4xX5m=kE*GYu!O#UD}} zmPDkwDaB_wg#GTepc=l$axY#^EC8wM&S&X-TgyV0YD-K}T*fSBnTT};%1e2drC&_m zmy%`BFPT=6F<&bYr(d!}ZAdkD4@*{iOEi#jh~MFOIdzJHPbO2`}8S@v*ou@3( zLdriZkF{4Gon-iFX|nkgAs3pXCZx4jcxl?e1d9*#&D1 zKNC*C&2QOJXCMUEK-q5busTZ?0EVGmNwLv90(DatVqxy?A{@+&M5-q4b1WanWGu`6Ef&^D7KnL;*HFmw?qVsb|4?I%a+gJf&XuFw^-?m8VK1pM`~_~+Os98yHHN?7W^>L<`>HYg z1@{*vu~Fg$_aeuv-GZ4gl&2Ai{+E|)E)F__aT-h587e^T5OEllH~zh z2ThUEnq@Uc+}9!F+()z^h8lFd+m_`5#(5>}S>DBynpC73?{;FTi97l~FpiCPyDAA< zKA^U1y!)6Gb26ge zv8%5cZe13Ae9ds1u;}A!hP#mSp{uX2kf5v&0WTl#Ao5x-3*o?xMrg{qBq>!uc_m-3iib@n`D$>sYbPuDYK19tp6xDTsmRw_DY5bA zQ=A!3qCP3^I~>ypz4xq?be1nXTl_9%DT{Lvznddv1xql?68}h9$#U<#s9r0|`8dnB zr7&hn$vs=uuqWz6*M})?5tdSX9!zyhvt;0EFc(tIaqCD)6S=nITq&h#D&>NcxkE2ve-B~O* z=BcA#sXJFnvN)N?6vvxT%(6&6)R~sKt0F?%v&`KSkt_r)cdsfDFLY4fGiJCK)8w}M zV>YS&{IPpoiF`AJ=I1|lTfZq|p|}MeVQ8-J=nq*4XNvXQ_dF=+_puxuxb)>ERpfneJmO`kCg}?ieXa zV!%#(Lx=i&?Y^%h)`r>c8YQv%WV=}$^T`EMbU~_Ycej-AE%$8q42yoteTRETN_fQW zbc?-3H4KlqU2X#@;SsmnjprDB#O-$b{wviUcN`0S;n)N9+3U{uS3djPR4K{gbv!xh zi! zI^i`blUbV5l>_96`#MXWJhpfXa@0*z;=ghXt5V@w;;6fbg}yMN@%gB`jHO{qb=EuT zu2mx6>Rcl8IloY~Dt-I*A>;=);cb#+QL+K%WFRNpSyCp6yjkv_5}$e$G82C0X2g-V*0z%x{r=ZbHtx*CUdzHRiV5e3;L|tiJ5Ml_6K$ z*QA7d@VYx+iT?<$9Ow%6y1RsB9?GKGp6l)kma4b4tY+E7vrpIEjY>oZ^o`ai>$;oG zLT`|^hy3j(U=D@)JnfywAUE6x(@9ioJPx_#4pHJaIj(xb9d{H<#q;Vn`0ltbvuuMT zAk`h0-X%po{(+pf7%F9_64^KCzVeQH9`(?rk3o#^PQ6c(EIve8i4fDvw^Yelas1{p-n4DgbW&c^{T;2mx!qW422})w6=ktcM=+g6fV_0<*{U=GRP<&_ zQLTClQrX)pC0U%om_Sn1Tl*2EQuC1h!o>Ubkr#@1JLuIFX5l!O#Rs(RjD7X9UBJ@2fPuvP1Mm;OtxO9{{B^}J4)Ly7L4 z`ra@pVLlJwxeNW5<@|I&-Ft>I)-%O@s81+Qa!lh`s)4xLrK_FB-e{R~*cwf|iBd9! zo?U6`&6X0*`!)44BB?5)tfpSRRaED!fX+J&AuYT(CC1WU@b6NpaLl84lGPg0(yPNU zg$%rbBc-*JOk*~#%vH=-DaoSOeq4{qm}yF4=hIeR?$zNQq$|BvUXh5Pb<(m-hQ` z@1cm$(LLO2EhW=f`80mN0Q+Ku*NG)9COugOL8i%=Cs?v$F@u%Fj*AiAL@8N9->r}E zew7j)DI+|49c_D5CQAwHJi<$k$m_E7Wl~hnoCkT%6Q6|rklr_Y-n*Yg_rp zqq+Cd-WVxoj2rldm#$mJc=K5D;d?!5u@}7!ECpXuvvV(cf3XxBt-gzV(JQc?NKlvE_4ogMgShp3A95M;y4Uqfipeyl z;z`6U$SiLpOS`X3;Xi^oD=+mc6+=%nNK(8{Ssub1T0Tgscb%mgq%dTT_ga=pm5*cI z^fFkMVm|6##LV@svy{f170G z@MbCzZ4RpyW>$Kal=xjQVV@#qrFWg>_uA_EXQd~0%Y1x#SBUN_S9(56wjJ z7VTv|aV+^_Wp!sM4WYL~k+b|S%V|Fs&!doPm6xhwVzUS9yaiIWS=&eAeSub(Z}ARF zNfB35Owk9a)_eXQs$q(ldl~DGLO%5>u^j7+aRsu;Yr^tI2IkZuo4si)-ELqe74n7m zkrdTpDUfa686|#>AJx6pSKjYRgoACTIjgTcf3IvGF&^s?%|oiMyr%n<=wo?@mmnoY zWME5a{rMf^+y z5^H7wOSbA^ujB#BXPdPPYhut}N4!c(a$e_sdep1O@;6_39`%~C1PjzN-=khz&c|J- zOLcrlmWBEp^R}`~OTem$kRQBS2UY2xWA5T0}7;O%Ca zcR`K(mpuEhs^Q*#rpS*yc**O^vU`k*x$F&NIlB&T8zSe+-Z&|f#0`Fz_=>leWdMYp z6J7Cg9if~ji80uNbancdH=O0GxwxB0J~zBmKd6|=5c+n&@K>U5QK}apl*;y>`$@@4 zv>~;a?=NPV^%33+YlE@O-^)@Ksq#Pqf6NI=l`QVZ@l_a-+n+2YMeO?!cVm#e{#llu z7^A4y-Q_nwNvTvHE035$e$k($h)%~<=|%jWO8k%N;mHwViujLnOnf7?PmB1&S;~HZ z74Kxsah8)f;+jE<`8Qck;Q80XQmUO&WxZtCq64J3-Zw_6e>O{L2t9AA?Z2f&-f^sHgEw&eWfA!ta=)K`p0;9}RR?GD-H-?TwJZ-njzAju z2mhd$Orsmlxo05{`8QcE<2~UkkfwgID=Ov*oMCT6n)!{SY_tB}W{RLK?$P|lf2kNc z;}?Xq^2f2z8NVo`wV(gGilH+;#XRCyWud1+Wg%_+?kx1aM0H3ze*?>LT!GYwbntJo zyooCiis|f^`CH{o(j3y&KaMj8Z5O>$K{4HYA7>yEdL~8E-LJv2@ng&cLVEfL5Ek$E zad-;TizUlAjTUS9E}J13t9ANJkVdk zqDSL_{)ULqXq@2Nw`eP}3_ThT@$27KqDSKqe%Cun^k_WNA0S2bF}jx-=}+dEmoY|- zK@CUwa|JFtBHuxe^%wt_Ec-86`Cqa@N;o4u)?aN>&gz*0%}BrG?`6?5(&PMZtp6=PO!CXvlux3_f3K26znhd4`P(1I zn_x{szZVO&*c(Wd55tM2kQqA;lvNS-iTMT*4@9L=1 zzsWSkGRPZ#s+4d}X12co-}ma)pr@QE{w5Y`4Vsxu_2Y5&jqZy%ep@MFK6CtyEVK^H z8kCjhUuMxyOW*YK`l_rgI6f%nxqdkoUDiCmu9R>_XujWAis~)Y8uR^uO8gN^)D_xW z{$M4sdyu#Mu~O7M$OhDBf&V5;af}38Aq)NVi0p(c_On$!vgMCJ(*1`5s&kV6a#J;C zF7+Q~DL+(=t4sY(EVO13&B`wIdn<|6XQ{tQimJ~^XW-}qNPEB%ar<+IBF=3n`&_K*B4 zpEdr8f912rkISj{sjkmj|9&Z9>FfLlIi@$paGLL3=Xdy5%qRY1Qj$e-6RanLm{0r! zDQdsd9QAsCyAppU=A-DYm%qbu`I{Ub_ZE&r*1Rf=l)b7=XEej&V>M14Nj zcJ*ZcGruN_-il3r2NvC`oBh60!tL7PCq(k0kz|X%C6W)x=l(I4^>`9=D{hSlE_&}ZkAhkBS=X>mi@6*#aO6Ssq}3B zD$5KmYr9_rqXXqk?MyM>`1M&Dpl4D0?C{&M?3t-rY^UF!V%KFwXDkbb2 z-}z;vg!5zH`G@bKRMD8@Qo?@toqw4{_rpVe-U6yDJwhJ#3$f_la>Oq#CCvG#Usj4b zcK$(cIqEl5;vfE9t(thuZ^lvq*HLur9P`^Ki5)w~`~)fL*fHASUeBMVV&n)JKz{TW zaXtm`G_Ww_xc@%O*JIW9amW3YN@6)5_h%MV+eJ?~??tK;et|+Hs?HT5C;d`V)RWmd zke~e}D#l-dwcuJp&iE@>^s}2Y{%V%7E%01e#%xj|e#e_LJ)~S`p{K4ifB1`Er7)GA zB0fRR{SkB4Kg=>8y?7YpydQ^q59+;C=h2W0{#F*<=YRLh+@oT255MTgO9}VRCI1nQ zDbv#u6Ohj(|1p+nP<^4=)>|lwp7I=C=pW@sb_yykj-)p zPs!U1CAPu}GFck3*g>vRDpdlD6Le*n$l?YmQo{Z21*0#z_JW2{~aV(VBbgigncY;V3(FT%dzDr#N-X0RU%3@QF|wUFj|SP--62@OkkmB z^>h!LKbXp?^ihyMNSC6Hf-}hZt{_`V*ct@_y9||{C0DSdo=`BTEF~PD3kI!N^!QvT z7$hY;y6+B#NKxb1?jmXm9>3}Ufx z4?<%?<=|zO$&+==9F|Q-)$CK{U?t1g?@dt+TZ)`3sIut&!TTXqfYX$`?DQSw?j24Kg8H{9k1~D|pcz@8kvWn67?+pU_m2R3t z`v5IQ_reW=<1889*Teg;gmg$#41u*4M&p zYJBh>%Sg;a(i^Su!G|ngVy;`sI+om+ji8k-uN5EcVyQM> zz2^`ge9JPYmHMVHKKOxU^8ob*SA1}q#o~9m;)4q;=lC7z_~1{Lj@@+5w^%A((Bf26 zTe|ccy%o7x-o{r*YP$-tydH}w&hjy?Thx}8W$Bl#Q&nYo<_mR}i4W?sl!RaqThc; z|6!>{SA+3EA(s0*opW)P(y^ndEKA?m(NvXX z@k2W2x>AzGY4ouHICA5IrYc6BmuX~c7L1L^Gl*#xq(Z=`t+AO8GCv*%NDv908bPT#nQDvo}tWLp;Dn_>0 zB1q>Tjq`b)N1HCe;(z7SC8$v=tn+fD>Kdd-!7pf|bo$lZNAV>#{g>s`x{7C~h12S@cMf5VU2{BS}Kgl|_#L2|;fqA`@R3 z)7!-f!HXQDkIIB#vXnHDAJ6yb7cCQl<1Bh+>FMCdx~etw72`9(O%{De|7=k3ez{$- z<7;qGOiG&gd;#vXuhv*>$=(Sg9s zI9)^1>ZarH=jfoVl<*iF9mHWAq~r7`#?^wzd2~=GB1Iu%g4Qg_qt&y&u|al3DAh~B zVHSNSJ}#)yQ02UQpGx&|@FvT*$fxWRc$X%4m*wV2B@==VSysMa%2u5iY-Q1R^pk?i zEPD3omEbnZ9$ekij8I}wsF5mt%n~){IXS2%B|Ivp1ob)QJ$%=8FScSzFkOn;U)3Sg zf@M;&j5_$@sS#vG@C2OzBKJ)*gG4DR72R>n3{oP}9I4(2-jx!*{g@oAW6}2@$-x&& zf*?(u@sop0DOo~)`=1<~WYJ&WCkNhxRG%!NS7w+Uf9bR zoECUEDnlF2}@rRl#vqFa7pl@6xFIU zXTBtOLy4aoSLU?q(t|fy=0K^ z>C2#{L3dnH(N@fbyoQ)%!E}}kNE+mW;LV6Egk%JpST-W&J;+DF?<_yPgzr-zD}x&m zSqoY9U+2L!G12G2wK37_W~_^eUIF8inCKNSLeVQ=grbjvQ1l8Iq3HE4LecA8tdEtY z*Spvd6TRNWr!mp%U2KerKH@%$iC*twQ%v++!RDCgqcRk|UP>r>y_8V&ksFF$HzO3i zZpP*yH}3KD`y}){cS}%MN|vuzrT9E3B1QE~x`zBbxGy3!2m5(YIU;47;8{sfU*#j; z65NFS{$=ocLFKZt{|?Pin)kyVa`K#2NPL_;)|!NkiEg) z$5hP2n8PR87v$`&WHD+;vOj3f@(%9tNe%?_SyqiyF$aTm7QELhW4;Z}vW(-LzYFs8 z;G93iJ59*vP!Pw`yove^;={pNmX|-qJ53$&rCX4zr%FZ7psB@<1pWIc*@%3U9AkM0 zZ$~Jx`>L3nsE?A|ET3`9ABpvFJueZH+ z7f=v#GA8<4hErN{>u(uOYjO0q3^B>Azlk^<)R228SvgN41R@Z5)Z(_ZV#&iQ4yK+NUIHFN$j$Nz^(y#kDU;)P5D$_L8Xm ziq-a$sN-HjJ5QqaRMUQv606q9(X|T{qxN0b?g*K~el8cu8saGHTBVnHtyGHWHlqi;nRHoJj&sBNOGa$Vnel0ph zN=*4kHUJXTCXh@njxRbvLRtpNZEWFq$V1vjlKF_43@N4U5aNs&%V>KjW;RlNh?p|k zk0f_7L*RU4e5paZLQ)1#ZuvHs)4YA;_DsOD>P)06uMHyEg?yGkDr#Smtc0wCRMx&F z>5l!{3aP4H7vgMBb?u%Ir$trQ{C#;@PK$a(D-$N$kSV zjXkclkYb--HMKSrqt36IS|*7)ziMiiNmR>>*M1{W?J!=uO`_W26B_Hs_adLEc34X@ zNK`wltyLpYt*(w%R|wV`>Mno%QAcY@k_zGPm+NZ%gg7-;Pn#gbsj(-u>0!catiHBH zh*M(?wKXKF#u{qdNK}nIrR|ks*I0s9KryPu60{oq<({eZh^BUgf3dMX35|qLmfm)K60_L5Nd7&uXoNIJMDC z>qMezqnY*+iK>m}+6WT0UoEsrB&v^Up{0|kJ#C?VOrrMmIqee?)izpcTS(NtKdp>GG+$)G00S{9LZVaQv!Eo)3tb#EvO&97c;fSB+br6v66`SP-{;z9PRKC$Sf_H z4TQJ53)=P4VI->MB6wCS*|6Jl)*cfUm+{BWRjoIGH*e$v3j6uyucfv2!v^^xX5ySIYtz9Ac7iB$!m^GUBby@mwv_l@VR;xqu0ooz2 zpLJRi$=hffJZ8N%hU7V_!wuSEl2KHLpJ{nv!s~FORz$K5Ewd_0&(>mx$kIQ?(P;qL ztkobXj#kHIi`JfGETlDLt2TsW>x@X&6_TUPBC)XV{OEkH<&gXh;d`-7J4-SHtz{rm zeW9_Tvh*EjEu$g1S|t(-bDt(bzSNqL+{U@Q0J2?6Az6W5i_2HqB$Bl=rR>nwkVK-! zc+5`i5XohngIvDWu93V!Iq%W}Z^-Q_nJ!c1X>~|iqRsPE-)M;>zoF)rL-MselCs!~ zjgZ~iNs>Qt1h+xIhm+}gzSA;E_Tb$47jjtJO_Gs;U)4d5XopB% zMr$dKZ91wY50^QYMhwsAm^PTC!z{Ty$F)%;Kce(Fq&luGA?bp%iKjZDttRP@W5H|w zr1mXI53~&)b4n{DS%9PSF!DLA1xCoy_oKD&eLtg>CK-b>m>G_Z{c~ZB}sprDT#>rQCmzhA8o8B zkQFf{ut4#uzc#8Q7?Rh9tUC^eI zTtmy`Gd3@3Ye-hl!LPj#^NaS#TQcVpsIkeABCRn=EK<#cT+&*S%*65HW&NtPC+Ujz zJO?qCwZ0_RP(Qr&UeN}V^q}^9RU1jt3+?`x?f6&J{uzqNTJy>Tp#Bjz8ifMh0GFRzV%wWB0Y&5dL~A%^KuW8@ajMLt|2 zbc5v4g^}zxNTi-X(i=zT79>i~BKZpW@FN(l|4EX8edk*kqZ?yo&SlXKBQX=MnEozF zd$e91Qe0m_vWJdWtiFL{6H@sRQ$jEGj?AYJsrX)KdL<$0tm{N3zNN0~i6mRrVQw8# z8Twm7 zzg$v}8ppTUDZQj#Lx_`4Dg8MiPCjMym!;VGl*PMh{+A!4)_ib8t@%*Sj!|nqIHJ~k za73;7P~J|Z)_ib8t@+@HTJymXwa!Tem5)oUbK;0v=fsv6{!S_yZ{!_O&$TM5d}7o+ zqa*5`v66~$sb`**mBgq!Xh+mK(vGNmYDd()XB9gib?@njy7zQM-Dy^}Q>nYrYPP6* z&+1BC>iO6sN@CQ#rz2_|7)R7PFpt`))H*Pa*`n5gscDN^2j&S|)H*P=ZBgsM)Uida z15?))wGPaawy1Sr>f55$foW)qS_h_)EovQ@Cbp<`V4B*Z)`4lR4+uMV_?`H3`p5^) zo#*t_FyS%J>yw2z?}eXNIooeWY>82;MmwU`nr@|1+3QFbOMXCWu_E+)=&ri z;Z&!mk&`XowI%9@h2%vnUnSqrCDJzMxzzhpCA&Q8{i%{X zmwJDisQ*Cu1o7^V&oxTai@nRYCojT}H+}rN(^-Fpq|GW>dKbMJ$p=^EJnAm`CnUwz zMKXTfNz!vkHWtcM-PIPxs5i6S^*a>9R|w%{_0%6vlchgG^SXQKO-P>KEc5BD_a{+r zlY8q0Bhj2&~P5ZGJ^>KZ(brvT+c8 zR;K8QB*i0@%p}=K^Qcqwa+7(g{1Ov$K$ah{vpY%TzN;fP|qZ3 zjk)?m5R<7FkyOFljM0!qx`BHtJ{zh7{xu2zeXI{7d8Z}z39?wfPqGGgH$3K3eFE-1 zc&a-q@vIKAL_a}N7Bf*dK$hx-VX_^vT(5xp6P_vs|Kd;iR_Zmv>_x7= zH%y*@e5IchBHzD11KFh;AMt&6-tX+y%aN$D`d+;;i5jc#)BBUCk@+V+mNU+_P2WJ#WF^Xu@C44Bx*!`P;ZQWho1%Ra`LyX2lY-Q zbIVFOr1vNJ19SfQigw@WCrK(G74KIM>laDZA{Cb-dd#OhXQx(=>ZOIqTIJV^WBMaP zoEkf>*CtUlc3f{lqH64f-kC(*m7LUHB~i6;Qh$R))y64(Dv7F%)A}wFRU2pQ_QUVL z_}3g9QQu`aYsaYXGJJ1~`YwYb>bnf*>=^Z3h97KE-(@&&i~26ZkG81Usz2Ehg%-ho z6Z*3)>bne%s2Qz}sP8g3qQ1-Ei25!=p`Eju2kVIXE`uXGF&B$}m%$PBOF&1|>{&(dERMUJzuF0B?nS*w z$VGb{*CPEIiAq(Z-w8{_=P?%PkxRt+WzS>0q{j%6Eu3FLF6pi?;iK+LdR&6I^Qyi^N(5j3hhO!s>UT&!z>~KWq`In)St`%v!Mh^aYmndc z%q%HPb4ZqBl)^_u z_w~{_qO6Dos0}WE>%B?7!`;M0?CC#xf0Fa7Wz4@i`&_2#h-Y8?D<{mTM$(}T+86SP zFh*^YG1ZXs4CE7KEG2mpspdeUjolaSxAC zIcsWr#0)OJj;kZ;yB@k7qrU6mi25yqZX6XkJ690H_)UmBzm{X0U5550FI~!K5U){I zh;vQx8MR5&HN|IiB2m{AzcEaTea#IRqbNpQmji~eotKqwUxfq4ZW49f2^xn;)O9D$ zsPvUgrLH@cF^oiAcS1&v0qh< zLXvFASx9vwb|>HWIqW0IuaHNKmL$UX={`Z6CTsfs7*4m zHh!}XdBJE-(rUAm_C^X$LSjgn!)W0H-kBoEb;F)tYn!i2}X zY_uS$hWlK;e#AnLg%11W8HsV>~9)m>DKK zW|6UhWFhjI2>HY~8Ya^rON@U=GM|oQT$UT9_si{R0O6@t8uh}2$E-FIN#>(A_?2j# zksKy`WxVyqdXmRb8$9MSBPUFF%toVlfh;QvEsDQ`&Ngb0oJQ&VJ?v&<8p)5yhrdnU zVq}waLkxe$y485-TbWM>9C!XEJ;!*OWCd;E=SCt)0&UMWV=Bo;)I8t9FN{2rY-|so z(UEHuk=#XDd{)DkhH*fa^&9fx^Ded<@g#2}hR<*L%19!yNOlPr|=qwi>e6 zNDdR8&pu-a$tCPNk0~&gh6#`P);LO1A6xht`YvPf{7@7mqn?%nTDA zbHvCc*;ozl`XR@R8zif-9ub!lMy2m$&RqC;amsj}WEzej|9#~dqf40l06A+63zK~0 zbI$mfq#X90r~1)Y8zwx}PsVPNW!QHfQ)nCu6CQKHxJI%D=gvXo{EJcYu-w929Mcn! zOGX`%4-oSM%-(2AjZX4ALe6#C*M?ZkEEL|QAcG=wc(NC*X}W{07(E}YUqKSi@6$*G(pb& zAjMrRN%$Aohe2XpSwb=x|26j{h~_#jnv*W4A!a}X2sx&=65BB$y&q&TvI7klb0h|3ykoCt}P^w;o0(L#KgIFg~@S@GcDJV zF!>TOA=l3&k?)~*L|G5H?vf1sQLZyk(pB=f+`>wj-@;cODCMd}^7}thO1lP-491KX z{%iL#uB9X!?n`;t_3#OqPk%Z(WnJw_w&7Up!S#X z)ka7L_$*VmvBN}~pEms~%1)K%jk?KiTk&p~FXZ>clOc(&(%;LN9xI~QY)BVZo{)6b6!Iygn=AI5jM<6jK${@R zu9hT!;G4EwUU5w#*^?b1q_3-hxz(cRs+v_^AR)9RqqG6 zr(6y|UUMZ1nZve^#B)f<>#kfO8SDg(;E#|Yu46yTEiCpt*7$FXcZe>dP|8=3DmWHz zx{^t%*Ni;5T4x}w)nrjeAp+AasgUoa-7Lv|hLq7c=8LosPo+_RFj3Zgo zg||YkSwb>cw+q-7#LRbjFUg$8LOy_erJCO4l*BFvBZ^)RnuIztg%m?WC_aSDTt4?H;$oWolnQFbOS(to> zm<_HvQ8MQ7d-5LtGuJaDMI;+ttw`>XY;q-$>_gvj4*6ueiiBja(5guGGTO!#S9CPb zIfMPX5?^ybOpdD(iGL&J`ayDCxkBc!qR;U3t~IDNrD`9^(XoK9`0-)$6YxjC9%z1PPz`^i3#7+X1Es~1Uc<0TSCefoEL9G&bVp_ zNoTJ^-iDlYH4KyYAm>~yNk-x8^XZWDu9h0lC!Kxmj$#WTKe_trGUsTt%w>>5*G!Uj zxE6c{x#-Fv*>xRX{Dc&_n88!cVQ*p!^C6d9rG=z3ZIhJCu56My8>L)zCA(xb7zulzk?Z)kXZK)k{=QCBE)bTm_5mJ{smju z3*vUy36lj+;Tfa5JIRoNQLHaweC{_%rVqduv>|@?2PEfT#q%*pz`aCBI=giiJr*SB z=JWXZ(P@M;Zwe&jzC@|Gdqly;9IxqKbJ7eUO!?g08P9>agv&!vJp zi-i9oej}uc`>c>T?8R1ces5KGbbzOl!p9rc+;xOxu$S-z$?w(1~9lzo~2C3n` zCM2C5Y8AzDTOS0T3%)88FmnhRDG z-y6kZFuob+PA1vwjb?txVD}Iq8LaPU{7wq;x;uwtG}_N2kfHASWn|88;dnKM40m56 zS^0Q0ON5Ma2g=Hr_4{$|K;CgTCK z_>7KEArsvxB(*=3GTFV6q%lSyJZ7ppkHkeWGu*!NGM^B|eCVzqB%NiTe)wALv)%P6 zrg0w}LC9Qp50Z^zarX?F=N?1y6Xr+lhs<{`6yiLiUf^CT#F>q`z+I&RFI_&B<=^vN z;C@j`>~f3&_!?Z9?w%y>+qj!Rbf&wH6!v*NxxQbfdnCzTTP9Pg8@n*FsEa2#?!^?N z*22wn2P*Q?){n&kpWF5-l-~9c=9bL)U3;rGX zPu(d}Vo&sy>wPVC48A#!_8V|$jlwaPqarw&)R143ktT|mqV z_gE>h1pe0Yu$%QUaBcq##`$?P4Y>+lAna6vwjapvwO&St@|2D&!&t;_D0{~{wqvM zK-RncRh(KahFbW{U0R6Kem--9@s}Sn_DGai>(!BUBpcl;t2z0Y$a$0dD$#P&FH`X+iL$QO1DmnR^(w)7Y(*Sz}D zmg(~&S$)LV;@WyrzDL`xVqA^h$6Wvh&bGunJS2)WMk+^|TBEFQ zY*~+Qj(3L?*s|fWoCSB-mOmd9SH>Cnj?9T!Iw6V;Kt7H%u8L>NkRx_JqjAsJ7k$D} zTi!-(a5-iR`$?`wd)$`OKRzglxC7#;oR}=sGnW%~s{OdT;d0WJg&2WwIb}(7e`EN)E$L{P?;@2W3voT20y(E*TusJC zvJA)%N@6DdfosM8$S08Vc1+PVeBTrDlPzO5WdN?Q_s}2yVhg{U z;NJ-?vgKX$M!S*fk}U@s;EglnS6f;?jPVBKvMt4M$8j8T#g_IM#s2`gYD*#d^2?Cl zZMl97D^o$Pxhsnn?(`dfxE~7>{x0$lcfBy-?;`(nHx4^5_^JXo+^xc5_%CQ~xw}e< zRckukcK0Pw>owhWze%FjYr5?oFC@Q&TCeH0dm6>4m7s3B7m%p+qi(yigv?Aii(xtQ zIf0rd<$-*3JJr;(GL`Nb6qbr_vlH{jUs0?U#AByYU)}ZDqQ1Htv_*Y&*Aexl&Y&kf ztStVu+@NPMZ6RMJm45?0&XXmDskiNMo;(uuw*4Vhma7boawA+XN-Bw|S}$6>qjyAY za~V5k6YjM5b+Fuj63b!E=T7B8Z%yhg9_3cwjFo zdb~AxOUP$xFRIu%H~*N=fMcwxr@Dx_7@@92)jTyw)Rm~ZrzVNI5oIC2HUqL!z!k4Lt8jDWR@J4Lp;CI6X-N&rBgsn{Qz6#Wb9iFJRvtc?@S| zS4bl}rgnmydDX-g-o{c8<4EybT4&pi$;rU`XT&tM<-!+HYy_maEz^q2>&0_QTzsww zZyUD6@U_>*Bb6h3rL`%L=T)j0KK{vow6f*G06cYsw6-MGQqQ)D&Y*FJ4N7Q(uw;iL#8_Bk)@y1KGsPTp)YP|8Xim}HVuXy%~BbXnd#v8Aw z7%>9jEo!{+sx4}~F~D<_a#rJwfp&}|wy5#OFpm#+2;p~;!#yR1%wkpXrgSgb*lRZx08z`0PTi)|rlTt$UE$?~i*WzXEisF09&&u~aV}!^)^91(dJx{if zixKJ^eBV>NHcxdiLY;$?JYFGAzdFUUp$?Ck!!A|EOatUI#dDsd%coK7BIE;4R$Uph zX#vK(kZGRXLYz^`bk89na(jM5%yduH`aD&>eU+KzX-cB5GP6B>Nz_$luIF_UbuT>6 zGlfLm3(xmtk*F)t0?!aUQQ~E(E72z&BSDI~60PtwAW>JM6`oh5*jJ(zo zK-FrLIlJmz2>i22GE{>@GP&6lrjiSCBykc~0x<3G{_srJ~SMh*u&HALz1ShPdT0ndcS zvNqHe|EOmVi8>a?JY|~57>p=AdCOe(`K4Dc4Wl9bfSjl2|RU@)BaMdMdTx zW#vWOXpT_6#XiJF5~%zG|OcuaBc6_PJI z;LaBk>wV%mUK`GNs(BNH$hI*7F`BnYOL=ru+i-cik*K!e_KqP@ZNuw*k3_W%)4Pa7 zwGE#)heWjvzqi@*vMkj$N_wx7sJ2ngdy7Q1jdI?9rPytwoHx1^&u129z(=xl>_s_m zyb!rx3n3M}9}3AYu|t<5v`XFuQX=@sd>LXYdDn!=21s@9`POm^PodR)390F2Z5-JT zsplOgBrl@-ZP^Z=_P$3l{@F;D*qX6tyjdjtofQAgT4R1gjK6%B+MXs#V$}9HqDpV! z-6iso`xQj`w%#Hk7b8?#ZRfqymT#dH-Y0bO)@mn3^(0-rElE^w)6Kh%MD-gzy&Fi> znbOl+BqUY572#LUWN(cZc+RQpW7Hu(caps+LY!;LE8by3;%dlF@%Xr7(^>*SS%L+h-d#eeNGta9+MteI7$&XOA@wRsWiMrQ&$2*2Z z-Rq@#mxKww*Gu)Tl~O|8MW%VTk*K@BH1BRorH)0KH#U)PVJhQCndg({oh&4ssjm#Y z=bb0Teop(ocZ(3Y7ms5v-uIpqa|ay!X;JuFpSq?+t4@ggt%qP_1Q zcpoBB?Pt0-fkd^jbZ;9W`F6|v(7QNHc*~sY-9xF=o_^%rCq!;@Bb5G;_dLa@n*Z2) zjYRd>pLzqG5V41f)iR!Ued3y?xIX6entGxY%KXOt-o+&98TIGht&~bVqyF4mAS911Un!qwe(uHO47)w^^K_fHWS9)Y7H;!C zDP&jFzCCzD2l>L=SV(@XdY+lIjeiL zquxP6u=4Gnk!%)Xj(N|M9Kj5ug^=UkqA=kxC%kt^ejSN#gFsGt%k|0Vb{0(x>gIw|sBI$=zTz>T~ zCUIdl%eRor-W-y0r?9<{tKP3jP90N{Pm*WLwsOM0Ar~RPdH*CijlK9C^1GKM%l#_EUfdMoCdsy?G|3oS9wAv{=To1gogLFcNIp~d z-M@Q>lBoOcYu*Wz>TW;z!4=J(p37PjP zAN7PGWTy4u`z80{W27o+ekdg0ZX2b{9VDu4lroQ!sJ2nsydz`|+l3>z9Ql+sYxLzg z&td$yZ-$gL6T)OWq@4M_5Lx;+kn-kAA^8zJpM#K!W)6vZH&NN#LDJxQ6gz{M%H~lL z-V%O>R5AHICx61w95I(6Rn6)oyd_+RR5PC>Q7xgm*;|O*o_mO?ZcdOfcFor?>-TqR ztXK-x$}yV?aav2f*-eVwTAna_hNbc%)e~mFuvGkb)iwt|kgB#hG%Qs~q^fO>5t7f; zGwQnLw_!1r5L3@Q`9Ms4^YK^tHq$s0F%8UTgvhlu>Or0|dkDE0p+?J3n}bNy+ngq5 zCW(5R)5JVNqQ-|!OgF-}>{%>aoSnYT2Xgb5!}w=_FQ zu}9{u%vVU%$h?&~gi@*PX=RQTBKN%|wx^Xjm15Kzme%H4A@aEM5n~%OH%wkYs&?jK zA^9b;@Qc!aFk)$(h2)Z`c^8T1J`y$W;zjc)iJEuO*$fQf zW#vU|ek__r*Tbwlvki$FEq5_rAUT0&p8V~9l9@vCEcSxW=twdrkSxM8Paf0NoJYd9 zXDqg`tJ!U++^^Xfhx0d~-Obm8lNeMi``wlYAy#JQSCt?tOCBS8dIcT($7Ej~bR*-a) zeTs@^M521y`DS+^@+e7ur6lV8V5XTJmg*W(eQfTc81=?*v3cl$d={IrWBB&SvTh^QC#EIjVuX5! z_^DYnEQUWlSY|#YW9+8~%gtt#O1&RkZjKL2^$&7hZZ3QvRhGGgQmHqFS!S*fr^d2O zbF8c}_5Na&86Z(@b+uVqh}?_feJ}^lOcLTe-&k)ZONmfhxZd0#M7BB;sn(lkg*ao9 z4QAXsvUD{j*ZBX08w?pU=$w6r;ux8_kms#B4O9$H|=4ytqx~(zsp*D8e+BYA(MiYf6wV*HPI z{zrWOBfm;>@=5#Nju2b=0_8F9nN8MvD!fw$SyN0 zOp+maX0u5=#yQ{f&8;(KDpgj#xi?IBS-Z{iVKNA^$Gj3I!y$Xk`sp&Cofrd@!Wdw` zS%21l%PKI3F6ENJ_8*L7IR!ax zvSo5F{=#1T1UX^4NY+6vLr$6{NqQmG4ah08D#>NU{0%v6)*)Gem||Gnhkc$z?`{fLiLURX6rR8#FY@vCCB=4#m0~DG+3CWA#!k_aOn%?ES z#wM~a-;*Pd3uZ|nsca#Hmwv&lDMX$rQksQHb8PbkbC?u13df`zMj#i>_euIgVj#bm z^GW_%f?tvfSx53K#04obzb5H>Naj;y9wSMD@O&-~L?*$T7Rteu! z5>=MryC%eWtLXN%UC+y!z|>um+m|9_7MpcCip|CLxP6OBDq?+r#Sqh1C?t&)y(8y` z2Yeeoi>u#H^OSwdPQTZvS0zV@4>yi)Qp&f1B%7qP z@90(;GY6%Aj+ipO#2hIv?22SNA!U6tKbO)A!t*KT%iJcVKg!}U<$ZZyN@;-nxK!{( zZiXshk^RO+lwRK# zy_?6RG2X)efIQ`UZV#7K)^ak|4uw4JOD0J|n=jT6*Kc3Ty)tGLQpG`9_}D%v{M@Mm zY3++eKge@_4eO!RfwcE6lOpz_8KkrC>o92p>FPTfCcIzm?z<*Lo=u$))6*CKEzfyk zY(XtKD<;KPpCk_FL~q2T_!^UBK8trHLRt!u`~I4cUKBI6qRgkSuP@1(gh)05F@1f5 zA4t{LH$h75VAKYG=Gosjm89qMGF5-ytguvkFZ%n|gvl7>Jiv!tz@Ho=@nbsFmXW3K z1`jcB*m9vfe%}lkZp)O~_?;AFv@P$w7|Aw3-m&Fz7w5-Kq?+kV5viOrWu~vx2~oP(i+dub zzL1HrIT13S3}0gsBTx3d8NQZ6(qdIv8NL^#uoS#y;ALg_UKTQkjl}(Tbbl_dlVlge z(_hFe-$)@7?Kge1eG_CpVte>ep6%NyUM~<4Z zeJLaxuzG_`HA;%uLcYz}zP&=^7Cs5t;yX>L)YGsWU(^}7Ju2rMUywxQoa3u1MdZxK zQ8~VNA+pW$JC_{aViI-dvduU1dvSEcn{^E| zJ;^5g3ScSZN8d*zzSUT75K`#NCdorg4&;LGhLBXoWf$a)|Pn$7T8Zoi{`$AG#Js+<25Y0dAs?2#5N`D+;_$&P; zrEr84kN+r1=m_QnBF5(*^}CFD8kYv1PtYIzCzlLn4vJ!pA(p>dm^=?D=^qp(iI6h> z>@Z1&l=oi|lEz-g_V8`4>>qW5=bXk;Q5Kh~{%SX+bjDurZLaQbga3`kG^G|*!=Fpi z8ZiSA^SFQfZ5hL51f-U~8O~~+iVM%Do}c|CR(KyS@p|0I%XXi=LXN&dVjo=+Nk z2d#x~VR!!qyuasi1o?agN%j|##B^e8KP1IpEk?%FrrPM^Zz?2}y#?WW(a+z5Vg^wi zzUr@2Or|PQ{d-4v z3R}3=-=3s4dhEK84gT>Y%NsgTunb4jXU-+3MG^q&=y%C4i2;*#gTPcfaa!Mw(H`6WH98IKj{gXipRVIIpr^2i;HvbdCu<< z;*18*`5zV{ufqJwc+MX$g}t#I<45H4gTJV@+~y^JM6pGXpZ%qul#-0KomN9G`s?G4 zg}06NI4{0{T=r+7zu>YofPI2o^CvfwsXj$Z;5py$?+}v8)|aP^U~w}k3pPZt5(6=ZA#lFAlq4LT0Hk=JTuUju^hyvt(1WBBdSf2r z4NQHW$Dnk~G~f~lgxbhdt0+|{kVtY8{b60ilnE5Hl`&5|6fKT&`9Pf)q0rEGQZ>X(3p86J#UPm#2(6W}=%Gl~7%>Y2i`Pjhi+tKb76lU5OPPrJ zc^R@akh57zf5=csRv=}IltM@vWL@A2$pJ_PWK*EcS2AW8 z@8OclcpKxgBhY5AjNvUR7xHx=t3b-VhWJG)DE$uPyFlh?DLo*3FOCLUo{>`cEyl*L;n{m&!}n5-V+;L|bAhA_QoevxhFk~) zE=k$;NhE6sxf;0gyOjCJnaBJYxORgCsh)@24J`jl3O~R2p8g%kCK-;Hj)?g;@YUZu zCYAB?s~03Xct{BD3$PNxtB}~>m8clRq_Np(nIj?YU|umUsch}9Xgd&JFr>?v$48?T zK;nXTJW_m+Wspk2YJQn&%qvkW2l9AuR#_>d7US#B=q2KVN#&%xhL}9W)DHH4R7zKh zc`{hN1{der)G+vjkTg8=iWE<_8wMMbT&5?$4TEh-V(gf1BtM!eRevd>CpnJN8wNv< z@v_p`+Bp1*AJQl|>~Sega3}gJq;W7%OG=4X@Kg!?Mzi41dR*kwgWHICE|@MPmGPCt z{(-a%t`>4Jq9dNbHF+M#EVx6aVqExp^H#y=CwV>>OZcCa&#~JCO(8O8J_ET;u$qjC z$RCF%)))=94JOJM#>EY37u*<@Dgl`Zl|isw-sgI7p&>^q-> z*D07(Uu=*4%&JrHB@*?_Dlzz~5a$V1VsNMsIdZ6mvJ!)-GR7{wb8xZ{InyZ~F`a{1 zGL?90^dzKfuvY_7tFh`?Q`cZ$l3X0qM(EtS28Ri8+D6x4^@h%|Xe9D^MvDEsrF*aq zNfAay{HaLyVAlsybq~J&K&qa>F(m2yc$eu#08^eyp`s6K?8%cNM6Ig zCgQ)r!NH9wrZQ$>K!yf~k-YFV?wcTQ2J1g7V=AHN{}?hNn9x!RpQq2|tzf2*iEJ?L z6jnmU1aFY|=VCk$86PbBJWn+-_GgTr`P`ngU{#V~)#dNI(}Fcg4xn}CAyr!NNs`y% zuZnO<731xcsJRZJ_An%(4=>C%GjNQzZaF`Y?<;2AY<8)?B_B;|3}CZ#XQ znT|>ZlQi$714;eLz3P?l{Jy1Y?COqPweS*DeMtyt7*Y`B&v@}3oa(% zJ(AqQEE3*pN!cJoo=t~D&VyRZq7cAG2OFBE(Ae#M-d=>`Vkkl&~&F(-J1t$oR z?KukL>?OgaLS*l!@%y4+wh*WHTNeC7irv>O5B?LD5AW-i2LqjW=@;$3Zbh)K5LuRq zoU?*&OA&obDafi|nh>XFTNTVEQ9ax0V7Ww@vw9l8I#``V^=xZ`PY7{(wl%>9LgcY1 zkFwSTpO-Oq>Fa_Wgvg$)I%3uZ$5D*x$2JAuCsD0;Q*Z`}>e)60=L$)Sor)RtwUE!I z;9?<8U$-gPy0bW5;`&uz#JnWM?&~%O2a~A2ZgcSM2U2YgrazEsYj6>X>g%=!*9ejO z&U>w`!9W*LI{T{@-eRHjoZzS=DUr>jd=U(ENOe8std^$l2f|E#eia8j}BQcN!mQ?Q?hR<3~nXa>XGMrVKATM@vSQ60Lj^rN{*8(ei6@pkaJ=197&v} zVlI+Yh46Wmg~8vYh}JR@sV)RVFY(&QVEoCzG|0tZdm*W;uqmGOK#GFHgru=A%SW?C zkY9u4UgoLNSoT9wt^_A3p_t!-bzYG%D=Fq$Fq34;X*?@HK7R&Vrtlc2#%=`L3vtf4 z8^LRRc}%#>di6o6KS-1%_A3iH-v~~Z!d6o+dNVkOMD?^cgNsOlF8Mq0o53s+2H}10 zt>6YJBIotU`Bt$18=@@s0-lF&h1>~d2}xzM&_nKo+zYmOlgFfrceMqOe}ijANb#Vx zoPtEf#lIzG7*hQKG2-@&ma-WVh4H#C&KM)*J%|qy7neoyEu=D}bX+0H4;L_+hLn$M zJWi(C*$8Wu;|*@*xN9VB@NDKO#8iz-8ZTq6bY!eK!(57sHrla0&L+xq)LcuI-N^8YrhG< zWyD$x&&0J6lFI6%bbhbWByQ$Rnd<%W_=*RlSzOL6DX-wZdphL#xcYOXRO-Ok5=i^F z>@e95Ns6m6SH`#za}tsq_t!irJyH5^kbZHc=Sz8^ERHZ_KwJ^Y!`B&$!rQgi;|491 zG5wB3F&}^57FQ=z%E|0V_Aq2*+>no?oR7t-?U2!NZ!VJZVtf=!fQ*ZqNs^6`RddL@ zaRnqRa9(tROpd!xvhXzKEJLQp?f6*clT;7uBtvG$r7V_m6i4ta$o#ma%ekbZx59ij z$fCFnLQ+{tJg=Pz`6TW>$;8J{^N>&D)~t}Jj`WLS>maM+SeBGv@ko{fSszzlNGh9( z*$6uz8{;;tl%?-S56R#DZ;rb|GBy;=_913#T=FUz^Ap|zAA@X*8?su;qt8dNUm!c; z?g&X|k$4Mp6Y@=5jWx1#F8@IG#PuRsGYfaL33!Vamm&mr^eI>u{SEZ|aT`c@&3hmR z;wr6`Wo^TVx(wuKT%nLOwgvJik1>aqKgh&s?0j?;zFfxG^NJK={4qy|}X^!!X078|0t3VH;(tYke>i z0jVOb{+p!iM_Zi*iLs87Tv(17(~x3TL^h8}V;68QvmByXL6RJ_RW5F;63KAPclZqA zv#M?8shlxM$l5MM_SoAI6S9s-5o4r1kdoFJAZjTSxa#;iH1q*3t*0jb-HiH>RyML<%dw*?kMojoVp;Bx}$cb9uqq zu$`w$Wj7F07G<@!&I(CmhjDkzXIgf&0y{*`tamTG%|Q>@(JD={33HcZObscb{Zv6d z9j&CDGF26vl{FzRT8BuQL+V4iScATnF+*`JXaebKv0YN?A*LOqw>3yeD(jFC#gZT| zTOa1}m{hhN_vSA{`dB+iiY>)85YpE=OtKU)T>4pegrs53HLMH+>2KBeMwZnFrN0Ro zU}ckhV#t`mR-q8gPoUC=ScUnrbl$IyMXEQg*xgcG4Kb$zGQz5~N9H^sE|N`!jI!F0 zyo`K4guG?#AZdltGa+NGvqDnY(-1!AZM>DYSLXaMTFNrSylaizCuQ%4a!)5&<4BH? zOt$8d?8EE^UO!W;wIl^&_KUp`$CTeGOtZ=gxhUo& z^B!P^)r&;UZJuEbB2jajXIP_!IJ1;zSTlq;Gnr>tbESx~Hew5BSlN`1dd4`@I$OZE zC!IZxyYEYJoMlxJBKtai-#yE!FJtWc?%7t?17g2o&&`cuUn8G6)=NTU zsy#y9kiuT2n0eM{Ax=L(&zeP|`uX`*$Adg)r=Op1brT|M^)PatZw-(!qMzrbFSL*Z zfB7+LhSEao4G|-I{?j665~Wf-|3}tL5_OmTk+oQeb4)+7{-&67HRZFxk1Wq2zJ;l= zS0T611AJsv5F)qvCzQ3wsx2hnzB(+no{}-KWoS;n$O&HZG&ACDtSU<}T4(9$yS!P`!888uV1`xB{YIa!0j68!8!7!}K zW$idBWfxkw2FbG0k8w%I%Q5-onw8cZA#zWBh*@Q=5t7FEyvov$HC8qWA3saUCAm>c zNgm0HYDx;Eh}O&ZYmIeMNIo-@s?)n}IXdnrYjaajS|ywPe*68BKFkWE%5$v~29>kdh2lFe4)x&M~F#Yz_9l)lw! z_Tzs`&#?{_{0ekwNL1;$R)G+wC46aJ5t6|Yan5ra=&7Z;Qb&< zy=?U-*?=vSa!!am?ozJ*kHlUVIg9f`#*`7VD>B#x?{iVsWvjA~cSX!|Lh3vabInR1 zY1&ynN4jRUCW*qa;7>)aS>1%Bu}zpkETyj$yYy?;+d`bOu31wkAGJL?hsYq=0-cJWPX9ZAF!^4a@MYYT~bhJVxAPV#7XxrH~ae3BBj9FSty#!Wh2yNatV zyldT)G3;3?>#h}hLmt8Hi8ANAmXGAVEjWz$+f`ic*IhejwO@Cwij-;>#%#O}?^=(M zG@!Q?cdZ5_e7z+Z^DN0MdJl5f>P)hp_Uo?Ik0g)Yaon{=lbp6wy-RY_PL)m)Ysbu& zBI<|t&v&hCiWwId#oD9&+_QGvlC{BC?@WT+x0>CS!q*n-1NqmA{)j5wi1CN6Qw;we2X8+WLib39qvrWLy9%MGzs2^%@-KAA7@b6okt&4zLegTJoxt31 zV(dcwCs!T4x#lv8A^%Z{p&>L#T#<|*6gX!_((3PtoZx*ZYlD4I&?ou%KEYRohGD7 zsByHECkpU8O~|vM^Tnk6h%5DVNb}I35>gr<<{sp^P$r4^{lswG=Y|S28Pju_d|S~v zR700C4)<|7V%mnXN#04qubD9hcp-G2XX9zge1tzp_u_G z4L-rYAbmnbBr_k45_>TqR4piD4rgE{6k-O2GD+IucWt~@UkeqH>@=d;NW{DzN{N%H zc#VyN3=J){r0k!K=ai_8VWFcWiE)wQeeTpybZHq=0ds`-Z`Wsr&XXk3@tPGXBIyIkLCow>`7$yUAI0r}%nj8f zF^=FFKKj-9q4p#hcrwXlL1+j`4}2{-AE_3Grjk5|F~ELEW@wKP*+U+Jd=x687(NH) z1Y}X@ju59e{y0?UVZJ@i-RR;_6CpAm-Wx9twU;sW-RLKwPr_o(A?Hs+Tcn8oun4j= zv_pu~8!rt7%F2CLz45ZpI3W}5-gsGP5{c@KmxpFbv3uj?p?N}NZ~Pm|S{}-hF?Q)$ zp$$Tu-Z(4NyBsflVyxMG#Ps00AkXh@nW0NK+z3X+n^MKn#LP z3XS1F;R6r)5$Mf`nc=DWA6zx?sMc;0@eZJXKM**Q^`sPi4v zaJ{>MluS8g-R?iBHn{syjCD2M=zj4(sW!UD2$3!2rEYXj7m~{s-$eh9 z(l@$iQ7U%>Jo_5YU$M0}3Wx9*2Y<|bqA zH)6hZHziq#*^fz(eeOgdxvVdGkiL-b+$lkxPc9qli)Mo%-@A8{#BRXvDM0qS3rrcq zp8$`59B`+GY#9$Z&ycv&)M{;$(+!yz9dpVRKKLgbOK1#;e9 zAS9P<%|m@5SKYfEau)KVJE0cOFNfX6(Q+B`ll!EQOqVq~;=21hNe9f#=cAPC?i*5A ze{9u1aL;(%U8lCFp=j4F5i3dv?q;@gVfL`-xY{$HlE+L-xy zA9BN;BqWpdz_VOFM!MzhC&lH)`yF1^E%#s{S0Zw1MUuQKB!lJSH%($D;LW0YI^{DA z`P2|nr>?Bw>B1-$2l?5ZA|!)N@<+0ekbEKOtP$G9qkneyt1naWbFhJo5t6|&@JoUb zB4$+s9;>%K=~wd)VJ{wS|;DJ8MqHVjfh63XwhRR!C*#Ls_5jm&i4g)g;!u z!5Ye1l7;Q%5ne;tNMiN5HIyAB#gEB*>Ke*kD-}lX{Jf~4oFIvwiCI_8aP}(2LhK&4 zhVuMV_V(F_8rD#Q$!{+I-2Z>c4B)R*o{605U@k$XRhf7Ems{}}_ zF+i+RTSx|Llpo1{5;6TK=9zHLgGtI@EdkzJ#VRRM#2A3rFjko>L>|v25Wf-=&ub`; z=ieck(p5-ixX!xLkK|-PwnA54loGD9u8bkE>Z~iNLhNHzSBgojV>O`EY$dmkb*u)I z;X*RlEo?(J5vxEbn;cReVklKxi&QSF?LoyuvWRLJRCFn#?NyN~sKg7AZI6T0R5l5b zZ8so~DEDP5R;HARZCFdG&_>p<3BCg0TeX(rmf{+D7H|Hs#cC;jA$Ch^DHBPomey7Z zgxF_gZRHB(lXY8`Ra?15@*tH}Te&MFm(4|gQ5Q9=t+Y?z^~q&>F#G5!NPQ*QAsrwM zmE|P-T<#8eOxf*_0g%U)8xDC9(o7lNj^}J2;ZG{B3z65uR}u51ve6+kAo0o_DK4uO zZ4~yj++sEH#EfsTHcBHQ8LkhT%k>=ED9uUu8wcY-yF%o= zIR5K?ot4P;a=-H{WIo!}RjDjQULn^)x+#r>WV)=YR+7@30rp+iTN!c#NH4|gVU67v29wGJ^vZr!_#2Q2PQko>% z`S5@BQd$a;t>9BCdxiT8>zdG8Y41q&9m?vh43Ofg@U}cQ`Y1z5uAn~rtn8zV6q3!R zVl~L)NYzJq+mTN(q_46>h%CJX^1Nbn=Jk>z*a*yH7_O`nBCi_{Kt?G098w+fveLc_ zPbIG;UdTwLNJs`NgV7*A!bd5Mx{9`o@hacWqm;2i?9u5crBH}H`WmGe-FPZ{^fgKu zE+m6}j4u~>&ZCtQA(@PiGYynJS{eL|EUOJ|pD{{`6qhe7V<|?RFSpnjC6!|Sq-{7x znNBfQ|20O*Cb9ajG0Gw#_DFb)@)^bO@hTs)jZuCOlEH?zldGDHQC!`54b#~ml2?>_ zLhP&PtIG6edCX2`T}8(#H%P2wW2`bLNwicPnYGdOvC3Q_a(^|0OjKfe@EEyw;vugo zNkZ&*wUd;7LNb}P#U?3(Nv!QNNl78$_f7nmpQKDBnI9{!;ggivLh$`Eg#VuJB;|dI zv9{r4WhKS*p}u>vvPOvA_Q^_Y&wsZ)RY?(&!3G88Tj^9~lMs7Mo2sy0JXHq!2fZin zE2k(ugj|WR##*l{1BA#cQU`2}smgRAa*OqXWGJk+y~PGVrYoa`*fpG?93ipxPNow3 z98YEUahb}CLNZ-7&=U9Sp~LuM*&Da<+!XDNOXzNRG~QO{CpN)i1IKUQZc^+~Kz_bjEU z5WDTOlvEO{?X#7YLhQEBRt}R`qwd*CDTy`eep`v}E4P?6>V8L=EyV6GvX!|)av6V4 zl7)6I#ICJ?m ze5>*+$)^y0C%#qri^Mv@w<%FC@X|9~EAfVf$81w7N@3NIa{@}=u9O=rW2`Z4ky4o? zlS(gA+(L5LG<@IG8L5ht#34LY4%^l!iuHo*R>qPn#+Dxd`Bo_)X@e)p!yw-&?T5)! z(Rk*-<&cs%T*~Z0Xes2lQuvaTDG%d!oFV6w*(12vN9ILku0!5J%tfU@NCsYK*Of+*F2-lyWE@Ysx`>SBgn$CZbJ{f0QMoWQ>9H z{UpTYi5<-)hw(M|&qE&Yv?95EJc@P2?L#HcM3M*4GZrKF%ASu&=HHSM=7=Mz?-vPyWroSrXep(c}hZw)7`8X-RLwHQclRbe; zM)-@cTAn;1>5RWCc@STH*Yd=^#$(bMe^;VH>U)Yw#^OnP9Y|wOx5+Z*Ta4=-hcxvR zkkrDswEa1F zm!~~>Bs12^5a&a3OM(n}?X;p7Jw9KH)Xo#(S!e@Ox^0tsC!ANH+Dd zL?f}Dw~Y5ZLXvkx-bs!3G$5JwzLlyO$unO0G;F-570K7lE$Kk=AkASI@99kPPFS8J zQNxl#V!bOF?-@&Sp@)3hGu|^%i2SPVbF_WDCryZbw2b!*%CxuYIuSEbip!c4IMFjh zN_f8CM9*9QNj1^)A*Hfr08a9(`A@1zoyrf12R9avjq-xHYQ>bXa9zq|b9^bC({CXdNw{LSnsq?+z2BH?duFF~?A zm*2Eo%KtUnQz9fsq`HNe*`DRI_o&j%UtnF4=5Xd#tjOiuZ$_g14lceH8N! zAd5UT-;pvs4yzbJmU@avwk(NaH6bfJL$i5|ef?SO87;)#7ppz@gygW@7~3>Ls@0ys z@A6bRtOq0>@`Yy;NpuocM}e&MoFJ)yZyCBk)_H2?$W)^-gS{tYy=Njx3Gx{L+2AQ4 zIRY69+31O#D^s;Zs*#Y*o-QQy@J?zxWUHq?$t}#0=DkdjXE4c8l5adOlT^cMQ9Nd+ zXFN&iN-4WMX(WA6RyuOt?KvXE-adOhr=_^8Sq*zVmq@Hx4SPK|NUYfrdp)Hj*6fJA zo_kWnbz>&V+Useb%Uhbx&Tqw&Z@gPS=vhKijBolDAm)(g2FX6WsaXa&=BYDZrg|Oy z`)bHZ&k~Y1aQ$8nIqSJg(yntP`xcKDg5X? z1o_d^{sWoHnu+m~r{)qFqx6+!-SVW7@MD#i^{Z#}QW?{+m~{^B1`#g#l~ zyT4%G{z7EVcaU?0_Z2DPip{2AHk3D&QdzTxqP(j}tR5uV8@WofBHR~5dmj)Y`+~B_ zC)(?gG2xucdUZ#t7g}S+A+E~&Z$~-476IS#E^kv2Bm0X7kxzN=$CQsXvpUB61&MX- zjqz?E;omQ-NEPGVPGUW=kMZsysa9V04l&+?B+p|F6W;H{cu$gC{R&?$w&nR;A-NqH z%?y$AZIWhKAF`H^dqV6z7~|dbiM@U5iXgU zPi4$H#0-Fhy!}3t@;PEgKpyor`drF4h?xj!>@6YLf|wbQ=H8MuGUfk#hqAnm=zms0o|eybpf-q|E&JXpyY@{G4wh-!&*tsn ztwU1!TNK-be0q8lNq#`g4oGir9!Z~uxB@_)^OlnQjBEG-NMEl}@b9t)c$+xnBw_}5 z+e={`{>BV;$Utuv$=a(@UhwWFxe~-(0AhxD6V}PLPiZJ+gg2jL>eIMpAZC=e{#P>Q z9G+S6RAamq*Gu7dWbAdU&g7k4C}jf4L~rl^NjZh<;RA@7>|H|A2UjgFY2Irj=dh+6 z&u50W=0=&S6<;A3lI0yvvIfFa&GMFzj3=4nP1__>b)i)Ay!S}n#QJ;+QZ4W{-z;PH zQK~#|5y_wUrq4voQg7B488ZkmPe4|Amv5DlNvYO)W4B3JNK)usKvEIH^V#g(v|YxW zqP2Ny{RkR0eC038r%GslzN!W@gihK><*H|x3HcSrpF%#4O+6)J7QTRSAEYq$2+1GI zF)t3XAvW&^8S@d2!^4n`vBe~Rq4XahTVi8R%b0VJYmgnW3B^+G;hJz8vL`nFyp)ge zye=vYqoUZ;Bt5WIt3Xc1mi{DTn&|j$9dbT4`By2?Ris>tP5DF0LR`oEi1|6T;4dk+ zQ0K;wzhYhYq)f&)#qp4TV(;JQBCq_tAQj@O{Ubz-C7y>=ii;Iu-?3JTTTWt)QXY)^ zQKky_7Z1k$B1HC;!;sH|aag61mle)ACa%1Y4A-mia^Q_6%ty|lxEL2N%U%V&PFzzG zYYtwWxV9usyze0CA<;B)uWiV#j3#k{^?Exu2;N0QIM5DO56}e=vxc*V%_stu{-6L6vGll;W zN|U%Hm1N9so0!;xP2zr#B5HUPIX8)856YO%)#X>KP2(z(Op1(RrxDXEZXbz)9^^Mj z>$o+QWvVTB`cy3)PfO!!#z=V{>oD*$?wPp3Leg19bloaqdd3YSnU1fy# zCdRGtNxAtIjzh?_xFSQ!oPNlWxZTngjXlhik5zx=t*Rs#u5_gZ}*S45Nh|;&ktr{p({Xw!LZb7n?xOUMZW@p?1k^)@Se?_W2ajxfO zOfS@s%lC2dBr%lga9k2eqBolTjhJI`bq2{)-3H?tHVx0rSc><-DE1WOZd|`1Qd*%uW~M&{2!%B#gB3i|G3 z$OG!wp)#Kic!tlVf|^Tma46P6fmBo%lN`d{83w7O7Lc?<+qqO$_mCV%PxLCJih6?N z9#;6|QdKP>nT~dGsiu}0CQHx99_0B{S3M-F(Fz_@L#;@U9N0F?;6)6?sRntg5$5Zx9NSvBHoR@AN;XXCtF&DogiQ{<=VtnfJQp6LF z4K=-@ zf#<6{=5h59#Z09y-I}PUC}uu{$23tdQcMSmX{uhQn86g&R4t_#pC<3|o2mCGrY3~v z(@ZVXUbbrxeUJ8pT1iN{Ychn#JfYU082)?myw817RVgMH!egFPLlm=|o)R}#>rqSr zwX3<>lwz7wSuNCfis?#awNN`yOfM?yDfJnOd5Ow;O6@~2`OnGvv{VOC%r*$GPfK+K z#aN@1c=c6^8HjNUkBL`PDP{+i)k>XCF{i1lR_a?6vx@56TAfER+o{g2)kPF@gzD2q zT|qIos6K7fH8Mt=7ye|7-c?^md93nhO=AaPu9aGo=2Hqr_}*iRHEt0_{#PZU$t*Bq(%-bq!nD3$fC z;uQ6qBW56SeqAkMh4i90e`R!B&Ws88!Bc|P@J zj5seoLeB51-5tVPF;9Jy^0CJA^VJVXtkUPJpO9E(%~#h8!5Un5qQn{k^VK3DIV>9W zS%aM4QycZ>t;k^!B=4)mBwg^f{VT*QRBJuQW9%)zOidOdj}3kg;$#AtxjuOvu zKUC*RVGT5_Lx6lfR8NzPj+gS0`amC^a|TPr2#xoZE7drXDyXxRIzn<-lNQlz5As>5 z7E_FmVm?vbePup;UBhFD`9$qTa(ZKwkkx7y30o>xLdaJ)k&MT$7VtOD`D#LcnNJ4E zXX>>9Qd-~|&STc7-3Cf|imr8EswYVLJSKmquRu*qmNDH))~RbqKE+%S-mb6IOH#tu z!>`o(&&yP4v^CbN$s`X^OV_J&gygV}*cxZh()DTy#qhS@gltr64wCsiL@nK<_9i)j z>k6`Bo795AGUgh|X0>3L6y8!Evqil@!duE^t7;7AG3o3pYQ;7+Nk|T>fU<(P1Kg&j zlKi>^@7`Nr4ve~tgtwi`*D5l>pS=#}j<8tkaPADtKFmERMZ0!~Wi0v&KGxbB7QR;J zJ;Zz;mR}y0>vMy+A@V#;cA^mR&YOEJ&J%a|Y3 z&J;5M!t?n-?MX39F-wQn=d?P2VpcY;W1~_i4?P)R#!f& zrcumE2#-0d&ZL-MDCV4+O)+I@RC!K)pJL`wOtHF*VpdZ=#p-H`@zUt@yt?L_@@DYBQ>3AZox`fCPegz@bWsEp_t3s}-yHi9eG5+yFeo`lnlrriH z?h+uss4-)t@L#Ls@|W6(qzAr=>If<0yZwrcX^E#{y&)BRWnL8`${GTR@p+_({(Tgr zs!tbUj~uG{5=g9(Lp9%0M?U;oSIzga5IJ%fhkUB}HprN8&JX#v3y~uSK3;vucU-0t ztNBeqs)v0ygxEci+m|rbu5%`0+`a;bEQI)dS>t3&t===>J0``&&u-o?2YeSP#_I6{ zzB?qm$6twj0=~-QMLw=4sK*cZVo7e{-Kxyz5t4uKzCg<3B!8eBDQ!s7VlC-LG7qzB zWK4e{_BbKn8!BVO-uV>u3Hq`eQV6N(`%+4Hv{TFX4T&{QsO39EV$E%?`kXMi=qT@%+#?nuPaXTbUx-Ufwb@y zlayXYpF0D0K)%AsGA0sd%EOQjzA{t(U7yarN>ao~<_SDq>g;=nzQosg&e<#;ZwDGdp79k5$z*xB^7ELUz5`Qb%t}a0NN->QV3JtO`rsp?A-*HiWy~_n@!&GdSMr9G5Muc8 z{GzWgOUmbn;bVyxeR(sbG^Bi9@}U#7D5`xIYu5^IDu z)i<2P8v9N4&9!1sJ)ZMa-!_s@aMc=(oTvIqN%(%}lIE+qK$d0g!E|2|3EzV}Cf%1s z!nY5XX}(P)eEaaNk>R^bG6YB61jJ1D)p_sV+b7ePOtK%_Cmk_w_?DBnuzhAhX8MXr ztnD+)SMhz3Pk8&x@(q^~J}+kb@<>#Sqvj!>w|&=0tYh^ZU-gBuKGqg{#}`jx9WC$p zCX(=0$^t6&)gL# zYrZe`1D;Q=7#ru{EO^hCK=OD)CT5Gh?;AqG_g8T|V+(z+3bF6I^L(ik!}s7C^pZh{<#y;|)!uZ=!?#rX{ zI<_(_%Sk>COMe=NuMSH)lFxiUi=1VTzZ7HsFMJgj^BU%`tuHX~tKS7aw?n=|4ZjNK za~rdLjzKo~+AiU#?A~FcufGsG=Z(JMLUPyz%v$96Z1EislFn{I_&WdFeT|m!e0D@y zIT!gxe#phnXQwY!NDiBbH6M6BdweyQ%Q_E_ix#raH&;kTIOqMof))SH`4F{YXC-Sc z-w{j7Ovkrfy!Q-CrRG)TTg9W{n4|cWKOSSt4BVsf6`_xXW86bA?t2;Ug~Rer4Y{t- z8A~czvjmI7V$BjP_IE5 zv9B?S)vjV+yb!saD|W_l@0UXAd&uk8>C#F5XEv6G2_nPZL`d0 z{L|4a8dBbWh9qGS{vYH4|BobNa7}m&`Be0mk}Rtp#Tp{!L4WENna_hCV~wef7*YEZ zw@TT7IbA&v^RRy+$%jiKSpcH=o9~qM;lHiC7O6D<*zcs=?2lh@MOmhQ6Unu^Q7j)) z(|?U*AVv;nkgB#n<$z3e)xcUPh^gb>OLCH=uK%u(Y?kpDWBpM2qyD5rvW8hW-!CGc z2L9I$bCK7dvpByR`SXOxx%!tOjs16p*iT9y_g6e3OSgVYtBJpr5PM~zX8tZhWX}BA zX)}Maj0vwS^n`yl<-?z*^54>W(*J`a)eV&1!e1gq+?CvcwDjMlRMu~4we(j%D(hoC zO^x?Y6=L5L#rv~Jtb3wX{y9SIYi}$60wMCexQDV@`B%x9aOrLQYlO(_b95%Yr}o!9 zCbnVtm$N$h8DNx)t#|ZyCMm(%ef<8tqrWf7-(h)?#G3ip z(LY9rd@37*`gHWC3bC)x9sRvdh#H3HUUu{kmLhu38Zwnbe2_$cos%-v5`0_AM~vP5 z{Yk95w(kCygk-q*cM39Q5{dPddUyXUlD}0e<`a^wcy=LE9U|G*+LB*|$i2gB*xm0s zCF^6|4<`8^BC+a|Q_1VzpwrfB4ydx8hAdJ150z#XJ5EBvvc3 z{m+tEt$5epkHl(4j(;wR)rxuk-9qeE%=a6`|8B)Xe+r4!iah@tBvvav@XryF&Q7+* z@s6#r$iInXDDC&f{^93&&grZZ$x?s(1ul5v>c!kur25d`kt7;20kXp1lVk&amAL&A zjD74MNRqh`cM^zM?SIiBZ$Litk0*H*G4Ddw`lmXC$E@?uCiwRpvh7^> z`?x*+WFZ;iJE^ru^_{=wWlK?A z*D+5Ia@Jq*nv}$HQS1ujyubHPQpUBxuO~pR`%hn&G6XSI-@sF8f8tFp*{oI$?)dR# z;ywQ!lCtkau^?jZ`!5MeXZJBXqAny-E50T3DNV+&=|Re9gG;3B#(mu70hkA(9UyCV? zYHlHRpIc4)QcC#kWOePRBNgvqt814imGyS=A+1}fo%3_ZxrR1Gis;c^fVj2MLhQcM ztre44eWjv3_nVy$zw=eJ=Y_~)>_z0GXk%ndIA^bxDn#~`V-Vxj&Qr`j%mL4%q+?kAA+f%F3uxu;i2As!-ZP+8Cb6FU2egMtp2e{t%kq&}PxS*@h{Spm z8qn&ISUqe&Ya%4WRpmIYj%YddyHFXg>n zNUKM3*<(p_64qJvgCVVh6p`~BJ))%uk^6!_!+%7pd6$=!A%0bi|KfQq zttrXu_42pW>uT*uI$(V^{_E=Xv=oxK-|-$2Wi`-VBQelhNy#F)gu9YOBIW?exhc5L zK_1imf5_5H5c4Udkv5!U8+uq?*5g{mKV{5z^vk@4O|@8utV60Nwe}?ZIRH-;udS5g z+EzgxEv>cBNghQF`Ce|V6DM{ykTR9&^K`&_cI0s?+_3DR9#K=K^!3ywgZ)h?0vkk1d0p4ygw zWIhE{pT61wAvtW}fhe{GUljJ&N=b$d#%*|+o zr*m3LBu|y;y17tp`ElA<5^L-?PD>}T#(v|pw@IwA-#Bd{i8b~cr>!Ef#(v|pbtL>- z&N`^iIBlC0_P=tNvDui*fGA#{9g!1jMzV$?CWT}ewnj6^cr8`PMKU~hp^s7H^^jd1<7U{b^M4*)e3~rsvU?))y_C%0Az}GU5MO<{OQwF?N5jB zZJ4I1(Q+H|s}{ckq-(XMgxi&_wGd*rD_!eEVzq0U)|bR;*9>hqiPf$d+5{nXyWY@d zkXY@?(&h@0?HZ0&WNDinG72(N+bcx2>ov$M?XE-KfXvZcWq7;nqh+qPNr-*4%+rdb zFl#2pJnbOG@V)#l@|mZdq!?=+$UN-|i8T*oo>nSkCtHY_d;Cb4r=^zVrOQ?<5cz!M zkj0Q(ZLJX5ids+O>43IJh+XIRwescuy>}LBHAt+tOAEDt5WDn+TD%auFIcF#AF%85 zF-l*kwQ|TBNS@YJh^){5Ad9rV4%q=&s-+3BYxt2CQ$f^_4Z^#1e*CP^;z(+~DvziY zS}iGJm6iR-XNA^~#5!|VXw8M#tyrNI2$9?Hs7Q6jA*UfLwd*n;(G&4)_^}pIk=Mtr z;cBgwkW6+H&n|ck^R+G{D%CJw>np@AJztwCV_f}y#`>&}W7db3O)?7dR5LE`lf1G{ z_U4~z%Sfg`c(3=Vwpxm)As?lDhIbVFZ)cfV6VY2CA6q(h#V>KAUAFL*IqyQg)HaHI z?BB}#QY#X&GlH*Adtby9J}BDGxRjfTk-3%>!zG6e=p4m7ko8)T5V@CmeKu(OgzSt^ z@1PGv%m!^v6|qmlb>65g5F+Ae*!u4(SisqTLX(v%JbhwbebEQbWXq*Q)wfGo^&r;rv!>?vOPPU_D_i+AVWlofyT|psc-Gbs_2EO0q#n zHqVXBZSy%(;d;qIbu$stYg}IDXy=v;@?k@Q`!!uaA8^p9-HB zeBLQv3(l6`rs2qh{1A@e=gtlEU$*dbrvzpFpgkgT-Wg%7YI{a&L}DG`XSC5eFFl8i z`xWoU5-?X^%NJsApJJ`x|H%%A@a}ihNHSL73xGHA9AE2C@;jd4mlraGWC)&yMdKRvllHO{ zapqPQF{`A6&y<^5kq~=d+|-&Ia%+@(IEuw0)lDriDCJ>DZOG4BD#@=;V})VJFWOy_ z`?v5^5^`HJOqr^C-$>R0QmPGfNH@rD+DL~~Kwo)B8&9$+18=qw^Sd^iWbs|BVg$LX z?IwAlCcX=R{GnYU8MHi-jfVWG4G;0svsu!~NH!62Pn#_yhmGBVD+%OpExM+xVU^|h z3J`K%YcC|5Ek-MrLL&5hiunL*5w3wm>6dEBRJWTkwh!Xc^J`1F`c)J=2dSv9sv{+- zA=a~k#OTR&r5qX%$?ig`>J=ZA(zq1AbvO%iSM*gRr(ed}ybwhnTu;V~gVch=>1*n9 z$!5O}!FzLvU*9bxhm}V@tst5{wt-Bwr$Z#`1PSOd4W$?zBiRd(kiMKG^UEkU8B$xX z{+NuZQ3g*KFy^nT#|g2oE%o#+LUu;%L4Dpts(N~Fhb(|J(C0d2HRLgUi91XN`G`Q+f-@X8l&;s6?tK^|Z%D4BJ-|E7jo&&_aKQX_d>rI=;8uobvdj`^0cQuuA6RGM$p4OL> zEZ&8A@sJMsMv|{cI_W1!)+6U0i0Q1?Zzl8MG8ocTZ%$HmH&%;;Jfq)m$V|wy`adM! zBj<&Xp1Sgc%%@~vB>Mu=Tdz+Ng=a)u`sn>g&Y`SLkbZiBLv}$1=rK>qe7YjlcaUU# zn?o)^2I=)%$e4!_Qvw;HFL4Nu8Ky68DPvxK6n*(yxR2AnBAG&xq8F3!wZ1ALW~AOU zUZ�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%0AF$>M64&gC*=BGkryAHR9>rpsb6G+${1*gr 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 z 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

  • c0De#b-Ed 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

    v_L< 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%0A*o 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ΝxnKC7$(a-no_HVrgMX zG9@NEYFVc=z0NHFZQDa^x?B$^7@1SDA)$ufSf2Xy(!xSa=BDhjrLPaZVb^)k8}>3} z?=25HQL5>r8{-R3HRq&AE-F~;7RkqzFA999?xv9-`i-W}804VMnn4_IPlEHwHT0i* zJ96J%R##u$kU0Ypup;##iH%S!4X7baGDF3e%;Dii5m5qrqShdD+Y)_5e$AljNa(hY zWjN*tyOzLQH|0U3+MKfX*XgyE?+*rbAYHF2CM1sJ3EA)vAn7%xG*&4G&q88a89gy7 z&AE}f7$PP%;OXfsGlYU9OMGysQ0Y9BSS}?BVFJEPGT8)vr|6Nl@wBL%*J~4)hb=0F zhX*)9_SwTabQ_+8@dup{?}qemEgTL+%zGGUz=_7+Rc_f*S3F$=5VF#^J&x~iymtVh zEG-E7>kn zhk*g0;Hww5f!13{LyVK>HBb_}gl~oLleK52Iel$bX<>V>fg`+O(j%)DoeJ&j8!w^; z5DAzI;?-&(J9~<#ZfVmXwsq3`4JDwAvB5Jaxcf3l8R3uz+Bm#O5FI4fVjh&Y5@*2{ z=ZYI9>zu(G*|IR4+B_tf<*T7%Js{6SAWg1?zNAZdB}`jR%CI{t#0qz%RdHj-KH#k6 zuq8)3o`_LGh{o>7z5;e__-oZQIg8%ULb8vGLo~ZtZKeTVK0x6j<6qC^2YCS(h{8)d z!QI2);%rjE7Kr4&QrNENg}&G!;L`KR$a zmtOHfbvZ4f#5z8Ccfn!l-pCm__nJrv0 zTG{^U^i}SUV*!Uy$ipQ(bxOQvqgb&1(R?A(G6|1Airg~UPzra{)QB%97A@%3bi-IF z3csQ1eo%_r*#X!d2TUopd(pAJ1e!wngCz7lD-5T=lVS0@aQ7h$p}2nBU`g|74zCs^ zI|rKsD2{4cOpDWQdekA~7AgZ{DVj%E%G>tHvV1Q^Z&e{w>*FPMq&PGP*lLdQfW&3B zjkYQVXV zMjm&7rNI+|u$HK)xttTLmaV(i&F>eQYCa29=>=w4VT*kYy2xE_%mU zSjIm5?RKZCT?QsNuXWJx=`@9Uj-i~5uLU)*%WpH5$tZV}Cl?n)q=5yAFA#MU99aX} zUy=)l#0nZA1dS3Dy?jQ!pIbGeA8d0+E7GSLE%>``S}&m=C&HYo)v3l}!g&ob8;JCP zAdr7oZ5{<(C!H8PyWAG?h{;h+K{xRFa5`vDgM)630@*3>#zv7m?rhA`Ih-1uKTz7d zT`>ni!myoje3TEdU0xHaQD?3J7S?Dp#Av2_FsGF7&-m2&T1e9w<`- zGr^#77mJu6!zdcCEpqGJoWz^ZTx$nrx1C*4z;7@e+%{niZC-R0e9q4$M)h;;Ayz#` zD4a^oIC2c+tKy6N{)+)ARjmNDAcYZE@<&AX~^8{{rpY=wJR(4qrU{X7oqfYQfB0`Eew zFLczjW7cH^dkP@?1#GBS*>!$HpI+s-b;O(r4Amv(vvz3*Ui z;>h9y$-0Q4&>wG@RjV;0c@VR6Lr^Xab>`V8XD%YDy#556l#DkTT2<`h4Dr#e5YkFR zrb(9LR%^c70OT{G0JkMZe3)RvZ6A5q3?X*=47CJ5Y8PL;(DRNU*y-FUcUI?v0f!6a zManN`#YPuJsisn2Smh`QBJ+3PJ1jF?nJ3g#ZAe)mDry- zy)i(lx=9R!qtS}#C(&o#@|D_7ahw%#K^+D*?Hp8tt5g`pr+3UBZHy$ zI!MXqF?M~1(VKwIV8T-p;C)u{u)*Cot|k+Uu$Rq$A7za{efAA4z=*veH4FMu5mFkD z2xgr%a_h2*fZpe#Y0e>#VYL9TjjzHQA?1OGeASIyb1xJ}k(T-cZWnB~E;a`iQW}L= zKz{ICT)|th$2b0koaq z%haA-whG2l6G1pNO8tobUPAFs7$(TyQ3Qe>v2&h{U0cF7I_Fg{Iu<$jv=BX~$-8Su z%e&n^d_v^(0w_Dugn-*@m|`HcDBMr7(l`=`WxeJC-Cr@-kHVab%d z55*T)2gx=qQ$F{klyzy9#4F5h8sT9nmeYPa17xE}cXyfJk0^8ik;A!r8u3sIE=C+p z!^(M%T?*Ph#}KXJA>P^)WBA*H+?lAQ8vcyda7GcXY*EN;h=?IqK5YbHvgl6gr(SPd zV@T<0y(Y(|DR};p7fOPN5)_%-{ZBrk`!3sg`@Z9LDoqnBE_ z9>Di{3{>>(8rq8CY4(ATYr@}M)5-%vxLJjk-#O?SJbc4NaUnrv3gC0MR<2M^&?cu| z`Do`$9(&h)zfIQq9zO>!2 z6KS)FNz>}Nc`hZ(+|LuK9akXwZ`fsx8%_w1I>;>Ng1aM{(Z#lwj$LqzE&fF#4De%E z+p#e~HKI#VIjLbs1m_Ed_Sh0IM#5bR4aYwSOVr?%M##ZYaiymCf11U(~wGE$fm)YA|1|xXH`~ zD&?rPp5MSh?Jan7$3$A!n&wPxo1F}T^$X~BO;6qh=?-GZF?shZG;P>*O)k0C?Wid) z=9)Yc88++)2Lf~kGO{SQePIv4=z`Kl{Guu|ol4_p8CuC9FDWaQ&>}aO)qD?j&xU$R zb?%-j?zqa2D)S+Qu zKM*px2Bee*qU%~uIfDU3N^saflM(`!O2yRBa)i}ZWN9~o>i9wHDBjygY$lEDj7jjK z*bxuuGl$5JO_!-o*BY~(=5yD*u%NMcS4S^X(HJs9pp)Bb0c>`Cu!W#rP?OSYza;oW zKBZp}Y2#J}xEXI8IzTd*CbKxqWyKmeOKOcz6sS9IUHN{Ns`CPi9h35peI@IA3htc( zs; z5J+x?g6xMp-3*b$=-)Xap(cLYy9*Z{WXD_wrAkQDUN2O$m~t@zYX~fvefz_em^UqAP$yyZO$6E( zXrZh!vG+TkSR1sdO6!D>qhEm@Sy;I>+2cArrZo;S_Kf>ox-q9T2m%>AOb%%+Xj)p? zYLnH1yU0VJEG?8co{`Qv(c?3>uss2#R8)q`SxAW8hIz+tC2!0W<=|k2;NY|{YFKMe z9YF)Z%uSslSD9Z=lS5)0vE!=_ne8lE0XRNh_!bZ?!?9<=2pIj#nM0>vW5zLHXTn?e zy81A}glSO3`y*Rlx$7NYU;{e1Ytn?Cn^DNMG=EKqrw(u*+)kdua z7=6mI!FI3P#pkYjH8r!AD-52)Wu>E$pC-Jkr;$0WNEQiY@l~za^ca%CbZN`;R0A7O zGD7)X{l`zOyIvUW+l47W&e_WO7#Vwkts;RM9Key?7{ydt?S&uIVW(49M|@>p6l_wH zBAqO%I}l+!nuv6Ne0^Qn0 zjAeUUtU6VFFJe(T`BJXigURV9YcCardoFNM3PEec){I9imK3TB4W+F20EX(GzUx4+ znLF%;tvL?@H0vm3jiWW_AF~C0I~q%d<%U-r9qQoXx?mCG=IuGr)M&Cktfmv|cp-Yu zkJIwFjxt*&JTvfvCi#dIX~+{%A+W(Soq!CvOQfW#xz!IYFyg0}bo7qk97z~0+VMbP zn4Oqc(|$&yr?9jd)R3$*cS)7fOsmBgV8EbyNZ{fOm8T?q6@47@xm9#b+Z5^rAS181r)WMO~G3?Lv(*k?eAk^Q#FD8t#5-YTcx>S8%S^!l8cSN_*ybSty_}^p|ne z;(MdKcal(Y!8j7ma5^KINw0`gKvCeN^{Ia}U8$lNW3>}Lj3B>t>3HV`!1>|96}{+# z7>L${0y`A5ox7FI^^j*M3XK+Dxra1K%g?diee2%natS!l#N-}g;97%0A;8Ipa#vLa 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 LZ^&Y*^NXy}>F5ri8r_)fT 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

    3y?l8@sc=TgfJKf|N+i<&r zi1n;bGgxS7BTn*?yDN0p%f4jBs@J{aeJY@HOq>lT z9=i;~?KpW3t?GdaZU!gv+pPwOfy~0zm7{l}{*)+cw}pm)FAfK15@zPSU)CV=t}MN( zmM{{ncD{|}P$YG7ZjfMrOt57-b?jzNsjw-)<4}N`L(nXsMzM8x=}un-*tHKZ9-$Z+ zbUaoBI1gn~okKuE0R+P(@_F0LgFwv#ud&n3fdGQA$&eKtMB#mLWI=ekojXKx<6frq zHmx?mB}F(Edrg~aA$ABe%g>y@AP9MJYL>>-3=2EnuGUJuABR&)0ys-WyIiV;HEz`M3pipXCU@#tt$~m@D-3)VYlH2bwh}`qSIglVz z-gx@LfZsSF^*WD@tmKYBY@X8y)r1bShVmB%;4{^J3o!0i%v){Gqe8(t8quJBO$}tz z1%`#u*hp^AzD4Zix@?G;>2__XmzgVItSFsSshE#K&@pQV9Y7Yx9v8kI>~J;mrr=JA zx`PGeu>uC`z}QV@9=SsGV*>^{pV^51s4`Jw3?PL&1|nl=ghR{3;n(q1Cb+;ws)Zt( ztvm*LAyj&XW=^BKX#=n^-pXZ7_F7Vz!dQ`<%8J}Q&9#bPnwVOWAXXB*wir1I?n&iM ziRGsu`C(z}zQ{~;gUmYY%Nni4g80i>0q(70Gfg#YC)!5waB(!(rV{c-Yt$?!sRs{q zFS+$YoT6*n4QA`i0LHJN2jjm;uy!uwYYFoRb)^N-G#l95II#ghJ-0d;yw8DhjKXc0 zWjuMQgc^}tTj$X!5iG3Q>&R@Oqz^0gs9YnaSJ8QN4@U&F6AjqkVh>V6gM<0vrUL^6 zF=ds#E{RgxPmZgk+isbHW4`P>4j}J&73Q5O&^>_L681O>_^p7ZECLsbIp-f^9wYjv zf$Uz0kQgZ*o2apRq&y1Sr_%n^12JbaiD3biG#XP0S$IWbK*P@qO;O7a?2 zb#Ss(Zyr~0EWzfu%VTqr38~i1Pi;RZz=-(bC}_M`Jq8L*Xd@!`0Vp^#bNc?%E}0eh zqgsb$0c4=c1*>zyxw-_Kx{q!Ol#xYn2i3a{6Un%u2D<@?P6t8>dY&Mwp|VqB3@|=e zB&+rVuE zT$Yk4FgV#o2qTvZjZn5Uy3T|4dO?)oOSZcymx@oqa~)LW@@j}{XKPVb)G*J1!bghC z6vh=ggxn~GnAS$f_Lw>7D+dX8v$)&4e9|E)UCs0`d{gz%aGj`}sgoX;% zoaq=4(*(#c>ySJjKDQf=?x(GbAx390d7&0NNUE?sW)Cr}It*LGUaIww=F0a~5HY%Z1x;)Z?kayb|lLE6@Sqrgvm20hx zYBdyA;J}e^9e9O*1-69GZn@X z@wgT1Z#se-d@vf7uaF$KR-co;xpII?BKC>rXXcCPx28KZ(Z1s5#)QjEDGwd6IaQ4s zOK!P7h$84714On%kh!ua9vCbg<`dW<>ierO$Oyf8MGfiTGHROdNLYciv<-3CQmvqK zs61bHK91BpYFpBDvDeJI>j)UfY+<=)0ln744kiRIxio-;Y6fQtf=>QGW1PoMSB$-V zzBTe$g-!u&@+dVNNauoKZy?yJl-ESjLLRy_qi2+AxHqqrM`dh3c}UoW$CfKMT5~Y) zl&PK%T24hd*0MK=Q3X>^k}hccogH+5z`C=NI1s!(N#T&3Jj2JJ$tHf2W(ZAkJjmtf zEy5OP4SWE%;&1+kvpIm#$c&cnmX1_iY6U$`_WrlniqV?O{M^S$pd^ zl{w(m>X33-bjp$FD1_usloy10easle#h8G3j$j*a6GtDV(%r#2Z3;`x(~dUR7ul$7BnFn zYFX3=s|XmAzEPpn3_Xht>=aqS_Y3+>li62R5(l>ge8r>{rcBrJDu!Z}t*kM3hFhQG-&ii=Rr70cI+C}eq zkn&>!k(~?K9i2~=oT`sxdKrj&t|FQ8*n(Jj7dS@~g?)3iIU6Pxm*hzCiW@Ugd5!8S z0o~1w_%=Z+&54k4vEH*wGDW8D2X>4rs%d>HR7YcZzNPG%=7D0#jq>|FuS<>f#xTkZ z6L>`maAG;?Xf%By=Cag-$@B2L7u2yXI*2;#r(yfNBe=pu&c;`WqfV&hnVkh2(#h_k zsKtsBH7T>FGs1%vgl4jY2zb?lD#T*YuzT%oGvGpdM-0MPXij>EkTG9xh}A7~%i54_ z3_!GVPFEp1O9!!axb$KdLZUmU>L7r&H658v6|~uI@=(SU(E`v)G!Y)kruOP!|6k3kTNVG<;EO07s3IysSb#4@+G$#cd zR4y7#I9l6oyC7fK==y}a#@eMPs(y+P7S&tFKqmU3lF_IV=)8Fa0Xb{ii9yTZ%f}KB z{F!&ETB2oo;JS6QA^j_Ffzdu41~I!R@|X37;ZCJTTdwo*i^^c$Gdmu7!WGlDEM4D0Wq~lB;C!zEsAv?i zA^}#Uoaz%0ZSd#ZmEC^{3Iqye@>Y@YnvzmTS}}J?Mxi^whOBuq5%AAiJEZV0Rm$Pk zk%tBS9$>-xDj<@j+9D@E5z!y=(TJtF>MYj1b@op#v+d zF<2UVk({kAf4v-%>!!-#B$4fAyTmB_CUwUQy3w1 zm_fvg=41l)1Hm{cqN0e~I#dMELa(tJftyXObQHTobD2YOZ&J%~BXLuMz16|m=DEX{ z)9lbsF6=TAFmEhycm$+XwK)@h9hISZ8Rk~lC&io@^AFL#cpM6z!^DU*hIhv~hasUp zED&sHv~=ZZbaz8Lh~UBKz3UG)s#3NnItu77d9?+0pEz(Sav?8{y03OYtpJwOfYcD^ zk#`czHt1QLMvsAKw*4bZgOK3iKH7wY2vHnk=bnkhG+y(%Fy%6zMZCE8146;VQwe<#Y!y^DF5FYh+MBcW~*2 z;;s;b;pLTwizR=!ny==N{-c4!WXxZfsZ_WoJ(+W8__5&V7Fv+Z#ijQqhYRe53aszF zxQ@4+$D}*uuD4nuC$>~|pwC`b@FUbDrirS|si2rDWn}W-akclXg?7RJyEWD!%Z zs1$74BJ2`&b>9*M&kPQigNfVCEEBdCgX}{A5IRwp6-${k6e!B6e1Lb$%EGqfh~JzC z3S?{+Df|iad~RoYyPll1S}G=rl2-v~!ez!kiuU-YDKXBqJRs*B!hV&_!ZJ%xS@1&z z;Bv}9GYpQvl`~NAM|J98^A8lrF*tOA9DTIqzxss@5xfhO;4C{wB`XOu)T z#Dco?Y^o8%uGU8PRL*t`1R!N$s0szE=@rs(yDmD!&yB*ZwHhLXFOWc={BIH9T=S13YpeF(F#H93D`z4Xy@M4&EuWN*gf>7CeZ+F!XaFpwl zUmW2Fk1frmkb(1RwiU26$X@w8^W8mfSCP)aM_5!>E@ZqhRb+O~3OFJVrn+z#=%?n_ zlL7_0uRy#t&Ib~e0(Xhnfe*?CoYU>Cb=CwB?+Vx7HuxP&L=?h!Uzds7Z%&8Ej=cqJ zULCFvL$QFzRnuHZFPz0XJ>M%mEsUxJk-McgH_7SK3Jgb<>wczn+5NmNz}7B$5|N)$+zhX+ugte&nr5FoKf+ZJXW zEyLidf1von6_~y{kn41icH?J_p9BW3Lg$>)bQ*J>v9##xfjw?9$_P|p#EO(O9jhyo z8MjHn$QmKR;#rz7H(m@IuK1~zIH@7Q*;o{sVH*_+fKjpCm@zqz(||`dc4CI{B!?-IMbZOWUQSA{d1EXVyj{7Wuv|rf*v3m=` zxOfLdc6+nPt{OIQQnq%GEmg+mp^smZ!?sZ_IMcDCh{5x)#`IBMaeNWBa#oov8yFE^ zQIS#daM8NKLy&UTmhJGhbs&MwAi>NSvg8XUhf>+H5?kBoAmKK~J7{2!NEQV}pH>H! z#rFxt`@s3*&oG|rD5xWw2DHN>&z{-=IL~xY%A~wH*|g^}(FHOAlp~IaU=~|djY*_u zR&YxAAmy9kPxhyn4y-q~hciCv=m@#!6NbPd=11-@fv-)L!}r z;|`E$1n2WJFe?qQ5#YPvR^`5jNkh(HK@*fh~tx037`Ww#0U(B#hA3At2r3#_795UKd zh$(zzQvfjyfA(DXm)EpbQ?!>qV z5KGSpl@vgv`}OyB_h7hap&}hAWloc|#`eUx?A|=WTgN!=R8J%M91Ob{OD+xccMG*KVR1yEYwP zJO$9~dTmutkd^8^0JWUMK&1Ms8VGuJ`Vgy+6lv);S-Cp{D@1y-x*VWH7|@Vu-5y~fll}X_Q;<{rFS!mj`s=i zgI*BsPS2=aAPm8|k%SZxSQ{#%fy064%0{c}cpTtZ#?2ETCraQSRhud%OJEbXXjf3k z%3JR6L-0aDm~jf8bd=Kp=xgvpUT*Kh-$NRp7Q;#4}ry;?wfy5HgAzIIj7SjzZC4z5ZfU~+7<(X*s^ zSotY)W5s^LINA3#Yn@ov(OGhsZT=~0Yg~QxF z`BViw6J0eJ8SwVcNn6g=obTHcP@Fo1?CP}u>wstBp3}(GI|PG?ZR%amISj(8+i0RY zEjrj~E8upc1BRj;lsxKX;6nw3!?M75%|Yq9jF`c#7vDOCj=d0z)2mR}^@ok{5`>`D z+ZuDBiB~{V0(cosspf$muP)!v+vOmly$yI3gu<5fsOLy8TBk4!f@TFnl+6mKk5ycC z!rxgR(Q*j(@G*e2%De25fbtc&(a*B@87_Jj0<(=S78@r%_9R{qxj9y0Ig;o`0-fu3 zq6K;bnGN1foIq_UJf&)UBv4p-(8K!?gV_FHq)^1gS5znm?9@=Svzv)uE3poUrTbj2 z8e)44L7>nY>+P-MN7w?2)U|Bgp{TV)Y0#V^Ita05*mn&E0a~^TdJ9)MFq7X%qdrI~ z(z7;S&Fl@?zlf$`AoyLJW}5rS5aR;%YMmEyCGwUiR9o)N*sC1!S%s_C&$*#A+kxV> z$jFwdG5t|~x>O+tOHm-iCWn{93FEOqx}Plf2e&)#8{t%QgF?lw-t$oO)nh zYpI0c-32a9z@t4ts0*Ni@rTMe2uvxVE~CJOze7`b;?L9e1y)d&H-k+gu=!XqLXl@@ z-bd)ok&D(RTO@fDu!Uu2pj?>^9n7B{tAYrK>Rv)!lVNv**9eQd*TEqmaxTFejB)J; zyHJwd)SIVMTVZPj*jyZly4Kdvb_aX!DhISs^v zL?!zz7}d1IHB`4q4-M_)8s$>S&{WnT#nuZzP}f=MF=n7pHTC3uz6qD&8yDb=wVuE{ z>=9w%CGKPebLrr=f?B^nO5jb27lL%Ube4s)#HofR6L-ScK~_R3$DRM5&=(T}<_wdR(#C(&5TnV%CB}8=9byiS&sWdmJu3AW5Tx z^1kS8Z_UyQ2hD;o!dxl7AQMrPP^W}&?D&vWJVcV`T@XE>A#U(fONNvab`M0RHW%^? z$So6DCdnOV4j^%6T!AMElqc}SL}#hGCYM`euzp7a&Iocd(7#iKx2?6X#=QPPjSg%NGE{{!<(p~ltN`i zR~LFE3M$@eqzHMClM#qo#}sqSt&+u|CS?~=l>5l>`VtyCzr zxU=Mju&{fYXcBuDHefKr?efYnC6kAzrjb<+Tuuc+D}9nrm70WqIGkb2UcPNY>Te2f zupgj?@Q1Aq%Rb1Up1X&y4V&%`6_GyzT(^kZO|;T+XsskCR<+SLdw98=Aj}+(+>qXM zb|^rwRZJj)^@Jp@rgV5Kl8&Voj8+j11YI~2umS8L?S%1q@xv;^QC`{v6+zqRF5trC zP9S*V%=9olpgpm$TJ%VUGZwV{&CVDnNC*@-j2Y~u0yP+6?iM_>(>%Mp6V>o5BBYFi z9X@e@YmWp#T{W&_UM#cK6nTnn`3Ob9qBb)7Pg>~s6;CZ>=Y;U%CFtE#a$?C~=Zidc zo~LXu5QNHfRzYcD;1|?kOp;gMH14pODTL30iq1SE_9ZT%U^;P4i$k&l1>f5A8udj$ z;~1TVAnBGt+Ggo*Gcverx?Fr}EPcw)7BN8i!}AEqd3)zg!0sL!HKkKb>|NhlS)ijo zx~B}u$;k5xFTnj?3-VjK?b4cO9xxIDrjFrIv2S#{usNB(S+roQ$M10pna3uJdp+>A z8v=Z>-fZ#(>WQtU=i5nqTR9HPBDSr=`mdi-9)7ZR((HaldCe2RV4jqJw+@3u5Zu{lQq&=i_KCQ5CI$e|{Bz){_pTIs0R^HEI66;Cc0&Otv}b7-ii$ZJ`8+b-tkNT8U04Ts?Ay$nFNQKy;g* z-HVYn2Ee<)ybfn<^W-wYlDMM)Ltg`X6YPnT@(*JFM!5=pvk15xxHj42V;;jR09lE0s**wiwCAjY4R6r3749E{t$J%0Ln}S_%vO8+>L=zWB&wSO^8<*iVNYe@wgVhgDu51<~7>3l#WG zaYzy;J&UhfPhAaR$*BR)h9e0$w$&^cQpLc$KB6AwDSL>S=@8!_if_(dq%<{Ds4~6_ z0@J|-O2KO>e{HVh2{l`%rX~Ep^$Hl`VcWFfgtji z7ZUBWgpkd?sq=BQ2Tj{qE8Kv!QVBH?sv{k|73Dlxv5ZP=`@$Qs?GslJcb5heMM4JJ zC0oc2-?LLlC_zy&0j~Q&i8Cbx8c7RPa|<<|8?$^O{Y@C}D-;<*(IzsRsq8ET!%?;H z4#0s`uuC}jJZ+hl!-FN`4nd$`66MZlM$vpNZ$0i9to2p=EV>aiI;=jPH(Hw&fxmbr z59l#JV@GiU9o_hcAYG(!DvVHYn7Ax0c+*1Y6f7J^m>GQ>(>?XRT~|O~dbGf!ofFD0 zVG@J7>X3AI-g&qSuc>M_!-GF4J#geEd#4HJ7fIBX$&s)u=9`We&c|VN+|cKqCOSZ0 z63NoL2q%*+c&{}Nt-;am#n7j^f;rtoT{}f;uazQx6juP*cjr?)k7_j1rwGYL?S zWUbA~J+>#*|mPNwt zTE}TtS9JAE9wuf2h_0TlFO)Z&o|6RqS=D?89NTmph?x07V$os6kfoqOz`emZuBAU`B9SmlfJ z1}h`T`XtT5Ky#^&4{dEX90pVsSs4NzbSBbTGtQ+ zXlm_)*UT%CO>o^$n|77m$nlQLC0T-t#8hpEDZL>2MuB%0pEOH|u5}=5_0SCnf!a+4 z@%oT7w1Y8@9Ci_zwdw&I)MSvxD3I_A_bG^PW^Pt^qPdXg9Qui|VMALKIL?|>$jGY2 zY8?*cohEhgBNDY4YA!UJs*qh*pIM5BFKvLZY3FK$inlr{eQNp*ttX9>#9wakw4-s) z7CR+l5;lf2*88P2LA0$hWzpi_`@P#NP%$VWxC^&!q~fWlA?)Pzm}syL}g z?~f1_P@PN-(=z1f6EcD)0=1bu9Ie`9FT5EpRPB-Xpp^z8aJbq;6p;kLetQzdHQagn z3#hYk8VBSbs$^3_6;pwj_N3;ufUyK6Ft)*igi0f`xQUm+AxSy%kQy4? z=F1BCEE$2(scr$B$`W(d`1x*R-J47Zq0iH6Z-@&rM4_c%GNslDY4$+3jV~cy*Md&> z1QI&;mcy#t^>8I}eBj>~0?YI3VWe4)ta6bE8Zqx*m|8VJ(EzJ&9kU!M$kw9qeXv1_ zmfrV42fPeA#Y(qO+DGTu6m?m>G!p+Wvz<^9CBn1gjHNK$_DkQ-Du^TA3{o<33<;pQ zoyhfYgK|1#e8GS-DF=kH-WA9ht zS`T{M%vsQYn*jk(Js>)+)@$vQjSV({Zw6YQG!7H%)&)|!;^sX2tJNrG^)zJIHW{fp z%V_~JkHkZV0Vx^i6diK`Tk7q=fZ`XDCwPi}VX!83?>IxUzKV&nPUTI4>m8)vtz`XN z>Y(&DE@LolXI9-Ai2`huzAc7tN!I#q z6!O9n!d&oTFJntsZl|p$EL+|?sWwN{(F6=rDYD{<<6n27+jlWRf z#QUq=CqgmZ3Dwg0rN^4uLPG-(7@VVLwV$C_&WDjD!uxq{?20YiTGVh_7b^{iq z7kvjpy47zOk%F%klDJ%QG-0LSGCb0cJjd6A5E7EO&XKyAF&k*>w|QYw>jblJcjj60 zCLtgu8z*Y~?*kl$;CidJ(k@9aK=|p=>f46&!WL*_3#d-hwk{@t2;7hW#F>Dq!m@#v zUS~tzpqH^7k-dWv1~<4IDSir)8U$(?=LCc^o$zibVpCeneuyWQ$2Z?B#FiYYH z#h;Nc7(t57*tgN}s%~$Cg5>w#VUYZzgL$bTwMFs<?o zT7au{A^Xvr5=Px#OEJ)Q^Yk`yp_fBmh+ZhMBVnR#6)8FKC*@$^Ix^rOiRY?ENc8Xy zpdA~Erz)YYx?{K%{WY>cesnIw1crH8FOVO^0wQ)EP{f*D`x!WJ=fs4ingsU%#wU9C z7(2i_>;n>IG0r(Di)|b7i=rnq4}x$vU4aE{wq+OVt;qBG9b+4`UhT9j4=Dsa@?G1@ z{GC@-0F?)j;!>;^7HO5$=ZY^f{T+>%;F-afu6hWa_b{zpM~LJ=sDOlU^b&@qhP*u^ zz&TW>@0>#cUI2P`p}S{upG_1n(!FsyxaIRmjQfh-AsV*H-01-M=O9qtyCO7G_SIV{ z9rWQ9lCAmt$ZaJ&(6Z%|PH?&+uMobWOw@jjTmx&DN0&DBdz)woW>?9$;L+{`w-h=5K+Yp)m+F}O8%79v77?|TK0oR;^KD=lNtt5 zV=$Y+CjE259gCr`6lL7&v;~M(5ckR2?6_HqRvjhrvmkF_GK=52NTi#8RR|d!FkTDc zO+O)LBZ6>LAV-%3BA#XBuYqBVa9p6QFhQPSCS*Y->dh^K)Q(g~%~fepicLk0^N$Wz zZc5K1U=@2!RFG zFPZ8Um1;vOvmWN_Ehd9%7(>sa(Zs;dp~f4i@ze$F2FSUz`0cQl(a>;W z1E9gh5Ks~-h=y|H<_raL`IIF3Fy)*Y4g3hcNboEch?z(dSv7!>%3rRx3$MfPkvne; zz`_Q4fboTGv`a`^J;jhk2l7V(qAVIcRSqaTWV~Ym5b$&jqECz~y6sPIC5u6a+FA+O z4@H&?{2F0e!kpMDoPk2FXuJwMv6HX|!68{$@L?9|m|09evUfOfYl#tpmNP}`0Rma7 z9t+P6azlfJEeBQ11>DQ!R4X}9;o!#$Ky`T_fI4(+*tf7KWJ(`Wcbb<2ws%g?v*ZCK z%Ti|C#}1rOcHn8tY|V^}d5e!cx{mAHz1kCFJ6)A;{eD*0&OXXQ(95$)};1=OU^upP3@?~1n?OLS}2{UW&)bM zAX#d9bP^wT=r%Y8Bhtm!rI8?SL#k?3Y z{o;Hk+u&sl`I_W9l9pF<dDaU)kN&n_A2odflnW3wzLnO8(XGw07bcnTlBj`6C4k|1>6CZXeWzh$3z4z2oS z1BOI#^fOdBmFC@=f+i$ZgY!)=S{tSBY& z=;3TIow)@(3<;Ehv><1>3TI(u*D)dc$Oh`TtJT2D`|c>JCo00^3u8@kKuJJ62IC%2 zAw3x|ISUX*yXBaB2~@!jPnxlKem8euZ1qgpY&`IUR5$c;qp4)m(zJ$Z?U$WB+byeI#$1m7!M2o>MBHwujSn_$PM?N)uKGvuy z-sTff??qYy4mhB@eR&=1$)_+5+^BjY4sqrt?Q4-^8V$Vz)O8vMJBsr5fhcs!YOen{ zlUQ!I7lB^jJeiK3cx8~BYhch%HHSc3#K_Xc<-rmmLHbLnig?G_)8Cn_Fj*D6zs z)kPv-9L{iGVo$=Bs5biw{qrlgI8#eIONgVlGlIKA9n@O{yIk42hVD&qzJwg);2dNmQ@7?uhcxn%3d0~7;-t`eLkt8}> z19RwYW9BeLTBV6XK-eW75j$Ky-4crzi;>31FFcL&olVRuD9usfB~v>B>|o%fmBL{% zTrl|1=}QH~_6isggTFYcqM~tNQ1QzI#_vP)?lq`|vjv?3Z5;y6Q{(#(J+cNIF`V7@ zB4r?Jn!yman#$tiS-_S}BuzgZF1)`HMc;kPJ*rg{4<&Ee-!^6f zxE)zSKqvI-M?fNc#vp*L6tYx$4Y2XOoTQdvdfW%&6wRGjxbn1MYP{8JomlLS^&-0f zf|BL7>dSlxhovEbrI@SbMFm8asj*OGT(WGNrXjai^iD&2sNrjz81U1BM@uh(@S*K7 zDf5yazTC|9(}{XEvNyH}HK^{6$lp(FWM59b-C@0bD|T^PFfS7MqoM}g5Yc@c9@WYj z1!D^AlHA!(B+GdC6Dx?38sr_TZ4@?xDb9ilnFP6mXsH9i{*GObSTcvGiE zHT@UwI-~-;c*Uv8%{5FXSzPQP?h__&jN+xilK{G@P8*$dmWE(J+^7-CC_J`c?~E71 zw{B1xM+W}WE~X$aU%h00=v~7&{)VKk zP~_Y**LcswqZS4vMDUD14MdV<5r09Km5Zq0u?qmhWZtH~O$zcRS%i5km@VW| z^l13`l3p#9u9{v%4G?m%Q4`4+w*+Swe?1d2c z`4Wd9Ha1`GMZZe)XB-63&UvjgG8+Ewz`XL7w3$-Fi#RwgGq)i;q)^3$lgVKyqoc2j zVo`b_8Uih*L_7@21F&FsQY-P)rm3f)9jvK!MlEEmn6bmO5HwKh4J{q%D@%20ks5+< zx9SABauQnWNzp{0M2UkS4_5*-J@qNuzB9SHt3pEpzVXf?F{+}afWd+xSqz)YO%nrnL!AkOB- z4|(y4ve^jV1KJ4E&hm~2YNYm6Bf+xG;d|C1dVQ=4Ft)2J>Fg!I)CHTT(4J?dAYUau zkg87MfUF9e^uU4>Qv#|$s=JEm2e|7JSx> zgLVldFmnX8v}F zivh}jdZQ~?0_5H66GL?8a|%FiUQ>UPz^6T`TB(J4zIff3XacBoIZKWB`dW4bDO^(l z(B~3XmfFeNV31z|b>ko^nw%6b$qjtLyJtCnQ&8=-@{w;aD9>78H4}Ph#$7SinOFw` zO1PNJl$C3K(wAED9e z&Z=amsV;VWxDH-WO}bmb=t<@jId8BRgPh7tj_#ldFD{d&`aL! z2)VCX&W}QpBxO^Db_$T44M4U6Fh{-``GrL9h69qtIk^-<6rP^Pr&X^RyD#Bu0E3v1wUN)`pY(nBMp({2jT>xQ?XJPnPAewRx?ke97Q)1yy)2`AYo z1lk7cJCnWP1*=xNCW}hj`>2BM&>8@p4Hc?L%KQw{YO$5*2bCf(1mmSID~gqvz%4j0 z1UZ2EozZ(>VadgSo>(DnXu6?I2l1lTgQ85?3%xTrZwfvFf_^VQ<@`@2uT;jTIhv{j>oQ+UujAf+SJ9JY_4 ze>2LBK~XSjjZt;SU&zXfPt+U(r8?VXe5p19%ayVSTEO5d0i+&CP+IGDYn9jM$wytY zFsNmn)X0eGA_2kcZ!lWCt-iew6avUEVvMH?E{48J7}7gF?N&;XR+8-VMBq7&&0fy& zs;`j&#@2A_4XZXKlvHYOamc9qjTGhc`|~5eEzHFk<7|&6KO~ zYA#6uy*_6+t(S;2GN#oXRSXcu`rHLGKzv(8VSWb2LRUd8BEw6FoE~sOCQIIc^JLbl62(P?|AXnB3@Xd}8 zFESY8y?TtNUmb0S7k=A8s4?+;Mk}HGp-+Qz*FAr-myt_t_fXrtkz*d#*o004d_AYS z>7lF^g#C;U0q94tb=Wnfi|`FEZE_@~7qrThZO6jNf-qnUB`a6-^cx4Mx^X!RXvpJFe5FC$S4j*4coNaMdFhIg~eR1+p6a zjot0WV)_S^c5%Xt2ozQuLaG{IDR$<)f%Ep%jfDAt-G?$EDc09_+a)!C)RN&n0gluz zOc8@w#N<_5EiMm3b#KfjND@%x9R1~PgGxOKL#>l$C?vs2F3!}EAXg6x!iRuh9yQfz z(2tFymHXuO*kB+#Jjg!81Bvb|SQddTmF-Gz1a3QWD)i*`w|X&joDlHe&n>xwrr}pB zpG=Kv7FQOV`*xun9l4Zglbpk8utH9jG>odQ5>u*lV{?A&#g6ILUZ#4n9eM%*9W5Yn zr#u}h4pg^w$l+1z~GrDtE4MqE4b4etAyqn@Cq#o=%E_kjk^>f zY7Qa#0D0%Hk)ZRwIkeZsA|i+#nvSm{oB>Iy7fW_yoVB&;0$PW4%p1;b+QM});Iu@P zBM1;iyn-teScq$*t%b_7o)qf9=Vl3ku{Xlwt z7Jz~BQ-M&1d{`U^s}j4o3ynGrrP9v!4Ho}I75%T#6r#dFQ$iz3=7-agw)xT>)K0Mk z39MB9C>SR4<&-LwZ71AKMDkTw+#b&+=}plcJ26ZI-Lc>(VI(H;XK+epJ(td^3=V#!yso z3%$gXE$}3<$4M8qkoKY${imka#MTi2OF*>0cyWyic;gX-H7h}N1d<%U?8@rX{7AC< z)~+I?n-2gfl8?W4aQ7_KpzYAH11Ww8P}U3s8J)y>w8J6tva%9o>F{TOLDIJ&AbJAP zL?XHS09S57xhW+!P%J`v(F2oBL981Unhd2aR57@?yw}jw*cfl*Z6$5@ij5K#CWE`n`xJuOmMsH5a58Fq=_#&f>cuqs{z=an;tGbLDSL@XCGu0uOS_O+}gpI=;3 z6GXxNZG_lZ2sV4A%&)y5;h-|M&**%UtSHDX5?%L*mfuBtcigFsKRTx(5$GWeUv|j{ zc*|jBE%Xj)E+p$Rnz$BRG|+4_iE$TzR!Lg{E#gwH)HEh+Iyvv1n?)1RgCI-6O8VnN z;3OUfForLDYe+|J)9`}l9Yu!LXB0`MC3`zx$CGA@rO%gz>}0U(cDFP}YM8U0w^dCJ zk4Ld0hm{Hj102I#!tlBM9Bbw=+nogED;XBd?FFb=C7{0w2F0l}I#M75JA$89Pub!tIZci9IgI0x?fxIIa8_aFe zkr_v*(Y@SkH_FsrOP3Wxy>GiMLWGEb+mA-|MkPKfcoc3prU|gi&U8Z-RmZ%JoWEgp zWN?DiP!gnAP(0;E?mV>A(9@&plDr=dcs zFMWn5DfNJfm@*E+IBP0HmdTi3fkHn}8%EoW=)@U$^6AAoFR8Y^cA-91UE?>$p;M)O z#>ztQt5OXq)lWI^Z;WqH#@vjXHW)xL{BA3pZSNB#zIj00=G`#1k4UFy&5gN9L6i<% zK`R)jem@W$n}ko zjyNnG4^l7FZl!Otb)IYbCIX87&{};+qwvWwV)?doQnzv{;@2rz?GD}moUtNB3qUpW z9p5>;Wi>KfJtJ%8UJ7w(uG-4vb)OQO5HRXas)+1yzHW{MbhWpZl$`mKrdY?LbJ>$z zmY~aCcv8cshmM72^#n0YWVw2s_G&y4LN=Pw$8`s#P$c_vo^Tf8HrLJ+)H@Bdtj5X- z=PDX|y|9R?gpwedw&evzcypFJD|rm5J-DJX4e3M9h_P5$0^;mzebE#ha2-fmdI;Zn za@{0v#f62KI`ZjQY!X^oz`ZD<1zXe@tgU1OWpZnJw@;5c4D$)Q6PcXywo;J3yA|>! zneFMl1SN)T%!h&=r_7v?t*q#m4rNm0VZOBFr`VkgF+`2E17gIi z(S6N9)IN(%bbVaP2%!QzPajEhFh2!(+ko}l5H-lv07g?*U5N1kpu62giPRW?Ni^V@ z>idKuEoXkH7e&YIL&2f$kalAp44PRSTb~5OVwOkOGT8>iUU(74@no@$p`pWCLN#>s;J0O**?8WtW?@=^Xo?LcAz;YdA|yJ;_zUJ?#R{wat3zvL0;} zdYu_n>0dGe4c@hbt^2{4l=A5Y@TBGmRHGBbRBElZt|7}1JLr8_&Zt>4@}S=)5|=RW zD^pIxPY!ax~x`THC|QI8GzE>ev|H2KqMpLX?11Xf2c9 zE*c=-swmwp?YoMbpzl&Lg-qu05U9eAt)!UW4(tZ%HiRUpP6X1AjabuDTWQF-3$L!k^~=&_y})3=+8faZ zc#jcVKPXu~&`8>K_F;-j0k4X}irhFOrTca&@wz~OnTl4!U{!4Hc95Q6G%A*xZ_}GH z15!4!z(w_M~ z6Khp`WP{aU?>N57f{RpddeNAuHC-oscP&QZ7l`YMhfC6Pfs(rU!4%* zP&6GG`~wNqv70l;faTK)z<)DJTs!QkG#jwljADkkX0wK5WtTb&@*ev3d}5`h*X;3wflr^wx1FFV#L%_lu6gJ+hWmFN=5q#BDA?lRzUd!$#v(8?UpPBS;-S|eK*8eD{cCK` zf+u-vTIo^j6gsQx5F6OS-Zvn%iJGQyH8zi>?FipSDQwQddv+5S(oc>FZkdsoq~X%PMV_mJL6%wh~9*c(0D2Juc#?^?P=(1)PRu>FT-@5g{O4#;p4q zS5CZAiw>?U_F!T;60X1?C!KlQ3^)`EQBuks8|P*5YVc{0OGdo5NtaM=@o-9Gb_bn{ zM_57NZhPmcJPb67qliUr79Y3^VrjJb&r>ijyp>O{z%`-7T=H95+mfSL`E0ki2A>h# z@#8pEZESCn5mt9;HgK|D%Q+bVAcGO$8hHFDnGBVChLjYndam|9weKCKLjexsz1!8M zXPWpXJ=P$?MQp&CtuIfibJoi-;`FhTWapb}Ik8sdnU4awfx!u!=#<0T)@tFb9LtU> z4g`s`oEm0LvPKp6fNE1q!iNY^3oY0j@TieN*QoRHJGrvKdh@=HwOxoK(dDg9Z?IT| zo4Qc8K&(bW`T5yszYWK%JNYjIN3ikq*@J@DJV~tg8}8sf z62sQ9GXq~=##Ia8B2mmxj=&z{wwd?On3L?$_-Xx^cSR1W<#j2)Tm+wb>~pgG%WyVi zAdwH;`s_mM!|yW216*zNNK>@BpKND!e0(!|+#QEI61wh%9#+r3n+#PG4xME$iVr7}oq92JEgwfGs zIgPwtX;e)1LRDW5?Z2}s+6WGmxDQB!ACPHZ=?w(!S-m={K6GIf_Rf?R3!@z1SodTy zgz9{2*0XZ8CDL>iHOfaV2izL;vFJ}Dq~CHbihBuh+1wSNBg}9aRI-JET{8*mxB1lf zS+7JQ_v5t%c`XV9FtBBuOyFK#A|$2}D6Y8dxQ{ie7AZ-9xyFceccmJX9Rl85B5cGY z*AC^81T{5`9bYb4q*I7z?O?5tUh`~TIMbqfTl!1VyU_b71UI=D3KJIK-l95m>4hJJ zDGi$(lqJBt<-Or~6X@H5NHa(_3%rbp)|DY(TnAuM1o`yZ-Y6HYF`zJj-Lw!v(Qq`* zP%uu1J*8fw^=r#_?8~vP#C}BW#qXdRmL|CCHjh47Mj905ce@eBh2Sy09->B^BbX6+ z$7@mErNPcpx&rIuf)_`lfkfP=I1EnrV}vs>Ke*d=H&yoNaz=qiM<&P5@f$RVNO?t) z(%@&o%nB%EAI1}{ytH7wp|6$`sQwHs(XK$GaT{`n%WaEiVpX0*km+!P21O4TjVy<) z0v1J}%}tV&69NGF>D!THP)sKrDz66E&Y6p_T)Jc| zY2PIygV{L+Fs#9CQfwHgKs{g(>BlElgsKG4YmDk7igE(KK!i-sV53PO&=@*3F3F7t zv9}y!c(YxG(+hf z20EWqubqsROebm^1Kjo&b1b^E^;zLv&7MWrCfqAknH zwCE#80!_b^@k4%QvEXnZB&8+1-6|-3d-esG*z!oHBy04aV^P5?M*)f+9oZYdYUjNI z#;k-tal+RUplrg%5p6;=AdMVOw<8~hq!hrSrf*l1EyB(V){5_iPDODeBSwwnh-$%D z^zmFPvkb2SG`>k3aaw|`{MHbs*rtLs9#=@J+pR5dphpIfHdQek2JXplUKhZ8LOCYm z_XF-u^;~6!K4*GeW7E6GUS!8uG4*Py1od$wNL6-O9yY8(tRpiX$>?9RJ-|{n`Cw%m z4jIY@g5O=xD+O&osrSc=91Bw8ho+6m%LnBtfj4kw+oJ408c2igCsBUbKz*cH<;zrO2--7b(6S5}B8IUkHbPRZ2OW#C1!swTsaji4MjC@|bu;JXn zkY?4gGWI>mhB%`6L_}0QDfM_R5U+FHo`gkgqwx`swwa;b*m5meX}W1oBg?I#=V7*N zzqIkTirwqD*^3cH(`?CYK#0{$)%s34IV9_I)XoYOZU&kfFi`Wl$rMC#7RvBp%ae%O zxEFmYx8;q9D{xg<+1u&SFoU{CA9pD5fRLK}IinT;2mSQ_(XLotN9plX<) zG3$DBjX3pWbOIltO3Rb%^yq4VY@+fagM*m7bJS(;mBtH`8o{jxcNiQMg%e%YMm^4Y zt~?NZ6w_i;Xgyc0568gi zrS0?V_!w6k+l4ZN4m^Y=RQ)2he7Bn+aOf}*RGE9>iyWI6iS%)lvL_%kbs;#E76vp@ zZYPNCfpSLXZcN%{por6eL=-1_MAcaO24rmFZy2RTWh@yoWCssV$f3f&b>fo%;$GyV z*a9-5Do}e(-Ao47k_g>H*=|hPiykNJ%L~ZXTVlfXC@`)0vjOMbZ?J(Cn1^$;IwWgh zDWKq`Wb+uau`O*nd80=rbB5=cuLal)lX)&0>074#LK4+i@r^(WNYE1#v?v?&^NS!yycVSF56$kr^RHkoo>P75 znYW6NeB5*NkB-7glE-1>s!CN!eye=T5G%FSSANG_?=T42pSLR>9Z8;a7r3Ytb+KdG zJg=>7Jp;4wjwR?DX-kyNbqexK9J<#B$&o)6Rs21Tf1VXw$_9S1eil zBoYV+Fam_NR^~z|p%XCLa;V$AY~?vAC(-XtCI?vG(7VRGC2Ljp0`E;_mF$CLOl9fF ztC{D=1xeMO>B9tkzW`b~X1}WnDwkTHp=3>O`|x(M0s;|eYs&c>EBJ%S7VM-T@Y*x2Hp9HC6>c*(9>N8&fVIUT%n6f0+9i>KFAE+mh2fi!c$9J zJ*cLtL=xb}BOY)Na`wNSL&;A^r?W?Xlau!`LC+aV&|pD5qFCsM%htQRN>Gffw5)C! z|XarvV9&^ zH?hTx#w^s;MN&xAK#hJo#6{)TTg1GMya8BZFIrAxm7)B$KmDz&$&!#RQx_da&j~wq0&q zgj`mnvURDulN2VqH7BQ+Z=sGU{oXA-F9dFIN|lw-qZn2_1U|%F0*q||48#d{2}po$ zA`TZT4xFy~Pgt#599hGTwyEN?`dn)npH40w9tTWMhDVKOKl?Kew96oCeUwlIr)%$(#`3 z7=5U!73ft1uPOVUY%{5dCG9eKa*$7L+(21**qEZ9#JcxOs1Hg6=h<63(#Ih)hVYzkebYzb2PN&=-zI>0xkyC9Z(t;AI8Z0pxdVV z64(e8byMISSCGzZPPtd^>}??ppcA!NU7d z80|}g2dma0FqtCpMp)x`QSn^t6(#~p2&HI%Uv&noEm@onK_8nK)&qJ$RZs-^V6;qsxS|CLEP^!dA3NsQp*Q%k!N}3l^;yHrbbWHVZ1)@S=iv=KaIP!{_?cx z%`LKS2pXFtl0FmXniZS`mz&(v*pVX0ineptxFU)hgbyJ7VEPMgzF(EWS@yit| z0Sm$=a!t}94uQ!5_JzO^!KX0xETQ9iQ|4NI#|4`B#}wNicn<%4_rL-7zN(v{KkU_(8II%PuE!i$#wURfde3b8)<`vkpk}?Re9s-uQ#}ov3!M< zShC`L#;9Ovk}J4w3Zqi_GeaJ+m`24L zJyYt)7|E8Cypfg+VU0X6V{`(jkZzP?^EZ%T974-5kmJz}d_)cxCtS#ZPc;RtK4Lj! zRa^>jBXDxJt>WG_=T-JftIl~Gcd=`2C*|3Iteo;(7J$q31M;oHk8Gm8f~TdmgRY(v zSZE+_qy29bGFRFh(afv8QV2>r9ZLxj?sOyWun(r7a8z`CCA=74l1k+#?{C|Q+*MkrFa|5 z5t=1UF1qa|DsPF!%g$qXR20-md~%PMI}S5?F354i$7fxn{S!1n+^Ic|6m02su(n5X=IS*pWmf*P5Q#kxMNre#>x$`J}^WE@1N(gF`R8l(XU5 z(}O88D%Z(ZrvsjZ$0GBvL2OI?s>=YM7G9-Yy*?oyKvbB8!4J(sU`;yI?^HC_5aQ!7 zS_F@jg6Y()rMY-lN$4z>LDxpL%ZtKAs$xo5fXB1Y76}M<^MQc4;0Ug?*l1RGP1jHz z=!E5ujULb}JKC9Ix*dZAp>5gV#L8gv=8migZ4qB8bIW;FM-@Y2CEh84YEiOcDV)15Uq&BinR2)iBK9zi`u>Jp}m`j!Gf*LF#$|A9aPdzSp4D*GA#@Ov;2o z>Dw7IPQt{h`aZnsTMnc9PGSfkWT3B;1I&UQtXZ6S0@uaF6G4AV#LQ`Y`D3X16$bvO zPD}?wRK1S*HiHnHQK7E1w6z_5klxZ847^+(izINZr`qUdfdk}r=S*bwpv(k9dFz;9 zFe6s1AJxfwucZoV_MoCCAECyyDSZNu6o*DeqBW%bJ}9%5G{DL>;Y?WPbDk&fmCTyr zd!jb<)W&lJYSz1n^fP7*IAy6WnLOh0w%OJrAd-?w84wHg@au%h)dGSbbCt42-nLv0 zkZ@^E;_kUK4(EPvL6(89ohO1VhRVBYILfvVVCcRK<4FWeL6rsUpK^c{G4~tIMR+F- zZz;A0TQTLP&NHR*SI{IiVcE2wOaizXw!>dNIa`PfB|Ttdyy`S$7+*4joD}_FWQU$F zE`j6-HY(L!`fRX6Y(si|BMiZiswzPzvep}h=qbxS#xHFJ-x%=cn;F;-v)uJGKIA9j z8hNO7hV&bG>Yy$to~O~P0-B|E5}%oA zV*>Voy(CU*Fuh|T8N|*89DZ(+6hM?01T*9@qD%}KrxmemSskw+Ph8-VHD{*}46A9@P<24N#`GmI9Wq zIE7SKB2&)=`Y=`;P&XGssTMHdT1>M{NFn z^jqRw!YTu+j`u)gNu%hxYI;Ey7hc0mI343(FrKC351P61C&9Ak9KkY-YQ*HU$XxYP z0jPW-dM)xTnuadViD5z}7>v~wl+@LMoDz^bU+BU&b^*|vyT}W*Y#JAp?mZU3UtiKT z3{ScVvE0We~C97>wmtggYoX4+VV{H}33V zWQ^wEdVMa61r{xzVYi|1;FR%|{pR!7Qo6g{$(l0*mM*Y35j$Uu^(yqIlfFaFrwGrOoq8vqTHZDF!~@-MXxu;o@=Oh+DoKurZs1Ksc=X|><4$% z#X}ngTM1__GePInW?ILu8Hl6y_}O@H5@M4m6mwbX4w{9$0)yL&lIo6}&{?gdH#fzHNUt3!U1 z3t}o(T`Q)oWO5vp_D1Id%q$Z>}{PbRl^*{+$Emh(ACdwEHe9K%Q3ImTj@Ds_MnCeM6UGpILS z1904Gu^n@=c01b{?I$f&)W%Wk$o5g3>?0-Whh$*U$2Er9`SYM~WL~B6FX;lwMdns? zq?!o#4L%9+YQU6Vy5DiJ@?LIIhFlzJHen+UDZY5{Sl}u;^fNzz=$6lPBp0K>w=mhc z7pihI+$N&F$qX_2r9PI;8Q>7Km}zr`OBcwgX!F;o7=9CNi%G;hTX8`F2WC^_ z<;XVTOR@CP!Fn>E8oQAy;J8G85;U~V>>%r%Mg>o2zqW1sp{S8qga-QRd~2<9hHBXkuVQ)(mknTonZqJOxuj)c6A_pksqpF2Ww~_Av^o0;!8kc3QA1oEV!j>SU>fpU z6IH#774idA;0Zblx?#Dny34wbB?FxwhqlOy@$foV+K6e?gN2%AixSw4da=>Hy%J_u zeAV!!dR22#UKEAKaZN= zc6JRfyJK?cd-E*<%WFvPVCTNw>32gWa#LUjw<4E67` zf%-iCu&%_sm#7NGeY2t2=u0Z@df+T{ZzLB>U}2`9ziYnol^%~)<##@_aXprwT1Op( z$VrK+8+%hCZrZ#*hAH~ar3{1#5*eEHRQN=W8e zT@*^e_*W(J{X;5wu&Bs=seN68f>?E86`6U{>v zs_FW+{!x8$&V{;@>aJ0F)KV;0NdieWIXpQaa55=9XEVGTJadPLtQSZyX%s3#!X{xj zCu=<&+>}GQlPXOoqH@nOz=clzU^WYA_{n{5niZlt)M=q2Zjqj?_cP8{ zYUB`OwQKg|#@#N3Yr2E#LvJ>CW9VMi;W475x@g%5df#2%k5we;x9wcl~$ zX%4=H*baP8E3IpnoNp972uY$C0=ui`K4F)$c)AFPR=Pg2=P;ec0~?5wMVI=PDuOi$ zb*0D3_+Ti2P!b5SocHI?F5^cWjgaP0aMG4MS5P)(+Xte7Vy{tP=r0aOzp- zwt@6_0XjwCIZf;_5?+NKWts-7z%vj;`dmQ76?{H$tr3&Hhpl2`h+vpB8C7Lqc6s1} zLieymp5t054fJvSqiyQC_lic^2~zsZNxT)}D*0`lJE%L>x#pX&48hjcF*Ippc0ASy zdUCgvISG9WV`}7Btl_;OZqk*AM3CaZMG%QkW6QvE&(_zwD&Y8*R-l0y?AH!zy;l{` zLahYU*6LVIu{S{V2E{|Z-19O8gt-BDRK<^dlQ&A5(pf+tTwS?^jIG^ngjUo}KwCBu zv`h@4cxMg`SZ|{6uwwxZ5(;bKk=S52SsG#B9L?@n_UlL>g0>h6c1zvV9lJBz?FQn6 zuR~wTF%fgV5j}{>EMWn+;Y$BF%%abR@Igf& z)UY5BI8vK6*Oy|=43nQA5276pUU2|KMgB#=ue-eSxI(!_!WF7?4@~Tba78IVP$-IZ z?ZBa#ar^Hm;_zAYXE!spYICE`K!~xX3>7&l3^Zc^$0O9r6FFdTNhW=&p`1aih02W5 zoW+6^#ah|khUUcz4pMOp91@xIWG3CCzI(fiJC8XFRV43I?C`;NK1BarshR=5ih#6}< z8!a*5(2Q<{9$Qk&Jeg`jxdakZYqVS4g5}1+S)n>g1VA|49A^sPd%E+X;FRSN9A#NQ zXHZ37RGOnTKZY}q`m&Q8iJlGBFxRD*$&@3sTsmBstB_CPtCZO-y;fVid-1ZZy@>mC z(Pewua)mKC@Ub2i(Kabq>$Yy>zVo5u)=6y+$&I6#L5kr{0pa4CrO>+Ngf;jxvmk@a zl)UdHOb$w}pArG;%H$oxfv7htSgb|airPbI(2ZshcM^vM2blgR7zx;0c{EOcX}b11 z3yo>VU1{$y_I!H^=^-}7xWmP(MtODVf;ZS++Ge?RqRDR)+4|uU&Yw z3m!M+fR%DG^ol6K#=tNfwFVCs2L>}Or^pdFhwHHCwy<2;4GT^TQbH4LR%|j+a9;}^ z4ru~TQ}%PdCWE>t=6YSQ?f5WYPz++=_7S&XlnPO8MMNub`Q+U3*c&!dfRHfmxiavyJzBsfy+Om`(t=Hc zxC>qyxZ`1Hp_Pn8H^&9cpf5b7rKfW0Y2np3GQ7e4#4u-K$P~_ zRgTSdyiR z2}U8)o|cA#9^yLW`zwuuft)*PAvFGYuHLVfCh+j+1W?%eXIe}0W5qx$mN!Z(k(ci* z;aOqjAR=J7_8@q+;2Y{b^3q@`mr8sSY$w@iZB+spZ=8#N8&cl59mb0Ck3pXw3tEJS z$nE4G5inV1tG7BicGrX_L*1VPx1$6pX>Tg=V9qH}urtsYP_F1aI{nmxA<%+=^%#f7 z5S5SRpw6;+AF9xhs4Pp`IM?&`KFg%wXy9)t;7KKE(gOud6wo&aYOIK}=^=XRqul13 zjpwkUi4|u%(u+P}Oo|ym&Y8;YTTt`0m9Rp&zj$I(r0Y>*}$`)9fpfgYjcttlDUc z?j=GXo`dK}6RNw0lc`7!>p&@3KtLO|u(;8}3@{3yb}U4Jfq8L(;%y_(;o4OoRl33y zYa$V_5Pb||24Yglb9OhJn%J#uLfZ3jbu7pu2+Z4taUi_2@ z#2<2ngtTDgrZ_77-$I8pp9bV_S<-{)tnA;o%uRW3N>!5Uj4&r6zKHBv3myoDHdDO> zjbh&g-?Iri)Ujkh?_0$ZSd=*qwQ69rq1|ZKHV6dohJlP(?8!-O}Ltn;%Wa2yd^lerTu z2_kU-($}i^MxB|4!Cwk-wiB^n{KZM%9iunSd+vmNh^kQ1#s&@y({~OWKJ~-S_+*Jw z#ksgV#;i=hHoU0IV!J# zK~x(O2_7jSpHYfr6nzRLdUp;c*!=2xz6#2t>oUaWKVTz2N__)KAn>To&7mpoF$WaU zu0A;J^I|?$8SI7jffJ3qX(U*2Bo%LA$jc%vh3eO|FeIfBUzdD(4YX-*NvDs@v1r>$ zfPo!^kdUL|CQDGVRIM+ah|>2^1TPL6&!97`YcI$=Ivh!%ApFbZgK8c0%RWKQ$S9Kn zhk!hyD%qDSMTO}#3wcf^wJ&5g*@a}POAM40tZsW(kLy+)d!gu}k2kHG6%f~g+fF3W z&cPO_K_TF>tneF~SXJXXJ0+{O9fIR5W{aHrFuTz1A)gsa%K z@k^hh742E8sj;=?gv_@mxY50iMu-bHXIdP-lQZJUX_NMqH$vXqa@NN1?sa>8t?mwI zhO>Ty8(G&dU`7(r!rID$(lJl0I5qlx83z4@DN5N)8!>X}*^_cep6|}}LV_zup485Ji^&h+qhAF0wv&18k|?23c~rJH z!2^ivfrd_c@n^^oE2kp%hV-RP-pwJo^FC2gV3q>%g6@I~yoQ9IT-;%;rSLIj^8^kH zd8S(<&Kn_6^G$~2Y?5|bd10yO?zYiCLMU5t0c3d}%g(-U7=wI(P1dfkQst3ZTqHkY zKRA#JYI?lDF>v(}xQx+{DclDEKtSB6Kr%uj&(`kP$_}@|h`hd8K!su}xdodG&JP6x zGf08@Pvq71g&rda*%gKFMP$N>GerD3Am`Ga!s>b~)FKf{9lg``i;J=yT}&EtXXgOAb!1u!+#9tLobF9==O+(O)mSWRRRzZ9eG2i zK`DXGC^_m&mOIrJ57TzkJz%eo22 zNRFlA_}KZz?Wbd~x}oNe74>R?!=oH+I)gIS#nNsOrD8oz#jaQCfhFX1p$MsGUUL(l zc4wAJj~ecMtg}G_Y|VzW5E8KL`o49;;Lveji$v^`Iv2ZURxshM`rEYZTvADjfzAcG zYu1_RFE~3O^NfY1Tk1)Z_Bb-G0Z6W~)V#$wC&5&<#H(Ig21ZqDedr6-VC8bNcI<21 zt;iue2yDv9dIWfR&~IB+zl)%&lWseEvx1#7IJS@=4@-NmmvT>tzEld_SQyXQlD3S% zM8UZyT`Sw6p$csWNQ>jHfd@Wss;7%EJbJ4sM;>vr`gGWgxE_yIGgv2?^R9xn(47#t zJ5}Cm-UO4ZaM9=Mv`{QlYSlMM$Pq@K480=hAYh5_8Vy`M!q7>TI;XTR3|rB5Ej>{} zH_evenC^QjX~AM6k7A=Pp_`Z&isMXcuhdcH*GwTof_2%=L8z_^FQ__SJ&g~|=ccK( zb(EW&!kKWM&>|-HlsMGs1q^0=c=LkwrI^7-Z;J;;-1Cxo$^N7`DhEjTlNigc8;z;` z+ZO3Tx0v*HSHoJj^?0}0EGty+MQTfJGPu{_VScKItUeaoh0`As6WLTN79b!>IEba{H;M1Xi5h%ns2Ocs z_3pb;wrJpBA-8G7rELOpaN0YG@a#;13as0_PRmHREe9t66oEG2XTn|97%b>E7n*F1 zEv1AHMWh)SvSROnQ=Opdz=Wv^j95dyGO<%bXof{dF7!Oe9AL4djty}!L_GV7v6Nhq zRX3B4Ak-J`$WDa{D<)#$dww$MFmUojvQ7P#?0_q~&I6`YvdV?9+ywjAj5-xrU@&ad z3_eyjAd%mf)jISLXGrmtm3To~S&1G7J`77h9|mD)zpz|LY>YgW$kvL$F38V0#p@3= zvY2=zb$24&?dg+N0RnNS)s*-uv7v~eB4!fVYiWo-V5JYJJJf~q2IyWAfUpUpoht(8 zX9qY`FesjZb7e=_dEo}x=$Ft&`q|^JraUaw$aT95MP)VI!@-W5Mq`SenmJK^#XWg! z3b+YmA%Mu9Od-cD-j;P_2%s+{Ju$^C-vcOi1{1gPkxSdAea4huU@>dy!F)?EJmVn3 z!93ZUCE*h7K?-fMKrUq7f?O22^4MxBrAMmygP{og-1$*&JdByZTqA0LwRs&H7NL$A zNnuTt$8Eejwb~W7!w!ZGVhUs1%Ip|C_T8ExLgQFgYmB`zV5ORT&(d~i88=vAs~y!C zP1xH(!B`hicUR(WsH+t1zRAF;T2(}}T2jC#SXRYeO?N;nVx4iHVgo75q4o<&b4KOlD2Q32-p9h-teZ*!d5e*(2L~?T2jXm9JvaJbD*Zb@T+@5>EsrwQHM&oMk{)ms^MV}QO%SkP>nglG1b-g^bwd5` zA(-DnA5X9@2*QLJZR-O8r2}sH1@%LKL6mnnpcL#QK-u3I!Zx~@zAWDg>^n~)I~!qg zKaH1J$^;lW+~NiEN*eGs!Z|_&wU;S;;FG+VQKv``?Cn6x0hqQmMwwim@oO4K=jS z^1`o*AwExdSn#enz|MpYP@ldZ556A&J_Gt?DNBQ$Js-*!+u4d&Z{m;Olpn;KC6#1f zaQ8Z=PJ_O0uQ6D-pp|N$P4V!?89X>Ot6pJl7-=L>wm9EkY?8s+TuIj7L@bD2hCg+; zTpaijL}-p<%J+jo^4<=qZe9lXy~D~KCNaay|Ca9U_BiEjdVo&dR&THg+N z%Wt47*vbWxp9@4P;6WtmTOKi!H>QDf;B#Oh zO+-v0ixhXUgy?H1UIqa|+l~&e_g-cff|lCl(efz>R}?3F*x~DnrBG zt?a6>r^omp&?wvvg`~#PW#GY*0f=YAg=xIOl2J}%zOf($J6R5_wCR#zcMKqG5{po( za^wp26}j0=A<|n1i0Gh%1yMmT(0i=wm}y6WKvo^Yz^ddfAZ8S+9wI9UBufYbH6SV= z=g^jxk?8U<4_#)Ma68^ODzoC4LIGzX@xxWvJfv(V;7fybYX%K3Xe@x4?!sBJt4+jx_fX`{K5B}{^v?n7*OdLQ zP3@MM1({;$Y@Bf%YLg?iIgu-n@Xis~Ob$Y~C?jbiJrIe6#R7!@g&F>9fchp_>2K;Z@5@PITk@Lg6X{Xw_1bJ z{Svw*Uk7BieKiSDunM(g_c>kOGRL6=*j1)IzeaJ!4`~6&7-IK0Gzl=6)wZZ9D)PRA zo>Iu>a{WfF0usgyK|tOdi>O`BrB3Exj}MG9yLo49>uZ$M{F4N9qhD8GxgTteWLWmyzpvFqO~9CPLt3pXW2xDR+S<{reWPr0N!LpKZmP(2gA9trDl6<~} z4m`OHY;<9~cZ;<~Z2>YeFBk}`O8Mp>4)8DLp$aUuv5L??PUWm42F7aSoVy%p#1kFngY+NsAQakSnUu?`3g**~=-b=|JgYj4{T3 z6-HR-=8ck^RMT1-eh&Sbn&yM0o{q6@BDNMmA9!O=p0pN87Gr4I>dhC|M;KXq8Qn4L69cSn_T#IoF9@W$i>@!)a zq&*|Pku++Cw$!G^)@>R@Y#7H`n0=U7at{T+KOD|*Zd}Q$a2lt)2Z08i%7nyk7!7s_ z?l%Y9R#J_Yk^u%{c?OglOSJHB*dXVRq_^XjSsL(#P$Xgpbd;4qn2^;ogJ(3BM-V3p zlLR-NDZGT4VUX<>+^2n4|**F zpGKm#;`Ewes)Q`^@>y^eRgt?s82efp-p7lA`l8DrubU4gLGtf=jjT2A+Rf0C;TdQG zT-FX&5koSJ4nY3kRpgF+HpcH1m`F`2reet>9mXOKl;SRI?oczMfwt(W<;ESnZ11~y zEkPI}R8!}qZ2Ml${HpFFIXy9WI;D9AXpK%u0h4TZeSKPvDvN9qTtbY7z3N7ZK4PB( z8#qj0uMNWsubZ5OaTC`G#lo%x$G|rL+Dduo+FjoR(B3UtlyOxE@+Kh1U2t5_ts~rK zv?(3&IknFyZ5Sh@dQNsP=K=@}jHzKCyhx8`AHXbfV0a%B5qgL=^#ui&)qN z#%D1-jNTN%C;QS0q3a?Rr1tsOs5Cr!8eW11fepkhFE})YW1`4W=z^W z@X;FsN|8FqaQr$7+o5WquZRlt-YF}nHyrxWS(enIgM(`$Fqw99$yXK{h{7A9#hYYX z;i_uSj{)9JwY#`NksQxF!Sp|7j9{-L4Z%?Ib3pp+Gk2lu!-kxLh$gGU9+gt>i4pnM z$`Jze9xe-k^>w|Bwwo&viXMz3CL`cvu`*4U1pCdriiS29sPIYMOceOfB0(ZXIA?VV zx7d+o>u&fs-c?;zGDBoYI5kzAbB4PhR=1B$zTNj&fnq{hf(38LBO@p<7fnox8urO= zdIH{MI~8!;lxdV9O}3ZQK#PXK^Uxw__8Aj}M~!$eDkTKHE!%}%(T!qKL@6~@QVPa; zN9pZ2MeQaqr^y8}2XuhLBw>F+G6QKGI}%FUhMM>aJCNv?j1dq+3E3W^5U~v^s+9!M zLmf!oYs>4ARKb!5Dp~WT$+4X$TdB#Ek-gPTAa{t`GSU*k=77vnLFUy3;3OV~+ygw! z2;3mk``!Y$e=pIMmdh_jLiQ0!%s_8*G9y!1_er256vD<0w3Nl75loSGGVEL6*ImRi zAW*{L+@T8OY5^gToUl3Qb$7ohu7$C%^JWzm>yQ6_QHf)rPPJ2Sh(_+EG6{)?4 zcOCn4WYbaC%ha&I9`%%7N87{gpFkcx9YV7#AZEk0)*Esa>lvYr>#H}uxh4T`!rEh* z$j%H_!A7FxxkxjcBodT}FtiqWC3g#k^^Kj?7f3;kg(l%}Rv5>A6mauZjjyC155d{J z>=eSBcyLfdXOtcF*qaK)+NzMa;^dFL73dAmBW?pNaF^5fQSd85L8dq`(0T?Kx-thC z_mTio8IT_|6C&XVaT)&LM(U$B1X}`K1B6QTzA~icJWn16urnG$i&QOF9ktZStV0Y2 z28;NwZPPS#d^~s;vD&}4qYBU-2Hafg1>&D?1f#t%;FV�cmLAmbAmDEj|#pgL+IwYa`06^Tl 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

    Cij(>IUU$CN@bM-8)O4sWcFD@sPHr( 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