From 94945006f48c486482a67a8c114a2fbe32c2aba4 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowen5@gmail.com>
Date: Sun, 20 Jun 2021 14:31:06 +0100
Subject: [PATCH 001/166] feat: adding attribute to ignore extension method for
 read writer (#841)

* feat: adding attibute to ignore extension method for read writer

* tests

* refactoring ReaderWriterProcessor

adding SerailizeExtensionHelper to handle checking of types and methods to find extension methods

making reflection and cecil methods have the same logic

* adding better fail message to assert

* fixing checking type is void

* fixing code smell
---
 Assets/Mirage/Runtime/CustomAttributes.cs     |   6 +
 .../Processors/ReaderWriterProcessor.cs       | 268 +++++++++++-------
 .../Runtime/Serialization/WeaverIgnoreTest.cs |  53 ++++
 .../Serialization/WeaverIgnoreTest.cs.meta    |  11 +
 Assets/Tests/Weaver/Tests.cs                  |   2 +-
 5 files changed, 237 insertions(+), 103 deletions(-)
 create mode 100644 Assets/Tests/Runtime/Serialization/WeaverIgnoreTest.cs
 create mode 100644 Assets/Tests/Runtime/Serialization/WeaverIgnoreTest.cs.meta

diff --git a/Assets/Mirage/Runtime/CustomAttributes.cs b/Assets/Mirage/Runtime/CustomAttributes.cs
index 7dd34553f72..bee5eecc05e 100644
--- a/Assets/Mirage/Runtime/CustomAttributes.cs
+++ b/Assets/Mirage/Runtime/CustomAttributes.cs
@@ -124,4 +124,10 @@ public sealed class ShowInInspectorAttribute : Attribute { }
     /// </summary>
     [AttributeUsage(AttributeTargets.Field)]
     public sealed class FoldoutEventAttribute : PropertyAttribute { }
+
+    /// <summary>
+    /// Tells Weaver to ignore an Extension method
+    /// </summary>
+    [AttributeUsage(AttributeTargets.Method)]
+    public sealed class WeaverIgnoreAttribute : PropertyAttribute { }
 }
diff --git a/Assets/Mirage/Weaver/Processors/ReaderWriterProcessor.cs b/Assets/Mirage/Weaver/Processors/ReaderWriterProcessor.cs
index 373f5485aaa..a7a6f50e5ab 100644
--- a/Assets/Mirage/Weaver/Processors/ReaderWriterProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/ReaderWriterProcessor.cs
@@ -3,6 +3,7 @@
 using System.Collections.Generic;
 using System.Linq;
 using System.Reflection;
+using System.Runtime.CompilerServices;
 using Mirage.Serialization;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
@@ -18,6 +19,7 @@ public class ReaderWriterProcessor
         private readonly ModuleDefinition module;
         private readonly Readers readers;
         private readonly Writers writers;
+        private readonly SerailizeExtensionHelper extensionHelper;
 
         /// <summary>
         /// Mirage's main module used to find built in extension methods and messages
@@ -29,6 +31,7 @@ public ReaderWriterProcessor(ModuleDefinition module, Readers readers, Writers w
             this.module = module;
             this.readers = readers;
             this.writers = writers;
+            extensionHelper = new SerailizeExtensionHelper(module, readers, writers);
         }
 
         public bool Process()
@@ -46,37 +49,18 @@ public bool Process()
             return writers.Count != writeCount || readers.Count != readCount;
         }
 
-
         #region Load Mirage built in readers and writers
         private void LoadBuiltinExtensions()
         {
             // find all extension methods
-            IEnumerable<Type> types = MirageModule.GetTypes().Where(IsStatic);
+            IEnumerable<Type> types = MirageModule.GetTypes();
 
             foreach (Type type in types)
             {
-                IEnumerable<MethodInfo> methods = type.GetMethods(BindingFlags.Static | BindingFlags.Public)
-                    .Where(IsExtension)
-                    .Where(NotGeneric);
-
-                foreach (MethodInfo method in methods)
-                {
-                    RegisterReader(method);
-                    RegisterWriter(method);
-                }
+                extensionHelper.RegisterExtensionMethodsInType(type);
             }
         }
 
-        /// <summary>
-        /// static classes are declared abstract and sealed at the IL level.
-        /// <see href="https://stackoverflow.com/a/1175901/8479976"/>
-        /// </summary>
-        private static bool IsStatic(Type t) => t.IsSealed && t.IsAbstract;
-
-        private static bool IsExtension(MethodInfo method) => Attribute.IsDefined(method, typeof(System.Runtime.CompilerServices.ExtensionAttribute));
-        private static bool NotGeneric(MethodInfo method) => !method.IsGenericMethod;
-
-
         private void LoadBuiltinMessages()
         {
             IEnumerable<Type> types = MirageModule.GetTypes().Where(t => t.GetCustomAttribute<NetworkMessageAttribute>() != null);
@@ -88,35 +72,6 @@ private void LoadBuiltinMessages()
                 messages.Add(typeReference);
             }
         }
-
-
-        private void RegisterReader(MethodInfo method)
-        {
-            if (method.GetParameters().Length != 1)
-                return;
-
-            if (method.GetParameters()[0].ParameterType.FullName != typeof(NetworkReader).FullName)
-                return;
-
-            if (method.ReturnType == typeof(void))
-                return;
-            readers.Register(module.ImportReference(method.ReturnType), module.ImportReference(method));
-        }
-
-        private void RegisterWriter(MethodInfo method)
-        {
-            if (method.GetParameters().Length != 2)
-                return;
-
-            if (method.GetParameters()[0].ParameterType.FullName != typeof(NetworkWriter).FullName)
-                return;
-
-            if (method.ReturnType != typeof(void))
-                return;
-
-            Type dataType = method.GetParameters()[1].ParameterType;
-            writers.Register(module.ImportReference(dataType), module.ImportReference(method));
-        }
         #endregion
 
         #region Assembly defined reader/writer
@@ -128,11 +83,7 @@ void ProcessAssemblyClasses()
             {
                 // extension methods only live in static classes
                 // static classes are represented as sealed and abstract
-                if (klass.IsAbstract && klass.IsSealed)
-                {
-                    LoadDeclaredWriters(klass);
-                    LoadDeclaredReaders(klass);
-                }
+                extensionHelper.RegisterExtensionMethodsInType(klass);
 
                 if (klass.GetCustomAttribute<NetworkMessageAttribute>() != null)
                 {
@@ -255,54 +206,7 @@ private static bool IsReadWriteMethod(MethodReference method)
                 method.Is<NetworkReader>(nameof(NetworkReader.Read));
         }
 
-        void LoadDeclaredWriters(TypeDefinition klass)
-        {
-            // register all the writers in this class.  Skip the ones with wrong signature
-            foreach (MethodDefinition method in klass.Methods)
-            {
-                if (method.Parameters.Count != 2)
-                    continue;
-
-                if (!method.Parameters[0].ParameterType.Is<NetworkWriter>())
-                    continue;
-
-                if (!method.ReturnType.Is(typeof(void)))
-                    continue;
-
-                if (!method.HasCustomAttribute<System.Runtime.CompilerServices.ExtensionAttribute>())
-                    continue;
-
-                if (method.HasGenericParameters)
-                    continue;
-
-                TypeReference dataType = method.Parameters[1].ParameterType;
-                writers.Register(dataType, module.ImportReference(method));
-            }
-        }
-
-        void LoadDeclaredReaders(TypeDefinition klass)
-        {
-            // register all the reader in this class.  Skip the ones with wrong signature
-            foreach (MethodDefinition method in klass.Methods)
-            {
-                if (method.Parameters.Count != 1)
-                    continue;
-
-                if (!method.Parameters[0].ParameterType.Is<NetworkReader>())
-                    continue;
-
-                if (method.ReturnType.Is(typeof(void)))
-                    continue;
-
-                if (!method.HasCustomAttribute<System.Runtime.CompilerServices.ExtensionAttribute>())
-                    continue;
 
-                if (method.HasGenericParameters)
-                    continue;
-
-                readers.Register(method.ReturnType, module.ImportReference(method));
-            }
-        }
 
         private static bool IsEditorAssembly(ModuleDefinition module)
         {
@@ -364,4 +268,164 @@ private void RegisterMessages(ILProcessor worker)
 
         #endregion
     }
+
+    /// <summary>
+    /// Helps get Extension methods using either reflection or cecil
+    /// </summary>
+    public class SerailizeExtensionHelper
+    {
+        private readonly ModuleDefinition module;
+        private readonly Readers readers;
+        private readonly Writers writers;
+
+        public SerailizeExtensionHelper(ModuleDefinition module, Readers readers, Writers writers)
+        {
+            this.module = module;
+            this.readers = readers;
+            this.writers = writers;
+        }
+
+
+        public void RegisterExtensionMethodsInType(Type type)
+        {
+            // only check static types
+            if (!IsStatic(type))
+                return;
+
+            IEnumerable<MethodInfo> methods = type.GetMethods(BindingFlags.Static | BindingFlags.Public)
+                   .Where(IsExtension)
+                   .Where(NotGeneric)
+                   .Where(NotIgnored);
+
+            foreach (MethodInfo method in methods)
+            {
+                if (IsWriterMethod(method))
+                {
+                    RegisterWriter(method);
+                }
+
+                if (IsReaderMethod(method))
+                {
+                    RegisterReader(method);
+                }
+            }
+        }
+        public void RegisterExtensionMethodsInType(TypeDefinition type)
+        {
+            // only check static types
+            if (!IsStatic(type))
+                return;
+
+            IEnumerable<MethodDefinition> methods = type.Methods
+                   .Where(IsExtension)
+                   .Where(NotGeneric)
+                   .Where(NotIgnored);
+
+            foreach (MethodDefinition method in methods)
+            {
+                if (IsWriterMethod(method))
+                {
+                    RegisterWriter(method);
+                }
+
+                if (IsReaderMethod(method))
+                {
+                    RegisterReader(method);
+                }
+            }
+        }
+
+        /// <summary>
+        /// static classes are declared abstract and sealed at the IL level.
+        /// <see href="https://stackoverflow.com/a/1175901/8479976"/>
+        /// </summary>
+        private static bool IsStatic(Type t) => t.IsSealed && t.IsAbstract;
+        private static bool IsStatic(TypeDefinition t) => t.IsSealed && t.IsAbstract;
+
+        private static bool IsExtension(MethodInfo method) => Attribute.IsDefined(method, typeof(ExtensionAttribute));
+        private static bool IsExtension(MethodDefinition method) => method.HasCustomAttribute<ExtensionAttribute>();
+        private static bool NotGeneric(MethodInfo method) => !method.IsGenericMethod;
+        private static bool NotGeneric(MethodDefinition method) => !method.IsGenericInstance;
+
+        /// <returns>true if method does not have <see cref="WeaverIgnoreAttribute"/></returns>
+        private static bool NotIgnored(MethodInfo method) => !Attribute.IsDefined(method, typeof(WeaverIgnoreAttribute));
+        /// <returns>true if method does not have <see cref="WeaverIgnoreAttribute"/></returns>
+        private static bool NotIgnored(MethodDefinition method) => !method.HasCustomAttribute<WeaverIgnoreAttribute>();
+
+
+        private static bool IsWriterMethod(MethodInfo method)
+        {
+            if (method.GetParameters().Length != 2)
+                return false;
+
+            if (method.GetParameters()[0].ParameterType.FullName != typeof(NetworkWriter).FullName)
+                return false;
+
+            if (method.ReturnType != typeof(void))
+                return false;
+
+            return true;
+        }
+        private bool IsWriterMethod(MethodDefinition method)
+        {
+            if (method.Parameters.Count != 2)
+                return false;
+
+            if (method.Parameters[0].ParameterType.FullName != typeof(NetworkWriter).FullName)
+                return false;
+
+            if (!method.ReturnType.Is(typeof(void)))
+                return false;
+
+            return true;
+        }
+
+        private static bool IsReaderMethod(MethodInfo method)
+        {
+            if (method.GetParameters().Length != 1)
+                return false;
+
+            if (method.GetParameters()[0].ParameterType.FullName != typeof(NetworkReader).FullName)
+                return false;
+
+            if (method.ReturnType == typeof(void))
+                return false;
+
+            return true;
+        }
+        private bool IsReaderMethod(MethodDefinition method)
+        {
+            if (method.Parameters.Count != 1)
+                return false;
+
+            if (method.Parameters[0].ParameterType.FullName != typeof(NetworkReader).FullName)
+                return false;
+
+            if (method.ReturnType.Is(typeof(void)))
+                return false;
+
+            return true;
+        }
+
+        private void RegisterWriter(MethodInfo method)
+        {
+            Type dataType = method.GetParameters()[1].ParameterType;
+            writers.Register(module.ImportReference(dataType), module.ImportReference(method));
+        }
+        private void RegisterWriter(MethodDefinition method)
+        {
+            TypeReference dataType = method.Parameters[1].ParameterType;
+            writers.Register(module.ImportReference(dataType), module.ImportReference(method));
+        }
+
+
+        private void RegisterReader(MethodInfo method)
+        {
+            readers.Register(module.ImportReference(method.ReturnType), module.ImportReference(method));
+        }
+        private void RegisterReader(MethodDefinition method)
+        {
+            readers.Register(module.ImportReference(method.ReturnType), module.ImportReference(method));
+        }
+    }
 }
diff --git a/Assets/Tests/Runtime/Serialization/WeaverIgnoreTest.cs b/Assets/Tests/Runtime/Serialization/WeaverIgnoreTest.cs
new file mode 100644
index 00000000000..dfefe8e9165
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/WeaverIgnoreTest.cs
@@ -0,0 +1,53 @@
+using System;
+using Mirage.Serialization;
+using NUnit.Framework;
+
+namespace Mirage.Tests.Runtime.Serialization
+{
+    public class WeaverIgnoreTest
+    {
+        [Test]
+        public void DoesNotUseCustomWriter()
+        {
+            // check method names
+            Assert.That(Writer<MyCustomType>.Write.Method.Name, Is.Not.EqualTo(new Action<NetworkWriter, MyCustomType>(MyCustomTypeExtension.WriteOnlyPartOfCustom).Method.Name));
+            Assert.That(Reader<MyCustomType>.Read.Method.Name, Is.Not.EqualTo(new Func<NetworkReader, MyCustomType>(MyCustomTypeExtension.ReadOnlyPartOfCustom).Method.Name));
+
+            // check writing and reading
+            var data = new MyCustomType
+            {
+                first = 10,
+                second = 20,
+            };
+            var writer = new NetworkWriter();
+            writer.Write(data);
+            var reader = new NetworkReader(writer.ToArraySegment());
+            MyCustomType copy = reader.Read<MyCustomType>();
+
+            // should have copied both fields,
+            // if it uses custom extension methods it will only write first
+            Assert.That(copy.first, Is.EqualTo(data.first));
+            Assert.That(copy.second, Is.EqualTo(data.second));
+        }
+
+    }
+    public struct MyCustomType
+    {
+        public int first;
+        public int second;
+    }
+    public static class MyCustomTypeExtension
+    {
+        [WeaverIgnore]
+        public static void WriteOnlyPartOfCustom(this NetworkWriter writer, MyCustomType value)
+        {
+            writer.WriteInt32(value.first);
+        }
+        [WeaverIgnore]
+
+        public static MyCustomType ReadOnlyPartOfCustom(this NetworkReader reader)
+        {
+            return new MyCustomType { first = reader.ReadInt32() };
+        }
+    }
+}
diff --git a/Assets/Tests/Runtime/Serialization/WeaverIgnoreTest.cs.meta b/Assets/Tests/Runtime/Serialization/WeaverIgnoreTest.cs.meta
new file mode 100644
index 00000000000..c5ddff0b9bc
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/WeaverIgnoreTest.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 2e9ee5990fd72af43b067517fad704cf
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Weaver/Tests.cs b/Assets/Tests/Weaver/Tests.cs
index 8245d4877e5..c94d3bfd283 100644
--- a/Assets/Tests/Weaver/Tests.cs
+++ b/Assets/Tests/Weaver/Tests.cs
@@ -24,7 +24,7 @@ public virtual void TestSetup()
         [AssertionMethod]
         protected void IsSuccess()
         {
-            Assert.That(weaverLog.Diagnostics, Is.Empty);
+            Assert.That(weaverLog.Diagnostics, Is.Empty, $"Failed because there are Diagnostics message: \n  {string.Join("\n  ", weaverLog.Diagnostics.Select(x => x.MessageData))}\n");
         }
 
         [AssertionMethod]

From 039b2c4735171c71752373ec105da43e72bf19ee Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Sun, 20 Jun 2021 13:45:16 +0000
Subject: [PATCH 002/166] chore(release): 96.4.0 [skip ci]

# [96.4.0](https://github.com/MirageNet/Mirage/compare/v96.3.1...v96.4.0) (2021-06-20)

### Features

* adding attribute to ignore extension method for read writer ([#841](https://github.com/MirageNet/Mirage/issues/841)) ([9494500](https://github.com/MirageNet/Mirage/commit/94945006f48c486482a67a8c114a2fbe32c2aba4))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs               | 2 +-
 Assets/Mirage/CHANGELOG.md                                 | 7 +++++++
 Assets/Mirage/Components/AssemblyInfo.cs                   | 2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                      | 2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs          | 2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs                     | 2 +-
 .../Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs      | 2 +-
 Assets/Mirage/package.json                                 | 2 +-
 8 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index 1467dac044e..92c5c974d14 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("96.3.1")]
+[assembly: AssemblyVersion("96.4.0")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index fa59dc2c920..829105f67ba 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,10 @@
+# [96.4.0](https://github.com/MirageNet/Mirage/compare/v96.3.1...v96.4.0) (2021-06-20)
+
+
+### Features
+
+* adding attribute to ignore extension method for read writer ([#841](https://github.com/MirageNet/Mirage/issues/841)) ([9494500](https://github.com/MirageNet/Mirage/commit/94945006f48c486482a67a8c114a2fbe32c2aba4))
+
 ## [96.3.1](https://github.com/MirageNet/Mirage/compare/v96.3.0...v96.3.1) (2021-06-17)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index 691d1538f04..89c31162046 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("96.3.1")]
+[assembly: AssemblyVersion("96.4.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index 7e2385ac1e4..09809e2b7a6 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("96.3.1")]
+[assembly: AssemblyVersion("96.4.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index 0e45715bd20..645d247fa9e 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("96.3.1")]
+[assembly: AssemblyVersion("96.4.0")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index 1467dac044e..92c5c974d14 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("96.3.1")]
+[assembly: AssemblyVersion("96.4.0")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index 1467dac044e..92c5c974d14 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("96.3.1")]
+[assembly: AssemblyVersion("96.4.0")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 10642f5262b..047a4e0cd72 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "96.3.1",
+    "version": "96.4.0",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From a18784451fb8b4711964ee9ef6c19c161a02059b Mon Sep 17 00:00:00 2001
From: dragonslaya84 <santos_steve@hotmail.com>
Date: Mon, 21 Jun 2021 03:44:39 -0400
Subject: [PATCH 003/166] fix: welcome window fixes (#845)

* fix: paths for welcome window changelog.
fix: allow 2019 and up for welcome window.

Signed-off-by: dragonslaya <steve.s@bigredplanetgames.com>

* fix: this fixes styling and error on 2019+ editors.

Signed-off-by: dragonslaya <steve.s@bigredplanetgames.com>

* fix: Welcome window now searches for existing file of the changelog to know which mirage install was done.

Signed-off-by: dragonslaya <steve.s@bigredplanetgames.com>

* fix: proper fix using current welcome window script path to get changelog path.
fix: fixed code smells

Signed-off-by: dragonslaya <dragonslaya.ss@gmail.com>

Co-authored-by: dragonslaya <steve.s@bigredplanetgames.com>
---
 .../WelcomeWindow/Resources/WelcomeWindow.uxml   |  6 ++++--
 .../Mirage/Editor/WelcomeWindow/WelcomeWindow.cs | 16 +++++++---------
 2 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/Assets/Mirage/Editor/WelcomeWindow/Resources/WelcomeWindow.uxml b/Assets/Mirage/Editor/WelcomeWindow/Resources/WelcomeWindow.uxml
index 5e3c467597d..c371a818001 100644
--- a/Assets/Mirage/Editor/WelcomeWindow/Resources/WelcomeWindow.uxml
+++ b/Assets/Mirage/Editor/WelcomeWindow/Resources/WelcomeWindow.uxml
@@ -1,5 +1,6 @@
-<ui:UXML xmlns:ui="UnityEngine.UIElements" xmlns:uie="UnityEditor.UIElements" xsi="http://www.w3.org/2001/XMLSchema-instance" engine="UnityEngine.UIElements" editor="UnityEditor.UIElements" noNamespaceSchemaLocation="../../../../UIElementsSchema/UIElements.xsd" editor-extension-mode="False">
-    <Style src="WelcomeWindow.uss" />
+<ui:UXML xmlns:ui="UnityEngine.UIElements" xmlns:uie="UnityEditor.UIElements" xsi="http://www.w3.org/2001/XMLSchema-instance" engine="UnityEngine.UIElements" editor="UnityEditor.UIElements" noNamespaceSchemaLocation="../../../../UIElementsSchema/UIElements.xsd" editor-extension-mode="False">    
+    <ui:VisualElement>
+            <Style src="WelcomeWindow.uss" />
     <ui:VisualElement name="Banner">
         <ui:Label name="VersionText" text="Placeholder" />
         <ui:Image name="Icon" style="background-image: resource('MirageIcon');" />
@@ -74,4 +75,5 @@
             </ui:ScrollView>
         </ui:VisualElement>
     </ui:Box>
+    </ui:VisualElement>
 </ui:UXML>
diff --git a/Assets/Mirage/Editor/WelcomeWindow/WelcomeWindow.cs b/Assets/Mirage/Editor/WelcomeWindow/WelcomeWindow.cs
index 82191118684..a499427f05a 100644
--- a/Assets/Mirage/Editor/WelcomeWindow/WelcomeWindow.cs
+++ b/Assets/Mirage/Editor/WelcomeWindow/WelcomeWindow.cs
@@ -1,6 +1,7 @@
 using System;
 using System.Collections.Generic;
 using System.IO;
+using System.Reflection;
 using Mirage.Logging;
 using UnityEditor;
 using UnityEditor.PackageManager;
@@ -62,12 +63,13 @@ public class WelcomeWindow : EditorWindow
         //editorprefs keys
         private static string firstStartUpKey = string.Empty;
         private const string firstTimeMirageKey = "MirageWelcome";
+        private const string miragePackageName = "com.miragenet.mirage";
 
         /// <summary>
         ///     Hard coded for source code version. If package version is found, this will
         ///     be set later on to package version. through checking for packages anyways.
         /// </summary>
-        private static string changeLogPath = "Assets/Mirage/CHANGELOG.md";
+        private string changeLogPath;
 
         private static string GetVersion()
         {
@@ -108,7 +110,7 @@ private static void ShowWindowOnFirstStart()
             {
                 EditorPrefs.SetString(screenToOpenKey, ShowChangeLog ? "ChangeLog" : "Welcome");
 
-#if UNITY_2020_1_OR_NEWER
+#if UNITY_2019_1_OR_NEWER
                 OpenWindow();
 #else
                 if (logger.LogEnabled()) logger.Log($"WelcomeWindow not supported in {Application.unityVersion}, it is only supported in Unity 2020.1 or newer");
@@ -138,14 +140,16 @@ public static void OpenWindow()
         //the code to handle display and button clicking
         private void OnEnable()
         {
+            changeLogPath = AssetDatabase.GetAssetPath(MonoScript.FromScriptableObject(this)) + "/../../../CHANGELOG.md";
+
             //Load the UI
             //Each editor window contains a root VisualElement object
             VisualElement root = rootVisualElement;
             VisualTreeAsset uxml = Resources.Load<VisualTreeAsset>("WelcomeWindow");
             StyleSheet uss = Resources.Load<StyleSheet>("WelcomeWindow");
 
-            uxml.CloneTree(root);
             root.styleSheets.Add(uss);
+            uxml.CloneTree(root);
 
             //set the version text
             Label versionText = root.Q<Label>("VersionText");
@@ -429,12 +433,6 @@ private void ListPackageProgress()
                                 continue;
                             }
 
-                            if (miragePackage.Value.packageName != null && miragePackage.Value.packageName.Equals("Mirage"))
-                            {
-                                // Found mirage package let's set up our change log path.
-                                changeLogPath = "Packages/com.miragenet.mirage/CHANGELOG.md";
-                            }
-
                             installedPackages.Add(miragePackage.Value.displayName);
                         }
 

From 43235e7b739d920d0f6eaf4ff6c4f948d1cd9fb7 Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Mon, 21 Jun 2021 08:08:54 +0000
Subject: [PATCH 004/166] chore(release): 96.4.1 [skip ci]

## [96.4.1](https://github.com/MirageNet/Mirage/compare/v96.4.0...v96.4.1) (2021-06-21)

### Bug Fixes

* welcome window fixes ([#845](https://github.com/MirageNet/Mirage/issues/845)) ([a187844](https://github.com/MirageNet/Mirage/commit/a18784451fb8b4711964ee9ef6c19c161a02059b))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs               | 2 +-
 Assets/Mirage/CHANGELOG.md                                 | 7 +++++++
 Assets/Mirage/Components/AssemblyInfo.cs                   | 2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                      | 2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs          | 2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs                     | 2 +-
 .../Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs      | 2 +-
 Assets/Mirage/package.json                                 | 2 +-
 8 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index 92c5c974d14..f3b91419ee8 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("96.4.0")]
+[assembly: AssemblyVersion("96.4.1")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index 829105f67ba..e19eb7127a1 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,10 @@
+## [96.4.1](https://github.com/MirageNet/Mirage/compare/v96.4.0...v96.4.1) (2021-06-21)
+
+
+### Bug Fixes
+
+* welcome window fixes ([#845](https://github.com/MirageNet/Mirage/issues/845)) ([a187844](https://github.com/MirageNet/Mirage/commit/a18784451fb8b4711964ee9ef6c19c161a02059b))
+
 # [96.4.0](https://github.com/MirageNet/Mirage/compare/v96.3.1...v96.4.0) (2021-06-20)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index 89c31162046..404691196f4 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("96.4.0")]
+[assembly: AssemblyVersion("96.4.1")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index 09809e2b7a6..e7f1ce8b9ee 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("96.4.0")]
+[assembly: AssemblyVersion("96.4.1")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index 645d247fa9e..79206a274e6 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("96.4.0")]
+[assembly: AssemblyVersion("96.4.1")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index 92c5c974d14..f3b91419ee8 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("96.4.0")]
+[assembly: AssemblyVersion("96.4.1")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index 92c5c974d14..f3b91419ee8 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("96.4.0")]
+[assembly: AssemblyVersion("96.4.1")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 047a4e0cd72..041db2b0fc6 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "96.4.0",
+    "version": "96.4.1",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From 677c7924b85a890f159ee0abfef44363b266f49a Mon Sep 17 00:00:00 2001
From: Paul Pacheco <paulpach@gmail.com>
Date: Mon, 21 Jun 2021 12:56:07 -0500
Subject: [PATCH 005/166] fix: null checks when types can't be resolved (#848)

---
 Assets/Mirage/Weaver/Extensions.cs |  5 +++++
 Assets/Mirage/Weaver/Resolvers.cs  | 12 ++++++++++--
 2 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/Assets/Mirage/Weaver/Extensions.cs b/Assets/Mirage/Weaver/Extensions.cs
index 62a9d81a2f4..890dd5f4e52 100644
--- a/Assets/Mirage/Weaver/Extensions.cs
+++ b/Assets/Mirage/Weaver/Extensions.cs
@@ -27,6 +27,8 @@ public static bool Is(this TypeReference td, Type t)
 
         public static bool IsDerivedFrom(this TypeDefinition td, Type baseClass)
         {
+            if (td == null)
+                return false;
 
             if (!td.IsClass)
                 return false;
@@ -86,6 +88,9 @@ public static TypeReference GetEnumUnderlyingType(this TypeDefinition td)
 
         public static bool ImplementsInterface<TInterface>(this TypeDefinition td)
         {
+            if (td == null)
+                return false;
+
             if (td.Is<TInterface>())
                 return true;
 
diff --git a/Assets/Mirage/Weaver/Resolvers.cs b/Assets/Mirage/Weaver/Resolvers.cs
index 7b6870ac3e5..cd9ff07611f 100644
--- a/Assets/Mirage/Weaver/Resolvers.cs
+++ b/Assets/Mirage/Weaver/Resolvers.cs
@@ -12,7 +12,11 @@ public static class Resolvers
     {
         public static MethodDefinition ResolveDefaultPublicCtor(TypeReference variable)
         {
-            foreach (MethodDefinition methodRef in variable.Resolve().Methods)
+            TypeDefinition td = variable.Resolve();
+            if (td == null)
+                return null;
+
+            foreach (MethodDefinition methodRef in td.Methods)
             {
                 if (methodRef.IsConstructor &&
                     methodRef.Resolve().IsPublic &&
@@ -26,7 +30,11 @@ public static MethodDefinition ResolveDefaultPublicCtor(TypeReference variable)
 
         public static MethodReference ResolveProperty(TypeReference tr, AssemblyDefinition scriptDef, string name)
         {
-            foreach (PropertyDefinition pd in tr.Resolve().Properties)
+            TypeDefinition td = tr.Resolve();
+            if (td == null)
+                return null;
+
+            foreach (PropertyDefinition pd in td.Properties)
             {
                 if (pd.Name == name)
                 {

From 67cb237c5dc5e84efec4124d7ea174bae32436eb Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Mon, 21 Jun 2021 18:07:43 +0000
Subject: [PATCH 006/166] chore(release): 96.4.2 [skip ci]

## [96.4.2](https://github.com/MirageNet/Mirage/compare/v96.4.1...v96.4.2) (2021-06-21)

### Bug Fixes

* null checks when types can't be resolved ([#848](https://github.com/MirageNet/Mirage/issues/848)) ([677c792](https://github.com/MirageNet/Mirage/commit/677c7924b85a890f159ee0abfef44363b266f49a))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs               | 2 +-
 Assets/Mirage/CHANGELOG.md                                 | 7 +++++++
 Assets/Mirage/Components/AssemblyInfo.cs                   | 2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                      | 2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs          | 2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs                     | 2 +-
 .../Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs      | 2 +-
 Assets/Mirage/package.json                                 | 2 +-
 8 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index f3b91419ee8..1e7a9d93e9d 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("96.4.1")]
+[assembly: AssemblyVersion("96.4.2")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index e19eb7127a1..f255d9f773d 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,10 @@
+## [96.4.2](https://github.com/MirageNet/Mirage/compare/v96.4.1...v96.4.2) (2021-06-21)
+
+
+### Bug Fixes
+
+* null checks when types can't be resolved ([#848](https://github.com/MirageNet/Mirage/issues/848)) ([677c792](https://github.com/MirageNet/Mirage/commit/677c7924b85a890f159ee0abfef44363b266f49a))
+
 ## [96.4.1](https://github.com/MirageNet/Mirage/compare/v96.4.0...v96.4.1) (2021-06-21)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index 404691196f4..4504fd747f3 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("96.4.1")]
+[assembly: AssemblyVersion("96.4.2")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index e7f1ce8b9ee..bd73642e5eb 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("96.4.1")]
+[assembly: AssemblyVersion("96.4.2")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index 79206a274e6..109b1c725a9 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("96.4.1")]
+[assembly: AssemblyVersion("96.4.2")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index f3b91419ee8..1e7a9d93e9d 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("96.4.1")]
+[assembly: AssemblyVersion("96.4.2")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index f3b91419ee8..1e7a9d93e9d 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("96.4.1")]
+[assembly: AssemblyVersion("96.4.2")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 041db2b0fc6..11c6a14971f 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "96.4.1",
+    "version": "96.4.2",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From 2b8b38cdad92f3d8a5c0837b947b6c589051ab85 Mon Sep 17 00:00:00 2001
From: Hertzole <hampusringstrom@gmail.com>
Date: Wed, 23 Jun 2021 15:01:08 +0200
Subject: [PATCH 007/166] Fixed character spawner. (#850)

---
 Assets/Mirage/Runtime/CharacterSpawner.cs   |  2 +-
 Assets/Tests/Editor/CharacterSpawnerTest.cs | 16 ++++++++--------
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/Assets/Mirage/Runtime/CharacterSpawner.cs b/Assets/Mirage/Runtime/CharacterSpawner.cs
index a38de7cd1f3..c3d251404c4 100644
--- a/Assets/Mirage/Runtime/CharacterSpawner.cs
+++ b/Assets/Mirage/Runtime/CharacterSpawner.cs
@@ -33,7 +33,7 @@ public class CharacterSpawner : MonoBehaviour
         public bool AutoSpawn = true;
 
         // Start is called before the first frame update
-        public virtual void Start()
+        public virtual void Awake()
         {
             if (PlayerPrefab == null)
             {
diff --git a/Assets/Tests/Editor/CharacterSpawnerTest.cs b/Assets/Tests/Editor/CharacterSpawnerTest.cs
index a9952bc09d1..2b1127a5a05 100644
--- a/Assets/Tests/Editor/CharacterSpawnerTest.cs
+++ b/Assets/Tests/Editor/CharacterSpawnerTest.cs
@@ -68,7 +68,7 @@ public void StartExceptionTest()
             spawner.PlayerPrefab = null;
             Assert.Throws<InvalidOperationException>(() =>
             {
-                spawner.Start();
+                spawner.Awake();
             });
         }
 
@@ -78,28 +78,28 @@ public void StartExceptionMissingServerObjectManagerTest()
             spawner.ServerObjectManager = null;
             Assert.Throws<InvalidOperationException>(() =>
             {
-                spawner.Start();
+                spawner.Awake();
             });
         }
 
         [Test]
         public void AutoConfigureClient()
         {
-            spawner.Start();
+            spawner.Awake();
             Assert.That(spawner.Client, Is.SameAs(client));
         }
 
         [Test]
         public void AutoConfigureServer()
         {
-            spawner.Start();
+            spawner.Awake();
             Assert.That(spawner.Server, Is.SameAs(server));
         }
 
         [Test]
         public void GetStartPositionRoundRobinTest()
         {
-            spawner.Start();
+            spawner.Awake();
 
             spawner.playerSpawnMethod = CharacterSpawner.PlayerSpawnMethod.RoundRobin;
             Assert.That(spawner.GetStartPosition(), Is.SameAs(pos1.transform));
@@ -111,7 +111,7 @@ public void GetStartPositionRoundRobinTest()
         [Test]
         public void GetStartPositionRandomTest()
         {
-            spawner.Start();
+            spawner.Awake();
 
             spawner.playerSpawnMethod = CharacterSpawner.PlayerSpawnMethod.Random;
             Assert.That(spawner.GetStartPosition(), Is.SameAs(pos1.transform) | Is.SameAs(pos2.transform));
@@ -120,7 +120,7 @@ public void GetStartPositionRandomTest()
         [Test]
         public void GetStartPositionNullTest()
         {
-            spawner.Start();
+            spawner.Awake();
 
             spawner.startPositions.Clear();
             Assert.That(spawner.GetStartPosition(), Is.SameAs(null));
@@ -132,7 +132,7 @@ public void MissingClientObjectSpawnerExceptionTest()
             spawner.ClientObjectManager = null;
             Assert.Throws<InvalidOperationException>(() =>
             {
-                spawner.Start();
+                spawner.Awake();
             });
         }
     }

From a76caf148540a2c15cc5622362391acfe20b2388 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Wed, 23 Jun 2021 16:02:12 +0100
Subject: [PATCH 008/166] fix: checking if disconnected before packing message

---
 Assets/Mirage/Runtime/NetworkPlayer.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/Assets/Mirage/Runtime/NetworkPlayer.cs b/Assets/Mirage/Runtime/NetworkPlayer.cs
index e615056e1b0..a79c65a570b 100644
--- a/Assets/Mirage/Runtime/NetworkPlayer.cs
+++ b/Assets/Mirage/Runtime/NetworkPlayer.cs
@@ -213,6 +213,8 @@ public void ClearHandlers()
         /// <returns></returns>
         public void Send<T>(T message, int channelId = Channel.Reliable)
         {
+            if (isDisconnected) { return; }
+
             using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
             {
                 // pack message and send allocation free

From 92b9fe4e74c78d0d7bb62b3cdafe84eecf7acdbc Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Wed, 23 Jun 2021 15:15:55 +0000
Subject: [PATCH 009/166] chore(release): 96.4.3 [skip ci]

## [96.4.3](https://github.com/MirageNet/Mirage/compare/v96.4.2...v96.4.3) (2021-06-23)

### Bug Fixes

* checking if disconnected before packing message ([a76caf1](https://github.com/MirageNet/Mirage/commit/a76caf148540a2c15cc5622362391acfe20b2388))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs               | 2 +-
 Assets/Mirage/CHANGELOG.md                                 | 7 +++++++
 Assets/Mirage/Components/AssemblyInfo.cs                   | 2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                      | 2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs          | 2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs                     | 2 +-
 .../Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs      | 2 +-
 Assets/Mirage/package.json                                 | 2 +-
 8 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index 1e7a9d93e9d..aee7f918bb4 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("96.4.2")]
+[assembly: AssemblyVersion("96.4.3")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index f255d9f773d..32a8370b3e2 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,10 @@
+## [96.4.3](https://github.com/MirageNet/Mirage/compare/v96.4.2...v96.4.3) (2021-06-23)
+
+
+### Bug Fixes
+
+* checking if disconnected before packing message ([a76caf1](https://github.com/MirageNet/Mirage/commit/a76caf148540a2c15cc5622362391acfe20b2388))
+
 ## [96.4.2](https://github.com/MirageNet/Mirage/compare/v96.4.1...v96.4.2) (2021-06-21)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index 4504fd747f3..edbc0dd8b92 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("96.4.2")]
+[assembly: AssemblyVersion("96.4.3")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index bd73642e5eb..575d026939b 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("96.4.2")]
+[assembly: AssemblyVersion("96.4.3")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index 109b1c725a9..8d0f99326ae 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("96.4.2")]
+[assembly: AssemblyVersion("96.4.3")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index 1e7a9d93e9d..aee7f918bb4 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("96.4.2")]
+[assembly: AssemblyVersion("96.4.3")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index 1e7a9d93e9d..aee7f918bb4 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("96.4.2")]
+[assembly: AssemblyVersion("96.4.3")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 11c6a14971f..080b1dc5ca1 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "96.4.2",
+    "version": "96.4.3",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From ea09c61e0c6c67990d05a58529a800a6948728c0 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Wed, 23 Jun 2021 16:26:25 +0100
Subject: [PATCH 010/166] feat: adding send methods for array segment

---
 Assets/Mirage/Runtime/PipePeerConnection.cs   | 26 +++++---
 .../Mirage/Runtime/SocketLayer/AckSystem.cs   | 41 +++++++------
 .../Mirage/Runtime/SocketLayer/Connection.cs  | 60 +++++++++++++++++--
 Assets/Mirage/Runtime/SocketLayer/Peer.cs     |  4 +-
 Assets/Tests/SocketLayer/AckSystemTest.cs     | 11 ++++
 5 files changed, 105 insertions(+), 37 deletions(-)

diff --git a/Assets/Mirage/Runtime/PipePeerConnection.cs b/Assets/Mirage/Runtime/PipePeerConnection.cs
index bb419dcb417..19e0c630cbc 100644
--- a/Assets/Mirage/Runtime/PipePeerConnection.cs
+++ b/Assets/Mirage/Runtime/PipePeerConnection.cs
@@ -75,36 +75,46 @@ void IConnection.Disconnect()
             otherConnection.Disconnect();
         }
 
-        INotifyToken IConnection.SendNotify(byte[] packet)
+        public INotifyToken SendNotify(byte[] packet, int offset, int length)
         {
             if (State == ConnectionState.Disconnected)
                 return default;
 
-            receive(packet);
+            receive(packet, offset, length);
 
             return new PipeNotifyToken();
         }
+        public INotifyToken SendNotify(ArraySegment<byte> packet) => SendNotify(packet.Array, packet.Offset, packet.Count);
+        public INotifyToken SendNotify(byte[] packet) => SendNotify(packet, 0, packet.Length);
 
-        void IConnection.SendReliable(byte[] message)
+
+
+
+        public void SendReliable(byte[] message, int offset, int length)
         {
             if (State == ConnectionState.Disconnected)
                 return;
 
-            receive(message);
+            receive(message, offset, length);
         }
+        public void SendReliable(ArraySegment<byte> packet) => SendReliable(packet.Array, packet.Offset, packet.Count);
+        public void SendReliable(byte[] packet) => SendReliable(packet, 0, packet.Length);
+
 
-        void IConnection.SendUnreliable(byte[] packet)
+        public void SendUnreliable(byte[] packet, int offset, int length)
         {
             if (State == ConnectionState.Disconnected)
                 return;
 
-            receive(packet);
+            receive(packet, offset, length);
         }
+        public void SendUnreliable(ArraySegment<byte> packet) => SendUnreliable(packet.Array, packet.Offset, packet.Count);
+        public void SendUnreliable(byte[] packet) => SendUnreliable(packet, 0, packet.Length);
 
-        private void receive(byte[] packet)
+        private void receive(byte[] packet, int offset, int length)
         {
             logger.Assert(State == ConnectionState.Connected);
-            otherHandler.ReceiveMessage(otherConnection, new ArraySegment<byte>(packet));
+            otherHandler.ReceiveMessage(otherConnection, new ArraySegment<byte>(packet, offset, length));
         }
 
         public class PipeEndPoint : EndPoint
diff --git a/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs b/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
index d23c8d17b67..66b89c425a8 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
@@ -170,10 +170,10 @@ private void SendAck()
             }
         }
 
-        public INotifyToken SendNotify(byte[] packet)
+        public INotifyToken SendNotify(byte[] inPacket, int inOffset, int inLength)
         {
             // todo batch Notify?
-            if (packet.Length + HEADER_SIZE_NOTIFY > MTU)
+            if (inLength + HEADER_SIZE_NOTIFY > MTU)
             {
                 throw new IndexOutOfRangeException($"Message is bigger than MTU, max Notify message size is {MTU - HEADER_SIZE_NOTIFY}");
             }
@@ -188,26 +188,26 @@ public INotifyToken SendNotify(byte[] packet)
 
             // todo check packet size is within MTU
             // todo use pool to stop allocations
-            byte[] final = new byte[packet.Length + HEADER_SIZE_NOTIFY];
-            Buffer.BlockCopy(packet, 0, final, HEADER_SIZE_NOTIFY, packet.Length);
+            byte[] outPacket = new byte[inLength + HEADER_SIZE_NOTIFY];
+            Buffer.BlockCopy(inPacket, inOffset, outPacket, HEADER_SIZE_NOTIFY, inLength);
 
-            int offset = 0;
+            int outOffset = 0;
 
-            ByteUtils.WriteByte(final, ref offset, (byte)PacketType.Notify);
+            ByteUtils.WriteByte(outPacket, ref outOffset, (byte)PacketType.Notify);
 
-            ByteUtils.WriteUShort(final, ref offset, sequence);
-            ByteUtils.WriteUShort(final, ref offset, LatestAckSequence);
-            ByteUtils.WriteULong(final, ref offset, AckMask);
+            ByteUtils.WriteUShort(outPacket, ref outOffset, sequence);
+            ByteUtils.WriteUShort(outPacket, ref outOffset, LatestAckSequence);
+            ByteUtils.WriteULong(outPacket, ref outOffset, AckMask);
 
-            Send(final, final.Length);
+            Send(outPacket, outPacket.Length);
 
             return token;
         }
 
 
-        public void SendReliable(byte[] message)
+        public void SendReliable(byte[] message, int offset, int length)
         {
-            if (message.Length + HEADER_SIZE_RELIABLE + 2 > MTU)
+            if (length + HEADER_SIZE_RELIABLE + 2 > MTU)
             {
                 throw new IndexOutOfRangeException($"Message is bigger than MTU, max Reliable message size is {MTU - HEADER_SIZE_RELIABLE - 2}");
             }
@@ -222,7 +222,7 @@ public void SendReliable(byte[] message)
                 nextBatch = CreateReliableBuffer(order);
             }
 
-            int msgLength = message.Length + 2;
+            int msgLength = length + 2;
             int batchLength = nextBatch.length;
             if (batchLength + msgLength > MTU)
             {
@@ -233,7 +233,7 @@ public void SendReliable(byte[] message)
                 nextBatch = CreateReliableBuffer(order);
             }
 
-            AddToBatch(nextBatch, message);
+            AddToBatch(nextBatch, message, offset, length);
         }
 
         private ReliablePacket CreateReliableBuffer(ushort order)
@@ -249,17 +249,16 @@ private ReliablePacket CreateReliableBuffer(ushort order)
 
             return new ReliablePacket(final, HEADER_SIZE_RELIABLE, order);
         }
-        static void AddToBatch(ReliablePacket packet, byte[] message)
+        static void AddToBatch(ReliablePacket packet, byte[] message, int offset, int length)
         {
             byte[] array = packet.buffer.array;
-            int offset = packet.length;
+            int packetOffset = packet.length;
 
-            int msgLength = message.Length;
-            ByteUtils.WriteUShort(array, ref offset, (ushort)msgLength);
-            Buffer.BlockCopy(message, 0, array, offset, msgLength);
-            offset += msgLength;
+            ByteUtils.WriteUShort(array, ref packetOffset, (ushort)length);
+            Buffer.BlockCopy(message, offset, array, packetOffset, length);
+            packetOffset += length;
 
-            packet.length = offset;
+            packet.length = packetOffset;
         }
 
         void SendReliablePacket(ReliablePacket reliable)
diff --git a/Assets/Mirage/Runtime/SocketLayer/Connection.cs b/Assets/Mirage/Runtime/SocketLayer/Connection.cs
index 822328a6c07..0cd1986a462 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Connection.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Connection.cs
@@ -15,12 +15,28 @@ public interface IConnection
         void Disconnect();
 
         INotifyToken SendNotify(byte[] packet);
+        INotifyToken SendNotify(byte[] packet, int offset, int length);
+        INotifyToken SendNotify(ArraySegment<byte> packet);
+
         /// <summary>
         /// single message, batched by AckSystem
         /// </summary>
         /// <param name="message"></param>
         void SendReliable(byte[] message);
+        /// <summary>
+        /// single message, batched by AckSystem
+        /// </summary>
+        /// <param name="message"></param>
+        void SendReliable(byte[] message, int offset, int length);
+        /// <summary>
+        /// single message, batched by AckSystem
+        /// </summary>
+        /// <param name="message"></param>
+        void SendReliable(ArraySegment<byte> message);
+
         void SendUnreliable(byte[] packet);
+        void SendUnreliable(byte[] packet, int offset, int length);
+        void SendUnreliable(ArraySegment<byte> packet);
     }
 
     /// <summary>
@@ -145,26 +161,58 @@ void ThrowIfNotConnected()
             if (_state != ConnectionState.Connected)
                 throw new InvalidOperationException("Connection is not connected");
         }
-        public void SendUnreliable(byte[] packet)
+
+
+        public void SendUnreliable(byte[] packet, int offset, int length)
         {
             ThrowIfNotConnected();
-            peer.SendUnreliable(this, packet);
+            peer.SendUnreliable(this, packet, offset, length);
+        }
+        public void SendUnreliable(byte[] packet)
+        {
+            SendUnreliable(packet, 0, packet.Length);
+        }
+        public void SendUnreliable(ArraySegment<byte> packet)
+        {
+            SendUnreliable(packet.Array, packet.Offset, packet.Count);
         }
 
-        public INotifyToken SendNotify(byte[] packet)
+
+        public INotifyToken SendNotify(byte[] packet, int offset, int length)
         {
             ThrowIfNotConnected();
-            return ackSystem.SendNotify(packet);
+            return ackSystem.SendNotify(packet, offset, length);
+        }
+        public INotifyToken SendNotify(byte[] packet)
+        {
+            return SendNotify(packet, 0, packet.Length);
+        }
+        public INotifyToken SendNotify(ArraySegment<byte> packet)
+        {
+            return SendNotify(packet.Array, packet.Offset, packet.Count);
+
         }
+
+
         /// <summary>
         /// single message, batched by AckSystem
         /// </summary>
         /// <param name="message"></param>
-        public void SendReliable(byte[] message)
+        public void SendReliable(byte[] message, int offset, int length)
         {
             ThrowIfNotConnected();
-            ackSystem.SendReliable(message);
+            ackSystem.SendReliable(message, offset, length);
+        }
+        public void SendReliable(byte[] packet)
+        {
+            SendReliable(packet, 0, packet.Length);
         }
+        public void SendReliable(ArraySegment<byte> packet)
+        {
+            SendReliable(packet.Array, packet.Offset, packet.Count);
+
+        }
+
 
         void IRawConnection.SendRaw(byte[] packet, int length)
         {
diff --git a/Assets/Mirage/Runtime/SocketLayer/Peer.cs b/Assets/Mirage/Runtime/SocketLayer/Peer.cs
index 7b78c32b177..1250709795f 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Peer.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Peer.cs
@@ -151,11 +151,11 @@ internal void Send(Connection connection, byte[] data, int length)
             }
         }
 
-        internal void SendUnreliable(Connection connection, byte[] packet)
+        internal void SendUnreliable(Connection connection, byte[] packet, int offset, int length)
         {
             using (ByteBuffer buffer = bufferPool.Take())
             {
-                Buffer.BlockCopy(packet, 0, buffer.array, 1, packet.Length);
+                Buffer.BlockCopy(packet, offset, buffer.array, 1, length);
                 // set header
                 buffer.array[0] = (byte)PacketType.Unreliable;
 
diff --git a/Assets/Tests/SocketLayer/AckSystemTest.cs b/Assets/Tests/SocketLayer/AckSystemTest.cs
index 3f59af565e8..01b3586145a 100644
--- a/Assets/Tests/SocketLayer/AckSystemTest.cs
+++ b/Assets/Tests/SocketLayer/AckSystemTest.cs
@@ -8,6 +8,17 @@
 
 namespace Mirage.SocketLayer.Tests.AckSystemTests
 {
+    internal static class AckSystemTextExtensions
+    {
+        public static INotifyToken SendNotify(this AckSystem ackSystem, byte[] array)
+        {
+            return ackSystem.SendNotify(array, 0, array.Length);
+        }
+        public static void SendReliable(this AckSystem ackSystem, byte[] array)
+        {
+            ackSystem.SendReliable(array, 0, array.Length);
+        }
+    }
     /// <summary>
     /// helper methods for testing AckSystem
     /// </summary>

From c990952246463282687c2968852dbe1ae36fdb6e Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Wed, 23 Jun 2021 16:29:23 +0100
Subject: [PATCH 011/166] perf: using array segments for sending

---
 Assets/Mirage/Runtime/NetworkPlayer.cs | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/Assets/Mirage/Runtime/NetworkPlayer.cs b/Assets/Mirage/Runtime/NetworkPlayer.cs
index a79c65a570b..9c397e484bf 100644
--- a/Assets/Mirage/Runtime/NetworkPlayer.cs
+++ b/Assets/Mirage/Runtime/NetworkPlayer.cs
@@ -1,7 +1,6 @@
 using System;
 using System.Collections.Generic;
 using System.IO;
-using System.Linq;
 using System.Net;
 using Mirage.Logging;
 using Mirage.Serialization;
@@ -217,28 +216,29 @@ public void Send<T>(T message, int channelId = Channel.Reliable)
 
             using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
             {
-                // pack message and send allocation free
                 MessagePacker.Pack(message, writer);
                 NetworkDiagnostics.OnSend(message, writer.Length, 1);
                 Send(writer.ToArraySegment(), channelId);
             }
         }
 
-        // internal because no one except Mirage should send bytes directly to
-        // the client. they would be detected as a message. send messages instead.
+        /// <summary>
+        /// Sends a block of data
+        /// <para>Only use this method if data has message Id already included, other wise receives wont know how to handle it. Otherwise use <see cref="Send{T}(T, int)"/></para>
+        /// </summary>
+        /// <param name="segment"></param>
+        /// <param name="channelId"></param>
         public void Send(ArraySegment<byte> segment, int channelId = Channel.Reliable)
         {
             if (isDisconnected) { return; }
 
-            // todo use buffer pool
-            byte[] packet = segment.ToArray();
             if (channelId == Channel.Reliable)
             {
-                connection.SendReliable(packet);
+                connection.SendReliable(segment);
             }
             else
             {
-                connection.SendUnreliable(packet);
+                connection.SendUnreliable(segment);
             }
         }
 

From 649f8fa5cd64c8e531ba82ebfb686500a15297ee Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Wed, 23 Jun 2021 16:57:36 +0100
Subject: [PATCH 012/166] refactor: adding read method to network diagnotistics
 to wrap read methods to get count

---
 Assets/Mirage/Runtime/NetworkDiagnostics.cs | 22 ++++++++++
 Assets/Mirage/Runtime/NetworkPlayer.cs      | 47 ++++++++-------------
 Assets/Mirage/Runtime/NetworkServer.cs      |  1 -
 3 files changed, 40 insertions(+), 30 deletions(-)

diff --git a/Assets/Mirage/Runtime/NetworkDiagnostics.cs b/Assets/Mirage/Runtime/NetworkDiagnostics.cs
index e3eb98eed1d..2c7fd3e4912 100644
--- a/Assets/Mirage/Runtime/NetworkDiagnostics.cs
+++ b/Assets/Mirage/Runtime/NetworkDiagnostics.cs
@@ -1,4 +1,5 @@
 using System;
+using Mirage.Serialization;
 
 namespace Mirage
 {
@@ -7,6 +8,7 @@ namespace Mirage
     /// A profiler can subscribe to these events and
     /// present the data in a friendly way to the user
     /// </summary>
+    // todo find a way to combime this with new peer metrics for more data
     public static class NetworkDiagnostics
     {
         /// <summary>
@@ -71,5 +73,25 @@ internal static void OnReceive<T>(T message, int bytes)
         }
 
         #endregion
+
+        internal static T ReadWithDiagnostics<T>(NetworkReader reader)
+        {
+            var message = default(T);
+
+            // record start position for NetworkDiagnostics because reader might contain multiple messages if using batching
+            int startPos = reader.Position;
+            try
+            {
+                message = reader.Read<T>();
+            }
+            finally
+            {
+                int endPos = reader.Position;
+                int byteLength = (endPos - startPos);
+                OnReceive(message, byteLength);
+            }
+
+            return message;
+        }
     }
 }
diff --git a/Assets/Mirage/Runtime/NetworkPlayer.cs b/Assets/Mirage/Runtime/NetworkPlayer.cs
index 9c397e484bf..96a6c69609f 100644
--- a/Assets/Mirage/Runtime/NetworkPlayer.cs
+++ b/Assets/Mirage/Runtime/NetworkPlayer.cs
@@ -125,33 +125,9 @@ private static NetworkMessageDelegate MessageHandler<T>(Action<INetworkPlayer, T
         {
             void AdapterFunction(INetworkPlayer player, NetworkReader reader)
             {
-                // 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.
-                var message = default(T);
-
-                // record start position for NetworkDiagnostics because reader might contain multiple messages if using batching
-                int startPos = reader.Position;
-                try
-                {
-                    message = reader.Read<T>();
-                }
-                finally
-                {
-                    int endPos = reader.Position;
-                    NetworkDiagnostics.OnReceive(message, endPos - startPos);
-                }
+                T message = NetworkDiagnostics.ReadWithDiagnostics<T>(reader);
 
-                handler(player, message);
+                handler.Invoke(player, message);
             }
             return AdapterFunction;
         }
@@ -217,8 +193,10 @@ public void Send<T>(T message, int channelId = Channel.Reliable)
             using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
             {
                 MessagePacker.Pack(message, writer);
-                NetworkDiagnostics.OnSend(message, writer.Length, 1);
-                Send(writer.ToArraySegment(), channelId);
+
+                var segment = writer.ToArraySegment();
+                NetworkDiagnostics.OnSend(message, segment.Count, 1);
+                Send(segment, channelId);
             }
         }
 
@@ -271,7 +249,7 @@ internal void InvokeHandler(int msgType, NetworkReader reader)
         {
             if (messageHandlers.TryGetValue(msgType, out NetworkMessageDelegate msgDelegate))
             {
-                msgDelegate(this, reader);
+                msgDelegate.Invoke(this, reader);
             }
             else
             {
@@ -292,6 +270,17 @@ void IMessageHandler.HandleMessage(ArraySegment<byte> packet)
             // unpack message
             using (PooledNetworkReader networkReader = NetworkReaderPool.GetReader(packet))
             {
+                // protect against attackers trying to send invalid data packets
+                // exception could be throw if:
+                // - invalid headers
+                // - invalid message ids
+                // - invalid data causing exceptions
+                // - negative ReadBytesAndSize prefixes
+                // - invalid utf8 strings
+                // - etc.
+                //
+                // if exception is caught, disconnect the attacker to stop any further attacks
+
                 try
                 {
                     int msgType = MessagePacker.UnpackId(networkReader);
diff --git a/Assets/Mirage/Runtime/NetworkServer.cs b/Assets/Mirage/Runtime/NetworkServer.cs
index c657d1ed847..f4cb379c732 100644
--- a/Assets/Mirage/Runtime/NetworkServer.cs
+++ b/Assets/Mirage/Runtime/NetworkServer.cs
@@ -401,7 +401,6 @@ public static void SendToMany<T>(IEnumerable<INetworkPlayer> players, T msg, int
 
                 foreach (INetworkPlayer player in players)
                 {
-                    // send to all connections, but don't wait for them
                     player.Send(segment, channelId);
                     count++;
                 }

From 821e2d28b2a764f834b96696ed6a438af2535f60 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Wed, 23 Jun 2021 17:15:42 +0100
Subject: [PATCH 013/166] fix: fixing length used for sending unreliable

---
 Assets/Mirage/Runtime/SocketLayer/Peer.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Assets/Mirage/Runtime/SocketLayer/Peer.cs b/Assets/Mirage/Runtime/SocketLayer/Peer.cs
index 1250709795f..519e3f5c821 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Peer.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Peer.cs
@@ -159,7 +159,7 @@ internal void SendUnreliable(Connection connection, byte[] packet, int offset, i
                 // set header
                 buffer.array[0] = (byte)PacketType.Unreliable;
 
-                Send(connection, buffer.array, packet.Length + 1);
+                Send(connection, buffer.array, length + 1);
             }
         }
 

From ac000eb6c2db50c81831d092c358f9e707954876 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Wed, 23 Jun 2021 17:18:45 +0100
Subject: [PATCH 014/166] perf: using pool for send notify

---
 .../Mirage/Runtime/SocketLayer/AckSystem.cs   | 21 ++++++++++---------
 1 file changed, 11 insertions(+), 10 deletions(-)

diff --git a/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs b/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
index 66b89c425a8..b1e9b999cdc 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
@@ -186,20 +186,21 @@ public INotifyToken SendNotify(byte[] inPacket, int inOffset, int inLength)
             var token = new NotifyToken();
             ushort sequence = (ushort)sentAckablePackets.Enqueue(new AckablePacket(token));
 
-            // todo check packet size is within MTU
-            // todo use pool to stop allocations
-            byte[] outPacket = new byte[inLength + HEADER_SIZE_NOTIFY];
-            Buffer.BlockCopy(inPacket, inOffset, outPacket, HEADER_SIZE_NOTIFY, inLength);
+            using (ByteBuffer buffer = bufferPool.Take())
+            {
+                byte[] outPacket = buffer.array;
+                Buffer.BlockCopy(inPacket, inOffset, outPacket, HEADER_SIZE_NOTIFY, inLength);
 
-            int outOffset = 0;
+                int outOffset = 0;
 
-            ByteUtils.WriteByte(outPacket, ref outOffset, (byte)PacketType.Notify);
+                ByteUtils.WriteByte(outPacket, ref outOffset, (byte)PacketType.Notify);
 
-            ByteUtils.WriteUShort(outPacket, ref outOffset, sequence);
-            ByteUtils.WriteUShort(outPacket, ref outOffset, LatestAckSequence);
-            ByteUtils.WriteULong(outPacket, ref outOffset, AckMask);
+                ByteUtils.WriteUShort(outPacket, ref outOffset, sequence);
+                ByteUtils.WriteUShort(outPacket, ref outOffset, LatestAckSequence);
+                ByteUtils.WriteULong(outPacket, ref outOffset, AckMask);
 
-            Send(outPacket, outPacket.Length);
+                Send(outPacket, outOffset + inLength);
+            }
 
             return token;
         }

From dc198c8637f14814a9c5d9523fd444c1c3d4d497 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Wed, 23 Jun 2021 18:31:54 +0100
Subject: [PATCH 015/166] test: fixing test method

---
 Assets/Tests/Runtime/Serialization/NetworkPlayerTest.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Assets/Tests/Runtime/Serialization/NetworkPlayerTest.cs b/Assets/Tests/Runtime/Serialization/NetworkPlayerTest.cs
index 72dcea8a41b..b769f774f3d 100644
--- a/Assets/Tests/Runtime/Serialization/NetworkPlayerTest.cs
+++ b/Assets/Tests/Runtime/Serialization/NetworkPlayerTest.cs
@@ -29,11 +29,11 @@ public void SendCallsSendOnConnection(int channel)
             player.Send(new ArraySegment<byte>(message), channel);
             if (channel == Channel.Reliable)
             {
-                connection.Received(1).SendReliable(Arg.Is<byte[]>(arg => arg.SequenceEqual(message)));
+                connection.Received(1).SendReliable(Arg.Is<ArraySegment<byte>>(arg => arg.SequenceEqual(message)));
             }
             else if (channel == Channel.Unreliable)
             {
-                connection.Received(1).SendUnreliable(Arg.Is<byte[]>(arg => arg.SequenceEqual(message)));
+                connection.Received(1).SendUnreliable(Arg.Is<ArraySegment<byte>>(arg => arg.SequenceEqual(message)));
             }
         }
 

From 2f78667a38192cf4e3da486489f6fc970bbfffac Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Wed, 23 Jun 2021 17:46:01 +0000
Subject: [PATCH 016/166] chore(release): 96.5.0 [skip ci]

# [96.5.0](https://github.com/MirageNet/Mirage/compare/v96.4.3...v96.5.0) (2021-06-23)

### Bug Fixes

* fixing length used for sending unreliable ([821e2d2](https://github.com/MirageNet/Mirage/commit/821e2d28b2a764f834b96696ed6a438af2535f60))

### Features

* adding send methods for array segment ([ea09c61](https://github.com/MirageNet/Mirage/commit/ea09c61e0c6c67990d05a58529a800a6948728c0))

### Performance Improvements

* using array segments for sending ([c990952](https://github.com/MirageNet/Mirage/commit/c990952246463282687c2968852dbe1ae36fdb6e))
* using pool for send notify ([ac000eb](https://github.com/MirageNet/Mirage/commit/ac000eb6c2db50c81831d092c358f9e707954876))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs   |  2 +-
 Assets/Mirage/CHANGELOG.md                     | 18 ++++++++++++++++++
 Assets/Mirage/Components/AssemblyInfo.cs       |  2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs          |  2 +-
 .../Mirage/Runtime/SocketLayer/AssemblyInfo.cs |  2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs         |  2 +-
 .../RigidbodyPhysics/Scripts/AssemblyInfo.cs   |  2 +-
 Assets/Mirage/package.json                     |  2 +-
 8 files changed, 25 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index aee7f918bb4..57f4023866b 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("96.4.3")]
+[assembly: AssemblyVersion("96.5.0")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index 32a8370b3e2..85753301da9 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,21 @@
+# [96.5.0](https://github.com/MirageNet/Mirage/compare/v96.4.3...v96.5.0) (2021-06-23)
+
+
+### Bug Fixes
+
+* fixing length used for sending unreliable ([821e2d2](https://github.com/MirageNet/Mirage/commit/821e2d28b2a764f834b96696ed6a438af2535f60))
+
+
+### Features
+
+* adding send methods for array segment ([ea09c61](https://github.com/MirageNet/Mirage/commit/ea09c61e0c6c67990d05a58529a800a6948728c0))
+
+
+### Performance Improvements
+
+* using array segments for sending ([c990952](https://github.com/MirageNet/Mirage/commit/c990952246463282687c2968852dbe1ae36fdb6e))
+* using pool for send notify ([ac000eb](https://github.com/MirageNet/Mirage/commit/ac000eb6c2db50c81831d092c358f9e707954876))
+
 ## [96.4.3](https://github.com/MirageNet/Mirage/compare/v96.4.2...v96.4.3) (2021-06-23)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index edbc0dd8b92..958e3d3400b 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("96.4.3")]
+[assembly: AssemblyVersion("96.5.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index 575d026939b..796056fe80f 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("96.4.3")]
+[assembly: AssemblyVersion("96.5.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index 8d0f99326ae..561b8d7a6dc 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("96.4.3")]
+[assembly: AssemblyVersion("96.5.0")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index aee7f918bb4..57f4023866b 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("96.4.3")]
+[assembly: AssemblyVersion("96.5.0")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index aee7f918bb4..57f4023866b 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("96.4.3")]
+[assembly: AssemblyVersion("96.5.0")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 080b1dc5ca1..a815c75e8de 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "96.4.3",
+    "version": "96.5.0",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From 466516b255360ba0411cc7639b9980530754192c Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Wed, 23 Jun 2021 18:54:53 +0100
Subject: [PATCH 017/166] test: moving classes to new files

---
 Assets/Tests/SocketLayer/AckSystem.meta       |   8 +
 .../SocketLayer/AckSystem/AckSystemTest.cs    |  82 ++
 .../{ => AckSystem}/AckSystemTest.cs.meta     |   0
 .../AckSystem/AckSystemTest_Notify_1stSend.cs |  77 ++
 .../AckSystemTest_Notify_1stSend.cs.meta      |  11 +
 .../AckSystemTest_Notify_DroppedSends.cs      | 152 +++
 .../AckSystemTest_Notify_DroppedSends.cs.meta |  11 +
 .../AckSystemTest_Notify_ManySends.cs         |  91 ++
 .../AckSystemTest_Notify_ManySends.cs.meta    |  11 +
 .../AckSystemTest_Notify_NoDroppedSends.cs    | 168 ++++
 ...ckSystemTest_Notify_NoDroppedSends.cs.meta |  11 +
 .../AckSystem/AckSystemTest_Reliable.cs       | 346 +++++++
 .../AckSystem/AckSystemTest_Reliable.cs.meta  |  11 +
 Assets/Tests/SocketLayer/AckSystemTest.cs     | 891 ------------------
 14 files changed, 979 insertions(+), 891 deletions(-)
 create mode 100644 Assets/Tests/SocketLayer/AckSystem.meta
 create mode 100644 Assets/Tests/SocketLayer/AckSystem/AckSystemTest.cs
 rename Assets/Tests/SocketLayer/{ => AckSystem}/AckSystemTest.cs.meta (100%)
 create mode 100644 Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_1stSend.cs
 create mode 100644 Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_1stSend.cs.meta
 create mode 100644 Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_DroppedSends.cs
 create mode 100644 Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_DroppedSends.cs.meta
 create mode 100644 Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_ManySends.cs
 create mode 100644 Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_ManySends.cs.meta
 create mode 100644 Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_NoDroppedSends.cs
 create mode 100644 Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_NoDroppedSends.cs.meta
 create mode 100644 Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Reliable.cs
 create mode 100644 Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Reliable.cs.meta
 delete mode 100644 Assets/Tests/SocketLayer/AckSystemTest.cs

diff --git a/Assets/Tests/SocketLayer/AckSystem.meta b/Assets/Tests/SocketLayer/AckSystem.meta
new file mode 100644
index 00000000000..da59a9f1ecd
--- /dev/null
+++ b/Assets/Tests/SocketLayer/AckSystem.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: ff9abc2ce7677a746af55ccb82047a14
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest.cs b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest.cs
new file mode 100644
index 00000000000..25ec69f9b92
--- /dev/null
+++ b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest.cs
@@ -0,0 +1,82 @@
+using System.Collections.Generic;
+using NUnit.Framework;
+
+namespace Mirage.SocketLayer.Tests.AckSystemTests
+{
+    internal static class AckSystemTextExtensions
+    {
+        public static INotifyToken SendNotify(this AckSystem ackSystem, byte[] array)
+        {
+            return ackSystem.SendNotify(array, 0, array.Length);
+        }
+        public static void SendReliable(this AckSystem ackSystem, byte[] array)
+        {
+            ackSystem.SendReliable(array, 0, array.Length);
+        }
+    }
+    /// <summary>
+    /// helper methods for testing AckSystem
+    /// </summary>
+    public class AckSystemTestBase
+    {
+        readonly System.Random rand = new System.Random();
+        protected BufferPool bufferPool = new BufferPool(1300, 100, 1000);
+
+        protected byte[] createRandomData(int id)
+        {
+            // random size messages
+            byte[] buffer = new byte[rand.Next(2, 12)];
+            // fill array with random
+            rand.NextBytes(buffer);
+
+            // first bytes can be ID
+            buffer[0] = (byte)id;
+            return buffer;
+        }
+
+        /// <summary>
+        /// more effecient that CollectionAssert
+        /// </summary>
+        protected static void AssertAreSameFromOffsets(byte[] expected, int expectedOffset, byte[] actual, int actualOffset, int length)
+        {
+            for (int i = 0; i < length; i++)
+            {
+                if (expected[i + expectedOffset] != actual[i + actualOffset])
+                {
+                    byte e = expected[i + expectedOffset];
+                    byte a = actual[i + actualOffset];
+                    Assert.Fail($"Arrays are not the same\n  expected {e}\n  actual {a}");
+                }
+            }
+        }
+    }
+
+    // NSubstitute doesn't work for this type because interface is internal
+    class SubIRawConnection : IRawConnection
+    {
+        public List<byte[]> packets = new List<byte[]>();
+
+        public void SendRaw(byte[] packet, int length)
+        {
+            byte[] clone = new byte[length];
+            System.Buffer.BlockCopy(packet, 0, clone, 0, length);
+            packets.Add(clone);
+        }
+    }
+
+    internal class AckTestInstance
+    {
+        public SubIRawConnection connection;
+        public AckSystem ackSystem;
+
+        /// <summary>
+        /// Bytes given to ack system
+        /// </summary>
+        public List<byte[]> messages;
+
+        /// <summary>Sent messages</summary>
+        public byte[] message(int i) => messages[i];
+        /// <summary>received packet</summary>
+        public byte[] packet(int i) => connection.packets[i];
+    }
+}
diff --git a/Assets/Tests/SocketLayer/AckSystemTest.cs.meta b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest.cs.meta
similarity index 100%
rename from Assets/Tests/SocketLayer/AckSystemTest.cs.meta
rename to Assets/Tests/SocketLayer/AckSystem/AckSystemTest.cs.meta
diff --git a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_1stSend.cs b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_1stSend.cs
new file mode 100644
index 00000000000..4733d335109
--- /dev/null
+++ b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_1stSend.cs
@@ -0,0 +1,77 @@
+using NUnit.Framework;
+
+namespace Mirage.SocketLayer.Tests.AckSystemTests
+{
+    /// <summary>
+    /// Send is done in setup, and then tests just valid that the sent data is correct
+    /// </summary>
+    [Category("SocketLayer")]
+    public class AckSystemTest_Notify_1stSend : AckSystemTestBase
+    {
+        private SubIRawConnection connection;
+        private AckSystem ackSystem;
+
+        /// <summary>
+        /// Bytes given to ack system
+        /// </summary>
+        byte[] message;
+        /// <summary>
+        /// Bytes out of ack system
+        /// </summary>
+        byte[] packet;
+
+        [SetUp]
+        public void SetUp()
+        {
+            connection = new SubIRawConnection();
+            ackSystem = new AckSystem(connection, new Config(), new Time(), bufferPool);
+
+            message = createRandomData(1);
+            ackSystem.SendNotify(message);
+
+            // should have got 1 packet
+            Assert.That(connection.packets.Count, Is.EqualTo(1));
+            packet = connection.packets[0];
+
+            // should have sent data
+            Assert.That(packet, Is.Not.Null);
+        }
+
+        [Test]
+        public void PacketShouldBeNotify()
+        {
+            int offset = 0;
+            byte packetType = ByteUtils.ReadByte(packet, ref offset);
+            Assert.That((PacketType)packetType, Is.EqualTo(PacketType.Notify));
+        }
+
+        [Test]
+        public void PacketSequenceShouldBe1()
+        {
+            int offset = 1;
+            ushort sequance = ByteUtils.ReadUShort(packet, ref offset);
+            Assert.That(sequance, Is.EqualTo(0));
+        }
+
+        [Test]
+        public void PacketReceivedShouldBe0()
+        {
+            int offset = 3;
+            ushort received = ByteUtils.ReadUShort(packet, ref offset);
+            Assert.That(received, Is.EqualTo(0));
+        }
+        [Test]
+        public void PacketMaskShouldBe0()
+        {
+            int offset = 5;
+            ushort mask = ByteUtils.ReadUShort(packet, ref offset);
+            Assert.That(mask, Is.EqualTo(0));
+        }
+
+        [Test]
+        public void PacketShouldContainMessage()
+        {
+            AssertAreSameFromOffsets(message, 0, packet, AckSystem.HEADER_SIZE_NOTIFY, message.Length);
+        }
+    }
+}
diff --git a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_1stSend.cs.meta b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_1stSend.cs.meta
new file mode 100644
index 00000000000..d36cc5e0caa
--- /dev/null
+++ b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_1stSend.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 0f4ac88bcf0872745b2862828c54d2d3
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_DroppedSends.cs b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_DroppedSends.cs
new file mode 100644
index 00000000000..a469b02973a
--- /dev/null
+++ b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_DroppedSends.cs
@@ -0,0 +1,152 @@
+using System.Collections.Generic;
+using System.Linq;
+using NUnit.Framework;
+
+namespace Mirage.SocketLayer.Tests.AckSystemTests
+{
+    /// <summary>
+    /// Send is done in setup, and then tests just valid that the sent data is correct
+    /// </summary>
+    [Category("SocketLayer")]
+    public class AckSystemTest_Notify_DroppedSends : AckSystemTestBase
+    {
+        const int messageCount = 5;
+
+        AckTestInstance instance1;
+        AckTestInstance instance2;
+
+        // what message get received each instance
+        bool[] received1 = new bool[messageCount] {
+            true,
+            false,
+            false,
+            true,
+            true,
+        };
+        bool[] received2 = new bool[messageCount] {
+            false,
+            true,
+            true,
+            false,
+            true,
+        };
+
+        [SetUp]
+        public void SetUp()
+        {
+            instance1 = new AckTestInstance();
+            instance1.connection = new SubIRawConnection();
+            instance1.ackSystem = new AckSystem(instance1.connection, new Config(), new Time(), bufferPool);
+
+
+            instance2 = new AckTestInstance();
+            instance2.connection = new SubIRawConnection();
+            instance2.ackSystem = new AckSystem(instance2.connection, new Config(), new Time(), bufferPool);
+
+            // create and send n messages
+            instance1.messages = new List<byte[]>();
+            instance2.messages = new List<byte[]>();
+            for (int i = 0; i < messageCount; i++)
+            {
+                instance1.messages.Add(createRandomData(i + 1));
+                instance2.messages.Add(createRandomData(i + 1));
+
+                // send inside loop so message sending alternates between 1 and 2
+
+                // send to conn1
+                instance1.ackSystem.SendNotify(instance1.messages[i]);
+
+                // give to instance2 if received
+                if (received2[i])
+                    instance2.ackSystem.ReceiveNotify(instance1.connection.packets[i], instance1.connection.packets[i].Length);
+
+                // send to conn2
+                instance2.ackSystem.SendNotify(instance2.messages[i]);
+                // give to instance1 if received
+                if (received1[i])
+                    instance1.ackSystem.ReceiveNotify(instance2.connection.packets[i], instance2.connection.packets[i].Length);
+            }
+
+            // should have got 1 packet
+            Assert.That(instance1.connection.packets.Count, Is.EqualTo(messageCount));
+            Assert.That(instance2.connection.packets.Count, Is.EqualTo(messageCount));
+
+            // should not have null data
+            Assert.That(instance1.connection.packets, Does.Not.Contain(null));
+            Assert.That(instance2.connection.packets, Does.Not.Contain(null));
+        }
+
+
+        [Test]
+        public void ReceivedShouldBeEqualToLatest()
+        {
+            ushort nextReceive = 0;
+            for (int i = 0; i < messageCount; i++)
+            {
+                int offset = 3;
+                ushort received = ByteUtils.ReadUShort(instance1.packet(i), ref offset);
+                Assert.That(received, Is.EqualTo(nextReceive), "Received should start at 0 and increment each time");
+
+                // do at end becuase 1 is sending first
+                if (received1[i])
+                    nextReceive = (ushort)(i);
+            }
+
+            nextReceive = 0;
+            for (int i = 0; i < messageCount; i++)
+            {
+                // do at start becuase 2 is sending second
+                if (received2[i])
+                    nextReceive = (ushort)(i);
+
+                int offset = 3;
+                ushort received = ByteUtils.ReadUShort(instance2.packet(i), ref offset);
+                Assert.That(received, Is.EqualTo(nextReceive), "Received should start at 1 (received first message before sending) and increment each time");
+            }
+        }
+
+        [Test]
+        public void MaskShouldBePreviousSequences()
+        {
+            uint[] expectedMask1 = new uint[5] {
+                0b0,    // no received
+                0b1,    // i=0 received
+                0b1,    // still just i=0
+                0b1,    // still just i=0
+                0b1001, // received i=3
+            };
+            uint[] expectedMask2 = new uint[5] {
+                0b0,    // i=0 not received
+                0b1,    // i=1 received
+                0b11,   // i=2 received
+                0b11,   // still just i=2
+                0b1101, // received i=4
+            };
+            uint[] mask = new uint[5];
+
+            for (int i = 0; i < messageCount; i++)
+            {
+                int offset = 5;
+                mask[i] = ByteUtils.ReadUInt(instance1.packet(i), ref offset);
+            }
+            // do 2nd loop so we can log all values to debug
+            for (int i = 0; i < messageCount; i++)
+            {
+                Assert.That(mask[i], Is.EqualTo(expectedMask1[i]), $"Received should contain previous receives\n  instance 1, index{i}\n{string.Join(",", mask.Select(x => x.ToString()))}");
+            }
+
+
+            // start at 1
+            for (int i = 0; i < messageCount; i++)
+            {
+                int offset = 5;
+                mask[i] = ByteUtils.ReadUInt(instance2.packet(i), ref offset);
+            }
+            // do 2nd loop so we can log all values to debug
+            for (int i = 0; i < messageCount; i++)
+            {
+                Assert.That(mask[i], Is.EqualTo(expectedMask2[i]), $"Received should contain previous receives\n  instance 2, index{i}\n{string.Join(",", mask.Select(x => x.ToString()))}");
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_DroppedSends.cs.meta b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_DroppedSends.cs.meta
new file mode 100644
index 00000000000..cc0ee398c80
--- /dev/null
+++ b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_DroppedSends.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 75da1a60151877d4b94f9b7e30f55ada
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_ManySends.cs b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_ManySends.cs
new file mode 100644
index 00000000000..b221b27fe54
--- /dev/null
+++ b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_ManySends.cs
@@ -0,0 +1,91 @@
+using System.Collections.Generic;
+using NUnit.Framework;
+
+namespace Mirage.SocketLayer.Tests.AckSystemTests
+{
+    /// <summary>
+    /// Send is done in setup, and then tests just valid that the sent data is correct
+    /// </summary>
+    [Category("SocketLayer")]
+    public class AckSystemTest_Notify_ManySends : AckSystemTestBase
+    {
+        const int messageCount = 5;
+
+        AckTestInstance instance;
+
+        [SetUp]
+        public void SetUp()
+        {
+            instance = new AckTestInstance();
+            instance.connection = new SubIRawConnection();
+            instance.ackSystem = new AckSystem(instance.connection, new Config(), new Time(), bufferPool);
+
+            // create and send n messages
+            instance.messages = new List<byte[]>();
+            for (int i = 0; i < messageCount; i++)
+            {
+                instance.messages.Add(createRandomData(i + 1));
+                instance.ackSystem.SendNotify(instance.messages[i]);
+            }
+
+
+            // should have got 1 packet
+            Assert.That(instance.connection.packets.Count, Is.EqualTo(messageCount));
+
+            // should not have null data
+            Assert.That(instance.connection.packets, Does.Not.Contain(null));
+        }
+
+        [Test]
+        public void AllPacketShouldBeNotify()
+        {
+            for (int i = 0; i < messageCount; i++)
+            {
+                int offset = 0;
+                byte packetType = ByteUtils.ReadByte(instance.packet(i), ref offset);
+                Assert.That((PacketType)packetType, Is.EqualTo(PacketType.Notify));
+            }
+        }
+
+        [Test]
+        public void PacketSequenceShouldIncrement()
+        {
+            for (int i = 0; i < messageCount; i++)
+            {
+                int offset = 1;
+                ushort sequance = ByteUtils.ReadUShort(instance.packet(i), ref offset);
+                Assert.That(sequance, Is.EqualTo(i), "sequnce should start at 1 and increment for each message");
+            }
+        }
+
+        [Test]
+        public void PacketReceivedShouldBe0()
+        {
+            for (int i = 0; i < messageCount; i++)
+            {
+                int offset = 3;
+                ushort received = ByteUtils.ReadUShort(instance.packet(i), ref offset);
+                Assert.That(received, Is.EqualTo(0), "Received should stay 0");
+            }
+        }
+        [Test]
+        public void PacketMaskShouldBe0()
+        {
+            for (int i = 0; i < messageCount; i++)
+            {
+                int offset = 5;
+                ushort mask = ByteUtils.ReadUShort(instance.packet(i), ref offset);
+                Assert.That(mask, Is.EqualTo(0), "Received should stay 0");
+            }
+        }
+
+        [Test]
+        public void PacketShouldContainMessage()
+        {
+            for (int i = 0; i < messageCount; i++)
+            {
+                AssertAreSameFromOffsets(instance.message(i), 0, instance.packet(i), AckSystem.HEADER_SIZE_NOTIFY, instance.message(i).Length);
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_ManySends.cs.meta b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_ManySends.cs.meta
new file mode 100644
index 00000000000..c7d482415c2
--- /dev/null
+++ b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_ManySends.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 70fcf426a94e5dc40b7876bac2f1c843
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_NoDroppedSends.cs b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_NoDroppedSends.cs
new file mode 100644
index 00000000000..a467e518cb8
--- /dev/null
+++ b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_NoDroppedSends.cs
@@ -0,0 +1,168 @@
+using System.Collections.Generic;
+using System.Linq;
+using NUnit.Framework;
+using UnityEngine;
+
+namespace Mirage.SocketLayer.Tests.AckSystemTests
+{
+    /// <summary>
+    /// Send is done in setup, and then tests just valid that the sent data is correct
+    /// </summary>
+    [Category("SocketLayer")]
+    public class AckSystemTest_Notify_NoDroppedSends : AckSystemTestBase
+    {
+        const int messageCount = 5;
+
+        AckTestInstance instance1;
+        AckTestInstance instance2;
+
+
+        [SetUp]
+        public void SetUp()
+        {
+            instance1 = new AckTestInstance();
+            instance1.connection = new SubIRawConnection();
+            instance1.ackSystem = new AckSystem(instance1.connection, new Config(), new Time(), bufferPool);
+
+
+            instance2 = new AckTestInstance();
+            instance2.connection = new SubIRawConnection();
+            instance2.ackSystem = new AckSystem(instance2.connection, new Config(), new Time(), bufferPool);
+
+            // create and send n messages
+            instance1.messages = new List<byte[]>();
+            instance2.messages = new List<byte[]>();
+            for (int i = 0; i < messageCount; i++)
+            {
+                instance1.messages.Add(createRandomData(i + 1));
+                instance2.messages.Add(createRandomData(i + 1));
+
+                // send inside loop so message sending alternates between 1 and 2
+
+                // send to conn1
+                instance1.ackSystem.SendNotify(instance1.messages[i]);
+                // give to instance2 from conn1
+                instance2.ackSystem.ReceiveNotify(instance1.connection.packets[i], instance1.connection.packets[i].Length);
+
+                // send to conn2
+                instance2.ackSystem.SendNotify(instance2.messages[i]);
+                // give to instance1 from conn2
+                instance1.ackSystem.ReceiveNotify(instance2.connection.packets[i], instance2.connection.packets[i].Length);
+            }
+
+            // should have got 1 packet
+            Assert.That(instance1.connection.packets.Count, Is.EqualTo(messageCount));
+            Assert.That(instance2.connection.packets.Count, Is.EqualTo(messageCount));
+
+            // should not have null data
+            Assert.That(instance1.connection.packets, Does.Not.Contain(null));
+            Assert.That(instance2.connection.packets, Does.Not.Contain(null));
+        }
+
+
+        [Test]
+        public void AllPacketsShouldBeNotify()
+        {
+            for (int i = 0; i < messageCount; i++)
+            {
+                int offset = 0;
+                byte packetType = ByteUtils.ReadByte(instance1.packet(i), ref offset);
+                Assert.That((PacketType)packetType, Is.EqualTo(PacketType.Notify));
+            }
+
+            for (int i = 0; i < messageCount; i++)
+            {
+                int offset = 0;
+                byte packetType = ByteUtils.ReadByte(instance2.packet(i), ref offset);
+                Assert.That((PacketType)packetType, Is.EqualTo(PacketType.Notify));
+            }
+        }
+
+        [Test]
+        public void SequenceShouldIncrementPerSystem()
+        {
+            for (int i = 0; i < messageCount; i++)
+            {
+                int offset = 1;
+                ushort sequance = ByteUtils.ReadUShort(instance1.packet(i), ref offset);
+                Assert.That(sequance, Is.EqualTo(i), "sequnce should start at 1 and increment for each message");
+            }
+
+            for (int i = 0; i < messageCount; i++)
+            {
+                int offset = 1;
+                ushort sequance = ByteUtils.ReadUShort(instance2.packet(i), ref offset);
+                Assert.That(sequance, Is.EqualTo(i), "sequnce should start at 1 and increment for each message");
+            }
+        }
+
+        [Test]
+        public void ReceivedShouldBeEqualToLatest()
+        {
+            for (int i = 0; i < messageCount; i++)
+            {
+                int offset = 3;
+                ushort received = ByteUtils.ReadUShort(instance1.packet(i), ref offset);
+                Assert.That(received, Is.EqualTo(Mathf.Clamp(i - 1, 0, messageCount)), "Received should start at 0 and increment each time");
+            }
+
+            for (int i = 0; i < messageCount; i++)
+            {
+                int offset = 3;
+                ushort received = ByteUtils.ReadUShort(instance2.packet(i), ref offset);
+                Assert.That(received, Is.EqualTo(i), "Received should start at 1 (received first message before sending) and increment each time");
+            }
+        }
+        [Test]
+        public void MaskShouldBePreviousSequences()
+        {
+            uint[] expectedMask = new uint[6] {
+                0b0,
+                0b1,
+                0b11,
+                0b111,
+                0b1111,
+                0b1_1111,
+            };
+            uint[] mask = new uint[5];
+
+            for (int i = 0; i < messageCount; i++)
+            {
+                int offset = 5;
+                mask[i] = ByteUtils.ReadUInt(instance1.packet(i), ref offset);
+            }
+            // do 2nd loop so we can log all values to debug
+            for (int i = 0; i < messageCount; i++)
+            {
+                Assert.That(mask[i], Is.EqualTo(expectedMask[i]), $"Received should contain previous receives\n  instance 1, index{i}\n{string.Join(",", mask.Select(x => x.ToString()))}");
+            }
+
+
+            // start at 1
+            for (int i = 0; i < messageCount; i++)
+            {
+                int offset = 5;
+                mask[i] = ByteUtils.ReadUInt(instance2.packet(i), ref offset);
+            }
+            // do 2nd loop so we can log all values to debug
+            for (int i = 0; i < messageCount; i++)
+            {
+                Assert.That(mask[i], Is.EqualTo(expectedMask[i + 1]), $"Received should contain previous receives\n  instance 2, index{i}\n{string.Join(",", mask.Select(x => x.ToString()))}");
+            }
+        }
+
+        [Test]
+        public void PacketShouldContainMessage()
+        {
+            for (int i = 0; i < messageCount; i++)
+            {
+                AssertAreSameFromOffsets(instance1.message(i), 0, instance1.packet(i), AckSystem.HEADER_SIZE_NOTIFY, instance1.message(i).Length);
+            }
+
+            for (int i = 0; i < messageCount; i++)
+            {
+                AssertAreSameFromOffsets(instance2.message(i), 0, instance2.packet(i), AckSystem.HEADER_SIZE_NOTIFY, instance2.message(i).Length);
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_NoDroppedSends.cs.meta b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_NoDroppedSends.cs.meta
new file mode 100644
index 00000000000..3f6fb4f3ad9
--- /dev/null
+++ b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_NoDroppedSends.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 8b22f2ff47e96b145b0abc3ad83df979
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Reliable.cs b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Reliable.cs
new file mode 100644
index 00000000000..01fcc0fe225
--- /dev/null
+++ b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Reliable.cs
@@ -0,0 +1,346 @@
+using System;
+using System.Collections;
+using System.Collections.Generic;
+using NUnit.Framework;
+using UnityEngine.TestTools;
+
+namespace Mirage.SocketLayer.Tests.AckSystemTests
+{
+    /// <summary>
+    /// Send is done in setup, and then tests just valid that the sent data is correct
+    /// </summary>
+    [Category("SocketLayer")]
+    public class AckSystemTest_Reliable : AckSystemTestBase
+    {
+        class Time : ITime
+        {
+            public float Now { get; set; }
+        }
+        class BadSocket
+        {
+            readonly AckSystem ackSystem1;
+            readonly AckSystem ackSystem2;
+
+            readonly SubIRawConnection connection1;
+            readonly SubIRawConnection connection2;
+
+            int processed1 = 0;
+            int processed2 = 0;
+
+            List<byte[]> ToSend1 = new List<byte[]>();
+            List<byte[]> ToSend2 = new List<byte[]>();
+
+            public BadSocket(AckTestInstance instance1, AckTestInstance instance2)
+            {
+                ackSystem1 = instance1.ackSystem;
+                ackSystem2 = instance2.ackSystem;
+                connection1 = instance1.connection;
+                connection2 = instance2.connection;
+            }
+
+            /// <summary>
+            /// Passes message from connection 1 to acksystem 2
+            /// </summary>
+            /// <param name="dropChance"></param>
+            public (List<byte[]>, List<byte[]>) Update(float dropChance, float skipChance)
+            {
+                List<byte[]> r2 = Update(ref processed1, ToSend1, connection1, ackSystem2, dropChance, skipChance);
+                List<byte[]> r1 = Update(ref processed2, ToSend2, connection2, ackSystem1, dropChance, skipChance);
+                return (r1, r2);
+            }
+            static List<byte[]> Update(ref int processed, List<byte[]> ToSend, SubIRawConnection connection, AckSystem ackSystem, float dropChance, float skipChance)
+            {
+                int count1 = connection.packets.Count;
+                for (int i = processed; i < count1; i++)
+                {
+                    byte[] packet = connection.packets[i];
+                    if (UnityEngine.Random.value > dropChance)
+                    {
+                        ToSend.Add(packet);
+                    }
+                }
+                processed = count1;
+
+                var newPackets = new List<byte[]>();
+                for (int i = 0; i < ToSend.Count; i++)
+                {
+                    if (UnityEngine.Random.value < skipChance) { continue; }
+                    newPackets.AddRange(Receive(ackSystem, ToSend[i]));
+                    ToSend.RemoveAt(i);
+                    i--;
+                }
+
+                return newPackets;
+            }
+
+            private static List<byte[]> Receive(AckSystem ackSystem, byte[] packet)
+            {
+                var messages = new List<byte[]>();
+                var type = (PacketType)packet[0];
+                switch (type)
+                {
+                    case PacketType.Reliable:
+                        ackSystem.ReceiveReliable(packet, packet.Length);
+                        break;
+                    case PacketType.Ack:
+                        ackSystem.ReceiveAck(packet);
+                        break;
+                    case PacketType.Command:
+                    case PacketType.Unreliable:
+                    case PacketType.Notify:
+                    case PacketType.KeepAlive:
+                    default:
+                        break;
+                }
+
+                while (ackSystem.NextReliablePacket(out AckSystem.ReliableReceived received))
+                {
+                    HandleAllMessageInPacket(messages, received);
+                }
+                return messages;
+            }
+
+            private static void HandleAllMessageInPacket(List<byte[]> messages, AckSystem.ReliableReceived received)
+            {
+                byte[] array = received.buffer.array;
+                int packetLength = received.length;
+                int offset = 0;
+                while (offset < packetLength)
+                {
+                    ushort length = ByteUtils.ReadUShort(array, ref offset);
+                    var message = new ArraySegment<byte>(array, offset, length);
+
+                    byte[] outBuffer = new byte[length];
+                    Buffer.BlockCopy(array, offset, outBuffer, 0, length);
+                    offset += length;
+                    messages.Add(outBuffer);
+                }
+
+                // release buffer after all its message have been handled
+                received.buffer.Release();
+            }
+        }
+
+        const float tick = 0.02f;
+
+        float timeout;
+        BadSocket badSocket;
+        Time time;
+        AckTestInstance instance1;
+        AckTestInstance instance2;
+
+        List<byte[]> receives1;
+        List<byte[]> receives2;
+
+        [SetUp]
+        public void SetUp()
+        {
+            time = new Time();
+            var config = new Config();
+            timeout = config.TimeBeforeEmptyAck;
+
+            instance1 = new AckTestInstance();
+            instance1.connection = new SubIRawConnection();
+            instance1.ackSystem = new AckSystem(instance1.connection, config, time, bufferPool);
+
+
+            instance2 = new AckTestInstance();
+            instance2.connection = new SubIRawConnection();
+            instance2.ackSystem = new AckSystem(instance2.connection, config, time, bufferPool);
+
+            badSocket = new BadSocket(instance1, instance2);
+
+            // create and send n messages
+            instance1.messages = new List<byte[]>();
+            instance2.messages = new List<byte[]>();
+
+            receives1 = new List<byte[]>();
+            receives2 = new List<byte[]>();
+        }
+
+        [TearDown]
+        public void TearDown()
+        {
+            time = null;
+            badSocket = null;
+            instance1 = null;
+            instance2 = null;
+            receives1 = null;
+            receives2 = null;
+            System.GC.Collect();
+        }
+
+        [UnityTest]
+        [TestCase(true, 100, 0f, 0f)]
+        [TestCase(true, 100, 0.2f, 0f)]
+        [TestCase(true, 100, 0.2f, 0.4f)]
+        [TestCase(true, 3000, 0.2f, 0f)]
+        [TestCase(true, 3000, 0.2f, 0.4f)]
+        [TestCase(false, 100, 0f, 0f)]
+        [TestCase(false, 100, 0.2f, 0f)]
+        [TestCase(false, 100, 0.2f, 0.4f)]
+        [TestCase(false, 3000, 0.2f, 0f)]
+        [TestCase(false, 3000, 0.2f, 0.4f)]
+        [Repeat(100)]
+        public void AllMessagesShouldHaveBeenReceivedInOrder(bool instance2Sends, int messageCount, float dropChance, float skipChance)
+        {
+            SendManyMessages(instance2Sends, messageCount, dropChance, skipChance);
+
+            // ---- asserts ---- // 
+            Assert.That(receives2, Has.Count.EqualTo(messageCount + 1));
+            Assert.That(receives1, Has.Count.EqualTo(instance2Sends ? messageCount + 1 : 0));
+
+            // check all message reached other side
+            for (int i = 0; i < messageCount; i++)
+            {
+                byte[] message = receives2[i];
+
+                byte[] expected = instance1.message(i);
+                AssertAreSameFromOffsets(expected, 0, message, 0, expected.Length);
+            }
+
+
+            if (instance2Sends)
+            {
+                for (int i = 0; i < messageCount; i++)
+                {
+                    byte[] message = receives1[i];
+
+                    byte[] expected = instance2.message(i);
+                    AssertAreSameFromOffsets(expected, 0, message, 0, expected.Length);
+                }
+            }
+        }
+
+        void SendManyMessages(bool instance2Sends, int messageCount, float dropChance, float skipChance)
+        {
+            // send all messages
+            for (int i = 0; i < messageCount; i++)
+            {
+                instance1.messages.Add(createRandomData(i + 1));
+                instance2.messages.Add(createRandomData(i + 1));
+
+                // send inside loop so message sending alternates between 1 and 2
+
+                // send to conn1
+                instance1.ackSystem.SendReliable(instance1.messages[i]);
+
+                if (instance2Sends)
+                {
+                    // send to conn2
+                    instance2.ackSystem.SendReliable(instance2.messages[i]);
+                }
+
+                // fake Update
+                Tick(dropChance, skipChance);
+            }
+
+            // send 1 more message so that other side will for sure get last message
+            // if we dont do then last message could be forgot and we receive 99/100
+            instance1.ackSystem.SendReliable(new byte[1] { 0 });
+            if (instance2Sends)
+            {
+                instance2.ackSystem.SendReliable(new byte[1] { 0 });
+            }
+            // run for enough updates that all message should be received
+            // wait more than timeout incase 
+            for (float t = 0; t < timeout * 2f; t += tick)
+            {
+                // fake Update
+                Tick(0, 0);
+            }
+
+            // should not have null data
+            Assert.That(instance1.connection.packets, Does.Not.Contain(null));
+            Assert.That(instance2.connection.packets, Does.Not.Contain(null));
+        }
+
+        private void Tick(float dropChance, float skipChance)
+        {
+            time.Now += tick;
+            instance1.ackSystem.Update();
+            instance2.ackSystem.Update();
+            (List<byte[]>, List<byte[]>) newMessages = badSocket.Update(dropChance, skipChance);
+            receives1.AddRange(newMessages.Item1);
+            receives2.AddRange(newMessages.Item2);
+        }
+
+
+        [UnityTest]
+        [Explicit("Explicit Test: this test takes about 50 seconds to run")]
+        public IEnumerator AllMessagesShouldHaveBeenReceivedInOrderFrames()
+        {
+            bool instance2Sends = false;
+            int messageCount = 3000;
+            float dropChance = 0.2f;
+            float skipChance = 0.4f;
+
+            // send all messages
+            for (int i = 0; i < messageCount; i++)
+            {
+                instance1.messages.Add(createRandomData(i + 1));
+                instance2.messages.Add(createRandomData(i + 1));
+
+                // send inside loop so message sending alternates between 1 and 2
+
+                // send to conn1
+                instance1.ackSystem.SendReliable(instance1.messages[i]);
+
+                if (instance2Sends)
+                {
+                    // send to conn2
+                    instance2.ackSystem.SendReliable(instance2.messages[i]);
+                }
+
+                // fake Update
+                Tick(dropChance, skipChance);
+                yield return null;
+            }
+
+            // send 1 more message so that other side will for sure get last message
+            // if we dont do then last message could be forgot and we receive 99/100
+            instance1.ackSystem.SendReliable(new byte[1] { 0 });
+            if (instance2Sends)
+            {
+                instance2.ackSystem.SendReliable(new byte[1] { 0 });
+            }
+            // run for enough updates that all message should be received
+            // wait more than timeout incase 
+            for (float t = 0; t < timeout * 2f; t += tick)
+            {
+                // fake Update
+                Tick(0, 0);
+            }
+
+            // should not have null data
+            Assert.That(instance1.connection.packets, Does.Not.Contain(null));
+            Assert.That(instance2.connection.packets, Does.Not.Contain(null));
+
+            // ---- asserts ---- // 
+            Assert.That(receives2, Has.Count.EqualTo(messageCount + 1));
+            Assert.That(receives1, Has.Count.EqualTo(instance2Sends ? messageCount + 1 : 0));
+
+            // check all message reached other side
+            for (int i = 0; i < messageCount; i++)
+            {
+                byte[] message = receives2[i];
+
+                byte[] expected = instance1.message(i);
+                AssertAreSameFromOffsets(expected, 0, message, 0, expected.Length);
+            }
+
+
+            if (instance2Sends)
+            {
+                for (int i = 0; i < messageCount; i++)
+                {
+                    byte[] message = receives1[i];
+
+                    byte[] expected = instance2.message(i);
+                    AssertAreSameFromOffsets(expected, 0, message, 0, expected.Length);
+                }
+            }
+        }
+
+    }
+}
diff --git a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Reliable.cs.meta b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Reliable.cs.meta
new file mode 100644
index 00000000000..e60aeb9f06f
--- /dev/null
+++ b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Reliable.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 3657314a7e2c6ab4cb01d902172512ad
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/SocketLayer/AckSystemTest.cs b/Assets/Tests/SocketLayer/AckSystemTest.cs
deleted file mode 100644
index 01b3586145a..00000000000
--- a/Assets/Tests/SocketLayer/AckSystemTest.cs
+++ /dev/null
@@ -1,891 +0,0 @@
-using System;
-using System.Collections;
-using System.Collections.Generic;
-using System.Linq;
-using NUnit.Framework;
-using UnityEngine;
-using UnityEngine.TestTools;
-
-namespace Mirage.SocketLayer.Tests.AckSystemTests
-{
-    internal static class AckSystemTextExtensions
-    {
-        public static INotifyToken SendNotify(this AckSystem ackSystem, byte[] array)
-        {
-            return ackSystem.SendNotify(array, 0, array.Length);
-        }
-        public static void SendReliable(this AckSystem ackSystem, byte[] array)
-        {
-            ackSystem.SendReliable(array, 0, array.Length);
-        }
-    }
-    /// <summary>
-    /// helper methods for testing AckSystem
-    /// </summary>
-    public class AckSystemTestBase
-    {
-        System.Random rand = new System.Random();
-        protected BufferPool bufferPool = new BufferPool(1300, 100, 1000);
-
-        protected byte[] createRandomData(int id)
-        {
-            // random size messages
-            byte[] buffer = new byte[rand.Next(2, 12)];
-            // fill array with random
-            rand.NextBytes(buffer);
-
-            // first bytes can be ID
-            buffer[0] = (byte)id;
-            return buffer;
-        }
-
-        /// <summary>
-        /// more effecient that CollectionAssert
-        /// </summary>
-        protected static void AssertAreSameFromOffsets(byte[] expected, int expectedOffset, byte[] actual, int actualOffset, int length)
-        {
-            for (int i = 0; i < length; i++)
-            {
-                if (expected[i + expectedOffset] != actual[i + actualOffset])
-                {
-                    byte e = expected[i + expectedOffset];
-                    byte a = actual[i + actualOffset];
-                    Assert.Fail($"Arrays are not the same\n  expected {e}\n  actual {a}");
-                }
-            }
-        }
-    }
-
-    // NSubstitute doesn't work for this type because interface is internal
-    class SubIRawConnection : IRawConnection
-    {
-        public List<byte[]> packets = new List<byte[]>();
-
-        public void SendRaw(byte[] packet, int length)
-        {
-            byte[] clone = new byte[length];
-            System.Buffer.BlockCopy(packet, 0, clone, 0, length);
-            packets.Add(clone);
-        }
-    }
-
-    internal class AckTestInstance
-    {
-        public SubIRawConnection connection;
-        public AckSystem ackSystem;
-
-        /// <summary>
-        /// Bytes given to ack system
-        /// </summary>
-        public List<byte[]> messages;
-
-        /// <summary>Sent messages</summary>
-        public byte[] message(int i) => messages[i];
-        /// <summary>received packet</summary>
-        public byte[] packet(int i) => connection.packets[i];
-    }
-
-    /// <summary>
-    /// Send is done in setup, and then tests just valid that the sent data is correct
-    /// </summary>
-    [Category("SocketLayer")]
-    public class AckSystemTest_Notify_1stSend : AckSystemTestBase
-    {
-        private SubIRawConnection connection;
-        private AckSystem ackSystem;
-
-        /// <summary>
-        /// Bytes given to ack system
-        /// </summary>
-        byte[] message;
-        /// <summary>
-        /// Bytes out of ack system
-        /// </summary>
-        byte[] packet;
-
-        [SetUp]
-        public void SetUp()
-        {
-            connection = new SubIRawConnection();
-            ackSystem = new AckSystem(connection, new Config(), new Time(), bufferPool);
-
-            message = createRandomData(1);
-            ackSystem.SendNotify(message);
-
-            // should have got 1 packet
-            Assert.That(connection.packets.Count, Is.EqualTo(1));
-            packet = connection.packets[0];
-
-            // should have sent data
-            Assert.That(packet, Is.Not.Null);
-        }
-
-        [Test]
-        public void PacketShouldBeNotify()
-        {
-            int offset = 0;
-            byte packetType = ByteUtils.ReadByte(packet, ref offset);
-            Assert.That((PacketType)packetType, Is.EqualTo(PacketType.Notify));
-        }
-
-        [Test]
-        public void PacketSequenceShouldBe1()
-        {
-            int offset = 1;
-            ushort sequance = ByteUtils.ReadUShort(packet, ref offset);
-            Assert.That(sequance, Is.EqualTo(0));
-        }
-
-        [Test]
-        public void PacketReceivedShouldBe0()
-        {
-            int offset = 3;
-            ushort received = ByteUtils.ReadUShort(packet, ref offset);
-            Assert.That(received, Is.EqualTo(0));
-        }
-        [Test]
-        public void PacketMaskShouldBe0()
-        {
-            int offset = 5;
-            ushort mask = ByteUtils.ReadUShort(packet, ref offset);
-            Assert.That(mask, Is.EqualTo(0));
-        }
-
-        [Test]
-        public void PacketShouldContainMessage()
-        {
-            AssertAreSameFromOffsets(message, 0, packet, AckSystem.HEADER_SIZE_NOTIFY, message.Length);
-        }
-    }
-
-    /// <summary>
-    /// Send is done in setup, and then tests just valid that the sent data is correct
-    /// </summary>
-    [Category("SocketLayer")]
-    public class AckSystemTest_Notify_ManySends : AckSystemTestBase
-    {
-        const int messageCount = 5;
-
-        AckTestInstance instance;
-
-        [SetUp]
-        public void SetUp()
-        {
-            instance = new AckTestInstance();
-            instance.connection = new SubIRawConnection();
-            instance.ackSystem = new AckSystem(instance.connection, new Config(), new Time(), bufferPool);
-
-            // create and send n messages
-            instance.messages = new List<byte[]>();
-            for (int i = 0; i < messageCount; i++)
-            {
-                instance.messages.Add(createRandomData(i + 1));
-                instance.ackSystem.SendNotify(instance.messages[i]);
-            }
-
-
-            // should have got 1 packet
-            Assert.That(instance.connection.packets.Count, Is.EqualTo(messageCount));
-
-            // should not have null data
-            Assert.That(instance.connection.packets, Does.Not.Contain(null));
-        }
-
-        [Test]
-        public void AllPacketShouldBeNotify()
-        {
-            for (int i = 0; i < messageCount; i++)
-            {
-                int offset = 0;
-                byte packetType = ByteUtils.ReadByte(instance.packet(i), ref offset);
-                Assert.That((PacketType)packetType, Is.EqualTo(PacketType.Notify));
-            }
-        }
-
-        [Test]
-        public void PacketSequenceShouldIncrement()
-        {
-            for (int i = 0; i < messageCount; i++)
-            {
-                int offset = 1;
-                ushort sequance = ByteUtils.ReadUShort(instance.packet(i), ref offset);
-                Assert.That(sequance, Is.EqualTo(i), "sequnce should start at 1 and increment for each message");
-            }
-        }
-
-        [Test]
-        public void PacketReceivedShouldBe0()
-        {
-            for (int i = 0; i < messageCount; i++)
-            {
-                int offset = 3;
-                ushort received = ByteUtils.ReadUShort(instance.packet(i), ref offset);
-                Assert.That(received, Is.EqualTo(0), "Received should stay 0");
-            }
-        }
-        [Test]
-        public void PacketMaskShouldBe0()
-        {
-            for (int i = 0; i < messageCount; i++)
-            {
-                int offset = 5;
-                ushort mask = ByteUtils.ReadUShort(instance.packet(i), ref offset);
-                Assert.That(mask, Is.EqualTo(0), "Received should stay 0");
-            }
-        }
-
-        [Test]
-        public void PacketShouldContainMessage()
-        {
-            for (int i = 0; i < messageCount; i++)
-            {
-                AssertAreSameFromOffsets(instance.message(i), 0, instance.packet(i), AckSystem.HEADER_SIZE_NOTIFY, instance.message(i).Length);
-            }
-        }
-    }
-
-    /// <summary>
-    /// Send is done in setup, and then tests just valid that the sent data is correct
-    /// </summary>
-    [Category("SocketLayer")]
-    public class AckSystemTest_Notify_NoDroppedSends : AckSystemTestBase
-    {
-        const int messageCount = 5;
-
-        AckTestInstance instance1;
-        AckTestInstance instance2;
-
-
-        [SetUp]
-        public void SetUp()
-        {
-            instance1 = new AckTestInstance();
-            instance1.connection = new SubIRawConnection();
-            instance1.ackSystem = new AckSystem(instance1.connection, new Config(), new Time(), bufferPool);
-
-
-            instance2 = new AckTestInstance();
-            instance2.connection = new SubIRawConnection();
-            instance2.ackSystem = new AckSystem(instance2.connection, new Config(), new Time(), bufferPool);
-
-            // create and send n messages
-            instance1.messages = new List<byte[]>();
-            instance2.messages = new List<byte[]>();
-            for (int i = 0; i < messageCount; i++)
-            {
-                instance1.messages.Add(createRandomData(i + 1));
-                instance2.messages.Add(createRandomData(i + 1));
-
-                // send inside loop so message sending alternates between 1 and 2
-
-                // send to conn1
-                instance1.ackSystem.SendNotify(instance1.messages[i]);
-                // give to instance2 from conn1
-                instance2.ackSystem.ReceiveNotify(instance1.connection.packets[i], instance1.connection.packets[i].Length);
-
-                // send to conn2
-                instance2.ackSystem.SendNotify(instance2.messages[i]);
-                // give to instance1 from conn2
-                instance1.ackSystem.ReceiveNotify(instance2.connection.packets[i], instance2.connection.packets[i].Length);
-            }
-
-            // should have got 1 packet
-            Assert.That(instance1.connection.packets.Count, Is.EqualTo(messageCount));
-            Assert.That(instance2.connection.packets.Count, Is.EqualTo(messageCount));
-
-            // should not have null data
-            Assert.That(instance1.connection.packets, Does.Not.Contain(null));
-            Assert.That(instance2.connection.packets, Does.Not.Contain(null));
-        }
-
-
-        [Test]
-        public void AllPacketsShouldBeNotify()
-        {
-            for (int i = 0; i < messageCount; i++)
-            {
-                int offset = 0;
-                byte packetType = ByteUtils.ReadByte(instance1.packet(i), ref offset);
-                Assert.That((PacketType)packetType, Is.EqualTo(PacketType.Notify));
-            }
-
-            for (int i = 0; i < messageCount; i++)
-            {
-                int offset = 0;
-                byte packetType = ByteUtils.ReadByte(instance2.packet(i), ref offset);
-                Assert.That((PacketType)packetType, Is.EqualTo(PacketType.Notify));
-            }
-        }
-
-        [Test]
-        public void SequenceShouldIncrementPerSystem()
-        {
-            for (int i = 0; i < messageCount; i++)
-            {
-                int offset = 1;
-                ushort sequance = ByteUtils.ReadUShort(instance1.packet(i), ref offset);
-                Assert.That(sequance, Is.EqualTo(i), "sequnce should start at 1 and increment for each message");
-            }
-
-            for (int i = 0; i < messageCount; i++)
-            {
-                int offset = 1;
-                ushort sequance = ByteUtils.ReadUShort(instance2.packet(i), ref offset);
-                Assert.That(sequance, Is.EqualTo(i), "sequnce should start at 1 and increment for each message");
-            }
-        }
-
-        [Test]
-        public void ReceivedShouldBeEqualToLatest()
-        {
-            for (int i = 0; i < messageCount; i++)
-            {
-                int offset = 3;
-                ushort received = ByteUtils.ReadUShort(instance1.packet(i), ref offset);
-                Assert.That(received, Is.EqualTo(Mathf.Clamp(i - 1, 0, messageCount)), "Received should start at 0 and increment each time");
-            }
-
-            for (int i = 0; i < messageCount; i++)
-            {
-                int offset = 3;
-                ushort received = ByteUtils.ReadUShort(instance2.packet(i), ref offset);
-                Assert.That(received, Is.EqualTo(i), "Received should start at 1 (received first message before sending) and increment each time");
-            }
-        }
-        [Test]
-        public void MaskShouldBePreviousSequences()
-        {
-            uint[] expectedMask = new uint[6] {
-                0b0,
-                0b1,
-                0b11,
-                0b111,
-                0b1111,
-                0b1_1111,
-            };
-            uint[] mask = new uint[5];
-
-            for (int i = 0; i < messageCount; i++)
-            {
-                int offset = 5;
-                mask[i] = ByteUtils.ReadUInt(instance1.packet(i), ref offset);
-            }
-            // do 2nd loop so we can log all values to debug
-            for (int i = 0; i < messageCount; i++)
-            {
-                Assert.That(mask[i], Is.EqualTo(expectedMask[i]), $"Received should contain previous receives\n  instance 1, index{i}\n{string.Join(",", mask.Select(x => x.ToString()))}");
-            }
-
-
-            // start at 1
-            for (int i = 0; i < messageCount; i++)
-            {
-                int offset = 5;
-                mask[i] = ByteUtils.ReadUInt(instance2.packet(i), ref offset);
-            }
-            // do 2nd loop so we can log all values to debug
-            for (int i = 0; i < messageCount; i++)
-            {
-                Assert.That(mask[i], Is.EqualTo(expectedMask[i + 1]), $"Received should contain previous receives\n  instance 2, index{i}\n{string.Join(",", mask.Select(x => x.ToString()))}");
-            }
-        }
-
-        [Test]
-        public void PacketShouldContainMessage()
-        {
-            for (int i = 0; i < messageCount; i++)
-            {
-                AssertAreSameFromOffsets(instance1.message(i), 0, instance1.packet(i), AckSystem.HEADER_SIZE_NOTIFY, instance1.message(i).Length);
-            }
-
-            for (int i = 0; i < messageCount; i++)
-            {
-                AssertAreSameFromOffsets(instance2.message(i), 0, instance2.packet(i), AckSystem.HEADER_SIZE_NOTIFY, instance2.message(i).Length);
-            }
-        }
-    }
-
-    /// <summary>
-    /// Send is done in setup, and then tests just valid that the sent data is correct
-    /// </summary>
-    [Category("SocketLayer")]
-    public class AckSystemTest_Notify_DroppedSends : AckSystemTestBase
-    {
-        const int messageCount = 5;
-
-        AckTestInstance instance1;
-        AckTestInstance instance2;
-
-        // what message get received each instance
-        bool[] received1 = new bool[messageCount] {
-            true,
-            false,
-            false,
-            true,
-            true,
-        };
-        bool[] received2 = new bool[messageCount] {
-            false,
-            true,
-            true,
-            false,
-            true,
-        };
-
-        [SetUp]
-        public void SetUp()
-        {
-            instance1 = new AckTestInstance();
-            instance1.connection = new SubIRawConnection();
-            instance1.ackSystem = new AckSystem(instance1.connection, new Config(), new Time(), bufferPool);
-
-
-            instance2 = new AckTestInstance();
-            instance2.connection = new SubIRawConnection();
-            instance2.ackSystem = new AckSystem(instance2.connection, new Config(), new Time(), bufferPool);
-
-            // create and send n messages
-            instance1.messages = new List<byte[]>();
-            instance2.messages = new List<byte[]>();
-            for (int i = 0; i < messageCount; i++)
-            {
-                instance1.messages.Add(createRandomData(i + 1));
-                instance2.messages.Add(createRandomData(i + 1));
-
-                // send inside loop so message sending alternates between 1 and 2
-
-                // send to conn1
-                instance1.ackSystem.SendNotify(instance1.messages[i]);
-
-                // give to instance2 if received
-                if (received2[i])
-                    instance2.ackSystem.ReceiveNotify(instance1.connection.packets[i], instance1.connection.packets[i].Length);
-
-                // send to conn2
-                instance2.ackSystem.SendNotify(instance2.messages[i]);
-                // give to instance1 if received
-                if (received1[i])
-                    instance1.ackSystem.ReceiveNotify(instance2.connection.packets[i], instance2.connection.packets[i].Length);
-            }
-
-            // should have got 1 packet
-            Assert.That(instance1.connection.packets.Count, Is.EqualTo(messageCount));
-            Assert.That(instance2.connection.packets.Count, Is.EqualTo(messageCount));
-
-            // should not have null data
-            Assert.That(instance1.connection.packets, Does.Not.Contain(null));
-            Assert.That(instance2.connection.packets, Does.Not.Contain(null));
-        }
-
-
-        [Test]
-        public void ReceivedShouldBeEqualToLatest()
-        {
-            ushort nextReceive = 0;
-            for (int i = 0; i < messageCount; i++)
-            {
-                int offset = 3;
-                ushort received = ByteUtils.ReadUShort(instance1.packet(i), ref offset);
-                Assert.That(received, Is.EqualTo(nextReceive), "Received should start at 0 and increment each time");
-
-                // do at end becuase 1 is sending first
-                if (received1[i])
-                    nextReceive = (ushort)(i);
-            }
-
-            nextReceive = 0;
-            for (int i = 0; i < messageCount; i++)
-            {
-                // do at start becuase 2 is sending second
-                if (received2[i])
-                    nextReceive = (ushort)(i);
-
-                int offset = 3;
-                ushort received = ByteUtils.ReadUShort(instance2.packet(i), ref offset);
-                Assert.That(received, Is.EqualTo(nextReceive), "Received should start at 1 (received first message before sending) and increment each time");
-            }
-        }
-
-        [Test]
-        public void MaskShouldBePreviousSequences()
-        {
-            uint[] expectedMask1 = new uint[5] {
-                0b0,    // no received
-                0b1,    // i=0 received
-                0b1,    // still just i=0
-                0b1,    // still just i=0
-                0b1001, // received i=3
-            };
-            uint[] expectedMask2 = new uint[5] {
-                0b0,    // i=0 not received
-                0b1,    // i=1 received
-                0b11,   // i=2 received
-                0b11,   // still just i=2
-                0b1101, // received i=4
-            };
-            uint[] mask = new uint[5];
-
-            for (int i = 0; i < messageCount; i++)
-            {
-                int offset = 5;
-                mask[i] = ByteUtils.ReadUInt(instance1.packet(i), ref offset);
-            }
-            // do 2nd loop so we can log all values to debug
-            for (int i = 0; i < messageCount; i++)
-            {
-                Assert.That(mask[i], Is.EqualTo(expectedMask1[i]), $"Received should contain previous receives\n  instance 1, index{i}\n{string.Join(",", mask.Select(x => x.ToString()))}");
-            }
-
-
-            // start at 1
-            for (int i = 0; i < messageCount; i++)
-            {
-                int offset = 5;
-                mask[i] = ByteUtils.ReadUInt(instance2.packet(i), ref offset);
-            }
-            // do 2nd loop so we can log all values to debug
-            for (int i = 0; i < messageCount; i++)
-            {
-                Assert.That(mask[i], Is.EqualTo(expectedMask2[i]), $"Received should contain previous receives\n  instance 2, index{i}\n{string.Join(",", mask.Select(x => x.ToString()))}");
-            }
-        }
-    }
-
-    /// <summary>
-    /// Send is done in setup, and then tests just valid that the sent data is correct
-    /// </summary>
-    [Category("SocketLayer")]
-    public class AckSystemTest_Reliable : AckSystemTestBase
-    {
-        class Time : ITime
-        {
-            public float Now { get; set; }
-        }
-        class BadSocket
-        {
-            readonly AckSystem ackSystem1;
-            readonly AckSystem ackSystem2;
-
-            readonly SubIRawConnection connection1;
-            readonly SubIRawConnection connection2;
-
-            int processed1 = 0;
-            int processed2 = 0;
-
-            List<byte[]> ToSend1 = new List<byte[]>();
-            List<byte[]> ToSend2 = new List<byte[]>();
-
-            public BadSocket(AckTestInstance instance1, AckTestInstance instance2)
-            {
-                ackSystem1 = instance1.ackSystem;
-                ackSystem2 = instance2.ackSystem;
-                connection1 = instance1.connection;
-                connection2 = instance2.connection;
-            }
-
-            /// <summary>
-            /// Passes message from connection 1 to acksystem 2
-            /// </summary>
-            /// <param name="dropChance"></param>
-            public (List<byte[]>, List<byte[]>) Update(float dropChance, float skipChance)
-            {
-                List<byte[]> r2 = Update(ref processed1, ToSend1, connection1, ackSystem2, dropChance, skipChance);
-                List<byte[]> r1 = Update(ref processed2, ToSend2, connection2, ackSystem1, dropChance, skipChance);
-                return (r1, r2);
-            }
-            static List<byte[]> Update(ref int processed, List<byte[]> ToSend, SubIRawConnection connection, AckSystem ackSystem, float dropChance, float skipChance)
-            {
-                int count1 = connection.packets.Count;
-                for (int i = processed; i < count1; i++)
-                {
-                    byte[] packet = connection.packets[i];
-                    if (UnityEngine.Random.value > dropChance)
-                    {
-                        ToSend.Add(packet);
-                    }
-                }
-                processed = count1;
-
-                var newPackets = new List<byte[]>();
-                for (int i = 0; i < ToSend.Count; i++)
-                {
-                    if (UnityEngine.Random.value < skipChance) { continue; }
-                    newPackets.AddRange(Receive(ackSystem, ToSend[i]));
-                    ToSend.RemoveAt(i);
-                    i--;
-                }
-
-                return newPackets;
-            }
-
-            private static List<byte[]> Receive(AckSystem ackSystem, byte[] packet)
-            {
-                var messages = new List<byte[]>();
-                var type = (PacketType)packet[0];
-                switch (type)
-                {
-                    case PacketType.Reliable:
-                        ackSystem.ReceiveReliable(packet, packet.Length);
-                        break;
-                    case PacketType.Ack:
-                        ackSystem.ReceiveAck(packet);
-                        break;
-                    case PacketType.Command:
-                    case PacketType.Unreliable:
-                    case PacketType.Notify:
-                    case PacketType.KeepAlive:
-                    default:
-                        break;
-                }
-
-                while (ackSystem.NextReliablePacket(out AckSystem.ReliableReceived received))
-                {
-                    HandleAllMessageInPacket(messages, received);
-                }
-                return messages;
-            }
-
-            private static void HandleAllMessageInPacket(List<byte[]> messages, AckSystem.ReliableReceived received)
-            {
-                byte[] array = received.buffer.array;
-                int packetLength = received.length;
-                int offset = 0;
-                while (offset < packetLength)
-                {
-                    ushort length = ByteUtils.ReadUShort(array, ref offset);
-                    var message = new ArraySegment<byte>(array, offset, length);
-
-                    byte[] outBuffer = new byte[length];
-                    Buffer.BlockCopy(array, offset, outBuffer, 0, length);
-                    offset += length;
-                    messages.Add(outBuffer);
-                }
-
-                // release buffer after all its message have been handled
-                received.buffer.Release();
-            }
-        }
-
-        const float tick = 0.02f;
-
-        float timeout;
-        BadSocket badSocket;
-        Time time;
-        AckTestInstance instance1;
-        AckTestInstance instance2;
-
-        List<byte[]> receives1;
-        List<byte[]> receives2;
-
-        [SetUp]
-        public void SetUp()
-        {
-            time = new Time();
-            var config = new Config();
-            timeout = config.TimeBeforeEmptyAck;
-
-            instance1 = new AckTestInstance();
-            instance1.connection = new SubIRawConnection();
-            instance1.ackSystem = new AckSystem(instance1.connection, config, time, bufferPool);
-
-
-            instance2 = new AckTestInstance();
-            instance2.connection = new SubIRawConnection();
-            instance2.ackSystem = new AckSystem(instance2.connection, config, time, bufferPool);
-
-            badSocket = new BadSocket(instance1, instance2);
-
-            // create and send n messages
-            instance1.messages = new List<byte[]>();
-            instance2.messages = new List<byte[]>();
-
-            receives1 = new List<byte[]>();
-            receives2 = new List<byte[]>();
-        }
-
-        [TearDown]
-        public void TearDown()
-        {
-            time = null;
-            badSocket = null;
-            instance1 = null;
-            instance2 = null;
-            receives1 = null;
-            receives2 = null;
-            System.GC.Collect();
-        }
-
-        [UnityTest]
-        [TestCase(true, 100, 0f, 0f)]
-        [TestCase(true, 100, 0.2f, 0f)]
-        [TestCase(true, 100, 0.2f, 0.4f)]
-        [TestCase(true, 3000, 0.2f, 0f)]
-        [TestCase(true, 3000, 0.2f, 0.4f)]
-        [TestCase(false, 100, 0f, 0f)]
-        [TestCase(false, 100, 0.2f, 0f)]
-        [TestCase(false, 100, 0.2f, 0.4f)]
-        [TestCase(false, 3000, 0.2f, 0f)]
-        [TestCase(false, 3000, 0.2f, 0.4f)]
-        [Repeat(100)]
-        public void AllMessagesShouldHaveBeenReceivedInOrder(bool instance2Sends, int messageCount, float dropChance, float skipChance)
-        {
-            SendManyMessages(instance2Sends, messageCount, dropChance, skipChance);
-
-            // ---- asserts ---- // 
-            Assert.That(receives2, Has.Count.EqualTo(messageCount + 1));
-            Assert.That(receives1, Has.Count.EqualTo(instance2Sends ? messageCount + 1 : 0));
-
-            // check all message reached other side
-            for (int i = 0; i < messageCount; i++)
-            {
-                byte[] message = receives2[i];
-
-                byte[] expected = instance1.message(i);
-                AssertAreSameFromOffsets(expected, 0, message, 0, expected.Length);
-            }
-
-
-            if (instance2Sends)
-            {
-                for (int i = 0; i < messageCount; i++)
-                {
-                    byte[] message = receives1[i];
-
-                    byte[] expected = instance2.message(i);
-                    AssertAreSameFromOffsets(expected, 0, message, 0, expected.Length);
-                }
-            }
-        }
-
-        void SendManyMessages(bool instance2Sends, int messageCount, float dropChance, float skipChance)
-        {
-            // send all messages
-            for (int i = 0; i < messageCount; i++)
-            {
-                instance1.messages.Add(createRandomData(i + 1));
-                instance2.messages.Add(createRandomData(i + 1));
-
-                // send inside loop so message sending alternates between 1 and 2
-
-                // send to conn1
-                instance1.ackSystem.SendReliable(instance1.messages[i]);
-
-                if (instance2Sends)
-                {
-                    // send to conn2
-                    instance2.ackSystem.SendReliable(instance2.messages[i]);
-                }
-
-                // fake Update
-                Tick(dropChance, skipChance);
-            }
-
-            // send 1 more message so that other side will for sure get last message
-            // if we dont do then last message could be forgot and we receive 99/100
-            instance1.ackSystem.SendReliable(new byte[1] { 0 });
-            if (instance2Sends)
-            {
-                instance2.ackSystem.SendReliable(new byte[1] { 0 });
-            }
-            // run for enough updates that all message should be received
-            // wait more than timeout incase 
-            for (float t = 0; t < timeout * 2f; t += tick)
-            {
-                // fake Update
-                Tick(0, 0);
-            }
-
-            // should not have null data
-            Assert.That(instance1.connection.packets, Does.Not.Contain(null));
-            Assert.That(instance2.connection.packets, Does.Not.Contain(null));
-        }
-
-        private void Tick(float dropChance, float skipChance)
-        {
-            time.Now += tick;
-            instance1.ackSystem.Update();
-            instance2.ackSystem.Update();
-            (List<byte[]>, List<byte[]>) newMessages = badSocket.Update(dropChance, skipChance);
-            receives1.AddRange(newMessages.Item1);
-            receives2.AddRange(newMessages.Item2);
-        }
-
-
-        [UnityTest]
-        [Explicit("Explicit Test: this test takes about 50 seconds to run")]
-        public IEnumerator AllMessagesShouldHaveBeenReceivedInOrderFrames()
-        {
-            bool instance2Sends = false;
-            int messageCount = 3000;
-            float dropChance = 0.2f;
-            float skipChance = 0.4f;
-
-            // send all messages
-            for (int i = 0; i < messageCount; i++)
-            {
-                instance1.messages.Add(createRandomData(i + 1));
-                instance2.messages.Add(createRandomData(i + 1));
-
-                // send inside loop so message sending alternates between 1 and 2
-
-                // send to conn1
-                instance1.ackSystem.SendReliable(instance1.messages[i]);
-
-                if (instance2Sends)
-                {
-                    // send to conn2
-                    instance2.ackSystem.SendReliable(instance2.messages[i]);
-                }
-
-                // fake Update
-                Tick(dropChance, skipChance);
-                yield return null;
-            }
-
-            // send 1 more message so that other side will for sure get last message
-            // if we dont do then last message could be forgot and we receive 99/100
-            instance1.ackSystem.SendReliable(new byte[1] { 0 });
-            if (instance2Sends)
-            {
-                instance2.ackSystem.SendReliable(new byte[1] { 0 });
-            }
-            // run for enough updates that all message should be received
-            // wait more than timeout incase 
-            for (float t = 0; t < timeout * 2f; t += tick)
-            {
-                // fake Update
-                Tick(0, 0);
-            }
-
-            // should not have null data
-            Assert.That(instance1.connection.packets, Does.Not.Contain(null));
-            Assert.That(instance2.connection.packets, Does.Not.Contain(null));
-
-            // ---- asserts ---- // 
-            Assert.That(receives2, Has.Count.EqualTo(messageCount + 1));
-            Assert.That(receives1, Has.Count.EqualTo(instance2Sends ? messageCount + 1 : 0));
-
-            // check all message reached other side
-            for (int i = 0; i < messageCount; i++)
-            {
-                byte[] message = receives2[i];
-
-                byte[] expected = instance1.message(i);
-                AssertAreSameFromOffsets(expected, 0, message, 0, expected.Length);
-            }
-
-
-            if (instance2Sends)
-            {
-                for (int i = 0; i < messageCount; i++)
-                {
-                    byte[] message = receives1[i];
-
-                    byte[] expected = instance2.message(i);
-                    AssertAreSameFromOffsets(expected, 0, message, 0, expected.Length);
-                }
-            }
-        }
-
-    }
-}

From 6195108dd84d5e83be3ac25d824d50125fa9510f Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Sun, 27 Jun 2021 15:15:45 +0100
Subject: [PATCH 018/166] fix: fixing typo in error

---
 Assets/Mirage/Runtime/NetworkServer.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Assets/Mirage/Runtime/NetworkServer.cs b/Assets/Mirage/Runtime/NetworkServer.cs
index f4cb379c732..0c4d3fc5b7e 100644
--- a/Assets/Mirage/Runtime/NetworkServer.cs
+++ b/Assets/Mirage/Runtime/NetworkServer.cs
@@ -248,7 +248,7 @@ void ThrowIfSocketIsMissing()
             if (SocketFactory is null)
                 SocketFactory = GetComponent<SocketFactory>();
             if (SocketFactory == null)
-                throw new InvalidOperationException($"{nameof(SocketFactory)} could not be found for ${nameof(NetworkServer)}");
+                throw new InvalidOperationException($"{nameof(SocketFactory)} could not be found for {nameof(NetworkServer)}");
         }
 
         internal void Update()

From 7c96692b162e6147d4a2ff2b4783cb87eab2b47a Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Sun, 27 Jun 2021 14:38:04 +0000
Subject: [PATCH 019/166] chore(release): 96.5.1 [skip ci]

## [96.5.1](https://github.com/MirageNet/Mirage/compare/v96.5.0...v96.5.1) (2021-06-27)

### Bug Fixes

* fixing typo in error ([6195108](https://github.com/MirageNet/Mirage/commit/6195108dd84d5e83be3ac25d824d50125fa9510f))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs               | 2 +-
 Assets/Mirage/CHANGELOG.md                                 | 7 +++++++
 Assets/Mirage/Components/AssemblyInfo.cs                   | 2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                      | 2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs          | 2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs                     | 2 +-
 .../Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs      | 2 +-
 Assets/Mirage/package.json                                 | 2 +-
 8 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index 57f4023866b..af62c86c298 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("96.5.0")]
+[assembly: AssemblyVersion("96.5.1")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index 85753301da9..9a3819c8788 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,10 @@
+## [96.5.1](https://github.com/MirageNet/Mirage/compare/v96.5.0...v96.5.1) (2021-06-27)
+
+
+### Bug Fixes
+
+* fixing typo in error ([6195108](https://github.com/MirageNet/Mirage/commit/6195108dd84d5e83be3ac25d824d50125fa9510f))
+
 # [96.5.0](https://github.com/MirageNet/Mirage/compare/v96.4.3...v96.5.0) (2021-06-23)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index 958e3d3400b..79e1113a614 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("96.5.0")]
+[assembly: AssemblyVersion("96.5.1")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index 796056fe80f..435e0f2a5f7 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("96.5.0")]
+[assembly: AssemblyVersion("96.5.1")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index 561b8d7a6dc..b2759ef416f 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("96.5.0")]
+[assembly: AssemblyVersion("96.5.1")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index 57f4023866b..af62c86c298 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("96.5.0")]
+[assembly: AssemblyVersion("96.5.1")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index 57f4023866b..af62c86c298 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("96.5.0")]
+[assembly: AssemblyVersion("96.5.1")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index a815c75e8de..23bf12426bb 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "96.5.0",
+    "version": "96.5.1",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From 2fcffddfe1eef2d0d6c89268aa0a88c8817ca239 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Sun, 27 Jun 2021 15:44:59 +0100
Subject: [PATCH 020/166] refactor: making ByteUtils public

---
 Assets/Mirage/Runtime/SocketLayer/ByteUtils.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Assets/Mirage/Runtime/SocketLayer/ByteUtils.cs b/Assets/Mirage/Runtime/SocketLayer/ByteUtils.cs
index 877c4f5a8a6..9070f1d7c7a 100644
--- a/Assets/Mirage/Runtime/SocketLayer/ByteUtils.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/ByteUtils.cs
@@ -1,6 +1,6 @@
 namespace Mirage.SocketLayer
 {
-    internal static class ByteUtils
+    public static class ByteUtils
     {
         public static void WriteByte(byte[] buffer, ref int offset, byte value)
         {

From 063e3b472af003eda400b1fcbbe863f63b3de422 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Sun, 27 Jun 2021 15:52:06 +0100
Subject: [PATCH 021/166] fix: fixing typo in error

---
 Assets/Mirage/Runtime/NetworkClient.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Assets/Mirage/Runtime/NetworkClient.cs b/Assets/Mirage/Runtime/NetworkClient.cs
index 674626eb511..7b0b9371de5 100644
--- a/Assets/Mirage/Runtime/NetworkClient.cs
+++ b/Assets/Mirage/Runtime/NetworkClient.cs
@@ -138,7 +138,7 @@ public void Connect(string address = null, ushort? port = null)
 
         void ThrowIfActive()
         {
-            if (Active) throw new InvalidOperationException("Server is already active");
+            if (Active) throw new InvalidOperationException("Client is already active");
         }
 
         void ThrowIfSocketIsMissing()

From b70bc51e26127c95729a365980be653e535511ea Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Sun, 27 Jun 2021 15:06:50 +0000
Subject: [PATCH 022/166] chore(release): 96.5.2 [skip ci]

## [96.5.2](https://github.com/MirageNet/Mirage/compare/v96.5.1...v96.5.2) (2021-06-27)

### Bug Fixes

* fixing typo in error ([063e3b4](https://github.com/MirageNet/Mirage/commit/063e3b472af003eda400b1fcbbe863f63b3de422))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs               | 2 +-
 Assets/Mirage/CHANGELOG.md                                 | 7 +++++++
 Assets/Mirage/Components/AssemblyInfo.cs                   | 2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                      | 2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs          | 2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs                     | 2 +-
 .../Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs      | 2 +-
 Assets/Mirage/package.json                                 | 2 +-
 8 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index af62c86c298..82b20ca9861 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("96.5.1")]
+[assembly: AssemblyVersion("96.5.2")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index 9a3819c8788..1436698c77e 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,10 @@
+## [96.5.2](https://github.com/MirageNet/Mirage/compare/v96.5.1...v96.5.2) (2021-06-27)
+
+
+### Bug Fixes
+
+* fixing typo in error ([063e3b4](https://github.com/MirageNet/Mirage/commit/063e3b472af003eda400b1fcbbe863f63b3de422))
+
 ## [96.5.1](https://github.com/MirageNet/Mirage/compare/v96.5.0...v96.5.1) (2021-06-27)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index 79e1113a614..d1e947df9ce 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("96.5.1")]
+[assembly: AssemblyVersion("96.5.2")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index 435e0f2a5f7..6850b8d01aa 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("96.5.1")]
+[assembly: AssemblyVersion("96.5.2")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index b2759ef416f..520aa450ee4 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("96.5.1")]
+[assembly: AssemblyVersion("96.5.2")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index af62c86c298..82b20ca9861 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("96.5.1")]
+[assembly: AssemblyVersion("96.5.2")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index af62c86c298..82b20ca9861 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("96.5.1")]
+[assembly: AssemblyVersion("96.5.2")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 23bf12426bb..0002e7e4bb1 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "96.5.1",
+    "version": "96.5.2",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From 1d32c69d6672ad360f7a4749e13c0a37c7278d10 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 27 Jun 2021 17:26:54 +0200
Subject: [PATCH 023/166] chore(deps): bump actions/upload-artifact from 2.2.3
 to 2.2.4 (#842)

Bumps [actions/upload-artifact](https://github.com/actions/upload-artifact) from 2.2.3 to 2.2.4.
- [Release notes](https://github.com/actions/upload-artifact/releases)
- [Commits](https://github.com/actions/upload-artifact/compare/v2.2.3...v2.2.4)

---
updated-dependencies:
- dependency-name: actions/upload-artifact
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/main.yml                    | 2 +-
 .github/workflows/request-activation-file.yml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
index 34a73dcd268..9e9feb18b4d 100644
--- a/.github/workflows/main.yml
+++ b/.github/workflows/main.yml
@@ -54,7 +54,7 @@ jobs:
         timeout-minutes: 20
 
       - name: Archive test results
-        uses: actions/upload-artifact@v2.2.3
+        uses: actions/upload-artifact@v2.2.4
         if: always()
         with:
           name: Test results
diff --git a/.github/workflows/request-activation-file.yml b/.github/workflows/request-activation-file.yml
index fb2d28dc507..c02bfb08c9e 100644
--- a/.github/workflows/request-activation-file.yml
+++ b/.github/workflows/request-activation-file.yml
@@ -13,7 +13,7 @@ jobs:
         run: unity-editor -logFile /dev/stdout -createManualActivationFile -quit 
 
       - name: Upload License Request
-        uses: actions/upload-artifact@v2.2.3
+        uses: actions/upload-artifact@v2.2.4
         with:
             name: Manual Activation File
             path: Unity_v2020.1.17f1.alf

From 6bc5ab8e87c9ec6d2a35a836119a4c891a5a173c Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowen5@gmail.com>
Date: Sun, 27 Jun 2021 17:13:11 +0100
Subject: [PATCH 024/166] refactor: simplifying packet size in config (#852)

MaxPacketSize now sets max message size including headers. and also determine size of SocketLayer buffers

BREAKING CHANGE: BufferSize and MTU replaced by MaxPacketSize
---
 .../Mirage/Runtime/SocketLayer/AckSystem.cs   | 14 +++++++-------
 Assets/Mirage/Runtime/SocketLayer/Config.cs   | 19 +++++++++++--------
 Assets/Mirage/Runtime/SocketLayer/Peer.cs     |  6 +++---
 Assets/Tests/SocketLayer/PeerTest.cs          |  2 +-
 4 files changed, 22 insertions(+), 19 deletions(-)

diff --git a/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs b/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
index b1e9b999cdc..dcf6f5bf8c6 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
@@ -29,7 +29,7 @@ internal class AckSystem
 
         //todo implement this
         readonly int maxPacketsInSendBufferPerConnection;
-        readonly int MTU;
+        readonly int maxPacketSize;
         readonly float ackTimeout;
         /// <summary>how many empty acks to send</summary>
         readonly int emptyAckLimit;
@@ -69,7 +69,7 @@ public AckSystem(IRawConnection connection, Config config, ITime time, BufferPoo
             ackTimeout = config.TimeBeforeEmptyAck;
             emptyAckLimit = config.EmptyAckLimit;
             receivesBeforeEmpty = config.ReceivesBeforeEmptyAck;
-            MTU = config.Mtu;
+            maxPacketSize = config.MaxPacketSize;
             maxPacketsInSendBufferPerConnection = config.MaxReliablePacketsInSendBufferPerConnection;
 
             int size = config.SequenceSize;
@@ -173,9 +173,9 @@ private void SendAck()
         public INotifyToken SendNotify(byte[] inPacket, int inOffset, int inLength)
         {
             // todo batch Notify?
-            if (inLength + HEADER_SIZE_NOTIFY > MTU)
+            if (inLength + HEADER_SIZE_NOTIFY > maxPacketSize)
             {
-                throw new IndexOutOfRangeException($"Message is bigger than MTU, max Notify message size is {MTU - HEADER_SIZE_NOTIFY}");
+                throw new IndexOutOfRangeException($"Message is bigger than MTU, max Notify message size is {maxPacketSize - HEADER_SIZE_NOTIFY}");
             }
             if (sentAckablePackets.IsFull)
             {
@@ -208,9 +208,9 @@ public INotifyToken SendNotify(byte[] inPacket, int inOffset, int inLength)
 
         public void SendReliable(byte[] message, int offset, int length)
         {
-            if (length + HEADER_SIZE_RELIABLE + 2 > MTU)
+            if (length + HEADER_SIZE_RELIABLE + 2 > maxPacketSize)
             {
-                throw new IndexOutOfRangeException($"Message is bigger than MTU, max Reliable message size is {MTU - HEADER_SIZE_RELIABLE - 2}");
+                throw new IndexOutOfRangeException($"Message is bigger than MTU, max Reliable message size is {maxPacketSize - HEADER_SIZE_RELIABLE - 2}");
             }
             if (sentAckablePackets.IsFull)
             {
@@ -225,7 +225,7 @@ public void SendReliable(byte[] message, int offset, int length)
 
             int msgLength = length + 2;
             int batchLength = nextBatch.length;
-            if (batchLength + msgLength > MTU)
+            if (batchLength + msgLength > maxPacketSize)
             {
                 // if full, send and create new
                 SendReliablePacket(nextBatch);
diff --git a/Assets/Mirage/Runtime/SocketLayer/Config.cs b/Assets/Mirage/Runtime/SocketLayer/Config.cs
index 69d06687ecb..fa4dabd7c88 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Config.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Config.cs
@@ -40,20 +40,23 @@ public class Config
         /// </summary>
         public float DisconnectDuration = 1;
 
-        // todo move these settings to socket
         /// <summary>
-        /// Max size of a packet (excluding peer header)
+        /// IP + UDP Header
         /// </summary>
-        public int Mtu => BufferSize - HEADER_SIZE;
+        const int HEADER_SIZE = 20 + 8;
+
         /// <summary>
-        /// Peer+ udp socket size
+        /// MTU is expected to be atleast this number
         /// </summary>
-        const int HEADER_SIZE = 20 + 8;
+        const int MIN_MTU = 1280;
+
         /// <summary>
-        /// Size of buffers, Should be Mtu + header size + header size for socket
-        /// <para>Udp Packet is 1280</para>
+        /// Max size of array that will be sent to or can be received from <see cref="ISocket"/>
+        /// <para>This will also be the size of all buffers used by <see cref="Peer"/></para>
+        /// <para>This is not max message size because this size includes packets header added by <see cref="Peer"/></para>
         /// </summary>
-        public int BufferSize = 1280;
+        // todo move these settings to socket
+        public int MaxPacketSize = MIN_MTU - HEADER_SIZE;
 
         /// <summary>
         /// How many buffers to create at start
diff --git a/Assets/Mirage/Runtime/SocketLayer/Peer.cs b/Assets/Mirage/Runtime/SocketLayer/Peer.cs
index 519e3f5c821..f88f22ace27 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Peer.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Peer.cs
@@ -72,7 +72,7 @@ public Peer(ISocket socket, IDataHandler dataHandler, Config config = null, ILog
             time = new Time();
 
             connectKeyValidator = new ConnectKeyValidator();
-            bufferPool = new BufferPool(this.config.Mtu, this.config.BufferPoolStartSize, this.config.BufferPoolMaxSize, this.logger);
+            bufferPool = new BufferPool(this.config.MaxPacketSize, this.config.BufferPoolStartSize, this.config.BufferPoolMaxSize, this.logger);
 
             Application.quitting += Application_quitting;
         }
@@ -241,8 +241,8 @@ private void ReceiveLoop()
                     int length = socket.Receive(buffer.array, out EndPoint receiveEndPoint);
 
                     // this should never happen. buffer size is only MTU, if socket returns higher length then it has a bug.
-                    if (length > config.Mtu)
-                        throw new IndexOutOfRangeException($"Socket returned length above MTU: MTU:{config.Mtu} length:{length}");
+                    if (length > config.MaxPacketSize)
+                        throw new IndexOutOfRangeException($"Socket returned length above MTU. MaxPacketSize:{config.MaxPacketSize} length:{length}");
 
                     var packet = new Packet(buffer, length);
 
diff --git a/Assets/Tests/SocketLayer/PeerTest.cs b/Assets/Tests/SocketLayer/PeerTest.cs
index 389355fd243..e0a4d0c2c0d 100644
--- a/Assets/Tests/SocketLayer/PeerTest.cs
+++ b/Assets/Tests/SocketLayer/PeerTest.cs
@@ -100,7 +100,7 @@ public void ThrowsIfSocketGivesLengthThatIsTooHigh()
                 peer.Update();
             });
 
-            Assert.That(exception, Has.Message.EqualTo($"Socket returned length above MTU: MTU:{config.Mtu} length:{aboveMTU}"));
+            Assert.That(exception, Has.Message.EqualTo($"Socket returned length above MTU. MaxPacketSize:{config.MaxPacketSize} length:{aboveMTU}"));
         }
 
         [Test]

From e7a5ed4707ddc086fa0aab1e2b9ae4f542c25893 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowen5@gmail.com>
Date: Sun, 27 Jun 2021 17:16:18 +0100
Subject: [PATCH 025/166] refactor: simplifying const values for ack system and
 min packet length (#853)

---
 .../Mirage/Runtime/SocketLayer/AckSystem.cs   | 43 ++++++++++++-------
 Assets/Mirage/Runtime/SocketLayer/Packet.cs   | 19 +++++---
 Assets/Mirage/Runtime/SocketLayer/Peer.cs     |  9 +++-
 .../AckSystem/AckSystemTest_Notify_1stSend.cs |  4 +-
 .../AckSystemTest_Notify_ManySends.cs         |  4 +-
 .../AckSystemTest_Notify_NoDroppedSends.cs    |  6 +--
 6 files changed, 55 insertions(+), 30 deletions(-)

diff --git a/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs b/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
index dcf6f5bf8c6..8f03f2912dc 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
@@ -8,12 +8,25 @@ internal class AckSystem
     {
         const int MASK_SIZE = sizeof(ulong) * 8;
 
-        /// <summary>PacketType, sequence, ack sequannce, mask</summary>
-        public const int HEADER_SIZE_NOTIFY = 5 + sizeof(ulong);
-        /// <summary>PacketType, sequence, ack sequannce, mask, order</summary>
-        public const int HEADER_SIZE_RELIABLE = 5 + sizeof(ulong) + 2;
-        /// <summary>PacketType, ack sequannce, mask</summary>
-        public const int HEADER_SIZE_ACK = 3 + sizeof(ulong);
+        public const int SEQUENCE_HEADER = sizeof(byte) + sizeof(ushort) + sizeof(ushort) + sizeof(ulong);
+
+        /// <summary>PacketType, sequence, ack sequence, mask</summary>
+        public const int NOTIFY_HEADER_SIZE = SEQUENCE_HEADER;
+        /// <summary>PacketType, sequence, ack sequence, mask, order</summary>
+        public const int RELIABLE_HEADER_SIZE = SEQUENCE_HEADER + sizeof(ushort);
+
+
+        /// <summary>PacketType, ack sequence, mask</summary>
+        public const int ACK_HEADER_SIZE = sizeof(byte) + sizeof(ushort) + sizeof(ulong);
+
+        public const int RELIABLE_MESSAGE_LENGTH_SIZE = sizeof(ushort);
+        public const int FRAGMENT_INDEX_SIZE = sizeof(byte);
+
+        /// <summary>Smallest size a header for reliable packet, <see cref="RELIABLE_HEADER_SIZE"/> + 2 bytes per message</summary>
+        public const int MIN_RELIABLE_HEADER_SIZE = RELIABLE_HEADER_SIZE + RELIABLE_MESSAGE_LENGTH_SIZE;
+
+        /// <summary>Smallest size a header for reliable packet, <see cref="RELIABLE_HEADER_SIZE"/> + 1 byte for fragment index</summary>
+        public const int MIN_RELIABLE_FRAGMENT_HEADER_SIZE = RELIABLE_HEADER_SIZE + FRAGMENT_INDEX_SIZE;
 
         readonly RingBuffer<AckablePacket> sentAckablePackets;
         readonly Sequencer reliableOrder;
@@ -173,9 +186,9 @@ private void SendAck()
         public INotifyToken SendNotify(byte[] inPacket, int inOffset, int inLength)
         {
             // todo batch Notify?
-            if (inLength + HEADER_SIZE_NOTIFY > maxPacketSize)
+            if (inLength + NOTIFY_HEADER_SIZE > maxPacketSize)
             {
-                throw new IndexOutOfRangeException($"Message is bigger than MTU, max Notify message size is {maxPacketSize - HEADER_SIZE_NOTIFY}");
+                throw new IndexOutOfRangeException($"Message is bigger than MTU, max Notify message size is {maxPacketSize - NOTIFY_HEADER_SIZE}");
             }
             if (sentAckablePackets.IsFull)
             {
@@ -189,7 +202,7 @@ public INotifyToken SendNotify(byte[] inPacket, int inOffset, int inLength)
             using (ByteBuffer buffer = bufferPool.Take())
             {
                 byte[] outPacket = buffer.array;
-                Buffer.BlockCopy(inPacket, inOffset, outPacket, HEADER_SIZE_NOTIFY, inLength);
+                Buffer.BlockCopy(inPacket, inOffset, outPacket, NOTIFY_HEADER_SIZE, inLength);
 
                 int outOffset = 0;
 
@@ -208,9 +221,9 @@ public INotifyToken SendNotify(byte[] inPacket, int inOffset, int inLength)
 
         public void SendReliable(byte[] message, int offset, int length)
         {
-            if (length + HEADER_SIZE_RELIABLE + 2 > maxPacketSize)
+            if (length + RELIABLE_HEADER_SIZE + 2 > maxPacketSize)
             {
-                throw new IndexOutOfRangeException($"Message is bigger than MTU, max Reliable message size is {maxPacketSize - HEADER_SIZE_RELIABLE - 2}");
+                throw new IndexOutOfRangeException($"Message is bigger than MTU, max Reliable message size is {maxPacketSize - RELIABLE_HEADER_SIZE - 2}");
             }
             if (sentAckablePackets.IsFull)
             {
@@ -248,7 +261,7 @@ private ReliablePacket CreateReliableBuffer(ushort order)
             offset = 13;
             ByteUtils.WriteUShort(final.array, ref offset, order);
 
-            return new ReliablePacket(final, HEADER_SIZE_RELIABLE, order);
+            return new ReliablePacket(final, RELIABLE_HEADER_SIZE, order);
         }
         static void AddToBatch(ReliablePacket packet, byte[] message, int offset, int length)
         {
@@ -301,7 +314,7 @@ public ArraySegment<byte> ReceiveNotify(byte[] packet, int length)
             // duplicate or arrived late
             if (distance <= 0) { return default; }
 
-            var segment = new ArraySegment<byte>(packet, HEADER_SIZE_NOTIFY, length - HEADER_SIZE_NOTIFY);
+            var segment = new ArraySegment<byte>(packet, NOTIFY_HEADER_SIZE, length - NOTIFY_HEADER_SIZE);
             return segment;
         }
 
@@ -339,8 +352,8 @@ public void ReceiveReliable(byte[] packet, int length)
             {
                 // new packet
                 ByteBuffer savedPacket = bufferPool.Take();
-                int bufferLength = length - HEADER_SIZE_RELIABLE;
-                Buffer.BlockCopy(packet, HEADER_SIZE_RELIABLE, savedPacket.array, 0, bufferLength);
+                int bufferLength = length - RELIABLE_HEADER_SIZE;
+                Buffer.BlockCopy(packet, RELIABLE_HEADER_SIZE, savedPacket.array, 0, bufferLength);
                 reliableReceive.InsertAt(reliableSequence, new ReliableReceived(savedPacket, bufferLength));
             }
         }
diff --git a/Assets/Mirage/Runtime/SocketLayer/Packet.cs b/Assets/Mirage/Runtime/SocketLayer/Packet.cs
index 91b4603e122..ebd7a7cc957 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Packet.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Packet.cs
@@ -24,22 +24,27 @@ public bool IsValidSize()
             if (length < MinPacketSize)
                 return false;
 
-
-            const int MinCommandSize = 2;
-            const int MinNotifySize = 1 + 2 + 2 + 4;
             // Min size of message given to Mirage
-            const int MinUnreliableSize = 3;
+            const int MIN_MESSAGE_SIZE = 2;
+
+
+            const int MIN_COMMAND_SIZE = 2;
+            const int MIN_UNRELIABLE_SIZE = 1 + MIN_MESSAGE_SIZE;
 
             switch (type)
             {
                 case PacketType.Command:
-                    return length >= MinCommandSize;
+                    return length >= MIN_COMMAND_SIZE;
 
                 case PacketType.Unreliable:
-                    return length >= MinUnreliableSize;
+                    return length >= MIN_UNRELIABLE_SIZE;
 
                 case PacketType.Notify:
-                    return length >= MinNotifySize;
+                    return length >= AckSystem.NOTIFY_HEADER_SIZE + MIN_MESSAGE_SIZE;
+                case PacketType.Reliable:
+                    return length >= AckSystem.MIN_RELIABLE_HEADER_SIZE + MIN_MESSAGE_SIZE;
+                case PacketType.Ack:
+                    return length >= AckSystem.ACK_HEADER_SIZE;
 
                 default:
                 case PacketType.KeepAlive:
diff --git a/Assets/Mirage/Runtime/SocketLayer/Peer.cs b/Assets/Mirage/Runtime/SocketLayer/Peer.cs
index f88f22ace27..0be1e9665bd 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Peer.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Peer.cs
@@ -266,7 +266,14 @@ private void ReceiveLoop()
         private void HandleMessage(Connection connection, Packet packet)
         {
             // ingore message of invalid size
-            if (!packet.IsValidSize()) { return; }
+            if (!packet.IsValidSize())
+            {
+                if (logger.filterLogType == LogType.Log)
+                {
+                    logger.Log($"Receive from {connection} was too small");
+                }
+                return;
+            }
 
             if (logger.filterLogType == LogType.Log)
             {
diff --git a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_1stSend.cs b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_1stSend.cs
index 4733d335109..a1262c9e6a7 100644
--- a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_1stSend.cs
+++ b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_1stSend.cs
@@ -1,4 +1,4 @@
-using NUnit.Framework;
+using NUnit.Framework;
 
 namespace Mirage.SocketLayer.Tests.AckSystemTests
 {
@@ -71,7 +71,7 @@ public void PacketMaskShouldBe0()
         [Test]
         public void PacketShouldContainMessage()
         {
-            AssertAreSameFromOffsets(message, 0, packet, AckSystem.HEADER_SIZE_NOTIFY, message.Length);
+            AssertAreSameFromOffsets(message, 0, packet, AckSystem.NOTIFY_HEADER_SIZE, message.Length);
         }
     }
 }
diff --git a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_ManySends.cs b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_ManySends.cs
index b221b27fe54..7e73a8c2eb6 100644
--- a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_ManySends.cs
+++ b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_ManySends.cs
@@ -1,4 +1,4 @@
-using System.Collections.Generic;
+using System.Collections.Generic;
 using NUnit.Framework;
 
 namespace Mirage.SocketLayer.Tests.AckSystemTests
@@ -84,7 +84,7 @@ public void PacketShouldContainMessage()
         {
             for (int i = 0; i < messageCount; i++)
             {
-                AssertAreSameFromOffsets(instance.message(i), 0, instance.packet(i), AckSystem.HEADER_SIZE_NOTIFY, instance.message(i).Length);
+                AssertAreSameFromOffsets(instance.message(i), 0, instance.packet(i), AckSystem.NOTIFY_HEADER_SIZE, instance.message(i).Length);
             }
         }
     }
diff --git a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_NoDroppedSends.cs b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_NoDroppedSends.cs
index a467e518cb8..005b06b477a 100644
--- a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_NoDroppedSends.cs
+++ b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_NoDroppedSends.cs
@@ -1,4 +1,4 @@
-using System.Collections.Generic;
+using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
 using UnityEngine;
@@ -156,12 +156,12 @@ public void PacketShouldContainMessage()
         {
             for (int i = 0; i < messageCount; i++)
             {
-                AssertAreSameFromOffsets(instance1.message(i), 0, instance1.packet(i), AckSystem.HEADER_SIZE_NOTIFY, instance1.message(i).Length);
+                AssertAreSameFromOffsets(instance1.message(i), 0, instance1.packet(i), AckSystem.NOTIFY_HEADER_SIZE, instance1.message(i).Length);
             }
 
             for (int i = 0; i < messageCount; i++)
             {
-                AssertAreSameFromOffsets(instance2.message(i), 0, instance2.packet(i), AckSystem.HEADER_SIZE_NOTIFY, instance2.message(i).Length);
+                AssertAreSameFromOffsets(instance2.message(i), 0, instance2.packet(i), AckSystem.NOTIFY_HEADER_SIZE, instance2.message(i).Length);
             }
         }
     }

From 33470def156acd675eeca1bb809bd6a34ac9b7c4 Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Sun, 27 Jun 2021 16:29:41 +0000
Subject: [PATCH 026/166] chore(release): 97.0.0 [skip ci]

# [97.0.0](https://github.com/MirageNet/Mirage/compare/v96.5.2...v97.0.0) (2021-06-27)

### Code Refactoring

* simplifying packet size in config ([#852](https://github.com/MirageNet/Mirage/issues/852)) ([6bc5ab8](https://github.com/MirageNet/Mirage/commit/6bc5ab8e87c9ec6d2a35a836119a4c891a5a173c))

### BREAKING CHANGES

* BufferSize and MTU replaced by MaxPacketSize
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs         |  2 +-
 Assets/Mirage/CHANGELOG.md                           | 12 ++++++++++++
 Assets/Mirage/Components/AssemblyInfo.cs             |  2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                |  2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs    |  2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs               |  2 +-
 .../RigidbodyPhysics/Scripts/AssemblyInfo.cs         |  2 +-
 Assets/Mirage/package.json                           |  2 +-
 8 files changed, 19 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index 82b20ca9861..132a279e86d 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("96.5.2")]
+[assembly: AssemblyVersion("97.0.0")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index 1436698c77e..a6816c0f4c8 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,15 @@
+# [97.0.0](https://github.com/MirageNet/Mirage/compare/v96.5.2...v97.0.0) (2021-06-27)
+
+
+### Code Refactoring
+
+* simplifying packet size in config ([#852](https://github.com/MirageNet/Mirage/issues/852)) ([6bc5ab8](https://github.com/MirageNet/Mirage/commit/6bc5ab8e87c9ec6d2a35a836119a4c891a5a173c))
+
+
+### BREAKING CHANGES
+
+* BufferSize and MTU replaced by MaxPacketSize
+
 ## [96.5.2](https://github.com/MirageNet/Mirage/compare/v96.5.1...v96.5.2) (2021-06-27)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index d1e947df9ce..9d49518343c 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("96.5.2")]
+[assembly: AssemblyVersion("97.0.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index 6850b8d01aa..3d9d10b2f7b 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("96.5.2")]
+[assembly: AssemblyVersion("97.0.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index 520aa450ee4..ed88ea98dd1 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("96.5.2")]
+[assembly: AssemblyVersion("97.0.0")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index 82b20ca9861..132a279e86d 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("96.5.2")]
+[assembly: AssemblyVersion("97.0.0")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index 82b20ca9861..132a279e86d 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("96.5.2")]
+[assembly: AssemblyVersion("97.0.0")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 0002e7e4bb1..d87670da1a3 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "96.5.2",
+    "version": "97.0.0",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From 84b7d2e4cf938763772ebedbb5a55e2db0034ff4 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowen5@gmail.com>
Date: Sun, 27 Jun 2021 19:13:32 +0100
Subject: [PATCH 027/166] fix: fixing first notify not being returned (#854)

---
 .../Mirage/Runtime/SocketLayer/AckSystem.cs   |  4 ++
 .../SocketLayer/AckSystem/AckSystemTest.cs    | 15 ++++++++
 .../AckSystem/AckSystemTest_Notify_1stSend.cs | 15 +++++---
 .../AckSystemTest_Notify_DroppedSends.cs      | 17 +++++----
 .../AckSystemTest_Notify_ManySends.cs         | 10 +++--
 .../AckSystemTest_Notify_NoDroppedSends.cs    | 38 ++++++++++++++++---
 6 files changed, 78 insertions(+), 21 deletions(-)

diff --git a/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs b/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
index 8f03f2912dc..d468cbb1d62 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
@@ -90,6 +90,10 @@ public AckSystem(IRawConnection connection, Config config, ITime time, BufferPoo
             reliableOrder = new Sequencer(size);
             reliableReceive = new RingBuffer<ReliableReceived>(size);
 
+            // set lastest to value before 0 so that first packet will be received
+            // max will be 1 less than 0
+            LatestAckSequence = (ushort)sentAckablePackets.Sequencer.MoveInBounds(ulong.MaxValue);
+
             OnSend();
         }
 
diff --git a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest.cs b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest.cs
index 25ec69f9b92..0065497dea9 100644
--- a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest.cs
+++ b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest.cs
@@ -1,3 +1,4 @@
+using System;
 using System.Collections.Generic;
 using NUnit.Framework;
 
@@ -49,6 +50,20 @@ protected static void AssertAreSameFromOffsets(byte[] expected, int expectedOffs
                 }
             }
         }
+
+        protected static void AssertAreSameFromOffsets(byte[] expected, int expectedOffset, int length, ArraySegment<byte> segment)
+        {
+            if (segment == default)
+            {
+                Assert.Fail($"Segment should not be default");
+            }
+            if (segment.Count != length)
+            {
+                Assert.Fail($"Segment did not have same length as expected\n  expected {length}\n  actual {segment.Count}");
+            }
+
+            AssertAreSameFromOffsets(expected, expectedOffset, segment.Array, segment.Offset, length);
+        }
     }
 
     // NSubstitute doesn't work for this type because interface is internal
diff --git a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_1stSend.cs b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_1stSend.cs
index a1262c9e6a7..26f0c1f7fb1 100644
--- a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_1stSend.cs
+++ b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_1stSend.cs
@@ -20,11 +20,16 @@ public class AckSystemTest_Notify_1stSend : AckSystemTestBase
         /// </summary>
         byte[] packet;
 
+        ushort maxSequence;
+
         [SetUp]
         public void SetUp()
         {
+            var config = new Config();
+            maxSequence = (ushort)((1 << config.SequenceSize) - 1);
+
             connection = new SubIRawConnection();
-            ackSystem = new AckSystem(connection, new Config(), new Time(), bufferPool);
+            ackSystem = new AckSystem(connection, config, new Time(), bufferPool);
 
             message = createRandomData(1);
             ackSystem.SendNotify(message);
@@ -46,7 +51,7 @@ public void PacketShouldBeNotify()
         }
 
         [Test]
-        public void PacketSequenceShouldBe1()
+        public void SentSequenceShouldBe1()
         {
             int offset = 1;
             ushort sequance = ByteUtils.ReadUShort(packet, ref offset);
@@ -54,14 +59,14 @@ public void PacketSequenceShouldBe1()
         }
 
         [Test]
-        public void PacketReceivedShouldBe0()
+        public void LatestReceivedShouldBeMax()
         {
             int offset = 3;
             ushort received = ByteUtils.ReadUShort(packet, ref offset);
-            Assert.That(received, Is.EqualTo(0));
+            Assert.That(received, Is.EqualTo(maxSequence));
         }
         [Test]
-        public void PacketMaskShouldBe0()
+        public void ReceivedMaskShouldBe0()
         {
             int offset = 5;
             ushort mask = ByteUtils.ReadUShort(packet, ref offset);
diff --git a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_DroppedSends.cs b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_DroppedSends.cs
index a469b02973a..04113763a1f 100644
--- a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_DroppedSends.cs
+++ b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_DroppedSends.cs
@@ -1,4 +1,4 @@
-using System.Collections.Generic;
+using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
 
@@ -11,7 +11,7 @@ namespace Mirage.SocketLayer.Tests.AckSystemTests
     public class AckSystemTest_Notify_DroppedSends : AckSystemTestBase
     {
         const int messageCount = 5;
-
+        private ushort maxSequence;
         AckTestInstance instance1;
         AckTestInstance instance2;
 
@@ -34,14 +34,17 @@ public class AckSystemTest_Notify_DroppedSends : AckSystemTestBase
         [SetUp]
         public void SetUp()
         {
+            var config = new Config();
+            maxSequence = (ushort)((1 << config.SequenceSize) - 1);
+
             instance1 = new AckTestInstance();
             instance1.connection = new SubIRawConnection();
-            instance1.ackSystem = new AckSystem(instance1.connection, new Config(), new Time(), bufferPool);
+            instance1.ackSystem = new AckSystem(instance1.connection, config, new Time(), bufferPool);
 
 
             instance2 = new AckTestInstance();
             instance2.connection = new SubIRawConnection();
-            instance2.ackSystem = new AckSystem(instance2.connection, new Config(), new Time(), bufferPool);
+            instance2.ackSystem = new AckSystem(instance2.connection, config, new Time(), bufferPool);
 
             // create and send n messages
             instance1.messages = new List<byte[]>();
@@ -80,19 +83,19 @@ public void SetUp()
         [Test]
         public void ReceivedShouldBeEqualToLatest()
         {
-            ushort nextReceive = 0;
+            ushort nextReceive = maxSequence;
             for (int i = 0; i < messageCount; i++)
             {
                 int offset = 3;
                 ushort received = ByteUtils.ReadUShort(instance1.packet(i), ref offset);
-                Assert.That(received, Is.EqualTo(nextReceive), "Received should start at 0 and increment each time");
+                Assert.That(received, Is.EqualTo(nextReceive), "Received should start at max and increment each time");
 
                 // do at end becuase 1 is sending first
                 if (received1[i])
                     nextReceive = (ushort)(i);
             }
 
-            nextReceive = 0;
+            nextReceive = maxSequence;
             for (int i = 0; i < messageCount; i++)
             {
                 // do at start becuase 2 is sending second
diff --git a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_ManySends.cs b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_ManySends.cs
index 7e73a8c2eb6..6ee31dd67ad 100644
--- a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_ManySends.cs
+++ b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_ManySends.cs
@@ -12,10 +12,14 @@ public class AckSystemTest_Notify_ManySends : AckSystemTestBase
         const int messageCount = 5;
 
         AckTestInstance instance;
+        ushort maxSequence;
 
         [SetUp]
         public void SetUp()
         {
+            var config = new Config();
+            maxSequence = (ushort)((1 << config.SequenceSize) - 1);
+
             instance = new AckTestInstance();
             instance.connection = new SubIRawConnection();
             instance.ackSystem = new AckSystem(instance.connection, new Config(), new Time(), bufferPool);
@@ -37,7 +41,7 @@ public void SetUp()
         }
 
         [Test]
-        public void AllPacketShouldBeNotify()
+        public void PacketsShouldBeNotify()
         {
             for (int i = 0; i < messageCount; i++)
             {
@@ -59,13 +63,13 @@ public void PacketSequenceShouldIncrement()
         }
 
         [Test]
-        public void PacketReceivedShouldBe0()
+        public void PacketReceivedShouldBeMax()
         {
             for (int i = 0; i < messageCount; i++)
             {
                 int offset = 3;
                 ushort received = ByteUtils.ReadUShort(instance.packet(i), ref offset);
-                Assert.That(received, Is.EqualTo(0), "Received should stay 0");
+                Assert.That(received, Is.EqualTo(maxSequence), $"Received should stay max, index:{i}");
             }
         }
         [Test]
diff --git a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_NoDroppedSends.cs b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_NoDroppedSends.cs
index 005b06b477a..6c42afe5a67 100644
--- a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_NoDroppedSends.cs
+++ b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Notify_NoDroppedSends.cs
@@ -1,7 +1,7 @@
+using System;
 using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
-using UnityEngine;
 
 namespace Mirage.SocketLayer.Tests.AckSystemTests
 {
@@ -12,22 +12,30 @@ namespace Mirage.SocketLayer.Tests.AckSystemTests
     public class AckSystemTest_Notify_NoDroppedSends : AckSystemTestBase
     {
         const int messageCount = 5;
+        private ushort maxSequence;
 
         AckTestInstance instance1;
         AckTestInstance instance2;
 
+        List<ArraySegment<byte>> received1;
+        List<ArraySegment<byte>> received2;
 
         [SetUp]
         public void SetUp()
         {
+            var config = new Config();
+            maxSequence = (ushort)((1 << config.SequenceSize) - 1);
+
             instance1 = new AckTestInstance();
             instance1.connection = new SubIRawConnection();
-            instance1.ackSystem = new AckSystem(instance1.connection, new Config(), new Time(), bufferPool);
+            instance1.ackSystem = new AckSystem(instance1.connection, config, new Time(), bufferPool);
+            received1 = new List<ArraySegment<byte>>();
 
 
             instance2 = new AckTestInstance();
             instance2.connection = new SubIRawConnection();
-            instance2.ackSystem = new AckSystem(instance2.connection, new Config(), new Time(), bufferPool);
+            instance2.ackSystem = new AckSystem(instance2.connection, config, new Time(), bufferPool);
+            received2 = new List<ArraySegment<byte>>();
 
             // create and send n messages
             instance1.messages = new List<byte[]>();
@@ -42,12 +50,14 @@ public void SetUp()
                 // send to conn1
                 instance1.ackSystem.SendNotify(instance1.messages[i]);
                 // give to instance2 from conn1
-                instance2.ackSystem.ReceiveNotify(instance1.connection.packets[i], instance1.connection.packets[i].Length);
+                ArraySegment<byte> segment2 = instance2.ackSystem.ReceiveNotify(instance1.connection.packets[i], instance1.connection.packets[i].Length);
+                received2.Add(segment2);
 
                 // send to conn2
                 instance2.ackSystem.SendNotify(instance2.messages[i]);
                 // give to instance1 from conn2
-                instance1.ackSystem.ReceiveNotify(instance2.connection.packets[i], instance2.connection.packets[i].Length);
+                ArraySegment<byte> segment1 = instance1.ackSystem.ReceiveNotify(instance2.connection.packets[i], instance2.connection.packets[i].Length);
+                received1.Add(segment1);
             }
 
             // should have got 1 packet
@@ -103,7 +113,9 @@ public void ReceivedShouldBeEqualToLatest()
             {
                 int offset = 3;
                 ushort received = ByteUtils.ReadUShort(instance1.packet(i), ref offset);
-                Assert.That(received, Is.EqualTo(Mathf.Clamp(i - 1, 0, messageCount)), "Received should start at 0 and increment each time");
+                int expected = i - 1;
+                if (expected == -1) expected = maxSequence;
+                Assert.That(received, Is.EqualTo(expected), "Received should start at 0 and increment each time");
             }
 
             for (int i = 0; i < messageCount; i++)
@@ -164,5 +176,19 @@ public void PacketShouldContainMessage()
                 AssertAreSameFromOffsets(instance2.message(i), 0, instance2.packet(i), AckSystem.NOTIFY_HEADER_SIZE, instance2.message(i).Length);
             }
         }
+
+        [Test]
+        public void AllSegmentsShouldHaveBeenReturned()
+        {
+            for (int i = 0; i < messageCount; i++)
+            {
+                AssertAreSameFromOffsets(instance1.message(i), 0, instance1.message(i).Length, received2[i]);
+            }
+
+            for (int i = 0; i < messageCount; i++)
+            {
+                AssertAreSameFromOffsets(instance2.message(i), 0, instance2.message(i).Length, received1[i]);
+            }
+        }
     }
 }

From b36de558264b06158d57032808428b6a3c6d412f Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Sun, 27 Jun 2021 18:26:43 +0000
Subject: [PATCH 028/166] chore(release): 97.0.1 [skip ci]

## [97.0.1](https://github.com/MirageNet/Mirage/compare/v97.0.0...v97.0.1) (2021-06-27)

### Bug Fixes

* fixing first notify not being returned ([#854](https://github.com/MirageNet/Mirage/issues/854)) ([84b7d2e](https://github.com/MirageNet/Mirage/commit/84b7d2e4cf938763772ebedbb5a55e2db0034ff4))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs               | 2 +-
 Assets/Mirage/CHANGELOG.md                                 | 7 +++++++
 Assets/Mirage/Components/AssemblyInfo.cs                   | 2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                      | 2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs          | 2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs                     | 2 +-
 .../Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs      | 2 +-
 Assets/Mirage/package.json                                 | 2 +-
 8 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index 132a279e86d..a93b68da018 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("97.0.0")]
+[assembly: AssemblyVersion("97.0.1")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index a6816c0f4c8..e1566d5618d 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,10 @@
+## [97.0.1](https://github.com/MirageNet/Mirage/compare/v97.0.0...v97.0.1) (2021-06-27)
+
+
+### Bug Fixes
+
+* fixing first notify not being returned ([#854](https://github.com/MirageNet/Mirage/issues/854)) ([84b7d2e](https://github.com/MirageNet/Mirage/commit/84b7d2e4cf938763772ebedbb5a55e2db0034ff4))
+
 # [97.0.0](https://github.com/MirageNet/Mirage/compare/v96.5.2...v97.0.0) (2021-06-27)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index 9d49518343c..b4fbc086184 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("97.0.0")]
+[assembly: AssemblyVersion("97.0.1")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index 3d9d10b2f7b..506a1d87156 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("97.0.0")]
+[assembly: AssemblyVersion("97.0.1")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index ed88ea98dd1..c3d7f9831e8 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("97.0.0")]
+[assembly: AssemblyVersion("97.0.1")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index 132a279e86d..a93b68da018 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("97.0.0")]
+[assembly: AssemblyVersion("97.0.1")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index 132a279e86d..a93b68da018 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("97.0.0")]
+[assembly: AssemblyVersion("97.0.1")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index d87670da1a3..a38d00d8059 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "97.0.0",
+    "version": "97.0.1",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From 4764294b18a6e20780fe05626bd001f8c63790f8 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowen5@gmail.com>
Date: Sun, 27 Jun 2021 19:45:23 +0100
Subject: [PATCH 029/166] feat(SocketLayer): adding fragmentation to reliable
 sending (#851)

---
 Assets/Mirage/Runtime/ClientStoppedReason.cs  |   3 +
 .../Mirage/Runtime/SocketLayer/AckSystem.cs   | 181 +++++++++++---
 Assets/Mirage/Runtime/SocketLayer/Config.cs   |   6 +
 .../Mirage/Runtime/SocketLayer/Connection.cs  |  69 +++++-
 .../SocketLayer/Enums/DisconnectReason.cs     |   5 +
 .../Runtime/SocketLayer/Enums/PacketType.cs   |   5 +
 Assets/Mirage/Runtime/SocketLayer/Packet.cs   |   2 +
 Assets/Mirage/Runtime/SocketLayer/Peer.cs     |   5 +-
 .../Mirage/Runtime/SocketLayer/RingBuffer.cs  |  59 ++++-
 Assets/Tests/Common/TestSocketFactory.cs      |  14 +-
 .../NetworkClientDisconnectTest.cs            |  51 ++++
 .../SocketLayer/AckSystem/AckSystemTest.cs    |   4 +-
 .../AckSystemTest_Fragmentation_Receive.cs    | 100 ++++++++
 ...ckSystemTest_Fragmentation_Receive.cs.meta |  11 +
 .../AckSystemTest_Fragmentation_Send.cs       |  96 ++++++++
 .../AckSystemTest_Fragmentation_Send.cs.meta  |  11 +
 .../AckSystem/AckSystemTest_Reliable.cs       |   7 +-
 Assets/Tests/SocketLayer/PeerTestBase.cs      |   2 +-
 .../Tests/SocketLayer/PeerTestSendReceive.cs  | 225 ++++++++++++++++--
 19 files changed, 789 insertions(+), 67 deletions(-)
 create mode 100644 Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Fragmentation_Receive.cs
 create mode 100644 Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Fragmentation_Receive.cs.meta
 create mode 100644 Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Fragmentation_Send.cs
 create mode 100644 Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Fragmentation_Send.cs.meta

diff --git a/Assets/Mirage/Runtime/ClientStoppedReason.cs b/Assets/Mirage/Runtime/ClientStoppedReason.cs
index bb6d5d07035..89e02f69883 100644
--- a/Assets/Mirage/Runtime/ClientStoppedReason.cs
+++ b/Assets/Mirage/Runtime/ClientStoppedReason.cs
@@ -24,6 +24,8 @@ public enum ClientStoppedReason
         LocalConnectionClosed = 2,
         /// <summary>Connection disconnect called on server</summary>
         RemoteConnectionClosed = 3,
+        /// <summary>Server disconnected because sent packet was not allowed by server config</summary>
+        InvalidPacket = 8,
 
         /// <summary>Server rejected connecting because it was full</summary>
         ServerFull = 4,
@@ -48,6 +50,7 @@ public static ClientStoppedReason ToClientStoppedReason(this DisconnectReason re
                 case DisconnectReason.Timeout: return ClientStoppedReason.Timeout;
                 case DisconnectReason.RequestedByRemotePeer: return ClientStoppedReason.RemoteConnectionClosed;
                 case DisconnectReason.RequestedByLocalPeer: return ClientStoppedReason.LocalConnectionClosed;
+                case DisconnectReason.InvalidPacket: return ClientStoppedReason.InvalidPacket;
             }
         }
 
diff --git a/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs b/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
index d468cbb1d62..addb70a81f2 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
@@ -1,6 +1,7 @@
 using System;
 using System.Collections.Generic;
 using System.Runtime.CompilerServices;
+using UnityEngine;
 
 namespace Mirage.SocketLayer
 {
@@ -48,6 +49,12 @@ internal class AckSystem
         readonly int emptyAckLimit;
         readonly int receivesBeforeEmpty;
 
+        readonly bool allowFragmented;
+        readonly int maxFragments;
+        readonly int maxFragmentsMessageSize;
+
+        public readonly int SizePerFragment;
+
         /// <summary>
         /// most recent sequence received
         /// <para>will be sent with next message</para>
@@ -85,6 +92,11 @@ public AckSystem(IRawConnection connection, Config config, ITime time, BufferPoo
             maxPacketSize = config.MaxPacketSize;
             maxPacketsInSendBufferPerConnection = config.MaxReliablePacketsInSendBufferPerConnection;
 
+            maxFragments = config.MaxReliableFragments;
+            allowFragmented = maxFragments >= 0;
+            SizePerFragment = maxPacketSize - MIN_RELIABLE_FRAGMENT_HEADER_SIZE;
+            maxFragmentsMessageSize = maxFragments * SizePerFragment;
+
             int size = config.SequenceSize;
             sentAckablePackets = new RingBuffer<AckablePacket>(size);
             reliableOrder = new Sequencer(size);
@@ -102,10 +114,47 @@ public AckSystem(IRawConnection connection, Config config, ITime time, BufferPoo
         /// <para>[length, message, length, message, ...]</para>
         /// </summary>
         /// <param name="packet"></param>
-        /// <returns>true if next packet is avaliable</returns>
+        /// <returns>true if next packet is available</returns>
         public bool NextReliablePacket(out ReliableReceived packet)
         {
-            return reliableReceive.TryDequeue(out packet);
+            if (!reliableReceive.TryPeak(out packet))
+                return false;
+
+
+            // normal packet (with batched messages) OR full fragmented message
+            if (!packet.isFragment || CheckFullFragmentedMessage(packet, reliableReceive.Read))
+            {
+                reliableReceive.RemoveNext();
+                return true;
+            }
+
+            return false;
+        }
+
+        private bool CheckFullFragmentedMessage(ReliableReceived packet, uint readIndex)
+        {
+            // fragment will always be first byte of message
+            uint fragmentIndex = packet.buffer.array[0];
+
+            // if fragment Index is 3 we expect 4 packets total (3 more)
+            // so we check 0,1,2 packets in
+            bool fullMessage = true;
+            for (uint i = 0; i < fragmentIndex; i++)
+            {
+                // check if other packets after current exist
+                if (!reliableReceive.Exists(readIndex + i + 1))
+                {
+                    fullMessage = false;
+                    break;
+                }
+            }
+
+            return fullMessage;
+        }
+
+        public ReliableReceived GetNextFragment()
+        {
+            return reliableReceive.Dequeue();
         }
 
         public void Update()
@@ -124,7 +173,6 @@ public void Update()
                 // send ack
                 SendAck();
             }
-
         }
 
         /// <summary>
@@ -222,51 +270,98 @@ public INotifyToken SendNotify(byte[] inPacket, int inOffset, int inLength)
             return token;
         }
 
-
         public void SendReliable(byte[] message, int offset, int length)
         {
-            if (length + RELIABLE_HEADER_SIZE + 2 > maxPacketSize)
-            {
-                throw new IndexOutOfRangeException($"Message is bigger than MTU, max Reliable message size is {maxPacketSize - RELIABLE_HEADER_SIZE - 2}");
-            }
             if (sentAckablePackets.IsFull)
             {
                 throw new InvalidOperationException("Sent queue is full");
             }
 
+
+            if (length + MIN_RELIABLE_HEADER_SIZE > maxPacketSize)
+            {
+                if (allowFragmented)
+                {
+                    SendFragmented(message, offset, length);
+                    return;
+                }
+                else
+                {
+                    throw new ArgumentException($"Message is bigger than MTU and fragmentation is disabled, max Reliable message size is {maxPacketSize - MIN_RELIABLE_HEADER_SIZE}", nameof(length));
+                }
+            }
+
+
             if (nextBatch == null)
             {
-                ushort order = (ushort)reliableOrder.Next();
-                nextBatch = CreateReliableBuffer(order);
+                nextBatch = CreateReliableBuffer(PacketType.Reliable);
             }
 
-            int msgLength = length + 2;
+            int msgLength = length + RELIABLE_MESSAGE_LENGTH_SIZE;
             int batchLength = nextBatch.length;
             if (batchLength + msgLength > maxPacketSize)
             {
                 // if full, send and create new
                 SendReliablePacket(nextBatch);
 
-                ushort order = (ushort)reliableOrder.Next();
-                nextBatch = CreateReliableBuffer(order);
+                nextBatch = CreateReliableBuffer(PacketType.Reliable);
             }
 
             AddToBatch(nextBatch, message, offset, length);
         }
 
-        private ReliablePacket CreateReliableBuffer(ushort order)
+        /// <summary>
+        /// Splits messsage into multiple packets
+        /// <para>Note: this might just send 1 packet if length is equal to size.
+        /// This might happen because fragmented header is 1 less that batched header</para>
+        /// </summary>
+        /// <param name="message"></param>
+        /// <param name="offset"></param>
+        /// <param name="length"></param>
+        private void SendFragmented(byte[] message, int offset, int length)
         {
+            if (length > maxFragmentsMessageSize)
+            {
+                throw new ArgumentException($"Message is bigger than MTU for fragmentation, max Reliable fragmented size is {maxFragmentsMessageSize}", nameof(length));
+            }
+
+            int fragments = Mathf.CeilToInt(length / (float)SizePerFragment);
+
+            int remaining = length;
+            for (int i = 0; i < fragments; i++)
+            {
+                int fragmentIndex = fragments - i - 1;
+
+                ReliablePacket packet = CreateReliableBuffer(PacketType.ReliableFragment);
+                byte[] array = packet.buffer.array;
+                int packetOffset = packet.length;
+
+                ByteUtils.WriteByte(array, ref packetOffset, (byte)fragmentIndex);
+                int nextLength = Math.Min(remaining, SizePerFragment);
+                Buffer.BlockCopy(message, offset + SizePerFragment * i, array, packetOffset, nextLength);
+                packetOffset += nextLength;
+                remaining -= nextLength;
+
+                packet.length = packetOffset;
+                SendReliablePacket(packet);
+            }
+        }
+
+        private ReliablePacket CreateReliableBuffer(PacketType packetType)
+        {
+            ushort order = (ushort)reliableOrder.Next();
 
             ByteBuffer final = bufferPool.Take();
 
             int offset = 0;
-            ByteUtils.WriteByte(final.array, ref offset, (byte)PacketType.Reliable);
+            ByteUtils.WriteByte(final.array, ref offset, (byte)packetType);
 
-            offset = 13;
+            offset = SEQUENCE_HEADER;
             ByteUtils.WriteUShort(final.array, ref offset, order);
 
             return new ReliablePacket(final, RELIABLE_HEADER_SIZE, order);
         }
+
         static void AddToBatch(ReliablePacket packet, byte[] message, int offset, int length)
         {
             byte[] array = packet.buffer.array;
@@ -323,11 +418,25 @@ public ArraySegment<byte> ReceiveNotify(byte[] packet, int length)
         }
 
 
+        /// <summary>
+        /// Checks if fragment index is less than max fragment size
+        /// </summary>
+        /// <param name="array"></param>
+        /// <returns></returns>
+        public bool InvalidFragment(byte[] array)
+        {
+            int offset = RELIABLE_HEADER_SIZE;
+            byte fragmentIndex = ByteUtils.ReadByte(array, ref offset);
+
+            // invalid if equal to (because it should be 0 indexed)
+            return fragmentIndex >= maxFragments;
+        }
+
         /// <summary>
         /// </summary>
         /// <param name="packet"></param>
         /// <returns>true if there are ordered message to read</returns>
-        public void ReceiveReliable(byte[] packet, int length)
+        public void ReceiveReliable(byte[] packet, int length, bool isFragment)
         {
             // start at 1 to skip packet type
             int offset = 1;
@@ -340,7 +449,7 @@ public void ReceiveReliable(byte[] packet, int length)
             _ = ProcessIncomingHeader(sequence, ackSequence, ackMask);
 
             // checks acks, late message are allowed for reliable
-            // but only update lastest if later than current
+            // but only insert lastest if later than read Index
 
             long reliableDistance = reliableReceive.DistanceToRead(reliableSequence);
 
@@ -351,17 +460,24 @@ public void ReceiveReliable(byte[] packet, int length)
             }
 
 
-            ReliableReceived existing = reliableReceive[reliableSequence];
-            if (existing.buffer == null)
+            if (PacketExists(reliableSequence))
             {
-                // new packet
-                ByteBuffer savedPacket = bufferPool.Take();
-                int bufferLength = length - RELIABLE_HEADER_SIZE;
-                Buffer.BlockCopy(packet, RELIABLE_HEADER_SIZE, savedPacket.array, 0, bufferLength);
-                reliableReceive.InsertAt(reliableSequence, new ReliableReceived(savedPacket, bufferLength));
+                // packet already received 
+                return;
             }
+
+            // new packet
+            ByteBuffer savedPacket = bufferPool.Take();
+            int bufferLength = length - RELIABLE_HEADER_SIZE;
+            Buffer.BlockCopy(packet, RELIABLE_HEADER_SIZE, savedPacket.array, 0, bufferLength);
+            reliableReceive.InsertAt(reliableSequence, new ReliableReceived(savedPacket, bufferLength, isFragment));
         }
 
+        bool PacketExists(ushort reliableSequence)
+        {
+            ReliableReceived existing = reliableReceive[reliableSequence];
+            return existing.buffer != null;
+        }
 
         public void ReceiveAck(byte[] packet)
         {
@@ -406,13 +522,13 @@ private void SetAckValues(ushort sequence, long distance)
             }
             else
             {
-                int negativeDistnace = -(int)distance;
+                int negativeDistance = -(int)distance;
 
                 // distance is too large to be shifted
-                if (negativeDistnace >= MASK_SIZE)
+                if (negativeDistance >= MASK_SIZE)
                     return;
 
-                ulong newAck = 1ul << negativeDistnace;
+                ulong newAck = 1ul << negativeDistance;
                 AckMask |= newAck;
             }
 
@@ -606,11 +722,18 @@ public struct ReliableReceived
         {
             public readonly ByteBuffer buffer;
             public readonly int length;
+            public readonly bool isFragment;
+            public int FragmentIndex
+            {
+                [MethodImpl(MethodImplOptions.AggressiveInlining)]
+                get => buffer.array[0];
+            }
 
-            public ReliableReceived(ByteBuffer buffer, int length)
+            public ReliableReceived(ByteBuffer buffer, int length, bool isFragment)
             {
                 this.buffer = buffer;
                 this.length = length;
+                this.isFragment = isFragment;
             }
         }
     }
diff --git a/Assets/Mirage/Runtime/SocketLayer/Config.cs b/Assets/Mirage/Runtime/SocketLayer/Config.cs
index fa4dabd7c88..662b8627c4b 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Config.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Config.cs
@@ -100,6 +100,12 @@ public class Config
         /// <para>Max of 16</para>
         /// </summary>
         public int SequenceSize = 12;
+
+        /// <summary>
+        /// How many fragments large reliable message can be split into
+        /// <para>if set to 0 then messages over <see cref="MaxPacketSize"/> will not be allowed to be sent</para>
+        /// </summary>
+        public int MaxReliableFragments = 5;
         #endregion
     }
 }
diff --git a/Assets/Mirage/Runtime/SocketLayer/Connection.cs b/Assets/Mirage/Runtime/SocketLayer/Connection.cs
index 0cd1986a462..db1ae325b45 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Connection.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Connection.cs
@@ -210,7 +210,6 @@ public void SendReliable(byte[] packet)
         public void SendReliable(ArraySegment<byte> packet)
         {
             SendReliable(packet.Array, packet.Offset, packet.Count);
-
         }
 
 
@@ -254,18 +253,78 @@ internal void ReceiveUnreliablePacket(Packet packet)
             dataHandler.ReceiveMessage(this, segment);
         }
 
-        internal void ReceivReliablePacket(Packet packet)
+        internal void ReceiveReliablePacket(Packet packet)
         {
-            ackSystem.ReceiveReliable(packet.buffer.array, packet.length);
+            ackSystem.ReceiveReliable(packet.buffer.array, packet.length, false);
+
+            HandleQueuedMessages();
+        }
+
+        internal void ReceiveReliableFragment(Packet packet)
+        {
+            if (ackSystem.InvalidFragment(packet.buffer.array))
+            {
+                Disconnect(DisconnectReason.InvalidPacket);
+                return;
+            }
 
+            ackSystem.ReceiveReliable(packet.buffer.array, packet.length, true);
+
+            HandleQueuedMessages();
+        }
+
+        void HandleQueuedMessages()
+        {
             // gets messages in order
             while (ackSystem.NextReliablePacket(out AckSystem.ReliableReceived received))
             {
-                HandleAllMessageInPacket(received);
+                if (received.isFragment)
+                {
+                    HandleFragmentedMessage(received);
+                }
+                else
+                {
+                    HandleBatchedMessageInPacket(received);
+                }
+            }
+        }
+
+        private void HandleFragmentedMessage(AckSystem.ReliableReceived received)
+        {
+            // get index from first
+            byte[] firstArray = received.buffer.array;
+            // length +1 because zero indexed 
+            int fragmentLength = firstArray[0] + 1;
+
+            // todo find way to remove allocation? (can't use buffers because they will be too small for this bigger message)
+            byte[] message = new byte[fragmentLength * ackSystem.SizePerFragment];
+
+            // copy first
+            int copyLength = received.length - 1;
+            Assert(copyLength == ackSystem.SizePerFragment, "First should be max size");
+            Buffer.BlockCopy(firstArray, 1, message, 0, copyLength);
+            received.buffer.Release();
+
+            int messageLength = copyLength;
+            // start at 1 because first copied above
+            for (int i = 1; i < fragmentLength; i++)
+            {
+                AckSystem.ReliableReceived next = ackSystem.GetNextFragment();
+                byte[] nextArray = next.buffer.array;
+
+                Assert(i == (fragmentLength - 1 - nextArray[0]), "fragment index should decrement each time");
+
+                // +1 because first is copied above
+                copyLength = next.length - 1;
+                Buffer.BlockCopy(nextArray, 1, message, ackSystem.SizePerFragment * i, copyLength);
+                messageLength += copyLength;
+                next.buffer.Release();
             }
+
+            dataHandler.ReceiveMessage(this, new ArraySegment<byte>(message, 0, messageLength));
         }
 
-        private void HandleAllMessageInPacket(AckSystem.ReliableReceived received)
+        private void HandleBatchedMessageInPacket(AckSystem.ReliableReceived received)
         {
             byte[] array = received.buffer.array;
             int packetLength = received.length;
diff --git a/Assets/Mirage/Runtime/SocketLayer/Enums/DisconnectReason.cs b/Assets/Mirage/Runtime/SocketLayer/Enums/DisconnectReason.cs
index 373da7a3179..b3fd667b6af 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Enums/DisconnectReason.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Enums/DisconnectReason.cs
@@ -24,5 +24,10 @@ public enum DisconnectReason
         /// Disconnect called by higher level
         /// </summary>
         RequestedByLocalPeer = 3,
+
+        /// <summary>
+        /// Received packet was not allowed by config
+        /// </summary>
+        InvalidPacket = 4,
     }
 }
diff --git a/Assets/Mirage/Runtime/SocketLayer/Enums/PacketType.cs b/Assets/Mirage/Runtime/SocketLayer/Enums/PacketType.cs
index b2b103f1259..8408170b5f0 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Enums/PacketType.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Enums/PacketType.cs
@@ -23,6 +23,11 @@ public enum PacketType
         /// </summary>
         Reliable = 4,
 
+        /// <summary>
+        /// packet with just acks
+        /// </summary>
+        ReliableFragment = 6,
+
         /// <summary>
         /// packet with just acks
         /// </summary>
diff --git a/Assets/Mirage/Runtime/SocketLayer/Packet.cs b/Assets/Mirage/Runtime/SocketLayer/Packet.cs
index ebd7a7cc957..db921d22c1b 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Packet.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Packet.cs
@@ -43,6 +43,8 @@ public bool IsValidSize()
                     return length >= AckSystem.NOTIFY_HEADER_SIZE + MIN_MESSAGE_SIZE;
                 case PacketType.Reliable:
                     return length >= AckSystem.MIN_RELIABLE_HEADER_SIZE + MIN_MESSAGE_SIZE;
+                case PacketType.ReliableFragment:
+                    return length >= AckSystem.MIN_RELIABLE_FRAGMENT_HEADER_SIZE + 1;
                 case PacketType.Ack:
                     return length >= AckSystem.ACK_HEADER_SIZE;
 
diff --git a/Assets/Mirage/Runtime/SocketLayer/Peer.cs b/Assets/Mirage/Runtime/SocketLayer/Peer.cs
index 0be1e9665bd..c4284e3920a 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Peer.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Peer.cs
@@ -315,11 +315,14 @@ private void HandleMessage(Connection connection, Packet packet)
                     connection.ReceiveNotifyPacket(packet);
                     break;
                 case PacketType.Reliable:
-                    connection.ReceivReliablePacket(packet);
+                    connection.ReceiveReliablePacket(packet);
                     break;
                 case PacketType.Ack:
                     connection.ReceiveNotifyAck(packet);
                     break;
+                case PacketType.ReliableFragment:
+                    connection.ReceiveReliableFragment(packet);
+                    break;
                 case PacketType.KeepAlive:
                     // do nothing
                     break;
diff --git a/Assets/Mirage/Runtime/SocketLayer/RingBuffer.cs b/Assets/Mirage/Runtime/SocketLayer/RingBuffer.cs
index d50396f9d79..47d45f6dcae 100644
--- a/Assets/Mirage/Runtime/SocketLayer/RingBuffer.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/RingBuffer.cs
@@ -29,6 +29,7 @@ bool IsDefault(T value)
 
         /// <summary>
         /// Number of non-null items in buffer
+        /// <para>NOTE: this is not distance from read to write</para>
         /// </summary>
         public int Count => count;
 
@@ -73,14 +74,65 @@ public uint Enqueue(T item)
             count++;
             return sequence;
         }
+
+        /// <summary>
+        /// Tries to read the item at read index
+        /// <para>same as <see cref="TryDequeue"/> but does not remove the item after reading it</para>
+        /// </summary>
+        /// <param name="item"></param>
+        /// <returns>true if item exists, or false if it is missing</returns>
+        public bool TryPeak(out T item)
+        {
+            item = buffer[read];
+            return !IsDefault(item);
+        }
+
+        /// <summary>
+        /// Does item exist at index
+        /// <para>Index will be moved into bounds</para>
+        /// </summary>
+        /// <param name="item"></param>
+        /// <returns>true if item exists, or false if it is missing</returns>
+        public bool Exists(uint index)
+        {
+            uint inBounds = (uint)Sequencer.MoveInBounds(index);
+            return !IsDefault(buffer[inBounds]);
+        }
+
+        /// <summary>
+        /// Removes the item at read index and increments read index
+        /// <para>can be used after <see cref="TryPeak"/> to do the same as <see cref="TryDequeue"/></para>
+        /// </summary>
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public void RemoveNext()
+        {
+            buffer[read] = default;
+            read = (uint)Sequencer.NextAfter(read);
+            count--;
+        }
+
+        /// <summary>
+        /// Removes next item and increments read index
+        /// <para>Assumes next items exists, best to use this with <see cref="Exists"/></para>
+        /// </summary>
+        public T Dequeue()
+        {
+            T item = buffer[read];
+            RemoveNext();
+            return item;
+        }
+
+        /// <summary>
+        /// Tries to remove the item at read index
+        /// </summary>
+        /// <param name="item"></param>
+        /// <returns>true if item exists, or false if it is missing</returns>
         public bool TryDequeue(out T item)
         {
             item = buffer[read];
             if (!IsDefault(item))
             {
-                buffer[read] = default;
-                read = (uint)Sequencer.NextAfter(read);
-                count--;
+                RemoveNext();
 
                 return true;
             }
@@ -90,6 +142,7 @@ public bool TryDequeue(out T item)
             }
         }
 
+
         public void InsertAt(uint index, T item)
         {
             count++;
diff --git a/Assets/Tests/Common/TestSocketFactory.cs b/Assets/Tests/Common/TestSocketFactory.cs
index a70c2c09b4a..d0c21d7c8e0 100644
--- a/Assets/Tests/Common/TestSocketFactory.cs
+++ b/Assets/Tests/Common/TestSocketFactory.cs
@@ -4,6 +4,7 @@
 using System.Net;
 using Mirage.SocketLayer;
 using NSubstitute;
+using UnityEngine;
 
 namespace Mirage.Tests
 {
@@ -48,8 +49,11 @@ private void AddThisSocket()
         readonly Queue<Packet> received = new Queue<Packet>();
         public List<Packet> Sent = new List<Packet>();
 
-        public TestSocket(EndPoint endPoint = null)
+        public readonly string name;
+
+        public TestSocket(string name, EndPoint endPoint = null)
         {
+            this.name = name;
             this.endPoint = endPoint ?? Substitute.For<EndPoint>();
         }
 
@@ -95,7 +99,7 @@ void ISocket.Send(EndPoint remoteEndPoint, byte[] data, int length)
             }
 
             // create copy because data is from buffer
-            byte[] clone = data.ToArray();
+            byte[] clone = data.Take(length).ToArray();
             Sent.Add(new Packet
             {
                 endPoint = remoteEndPoint,
@@ -128,9 +132,11 @@ public class TestSocketFactory : SocketFactory
     {
         public EndPoint serverEndpoint = Substitute.For<EndPoint>();
 
+        int clientNameIndex;
+        int serverNameIndex;
         public override ISocket CreateClientSocket()
         {
-            return new TestSocket();
+            return new TestSocket($"Client {clientNameIndex++}");
         }
 
         public override ISocket CreateServerSocket()
@@ -141,7 +147,7 @@ public override ISocket CreateServerSocket()
                 // Clients use Server endpoint to connect, so a 2nd server can't be started from the same TestSocketFactory
                 // if multiple server are needed then it would require multiple instances of TestSocketFactory
             }
-            return new TestSocket(serverEndpoint);
+            return new TestSocket($"Server {serverNameIndex++}", serverEndpoint);
         }
 
         public override EndPoint GetBindEndPoint()
diff --git a/Assets/Tests/Runtime/ClientServer/NetworkClientDisconnectTest.cs b/Assets/Tests/Runtime/ClientServer/NetworkClientDisconnectTest.cs
index 9c63f8c413e..c0f397294ab 100644
--- a/Assets/Tests/Runtime/ClientServer/NetworkClientDisconnectTest.cs
+++ b/Assets/Tests/Runtime/ClientServer/NetworkClientDisconnectTest.cs
@@ -1,4 +1,6 @@
 using System.Collections;
+using System.Linq;
+using System.Net;
 using Mirage.SocketLayer;
 using NUnit.Framework;
 using UnityEngine;
@@ -75,6 +77,55 @@ public IEnumerator DisconnectEventWhenTimeout()
 
             Assert.That(called, Is.EqualTo(1));
         }
+
+        [UnityTest]
+        public IEnumerator DisconnectEventWhenSentInvalidPacket()
+        {
+            (ISocket clientSocket, EndPoint serverEndPoint) = GetSocketAndEndPoint();
+            byte[] badMessage = CreateInvalidPacket();
+
+            clientSocket.Send(serverEndPoint, badMessage, 20);
+
+            int called = 0;
+            client.Disconnected.AddListener((reason) =>
+            {
+                called++;
+                Assert.That(reason, Is.EqualTo(ClientStoppedReason.InvalidPacket));
+            });
+
+            // wait 2 frames so that messages can go from client->server->client
+            yield return null;
+            yield return null;
+
+            Assert.That(called, Is.EqualTo(1));
+        }
+
+        private (ISocket clientSocket, EndPoint serverEndPoint) GetSocketAndEndPoint()
+        {
+            EndPoint clientEndPoint = server.Players.First().Connection.EndPoint;
+            TestSocket clientSocket = TestSocket.allSockets[clientEndPoint];
+
+            EndPoint serverEndPoint = ((TestSocketFactory)server.SocketFactory).serverEndpoint;
+
+            return (clientSocket, serverEndPoint);
+        }
+
+        private static byte[] CreateInvalidPacket()
+        {
+            byte[] packet = new byte[20];
+            int offset = 0;
+            ByteUtils.WriteByte(packet, ref offset, (byte)PacketType.ReliableFragment);
+            // reliable order header
+            offset += 2;
+            offset += 2;
+            offset += 8;
+            offset += 2;
+
+            // byte fragment index over limit in config
+            ByteUtils.WriteByte(packet, ref offset, 200);
+
+            return packet;
+        }
     }
 
     public class NetworkClientConnectFailedFullServerTest : ClientServerSetup<MockComponent>
diff --git a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest.cs b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest.cs
index 0065497dea9..07cc585e56c 100644
--- a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest.cs
+++ b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest.cs
@@ -20,8 +20,8 @@ public static void SendReliable(this AckSystem ackSystem, byte[] array)
     /// </summary>
     public class AckSystemTestBase
     {
-        readonly System.Random rand = new System.Random();
-        protected BufferPool bufferPool = new BufferPool(1300, 100, 1000);
+        protected readonly System.Random rand = new System.Random();
+        protected readonly BufferPool bufferPool = new BufferPool(new Config().MaxPacketSize, 100, 1000);
 
         protected byte[] createRandomData(int id)
         {
diff --git a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Fragmentation_Receive.cs b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Fragmentation_Receive.cs
new file mode 100644
index 00000000000..0bff2d0f007
--- /dev/null
+++ b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Fragmentation_Receive.cs
@@ -0,0 +1,100 @@
+using NUnit.Framework;
+
+namespace Mirage.SocketLayer.Tests.AckSystemTests
+{
+    /// <summary>
+    /// Send is done in setup, and then tests just valid that the sent data is correct
+    /// </summary>
+    [Category("SocketLayer")]
+    public class AckSystemTest_Fragmentation_Receive : AckSystemTestBase
+    {
+        private AckSystem ackSystem;
+        private Config config;
+        private byte[] message;
+        private byte[] packet1;
+        private byte[] packet2;
+
+        [SetUp]
+        public void SetUp()
+        {
+            config = new Config();
+            int mtu = config.MaxPacketSize;
+            int bigSize = (int)(mtu * 1.5f);
+
+            message = CreateBigData(1, bigSize);
+
+            var sender = new AckTestInstance();
+            sender.connection = new SubIRawConnection();
+            sender.ackSystem = new AckSystem(sender.connection, config, new Time(), bufferPool);
+            sender.ackSystem.SendReliable(message);
+            packet1 = sender.packet(0);
+            packet2 = sender.packet(1);
+
+
+            var connection = new SubIRawConnection();
+            ackSystem = new AckSystem(connection, config, new Time(), bufferPool);
+        }
+
+        byte[] CreateBigData(int id, int size)
+        {
+            byte[] buffer = new byte[size];
+            rand.NextBytes(buffer);
+            buffer[0] = (byte)id;
+
+            return buffer;
+        }
+
+
+        [Test]
+        [TestCase(-2, ExpectedResult = false)]
+        [TestCase(-1, ExpectedResult = false)]
+        [TestCase(0, ExpectedResult = true, Description = "equal to max is invalid")]
+        [TestCase(1, ExpectedResult = true)]
+        [TestCase(2, ExpectedResult = true)]
+        [TestCase(5, ExpectedResult = true)]
+        public bool ShouldBeInvalidIfFragmentIsOverMax(int differenceToMax)
+        {
+            int max = config.MaxReliableFragments;
+            byte[] badPacket = new byte[AckSystem.MIN_RELIABLE_FRAGMENT_HEADER_SIZE];
+            int offset = 0;
+            // write as if it is normal packet
+            ByteUtils.WriteByte(badPacket, ref offset, 0);
+            ByteUtils.WriteUShort(badPacket, ref offset, 0);
+            ByteUtils.WriteUShort(badPacket, ref offset, 0);
+            ByteUtils.WriteULong(badPacket, ref offset, 0);
+            ByteUtils.WriteUShort(badPacket, ref offset, 0);
+            // write bad index (over max)
+            int fragment = max + differenceToMax;
+            ByteUtils.WriteByte(badPacket, ref offset, (byte)fragment);
+
+            return ackSystem.InvalidFragment(badPacket);
+        }
+
+
+        [Test]
+        public void MessageShouldBeInQueueAfterReceive()
+        {
+            ackSystem.ReceiveReliable(packet1, packet1.Length, true);
+
+            Assert.IsFalse(ackSystem.NextReliablePacket(out AckSystem.ReliableReceived _));
+
+            ackSystem.ReceiveReliable(packet2, packet2.Length, true);
+
+            int bytesIn1 = config.MaxPacketSize - AckSystem.MIN_RELIABLE_FRAGMENT_HEADER_SIZE;
+            int bytesIn2 = message.Length - bytesIn1;
+
+            Assert.IsTrue(ackSystem.NextReliablePacket(out AckSystem.ReliableReceived first));
+
+            Assert.IsTrue(first.isFragment);
+            Assert.That(first.buffer.array[0], Is.EqualTo(1), "First fragment should have index 1");
+            Assert.That(first.length, Is.EqualTo(bytesIn1 + 1));
+            AssertAreSameFromOffsets(message, 0, first.buffer.array, 1, bytesIn1);
+
+            AckSystem.ReliableReceived second = ackSystem.GetNextFragment();
+            Assert.IsTrue(second.isFragment);
+            Assert.That(second.buffer.array[0], Is.EqualTo(0), "Second fragment should have index 0");
+            Assert.That(second.length, Is.EqualTo(bytesIn2 + 1));
+            AssertAreSameFromOffsets(message, bytesIn1, second.buffer.array, 1, bytesIn2);
+        }
+    }
+}
diff --git a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Fragmentation_Receive.cs.meta b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Fragmentation_Receive.cs.meta
new file mode 100644
index 00000000000..40b7a299ee7
--- /dev/null
+++ b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Fragmentation_Receive.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 4faa65543f63eee40be544c9fb1ff143
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Fragmentation_Send.cs b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Fragmentation_Send.cs
new file mode 100644
index 00000000000..d76a1de8594
--- /dev/null
+++ b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Fragmentation_Send.cs
@@ -0,0 +1,96 @@
+using System.Collections.Generic;
+using NUnit.Framework;
+
+namespace Mirage.SocketLayer.Tests.AckSystemTests
+{
+    /// <summary>
+    /// Send is done in setup, and then tests just valid that the sent data is correct
+    /// </summary>
+    [Category("SocketLayer")]
+    public class AckSystemTest_Fragmentation_Send : AckSystemTestBase
+    {
+        AckTestInstance instance;
+
+        [SetUp]
+        public void SetUp()
+        {
+            var config = new Config();
+            int mtu = config.MaxPacketSize;
+            int bigSize = (int)(mtu * 1.5f);
+
+            byte[] message = CreateBigData(1, bigSize);
+
+            instance = new AckTestInstance();
+            instance.connection = new SubIRawConnection();
+            instance.ackSystem = new AckSystem(instance.connection, config, new Time(), bufferPool);
+
+            // create and send n messages
+            instance.messages = new List<byte[]>();
+            instance.messages.Add(message);
+            instance.ackSystem.SendReliable(message);
+
+            // should not have null data
+            Assert.That(instance.connection.packets, Does.Not.Contain(null));
+        }
+
+        byte[] CreateBigData(int id, int size)
+        {
+            byte[] buffer = new byte[size];
+            rand.NextBytes(buffer);
+            buffer[0] = (byte)id;
+
+            return buffer;
+        }
+
+        [Test]
+        public void ShouldHaveSent2Packets()
+        {
+            Assert.That(instance.connection.packets.Count, Is.EqualTo(2));
+        }
+
+        [Test]
+        public void MessageShouldBeReliableFragment()
+        {
+            foreach (byte[] packet in instance.connection.packets)
+            {
+                int offset = 0;
+                byte packetType = ByteUtils.ReadByte(packet, ref offset);
+                Assert.That((PacketType)packetType, Is.EqualTo(PacketType.ReliableFragment));
+            }
+        }
+
+        [Test]
+        public void EachPacketHasDifferentAckSequence()
+        {
+            for (int i = 0; i < instance.connection.packets.Count; i++)
+            {
+                int offset = 1;
+                ushort sequance = ByteUtils.ReadUShort(instance.packet(i), ref offset);
+                Assert.That(sequance, Is.EqualTo(i));
+            }
+        }
+
+        [Test]
+        public void EachPacketHasDifferentReliableOrder()
+        {
+            for (int i = 0; i < instance.connection.packets.Count; i++)
+            {
+                int offset = 1 + 2 + 2 + 8;
+                ushort reliableOrder = ByteUtils.ReadUShort(instance.packet(i), ref offset);
+
+                Assert.That(reliableOrder, Is.EqualTo(i));
+            }
+        }
+
+        [Test]
+        public void EachPacketHasDifferentFragmentIndex()
+        {
+            for (int i = 0; i < instance.connection.packets.Count; i++)
+            {
+                int offset = 1 + 2 + 2 + 8 + 2;
+                ushort fragmentIndex = ByteUtils.ReadByte(instance.packet(i), ref offset);
+                Assert.That(fragmentIndex, Is.EqualTo(1 - i), "Should be reverse Index, first packet should have 1 and second should have 0");
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Fragmentation_Send.cs.meta b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Fragmentation_Send.cs.meta
new file mode 100644
index 00000000000..2b0f88bee88
--- /dev/null
+++ b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Fragmentation_Send.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 3d4b795ca10fa204cad8b7ea76c4c7e5
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Reliable.cs b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Reliable.cs
index 01fcc0fe225..5a21b0a64b8 100644
--- a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Reliable.cs
+++ b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest_Reliable.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections;
 using System.Collections.Generic;
 using NUnit.Framework;
@@ -6,9 +6,6 @@
 
 namespace Mirage.SocketLayer.Tests.AckSystemTests
 {
-    /// <summary>
-    /// Send is done in setup, and then tests just valid that the sent data is correct
-    /// </summary>
     [Category("SocketLayer")]
     public class AckSystemTest_Reliable : AckSystemTestBase
     {
@@ -80,7 +77,7 @@ private static List<byte[]> Receive(AckSystem ackSystem, byte[] packet)
                 switch (type)
                 {
                     case PacketType.Reliable:
-                        ackSystem.ReceiveReliable(packet, packet.Length);
+                        ackSystem.ReceiveReliable(packet, packet.Length, false);
                         break;
                     case PacketType.Ack:
                         ackSystem.ReceiveAck(packet);
diff --git a/Assets/Tests/SocketLayer/PeerTestBase.cs b/Assets/Tests/SocketLayer/PeerTestBase.cs
index 6b08a6bc3f1..07f516ba7b2 100644
--- a/Assets/Tests/SocketLayer/PeerTestBase.cs
+++ b/Assets/Tests/SocketLayer/PeerTestBase.cs
@@ -87,7 +87,7 @@ public class PeerInstanceWithSocket : PeerInstance
         /// </summary>
         public EndPoint endPoint;
 
-        public PeerInstanceWithSocket(Config config = null) : base(config, socket: new TestSocket())
+        public PeerInstanceWithSocket(Config config = null) : base(config, socket: new TestSocket("TestInstance"))
         {
             socket = (TestSocket)base.socket;
             endPoint = socket.endPoint;
diff --git a/Assets/Tests/SocketLayer/PeerTestSendReceive.cs b/Assets/Tests/SocketLayer/PeerTestSendReceive.cs
index 0f0d3de6840..da4f419ac45 100644
--- a/Assets/Tests/SocketLayer/PeerTestSendReceive.cs
+++ b/Assets/Tests/SocketLayer/PeerTestSendReceive.cs
@@ -1,9 +1,11 @@
 using System;
+using System.Collections;
 using System.Collections.Generic;
 using System.Linq;
 using System.Net;
 using NSubstitute;
 using NUnit.Framework;
+using UnityEngine.TestTools;
 
 namespace Mirage.SocketLayer.Tests.PeerTests
 {
@@ -17,13 +19,21 @@ public class PeerTestSendReceive
         List<IConnection> clientConnections;
         List<IConnection> serverConnections;
 
+        int maxFragmentMessageSize;
+        float NotifyWaitTime;
+
         [SetUp]
         public void SetUp()
         {
             clientConnections = new List<IConnection>();
             serverConnections = new List<IConnection>();
 
-            server = new PeerInstanceWithSocket(new Config { MaxConnections = ClientCount });
+            var config = new Config { MaxConnections = ClientCount };
+            maxFragmentMessageSize = config.MaxReliableFragments * (config.MaxPacketSize - AckSystem.MIN_RELIABLE_FRAGMENT_HEADER_SIZE);
+            NotifyWaitTime = config.TimeBeforeEmptyAck * 2;
+
+
+            server = new PeerInstanceWithSocket(config);
             clients = new PeerInstanceWithSocket[ClientCount];
             Action<IConnection> serverConnect = (conn) => serverConnections.Add(conn);
             server.peer.OnConnected += serverConnect;
@@ -31,7 +41,7 @@ public void SetUp()
             server.peer.Bind(Substitute.For<EndPoint>());
             for (int i = 0; i < ClientCount; i++)
             {
-                clients[i] = new PeerInstanceWithSocket();
+                clients[i] = new PeerInstanceWithSocket(config);
                 clientConnections.Add(clients[i].peer.Connect(server.endPoint));
             }
 
@@ -47,56 +57,237 @@ void UpdateAll()
             }
         }
 
-        [Test]
-        public void SeverUnreliableSend()
+        private void CheckClientReceived(byte[] message)
         {
-            byte[] packet = Enumerable.Range(10, 20).Select(x => (byte)x).ToArray();
+            UpdateAll();
+            UpdateAll();
 
-            // send 1 message to each client
+            // check each client got packet once
             for (int i = 0; i < ClientCount; i++)
             {
-                serverConnections[i].SendUnreliable(packet);
+                IDataHandler handler = clients[i].dataHandler;
+
+                //handler.Received(1).ReceiveMessage(clientConnections[i], Arg.Is<ArraySegment<byte>>(x => x.SequenceEqual(message)));
+                handler.Received(1).ReceiveMessage(clientConnections[i], Arg.Is<ArraySegment<byte>>(x => DebugSequenceEqual(message, x)));
             }
+        }
 
+        private void CheckServerReceived(byte[] message)
+        {
+            UpdateAll();
             UpdateAll();
 
-            // check each client got packet once
+            IDataHandler handler = server.dataHandler;
+            // check each client sent packet once
             for (int i = 0; i < ClientCount; i++)
             {
-                IDataHandler handler = clients[i].dataHandler;
+                //handler.Received(1).ReceiveMessage(serverConnections[i], Arg.Is<ArraySegment<byte>>(x => x.SequenceEqual(message)));
+                handler.Received(1).ReceiveMessage(serverConnections[i], Arg.Is<ArraySegment<byte>>(x => DebugSequenceEqual(message, x)));
+            }
+        }
+
+        [Test]
+        public void SeverUnreliableSend()
+        {
+            byte[] message = Enumerable.Range(10, 20).Select(x => (byte)x).ToArray();
 
-                handler.Received(1).ReceiveMessage(clientConnections[i], Arg.Is<ArraySegment<byte>>(x => x.SequenceEqual(packet)));
+            // send 1 message to each client
+            for (int i = 0; i < ClientCount; i++)
+            {
+                serverConnections[i].SendUnreliable(message);
             }
+
+            CheckClientReceived(message);
         }
 
+
         [Test]
         public void ClientUnreliableSend()
         {
-            Assert.Ignore("not implemented");
+            byte[] message = Enumerable.Range(10, 20).Select(x => (byte)x).ToArray();
+
+            // send 1 message from each client
+            for (int i = 0; i < ClientCount; i++)
+            {
+                clientConnections[i].SendUnreliable(message);
+            }
+
+            CheckServerReceived(message);
         }
 
         [Test]
         public void ServerNotifySend()
         {
-            Assert.Ignore("not implemented");
+            byte[] message = Enumerable.Range(10, 20).Select(x => (byte)x).ToArray();
+
+            // send 1 message to each client
+            for (int i = 0; i < ClientCount; i++)
+            {
+                serverConnections[i].SendNotify(message);
+            }
+
+            CheckClientReceived(message);
         }
 
         [Test]
         public void ClientNotifySend()
         {
-            Assert.Ignore("not implemented");
+            byte[] message = Enumerable.Range(10, 20).Select(x => (byte)x).ToArray();
+
+            // send 1 message from each client
+            for (int i = 0; i < ClientCount; i++)
+            {
+                clientConnections[i].SendNotify(message);
+            }
+
+            CheckServerReceived(message);
+        }
+
+        [UnityTest]
+        public IEnumerator ServerNotifySendMarkedAsReceived()
+        {
+            byte[] message = Enumerable.Range(10, 20).Select(x => (byte)x).ToArray();
+
+            var received = new Action[ClientCount];
+            var lost = new Action[ClientCount];
+            // send 1 message to each client
+            for (int i = 0; i < ClientCount; i++)
+            {
+                INotifyToken token = serverConnections[i].SendNotify(message);
+
+                received[i] = Substitute.For<Action>();
+                lost[i] = Substitute.For<Action>();
+                token.Delivered += received[i];
+                token.Lost += lost[i];
+            }
+
+            float end = UnityEngine.Time.time + NotifyWaitTime;
+            while (end > UnityEngine.Time.time)
+            {
+                UpdateAll();
+                yield return null;
+            }
+
+            for (int i = 0; i < ClientCount; i++)
+            {
+                received[i].Received(1).Invoke();
+                lost[i].DidNotReceive().Invoke();
+            }
+        }
+
+        [UnityTest]
+        public IEnumerator ClientNotifySendMarkedAsReceived()
+        {
+            byte[] message = Enumerable.Range(10, 20).Select(x => (byte)x).ToArray();
+
+            var received = new Action[ClientCount];
+            var lost = new Action[ClientCount];
+            // send 1 message from each client
+            for (int i = 0; i < ClientCount; i++)
+            {
+                INotifyToken token = clientConnections[i].SendNotify(message);
+
+                received[i] = Substitute.For<Action>();
+                lost[i] = Substitute.For<Action>();
+                token.Delivered += received[i];
+                token.Lost += lost[i];
+            }
+
+            float end = UnityEngine.Time.time + NotifyWaitTime;
+            while (end > UnityEngine.Time.time)
+            {
+                UpdateAll();
+                yield return null;
+            }
+
+            for (int i = 0; i < ClientCount; i++)
+            {
+                received[i].Received(1).Invoke();
+                lost[i].DidNotReceive().Invoke();
+            }
         }
 
+
         [Test]
-        public void ServerNotifyAck()
+        public void ServerReliableSend()
         {
-            Assert.Ignore("not implemented");
+            byte[] message = Enumerable.Range(10, 20).Select(x => (byte)x).ToArray();
+
+            // send 1 message to each client
+            for (int i = 0; i < ClientCount; i++)
+            {
+                serverConnections[i].SendReliable(message);
+            }
+
+            CheckClientReceived(message);
         }
 
         [Test]
-        public void ClientNotifyAck()
+        public void ClientReliableSend()
         {
-            Assert.Ignore("not implemented");
+            byte[] message = Enumerable.Range(10, 20).Select(x => (byte)x).ToArray();
+
+            // send 1 message from each client
+            for (int i = 0; i < ClientCount; i++)
+            {
+                clientConnections[i].SendReliable(message);
+            }
+
+            CheckServerReceived(message);
+        }
+
+        [Test]
+        [TestCase(1, 5)]
+        [TestCase(0.8f, 4)]
+        [TestCase(0.5f, 3)]
+        [TestCase(0.3f, 2)]
+        [TestCase(0.2f, 1)]
+        public void FragmentedSend(float maxMultiplier, int expectedFragments)
+        {
+            int size = (int)(maxFragmentMessageSize * maxMultiplier);
+            byte[] message = Enumerable.Range(10, size).Select(x => (byte)x).ToArray();
+
+            int sentCount = server.socket.Sent.Count;
+
+            serverConnections[0].SendReliable(message);
+            IDataHandler handler = clients[0].dataHandler;
+
+            // change in sent
+            Assert.That(server.socket.Sent.Count - sentCount, Is.EqualTo(expectedFragments));
+
+            UpdateAll();
+
+            handler.Received(1).ReceiveMessage(clientConnections[0], Arg.Is<ArraySegment<byte>>(x => x.SequenceEqual(message)));
+        }
+
+        [Test]
+        public void FragmentedSendThrowsIfTooBig()
+        {
+            byte[] message = Enumerable.Range(10, maxFragmentMessageSize + 1).Select(x => (byte)x).ToArray();
+
+            Assert.Throws<ArgumentException>(() =>
+            {
+                serverConnections[0].SendReliable(message);
+            });
+
+            UpdateAll();
+
+            IDataHandler handler = clients[0].dataHandler;
+            handler.DidNotReceive().ReceiveMessage(Arg.Any<IConnection>(), Arg.Any<ArraySegment<byte>>());
+        }
+
+
+
+        private bool DebugSequenceEqual(byte[] inMsg, ArraySegment<byte> outMsg)
+        {
+            if (inMsg.Length != outMsg.Count) { return false; }
+
+            for (int i = 0; i < inMsg.Length; i++)
+            {
+                if (inMsg[i] != outMsg.Array[outMsg.Offset + i]) { return false; }
+            }
+
+            return true;
         }
     }
 }

From 16f91bab12eefd3932fad06c654c314be8875c3e Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Sun, 27 Jun 2021 18:57:08 +0000
Subject: [PATCH 030/166] chore(release): 97.1.0 [skip ci]

# [97.1.0](https://github.com/MirageNet/Mirage/compare/v97.0.1...v97.1.0) (2021-06-27)

### Features

* **SocketLayer:** adding fragmentation to reliable sending ([#851](https://github.com/MirageNet/Mirage/issues/851)) ([4764294](https://github.com/MirageNet/Mirage/commit/4764294b18a6e20780fe05626bd001f8c63790f8))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs               | 2 +-
 Assets/Mirage/CHANGELOG.md                                 | 7 +++++++
 Assets/Mirage/Components/AssemblyInfo.cs                   | 2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                      | 2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs          | 2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs                     | 2 +-
 .../Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs      | 2 +-
 Assets/Mirage/package.json                                 | 2 +-
 8 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index a93b68da018..fcd19e05f64 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("97.0.1")]
+[assembly: AssemblyVersion("97.1.0")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index e1566d5618d..95a3f4b4c3c 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,10 @@
+# [97.1.0](https://github.com/MirageNet/Mirage/compare/v97.0.1...v97.1.0) (2021-06-27)
+
+
+### Features
+
+* **SocketLayer:** adding fragmentation to reliable sending ([#851](https://github.com/MirageNet/Mirage/issues/851)) ([4764294](https://github.com/MirageNet/Mirage/commit/4764294b18a6e20780fe05626bd001f8c63790f8))
+
 ## [97.0.1](https://github.com/MirageNet/Mirage/compare/v97.0.0...v97.0.1) (2021-06-27)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index b4fbc086184..ae95d5a5c6a 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("97.0.1")]
+[assembly: AssemblyVersion("97.1.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index 506a1d87156..166c8cd9fdf 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("97.0.1")]
+[assembly: AssemblyVersion("97.1.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index c3d7f9831e8..6c7d2beadf4 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("97.0.1")]
+[assembly: AssemblyVersion("97.1.0")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index a93b68da018..fcd19e05f64 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("97.0.1")]
+[assembly: AssemblyVersion("97.1.0")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index a93b68da018..fcd19e05f64 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("97.0.1")]
+[assembly: AssemblyVersion("97.1.0")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index a38d00d8059..3860926c5cd 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "97.0.1",
+    "version": "97.1.0",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From 07b59b881ccc0db6278729a2905110c95b19ef57 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Sun, 27 Jun 2021 22:20:11 +0100
Subject: [PATCH 031/166] test: fixing health script not starting its coroutine

---
 Assets/Tests/Performance/Runtime/10KL/Scripts/Health.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/Assets/Tests/Performance/Runtime/10KL/Scripts/Health.cs b/Assets/Tests/Performance/Runtime/10KL/Scripts/Health.cs
index 69d1fdccf1f..3aabca0a7ec 100644
--- a/Assets/Tests/Performance/Runtime/10KL/Scripts/Health.cs
+++ b/Assets/Tests/Performance/Runtime/10KL/Scripts/Health.cs
@@ -6,6 +6,11 @@ namespace Mirage.Examples.Light
     public class Health : NetworkBehaviour
     {
         [SyncVar] public int health = 10;
+        private void Awake()
+        {
+            NetIdentity.OnStartServer.AddListener(OnStartServer);
+            NetIdentity.OnStopServer.AddListener(OnStopServer);
+        }
 
         public void OnStartServer()
         {

From a27fe9aefb9871851028385579df3a3d9d056161 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Sun, 27 Jun 2021 22:20:30 +0100
Subject: [PATCH 032/166] test: using IterationsPerMeasurement for performance
 tests

---
 .../Runtime/NetworkWriter/NetworkWriterPerformance.cs  | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/Assets/Tests/Performance/Runtime/NetworkWriter/NetworkWriterPerformance.cs b/Assets/Tests/Performance/Runtime/NetworkWriter/NetworkWriterPerformance.cs
index 05942c26d21..f3abcb8b4db 100644
--- a/Assets/Tests/Performance/Runtime/NetworkWriter/NetworkWriterPerformance.cs
+++ b/Assets/Tests/Performance/Runtime/NetworkWriter/NetworkWriterPerformance.cs
@@ -13,6 +13,7 @@ public class NetworkWriterPerformance
         public void WritePackedInt32()
         {
             Measure.Method(WPackedInt32)
+                .IterationsPerMeasurement(1000)
                 .WarmupCount(10)
                 .MeasurementCount(100)
                 .Run();
@@ -22,7 +23,7 @@ static void WPackedInt32()
         {
             using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
             {
-                for (int i = 0; i < 1000; i++)
+                for (int i = 0; i < 37; i++)
                 {
                     writer.WritePackedInt32(i * 1000);
                 }
@@ -34,6 +35,7 @@ static void WPackedInt32()
         public void WriteInt32()
         {
             Measure.Method(WInt32)
+                .IterationsPerMeasurement(1000)
                 .WarmupCount(10)
                 .MeasurementCount(100)
                 .Run();
@@ -42,7 +44,7 @@ static void WInt32()
         {
             using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
             {
-                for (int i = 0; i < 1000; i++)
+                for (int i = 0; i < 37; i++)
                 {
                     writer.WriteInt32(i * 1000);
                 }
@@ -55,6 +57,7 @@ static void WInt32()
         public void WriteGenericInt32()
         {
             Measure.Method(WGenericInt32)
+                .IterationsPerMeasurement(1000)
                 .WarmupCount(10)
                 .MeasurementCount(100)
                 .Run();
@@ -63,7 +66,7 @@ static void WGenericInt32()
         {
             using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
             {
-                for (int i = 0; i < 1000; i++)
+                for (int i = 0; i < 37; i++)
                 {
                     writer.Write(i * 1000);
                 }
@@ -71,4 +74,3 @@ static void WGenericInt32()
         }
     }
 }
-

From 6b4c98889777cad31d27d8211f8858e4d81bde09 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Sun, 27 Jun 2021 22:36:01 +0100
Subject: [PATCH 033/166] fix(NetworkManagerHud): returning to offline menu
 when server or client is stopped

---
 Assets/Mirage/Components/NetworkManagerHud.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/Assets/Mirage/Components/NetworkManagerHud.cs b/Assets/Mirage/Components/NetworkManagerHud.cs
index ec2c5d1495c..5aacba41a29 100644
--- a/Assets/Mirage/Components/NetworkManagerHud.cs
+++ b/Assets/Mirage/Components/NetworkManagerHud.cs
@@ -18,6 +18,10 @@ private void Start()
         {
             DontDestroyOnLoad(transform.root.gameObject);
             Application.runInBackground = true;
+
+            // return to offset menu when server or client is stopped
+            NetworkManager.Server.Stopped.AddListener(OfflineSetActive);
+            NetworkManager.Client.Disconnected.AddListener(_ => OfflineSetActive());
         }
 
         void SetLabel(string value)

From e4200e07b9c424eccda9e8bfb75a743af753ad78 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Mon, 28 Jun 2021 14:57:01 +0100
Subject: [PATCH 034/166] fix(NetworkManagerHud): adding null check before
 using server or client

---
 Assets/Mirage/Components/NetworkManagerHud.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Assets/Mirage/Components/NetworkManagerHud.cs b/Assets/Mirage/Components/NetworkManagerHud.cs
index 5aacba41a29..33dde7b42e9 100644
--- a/Assets/Mirage/Components/NetworkManagerHud.cs
+++ b/Assets/Mirage/Components/NetworkManagerHud.cs
@@ -20,8 +20,8 @@ private void Start()
             Application.runInBackground = true;
 
             // return to offset menu when server or client is stopped
-            NetworkManager.Server.Stopped.AddListener(OfflineSetActive);
-            NetworkManager.Client.Disconnected.AddListener(_ => OfflineSetActive());
+            NetworkManager.Server?.Stopped.AddListener(OfflineSetActive);
+            NetworkManager.Client?.Disconnected.AddListener(_ => OfflineSetActive());
         }
 
         void SetLabel(string value)

From a5c11d9c484ecdc1acadda73e6aec282b89dd363 Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Mon, 28 Jun 2021 14:09:33 +0000
Subject: [PATCH 035/166] chore(release): 97.1.1 [skip ci]

## [97.1.1](https://github.com/MirageNet/Mirage/compare/v97.1.0...v97.1.1) (2021-06-28)

### Bug Fixes

* **NetworkManagerHud:** adding null check before using server or client ([e4200e0](https://github.com/MirageNet/Mirage/commit/e4200e07b9c424eccda9e8bfb75a743af753ad78))
* **NetworkManagerHud:** returning to offline menu when server or client is stopped ([6b4c988](https://github.com/MirageNet/Mirage/commit/6b4c98889777cad31d27d8211f8858e4d81bde09))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs              | 2 +-
 Assets/Mirage/CHANGELOG.md                                | 8 ++++++++
 Assets/Mirage/Components/AssemblyInfo.cs                  | 2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                     | 2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs         | 2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs                    | 2 +-
 .../Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs     | 2 +-
 Assets/Mirage/package.json                                | 2 +-
 8 files changed, 15 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index fcd19e05f64..0eb5cc3dedc 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("97.1.0")]
+[assembly: AssemblyVersion("97.1.1")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index 95a3f4b4c3c..04921879ef2 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,11 @@
+## [97.1.1](https://github.com/MirageNet/Mirage/compare/v97.1.0...v97.1.1) (2021-06-28)
+
+
+### Bug Fixes
+
+* **NetworkManagerHud:** adding null check before using server or client ([e4200e0](https://github.com/MirageNet/Mirage/commit/e4200e07b9c424eccda9e8bfb75a743af753ad78))
+* **NetworkManagerHud:** returning to offline menu when server or client is stopped ([6b4c988](https://github.com/MirageNet/Mirage/commit/6b4c98889777cad31d27d8211f8858e4d81bde09))
+
 # [97.1.0](https://github.com/MirageNet/Mirage/compare/v97.0.1...v97.1.0) (2021-06-27)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index ae95d5a5c6a..80fb02f7b66 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("97.1.0")]
+[assembly: AssemblyVersion("97.1.1")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index 166c8cd9fdf..398f388c94b 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("97.1.0")]
+[assembly: AssemblyVersion("97.1.1")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index 6c7d2beadf4..fb258dc6c2e 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("97.1.0")]
+[assembly: AssemblyVersion("97.1.1")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index fcd19e05f64..0eb5cc3dedc 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("97.1.0")]
+[assembly: AssemblyVersion("97.1.1")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index fcd19e05f64..0eb5cc3dedc 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("97.1.0")]
+[assembly: AssemblyVersion("97.1.1")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 3860926c5cd..8f380780b82 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "97.1.0",
+    "version": "97.1.1",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From 5a8cf36cfd4b3fce410d0f4150dcb326ddcb6f4a Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowen5@gmail.com>
Date: Mon, 28 Jun 2021 16:07:53 +0100
Subject: [PATCH 036/166] docs: adding max value to doc comments

---
 Assets/Mirage/Runtime/SocketLayer/Config.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/Assets/Mirage/Runtime/SocketLayer/Config.cs b/Assets/Mirage/Runtime/SocketLayer/Config.cs
index 662b8627c4b..3a82c4d20ed 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Config.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Config.cs
@@ -1,5 +1,6 @@
 namespace Mirage.SocketLayer
 {
+    // todo add validation for this config
     public class Config
     {
         #region server 
@@ -104,6 +105,7 @@ public class Config
         /// <summary>
         /// How many fragments large reliable message can be split into
         /// <para>if set to 0 then messages over <see cref="MaxPacketSize"/> will not be allowed to be sent</para>
+        /// <para>max value is 255</para>
         /// </summary>
         public int MaxReliableFragments = 5;
         #endregion

From f93578641956c17d84f32ab6356887f45974b07d Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Thu, 1 Jul 2021 16:01:36 +0100
Subject: [PATCH 037/166] perf(SocketLayer): adding IEquatable to struct

removes allocations from ring buffer comparer
---
 Assets/Mirage/Runtime/SocketLayer/AckSystem.cs | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs b/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
index addb70a81f2..182fe7a3dba 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
@@ -718,7 +718,7 @@ public override int GetHashCode()
                 return order;
             }
         }
-        public struct ReliableReceived
+        public struct ReliableReceived : IEquatable<ReliableReceived>
         {
             public readonly ByteBuffer buffer;
             public readonly int length;
@@ -735,6 +735,11 @@ public ReliableReceived(ByteBuffer buffer, int length, bool isFragment)
                 this.length = length;
                 this.isFragment = isFragment;
             }
+
+            public bool Equals(ReliableReceived other)
+            {
+                return buffer == other.buffer;
+            }
         }
     }
 }

From d3089f8a3419728db0836d6f62a02805e1b33252 Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Thu, 1 Jul 2021 15:15:05 +0000
Subject: [PATCH 038/166] chore(release): 97.1.2 [skip ci]

## [97.1.2](https://github.com/MirageNet/Mirage/compare/v97.1.1...v97.1.2) (2021-07-01)

### Performance Improvements

* **SocketLayer:** adding IEquatable to struct ([f935786](https://github.com/MirageNet/Mirage/commit/f93578641956c17d84f32ab6356887f45974b07d))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs               | 2 +-
 Assets/Mirage/CHANGELOG.md                                 | 7 +++++++
 Assets/Mirage/Components/AssemblyInfo.cs                   | 2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                      | 2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs          | 2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs                     | 2 +-
 .../Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs      | 2 +-
 Assets/Mirage/package.json                                 | 2 +-
 8 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index 0eb5cc3dedc..f7cb55869ad 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("97.1.1")]
+[assembly: AssemblyVersion("97.1.2")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index 04921879ef2..abfdd262280 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,10 @@
+## [97.1.2](https://github.com/MirageNet/Mirage/compare/v97.1.1...v97.1.2) (2021-07-01)
+
+
+### Performance Improvements
+
+* **SocketLayer:** adding IEquatable to struct ([f935786](https://github.com/MirageNet/Mirage/commit/f93578641956c17d84f32ab6356887f45974b07d))
+
 ## [97.1.1](https://github.com/MirageNet/Mirage/compare/v97.1.0...v97.1.1) (2021-06-28)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index 80fb02f7b66..7f2f2219d1d 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("97.1.1")]
+[assembly: AssemblyVersion("97.1.2")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index 398f388c94b..3079d41d0ca 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("97.1.1")]
+[assembly: AssemblyVersion("97.1.2")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index fb258dc6c2e..2e0f1f817f8 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("97.1.1")]
+[assembly: AssemblyVersion("97.1.2")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index 0eb5cc3dedc..f7cb55869ad 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("97.1.1")]
+[assembly: AssemblyVersion("97.1.2")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index 0eb5cc3dedc..f7cb55869ad 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("97.1.1")]
+[assembly: AssemblyVersion("97.1.2")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 8f380780b82..670fe30de7c 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "97.1.1",
+    "version": "97.1.2",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From 59ce7e097d46d7f2cb7eaa01736dde36066396c5 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Fri, 2 Jul 2021 17:03:08 +0100
Subject: [PATCH 039/166] perf: improving how socketlayer handles endpoints
 (#856)

Peer EndPoint is now an interface that has a method to create a copy. This will allow Sockets to re-use a single endpoint inside receive and Peer will create a copy of it when a new connection is accepted

BREAKING CHANGE: Socket functions now use an interface instead of the EndPoint class, Socket Implementations should create a custom Endpoint class for their socket.
---
 Assets/Mirage/Runtime/NetworkClient.cs        |  2 +-
 Assets/Mirage/Runtime/NetworkPlayer.cs        |  4 +-
 Assets/Mirage/Runtime/PipePeerConnection.cs   | 10 ++-
 .../Mirage/Runtime/SocketLayer/Connection.cs  | 14 ++--
 Assets/Mirage/Runtime/SocketLayer/ISocket.cs  | 30 +++++--
 Assets/Mirage/Runtime/SocketLayer/Peer.cs     | 23 +++---
 .../Runtime/SocketLayer/SocketFactory.cs      |  4 +-
 .../Runtime/Sockets/Udp/UdpSocketFactory.cs   | 79 ++++++++++++++-----
 .../Tests/Common/Mirage.Tests.Common.asmdef   |  3 +-
 Assets/Tests/Common/TestSocketFactory.cs      | 41 ++++++----
 .../NetworkClientDisconnectTest.cs            |  9 +--
 Assets/Tests/SocketLayer/PeerTest.cs          | 10 +--
 Assets/Tests/SocketLayer/PeerTestAsClient.cs  | 20 ++---
 Assets/Tests/SocketLayer/PeerTestAsServer.cs  | 26 +++---
 Assets/Tests/SocketLayer/PeerTestBase.cs      | 11 ++-
 .../Tests/SocketLayer/PeerTestConnecting.cs   |  4 +-
 .../Tests/SocketLayer/PeerTestSendReceive.cs  |  4 +-
 17 files changed, 180 insertions(+), 114 deletions(-)

diff --git a/Assets/Mirage/Runtime/NetworkClient.cs b/Assets/Mirage/Runtime/NetworkClient.cs
index 7b0b9371de5..d54afb741a1 100644
--- a/Assets/Mirage/Runtime/NetworkClient.cs
+++ b/Assets/Mirage/Runtime/NetworkClient.cs
@@ -112,7 +112,7 @@ public void Connect(string address = null, ushort? port = null)
             World = new NetworkWorld();
             InitializeAuthEvents();
 
-            EndPoint endPoint = SocketFactory.GetConnectEndPoint(address, port);
+            IEndPoint endPoint = SocketFactory.GetConnectEndPoint(address, port);
             if (logger.LogEnabled()) logger.Log($"Client connecting to endpoint: {endPoint}");
 
             ISocket socket = SocketFactory.CreateClientSocket();
diff --git a/Assets/Mirage/Runtime/NetworkPlayer.cs b/Assets/Mirage/Runtime/NetworkPlayer.cs
index 96a6c69609f..07f2aae7829 100644
--- a/Assets/Mirage/Runtime/NetworkPlayer.cs
+++ b/Assets/Mirage/Runtime/NetworkPlayer.cs
@@ -1,9 +1,9 @@
 using System;
 using System.Collections.Generic;
 using System.IO;
-using System.Net;
 using Mirage.Logging;
 using Mirage.Serialization;
+using Mirage.SocketLayer;
 using UnityEngine;
 using UnityEngine.Assertions;
 
@@ -70,7 +70,7 @@ public sealed class NetworkPlayer : INetworkPlayer
         /// The IP address / URL / FQDN associated with the connection.
         /// Can be useful for a game master to do IP Bans etc.
         /// </summary>
-        public EndPoint Address => connection.EndPoint;
+        public IEndPoint Address => connection.EndPoint;
 
         public SocketLayer.IConnection Connection => connection;
 
diff --git a/Assets/Mirage/Runtime/PipePeerConnection.cs b/Assets/Mirage/Runtime/PipePeerConnection.cs
index 19e0c630cbc..a018ad28a7d 100644
--- a/Assets/Mirage/Runtime/PipePeerConnection.cs
+++ b/Assets/Mirage/Runtime/PipePeerConnection.cs
@@ -1,5 +1,4 @@
 using System;
-using System.Net;
 using Mirage.Logging;
 using Mirage.SocketLayer;
 using UnityEngine;
@@ -58,7 +57,7 @@ public override string ToString()
             return name;
         }
 
-        EndPoint IConnection.EndPoint => new PipeEndPoint();
+        IEndPoint IConnection.EndPoint => new PipeEndPoint();
 
 
         public ConnectionState State { get; private set; } = ConnectionState.Connected;
@@ -117,8 +116,13 @@ private void receive(byte[] packet, int offset, int length)
             otherHandler.ReceiveMessage(otherConnection, new ArraySegment<byte>(packet, offset, length));
         }
 
-        public class PipeEndPoint : EndPoint
+        public class PipeEndPoint : IEndPoint
         {
+            IEndPoint IEndPoint.CreateCopy()
+            {
+                // never need copy of pipeendpoint
+                throw new NotSupportedException();
+            }
         }
 
         /// <summary>
diff --git a/Assets/Mirage/Runtime/SocketLayer/Connection.cs b/Assets/Mirage/Runtime/SocketLayer/Connection.cs
index db1ae325b45..88ebfb05c68 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Connection.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Connection.cs
@@ -1,5 +1,4 @@
 using System;
-using System.Net;
 using UnityEngine;
 
 namespace Mirage.SocketLayer
@@ -9,7 +8,7 @@ namespace Mirage.SocketLayer
     /// </summary>
     public interface IConnection
     {
-        EndPoint EndPoint { get; }
+        IEndPoint EndPoint { get; }
         ConnectionState State { get; }
 
         void Disconnect();
@@ -97,7 +96,7 @@ public ConnectionState State
         public bool Connected => State == ConnectionState.Connected;
 
         private readonly Peer peer;
-        public readonly EndPoint EndPoint;
+        public readonly IEndPoint EndPoint;
         private readonly IDataHandler dataHandler;
 
         private readonly ConnectingTracker connectingTracker;
@@ -107,13 +106,16 @@ public ConnectionState State
 
         private readonly AckSystem ackSystem;
 
-        EndPoint IConnection.EndPoint => EndPoint;
+        IEndPoint IConnection.EndPoint => EndPoint;
 
-        internal Connection(Peer peer, EndPoint endPoint, IDataHandler dataHandler, Config config, Time time, BufferPool bufferPool, ILogger logger, Metrics metrics)
+        internal Connection(Peer peer, IEndPoint endPoint, IDataHandler dataHandler, Config config, Time time, BufferPool bufferPool, ILogger logger, Metrics metrics)
         {
             this.peer = peer;
             this.logger = logger ?? Debug.unityLogger;
-            EndPoint = endPoint ?? throw new ArgumentNullException(nameof(endPoint));
+
+            // create copy of endpoint for this connection
+            // this is so that we can re-use the endpoint (reduces alloc) for receive and not worry about changing internal data needed for each connection
+            EndPoint = endPoint?.CreateCopy() ?? throw new ArgumentNullException(nameof(endPoint));
             this.dataHandler = dataHandler ?? throw new ArgumentNullException(nameof(dataHandler));
             State = ConnectionState.Created;
 
diff --git a/Assets/Mirage/Runtime/SocketLayer/ISocket.cs b/Assets/Mirage/Runtime/SocketLayer/ISocket.cs
index 11772c4119c..b630a602cce 100644
--- a/Assets/Mirage/Runtime/SocketLayer/ISocket.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/ISocket.cs
@@ -1,5 +1,3 @@
-using System.Net;
-
 namespace Mirage.SocketLayer
 {
     /// <summary>
@@ -12,13 +10,13 @@ public interface ISocket
         /// <para>Used by Server to allow clients to connect</para>
         /// </summary>
         /// <param name="endPoint">the endpoint to listen on</param>
-        void Bind(EndPoint endPoint);
+        void Bind(IEndPoint endPoint);
 
         /// <summary>
         /// Sets up Socket ready to send data to endpoint as a client
         /// </summary>
         /// <param name="endPoint"></param>
-        void Connect(EndPoint endPoint);
+        void Connect(IEndPoint endPoint);
 
         /// <summary>
         /// Closes the socket, stops receiving messages from other peers
@@ -42,7 +40,7 @@ public interface ISocket
         /// <param name="buffer">buffer to write recevived packet into</param>
         /// <param name="endPoint">where packet came from</param>
         /// <returns>length of packet, should not be above <paramref name="buffer"/> length</returns>
-        int Receive(byte[] buffer, out EndPoint endPoint);
+        int Receive(byte[] buffer, out IEndPoint endPoint);
 
         /// <summary>
         /// Sends a packet to an endpoint
@@ -51,6 +49,26 @@ public interface ISocket
         /// <param name="endPoint">where packet is being sent to</param>
         /// <param name="packet">buffer that contains the packet, starting at index 0</param>
         /// <param name="length">length of the packet</param>
-        void Send(EndPoint endPoint, byte[] packet, int length);
+        void Send(IEndPoint endPoint, byte[] packet, int length);
+    }
+
+    /// <summary>
+    /// Object that can be used as an endpoint for <see cref="Peer"/> and <see cref="ISocket"/>
+    /// <para>
+    /// Implementation of this should override <see cref="object.GetHashCode"/> and <see cref="object.Equals(object)"/> so that 2 instance wil be equal if they have the same address internally
+    /// </para>
+    /// <para>
+    /// When a new connection is received by Peer a copy of this endpoint will be created and given to that connection.
+    /// On future received the incoming endpoint will be compared to active connections inside a dictionary
+    /// </para>
+    /// </summary>
+    public interface IEndPoint
+    {
+        /// <summary>
+        /// Creates a new instance of <see cref="IEndPoint"/> with same connection data
+        /// <para>this is called when a new connection is created by <see cref="Peer"/></para>
+        /// </summary>
+        /// <returns></returns>
+        IEndPoint CreateCopy();
     }
 }
diff --git a/Assets/Mirage/Runtime/SocketLayer/Peer.cs b/Assets/Mirage/Runtime/SocketLayer/Peer.cs
index c4284e3920a..5908c4c2f00 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Peer.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Peer.cs
@@ -1,6 +1,5 @@
 using System;
 using System.Collections.Generic;
-using System.Net;
 using UnityEngine;
 
 namespace Mirage.SocketLayer
@@ -20,8 +19,8 @@ public interface IPeer
         event Action<IConnection, RejectReason> OnConnectionFailed;
         event Action<IConnection, DisconnectReason> OnDisconnected;
 
-        void Bind(EndPoint endPoint);
-        IConnection Connect(EndPoint endPoint);
+        void Bind(IEndPoint endPoint);
+        IConnection Connect(IEndPoint endPoint);
         void Close();
         void Update();
     }
@@ -48,7 +47,7 @@ void Error(string error)
 
         readonly ConnectKeyValidator connectKeyValidator;
         readonly BufferPool bufferPool;
-        readonly Dictionary<EndPoint, Connection> connections = new Dictionary<EndPoint, Connection>();
+        readonly Dictionary<IEndPoint, Connection> connections = new Dictionary<IEndPoint, Connection>();
         // list so that remove can take place after foreach loops
         readonly List<Connection> connectionsToRemove = new List<Connection>();
 
@@ -85,14 +84,14 @@ private void Application_quitting()
                 Close();
         }
 
-        public void Bind(EndPoint endPoint)
+        public void Bind(IEndPoint endPoint)
         {
             if (active) throw new InvalidOperationException("Peer is already active");
             active = true;
             socket.Bind(endPoint);
         }
 
-        public IConnection Connect(EndPoint endPoint)
+        public IConnection Connect(IEndPoint endPoint)
         {
             if (active) throw new InvalidOperationException("Peer is already active");
 
@@ -163,7 +162,7 @@ internal void SendUnreliable(Connection connection, byte[] packet, int offset, i
             }
         }
 
-        internal void SendCommandUnconnected(EndPoint endPoint, Commands command, byte? extra = null)
+        internal void SendCommandUnconnected(IEndPoint endPoint, Commands command, byte? extra = null)
         {
             using (ByteBuffer buffer = bufferPool.Take())
             {
@@ -238,7 +237,7 @@ private void ReceiveLoop()
             {
                 while (socket.Poll())
                 {
-                    int length = socket.Receive(buffer.array, out EndPoint receiveEndPoint);
+                    int length = socket.Receive(buffer.array, out IEndPoint receiveEndPoint);
 
                     // this should never happen. buffer size is only MTU, if socket returns higher length then it has a bug.
                     if (length > config.MaxPacketSize)
@@ -357,7 +356,7 @@ private void HandleCommand(Connection connection, Packet packet)
             }
         }
 
-        private void HandleNewConnection(EndPoint endPoint, Packet packet)
+        private void HandleNewConnection(IEndPoint endPoint, Packet packet)
         {
             // if invalid, then reject without reason
             if (!Validate(packet)) { return; }
@@ -403,7 +402,7 @@ private bool AtMaxConnections()
         {
             return connections.Count >= config.MaxConnections;
         }
-        private void AcceptNewConnection(EndPoint endPoint)
+        private void AcceptNewConnection(IEndPoint endPoint)
         {
             if (logger.IsLogTypeAllowed(LogType.Log)) logger.Log($"Accepting new connection from:{endPoint}");
 
@@ -412,7 +411,7 @@ private void AcceptNewConnection(EndPoint endPoint)
             HandleConnectionRequest(connection);
         }
 
-        private Connection CreateNewConnection(EndPoint endPoint)
+        private Connection CreateNewConnection(IEndPoint endPoint)
         {
             var connection = new Connection(this, endPoint, dataHandler, config, time, bufferPool, logger, metrics);
             connection.SetReceiveTime();
@@ -443,7 +442,7 @@ private void HandleConnectionRequest(Connection connection)
         }
 
 
-        private void RejectConnectionWithReason(EndPoint endPoint, RejectReason reason)
+        private void RejectConnectionWithReason(IEndPoint endPoint, RejectReason reason)
         {
             SendCommandUnconnected(endPoint, Commands.ConnectionRejected, (byte)reason);
         }
diff --git a/Assets/Mirage/Runtime/SocketLayer/SocketFactory.cs b/Assets/Mirage/Runtime/SocketLayer/SocketFactory.cs
index ae0421076b4..5fef17a38cc 100644
--- a/Assets/Mirage/Runtime/SocketLayer/SocketFactory.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/SocketFactory.cs
@@ -20,7 +20,7 @@ public abstract class SocketFactory : MonoBehaviour
         public abstract ISocket CreateServerSocket();
 
         /// <summary>Creates the <see cref="EndPoint"/> that the Server Socket will bind to</summary>
-        public abstract EndPoint GetBindEndPoint();
+        public abstract IEndPoint GetBindEndPoint();
 
 
         /// <summary>Creates a <see cref="ISocket"/> to be used by <see cref="Peer"/> on the client</summary>
@@ -28,6 +28,6 @@ public abstract class SocketFactory : MonoBehaviour
         public abstract ISocket CreateClientSocket();
 
         /// <summary>Creates the <see cref="EndPoint"/> that the Client Socket will connect to using the parameter given</summary>
-        public abstract EndPoint GetConnectEndPoint(string address = null, ushort? port = null);
+        public abstract IEndPoint GetConnectEndPoint(string address = null, ushort? port = null);
     }
 }
diff --git a/Assets/Mirage/Runtime/Sockets/Udp/UdpSocketFactory.cs b/Assets/Mirage/Runtime/Sockets/Udp/UdpSocketFactory.cs
index dcc5b0edd56..5dc0c456a44 100644
--- a/Assets/Mirage/Runtime/Sockets/Udp/UdpSocketFactory.cs
+++ b/Assets/Mirage/Runtime/Sockets/Udp/UdpSocketFactory.cs
@@ -25,19 +25,19 @@ public override ISocket CreateServerSocket()
             return new UdpSocket();
         }
 
-        public override EndPoint GetBindEndPoint()
+        public override IEndPoint GetBindEndPoint()
         {
-            return new IPEndPoint(IPAddress.IPv6Any, port);
+            return new EndPointWrapper(new IPEndPoint(IPAddress.IPv6Any, port));
         }
 
-        public override EndPoint GetConnectEndPoint(string address = null, ushort? port = null)
+        public override IEndPoint GetConnectEndPoint(string address = null, ushort? port = null)
         {
             string addressString = address ?? this.address;
             IPAddress ipAddress = getAddress(addressString);
 
             ushort portIn = port ?? (ushort)this.port;
 
-            return new IPEndPoint(ipAddress, portIn);
+            return new EndPointWrapper(new IPEndPoint(ipAddress, portIn));
         }
 
         private IPAddress getAddress(string addressString)
@@ -67,24 +67,60 @@ void ThrowIfNotSupported()
         private static bool IsWebgl => Application.platform == RuntimePlatform.WebGLPlayer;
     }
 
+    public class EndPointWrapper : IEndPoint
+    {
+        public EndPoint inner;
+
+        public EndPointWrapper(EndPoint endPoint)
+        {
+            inner = endPoint;
+        }
+
+        public override bool Equals(object obj)
+        {
+            if (obj is EndPointWrapper other)
+            {
+                return inner.Equals(other.inner);
+            }
+            return false;
+        }
+
+        public override int GetHashCode()
+        {
+            return inner.GetHashCode();
+        }
+
+        public override string ToString()
+        {
+            return inner.ToString();
+        }
+
+        IEndPoint IEndPoint.CreateCopy()
+        {
+            // copy the inner endpoint
+            EndPoint copy = inner.Create(inner.Serialize());
+            return new EndPointWrapper(copy);
+        }
+    }
+
     public class UdpSocket : ISocket
     {
         Socket socket;
-        IPEndPoint AnyEndpoint;
+        EndPointWrapper Endpoint;
 
-        public void Bind(EndPoint endPoint)
+        public void Bind(IEndPoint endPoint)
         {
-            AnyEndpoint = endPoint as IPEndPoint;
+            Endpoint = (EndPointWrapper)endPoint;
 
-            socket = CreateSocket(endPoint);
+            socket = CreateSocket(Endpoint.inner);
             socket.DualMode = true;
-
-            socket.Bind(endPoint);
+            socket.Bind(Endpoint.inner);
         }
 
         static Socket CreateSocket(EndPoint endPoint)
         {
-            var socket = new Socket(endPoint.AddressFamily, SocketType.Dgram, ProtocolType.Udp)
+            var ipEndPoint = (IPEndPoint)endPoint;
+            var socket = new Socket(ipEndPoint.AddressFamily, SocketType.Dgram, ProtocolType.Udp)
             {
                 Blocking = false,
             };
@@ -126,13 +162,12 @@ private static void TrySetIOControl(Socket socket)
             }
         }
 
-        public void Connect(EndPoint endPoint)
+        public void Connect(IEndPoint endPoint)
         {
-            AnyEndpoint = endPoint as IPEndPoint;
+            Endpoint = (EndPointWrapper)endPoint;
 
-            socket = CreateSocket(endPoint);
-
-            socket.Connect(endPoint);
+            socket = CreateSocket(Endpoint.inner);
+            socket.Connect(Endpoint.inner);
         }
 
         public void Close()
@@ -150,18 +185,20 @@ public bool Poll()
             return socket.Poll(0, SelectMode.SelectRead);
         }
 
-        public int Receive(byte[] buffer, out EndPoint endPoint)
+        public int Receive(byte[] buffer, out IEndPoint endPoint)
         {
-            endPoint = AnyEndpoint;
-            int c = socket.ReceiveFrom(buffer, ref endPoint);
+            int c = socket.ReceiveFrom(buffer, ref Endpoint.inner);
+            endPoint = Endpoint;
             return c;
         }
 
-        public void Send(EndPoint endPoint, byte[] packet, int length)
+        public void Send(IEndPoint endPoint, byte[] packet, int length)
         {
             // todo check disconnected
             // todo what SocketFlags??
-            socket.SendTo(packet, length, SocketFlags.None, endPoint);
+
+            EndPoint netEndPoint = ((EndPointWrapper)endPoint).inner;
+            socket.SendTo(packet, length, SocketFlags.None, netEndPoint);
         }
     }
 }
diff --git a/Assets/Tests/Common/Mirage.Tests.Common.asmdef b/Assets/Tests/Common/Mirage.Tests.Common.asmdef
index db9efc85b0e..f2ca60eee22 100644
--- a/Assets/Tests/Common/Mirage.Tests.Common.asmdef
+++ b/Assets/Tests/Common/Mirage.Tests.Common.asmdef
@@ -13,7 +13,8 @@
     "overrideReferences": true,
     "precompiledReferences": [
         "nunit.framework.dll",
-        "NSubstitute.dll"
+        "NSubstitute.dll",
+        "System.Threading.Tasks.Extensions.dll"
     ],
     "autoReferenced": false,
     "defineConstraints": [
diff --git a/Assets/Tests/Common/TestSocketFactory.cs b/Assets/Tests/Common/TestSocketFactory.cs
index d0c21d7c8e0..5256e37ba48 100644
--- a/Assets/Tests/Common/TestSocketFactory.cs
+++ b/Assets/Tests/Common/TestSocketFactory.cs
@@ -1,10 +1,8 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
-using System.Net;
 using Mirage.SocketLayer;
 using NSubstitute;
-using UnityEngine;
 
 namespace Mirage.Tests
 {
@@ -16,14 +14,14 @@ public class TestSocket : ISocket
         /// <summary>
         /// this static dictionary will act as the internet
         /// </summary>
-        public static Dictionary<EndPoint, TestSocket> allSockets = new Dictionary<EndPoint, TestSocket>();
+        public static Dictionary<IEndPoint, TestSocket> allSockets = new Dictionary<IEndPoint, TestSocket>();
 
         /// <summary>
         /// Can be useful to fake timeouts or dropped messages
         /// </summary>
         public static bool StopAllMessages;
 
-        public static bool EndpointInUse(EndPoint endPoint) => allSockets.ContainsKey(endPoint);
+        public static bool EndpointInUse(IEndPoint endPoint) => allSockets.ContainsKey(endPoint);
 
         /// <summary>
         /// adds this socket as an option to receive data
@@ -44,26 +42,26 @@ private void AddThisSocket()
         }
 
 
-        public readonly EndPoint endPoint;
+        public readonly IEndPoint endPoint;
 
         readonly Queue<Packet> received = new Queue<Packet>();
         public List<Packet> Sent = new List<Packet>();
 
         public readonly string name;
 
-        public TestSocket(string name, EndPoint endPoint = null)
+        public TestSocket(string name, IEndPoint endPoint = null)
         {
             this.name = name;
-            this.endPoint = endPoint ?? Substitute.For<EndPoint>();
+            this.endPoint = endPoint ?? TestEndPoint.CreateSubstitute();
         }
 
 
-        void ISocket.Bind(EndPoint endPoint)
+        void ISocket.Bind(IEndPoint endPoint)
         {
             AddThisSocket();
         }
 
-        void ISocket.Connect(EndPoint endPoint)
+        void ISocket.Connect(IEndPoint endPoint)
         {
             AddThisSocket();
         }
@@ -78,17 +76,17 @@ bool ISocket.Poll()
             return received.Count > 0;
         }
 
-        int ISocket.Receive(byte[] data, out EndPoint endPoint)
+        int ISocket.Receive(byte[] buffer, out IEndPoint endPoint)
         {
             Packet next = received.Dequeue();
             endPoint = next.endPoint;
             int length = next.length;
 
-            Buffer.BlockCopy(next.data, 0, data, 0, length);
+            Buffer.BlockCopy(next.data, 0, buffer, 0, length);
             return length;
         }
 
-        void ISocket.Send(EndPoint remoteEndPoint, byte[] data, int length)
+        void ISocket.Send(IEndPoint remoteEndPoint, byte[] packet, int length)
         {
             AddThisSocket();
 
@@ -99,7 +97,7 @@ void ISocket.Send(EndPoint remoteEndPoint, byte[] data, int length)
             }
 
             // create copy because data is from buffer
-            byte[] clone = data.Take(length).ToArray();
+            byte[] clone = packet.Take(length).ToArray();
             Sent.Add(new Packet
             {
                 endPoint = remoteEndPoint,
@@ -121,16 +119,25 @@ void ISocket.Send(EndPoint remoteEndPoint, byte[] data, int length)
 
         public struct Packet
         {
-            public EndPoint endPoint;
+            public IEndPoint endPoint;
             public byte[] data;
             public int length;
         }
     }
 
+    public static class TestEndPoint
+    {
+        public static IEndPoint CreateSubstitute()
+        {
+            IEndPoint endpoint = Substitute.For<IEndPoint>();
+            endpoint.CreateCopy().Returns(endpoint);
+            return endpoint;
+        }
+    }
 
     public class TestSocketFactory : SocketFactory
     {
-        public EndPoint serverEndpoint = Substitute.For<EndPoint>();
+        public IEndPoint serverEndpoint = TestEndPoint.CreateSubstitute();
 
         int clientNameIndex;
         int serverNameIndex;
@@ -150,12 +157,12 @@ public override ISocket CreateServerSocket()
             return new TestSocket($"Server {serverNameIndex++}", serverEndpoint);
         }
 
-        public override EndPoint GetBindEndPoint()
+        public override IEndPoint GetBindEndPoint()
         {
             return default;
         }
 
-        public override EndPoint GetConnectEndPoint(string address = null, ushort? port = null)
+        public override IEndPoint GetConnectEndPoint(string address = null, ushort? port = null)
         {
             return serverEndpoint;
         }
diff --git a/Assets/Tests/Runtime/ClientServer/NetworkClientDisconnectTest.cs b/Assets/Tests/Runtime/ClientServer/NetworkClientDisconnectTest.cs
index c0f397294ab..3db7e0e8181 100644
--- a/Assets/Tests/Runtime/ClientServer/NetworkClientDisconnectTest.cs
+++ b/Assets/Tests/Runtime/ClientServer/NetworkClientDisconnectTest.cs
@@ -1,6 +1,5 @@
 using System.Collections;
 using System.Linq;
-using System.Net;
 using Mirage.SocketLayer;
 using NUnit.Framework;
 using UnityEngine;
@@ -81,7 +80,7 @@ public IEnumerator DisconnectEventWhenTimeout()
         [UnityTest]
         public IEnumerator DisconnectEventWhenSentInvalidPacket()
         {
-            (ISocket clientSocket, EndPoint serverEndPoint) = GetSocketAndEndPoint();
+            (ISocket clientSocket, IEndPoint serverEndPoint) = GetSocketAndEndPoint();
             byte[] badMessage = CreateInvalidPacket();
 
             clientSocket.Send(serverEndPoint, badMessage, 20);
@@ -100,12 +99,12 @@ public IEnumerator DisconnectEventWhenSentInvalidPacket()
             Assert.That(called, Is.EqualTo(1));
         }
 
-        private (ISocket clientSocket, EndPoint serverEndPoint) GetSocketAndEndPoint()
+        private (ISocket clientSocket, IEndPoint serverEndPoint) GetSocketAndEndPoint()
         {
-            EndPoint clientEndPoint = server.Players.First().Connection.EndPoint;
+            IEndPoint clientEndPoint = server.Players.First().Connection.EndPoint;
             TestSocket clientSocket = TestSocket.allSockets[clientEndPoint];
 
-            EndPoint serverEndPoint = ((TestSocketFactory)server.SocketFactory).serverEndpoint;
+            IEndPoint serverEndPoint = ((TestSocketFactory)server.SocketFactory).serverEndpoint;
 
             return (clientSocket, serverEndPoint);
         }
diff --git a/Assets/Tests/SocketLayer/PeerTest.cs b/Assets/Tests/SocketLayer/PeerTest.cs
index e0a4d0c2c0d..bc5bdbb748c 100644
--- a/Assets/Tests/SocketLayer/PeerTest.cs
+++ b/Assets/Tests/SocketLayer/PeerTest.cs
@@ -1,5 +1,5 @@
 using System;
-using System.Net;
+using Mirage.Tests;
 using NSubstitute;
 using NUnit.Framework;
 using UnityEngine;
@@ -68,7 +68,7 @@ public void CloseShouldCallSocketClose()
         [Test]
         public void IgnoresMessageThatIsTooShort()
         {
-            peer.Bind(Substitute.For<EndPoint>());
+            peer.Bind(TestEndPoint.CreateSubstitute());
 
             Action<IConnection> connectAction = Substitute.For<Action<IConnection>>();
             peer.OnConnected += connectAction;
@@ -87,7 +87,7 @@ public void IgnoresMessageThatIsTooShort()
         [Test]
         public void ThrowsIfSocketGivesLengthThatIsTooHigh()
         {
-            peer.Bind(Substitute.For<EndPoint>());
+            peer.Bind(TestEndPoint.CreateSubstitute());
 
             Action<IConnection> connectAction = Substitute.For<Action<IConnection>>();
             peer.OnConnected += connectAction;
@@ -107,12 +107,12 @@ public void ThrowsIfSocketGivesLengthThatIsTooHigh()
         [Repeat(10)]
         public void IgnoresRandomData()
         {
-            peer.Bind(Substitute.For<EndPoint>());
+            peer.Bind(TestEndPoint.CreateSubstitute());
 
             Action<IConnection> connectAction = Substitute.For<Action<IConnection>>();
             peer.OnConnected += connectAction;
 
-            EndPoint endPoint = Substitute.For<EndPoint>();
+            IEndPoint endPoint = TestEndPoint.CreateSubstitute();
 
             // 2 is min length of a message
             byte[] randomData = new byte[UnityEngine.Random.Range(2, 20)];
diff --git a/Assets/Tests/SocketLayer/PeerTestAsClient.cs b/Assets/Tests/SocketLayer/PeerTestAsClient.cs
index 2e3f5b7415d..d026b0db439 100644
--- a/Assets/Tests/SocketLayer/PeerTestAsClient.cs
+++ b/Assets/Tests/SocketLayer/PeerTestAsClient.cs
@@ -1,6 +1,6 @@
 using System;
 using System.Collections;
-using System.Net;
+using Mirage.Tests;
 using NSubstitute;
 using NUnit.Framework;
 using UnityEngine;
@@ -14,7 +14,7 @@ public class PeerTestAsClient : PeerTestBase
         [Test]
         public void ConnectShouldSendMessageToSocket()
         {
-            EndPoint endPoint = Substitute.For<EndPoint>();
+            IEndPoint endPoint = TestEndPoint.CreateSubstitute();
             peer.Connect(endPoint);
 
             byte[] expected = connectRequest;
@@ -29,7 +29,7 @@ public void ConnectShouldSendMessageToSocket()
         [Test]
         public void ConnectShouldReturnANewConnection()
         {
-            EndPoint endPoint = Substitute.For<EndPoint>();
+            IEndPoint endPoint = TestEndPoint.CreateSubstitute();
             IConnection conn = peer.Connect(endPoint);
             Assert.That(conn, Is.TypeOf<Connection>(), "returned type should be connection");
             Assert.That(conn.State, Is.EqualTo(ConnectionState.Connecting), "new connection should be connecting");
@@ -45,7 +45,7 @@ public void InvokesConnectEventAfterReceiveingAcccept()
         [UnityTest]
         public IEnumerator ShouldResendConnectMessageIfNoReply()
         {
-            EndPoint endPoint = Substitute.For<EndPoint>();
+            IEndPoint endPoint = TestEndPoint.CreateSubstitute();
             _ = peer.Connect(endPoint);
 
             byte[] expected = connectRequest;
@@ -86,7 +86,7 @@ public IEnumerator ShouldResendConnectMessageIfNoReply()
         [UnityTest]
         public IEnumerator ShouldInvokeConnectionFailedIfNoReplyAfterMax()
         {
-            EndPoint endPoint = Substitute.For<EndPoint>();
+            IEndPoint endPoint = TestEndPoint.CreateSubstitute();
             IConnection conn = peer.Connect(endPoint);
 
             // wait enough time so that  would have been called
@@ -106,7 +106,7 @@ public IEnumerator ShouldInvokeConnectionFailedIfNoReplyAfterMax()
         [Test]
         public void ShouldInvokeConnectionFailedIfServerRejects()
         {
-            EndPoint endPoint = Substitute.For<EndPoint>();
+            IEndPoint endPoint = TestEndPoint.CreateSubstitute();
             IConnection conn = peer.Connect(endPoint);
 
             socket.SetupReceiveCall(new byte[3] {
@@ -125,7 +125,7 @@ public void ShouldInvokeConnectionFailedIfServerRejects()
         [UnityTest]
         public IEnumerator InvokesConnectFailedIfClosedBeforeConnect()
         {
-            EndPoint endPoint = Substitute.For<EndPoint>();
+            IEndPoint endPoint = TestEndPoint.CreateSubstitute();
             IConnection conn = peer.Connect(endPoint);
 
             peer.Close();
@@ -154,7 +154,7 @@ public void CloseSendsDisconnectMessageIfConnected()
             // todo test as client with 1 connection
             Assert.Ignore("new NotImplementedException(What should happen if close / disconnect is called while still connecting)");
 
-            EndPoint endPoint = Substitute.For<EndPoint>();
+            IEndPoint endPoint = TestEndPoint.CreateSubstitute();
             IConnection conn = peer.Connect(endPoint);
 
             peer.Close();
@@ -176,13 +176,13 @@ public void CloseSendsDisconnectMessageIfConnected()
         public void IgnoresRequestToConnect()
         {
             Assert.Ignore("not implemented");
-            peer.Connect(Substitute.For<EndPoint>());
+            peer.Connect(TestEndPoint.CreateSubstitute());
 
             Action<IConnection> connectAction = Substitute.For<Action<IConnection>>();
             peer.OnConnected += connectAction;
 
             byte[] expected = connectRequest;
-            EndPoint endPoint = Substitute.For<EndPoint>();
+            IEndPoint endPoint = TestEndPoint.CreateSubstitute();
             socket.SetupReceiveCall(expected, endPoint);
             peer.Update();
 
diff --git a/Assets/Tests/SocketLayer/PeerTestAsServer.cs b/Assets/Tests/SocketLayer/PeerTestAsServer.cs
index ab0b2dd5224..aa3ec4fe725 100644
--- a/Assets/Tests/SocketLayer/PeerTestAsServer.cs
+++ b/Assets/Tests/SocketLayer/PeerTestAsServer.cs
@@ -1,5 +1,5 @@
 using System;
-using System.Net;
+using Mirage.Tests;
 using NSubstitute;
 using NUnit.Framework;
 using UnityEngine;
@@ -12,7 +12,7 @@ public class PeerTestAsServer : PeerTestBase
         [Test]
         public void BindShoudlCallSocketBind()
         {
-            EndPoint endPoint = Substitute.For<EndPoint>();
+            IEndPoint endPoint = TestEndPoint.CreateSubstitute();
             peer.Bind(endPoint);
 
             socket.Received(1).Bind(Arg.Is(endPoint));
@@ -21,13 +21,13 @@ public void BindShoudlCallSocketBind()
         [Test]
         public void CloseSendsDisconnectMessageToAllConnections()
         {
-            EndPoint endPoint = Substitute.For<EndPoint>();
+            IEndPoint endPoint = TestEndPoint.CreateSubstitute();
             peer.Bind(endPoint);
 
-            var endPoints = new EndPoint[maxConnections];
+            var endPoints = new IEndPoint[maxConnections];
             for (int i = 0; i < maxConnections; i++)
             {
-                endPoints[i] = Substitute.For<EndPoint>();
+                endPoints[i] = TestEndPoint.CreateSubstitute();
 
                 socket.SetupReceiveCall(connectRequest, endPoints[i]);
                 peer.Update();
@@ -59,12 +59,12 @@ public void CloseSendsDisconnectMessageToAllConnections()
         [Test]
         public void AcceptsConnectionForValidMessage()
         {
-            peer.Bind(Substitute.For<EndPoint>());
+            peer.Bind(TestEndPoint.CreateSubstitute());
 
             Action<IConnection> connectAction = Substitute.For<Action<IConnection>>();
             peer.OnConnected += connectAction;
 
-            EndPoint endPoint = Substitute.For<EndPoint>();
+            IEndPoint endPoint = TestEndPoint.CreateSubstitute();
             socket.SetupReceiveCall(connectRequest, endPoint);
             peer.Update();
 
@@ -80,16 +80,16 @@ public void AcceptsConnectionForValidMessage()
         [Test]
         public void AcceptsConnectionsUpToMax()
         {
-            peer.Bind(Substitute.For<EndPoint>());
+            peer.Bind(TestEndPoint.CreateSubstitute());
 
             Action<IConnection> connectAction = Substitute.For<Action<IConnection>>();
             peer.OnConnected += connectAction;
 
 
-            var endPoints = new EndPoint[maxConnections];
+            var endPoints = new IEndPoint[maxConnections];
             for (int i = 0; i < maxConnections; i++)
             {
-                endPoints[i] = Substitute.For<EndPoint>();
+                endPoints[i] = TestEndPoint.CreateSubstitute();
 
                 socket.SetupReceiveCall(connectRequest, endPoints[i]);
                 peer.Update();
@@ -111,7 +111,7 @@ public void AcceptsConnectionsUpToMax()
         [Test]
         public void RejectsConnectionOverMax()
         {
-            peer.Bind(Substitute.For<EndPoint>());
+            peer.Bind(TestEndPoint.CreateSubstitute());
 
             Action<IConnection> connectAction = Substitute.For<Action<IConnection>>();
             peer.OnConnected += connectAction;
@@ -126,7 +126,7 @@ public void RejectsConnectionOverMax()
             socket.ClearReceivedCalls();
             connectAction.ClearReceivedCalls();
 
-            EndPoint overMaxEndpoint = Substitute.For<EndPoint>();
+            IEndPoint overMaxEndpoint = TestEndPoint.CreateSubstitute();
             socket.SetupReceiveCall(connectRequest, overMaxEndpoint);
 
 
@@ -152,7 +152,7 @@ public void RejectsConnectionOverMax()
         [Test, Description("Should reject with no reason given")]
         public void IgnoresMessageThatIsInvalid()
         {
-            peer.Bind(Substitute.For<EndPoint>());
+            peer.Bind(TestEndPoint.CreateSubstitute());
 
             Action<IConnection> connectAction = Substitute.For<Action<IConnection>>();
             peer.OnConnected += connectAction;
diff --git a/Assets/Tests/SocketLayer/PeerTestBase.cs b/Assets/Tests/SocketLayer/PeerTestBase.cs
index 07f516ba7b2..d51ded3cc0a 100644
--- a/Assets/Tests/SocketLayer/PeerTestBase.cs
+++ b/Assets/Tests/SocketLayer/PeerTestBase.cs
@@ -1,5 +1,4 @@
 using System;
-using System.Net;
 using Mirage.Tests;
 using NSubstitute;
 using NUnit.Framework;
@@ -85,7 +84,7 @@ public class PeerInstanceWithSocket : PeerInstance
         /// <summary>
         /// endpoint that other sockets use to send to this
         /// </summary>
-        public EndPoint endPoint;
+        public IEndPoint endPoint;
 
         public PeerInstanceWithSocket(Config config = null) : base(config, socket: new TestSocket("TestInstance"))
         {
@@ -121,12 +120,12 @@ public static class ArgCollection
             return true;
         }
 
-        public static void SetupReceiveCall(this ISocket socket, byte[] data, EndPoint endPoint = null, int? length = null)
+        public static void SetupReceiveCall(this ISocket socket, byte[] data, IEndPoint endPoint = null, int? length = null)
         {
             socket.Poll().Returns(true, false);
             socket
                // when any call
-               .When(x => x.Receive(Arg.Any<byte[]>(), out Arg.Any<EndPoint>()))
+               .When(x => x.Receive(Arg.Any<byte[]>(), out Arg.Any<IEndPoint>()))
                // return the data from endpoint
                .Do(x =>
                {
@@ -135,9 +134,9 @@ public static void SetupReceiveCall(this ISocket socket, byte[] data, EndPoint e
                    {
                        dataArg[i] = data[i];
                    }
-                   x[1] = endPoint ?? Substitute.For<EndPoint>();
+                   x[1] = endPoint ?? TestEndPoint.CreateSubstitute();
                });
-            socket.Receive(Arg.Any<byte[]>(), out Arg.Any<EndPoint>()).Returns(length ?? data.Length);
+            socket.Receive(Arg.Any<byte[]>(), out Arg.Any<IEndPoint>()).Returns(length ?? data.Length);
         }
     }
 }
diff --git a/Assets/Tests/SocketLayer/PeerTestConnecting.cs b/Assets/Tests/SocketLayer/PeerTestConnecting.cs
index d0c9bad7838..5e508070d77 100644
--- a/Assets/Tests/SocketLayer/PeerTestConnecting.cs
+++ b/Assets/Tests/SocketLayer/PeerTestConnecting.cs
@@ -29,7 +29,7 @@ public void SetUp()
         [Test]
         public void ServerAcceptsAllClients()
         {
-            server.peer.Bind(Substitute.For<EndPoint>());
+            server.peer.Bind(TestEndPoint.CreateSubstitute());
 
             Action<IConnection> connectAction = Substitute.For<Action<IConnection>>();
             server.peer.OnConnected += connectAction;
@@ -71,7 +71,7 @@ public void ServerAcceptsAllClients()
         [Test]
         public void EachServerConnectionIsANewInstance()
         {
-            server.peer.Bind(Substitute.For<EndPoint>());
+            server.peer.Bind(TestEndPoint.CreateSubstitute());
             var serverConnections = new List<IConnection>();
 
             Action<IConnection> connectAction = (conn) =>
diff --git a/Assets/Tests/SocketLayer/PeerTestSendReceive.cs b/Assets/Tests/SocketLayer/PeerTestSendReceive.cs
index da4f419ac45..5b1bb55333e 100644
--- a/Assets/Tests/SocketLayer/PeerTestSendReceive.cs
+++ b/Assets/Tests/SocketLayer/PeerTestSendReceive.cs
@@ -2,7 +2,7 @@
 using System.Collections;
 using System.Collections.Generic;
 using System.Linq;
-using System.Net;
+using Mirage.Tests;
 using NSubstitute;
 using NUnit.Framework;
 using UnityEngine.TestTools;
@@ -38,7 +38,7 @@ public void SetUp()
             Action<IConnection> serverConnect = (conn) => serverConnections.Add(conn);
             server.peer.OnConnected += serverConnect;
 
-            server.peer.Bind(Substitute.For<EndPoint>());
+            server.peer.Bind(TestEndPoint.CreateSubstitute());
             for (int i = 0; i < ClientCount; i++)
             {
                 clients[i] = new PeerInstanceWithSocket(config);

From c3b444861d87c32a571bf2c805ffef8f78413d53 Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Fri, 2 Jul 2021 16:17:18 +0000
Subject: [PATCH 040/166] chore(release): 98.0.0 [skip ci]

# [98.0.0](https://github.com/MirageNet/Mirage/compare/v97.1.2...v98.0.0) (2021-07-02)

### Performance Improvements

* improving how socketlayer handles endpoints ([#856](https://github.com/MirageNet/Mirage/issues/856)) ([59ce7e0](https://github.com/MirageNet/Mirage/commit/59ce7e097d46d7f2cb7eaa01736dde36066396c5))

### BREAKING CHANGES

* Socket functions now use an interface instead of the EndPoint class, Socket Implementations should create a custom Endpoint class for their socket.
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs         |  2 +-
 Assets/Mirage/CHANGELOG.md                           | 12 ++++++++++++
 Assets/Mirage/Components/AssemblyInfo.cs             |  2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                |  2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs    |  2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs               |  2 +-
 .../RigidbodyPhysics/Scripts/AssemblyInfo.cs         |  2 +-
 Assets/Mirage/package.json                           |  2 +-
 8 files changed, 19 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index f7cb55869ad..372109992b2 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("97.1.2")]
+[assembly: AssemblyVersion("98.0.0")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index abfdd262280..f1521dd605c 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,15 @@
+# [98.0.0](https://github.com/MirageNet/Mirage/compare/v97.1.2...v98.0.0) (2021-07-02)
+
+
+### Performance Improvements
+
+* improving how socketlayer handles endpoints ([#856](https://github.com/MirageNet/Mirage/issues/856)) ([59ce7e0](https://github.com/MirageNet/Mirage/commit/59ce7e097d46d7f2cb7eaa01736dde36066396c5))
+
+
+### BREAKING CHANGES
+
+* Socket functions now use an interface instead of the EndPoint class, Socket Implementations should create a custom Endpoint class for their socket.
+
 ## [97.1.2](https://github.com/MirageNet/Mirage/compare/v97.1.1...v97.1.2) (2021-07-01)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index 7f2f2219d1d..18b9c5755cc 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("97.1.2")]
+[assembly: AssemblyVersion("98.0.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index 3079d41d0ca..8675cfa56d8 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("97.1.2")]
+[assembly: AssemblyVersion("98.0.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index 2e0f1f817f8..4104b944c1e 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("97.1.2")]
+[assembly: AssemblyVersion("98.0.0")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index f7cb55869ad..372109992b2 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("97.1.2")]
+[assembly: AssemblyVersion("98.0.0")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index f7cb55869ad..372109992b2 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("97.1.2")]
+[assembly: AssemblyVersion("98.0.0")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 670fe30de7c..485973f37e4 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "97.1.2",
+    "version": "98.0.0",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From a89bae8024bc0397145bd15a4aa08c807cd0610e Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Fri, 2 Jul 2021 20:33:15 +0100
Subject: [PATCH 041/166] ci: running tests in debug mode for code coverage
 (#858)

fixes coverage when using aggressive inlining
---
 .github/workflows/main.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
index 9e9feb18b4d..5adb70864e2 100644
--- a/.github/workflows/main.yml
+++ b/.github/workflows/main.yml
@@ -46,11 +46,11 @@ jobs:
           apt install -y openjdk-11-jre-headless=11.0.11+9-0ubuntu2~18.04
 
       - name: Run editor Tests
-        run: unity-editor -nographics -logFile /dev/stdout -runTests -testPlatform editmode -testResults Tests/editmode-results.xml -enableCodeCoverage -coverageResultsPath Tests
+        run: unity-editor -nographics -logFile /dev/stdout -runTests -testPlatform editmode -testResults Tests/editmode-results.xml -enableCodeCoverage -coverageResultsPath Tests -debugCodeOptimization 
         timeout-minutes: 20
         
       - name: Run play Tests
-        run: unity-editor -nographics -logFile /dev/stdout -runTests -testPlatform playmode -testResults Tests/playmode-results.xml -enableCodeCoverage -coverageResultsPath Tests
+        run: unity-editor -nographics -logFile /dev/stdout -runTests -testPlatform playmode -testResults Tests/playmode-results.xml -enableCodeCoverage -coverageResultsPath Tests -debugCodeOptimization 
         timeout-minutes: 20
 
       - name: Archive test results

From 773c58f75eb77be2a893398d1e27012ee9ba83e6 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Fri, 2 Jul 2021 21:06:06 +0100
Subject: [PATCH 042/166] perf: replacing network writer with a faster version
 that can do bit packing (#805)

BREAKING: NetworkWriter and NetworkReader have been completely re-written to support bitpacking
---
 Assets/Mirage/Mirage.asmdef                   |   2 +-
 Assets/Mirage/Runtime/NetworkClient.cs        |   7 +-
 Assets/Mirage/Runtime/NetworkDiagnostics.cs   |  10 +-
 Assets/Mirage/Runtime/NetworkIdentity.cs      |  13 +-
 Assets/Mirage/Runtime/NetworkPlayer.cs        |   2 +-
 Assets/Mirage/Runtime/NetworkServer.cs        |   2 +
 .../Mirage/Runtime/Serialization/BitMask.cs   |  62 +++
 .../Runtime/Serialization/BitMask.cs.meta}    |   2 +-
 .../Serialization/CollectionExtensions.cs     |   6 +-
 .../Runtime/Serialization/Compression.cs      |   2 +-
 .../GenericTypesSerializationExtensions.cs    |  65 +++
 ...nericTypesSerializationExtensions.cs.meta} |   2 +-
 .../Runtime/Serialization/NetworkReader.cs    | 389 +++++++++++----
 .../Serialization/NetworkReaderPool.cs        | 152 ++----
 .../Runtime/Serialization/NetworkWriter.cs    | 451 +++++++++++++-----
 .../Serialization/NetworkWriterPool.cs        | 120 ++---
 .../Runtime/Serialization/StringExtensions.cs |  16 +-
 .../Serialization/SystemTypesExtensions.cs    |  87 +++-
 .../Runtime/Serialization/TypeConversion.cs   |  47 --
 .../Mirage/Runtime/SocketLayer/AckSystem.cs   |   4 +-
 .../Mirage/Runtime/SocketLayer/ByteBuffer.cs  |  32 ++
 .../Runtime/SocketLayer/ByteBuffer.cs.meta}   |   2 +-
 .../Mirage/Runtime/SocketLayer/Connection.cs  |   2 +-
 Assets/Mirage/Runtime/SocketLayer/Peer.cs     |   6 +-
 .../SocketLayer/{BufferPool.cs => Pool.cs}    |  80 ++--
 .../{BufferPool.cs.meta => Pool.cs.meta}      |   0
 .../Weaver/Processors/ClientRpcProcessor.cs   |   9 +-
 .../Weaver/Processors/NetworkWriterHelper.cs  |  26 +
 .../Processors/NetworkWriterHelper.cs.meta    |  11 +
 .../Processors/ReaderWriterProcessor.cs       |   4 +-
 .../Weaver/Processors/ServerRpcProcessor.cs   |   4 +-
 .../Editor/NetworkIdentityCallbackTests.cs    |  12 +-
 Assets/Tests/Editor/NetworkTransformTest.cs   |  15 +-
 .../Runtime/Collections/SyncDictionaryTest.cs |  66 +--
 .../Runtime/Collections/SyncListClassTest.cs  |  12 +-
 .../Runtime/Collections/SyncListStructTest.cs |  14 +-
 .../Tests/Runtime/Collections/SyncListTest.cs |  96 ++--
 .../Tests/Runtime/Collections/SyncSetTest.cs  |  62 +--
 .../Runtime/Host/NetworkIdentityTests.cs      |   2 +-
 Assets/Tests/Runtime/MessagePackerTest.cs     |  19 +-
 .../Tests/Runtime/Mirage.Tests.Runtime.asmdef |   2 +-
 .../Serialization/ArraySegmentWriterTest.cs   | 141 +++---
 .../BasicAuthenticatorMessagesTest.cs         |  14 +-
 .../Serialization/BitMaskHelperTests.cs       |  54 +++
 .../Serialization/BitMaskHelperTests.cs.meta  |  11 +
 .../BitPackingCopyFromOtherTests.cs           | 148 ++++++
 .../BitPackingCopyFromOtherTests.cs.meta      |  11 +
 .../Serialization/BitPackingProperties.cs     | 110 +++++
 .../BitPackingProperties.cs.meta              |  11 +
 .../BitPackingReusingWriterTests.cs           | 159 ++++++
 .../BitPackingReusingWriterTests.cs.meta      |  11 +
 .../Runtime/Serialization/BitPackingTests.cs  | 194 ++++++++
 .../Serialization/BitPackingTests.cs.meta     |  11 +
 .../Runtime/Serialization/CompressionTests.cs |   2 -
 .../Serialization/EnumReadWriteTests.cs       |  19 +-
 .../Serialization/MessageInheritanceTest.cs   |  39 +-
 .../Serialization/NetworkPlayerTest.cs        |   3 +-
 .../Serialization/NetworkReaderPoolTest.cs    | 129 -----
 .../Serialization/NetworkReaderTest.cs        |  12 +-
 .../Serialization/NetworkReaderWriterTest.cs  |   7 +-
 .../Serialization/NetworkWriterPoolTest.cs    | 128 -----
 .../Serialization/NetworkWriterTest.cs        | 262 +++++-----
 .../Serialization/StructMessagesTests.cs      |  20 +-
 .../Runtime/Serialization/WeaverIgnoreTest.cs |   6 +-
 Assets/Tests/Runtime/SyncVarTest.cs           |  17 +-
 Assets/Tests/Runtime/SyncVarVirtualTest.cs    |  17 +-
 .../SocketLayer/AckSystem/AckSystemTest.cs    |   6 +-
 Assets/Tests/SocketLayer/BufferPoolTest.cs    | 190 +++++++-
 68 files changed, 2442 insertions(+), 1207 deletions(-)
 create mode 100644 Assets/Mirage/Runtime/Serialization/BitMask.cs
 rename Assets/{Tests/Runtime/Serialization/NetworkReaderPoolTest.cs.meta => Mirage/Runtime/Serialization/BitMask.cs.meta} (83%)
 create mode 100644 Assets/Mirage/Runtime/Serialization/GenericTypesSerializationExtensions.cs
 rename Assets/Mirage/Runtime/Serialization/{TypeConversion.cs.meta => GenericTypesSerializationExtensions.cs.meta} (83%)
 delete mode 100644 Assets/Mirage/Runtime/Serialization/TypeConversion.cs
 create mode 100644 Assets/Mirage/Runtime/SocketLayer/ByteBuffer.cs
 rename Assets/{Tests/Runtime/Serialization/NetworkWriterPoolTest.cs.meta => Mirage/Runtime/SocketLayer/ByteBuffer.cs.meta} (83%)
 rename Assets/Mirage/Runtime/SocketLayer/{BufferPool.cs => Pool.cs} (53%)
 rename Assets/Mirage/Runtime/SocketLayer/{BufferPool.cs.meta => Pool.cs.meta} (100%)
 create mode 100644 Assets/Mirage/Weaver/Processors/NetworkWriterHelper.cs
 create mode 100644 Assets/Mirage/Weaver/Processors/NetworkWriterHelper.cs.meta
 create mode 100644 Assets/Tests/Runtime/Serialization/BitMaskHelperTests.cs
 create mode 100644 Assets/Tests/Runtime/Serialization/BitMaskHelperTests.cs.meta
 create mode 100644 Assets/Tests/Runtime/Serialization/BitPackingCopyFromOtherTests.cs
 create mode 100644 Assets/Tests/Runtime/Serialization/BitPackingCopyFromOtherTests.cs.meta
 create mode 100644 Assets/Tests/Runtime/Serialization/BitPackingProperties.cs
 create mode 100644 Assets/Tests/Runtime/Serialization/BitPackingProperties.cs.meta
 create mode 100644 Assets/Tests/Runtime/Serialization/BitPackingReusingWriterTests.cs
 create mode 100644 Assets/Tests/Runtime/Serialization/BitPackingReusingWriterTests.cs.meta
 create mode 100644 Assets/Tests/Runtime/Serialization/BitPackingTests.cs
 create mode 100644 Assets/Tests/Runtime/Serialization/BitPackingTests.cs.meta
 delete mode 100644 Assets/Tests/Runtime/Serialization/NetworkReaderPoolTest.cs
 delete mode 100644 Assets/Tests/Runtime/Serialization/NetworkWriterPoolTest.cs

diff --git a/Assets/Mirage/Mirage.asmdef b/Assets/Mirage/Mirage.asmdef
index 476c06d2938..c54625edba7 100644
--- a/Assets/Mirage/Mirage.asmdef
+++ b/Assets/Mirage/Mirage.asmdef
@@ -7,7 +7,7 @@
     ],
     "includePlatforms": [],
     "excludePlatforms": [],
-    "allowUnsafeCode": false,
+    "allowUnsafeCode": true,
     "overrideReferences": true,
     "precompiledReferences": [],
     "autoReferenced": true,
diff --git a/Assets/Mirage/Runtime/NetworkClient.cs b/Assets/Mirage/Runtime/NetworkClient.cs
index d54afb741a1..432fe9dd766 100644
--- a/Assets/Mirage/Runtime/NetworkClient.cs
+++ b/Assets/Mirage/Runtime/NetworkClient.cs
@@ -2,6 +2,7 @@
 using System.Net;
 using Mirage.Events;
 using Mirage.Logging;
+using Mirage.Serialization;
 using Mirage.SocketLayer;
 using UnityEngine;
 
@@ -119,7 +120,11 @@ public void Connect(string address = null, ushort? port = null)
             var dataHandler = new DataHandler();
             Metrics = EnablePeerMetrics ? new Metrics() : null;
 
-            peer = new Peer(socket, dataHandler, PeerConfig, LogFactory.GetLogger<Peer>(), Metrics);
+            Config config = PeerConfig ?? new Config();
+
+            NetworkWriterPool.Configure(config.MaxPacketSize);
+
+            peer = new Peer(socket, dataHandler, config, LogFactory.GetLogger<Peer>(), Metrics);
             peer.OnConnected += Peer_OnConnected;
             peer.OnConnectionFailed += Peer_OnConnectionFailed;
             peer.OnDisconnected += Peer_OnDisconnected;
diff --git a/Assets/Mirage/Runtime/NetworkDiagnostics.cs b/Assets/Mirage/Runtime/NetworkDiagnostics.cs
index 2c7fd3e4912..5f6b424fad6 100644
--- a/Assets/Mirage/Runtime/NetworkDiagnostics.cs
+++ b/Assets/Mirage/Runtime/NetworkDiagnostics.cs
@@ -8,7 +8,7 @@ namespace Mirage
     /// A profiler can subscribe to these events and
     /// present the data in a friendly way to the user
     /// </summary>
-    // todo find a way to combime this with new peer metrics for more data
+    // todo find a way to combine this with new peer metrics for more data
     public static class NetworkDiagnostics
     {
         /// <summary>
@@ -79,16 +79,16 @@ internal static T ReadWithDiagnostics<T>(NetworkReader reader)
             var message = default(T);
 
             // record start position for NetworkDiagnostics because reader might contain multiple messages if using batching
-            int startPos = reader.Position;
+            int startPos = reader.BitPosition;
             try
             {
                 message = reader.Read<T>();
             }
             finally
             {
-                int endPos = reader.Position;
-                int byteLength = (endPos - startPos);
-                OnReceive(message, byteLength);
+                int endPos = reader.BitPosition;
+                int byteLength = (endPos - startPos) >> 3;
+                NetworkDiagnostics.OnReceive(message, byteLength);
             }
 
             return message;
diff --git a/Assets/Mirage/Runtime/NetworkIdentity.cs b/Assets/Mirage/Runtime/NetworkIdentity.cs
index 44824b5a5e8..bb7bde5e058 100644
--- a/Assets/Mirage/Runtime/NetworkIdentity.cs
+++ b/Assets/Mirage/Runtime/NetworkIdentity.cs
@@ -823,7 +823,7 @@ void OnSerialize(NetworkBehaviour comp, NetworkWriter writer, bool initialState)
 
                     // remember start position in case we need to copy it into
                     // observers writer too
-                    int startPosition = ownerWriter.Position;
+                    int startBitPosition = ownerWriter.BitPosition;
 
                     // write index as byte [0..255]
                     ownerWriter.WriteByte((byte)i);
@@ -831,7 +831,7 @@ void OnSerialize(NetworkBehaviour comp, NetworkWriter writer, bool initialState)
                     // serialize into ownerWriter first
                     // (owner always gets everything!)
                     OnSerialize(comp, ownerWriter, initialState);
-                    ++ownerWritten;
+                    ownerWritten++;
 
                     // copy into observersWriter too if SyncMode.Observers
                     // -> we copy instead of calling OnSerialize again because
@@ -844,10 +844,9 @@ void OnSerialize(NetworkBehaviour comp, NetworkWriter writer, bool initialState)
                     //    OnSerialize again
                     if (comp.syncMode == SyncMode.Observers)
                     {
-                        var segment = ownerWriter.ToArraySegment();
-                        int length = ownerWriter.Position - startPosition;
-                        observersWriter.WriteBytes(segment.Array, startPosition, length);
-                        ++observersWritten;
+                        int bitLength = ownerWriter.BitPosition - startBitPosition;
+                        observersWriter.CopyFromWriter(ownerWriter, startBitPosition, bitLength);
+                        observersWritten++;
                     }
                 }
             }
@@ -888,7 +887,7 @@ internal void OnDeserializeAll(NetworkReader reader, bool initialState)
             reader.ObjectLocator = Client != null ? Client.World : null;
             // deserialize all components that were received
             NetworkBehaviour[] components = NetworkBehaviours;
-            while (reader.Position < reader.Length)
+            while (reader.CanRead())
             {
                 // read & check index [0..255]
                 byte index = reader.ReadByte();
diff --git a/Assets/Mirage/Runtime/NetworkPlayer.cs b/Assets/Mirage/Runtime/NetworkPlayer.cs
index 07f2aae7829..4879e0f5e7d 100644
--- a/Assets/Mirage/Runtime/NetworkPlayer.cs
+++ b/Assets/Mirage/Runtime/NetworkPlayer.cs
@@ -202,7 +202,7 @@ public void Send<T>(T message, int channelId = Channel.Reliable)
 
         /// <summary>
         /// Sends a block of data
-        /// <para>Only use this method if data has message Id already included, other wise receives wont know how to handle it. Otherwise use <see cref="Send{T}(T, int)"/></para>
+        /// <para>Only use this method if data has message Id already included, otherwise receives wont know how to handle it. Otherwise use <see cref="Send{T}(T, int)"/></para>
         /// </summary>
         /// <param name="segment"></param>
         /// <param name="channelId"></param>
diff --git a/Assets/Mirage/Runtime/NetworkServer.cs b/Assets/Mirage/Runtime/NetworkServer.cs
index 0c4d3fc5b7e..dab62fff284 100644
--- a/Assets/Mirage/Runtime/NetworkServer.cs
+++ b/Assets/Mirage/Runtime/NetworkServer.cs
@@ -216,6 +216,8 @@ public void StartServer(NetworkClient localClient = null)
                 MaxConnections = MaxConnections,
             };
 
+            NetworkWriterPool.Configure(config.MaxPacketSize);
+
             peer = new Peer(socket, dataHandler, config, LogFactory.GetLogger<Peer>(), Metrics);
             peer.OnConnected += Peer_OnConnected;
             peer.OnDisconnected += Peer_OnDisconnected;
diff --git a/Assets/Mirage/Runtime/Serialization/BitMask.cs b/Assets/Mirage/Runtime/Serialization/BitMask.cs
new file mode 100644
index 00000000000..599bf1a0a33
--- /dev/null
+++ b/Assets/Mirage/Runtime/Serialization/BitMask.cs
@@ -0,0 +1,62 @@
+/*
+MIT License
+
+Copyright (c) 2021 James Frowen
+
+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.
+*/
+
+using System.Runtime.CompilerServices;
+
+namespace Mirage.Serialization
+{
+    public static class BitMask
+    {
+        /// <summary>
+        /// Creates mask for <paramref name="bits"/>
+        /// <para>
+        /// (showing 32 bits for simplify, result is 64 bit)
+        /// <br/>
+        /// Example bits = 4 => mask = 00000000_00000000_00000000_00001111
+        /// <br/>
+        /// Example bits = 10 => mask = 00000000_00000000_00000011_11111111
+        /// </para>
+        /// </summary>
+        /// <param name="bits"></param>
+        /// <returns></returns>
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public static ulong Mask(int bits)
+        {
+            return bits == 0 ? 0 : ulong.MaxValue >> (64 - bits);
+        }
+
+        /// <summary>
+        /// Creates Mask either side of start and end
+        /// <para>Note this mask is only valid for start [0..63] and end [0..64]4</para>
+        /// </summary>
+        /// <param name="start"></param>
+        /// <param name="end"></param>
+        /// <returns></returns>
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public static ulong OuterMask(int start, int end)
+        {
+            return (ulong.MaxValue << start) ^ (ulong.MaxValue >> (64 - end));
+        }
+    }
+}
diff --git a/Assets/Tests/Runtime/Serialization/NetworkReaderPoolTest.cs.meta b/Assets/Mirage/Runtime/Serialization/BitMask.cs.meta
similarity index 83%
rename from Assets/Tests/Runtime/Serialization/NetworkReaderPoolTest.cs.meta
rename to Assets/Mirage/Runtime/Serialization/BitMask.cs.meta
index a481d66ccce..97b8c0adb87 100644
--- a/Assets/Tests/Runtime/Serialization/NetworkReaderPoolTest.cs.meta
+++ b/Assets/Mirage/Runtime/Serialization/BitMask.cs.meta
@@ -1,5 +1,5 @@
 fileFormatVersion: 2
-guid: b3be8a791c407cb4b9e2d4e1037b8cfe
+guid: e8ce6cd3bc8829743bc1b67cf937135d
 MonoImporter:
   externalObjects: {}
   serializedVersion: 2
diff --git a/Assets/Mirage/Runtime/Serialization/CollectionExtensions.cs b/Assets/Mirage/Runtime/Serialization/CollectionExtensions.cs
index db4e1acd4cf..b511c2fcfbc 100644
--- a/Assets/Mirage/Runtime/Serialization/CollectionExtensions.cs
+++ b/Assets/Mirage/Runtime/Serialization/CollectionExtensions.cs
@@ -98,7 +98,7 @@ public static ArraySegment<byte> ReadBytesAndSizeSegment(this NetworkReader read
         public static byte[] ReadBytes(this NetworkReader reader, int count)
         {
             byte[] bytes = new byte[count];
-            reader.ReadBytes(bytes, count);
+            reader.ReadBytes(bytes, 0, count);
             return bytes;
         }
 
@@ -120,8 +120,8 @@ public static T[] ReadArray<T>(this NetworkReader reader)
             int length = reader.ReadPackedInt32();
             if (length < 0)
                 return null;
-            if (length > reader.Length - reader.Position)
-                throw new EndOfStreamException("Can't read " + length + " elements because it would read past the end of the stream. ");
+            if (!reader.CanReadBytes(length))
+                throw new EndOfStreamException($"Can't read {length} elements because it would read past the end of the stream.");
             var result = new T[length];
             for (int i = 0; i < length; i++)
             {
diff --git a/Assets/Mirage/Runtime/Serialization/Compression.cs b/Assets/Mirage/Runtime/Serialization/Compression.cs
index e182663a26c..95d2ea9c391 100644
--- a/Assets/Mirage/Runtime/Serialization/Compression.cs
+++ b/Assets/Mirage/Runtime/Serialization/Compression.cs
@@ -171,4 +171,4 @@ internal static Quaternion Decompress(uint compressed)
             return rotation;
         }
     }
-}
+}
\ No newline at end of file
diff --git a/Assets/Mirage/Runtime/Serialization/GenericTypesSerializationExtensions.cs b/Assets/Mirage/Runtime/Serialization/GenericTypesSerializationExtensions.cs
new file mode 100644
index 00000000000..4b5cc397769
--- /dev/null
+++ b/Assets/Mirage/Runtime/Serialization/GenericTypesSerializationExtensions.cs
@@ -0,0 +1,65 @@
+using System;
+using System.Collections.Generic;
+using System.Runtime.CompilerServices;
+
+namespace Mirage.Serialization
+{
+    /// <summary>
+    /// a class that holds writers for the different types
+    /// Note that c# creates a different static variable for each
+    /// type
+    /// This will be populated by the weaver
+    /// </summary>
+    /// <typeparam name="T"></typeparam>
+    public static class Writer<T>
+    {
+        public static Action<NetworkWriter, T> Write { internal get; set; }
+    }
+
+    /// <summary>
+    /// a class that holds readers for the different types
+    /// Note that c# creates a different static variable for each
+    /// type
+    /// This will be populated by the weaver
+    /// </summary>
+    /// <typeparam name="T"></typeparam>
+    public static class Reader<T>
+    {
+        public static Func<NetworkReader, T> Read { internal get; set; }
+    }
+
+    public static class GenericTypesSerializationExtensions
+    {
+        /// <summary>
+        /// Writes any type that mirror supports
+        /// </summary>
+        /// <typeparam name="T"></typeparam>
+        /// <param name="value"></param>
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        // do not include these as serialize function because they are used directly by weaver
+        [WeaverIgnore]
+        public static void Write<T>(this NetworkWriter writer, T value)
+        {
+            if (Writer<T>.Write == null)
+                throw new KeyNotFoundException($"No writer found for {typeof(T)}. See https://miragenet.github.io/Mirage/Articles/General/Troubleshooting.html for details");
+
+            Writer<T>.Write(writer, value);
+        }
+
+        /// <summary>
+        /// Reads any data type that mirror supports
+        /// </summary>
+        /// <typeparam name="T"></typeparam>
+        /// <returns></returns>
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        // do not include these as serialize function because they are used directly by weaver
+        [WeaverIgnore]
+        public static T Read<T>(this NetworkReader reader)
+        {
+            if (Reader<T>.Read == null)
+                throw new KeyNotFoundException($"No reader found for {typeof(T)}. See https://miragenet.github.io/Mirage/Articles/General/Troubleshooting.html for details");
+
+            return Reader<T>.Read(reader);
+        }
+    }
+}
diff --git a/Assets/Mirage/Runtime/Serialization/TypeConversion.cs.meta b/Assets/Mirage/Runtime/Serialization/GenericTypesSerializationExtensions.cs.meta
similarity index 83%
rename from Assets/Mirage/Runtime/Serialization/TypeConversion.cs.meta
rename to Assets/Mirage/Runtime/Serialization/GenericTypesSerializationExtensions.cs.meta
index d48d61eb954..feb3dc9798c 100644
--- a/Assets/Mirage/Runtime/Serialization/TypeConversion.cs.meta
+++ b/Assets/Mirage/Runtime/Serialization/GenericTypesSerializationExtensions.cs.meta
@@ -1,5 +1,5 @@
 fileFormatVersion: 2
-guid: 8ab6c1ed99802413b9d356645175e225
+guid: f8407512ce3e79b4cb38c3da4b8b8855
 MonoImporter:
   externalObjects: {}
   serializedVersion: 2
diff --git a/Assets/Mirage/Runtime/Serialization/NetworkReader.cs b/Assets/Mirage/Runtime/Serialization/NetworkReader.cs
index d0ab6dba0d2..7067b5ca6e5 100644
--- a/Assets/Mirage/Runtime/Serialization/NetworkReader.cs
+++ b/Assets/Mirage/Runtime/Serialization/NetworkReader.cs
@@ -1,145 +1,356 @@
-// Custom NetworkReader that doesn't use C#'s built in MemoryStream in order to
-// avoid allocations.
-//
-// Benchmark: 100kb byte[] passed to NetworkReader constructor 1000x
-//   before with MemoryStream
-//     0.8% CPU time, 250KB memory, 3.82ms
-//   now:
-//     0.0% CPU time,  32KB memory, 0.02ms
+/*
+MIT License
+
+Copyright (c) 2021 James Frowen
+
+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.
+*/
+
 using System;
 using System.IO;
-using UnityEngine;
+using System.Runtime.CompilerServices;
+using System.Runtime.InteropServices;
+using Unity.Collections.LowLevel.Unsafe;
 
 namespace Mirage.Serialization
 {
     /// <summary>
-    /// a class that holds readers for the different types
-    /// Note that c# creates a different static variable for each
-    /// type
-    /// This will be populated by the weaver
+    /// Bit writer, writes values to a buffer on a bit level
+    /// <para>Use <see cref="NetworkReaderPool.GetReader"/> to reduce memory allocation</para>
     /// </summary>
-    /// <typeparam name="T"></typeparam>
-    public static class Reader<T>
+    public unsafe class NetworkReader : IDisposable
     {
-        public static Func<NetworkReader, T> Read { internal get; set; }
-    }
+        byte[] managedBuffer;
+        GCHandle handle;
+        ulong* longPtr;
+        bool needsDisposing;
 
-    // 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.
-    /// <summary>
-    /// Binary stream Reader. Supports simple types, buffers, arrays, structs, and nested types
-    /// <para>Use <see cref="NetworkReaderPool.GetReader">NetworkReaderPool.GetReader</see> to reduce memory allocation</para>
-    /// </summary>
-    public class NetworkReader
-    {
-        // internal buffer
-        // byte[] pointer would work, but we use ArraySegment to also support
-        // the ArraySegment constructor
-        internal ArraySegment<byte> 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;
-        public int Length => buffer.Count;
+        int bitPosition;
+        int bitLength;
+
+        public int BitLength
+        {
+            [MethodImpl(MethodImplOptions.AggressiveInlining)]
+            get => bitLength;
+        }
+
+        public int BitPosition
+        {
+            [MethodImpl(MethodImplOptions.AggressiveInlining)]
+            get => bitPosition;
+        }
+
+        /// <summary>
+        /// Position to the nearest byte
+        /// </summary>
+        public int BytePosition
+        {
+            // rounds up to nearest 8
+            // add to 3 last bits,
+            //   if any are 1 then it will roll over 4th bit.
+            //   if all are 0, then nothing happens 
+            [MethodImpl(MethodImplOptions.AggressiveInlining)]
+            get => (bitPosition + 0b111) >> 3;
+        }
 
         /// <summary>
         /// some service object that can find objects by net id
         /// </summary>
+        // todo try move this somewhere else
         public IObjectLocator ObjectLocator { get; internal set; }
 
-        public NetworkReader(byte[] bytes)
+
+        public NetworkReader() { }
+
+        ~NetworkReader()
         {
-            buffer = new ArraySegment<byte>(bytes);
+            Dispose(false);
         }
+        /// <param name="disposing">true if called from IDisposable</param>
+        protected virtual void Dispose(bool disposing)
+        {
+            if (!needsDisposing) return;
 
-        public NetworkReader(ArraySegment<byte> segment)
+            handle.Free();
+            longPtr = null;
+            needsDisposing = false;
+
+            if (disposing)
+            {
+                // clear manged stuff here because we no longer want reader to keep reference to buffer
+                bitLength = 0;
+                managedBuffer = null;
+            }
+        }
+        public void Dispose()
         {
-            buffer = segment;
+            Dispose(true);
         }
 
-        public byte ReadByte()
+        public void Reset(ArraySegment<byte> segment)
+        {
+            Reset(segment.Array, segment.Offset, segment.Count);
+        }
+        public void Reset(byte[] array)
+        {
+            Reset(array, 0, array.Length);
+        }
+        public void Reset(byte[] array, int position, int length)
         {
-            if (Position + 1 > buffer.Count)
+            if (needsDisposing)
             {
-                throw new EndOfStreamException("ReadByte out of range:" + ToString());
+                // dispose old handler first
+                Dispose();
             }
-            return buffer.Array[buffer.Offset + Position++];
+
+            // reset disposed bool, as it can be disposed again after reset
+            needsDisposing = true;
+
+            bitPosition = position * 8;
+            bitLength = bitPosition + (length * 8);
+            managedBuffer = array;
+            handle = GCHandle.Alloc(managedBuffer, GCHandleType.Pinned);
+            longPtr = (ulong*)handle.AddrOfPinnedObject();
         }
 
-        public int ReadInt32() => (int)ReadUInt32();
-        public uint ReadUInt32()
+        /// <summary>
+        /// Can read atleast 1 bit
+        /// </summary>
+        /// <returns></returns>
+        public bool CanRead()
         {
-            uint value = 0;
-            value |= ReadByte();
-            value |= (uint)(ReadByte() << 8);
-            value |= (uint)(ReadByte() << 16);
-            value |= (uint)(ReadByte() << 24);
-            return value;
+            return bitPosition < bitLength;
         }
-        public long ReadInt64() => (long)ReadUInt64();
-        public ulong ReadUInt64()
+
+        /// <summary>
+        /// Can atleast <paramref name="byteLength"/> bytes
+        /// </summary>
+        /// <param name="byteLength"></param>
+        /// <returns></returns>
+        public bool CanReadBytes(int byteLength)
         {
-            ulong value = 0;
-            value |= ReadByte();
-            value |= ((ulong)ReadByte()) << 8;
-            value |= ((ulong)ReadByte()) << 16;
-            value |= ((ulong)ReadByte()) << 24;
-            value |= ((ulong)ReadByte()) << 32;
-            value |= ((ulong)ReadByte()) << 40;
-            value |= ((ulong)ReadByte()) << 48;
-            value |= ((ulong)ReadByte()) << 56;
-            return value;
+            return (bitPosition + (byteLength * 8)) <= bitLength;
+
         }
 
-        // read bytes into the passed buffer
-        public byte[] ReadBytes(byte[] bytes, int count)
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        void CheckNewLength(int newPosition)
         {
-            // check if passed byte array is big enough
-            if (count > bytes.Length)
+            if (newPosition > bitLength)
             {
-                throw new EndOfStreamException("ReadBytes can't read " + count + " + bytes because the passed byte[] only has length " + bytes.Length);
+                throw new EndOfStreamException($"Can not read over end of buffer, new position {newPosition}, length {bitLength} bits");
             }
+        }
 
-            ArraySegment<byte> data = ReadBytesSegment(count);
-            Array.Copy(data.Array, data.Offset, bytes, 0, count);
-            return bytes;
+        private void PadToByte()
+        {
+            bitPosition = BytePosition << 3;
         }
 
-        // useful to parse payloads etc. without allocating
-        public ArraySegment<byte> ReadBytesSegment(int count)
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public bool ReadBoolean()
+        {
+            return ReadBooleanAsUlong() == 1UL;
+        }
+
+        /// <summary>
+        /// Writes first bit of <paramref name="value"/> to buffer
+        /// </summary>
+        /// <param name="value"></param>
+        public ulong ReadBooleanAsUlong()
         {
-            // check if within buffer limits
-            if (Position + count > buffer.Count)
+            int newPosition = bitPosition + 1;
+            CheckNewLength(newPosition);
+
+            ulong* ptr = (longPtr + (bitPosition >> 6));
+            ulong result = ((*ptr) >> bitPosition) & 0b1;
+
+            bitPosition = newPosition;
+            return result;
+        }
+
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public sbyte ReadSByte() => (sbyte)ReadByte();
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public byte ReadByte() => (byte)ReadUnmasked(8);
+
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public short ReadInt16() => (short)ReadUInt16();
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public ushort ReadUInt16() => (ushort)ReadUnmasked(16);
+
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public int ReadInt32() => (int)ReadUInt32();
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public uint ReadUInt32() => (uint)ReadUnmasked(32);
+
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public long ReadInt64() => (long)ReadUInt64();
+        public ulong ReadUInt64()
+        {
+            int newPosition = bitPosition + 64;
+            CheckNewLength(newPosition);
+
+            int bitsInLong = bitPosition & 0b11_1111;
+            ulong result;
+            if (bitsInLong == 0)
             {
-                throw new EndOfStreamException("ReadBytesSegment can't read " + count + " bytes because it would read past the end of the stream. " + ToString());
+                ulong* ptr1 = (longPtr + (bitPosition >> 6));
+                result = *ptr1;
             }
+            else
+            {
+                int bitsLeft = 64 - bitsInLong;
+
+                ulong* ptr1 = (longPtr + (bitPosition >> 6));
+                ulong* ptr2 = (ptr1 + 1);
 
-            // return the segment
-            var result = new ArraySegment<byte>(buffer.Array, buffer.Offset + Position, count);
-            Position += count;
+                // eg use byte, read 6  =>bitPosition=5, bitsLeft=3, newPos=1
+                // r1 = aaab_bbbb => 0000_0aaa
+                // r2 = cccc_caaa => ccaa_a000
+                // r = r1|r2 => ccaa_aaaa
+                // we mask this result later
+
+                ulong r1 = (*ptr1) >> bitPosition;
+                ulong r2 = (*ptr2) << bitsLeft;
+                result = r1 | r2;
+            }
+
+            bitPosition = newPosition;
+
+            // dont need to mask this result because should be reading all 64 bits
             return result;
         }
 
-        public override string ToString()
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public float ReadSingle()
+        {
+            uint uValue = ReadUInt32();
+            return *(float*)&uValue;
+        }
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public double ReadDouble()
+        {
+            ulong uValue = ReadUInt64();
+            return *(double*)&uValue;
+        }
+
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public ulong Read(int bits)
         {
-            return "NetworkReader pos=" + Position + " len=" + Length + " buffer=" + BitConverter.ToString(buffer.Array, buffer.Offset, buffer.Count);
+            if (bits == 0) return 0;
+            // mask so we dont returns extra bits
+            return ReadUnmasked(bits) & (ulong.MaxValue >> (64 - bits));
         }
 
+        private ulong ReadUnmasked(int bits)
+        {
+            int newPosition = bitPosition + bits;
+            CheckNewLength(newPosition);
+
+            int bitsInLong = bitPosition & 0b11_1111;
+            int bitsLeft = 64 - bitsInLong;
+
+            ulong result;
+            if (bitsLeft >= bits)
+            {
+                ulong* ptr = longPtr + (bitPosition >> 6);
+                result = (*ptr) >> bitsInLong;
+            }
+            else
+            {
+                ulong* ptr1 = longPtr + (bitPosition >> 6);
+                ulong* ptr2 = ptr1 + 1;
+
+                // eg use byte, read 6  =>bitPosition=5, bitsLeft=3, newPos=1
+                // r1 = aaab_bbbb => 0000_0aaa
+                // r2 = cccc_caaa => ccaa_a000
+                // r = r1|r2 => ccaa_aaaa
+                // we mask this result later
+
+                ulong r1 = (*ptr1) >> bitsInLong;
+                ulong r2 = (*ptr2) << bitsLeft;
+                result = r1 | r2;
+            }
+            bitPosition = newPosition;
+
+            return result;
+        }
+
+
         /// <summary>
-        /// Reads any data type that mirror supports
+        /// <para>
+        ///    Moves position to nearest byte then copies struct from that position
+        /// </para>
+        /// See <see href="https://docs.unity3d.com/ScriptReference/Unity.Collections.LowLevel.Unsafe.UnsafeUtility.CopyPtrToStructure.html">UnsafeUtility.CopyPtrToStructure</see>
         /// </summary>
         /// <typeparam name="T"></typeparam>
-        /// <returns></returns>
-        public T Read<T>()
+        /// <param name="value"></param>
+        /// <param name="byteSize"></param>
+        public void PadAndCopy<T>(int byteSize, out T value) where T : struct
         {
-            if (Reader<T>.Read == null)
-                Debug.AssertFormat(
-                    Reader<T>.Read != null,
-                    @"No reader found for {0}. See https://miragenet.github.io/Mirage/Articles/General/Troubleshooting.html for details",
-                    typeof(T));
+            PadToByte();
+            int newPosition = bitPosition + (64 * byteSize);
+            CheckNewLength(newPosition);
 
-            return Reader<T>.Read(this);
+            byte* startPtr = ((byte*)longPtr) + (bitPosition >> 3);
+
+            UnsafeUtility.CopyPtrToStructure(startPtr, out value);
+            bitPosition = newPosition;
+        }
+
+        /// <summary>
+        /// <para>
+        ///    Moves position to nearest byte then copies bytes from that position
+        /// </para>
+        /// </summary>
+        /// <param name="array"></param>
+        /// <param name="offset"></param>
+        /// <param name="length"></param>
+        public void ReadBytes(byte[] array, int offset, int length)
+        {
+            PadToByte();
+            int newPosition = bitPosition + (8 * length);
+            CheckNewLength(newPosition);
+
+            // todo benchmark this vs Marshal.Copy or for loop
+            Buffer.BlockCopy(managedBuffer, BytePosition, array, offset, length);
+            bitPosition = newPosition;
+        }
+
+        public ArraySegment<byte> ReadBytesSegment(int count)
+        {
+            PadToByte();
+            int newPosition = bitPosition + (8 * count);
+            CheckNewLength(newPosition);
+
+            var result = new ArraySegment<byte>(managedBuffer, BytePosition, count);
+            bitPosition = newPosition;
+            return result;
         }
     }
 }
diff --git a/Assets/Mirage/Runtime/Serialization/NetworkReaderPool.cs b/Assets/Mirage/Runtime/Serialization/NetworkReaderPool.cs
index 79897a1bcb4..2b5c56a779b 100644
--- a/Assets/Mirage/Runtime/Serialization/NetworkReaderPool.cs
+++ b/Assets/Mirage/Runtime/Serialization/NetworkReaderPool.cs
@@ -1,138 +1,86 @@
 using System;
 using Mirage.Logging;
+using Mirage.SocketLayer;
 using UnityEngine;
 
 namespace Mirage.Serialization
 {
     /// <summary>
-    /// NetworkReader to be used with <see cref="NetworkReaderPool">NetworkReaderPool</see>
+    /// Holds static reference to <see cref="Pool{T}"/> of <see cref="PooledNetworkReader"/>
     /// </summary>
-    public sealed class PooledNetworkReader : NetworkReader, IDisposable
+    public static class NetworkReaderPool
     {
-        internal PooledNetworkReader(byte[] bytes) : base(bytes) { }
+        static readonly ILogger logger = LogFactory.GetLogger(typeof(NetworkReaderPool));
+        static Pool<PooledNetworkReader> pool = new Pool<PooledNetworkReader>(PooledNetworkReader.CreateNew, 0, 5, 100, logger);
 
-        internal PooledNetworkReader(ArraySegment<byte> segment) : base(segment) { }
+        public static void Configure(int startPoolSize = 5, int maxPoolSize = 100)
+        {
+            if (pool != null)
+            {
+                pool.Configure(startPoolSize, maxPoolSize);
+            }
+            else
+            {
+                pool = new Pool<PooledNetworkReader>(PooledNetworkReader.CreateNew, 0, startPoolSize, maxPoolSize, logger);
+            }
+        }
 
-        public void Dispose()
+        public static PooledNetworkReader GetReader(ArraySegment<byte> packet)
+        {
+            PooledNetworkReader reader = pool.Take();
+            reader.Reset(packet.Array, packet.Offset, packet.Count);
+            return reader;
+        }
+        public static PooledNetworkReader GetReader(byte[] array)
         {
-            NetworkReaderPool.Recycle(this);
+            PooledNetworkReader reader = pool.Take();
+            reader.Reset(array, 0, array.Length);
+            return reader;
+        }
+        public static PooledNetworkReader GetReader(byte[] array, int offset, int length)
+        {
+            PooledNetworkReader reader = pool.Take();
+            reader.Reset(array, offset, length);
+            return reader;
         }
     }
 
     /// <summary>
-    /// Pool of NetworkReaders
-    /// <para>Use this pool instead of <see cref="NetworkReader">NetworkReader</see> to reduce memory allocation</para>
-    /// <para>Use <see cref="Capacity">Capacity</see> to change size of pool</para>
+    /// NetworkReader to be used with <see cref="NetworkReaderPool">NetworkReaderPool</see>
     /// </summary>
-    public static class NetworkReaderPool
+    public sealed class PooledNetworkReader : NetworkReader, IDisposable
     {
-        static readonly ILogger logger = LogFactory.GetLogger(typeof(NetworkReaderPool));
+        private readonly Pool<PooledNetworkReader> pool;
 
-        /// <summary>
-        /// Size of the pool
-        /// <para>If pool is too small getting readers will causes memory allocation</para>
-        /// <para>Default value: 100</para>
-        /// </summary>
-        public static int Capacity
+        private PooledNetworkReader(Pool<PooledNetworkReader> pool) : base()
         {
-            get => pool.Length;
-            set
-            {
-                // resize the array
-                Array.Resize(ref pool, value);
-
-                // if capacity is smaller than before, then we need to adjust
-                // 'next' so it doesn't point to an index out of range
-                // -> if we set '0' then next = min(_, 0-1) => -1
-                // -> if we set '2' then next = min(_, 2-1) =>  1
-                next = Mathf.Min(next, pool.Length - 1);
-            }
+            this.pool = pool ?? throw new ArgumentNullException(nameof(pool));
         }
 
-        /// <summary>
-        /// Mirage usually only uses up to 4 readers in nested usings,
-        /// 100 is a good margin for edge cases when users need a lot readers at
-        /// the same time.
-        ///
-        /// <para>keep in mind, most entries of the pool will be null in most cases</para>
-        /// </summary>
-        ///
-        /// Note: we use an Array instead of a Stack because it's significantly
-        ///       faster: https://github.com/vis2k/Mirror/issues/1614
-        static PooledNetworkReader[] pool = new PooledNetworkReader[100];
-
-        static int next = -1;
-
-        /// <summary>
-        /// Get the next reader in the pool
-        /// <para>If pool is empty, creates a new Reader</para>
-        /// </summary>
-        public static PooledNetworkReader GetReader(byte[] bytes)
+        public static PooledNetworkReader CreateNew(int _, Pool<PooledNetworkReader> pool)
         {
-            if (next == -1)
-            {
-                return new PooledNetworkReader(bytes);
-            }
-
-            PooledNetworkReader reader = pool[next];
-            pool[next] = null;
-            next--;
-
-            // reset buffer
-            SetBuffer(reader, bytes);
-            reader.ObjectLocator = null;
-            return reader;
+            return new PooledNetworkReader(pool);
         }
 
         /// <summary>
-        /// Get the next reader in the pool
-        /// <para>If pool is empty, creates a new Reader</para>
+        /// Puts object back in Pool
         /// </summary>
-        public static PooledNetworkReader GetReader(ArraySegment<byte> segment)
+        public void Release()
         {
-            if (next == -1)
-            {
-                return new PooledNetworkReader(segment);
-            }
-
-            PooledNetworkReader reader = pool[next];
-            pool[next] = null;
-            next--;
-
-            // reset buffer
-            SetBuffer(reader, segment);
-            reader.ObjectLocator = null;
-            return reader;
+            Dispose(true);
         }
 
-        /// <summary>
-        /// Puts reader back into pool
-        /// <para>When pool is full, the extra reader is left for the GC</para>
-        /// </summary>
-        public static void Recycle(PooledNetworkReader reader)
+        void IDisposable.Dispose() => Dispose(true);
+        protected override void Dispose(bool disposing)
         {
-            if (next < pool.Length - 1)
-            {
-                next++;
-                pool[next] = reader;
-            }
-            else
+            base.Dispose(disposing);
+
+            // only put back into the pool is Dispose was called
+            // => dont put it back for finalize
+            if (disposing)
             {
-                logger.LogWarning("NetworkReaderPool.Recycle, Pool was full leaving extra reader for GC");
+                pool.Put(this);
             }
         }
-
-        // SetBuffer methods mirror constructor for ReaderPool
-        static void SetBuffer(NetworkReader reader, byte[] bytes)
-        {
-            reader.buffer = new ArraySegment<byte>(bytes);
-            reader.Position = 0;
-        }
-
-        static void SetBuffer(NetworkReader reader, ArraySegment<byte> segment)
-        {
-            reader.buffer = segment;
-            reader.Position = 0;
-        }
     }
 }
diff --git a/Assets/Mirage/Runtime/Serialization/NetworkWriter.cs b/Assets/Mirage/Runtime/Serialization/NetworkWriter.cs
index df91ed6669b..ef12043563e 100644
--- a/Assets/Mirage/Runtime/Serialization/NetworkWriter.cs
+++ b/Assets/Mirage/Runtime/Serialization/NetworkWriter.cs
@@ -1,184 +1,401 @@
+/*
+MIT License
+
+Copyright (c) 2021 James Frowen
+
+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.
+*/
+
 using System;
 using System.Runtime.CompilerServices;
+using System.Runtime.InteropServices;
+using Unity.Collections.LowLevel.Unsafe;
 using UnityEngine;
 
 namespace Mirage.Serialization
 {
     /// <summary>
-    /// a class that holds writers for the different types
-    /// Note that c# creates a different static variable for each
-    /// type
-    /// This will be populated by the weaver
+    /// Bit writer, writes values to a buffer on a bit level
+    /// <para>Use <see cref="NetworkWriterPool.GetWriter"/> to reduce memory allocation</para>
     /// </summary>
-    /// <typeparam name="T"></typeparam>
-    public static class Writer<T>
+    public unsafe class NetworkWriter
     {
-        public static Action<NetworkWriter, T> Write { internal get; set; }
-    }
+        byte[] managedBuffer;
+        int bitCapacity;
+        /// <summary>Allow internal buffer to resize if capcity is reached</summary>
+        readonly bool allowResize;
 
-    /// <summary>
-    /// Binary stream Writer. Supports simple types, buffers, arrays, structs, and nested types
-    /// <para>Use <see cref="NetworkWriterPool.GetWriter">NetworkWriter.GetWriter</see> to reduce memory allocation</para>
-    /// </summary>
-    public class NetworkWriter
-    {
-        public const int MaxStringLength = 1024 * 32;
+        GCHandle handle;
+        ulong* longPtr;
+        bool needsDisposing;
 
-        // 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
-        byte[] buffer = new byte[1500];
+        int bitPosition;
 
-        // '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
-        int position;
+        public int ByteCapacity
+        {
+            // see ByteLength for comment
+            [MethodImpl(MethodImplOptions.AggressiveInlining)]
+            get => (bitCapacity + 0b111) >> 3;
+        }
 
-        public int Length { get; private set; }
+        public int ByteLength
+        {
+            // rounds up to nearest 8
+            // add to 3 last bits,
+            //   if any are 1 then it will roll over 4th bit.
+            //   if all are 0, then nothing happens 
+            [MethodImpl(MethodImplOptions.AggressiveInlining)]
+            get => (bitPosition + 0b111) >> 3;
+        }
 
-        public int Position
+        public int BitPosition
         {
-            get => position;
-            set
-            {
-                position = value;
-                EnsureLength(value);
-            }
+            [MethodImpl(MethodImplOptions.AggressiveInlining)]
+            get => bitPosition;
         }
 
+        public NetworkWriter(int minByteCapacity) : this(minByteCapacity, true) { }
+        public NetworkWriter(int minByteCapacity, bool allowResize)
+        {
+            this.allowResize = allowResize;
+
+            // ensure capacity is multiple of 8
+            int ulongCapacity = Mathf.CeilToInt(minByteCapacity / (float)sizeof(ulong));
+            int byteCapacity = ulongCapacity * sizeof(ulong);
+
+            bitCapacity = byteCapacity * 8;
+            managedBuffer = new byte[byteCapacity];
+
+            CreateHandle();
+        }
+
+
+        ~NetworkWriter()
+        {
+            FreeHandle();
+        }
+
+
+        void ResizeBuffer()
+        {
+            int size = managedBuffer.Length * 2;
+
+            Debug.Log(handle.AddrOfPinnedObject());
+            FreeHandle();
+
+            Array.Resize(ref managedBuffer, size);
+            bitCapacity = size * 8;
+
+            CreateHandle();
+            Debug.Log(handle.AddrOfPinnedObject());
+        }
+        void CreateHandle()
+        {
+            if (needsDisposing) FreeHandle();
+
+            handle = GCHandle.Alloc(managedBuffer, GCHandleType.Pinned);
+            longPtr = (ulong*)handle.AddrOfPinnedObject();
+            needsDisposing = true;
+        }
         /// <summary>
-        /// Reset both the position and length of the stream
+        /// Frees the handle for the buffer
+        /// <para>In order for <see cref="PooledNetworkWriter"/> to work This class can not have <see cref="IDisposable"/>. Instead we call this method from finalize</para>
         /// </summary>
-        /// <remarks>
-        /// Leaves the capacity the same so that we can reuse this writer without extra allocations
-        /// </remarks>
+        void FreeHandle()
+        {
+            if (!needsDisposing) return;
+
+            handle.Free();
+            longPtr = null;
+            needsDisposing = false;
+        }
+
         public void Reset()
         {
-            position = 0;
-            Length = 0;
+            bitPosition = 0;
         }
 
         /// <summary>
-        /// Sets length, moves position if it is greater than new length
+        /// Copies internal buffer to new Array
+        /// <para>To reduce Allocations use <see cref="ToArraySegment"/> instead</para>
         /// </summary>
-        /// <param name="newLength"></param>
-        /// <remarks>
-        /// Zeros out any extra length created by setlength
-        /// </remarks>
-        public void SetLength(int newLength)
+        /// <returns></returns>
+        public byte[] ToArray()
         {
-            int oldLength = Length;
+            byte[] data = new byte[ByteLength];
+            Buffer.BlockCopy(managedBuffer, 0, data, 0, ByteLength);
+            return data;
+        }
+        public ArraySegment<byte> ToArraySegment()
+        {
+            return new ArraySegment<byte>(managedBuffer, 0, ByteLength);
+        }
 
-            // ensure length & capacity
-            EnsureLength(newLength);
 
-            // zero out new length
-            if (oldLength < newLength)
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        void CheckNewLength(int newLength)
+        {
+            if (newLength > bitCapacity)
             {
-                Array.Clear(buffer, oldLength, newLength - oldLength);
+                if (allowResize)
+                {
+                    ResizeBuffer();
+                }
+                else
+                {
+                    throw new InvalidOperationException($"Can not write over end of buffer, new length {newLength}, capacity {bitCapacity}");
+                }
             }
+        }
 
-            Length = newLength;
-            position = Mathf.Min(position, Length);
+        private void PadToByte()
+        {
+            bitPosition = ByteLength << 3;
         }
 
         [MethodImpl(MethodImplOptions.AggressiveInlining)]
-        void EnsureLength(int value)
+        public void WriteBoolean(bool value)
         {
-            if (Length < value)
-            {
-                Length = value;
-                EnsureCapacity(value);
-            }
+            WriteBoolean(value ? 1UL : 0UL);
         }
+        /// <summary>
+        /// Writes first bit of <paramref name="value"/> to buffer
+        /// </summary>
+        /// <param name="value"></param>
+        public void WriteBoolean(ulong value)
+        {
+            int newPosition = bitPosition + 1;
+            CheckNewLength(newPosition);
+
+            int bitsInLong = bitPosition & 0b11_1111;
+
+            ulong* ptr = longPtr + (bitPosition >> 6);
+            *ptr = (
+                *ptr & (
+                    // start with 0000_0001
+                    // shift by number in bit, eg 5 => 0010_0000
+                    // then not 1101_1111
+                    ~(1UL << bitsInLong)
+                )
+            ) | ((value & 0b1) << bitsInLong);
+
+            bitPosition = newPosition;
+        }
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public void WriteSByte(sbyte value) => WriteByte((byte)value);
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public void WriteByte(byte value) => WriterUnmasked(value, 8);
+
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public void WriteInt16(short value) => WriteUInt16((ushort)value);
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public void WriteUInt16(ushort value) => WriterUnmasked(value, 16);
+
 
         [MethodImpl(MethodImplOptions.AggressiveInlining)]
-        void EnsureCapacity(int value)
+        public void WriteInt32(int value) => WriteUInt32((uint)value);
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public void WriteUInt32(uint value) => WriterUnmasked(value, 32);
+
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public void WriteInt64(long value) => WriteUInt64((ulong)value);
+        public void WriteUInt64(ulong value)
         {
-            if (buffer.Length < value)
+            int newPosition = bitPosition + 64;
+            CheckNewLength(newPosition);
+
+            int bitsInLong = bitPosition & 0b11_1111;
+
+            if (bitsInLong == 0)
             {
-                int capacity = Math.Max(value, buffer.Length * 2);
-                Array.Resize(ref buffer, capacity);
+                ulong* ptr1 = longPtr + (bitPosition >> 6);
+                *ptr1 = value;
             }
-        }
+            else
+            {
+                int bitsLeft = 64 - bitsInLong;
 
-        // MemoryStream has 3 values: Position, Length and Capacity.
-        // Position is used to indicate where we are writing
-        // Length is how much data we have written
-        // capacity is how much memory we have allocated
-        // ToArray returns all the data we have written,  regardless of the current position
-        public byte[] ToArray()
-        {
-            byte[] data = new byte[Length];
-            Array.ConstrainedCopy(buffer, 0, data, 0, Length);
-            return data;
+                ulong* ptr1 = longPtr + (bitPosition >> 6);
+                ulong* ptr2 = ptr1 + 1;
+
+                *ptr1 = (*ptr1 & (ulong.MaxValue >> bitsLeft)) | (value << bitsInLong);
+                *ptr2 = (*ptr2 & (ulong.MaxValue << newPosition)) | (value >> bitsLeft);
+            }
+            bitPosition = newPosition;
         }
 
-        // Gets the serialized data in an ArraySegment<byte>
-        // this is similar to ToArray(),  but it gets the data in O(1)
-        // and without allocations.
-        // Do not write anything else or modify the NetworkWriter
-        // while you are using the ArraySegment
-        public ArraySegment<byte> ToArraySegment()
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public void WriteSingle(float value) => WriteUInt32(*(uint*)&value);
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public void WriteDouble(double value) => WriteUInt64(*(ulong*)&value);
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public void Write(ulong value, int bits)
         {
-            return new ArraySegment<byte>(buffer, 0, Length);
+            if (bits == 0) return;
+            // mask so we dont overwrite
+            WriterUnmasked(value & BitMask.Mask(bits), bits);
         }
 
-        public void WriteByte(byte value)
+        private void WriterUnmasked(ulong value, int bits)
         {
-            EnsureLength(position + 1);
-            buffer[position++] = value;
-        }
+            int newPosition = bitPosition + bits;
+            CheckNewLength(newPosition);
 
+            int bitsInLong = bitPosition & 0b11_1111;
+            int bitsLeft = 64 - bitsInLong;
 
-        // 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[] buffer, int offset, int count)
-        {
-            EnsureLength(position + count);
-            Array.ConstrainedCopy(buffer, offset, this.buffer, position, count);
-            position += count;
+            if (bitsLeft >= bits)
+            {
+                ulong* ptr = longPtr + (bitPosition >> 6);
+
+                *ptr = (*ptr & BitMask.OuterMask(bitPosition, newPosition)) | (value << bitsInLong);
+            }
+            else
+            {
+                ulong* ptr1 = longPtr + (bitPosition >> 6);
+                ulong* ptr2 = ptr1 + 1;
+
+                *ptr1 = (*ptr1 & (ulong.MaxValue >> bitsLeft)) | (value << bitsInLong);
+                *ptr2 = (*ptr2 & (ulong.MaxValue << newPosition)) | (value >> bitsLeft);
+            }
+            bitPosition = newPosition;
         }
 
-        public void WriteUInt32(uint value)
+        public void WriteAtBytePosition(ulong value, int bits, int bytePosition)
         {
-            EnsureLength(position + 4);
-            buffer[position++] = (byte)value;
-            buffer[position++] = (byte)(value >> 8);
-            buffer[position++] = (byte)(value >> 16);
-            buffer[position++] = (byte)(value >> 24);
+            WriteAtPosition(value, bits, bytePosition * 8);
         }
+        public void WriteAtPosition(ulong value, int bits, int bitPosition)
+        {
+            // careful with this method, dont set bitPosition
 
-        public void WriteInt32(int value) => WriteUInt32((uint)value);
+            int newPosition = bitPosition + bits;
+            CheckNewLength(newPosition);
 
-        public void WriteUInt64(ulong value)
-        {
-            EnsureLength(position + 8);
-            buffer[position++] = (byte)value;
-            buffer[position++] = (byte)(value >> 8);
-            buffer[position++] = (byte)(value >> 16);
-            buffer[position++] = (byte)(value >> 24);
-            buffer[position++] = (byte)(value >> 32);
-            buffer[position++] = (byte)(value >> 40);
-            buffer[position++] = (byte)(value >> 48);
-            buffer[position++] = (byte)(value >> 56);
-        }
+            // mask so we dont overwrite
+            value &= ulong.MaxValue >> (64 - bits);
 
-        public void WriteInt64(long value) => WriteUInt64((ulong)value);
+            int bitsInLong = bitPosition & 0b11_1111;
+            int bitsLeft = 64 - bitsInLong;
+            if (bitsLeft >= bits)
+            {
+                ulong* ptr = longPtr + (bitPosition >> 6);
+                *ptr = (
+                    *ptr & (
+                        (ulong.MaxValue >> bitsLeft) | (ulong.MaxValue << (newPosition /*we can use full position here as c# will mask it to just 6 bits*/))
+                    )
+                ) | (value << bitsInLong);
+            }
+            else
+            {
+                ulong* ptr1 = longPtr + (bitPosition >> 6);
+                ulong* ptr2 = ptr1 + 1;
+
+                *ptr1 = (*ptr1 & (ulong.MaxValue >> bitsLeft)) | (value << bitsInLong);
+                *ptr2 = (*ptr2 & (ulong.MaxValue << newPosition)) | (value >> bitsLeft);
+            }
+        }
 
         /// <summary>
-        /// Writes any type that mirror supports
+        /// <para>
+        ///    Moves position to nearest byte then copies struct to that position
+        /// </para>
+        /// See <see href="https://docs.unity3d.com/ScriptReference/Unity.Collections.LowLevel.Unsafe.UnsafeUtility.CopyStructureToPtr.html">UnsafeUtility.CopyStructureToPtr</see>
         /// </summary>
         /// <typeparam name="T"></typeparam>
         /// <param name="value"></param>
-        public void Write<T>(T value)
+        /// <param name="byteSize">size of struct, in bytes</param>
+        public void PadAndCopy<T>(ref T value, int byteSize) where T : struct
         {
-            if (Writer<T>.Write == null)
-                Debug.AssertFormat(
-                    Writer<T>.Write != null,
-                    @"No writer found for {0}. See https://miragenet.github.io/Mirage/Articles/General/Troubleshooting.html for details",
-                    typeof(T));
+            PadToByte();
+            int newPosition = bitPosition + (8 * byteSize);
+            CheckNewLength(newPosition);
+
+            byte* startPtr = ((byte*)longPtr) + (bitPosition >> 3);
+
+            UnsafeUtility.CopyStructureToPtr(ref value, startPtr);
+            bitPosition = newPosition;
+        }
+
+        /// <summary>
+        /// <para>
+        ///    Moves position to nearest byte then writes bytes to that position
+        /// </para>
+        /// </summary>
+        /// <param name="array"></param>
+        /// <param name="offset"></param>
+        /// <param name="length"></param>
+        public void WriteBytes(byte[] array, int offset, int length)
+        {
+            PadToByte();
+            int newPosition = bitPosition + (8 * length);
+            CheckNewLength(newPosition);
+
+            // todo benchmark this vs Marshal.Copy or for loop
+            Buffer.BlockCopy(array, offset, managedBuffer, ByteLength, length);
+            bitPosition = newPosition;
+        }
+
+        public void CopyFromWriter(NetworkWriter other, int otherBitPosition, int bitLength)
+        {
+            int newBit = bitPosition + bitLength;
+            CheckNewLength(newBit);
+
+            int ulongPos = otherBitPosition >> 6;
+            ulong* otherPtr = other.longPtr + ulongPos;
+
+
+            int firstBitOffset = otherBitPosition & 0b11_1111;
+
+            // first align other
+            if (firstBitOffset != 0)
+            {
+                int bitsToCopyFromFirst = Math.Min(64 - firstBitOffset, bitLength);
+
+                // if offset is 10, then we want to shift value by 10 to remove un-needed bits
+                ulong firstValue = *otherPtr >> firstBitOffset;
+
+                Write(firstValue, bitsToCopyFromFirst);
+
+                bitLength -= bitsToCopyFromFirst;
+                otherPtr++;
+            }
+
+            // write aligned with other
+            while (bitLength > 64)
+            {
+                WriteUInt64(*otherPtr);
+
+                bitLength -= 64;
+                otherPtr++;
+            }
+
+            // write left over others
+            //      if bitlength == 0 then write will return
+            Write(*otherPtr, bitLength);
 
-            Writer<T>.Write(this, value);
+            Debug.Assert(bitPosition == newBit, "bitPosition should already be equal to newBit because it would have incremented each WriteUInt64");
+            bitPosition = newBit;
         }
     }
 }
diff --git a/Assets/Mirage/Runtime/Serialization/NetworkWriterPool.cs b/Assets/Mirage/Runtime/Serialization/NetworkWriterPool.cs
index 93f7814c323..b08ef0364c9 100644
--- a/Assets/Mirage/Runtime/Serialization/NetworkWriterPool.cs
+++ b/Assets/Mirage/Runtime/Serialization/NetworkWriterPool.cs
@@ -1,99 +1,83 @@
 using System;
 using Mirage.Logging;
+using Mirage.SocketLayer;
 using UnityEngine;
 
 namespace Mirage.Serialization
 {
-    /// <summary>
-    /// NetworkWriter to be used with <see cref="NetworkWriterPool">NetworkWriterPool</see>
-    /// </summary>
-    public sealed class PooledNetworkWriter : NetworkWriter, IDisposable
-    {
-        public void Dispose()
-        {
-            NetworkWriterPool.Recycle(this);
-        }
-    }
-
-    /// <summary>
-    /// Pool of NetworkWriters
-    /// <para>Use this pool instead of <see cref="NetworkWriter">NetworkWriter</see> to reduce memory allocation</para>
-    /// <para>Use <see cref="Capacity">Capacity</see> to change size of pool</para>
-    /// </summary>
     public static class NetworkWriterPool
     {
         static readonly ILogger logger = LogFactory.GetLogger(typeof(NetworkWriterPool));
+        static Pool<PooledNetworkWriter> pool;
 
         /// <summary>
-        /// Size of the pool
-        /// <para>If pool is too small getting writers will causes memory allocation</para>
-        /// <para>Default value: 100 </para>
+        /// Current Size of buffers, or null before Configure has been called
         /// </summary>
-        public static int Capacity
-        {
-            get => pool.Length;
-            set
-            {
-                // resize the array
-                Array.Resize(ref pool, value);
+        public static int? BufferSize { get; private set; }
 
-                // if capacity is smaller than before, then we need to adjust
-                // 'next' so it doesn't point to an index out of range
-                // -> if we set '0' then next = min(_, 0-1) => -1
-                // -> if we set '2' then next = min(_, 2-1) =>  1
-                next = Mathf.Min(next, pool.Length - 1);
-            }
+        static NetworkWriterPool()
+        {
+            // auto configure so that pool can be used without having to manually call it
+            var config = new Config();
+            Configure(config.MaxPacketSize);
         }
 
         /// <summary>
-        /// Mirage usually only uses up to 4 writes in nested usings,
-        /// 100 is a good margin for edge cases when users need a lot writers at
-        /// the same time.
-        ///
-        /// <para>keep in mind, most entries of the pool will be null in most cases</para>
+        /// Configures an exist pool or creates a new one
+        /// <para>Does not create a new pool if <paramref name="bufferSize"/> is less that current <see cref="BufferSize"/></para>
         /// </summary>
-        ///
-        /// Note: we use an Array instead of a Stack because it's significantly
-        ///       faster: https://github.com/vis2k/Mirror/issues/1614
-        static PooledNetworkWriter[] pool = new PooledNetworkWriter[10];
-
-        static int next = -1;
-
-        /// <summary>
-        /// Get the next writer in the pool
-        /// <para>If pool is empty, creates a new Writer</para>
-        /// </summary>
-        public static PooledNetworkWriter GetWriter()
+        /// <param name="bufferSize">starting capacity of buffer</param>
+        /// <param name="startPoolSize"></param>
+        /// <param name="maxPoolSize"></param>
+        public static void Configure(int bufferSize, int startPoolSize = 5, int maxPoolSize = 100)
         {
-            if (next == -1)
+            // if new size is less, then just configure start/max
+            if (BufferSize.HasValue && bufferSize < BufferSize.Value)
             {
-                return new PooledNetworkWriter();
+                pool.Configure(startPoolSize, maxPoolSize);
             }
+            else
+            {
+                pool = new Pool<PooledNetworkWriter>(PooledNetworkWriter.CreateNew, bufferSize, startPoolSize, maxPoolSize, logger);
+                BufferSize = bufferSize;
+            }
+        }
 
-            PooledNetworkWriter writer = pool[next];
-            pool[next] = null;
-            next--;
-
-            // reset cached writer length and position
+        public static PooledNetworkWriter GetWriter()
+        {
+            if (pool == null) throw new InvalidOperationException("Configure must be called before ");
+            PooledNetworkWriter writer = pool.Take();
             writer.Reset();
             return writer;
         }
+    }
+
+    /// <summary>
+    /// NetworkWriter to be used with <see cref="NetworkWriterPool">NetworkWriterPool</see>
+    /// </summary>
+    public sealed class PooledNetworkWriter : NetworkWriter, IDisposable
+    {
+        private readonly Pool<PooledNetworkWriter> pool;
+
+        private PooledNetworkWriter(int bufferSize, Pool<PooledNetworkWriter> pool) : base(bufferSize)
+        {
+            this.pool = pool ?? throw new ArgumentNullException(nameof(pool));
+        }
+
+        public static PooledNetworkWriter CreateNew(int bufferSize, Pool<PooledNetworkWriter> pool)
+        {
+            return new PooledNetworkWriter(bufferSize, pool);
+        }
 
         /// <summary>
-        /// Puts writer back into pool
-        /// <para>When pool is full, the extra writer is left for the GC</para>
+        /// Puts object back in Pool
         /// </summary>
-        public static void Recycle(PooledNetworkWriter writer)
+        public void Release()
         {
-            if (next < pool.Length - 1)
-            {
-                next++;
-                pool[next] = writer;
-            }
-            else
-            {
-                logger.LogWarning("NetworkWriterPool.Recycle, Pool was full leaving extra writer for GC");
-            }
+            Reset();
+            pool.Put(this);
         }
+
+        void IDisposable.Dispose() => Release();
     }
 }
diff --git a/Assets/Mirage/Runtime/Serialization/StringExtensions.cs b/Assets/Mirage/Runtime/Serialization/StringExtensions.cs
index 7807c8b4f10..fa595521134 100644
--- a/Assets/Mirage/Runtime/Serialization/StringExtensions.cs
+++ b/Assets/Mirage/Runtime/Serialization/StringExtensions.cs
@@ -6,8 +6,14 @@ namespace Mirage.Serialization
 {
     public static class StringExtensions
     {
+        /// <summary>
+        /// Defaults MTU, 1300
+        /// <para>Can be changed by user if they need to</para>
+        /// </summary>
+        public static int MaxStringLength = 1300;
+
         static readonly UTF8Encoding encoding = new UTF8Encoding(false, true);
-        static readonly byte[] stringBuffer = new byte[NetworkWriter.MaxStringLength];
+        static readonly byte[] stringBuffer = new byte[MaxStringLength];
 
         /// <param name="value">string or null</param>
         public static void WriteString(this NetworkWriter writer, string value)
@@ -27,9 +33,9 @@ public static void WriteString(this NetworkWriter writer, string value)
             int size = encoding.GetBytes(value, 0, value.Length, stringBuffer, 0);
 
             // check if within max size
-            if (size >= NetworkWriter.MaxStringLength)
+            if (size >= MaxStringLength)
             {
-                throw new DataMisalignedException($"NetworkWriter.Write(string) too long: {size}. Limit: {NetworkWriter.MaxStringLength}");
+                throw new DataMisalignedException($"NetworkWriter.Write(string) too long: {size}. Limit: {MaxStringLength}");
             }
 
             // write size and bytes
@@ -51,9 +57,9 @@ public static string ReadString(this NetworkReader reader)
             int realSize = size - 1;
 
             // make sure it's within limits to avoid allocation attacks etc.
-            if (realSize >= NetworkWriter.MaxStringLength)
+            if (realSize >= MaxStringLength)
             {
-                throw new EndOfStreamException("ReadString too long: {realSize}. Limit is: {NetworkWriter.MaxStringLength}");
+                throw new EndOfStreamException($"ReadString too long: {realSize}. Limit is: {MaxStringLength}");
             }
 
             ArraySegment<byte> data = reader.ReadBytesSegment(realSize);
diff --git a/Assets/Mirage/Runtime/Serialization/SystemTypesExtensions.cs b/Assets/Mirage/Runtime/Serialization/SystemTypesExtensions.cs
index b14f0091c76..4356123bfb5 100644
--- a/Assets/Mirage/Runtime/Serialization/SystemTypesExtensions.cs
+++ b/Assets/Mirage/Runtime/Serialization/SystemTypesExtensions.cs
@@ -1,26 +1,69 @@
 using System;
+using System.Runtime.InteropServices;
 
 namespace Mirage.Serialization
 {
     public static class SystemTypesExtensions
     {
-        public static void WriteByte(this NetworkWriter writer, byte value) => writer.WriteByte(value);
+        // todo benchmark converters 
+        /// <summary>
+        /// Converts between uint and float without allocations
+        /// </summary>
+        [StructLayout(LayoutKind.Explicit)]
+        internal struct UIntFloat
+        {
+            [FieldOffset(0)]
+            public float floatValue;
+
+            [FieldOffset(0)]
+            public uint intValue;
+        }
+
+        /// <summary>
+        /// Converts between ulong and double without allocations
+        /// </summary>
+        [StructLayout(LayoutKind.Explicit)]
+        internal struct UIntDouble
+        {
+            [FieldOffset(0)]
+            public double doubleValue;
+
+            [FieldOffset(0)]
+            public ulong longValue;
+        }
+
+        /// <summary>
+        /// Converts between ulong and decimal without allocations
+        /// </summary>
+        [StructLayout(LayoutKind.Explicit)]
+        internal struct UIntDecimal
+        {
+            [FieldOffset(0)]
+            public ulong longValue1;
 
-        public static void WriteSByte(this NetworkWriter writer, sbyte value) => writer.WriteByte((byte)value);
+            [FieldOffset(8)]
+            public ulong longValue2;
+
+            [FieldOffset(0)]
+            public decimal decimalValue;
+        }
+
+        public static void WriteByteExtension(this NetworkWriter writer, byte value) => writer.WriteByte(value);
+
+        public static void WriteSByteExtension(this NetworkWriter writer, sbyte value) => writer.WriteSByte(value);
 
         public static void WriteChar(this NetworkWriter writer, char value) => writer.WriteUInt16(value);
 
-        public static void WriteBoolean(this NetworkWriter writer, bool value) => writer.WriteByte((byte)(value ? 1 : 0));
+        public static void WriteBooleanExtension(this NetworkWriter writer, bool value) => writer.WriteBoolean(value);
 
-        public static void WriteUInt16(this NetworkWriter writer, ushort value)
+        public static void WriteUInt16Extension(this NetworkWriter writer, ushort value)
         {
-            writer.WriteByte((byte)value);
-            writer.WriteByte((byte)(value >> 8));
+            writer.WriteUInt16(value);
         }
 
-        public static void WriteInt16(this NetworkWriter writer, short value) => writer.WriteUInt16((ushort)value);
+        public static void WriteInt16Extension(this NetworkWriter writer, short value) => writer.WriteInt16(value);
 
-        public static void WriteSingle(this NetworkWriter writer, float value)
+        public static void WriteSingleConverter(this NetworkWriter writer, float value)
         {
             var converter = new UIntFloat
             {
@@ -28,8 +71,7 @@ public static void WriteSingle(this NetworkWriter writer, float value)
             };
             writer.WriteUInt32(converter.intValue);
         }
-
-        public static void WriteDouble(this NetworkWriter writer, double value)
+        public static void WriteDoubleConverter(this NetworkWriter writer, double value)
         {
             var converter = new UIntDouble
             {
@@ -37,8 +79,7 @@ public static void WriteDouble(this NetworkWriter writer, double value)
             };
             writer.WriteUInt64(converter.longValue);
         }
-
-        public static void WriteDecimal(this NetworkWriter writer, decimal value)
+        public static void WriteDecimalConverter(this NetworkWriter writer, decimal value)
         {
             // the only way to read it without allocations is to both read and
             // write it with the FloatConverter (which is not binary compatible
@@ -70,19 +111,13 @@ public static void WriteGuid(this NetworkWriter writer, Guid value)
 
 
 
-        public static byte ReadByte(this NetworkReader reader) => reader.ReadByte();
-        public static sbyte ReadSByte(this NetworkReader reader) => (sbyte)reader.ReadByte();
+        public static byte ReadByteExtension(this NetworkReader reader) => reader.ReadByte();
+        public static sbyte ReadSByteExtension(this NetworkReader reader) => reader.ReadSByte();
         public static char ReadChar(this NetworkReader reader) => (char)reader.ReadUInt16();
-        public static bool ReadBoolean(this NetworkReader reader) => reader.ReadByte() != 0;
-        public static short ReadInt16(this NetworkReader reader) => (short)reader.ReadUInt16();
-        public static ushort ReadUInt16(this NetworkReader reader)
-        {
-            ushort value = 0;
-            value |= reader.ReadByte();
-            value |= (ushort)(reader.ReadByte() << 8);
-            return value;
-        }
-        public static float ReadSingle(this NetworkReader reader)
+        public static bool ReadBooleanExtension(this NetworkReader reader) => reader.ReadBoolean();
+        public static short ReadInt16Extension(this NetworkReader reader) => reader.ReadInt16();
+        public static ushort ReadUInt16Extension(this NetworkReader reader) => reader.ReadUInt16();
+        public static float ReadSingleConverter(this NetworkReader reader)
         {
             var converter = new UIntFloat
             {
@@ -90,7 +125,7 @@ public static float ReadSingle(this NetworkReader reader)
             };
             return converter.floatValue;
         }
-        public static double ReadDouble(this NetworkReader reader)
+        public static double ReadDoubleConverter(this NetworkReader reader)
         {
             var converter = new UIntDouble
             {
@@ -98,7 +133,7 @@ public static double ReadDouble(this NetworkReader reader)
             };
             return converter.doubleValue;
         }
-        public static decimal ReadDecimal(this NetworkReader reader)
+        public static decimal ReadDecimalConverter(this NetworkReader reader)
         {
             var converter = new UIntDecimal
             {
diff --git a/Assets/Mirage/Runtime/Serialization/TypeConversion.cs b/Assets/Mirage/Runtime/Serialization/TypeConversion.cs
deleted file mode 100644
index 9125dca569d..00000000000
--- a/Assets/Mirage/Runtime/Serialization/TypeConversion.cs
+++ /dev/null
@@ -1,47 +0,0 @@
-using System.Runtime.InteropServices;
-
-namespace Mirage.Serialization
-{
-
-    /// <summary>
-    /// Converts between uint and float without allocations
-    /// </summary>
-    [StructLayout(LayoutKind.Explicit)]
-    internal struct UIntFloat
-    {
-        [FieldOffset(0)]
-        public float floatValue;
-
-        [FieldOffset(0)]
-        public uint intValue;
-    }
-
-    /// <summary>
-    /// Converts between ulong and double without allocations
-    /// </summary>
-    [StructLayout(LayoutKind.Explicit)]
-    internal struct UIntDouble
-    {
-        [FieldOffset(0)]
-        public double doubleValue;
-
-        [FieldOffset(0)]
-        public ulong longValue;
-    }
-
-    /// <summary>
-    /// Converts between ulong and decimal without allocations
-    /// </summary>
-    [StructLayout(LayoutKind.Explicit)]
-    internal struct UIntDecimal
-    {
-        [FieldOffset(0)]
-        public ulong longValue1;
-
-        [FieldOffset(8)]
-        public ulong longValue2;
-
-        [FieldOffset(0)]
-        public decimal decimalValue;
-    }
-}
\ No newline at end of file
diff --git a/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs b/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
index 182fe7a3dba..14d1fffe73a 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
@@ -38,7 +38,7 @@ internal class AckSystem
 
         readonly IRawConnection connection;
         readonly ITime time;
-        readonly BufferPool bufferPool;
+        readonly Pool<ByteBuffer> bufferPool;
         readonly Metrics metrics;
 
         //todo implement this
@@ -77,7 +77,7 @@ internal class AckSystem
         /// <param name="connection"></param>
         /// <param name="ackTimeout">how long after last send before sending empty ack</param>
         /// <param name="time"></param>
-        public AckSystem(IRawConnection connection, Config config, ITime time, BufferPool bufferPool, Metrics metrics = null)
+        public AckSystem(IRawConnection connection, Config config, ITime time, Pool<ByteBuffer> bufferPool, Metrics metrics = null)
         {
             if (config == null) throw new ArgumentNullException(nameof(config));
 
diff --git a/Assets/Mirage/Runtime/SocketLayer/ByteBuffer.cs b/Assets/Mirage/Runtime/SocketLayer/ByteBuffer.cs
new file mode 100644
index 00000000000..768a5d41b05
--- /dev/null
+++ b/Assets/Mirage/Runtime/SocketLayer/ByteBuffer.cs
@@ -0,0 +1,32 @@
+using System;
+
+namespace Mirage.SocketLayer
+{
+    /// <summary>
+    /// Warpper around a byte[] that belongs to a <see cref="BufferPool"/>
+    /// </summary>
+    public sealed class ByteBuffer : IDisposable
+    {
+        public readonly byte[] array;
+        readonly Pool<ByteBuffer> pool;
+
+        private ByteBuffer(int bufferSize, Pool<ByteBuffer> pool)
+        {
+            this.pool = pool ?? throw new ArgumentNullException(nameof(pool));
+
+            array = new byte[bufferSize];
+        }
+
+        public static ByteBuffer CreateNew(int bufferSize, Pool<ByteBuffer> pool)
+        {
+            return new ByteBuffer(bufferSize, pool);
+        }
+
+        public void Release()
+        {
+            pool.Put(this);
+        }
+
+        void IDisposable.Dispose() => Release();
+    }
+}
diff --git a/Assets/Tests/Runtime/Serialization/NetworkWriterPoolTest.cs.meta b/Assets/Mirage/Runtime/SocketLayer/ByteBuffer.cs.meta
similarity index 83%
rename from Assets/Tests/Runtime/Serialization/NetworkWriterPoolTest.cs.meta
rename to Assets/Mirage/Runtime/SocketLayer/ByteBuffer.cs.meta
index 397df911764..222ecdeae93 100644
--- a/Assets/Tests/Runtime/Serialization/NetworkWriterPoolTest.cs.meta
+++ b/Assets/Mirage/Runtime/SocketLayer/ByteBuffer.cs.meta
@@ -1,5 +1,5 @@
 fileFormatVersion: 2
-guid: d11bb8e42a76bf248892f8b398b0dd57
+guid: d4a3e8b3aacf45b43bf3e29826cf13ac
 MonoImporter:
   externalObjects: {}
   serializedVersion: 2
diff --git a/Assets/Mirage/Runtime/SocketLayer/Connection.cs b/Assets/Mirage/Runtime/SocketLayer/Connection.cs
index 88ebfb05c68..e8a6c8a65bf 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Connection.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Connection.cs
@@ -108,7 +108,7 @@ public ConnectionState State
 
         IEndPoint IConnection.EndPoint => EndPoint;
 
-        internal Connection(Peer peer, IEndPoint endPoint, IDataHandler dataHandler, Config config, Time time, BufferPool bufferPool, ILogger logger, Metrics metrics)
+        internal Connection(Peer peer, IEndPoint endPoint, IDataHandler dataHandler, Config config, Time time, Pool<ByteBuffer> bufferPool, ILogger logger, Metrics metrics)
         {
             this.peer = peer;
             this.logger = logger ?? Debug.unityLogger;
diff --git a/Assets/Mirage/Runtime/SocketLayer/Peer.cs b/Assets/Mirage/Runtime/SocketLayer/Peer.cs
index 5908c4c2f00..63b2ecdf2ed 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Peer.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Peer.cs
@@ -46,7 +46,7 @@ void Error(string error)
         readonly Time time;
 
         readonly ConnectKeyValidator connectKeyValidator;
-        readonly BufferPool bufferPool;
+        readonly Pool<ByteBuffer> bufferPool;
         readonly Dictionary<IEndPoint, Connection> connections = new Dictionary<IEndPoint, Connection>();
         // list so that remove can take place after foreach loops
         readonly List<Connection> connectionsToRemove = new List<Connection>();
@@ -71,8 +71,8 @@ public Peer(ISocket socket, IDataHandler dataHandler, Config config = null, ILog
             time = new Time();
 
             connectKeyValidator = new ConnectKeyValidator();
-            bufferPool = new BufferPool(this.config.MaxPacketSize, this.config.BufferPoolStartSize, this.config.BufferPoolMaxSize, this.logger);
-
+            
+            bufferPool = new Pool<ByteBuffer>(ByteBuffer.CreateNew, this.config.MaxPacketSize, this.config.BufferPoolStartSize, this.config.BufferPoolMaxSize, this.logger);
             Application.quitting += Application_quitting;
         }
 
diff --git a/Assets/Mirage/Runtime/SocketLayer/BufferPool.cs b/Assets/Mirage/Runtime/SocketLayer/Pool.cs
similarity index 53%
rename from Assets/Mirage/Runtime/SocketLayer/BufferPool.cs
rename to Assets/Mirage/Runtime/SocketLayer/Pool.cs
index 94a9ce9696c..a0700e3f218 100644
--- a/Assets/Mirage/Runtime/SocketLayer/BufferPool.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Pool.cs
@@ -3,44 +3,46 @@
 
 namespace Mirage.SocketLayer
 {
-    /// <summary>
-    /// Warpper around a byte[] that belongs to a <see cref="BufferPool"/>
-    /// </summary>
-    public sealed class ByteBuffer : IDisposable
-    {
-        public readonly byte[] array;
-        readonly BufferPool pool;
-
-        public ByteBuffer(int bufferSize, BufferPool pool)
-        {
-            this.pool = pool ?? throw new ArgumentNullException(nameof(pool));
-
-            array = new byte[bufferSize];
-        }
-
-        public void Release()
-        {
-            pool.Put(this);
-        }
-
-        void IDisposable.Dispose() => Release();
-    }
-
     /// <summary>
     /// Holds a collection of <see cref="ByteBuffer"/> so they can be re-used without allocations
     /// </summary>
-    public class BufferPool
+    public class Pool<T> where T : class
     {
         const int PoolEmpty = -1;
 
+        int maxPoolSize;
         readonly int bufferSize;
-        readonly int maxPoolSize;
         readonly ILogger logger;
+        readonly Func<int, Pool<T>, T> createNew;
+
 
-        readonly ByteBuffer[] pool;
+        T[] pool;
         int next = -1;
         int created = 0;
 
+        /// <summary>
+        /// sets max pool size and then creates writers up to new start size
+        /// </summary>
+        /// <param name="startPoolSize"></param>
+        /// <param name="maxPoolSize"></param>
+        public void Configure(int startPoolSize, int maxPoolSize)
+        {
+            if (startPoolSize > maxPoolSize) throw new ArgumentException("Start Size must be less than max size", nameof(startPoolSize));
+
+            if (this.maxPoolSize != maxPoolSize)
+            {
+                this.maxPoolSize = maxPoolSize;
+                Array.Resize(ref pool, maxPoolSize);
+            }
+
+            for (int i = created; i < startPoolSize; i++)
+            {
+                Put(CreateNewBuffer());
+            }
+
+            if (logger.IsLogTypeAllowed(LogType.Log)) logger.Log(LogType.Log, $"Configuring buffer, start Size {startPoolSize}, max size {maxPoolSize}");
+        }
+
         /// <summary>
         /// 
         /// </summary>
@@ -48,29 +50,30 @@ public class BufferPool
         /// <param name="startPoolSize">how many buffers to create at start</param>
         /// <param name="maxPoolSize">max number of buffers in pool</param>
         /// <param name="logger"></param>
-        public BufferPool(int bufferSize, int startPoolSize, int maxPoolSize, ILogger logger = null)
+        public Pool(Func<int, Pool<T>, T> createNew, int bufferSize, int startPoolSize, int maxPoolSize, ILogger logger = null)
         {
-            if (startPoolSize > maxPoolSize) throw new ArgumentException("Start Size must be less than max size", nameof(startPoolSize));
+            if (startPoolSize > maxPoolSize) throw new ArgumentException("Start size must be less than max size", nameof(startPoolSize));
+            this.createNew = createNew ?? throw new ArgumentNullException(nameof(createNew));
 
             this.bufferSize = bufferSize;
             this.maxPoolSize = maxPoolSize;
             this.logger = logger ?? Debug.unityLogger;
 
-            pool = new ByteBuffer[maxPoolSize];
+            pool = new T[maxPoolSize];
             for (int i = 0; i < startPoolSize; i++)
             {
                 Put(CreateNewBuffer());
             }
         }
 
-        private ByteBuffer CreateNewBuffer()
+        private T CreateNewBuffer()
         {
-            if (created >= maxPoolSize && logger.IsLogTypeAllowed(LogType.Warning)) logger.Log(LogType.Warning, $"Buffer Max Size reached, created:{created} max:{maxPoolSize}");
+            if (created >= maxPoolSize && logger.IsLogTypeAllowed(LogType.Warning)) logger.Log(LogType.Warning, $"Buffer Max Size reached, created:{created + 1} max:{maxPoolSize}");
             created++;
-            return new ByteBuffer(bufferSize, this);
+            return createNew.Invoke(bufferSize, this);
         }
 
-        public ByteBuffer Take()
+        public T Take()
         {
             if (next == PoolEmpty)
             {
@@ -78,14 +81,17 @@ public ByteBuffer Take()
             }
             else
             {
-                // todo is it a security risk to now clear buffer?
+                // todo is it a security risk to not clear buffer?
 
-                // take then decriment
-                return pool[next--];
+                // take then decrement
+                T item = pool[next];
+                pool[next] = null;
+                next--;
+                return item;
             }
         }
 
-        public void Put(ByteBuffer buffer)
+        public void Put(T buffer)
         {
             if (next < maxPoolSize - 1)
             {
diff --git a/Assets/Mirage/Runtime/SocketLayer/BufferPool.cs.meta b/Assets/Mirage/Runtime/SocketLayer/Pool.cs.meta
similarity index 100%
rename from Assets/Mirage/Runtime/SocketLayer/BufferPool.cs.meta
rename to Assets/Mirage/Runtime/SocketLayer/Pool.cs.meta
diff --git a/Assets/Mirage/Weaver/Processors/ClientRpcProcessor.cs b/Assets/Mirage/Weaver/Processors/ClientRpcProcessor.cs
index e61d2ef23e5..642d115c8bf 100644
--- a/Assets/Mirage/Weaver/Processors/ClientRpcProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/ClientRpcProcessor.cs
@@ -4,6 +4,7 @@
 using Mirage.Serialization;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
+
 namespace Mirage.Weaver
 {
     public enum Client { Owner, Observers, Connection }
@@ -67,8 +68,8 @@ MethodDefinition GenerateSkeleton(MethodDefinition md, MethodDefinition userCode
 
             if (hasNetworkConnection)
             {
-               // this is called in the skeleton (the client)
-               // the client should just get the connection to the server and pass that in
+                // this is called in the skeleton (the client)
+                // the client should just get the connection to the server and pass that in
                 worker.Append(worker.Create(OpCodes.Ldarg_0));
                 worker.Append(worker.Create(OpCodes.Call, (NetworkBehaviour nb) => nb.Client));
                 worker.Append(worker.Create(OpCodes.Call, (NetworkClient nb) => nb.Player));
@@ -193,9 +194,7 @@ MethodDefinition GenerateStub(MethodDefinition md, CustomAttribute clientRpcAttr
                 worker.Append(worker.Create(OpCodes.Callvirt, sendTargetRpcRef));
             }
 
-            // NetworkWriterPool.Recycle(writer);
-            worker.Append(worker.Create(OpCodes.Ldloc, writer));
-            worker.Append(worker.Create(OpCodes.Call, () => NetworkWriterPool.Recycle(default)));
+            NetworkWriterHelper.CallRelease(module, worker, writer);
 
             worker.Append(worker.Create(OpCodes.Ret));
 
diff --git a/Assets/Mirage/Weaver/Processors/NetworkWriterHelper.cs b/Assets/Mirage/Weaver/Processors/NetworkWriterHelper.cs
new file mode 100644
index 00000000000..a05be735fb4
--- /dev/null
+++ b/Assets/Mirage/Weaver/Processors/NetworkWriterHelper.cs
@@ -0,0 +1,26 @@
+using Mirage.Serialization;
+using Mono.Cecil;
+using Mono.Cecil.Cil;
+
+namespace Mirage.Weaver
+{
+    public static class NetworkWriterHelper
+    {
+        public static void CallRelease(ModuleDefinition module, ILProcessor worker, VariableDefinition writer)
+        {
+            MethodReference releaseMethod = GetReleaseMethod(module, writer);
+
+            worker.Append(worker.Create(OpCodes.Ldloc, writer));
+            worker.Append(worker.Create(OpCodes.Call, releaseMethod));
+        }
+        public static MethodReference GetReleaseMethod(ModuleDefinition module, VariableDefinition writer)
+        {
+            return GetReleaseMethod(module, writer.VariableType.Resolve());
+        }
+        public static MethodReference GetReleaseMethod(ModuleDefinition module, TypeDefinition writer)
+        {
+            MethodDefinition releaseMethod = writer.GetMethod(nameof(PooledNetworkWriter.Release));
+            return module.ImportReference(releaseMethod);
+        }
+    }
+}
diff --git a/Assets/Mirage/Weaver/Processors/NetworkWriterHelper.cs.meta b/Assets/Mirage/Weaver/Processors/NetworkWriterHelper.cs.meta
new file mode 100644
index 00000000000..27d2fbcfd45
--- /dev/null
+++ b/Assets/Mirage/Weaver/Processors/NetworkWriterHelper.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: e7ae4c2cb4f82c24c811d9c1cfb69cf9
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Weaver/Processors/ReaderWriterProcessor.cs b/Assets/Mirage/Weaver/Processors/ReaderWriterProcessor.cs
index a7a6f50e5ab..63a346eb88e 100644
--- a/Assets/Mirage/Weaver/Processors/ReaderWriterProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/ReaderWriterProcessor.cs
@@ -202,8 +202,8 @@ private static bool IsMessageMethod(MethodReference method)
         private static bool IsReadWriteMethod(MethodReference method)
         {
             return
-                method.Is<NetworkWriter>(nameof(NetworkWriter.Write)) ||
-                method.Is<NetworkReader>(nameof(NetworkReader.Read));
+                method.Is(typeof(GenericTypesSerializationExtensions), nameof(GenericTypesSerializationExtensions.Write)) ||
+                method.Is(typeof(GenericTypesSerializationExtensions), nameof(GenericTypesSerializationExtensions.Read));
         }
 
 
diff --git a/Assets/Mirage/Weaver/Processors/ServerRpcProcessor.cs b/Assets/Mirage/Weaver/Processors/ServerRpcProcessor.cs
index 76f11dba7b5..ce9e482b1fb 100644
--- a/Assets/Mirage/Weaver/Processors/ServerRpcProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/ServerRpcProcessor.cs
@@ -97,9 +97,7 @@ MethodDefinition GenerateStub(MethodDefinition md, CustomAttribute serverRpcAttr
             worker.Append(worker.Create(requireAuthority ? OpCodes.Ldc_I4_1 : OpCodes.Ldc_I4_0));
             CallSendServerRpc(md, worker);
 
-            // NetworkWriterPool.Recycle(writer);
-            worker.Append(worker.Create(OpCodes.Ldloc, writer));
-            worker.Append(worker.Create(OpCodes.Call, () => NetworkWriterPool.Recycle(default)));
+            NetworkWriterHelper.CallRelease(module, worker, writer);
 
             worker.Append(worker.Create(OpCodes.Ret));
 
diff --git a/Assets/Tests/Editor/NetworkIdentityCallbackTests.cs b/Assets/Tests/Editor/NetworkIdentityCallbackTests.cs
index 7e80f1301b2..153131952a9 100644
--- a/Assets/Tests/Editor/NetworkIdentityCallbackTests.cs
+++ b/Assets/Tests/Editor/NetworkIdentityCallbackTests.cs
@@ -502,8 +502,8 @@ public void OnSerializeAllSafely()
             comp2.syncMode = SyncMode.Owner;
 
             // serialize all
-            var ownerWriter = new NetworkWriter();
-            var observersWriter = new NetworkWriter();
+            var ownerWriter = new NetworkWriter(1300);
+            var observersWriter = new NetworkWriter(1300);
 
             // serialize should propagate exceptions
             Assert.Throws<Exception>(() =>
@@ -547,8 +547,8 @@ public void OnDeserializeSafelyShouldDetectAndHandleDeSerializationMismatch()
             comp2.value = "67890";
 
             // serialize
-            var ownerWriter = new NetworkWriter();
-            var observersWriter = new NetworkWriter();
+            var ownerWriter = new NetworkWriter(1300);
+            var observersWriter = new NetworkWriter(1300);
             identity.OnSerializeAll(true, ownerWriter, observersWriter);
 
             // reset component values
@@ -556,11 +556,13 @@ public void OnDeserializeSafelyShouldDetectAndHandleDeSerializationMismatch()
             comp2.value = null;
 
             // deserialize all
-            var reader = new NetworkReader(ownerWriter.ToArray());
+            var reader = new NetworkReader();
+            reader.Reset(ownerWriter.ToArraySegment());
             Assert.Throws<DeserializeFailedException>(() =>
             {
                 identity.OnDeserializeAll(reader, true);
             });
+            reader.Dispose();
         }
 
         [Test]
diff --git a/Assets/Tests/Editor/NetworkTransformTest.cs b/Assets/Tests/Editor/NetworkTransformTest.cs
index 12f10774874..57f2a545ecb 100644
--- a/Assets/Tests/Editor/NetworkTransformTest.cs
+++ b/Assets/Tests/Editor/NetworkTransformTest.cs
@@ -7,16 +7,27 @@ namespace Mirage
     [TestFixture]
     public class NetworkTransformTest
     {
+        readonly NetworkWriter writer = new NetworkWriter(1300);
+        readonly NetworkReader reader = new NetworkReader();
+
+        [TearDown]
+        public void TearDown()
+        {
+            writer.Reset();
+            reader.Dispose();
+        }
+
         [Test]
         public void SerializeIntoWriterTest()
         {
-            var writer = new NetworkWriter();
             var position = new Vector3(1, 2, 3);
             var rotation = new Quaternion(0.1f, 0.2f, 0.3f, 0.4f);
             var scale = new Vector3(0.5f, 0.6f, 0.7f);
 
             NetworkTransformBase.SerializeIntoWriter(writer, position, rotation, scale);
-            var reader = new NetworkReader(writer.ToArray());
+
+            reader.Reset(writer.ToArraySegment());
+
             Assert.That(reader.ReadVector3(), Is.EqualTo(position));
             Assert.That(reader.ReadQuaternion(), Is.EqualTo(rotation));
             Assert.That(reader.ReadVector3(), Is.EqualTo(scale));
diff --git a/Assets/Tests/Runtime/Collections/SyncDictionaryTest.cs b/Assets/Tests/Runtime/Collections/SyncDictionaryTest.cs
index b6b8b08802e..3a141747359 100644
--- a/Assets/Tests/Runtime/Collections/SyncDictionaryTest.cs
+++ b/Assets/Tests/Runtime/Collections/SyncDictionaryTest.cs
@@ -1,7 +1,6 @@
 using System;
 using System.Collections.Generic;
 using Mirage.Collections;
-using Mirage.Serialization;
 using NSubstitute;
 using NUnit.Framework;
 
@@ -17,23 +16,6 @@ public class SyncDictionaryIntString : SyncDictionary<int, string>
         SyncDictionaryIntString serverSyncDictionary;
         SyncDictionaryIntString clientSyncDictionary;
 
-        void SerializeAllTo<T>(T fromList, T toList) where T : ISyncObject
-        {
-            var writer = new NetworkWriter();
-            fromList.OnSerializeAll(writer);
-            var reader = new NetworkReader(writer.ToArray());
-            toList.OnDeserializeAll(reader);
-        }
-
-        void SerializeDeltaTo<T>(T fromList, T toList) where T : ISyncObject
-        {
-            var writer = new NetworkWriter();
-            fromList.OnSerializeDelta(writer);
-            var reader = new NetworkReader(writer.ToArray());
-            toList.OnDeserializeDelta(reader);
-            fromList.Flush();
-        }
-
         [SetUp]
         public void SetUp()
         {
@@ -44,7 +26,7 @@ public void SetUp()
             serverSyncDictionary.Add(0, "Hello");
             serverSyncDictionary.Add(1, "World");
             serverSyncDictionary.Add(2, "!");
-            SerializeAllTo(serverSyncDictionary, clientSyncDictionary);
+            SerializeHelper.SerializeAllTo(serverSyncDictionary, clientSyncDictionary);
         }
 
         [Test]
@@ -65,7 +47,7 @@ public void ClearEventOnSyncAll()
         {
             Action callback = Substitute.For<Action>();
             clientSyncDictionary.OnClear += callback;
-            SerializeAllTo(serverSyncDictionary, clientSyncDictionary);
+            SerializeHelper.SerializeAllTo(serverSyncDictionary, clientSyncDictionary);
             callback.Received().Invoke();
         }
 
@@ -74,7 +56,7 @@ public void InsertEventOnSyncAll()
         {
             Action<int, string> callback = Substitute.For<Action<int, string>>();
             clientSyncDictionary.OnInsert += callback;
-            SerializeAllTo(serverSyncDictionary, clientSyncDictionary);
+            SerializeHelper.SerializeAllTo(serverSyncDictionary, clientSyncDictionary);
 
             callback.Received().Invoke(0, "Hello");
             callback.Received().Invoke(1, "World");
@@ -86,7 +68,7 @@ public void ChangeEventOnSyncAll()
         {
             Action callback = Substitute.For<Action>();
             clientSyncDictionary.OnChange += callback;
-            SerializeAllTo(serverSyncDictionary, clientSyncDictionary);
+            SerializeHelper.SerializeAllTo(serverSyncDictionary, clientSyncDictionary);
             callback.Received().Invoke();
         }
 
@@ -94,7 +76,7 @@ public void ChangeEventOnSyncAll()
         public void TestAdd()
         {
             serverSyncDictionary.Add(4, "yay");
-            SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
+            SerializeHelper.SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
             Assert.That(clientSyncDictionary.ContainsKey(4));
             Assert.That(clientSyncDictionary[4], Is.EqualTo("yay"));
         }
@@ -103,7 +85,7 @@ public void TestAdd()
         public void TestClear()
         {
             serverSyncDictionary.Clear();
-            SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
+            SerializeHelper.SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
             Assert.That(serverSyncDictionary, Is.EquivalentTo(new SyncDictionaryIntString()));
         }
 
@@ -111,7 +93,7 @@ public void TestClear()
         public void TestSet()
         {
             serverSyncDictionary[1] = "yay";
-            SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
+            SerializeHelper.SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
             Assert.That(clientSyncDictionary.ContainsKey(1));
             Assert.That(clientSyncDictionary[1], Is.EqualTo("yay"));
         }
@@ -120,7 +102,7 @@ public void TestSet()
         public void TestBareSet()
         {
             serverSyncDictionary[4] = "yay";
-            SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
+            SerializeHelper.SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
             Assert.That(clientSyncDictionary.ContainsKey(4));
             Assert.That(clientSyncDictionary[4], Is.EqualTo("yay"));
         }
@@ -129,7 +111,7 @@ public void TestBareSet()
         public void TestBareSetNull()
         {
             serverSyncDictionary[4] = null;
-            SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
+            SerializeHelper.SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
             Assert.That(clientSyncDictionary[4], Is.Null);
             Assert.That(clientSyncDictionary.ContainsKey(4));
         }
@@ -139,7 +121,7 @@ public void TestConsecutiveSet()
         {
             serverSyncDictionary[1] = "yay";
             serverSyncDictionary[1] = "world";
-            SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
+            SerializeHelper.SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
             Assert.That(clientSyncDictionary[1], Is.EqualTo("world"));
         }
 
@@ -147,7 +129,7 @@ public void TestConsecutiveSet()
         public void TestNullSet()
         {
             serverSyncDictionary[1] = null;
-            SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
+            SerializeHelper.SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
             Assert.That(clientSyncDictionary.ContainsKey(1));
             Assert.That(clientSyncDictionary[1], Is.Null);
         }
@@ -156,7 +138,7 @@ public void TestNullSet()
         public void TestRemove()
         {
             serverSyncDictionary.Remove(1);
-            SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
+            SerializeHelper.SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
             Assert.That(!clientSyncDictionary.ContainsKey(1));
         }
 
@@ -164,10 +146,10 @@ public void TestRemove()
         public void TestMultSync()
         {
             serverSyncDictionary.Add(10, "1");
-            SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
+            SerializeHelper.SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
             // add some delta and see if it applies
             serverSyncDictionary.Add(11, "2");
-            SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
+            SerializeHelper.SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
             Assert.That(clientSyncDictionary.ContainsKey(10));
             Assert.That(clientSyncDictionary[10], Is.EqualTo("1"));
             Assert.That(clientSyncDictionary.ContainsKey(11));
@@ -179,7 +161,7 @@ public void TestContains()
         {
             Assert.That(!clientSyncDictionary.Contains(new KeyValuePair<int, string>(2, "Hello")));
             serverSyncDictionary[2] = "Hello";
-            SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
+            SerializeHelper.SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
             Assert.That(clientSyncDictionary.Contains(new KeyValuePair<int, string>(2, "Hello")));
         }
 
@@ -189,7 +171,7 @@ public void AddClientCallbackTest()
             Action<int, string> callback = Substitute.For<Action<int, string>>();
             clientSyncDictionary.OnInsert += callback;
             serverSyncDictionary.Add(3, "yay");
-            SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
+            SerializeHelper.SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
             callback.Received().Invoke(3, "yay");
         }
 
@@ -199,7 +181,7 @@ public void AddServerCallbackTest()
             Action<int, string> callback = Substitute.For<Action<int, string>>();
             serverSyncDictionary.OnInsert += callback;
             serverSyncDictionary.Add(3, "yay");
-            SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
+            SerializeHelper.SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
             callback.Received().Invoke(3, "yay");
         }
 
@@ -209,7 +191,7 @@ public void RemoveClientCallbackTest()
             Action<int, string> callback = Substitute.For<Action<int, string>>();
             clientSyncDictionary.OnRemove += callback;
             serverSyncDictionary.Remove(1);
-            SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
+            SerializeHelper.SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
             callback.Received().Invoke(1, "World");
         }
 
@@ -219,7 +201,7 @@ public void ClearClientCallbackTest()
             Action callback = Substitute.For<Action>();
             clientSyncDictionary.OnClear += callback;
             serverSyncDictionary.Clear();
-            SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
+            SerializeHelper.SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
             callback.Received().Invoke();
         }
 
@@ -230,7 +212,7 @@ public void ChangeClientCallbackTest()
             clientSyncDictionary.OnChange += callback;
             serverSyncDictionary.Add(3, "1");
             serverSyncDictionary.Add(4, "1");
-            SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
+            SerializeHelper.SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
             callback.Received(1).Invoke();
         }
 
@@ -240,7 +222,7 @@ public void SetClientCallbackTest()
             Action<int, string, string> callback = Substitute.For<Action<int, string, string>>();
             clientSyncDictionary.OnSet += callback;
             serverSyncDictionary[0] = "yay";
-            SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
+            SerializeHelper.SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
             callback.Received().Invoke(0, "Hello", "yay");
         }
 
@@ -320,7 +302,7 @@ public void WritingToReadOnlyThrows()
         public void DirtyTest()
         {
             // Sync Delta to clear dirty
-            SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
+            SerializeHelper.SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
 
             // nothing to send
             Assert.That(serverSyncDictionary.IsDirty, Is.False);
@@ -328,7 +310,7 @@ public void DirtyTest()
             // something has changed
             serverSyncDictionary.Add(15, "yay");
             Assert.That(serverSyncDictionary.IsDirty, Is.True);
-            SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
+            SerializeHelper.SerializeDeltaTo(serverSyncDictionary, clientSyncDictionary);
 
             // data has been flushed,  should go back to clear
             Assert.That(serverSyncDictionary.IsDirty, Is.False);
@@ -349,7 +331,7 @@ public void ObjectCanBeReusedAfterReset()
             // Check Add and Sync without errors
             hostList.Add(30, "hello");
             hostList.Add(35, "world");
-            SerializeDeltaTo(hostList, clientList2);
+            SerializeHelper.SerializeDeltaTo(hostList, clientList2);
         }
 
         [Test]
diff --git a/Assets/Tests/Runtime/Collections/SyncListClassTest.cs b/Assets/Tests/Runtime/Collections/SyncListClassTest.cs
index e1cf3c95585..4a5e188a74f 100644
--- a/Assets/Tests/Runtime/Collections/SyncListClassTest.cs
+++ b/Assets/Tests/Runtime/Collections/SyncListClassTest.cs
@@ -19,7 +19,7 @@ public void RemoveShouldRemoveItem()
             var serverList = new SyncList<TestObject>();
             var clientList = new SyncList<TestObject>();
 
-            SyncListTest.SerializeAllTo(serverList, clientList);
+            SerializeHelper.SerializeAllTo(serverList, clientList);
 
             // add some items
             var item1 = new TestObject { id = 1, text = "Lorem ipsum dolor sit, amet consectetur adipisicing elit. Nostrum ullam aliquid perferendis, aut nihil sunt quod ipsum corporis a. Cupiditate, alias. Commodi, molestiae distinctio repellendus dolor similique delectus inventore eum." };
@@ -28,13 +28,13 @@ public void RemoveShouldRemoveItem()
             serverList.Add(item2);
 
             // sync
-            SyncListTest.SerializeDeltaTo(serverList, clientList);
+            SerializeHelper.SerializeDeltaTo(serverList, clientList);
 
             // clear all items            
             serverList.Remove(item1);
 
             // sync
-            SyncListTest.SerializeDeltaTo(serverList, clientList);
+            SerializeHelper.SerializeDeltaTo(serverList, clientList);
 
             Assert.IsFalse(clientList.Any(x => x.id == item1.id));
             Assert.IsTrue(clientList.Any(x => x.id == item2.id));
@@ -46,7 +46,7 @@ public void ClearShouldClearAll()
             var serverList = new SyncList<TestObject>();
             var clientList = new SyncList<TestObject>();
 
-            SyncListTest.SerializeAllTo(serverList, clientList);
+            SerializeHelper.SerializeAllTo(serverList, clientList);
 
             // add some items
             var item1 = new TestObject { id = 1, text = "Lorem ipsum dolor sit, amet consectetur adipisicing elit. Nostrum ullam aliquid perferendis, aut nihil sunt quod ipsum corporis a. Cupiditate, alias. Commodi, molestiae distinctio repellendus dolor similique delectus inventore eum." };
@@ -55,13 +55,13 @@ public void ClearShouldClearAll()
             serverList.Add(item2);
 
             // sync
-            SyncListTest.SerializeDeltaTo(serverList, clientList);
+            SerializeHelper.SerializeDeltaTo(serverList, clientList);
 
             // clear all items            
             serverList.Clear();
 
             // sync
-            SyncListTest.SerializeDeltaTo(serverList, clientList);
+            SerializeHelper.SerializeDeltaTo(serverList, clientList);
 
             Assert.That(clientList.Count, Is.Zero);
 
diff --git a/Assets/Tests/Runtime/Collections/SyncListStructTest.cs b/Assets/Tests/Runtime/Collections/SyncListStructTest.cs
index a3f474ca1b9..d584c720ede 100644
--- a/Assets/Tests/Runtime/Collections/SyncListStructTest.cs
+++ b/Assets/Tests/Runtime/Collections/SyncListStructTest.cs
@@ -6,18 +6,22 @@ namespace Mirage.Tests.Runtime
 {
     public class SyncListStructTest
     {
-        [Test]
-        public void ListIsDirtyWhenModifingAndSettingStruct()
+        [SetUp]
+        public void Setup()
         {
             // let the weaver know to generate a reader and writer for TestPlayer
-            var writer = new NetworkWriter();
+            var writer = new NetworkWriter(1300);
             writer.Write<TestPlayer>(default);
+        }
 
+        [Test]
+        public void ListIsDirtyWhenModifingAndSettingStruct()
+        {
             var serverList = new SyncList<TestPlayer>();
             var clientList = new SyncList<TestPlayer>();
-            SyncListTest.SerializeAllTo(serverList, clientList);
+            SerializeHelper.SerializeAllTo(serverList, clientList);
             serverList.Add(new TestPlayer { item = new TestItem { price = 10 } });
-            SyncListTest.SerializeDeltaTo(serverList, clientList);
+            SerializeHelper.SerializeDeltaTo(serverList, clientList);
             Assert.That(serverList.IsDirty, Is.False);
 
             TestPlayer player = serverList[0];
diff --git a/Assets/Tests/Runtime/Collections/SyncListTest.cs b/Assets/Tests/Runtime/Collections/SyncListTest.cs
index 62cb69dac53..4211dc97c02 100644
--- a/Assets/Tests/Runtime/Collections/SyncListTest.cs
+++ b/Assets/Tests/Runtime/Collections/SyncListTest.cs
@@ -7,37 +7,47 @@
 
 namespace Mirage.Tests.Runtime
 {
-    [TestFixture]
-    public class SyncListTest
+    public static class SerializeHelper
     {
-        SyncList<string> serverSyncList;
-        SyncList<string> clientSyncList;
+        static readonly NetworkWriter writer = new NetworkWriter(1300);
+        static readonly NetworkReader reader = new NetworkReader();
 
         public static void SerializeAllTo<T>(T fromList, T toList) where T : ISyncObject
         {
-            var writer = new NetworkWriter();
+            writer.Reset();
             fromList.OnSerializeAll(writer);
-            var reader = new NetworkReader(writer.ToArray());
+
+            reader.Reset(writer.ToArray());
             toList.OnDeserializeAll(reader);
 
-            int writeLength = writer.Length;
-            int readLength = reader.Position;
+            int writeLength = writer.ByteLength;
+            int readLength = reader.BytePosition;
             Assert.That(writeLength == readLength, $"OnSerializeAll and OnDeserializeAll calls write the same amount of data\n    writeLength={writeLength}\n    readLength={readLength}");
 
         }
 
         public static void SerializeDeltaTo<T>(T fromList, T toList) where T : ISyncObject
         {
-            var writer = new NetworkWriter();
+            writer.Reset();
+
             fromList.OnSerializeDelta(writer);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArray());
+
             toList.OnDeserializeDelta(reader);
             fromList.Flush();
 
-            int writeLength = writer.Length;
-            int readLength = reader.Position;
+            int writeLength = writer.ByteLength;
+            int readLength = reader.BytePosition;
             Assert.That(writeLength == readLength, $"OnSerializeDelta and OnDeserializeDelta calls write the same amount of data\n    writeLength={writeLength}\n    readLength={readLength}");
         }
+    }
+    [TestFixture]
+    public class SyncListTest
+    {
+        SyncList<string> serverSyncList;
+        SyncList<string> clientSyncList;
+
+
 
         [SetUp]
         public void SetUp()
@@ -49,7 +59,7 @@ public void SetUp()
             serverSyncList.Add("Hello");
             serverSyncList.Add("World");
             serverSyncList.Add("!");
-            SerializeAllTo(serverSyncList, clientSyncList);
+            SerializeHelper.SerializeAllTo(serverSyncList, clientSyncList);
         }
 
         [Test]
@@ -63,7 +73,7 @@ public void ClearEventOnSyncAll()
         {
             Action callback = Substitute.For<Action>();
             clientSyncList.OnClear += callback;
-            SerializeAllTo(serverSyncList, clientSyncList);
+            SerializeHelper.SerializeAllTo(serverSyncList, clientSyncList);
             callback.Received().Invoke();
         }
 
@@ -72,7 +82,7 @@ public void InsertEventOnSyncAll()
         {
             Action<int, string> callback = Substitute.For<Action<int, string>>();
             clientSyncList.OnInsert += callback;
-            SerializeAllTo(serverSyncList, clientSyncList);
+            SerializeHelper.SerializeAllTo(serverSyncList, clientSyncList);
 
             Received.InOrder(() =>
             {
@@ -87,7 +97,7 @@ public void ChangeEventOnSyncAll()
         {
             Action callback = Substitute.For<Action>();
             clientSyncList.OnChange += callback;
-            SerializeAllTo(serverSyncList, clientSyncList);
+            SerializeHelper.SerializeAllTo(serverSyncList, clientSyncList);
             callback.Received().Invoke();
         }
 
@@ -95,7 +105,7 @@ public void ChangeEventOnSyncAll()
         public void TestAdd()
         {
             serverSyncList.Add("yay");
-            SerializeDeltaTo(serverSyncList, clientSyncList);
+            SerializeHelper.SerializeDeltaTo(serverSyncList, clientSyncList);
             Assert.That(clientSyncList, Is.EquivalentTo(new[] { "Hello", "World", "!", "yay" }));
         }
 
@@ -103,7 +113,7 @@ public void TestAdd()
         public void TestAddRange()
         {
             serverSyncList.AddRange(new[] { "One", "Two", "Three" });
-            SerializeDeltaTo(serverSyncList, clientSyncList);
+            SerializeHelper.SerializeDeltaTo(serverSyncList, clientSyncList);
             Assert.That(clientSyncList, Is.EqualTo(new[] { "Hello", "World", "!", "One", "Two", "Three" }));
         }
 
@@ -111,7 +121,7 @@ public void TestAddRange()
         public void TestClear()
         {
             serverSyncList.Clear();
-            SerializeDeltaTo(serverSyncList, clientSyncList);
+            SerializeHelper.SerializeDeltaTo(serverSyncList, clientSyncList);
             Assert.That(clientSyncList, Is.EquivalentTo(new string[] { }));
         }
 
@@ -119,7 +129,7 @@ public void TestClear()
         public void TestInsert()
         {
             serverSyncList.Insert(0, "yay");
-            SerializeDeltaTo(serverSyncList, clientSyncList);
+            SerializeHelper.SerializeDeltaTo(serverSyncList, clientSyncList);
             Assert.That(clientSyncList, Is.EquivalentTo(new[] { "yay", "Hello", "World", "!" }));
         }
 
@@ -127,7 +137,7 @@ public void TestInsert()
         public void TestInsertRange()
         {
             serverSyncList.InsertRange(1, new[] { "One", "Two", "Three" });
-            SerializeDeltaTo(serverSyncList, clientSyncList);
+            SerializeHelper.SerializeDeltaTo(serverSyncList, clientSyncList);
             Assert.That(clientSyncList, Is.EqualTo(new[] { "Hello", "One", "Two", "Three", "World", "!" }));
         }
 
@@ -135,7 +145,7 @@ public void TestInsertRange()
         public void TestSet()
         {
             serverSyncList[1] = "yay";
-            SerializeDeltaTo(serverSyncList, clientSyncList);
+            SerializeHelper.SerializeDeltaTo(serverSyncList, clientSyncList);
             Assert.That(clientSyncList[1], Is.EqualTo("yay"));
             Assert.That(clientSyncList, Is.EquivalentTo(new[] { "Hello", "yay", "!" }));
         }
@@ -144,11 +154,11 @@ public void TestSet()
         public void TestSetNull()
         {
             serverSyncList[1] = null;
-            SerializeDeltaTo(serverSyncList, clientSyncList);
+            SerializeHelper.SerializeDeltaTo(serverSyncList, clientSyncList);
             Assert.That(clientSyncList[1], Is.EqualTo(null));
             Assert.That(clientSyncList, Is.EquivalentTo(new[] { "Hello", null, "!" }));
             serverSyncList[1] = "yay";
-            SerializeDeltaTo(serverSyncList, clientSyncList);
+            SerializeHelper.SerializeDeltaTo(serverSyncList, clientSyncList);
             Assert.That(clientSyncList, Is.EquivalentTo(new[] { "Hello", "yay", "!" }));
         }
 
@@ -156,7 +166,7 @@ public void TestSetNull()
         public void TestRemoveAll()
         {
             serverSyncList.RemoveAll(entry => entry.Contains("l"));
-            SerializeDeltaTo(serverSyncList, clientSyncList);
+            SerializeHelper.SerializeDeltaTo(serverSyncList, clientSyncList);
             Assert.That(clientSyncList, Is.EquivalentTo(new[] { "!" }));
         }
 
@@ -164,7 +174,7 @@ public void TestRemoveAll()
         public void TestRemoveAllNone()
         {
             serverSyncList.RemoveAll(entry => entry == "yay");
-            SerializeDeltaTo(serverSyncList, clientSyncList);
+            SerializeHelper.SerializeDeltaTo(serverSyncList, clientSyncList);
             Assert.That(clientSyncList, Is.EquivalentTo(new[] { "Hello", "World", "!" }));
         }
 
@@ -172,7 +182,7 @@ public void TestRemoveAllNone()
         public void TestRemoveAt()
         {
             serverSyncList.RemoveAt(1);
-            SerializeDeltaTo(serverSyncList, clientSyncList);
+            SerializeHelper.SerializeDeltaTo(serverSyncList, clientSyncList);
             Assert.That(clientSyncList, Is.EquivalentTo(new[] { "Hello", "!" }));
         }
 
@@ -180,7 +190,7 @@ public void TestRemoveAt()
         public void TestRemove()
         {
             serverSyncList.Remove("World");
-            SerializeDeltaTo(serverSyncList, clientSyncList);
+            SerializeHelper.SerializeDeltaTo(serverSyncList, clientSyncList);
             Assert.That(clientSyncList, Is.EquivalentTo(new[] { "Hello", "!" }));
         }
 
@@ -223,10 +233,10 @@ public void TestFindAllNonExistent()
         public void TestMultSync()
         {
             serverSyncList.Add("1");
-            SerializeDeltaTo(serverSyncList, clientSyncList);
+            SerializeHelper.SerializeDeltaTo(serverSyncList, clientSyncList);
             // add some delta and see if it applies
             serverSyncList.Add("2");
-            SerializeDeltaTo(serverSyncList, clientSyncList);
+            SerializeHelper.SerializeDeltaTo(serverSyncList, clientSyncList);
             Assert.That(clientSyncList, Is.EquivalentTo(new[] { "Hello", "World", "!", "1", "2" }));
         }
 
@@ -239,7 +249,7 @@ public void SyncListIntest()
             serverList.Add(1);
             serverList.Add(2);
             serverList.Add(3);
-            SerializeDeltaTo(serverList, clientList);
+            SerializeHelper.SerializeDeltaTo(serverList, clientList);
 
             Assert.That(clientList, Is.EquivalentTo(new[] { 1, 2, 3 }));
         }
@@ -253,7 +263,7 @@ public void SyncListBoolTest()
             serverList.Add(true);
             serverList.Add(false);
             serverList.Add(true);
-            SerializeDeltaTo(serverList, clientList);
+            SerializeHelper.SerializeDeltaTo(serverList, clientList);
 
             Assert.That(clientList, Is.EquivalentTo(new[] { true, false, true }));
         }
@@ -267,7 +277,7 @@ public void SyncListUIntTest()
             serverList.Add(1U);
             serverList.Add(2U);
             serverList.Add(3U);
-            SerializeDeltaTo(serverList, clientList);
+            SerializeHelper.SerializeDeltaTo(serverList, clientList);
 
             Assert.That(clientList, Is.EquivalentTo(new[] { 1U, 2U, 3U }));
         }
@@ -281,7 +291,7 @@ public void SyncListFloatTest()
             serverList.Add(1.0F);
             serverList.Add(2.0F);
             serverList.Add(3.0F);
-            SerializeDeltaTo(serverList, clientList);
+            SerializeHelper.SerializeDeltaTo(serverList, clientList);
 
             Assert.That(clientList, Is.EquivalentTo(new[] { 1.0F, 2.0F, 3.0F }));
         }
@@ -292,7 +302,7 @@ public void AddClientCallbackTest()
             Action<int, string> callback = Substitute.For<Action<int, string>>();
             clientSyncList.OnInsert += callback;
             serverSyncList.Add("yay");
-            SerializeDeltaTo(serverSyncList, clientSyncList);
+            SerializeHelper.SerializeDeltaTo(serverSyncList, clientSyncList);
             callback.Received().Invoke(3, "yay");
         }
 
@@ -302,7 +312,7 @@ public void InsertClientCallbackTest()
             Action<int, string> callback = Substitute.For<Action<int, string>>();
             clientSyncList.OnInsert += callback;
             serverSyncList.Insert(1, "yay");
-            SerializeDeltaTo(serverSyncList, clientSyncList);
+            SerializeHelper.SerializeDeltaTo(serverSyncList, clientSyncList);
             callback.Received().Invoke(1, "yay");
         }
 
@@ -312,7 +322,7 @@ public void RemoveClientCallbackTest()
             Action<int, string> callback = Substitute.For<Action<int, string>>();
             clientSyncList.OnRemove += callback;
             serverSyncList.Remove("World");
-            SerializeDeltaTo(serverSyncList, clientSyncList);
+            SerializeHelper.SerializeDeltaTo(serverSyncList, clientSyncList);
             callback.Received().Invoke(1, "World");
         }
 
@@ -322,7 +332,7 @@ public void ClearClientCallbackTest()
             Action callback = Substitute.For<Action>();
             clientSyncList.OnClear += callback;
             serverSyncList.Clear();
-            SerializeDeltaTo(serverSyncList, clientSyncList);
+            SerializeHelper.SerializeDeltaTo(serverSyncList, clientSyncList);
             callback.Received().Invoke();
         }
 
@@ -332,7 +342,7 @@ public void SetClientCallbackTest()
             Action<int, string, string> callback = Substitute.For<Action<int, string, string>>();
             clientSyncList.OnSet += callback;
             serverSyncList[1] = "yo mama";
-            SerializeDeltaTo(serverSyncList, clientSyncList);
+            SerializeHelper.SerializeDeltaTo(serverSyncList, clientSyncList);
             callback.Received().Invoke(1, "World", "yo mama");
         }
 
@@ -343,7 +353,7 @@ public void ChangeClientCallbackTest()
             clientSyncList.OnChange += callback;
             serverSyncList.Add("1");
             serverSyncList.Add("2");
-            SerializeDeltaTo(serverSyncList, clientSyncList);
+            SerializeHelper.SerializeDeltaTo(serverSyncList, clientSyncList);
             callback.Received(1).Invoke();
         }
 
@@ -427,7 +437,7 @@ public void WritingToReadOnlyThrows()
         public void DirtyTest()
         {
             // Sync Delta to clear dirty
-            SerializeDeltaTo(serverSyncList, clientSyncList);
+            SerializeHelper.SerializeDeltaTo(serverSyncList, clientSyncList);
 
             // nothing to send
             Assert.That(serverSyncList.IsDirty, Is.False);
@@ -435,7 +445,7 @@ public void DirtyTest()
             // something has changed
             serverSyncList.Add("1");
             Assert.That(serverSyncList.IsDirty, Is.True);
-            SerializeDeltaTo(serverSyncList, clientSyncList);
+            SerializeHelper.SerializeDeltaTo(serverSyncList, clientSyncList);
 
             // data has been flushed,  should go back to clear
             Assert.That(serverSyncList.IsDirty, Is.False);
@@ -455,7 +465,7 @@ public void ObjectCanBeReusedAfterReset()
             // Check Add and Sync without errors
             hostList.Add("hello");
             hostList.Add("world");
-            SerializeDeltaTo(hostList, clientList2);
+            SerializeHelper.SerializeDeltaTo(hostList, clientList2);
         }
 
         [Test]
diff --git a/Assets/Tests/Runtime/Collections/SyncSetTest.cs b/Assets/Tests/Runtime/Collections/SyncSetTest.cs
index e3901d4bd4b..1a872c73aa4 100644
--- a/Assets/Tests/Runtime/Collections/SyncSetTest.cs
+++ b/Assets/Tests/Runtime/Collections/SyncSetTest.cs
@@ -1,7 +1,6 @@
 using System;
 using System.Collections.Generic;
 using Mirage.Collections;
-using Mirage.Serialization;
 using NSubstitute;
 using NUnit.Framework;
 
@@ -15,23 +14,6 @@ public class SyncSetString : SyncHashSet<string> { }
         SyncSetString serverSyncSet;
         SyncSetString clientSyncSet;
 
-        void SerializeAllTo<T>(T fromList, T toList) where T : ISyncObject
-        {
-            var writer = new NetworkWriter();
-            fromList.OnSerializeAll(writer);
-            var reader = new NetworkReader(writer.ToArray());
-            toList.OnDeserializeAll(reader);
-        }
-
-        void SerializeDeltaTo<T>(T fromList, T toList) where T : ISyncObject
-        {
-            var writer = new NetworkWriter();
-            fromList.OnSerializeDelta(writer);
-            var reader = new NetworkReader(writer.ToArray());
-            toList.OnDeserializeDelta(reader);
-            fromList.Flush();
-        }
-
         [SetUp]
         public void SetUp()
         {
@@ -42,7 +24,7 @@ public void SetUp()
             serverSyncSet.Add("Hello");
             serverSyncSet.Add("World");
             serverSyncSet.Add("!");
-            SerializeAllTo(serverSyncSet, clientSyncSet);
+            SerializeHelper.SerializeAllTo(serverSyncSet, clientSyncSet);
         }
 
         [Test]
@@ -57,7 +39,7 @@ public void ClearEventOnSyncAll()
         {
             Action callback = Substitute.For<Action>();
             clientSyncSet.OnClear += callback;
-            SerializeAllTo(serverSyncSet, clientSyncSet);
+            SerializeHelper.SerializeAllTo(serverSyncSet, clientSyncSet);
             callback.Received().Invoke();
         }
 
@@ -66,7 +48,7 @@ public void InsertEventOnSyncAll()
         {
             Action<string> callback = Substitute.For<Action<string>>();
             clientSyncSet.OnAdd += callback;
-            SerializeAllTo(serverSyncSet, clientSyncSet);
+            SerializeHelper.SerializeAllTo(serverSyncSet, clientSyncSet);
 
             callback.Received().Invoke("Hello");
             callback.Received().Invoke("World");
@@ -78,7 +60,7 @@ public void ChangeEventOnSyncAll()
         {
             Action callback = Substitute.For<Action>();
             clientSyncSet.OnChange += callback;
-            SerializeAllTo(serverSyncSet, clientSyncSet);
+            SerializeHelper.SerializeAllTo(serverSyncSet, clientSyncSet);
             callback.Received().Invoke();
         }
 
@@ -88,7 +70,7 @@ public void TestAdd()
         {
             serverSyncSet.Add("yay");
             Assert.That(serverSyncSet.IsDirty, Is.True);
-            SerializeDeltaTo(serverSyncSet, clientSyncSet);
+            SerializeHelper.SerializeDeltaTo(serverSyncSet, clientSyncSet);
             Assert.That(clientSyncSet, Is.EquivalentTo(new[] { "Hello", "World", "!", "yay" }));
             Assert.That(serverSyncSet.IsDirty, Is.False);
         }
@@ -98,7 +80,7 @@ public void TestClear()
         {
             serverSyncSet.Clear();
             Assert.That(serverSyncSet.IsDirty, Is.True);
-            SerializeDeltaTo(serverSyncSet, clientSyncSet);
+            SerializeHelper.SerializeDeltaTo(serverSyncSet, clientSyncSet);
             Assert.That(clientSyncSet, Is.EquivalentTo(new string[] { }));
             Assert.That(serverSyncSet.IsDirty, Is.False);
         }
@@ -108,7 +90,7 @@ public void TestRemove()
         {
             serverSyncSet.Remove("World");
             Assert.That(serverSyncSet.IsDirty, Is.True);
-            SerializeDeltaTo(serverSyncSet, clientSyncSet);
+            SerializeHelper.SerializeDeltaTo(serverSyncSet, clientSyncSet);
             Assert.That(clientSyncSet, Is.EquivalentTo(new[] { "Hello", "!" }));
             Assert.That(serverSyncSet.IsDirty, Is.False);
         }
@@ -117,10 +99,10 @@ public void TestRemove()
         public void TestMultSync()
         {
             serverSyncSet.Add("1");
-            SerializeDeltaTo(serverSyncSet, clientSyncSet);
+            SerializeHelper.SerializeDeltaTo(serverSyncSet, clientSyncSet);
             // add some delta and see if it applies
             serverSyncSet.Add("2");
-            SerializeDeltaTo(serverSyncSet, clientSyncSet);
+            SerializeHelper.SerializeDeltaTo(serverSyncSet, clientSyncSet);
             Assert.That(clientSyncSet, Is.EquivalentTo(new[] { "Hello", "World", "!", "1", "2" }));
         }
 
@@ -130,7 +112,7 @@ public void AddClientCallbackTest()
             Action<string> callback = Substitute.For<Action<string>>();
             clientSyncSet.OnAdd += callback;
             serverSyncSet.Add("yay");
-            SerializeDeltaTo(serverSyncSet, clientSyncSet);
+            SerializeHelper.SerializeDeltaTo(serverSyncSet, clientSyncSet);
             callback.Received().Invoke("yay");
         }
 
@@ -140,7 +122,7 @@ public void RemoveClientCallbackTest()
             Action<string> callback = Substitute.For<Action<string>>();
             clientSyncSet.OnRemove += callback;
             serverSyncSet.Remove("World");
-            SerializeDeltaTo(serverSyncSet, clientSyncSet);
+            SerializeHelper.SerializeDeltaTo(serverSyncSet, clientSyncSet);
             callback.Received().Invoke("World");
         }
 
@@ -150,7 +132,7 @@ public void ClearClientCallbackTest()
             Action callback = Substitute.For<Action>();
             clientSyncSet.OnClear += callback;
             serverSyncSet.Clear();
-            SerializeDeltaTo(serverSyncSet, clientSyncSet);
+            SerializeHelper.SerializeDeltaTo(serverSyncSet, clientSyncSet);
             callback.Received().Invoke();
         }
 
@@ -161,7 +143,7 @@ public void ChangeClientCallbackTest()
             clientSyncSet.OnChange += callback;
             serverSyncSet.Add("1");
             serverSyncSet.Add("2");
-            SerializeDeltaTo(serverSyncSet, clientSyncSet);
+            SerializeHelper.SerializeDeltaTo(serverSyncSet, clientSyncSet);
             callback.Received(1).Invoke();
         }
 
@@ -175,7 +157,7 @@ public void CountTest()
         public void TestExceptWith()
         {
             serverSyncSet.ExceptWith(new[] { "World", "Hello" });
-            SerializeDeltaTo(serverSyncSet, clientSyncSet);
+            SerializeHelper.SerializeDeltaTo(serverSyncSet, clientSyncSet);
             Assert.That(clientSyncSet, Is.EquivalentTo(new[] { "!" }));
         }
 
@@ -183,7 +165,7 @@ public void TestExceptWith()
         public void TestExceptWithSelf()
         {
             serverSyncSet.ExceptWith(serverSyncSet);
-            SerializeDeltaTo(serverSyncSet, clientSyncSet);
+            SerializeHelper.SerializeDeltaTo(serverSyncSet, clientSyncSet);
             Assert.That(clientSyncSet, Is.EquivalentTo(new string[] { }));
         }
 
@@ -191,7 +173,7 @@ public void TestExceptWithSelf()
         public void TestIntersectWith()
         {
             serverSyncSet.IntersectWith(new[] { "World", "Hello" });
-            SerializeDeltaTo(serverSyncSet, clientSyncSet);
+            SerializeHelper.SerializeDeltaTo(serverSyncSet, clientSyncSet);
             Assert.That(clientSyncSet, Is.EquivalentTo(new[] { "World", "Hello" }));
         }
 
@@ -199,7 +181,7 @@ public void TestIntersectWith()
         public void TestIntersectWithSet()
         {
             serverSyncSet.IntersectWith(new HashSet<string> { "World", "Hello" });
-            SerializeDeltaTo(serverSyncSet, clientSyncSet);
+            SerializeHelper.SerializeDeltaTo(serverSyncSet, clientSyncSet);
             Assert.That(clientSyncSet, Is.EquivalentTo(new[] { "World", "Hello" }));
         }
 
@@ -255,7 +237,7 @@ public void TestSetEquals()
         public void TestSymmetricExceptWith()
         {
             serverSyncSet.SymmetricExceptWith(new HashSet<string> { "Hello", "is" });
-            SerializeDeltaTo(serverSyncSet, clientSyncSet);
+            SerializeHelper.SerializeDeltaTo(serverSyncSet, clientSyncSet);
             Assert.That(clientSyncSet, Is.EquivalentTo(new[] { "World", "is", "!" }));
         }
 
@@ -263,7 +245,7 @@ public void TestSymmetricExceptWith()
         public void TestSymmetricExceptWithSelf()
         {
             serverSyncSet.SymmetricExceptWith(serverSyncSet);
-            SerializeDeltaTo(serverSyncSet, clientSyncSet);
+            SerializeHelper.SerializeDeltaTo(serverSyncSet, clientSyncSet);
             Assert.That(clientSyncSet, Is.EquivalentTo(new string[] { }));
         }
 
@@ -271,7 +253,7 @@ public void TestSymmetricExceptWithSelf()
         public void TestUnionWith()
         {
             serverSyncSet.UnionWith(new HashSet<string> { "Hello", "is" });
-            SerializeDeltaTo(serverSyncSet, clientSyncSet);
+            SerializeHelper.SerializeDeltaTo(serverSyncSet, clientSyncSet);
             Assert.That(clientSyncSet, Is.EquivalentTo(new[] { "World", "Hello", "is", "!" }));
         }
 
@@ -279,7 +261,7 @@ public void TestUnionWith()
         public void TestUnionWithSelf()
         {
             serverSyncSet.UnionWith(serverSyncSet);
-            SerializeDeltaTo(serverSyncSet, clientSyncSet);
+            SerializeHelper.SerializeDeltaTo(serverSyncSet, clientSyncSet);
             Assert.That(clientSyncSet, Is.EquivalentTo(new[] { "World", "Hello", "!" }));
         }
 
@@ -311,7 +293,7 @@ public void ObjectCanBeReusedAfterReset()
             hostList.Add("1");
             hostList.Add("2");
             hostList.Add("3");
-            SerializeDeltaTo(hostList, clientList2);
+            SerializeHelper.SerializeDeltaTo(hostList, clientList2);
         }
 
         [Test]
diff --git a/Assets/Tests/Runtime/Host/NetworkIdentityTests.cs b/Assets/Tests/Runtime/Host/NetworkIdentityTests.cs
index e22cffffb6e..12cbc02b3f3 100644
--- a/Assets/Tests/Runtime/Host/NetworkIdentityTests.cs
+++ b/Assets/Tests/Runtime/Host/NetworkIdentityTests.cs
@@ -257,7 +257,7 @@ public override void ExtraTearDown()
         [UnityTest]
         public IEnumerator ClientNotNullAfterSpawnInStarted() => UniTask.ToCoroutine(async () =>
         {
-            await AsyncUtil.WaitUntilWithTimeout(() => testIdentity.Client == client);
+            await AsyncUtil.WaitUntilWithTimeout(() => testIdentity.Client == (client as INetworkClient));
         });
     }
 }
diff --git a/Assets/Tests/Runtime/MessagePackerTest.cs b/Assets/Tests/Runtime/MessagePackerTest.cs
index 3e0510cd5d1..06b3ebe89dd 100644
--- a/Assets/Tests/Runtime/MessagePackerTest.cs
+++ b/Assets/Tests/Runtime/MessagePackerTest.cs
@@ -9,6 +9,19 @@ namespace Mirage.Tests.Runtime.Serialization
     [TestFixture]
     public class MessagePackerTest
     {
+        NetworkReader reader;
+        [SetUp]
+        public void Setup()
+        {
+            reader = new NetworkReader();
+        }
+        [TearDown]
+        public void TearDown()
+        {
+            reader.Dispose();
+            reader = null;
+        }
+
 
         [Test]
         public void TestPacking()
@@ -76,7 +89,7 @@ public void TestUnpackMessageNonGeneric()
             };
 
             byte[] data = MessagePacker.Pack(message);
-            var reader = new NetworkReader(data);
+            reader.Reset(data);
 
             int msgType = MessagePacker.UnpackId(reader);
             Assert.That(msgType, Is.EqualTo(BitConverter.ToUInt16(data, 0)));
@@ -88,8 +101,8 @@ public void UnpackInvalidMessage()
             // try an invalid message
             Assert.Throws<EndOfStreamException>(() =>
             {
-                var reader2 = new NetworkReader(new byte[0]);
-                _ = MessagePacker.UnpackId(reader2);
+                reader.Reset(new byte[0]);
+                _ = MessagePacker.UnpackId(reader);
             });
         }
 
diff --git a/Assets/Tests/Runtime/Mirage.Tests.Runtime.asmdef b/Assets/Tests/Runtime/Mirage.Tests.Runtime.asmdef
index 710e70dfed1..84339240c53 100644
--- a/Assets/Tests/Runtime/Mirage.Tests.Runtime.asmdef
+++ b/Assets/Tests/Runtime/Mirage.Tests.Runtime.asmdef
@@ -13,7 +13,7 @@
     ],
     "includePlatforms": [],
     "excludePlatforms": [],
-    "allowUnsafeCode": false,
+    "allowUnsafeCode": true,
     "overrideReferences": true,
     "precompiledReferences": [
         "nunit.framework.dll",
diff --git a/Assets/Tests/Runtime/Serialization/ArraySegmentWriterTest.cs b/Assets/Tests/Runtime/Serialization/ArraySegmentWriterTest.cs
index 1e897d86adf..f31cf16116d 100644
--- a/Assets/Tests/Runtime/Serialization/ArraySegmentWriterTest.cs
+++ b/Assets/Tests/Runtime/Serialization/ArraySegmentWriterTest.cs
@@ -7,111 +7,98 @@ namespace Mirage.Tests.Runtime.Serialization
     [TestFixture]
     public class ArraySegmentWriterTest
     {
-        #region ArraySegment<byte>
-
-        // ArraySegment<byte> is a special case,  optimized for no copy and no allocation
-        // other types are generated by the weaver
-
-        [Test]
-        public void TestEmptyByteArray()
+        /// <summary>
+        /// ArraySegment<byte> is a special case,  optimized for no copy and no allocation
+        /// other types are generated by the weaver 
+        /// </summary>
+        public class ByteSegment
         {
-            var array = new ArraySegment<byte>(new byte[0]);
-
-            byte[] data = MessagePacker.Pack(array);
-
-            ArraySegment<byte> unpacked = MessagePacker.Unpack<ArraySegment<byte>>(data);
+            [Test]
+            public void TestEmptyArray()
+            {
+                var array = new ArraySegment<byte>(new byte[0]);
 
-            Assert.IsNotNull(unpacked.Array);
-            Assert.That(unpacked.Count, Is.EqualTo(0));
-        }
+                byte[] data = MessagePacker.Pack(array);
 
-        public static ArraySegment<int> SampleReader(NetworkReader reader)
-        {
-            int length = reader.ReadPackedInt32();
-            int[] array = new int[length];
+                ArraySegment<byte> unpacked = MessagePacker.Unpack<ArraySegment<byte>>(data);
 
-            for (int i = 0; i < length; i++)
-            {
-                array[i] = reader.ReadPackedInt32();
+                Assert.IsNotNull(unpacked.Array);
+                Assert.That(unpacked.Count, Is.EqualTo(0));
             }
 
-            return new ArraySegment<int>(array);
-        }
-
-        [Test]
-        public void TestNullByteArray()
-        {
-            ArraySegment<byte> array = default;
+            [Test]
+            public void TestNullArray()
+            {
+                ArraySegment<byte> array = default;
 
-            byte[] data = MessagePacker.Pack(array);
+                byte[] data = MessagePacker.Pack(array);
 
-            ArraySegment<byte> unpacked = MessagePacker.Unpack<ArraySegment<byte>>(data);
+                ArraySegment<byte> unpacked = MessagePacker.Unpack<ArraySegment<byte>>(data);
 
-            Assert.IsNull(unpacked.Array);
-            Assert.That(unpacked.Offset, Is.EqualTo(0));
-            Assert.That(unpacked.Count, Is.EqualTo(0));
-        }
+                Assert.IsNull(unpacked.Array);
+                Assert.That(unpacked.Offset, Is.EqualTo(0));
+                Assert.That(unpacked.Count, Is.EqualTo(0));
+            }
 
-        [Test]
-        public void TestSegmentByteArray()
-        {
-            byte[] sourcedata = { 0, 1, 2, 3, 4, 5, 6 };
-            var array = new ArraySegment<byte>(sourcedata, 3, 2);
+            [Test]
+            public void TestSegmentArray()
+            {
+                byte[] sourcedata = { 0, 1, 2, 3, 4, 5, 6 };
+                var array = new ArraySegment<byte>(sourcedata, 3, 2);
 
-            byte[] data = MessagePacker.Pack(array);
+                byte[] data = MessagePacker.Pack(array);
 
-            ArraySegment<byte> unpacked = MessagePacker.Unpack<ArraySegment<byte>>(data);
+                ArraySegment<byte> unpacked = MessagePacker.Unpack<ArraySegment<byte>>(data);
 
-            Assert.IsNotNull(unpacked.Array);
-            Assert.That(unpacked.Count, Is.EqualTo(2));
-            Assert.That(unpacked, Is.EquivalentTo(new byte[] { 3, 4 }));
+                Assert.IsNotNull(unpacked.Array);
+                Assert.That(unpacked.Count, Is.EqualTo(2));
+                Assert.That(unpacked, Is.EquivalentTo(new byte[] { 3, 4 }));
+            }
         }
-        #endregion
 
-        #region ArraySegment<int>
-
-        [Test]
-        public void TestEmptyIntArray()
+        public class IntSegment
         {
-            var array = new ArraySegment<int>(new int[0]);
+            [Test]
+            public void TestEmptyArray()
+            {
+                var array = new ArraySegment<int>(new int[0]);
 
-            byte[] data = MessagePacker.Pack(array);
+                byte[] data = MessagePacker.Pack(array);
 
-            ArraySegment<int> unpacked = MessagePacker.Unpack<ArraySegment<int>>(data);
+                ArraySegment<int> unpacked = MessagePacker.Unpack<ArraySegment<int>>(data);
 
-            Assert.IsNotNull(unpacked.Array);
-            Assert.That(unpacked.Count, Is.EqualTo(0));
-        }
+                Assert.IsNotNull(unpacked.Array);
+                Assert.That(unpacked.Count, Is.EqualTo(0));
+            }
 
-        [Test]
-        public void TestNullIntArray()
-        {
-            ArraySegment<int> array = default;
+            [Test]
+            public void TestNullArray()
+            {
+                ArraySegment<int> array = default;
 
-            byte[] data = MessagePacker.Pack(array);
+                byte[] data = MessagePacker.Pack(array);
 
-            ArraySegment<int> unpacked = MessagePacker.Unpack<ArraySegment<int>>(data);
+                ArraySegment<int> unpacked = MessagePacker.Unpack<ArraySegment<int>>(data);
 
-            Assert.That(unpacked.Offset, Is.EqualTo(0));
-            Assert.That(unpacked.Count, Is.EqualTo(0));
-        }
+                Assert.That(unpacked.Offset, Is.EqualTo(0));
+                Assert.That(unpacked.Count, Is.EqualTo(0));
+            }
 
-        [Test]
-        public void TestSegmentIntArray()
-        {
-            int[] sourcedata = { 0, 1, 2, 3, 4, 5, 6 };
+            [Test]
+            public void TestSegmentArray()
+            {
+                int[] sourcedata = { 0, 1, 2, 3, 4, 5, 6 };
 
-            var array = new ArraySegment<int>(sourcedata, 3, 2);
+                var array = new ArraySegment<int>(sourcedata, 3, 2);
 
-            byte[] data = MessagePacker.Pack(array);
+                byte[] data = MessagePacker.Pack(array);
 
-            ArraySegment<int> unpacked = MessagePacker.Unpack<ArraySegment<int>>(data);
+                ArraySegment<int> unpacked = MessagePacker.Unpack<ArraySegment<int>>(data);
 
-            Assert.IsNotNull(unpacked.Array);
-            Assert.That(unpacked.Count, Is.EqualTo(2));
-            Assert.That(unpacked, Is.EquivalentTo(new[] { 3, 4 }));
+                Assert.IsNotNull(unpacked.Array);
+                Assert.That(unpacked.Count, Is.EqualTo(2));
+                Assert.That(unpacked, Is.EquivalentTo(new[] { 3, 4 }));
+            }
         }
-        #endregion
-
     }
 }
diff --git a/Assets/Tests/Runtime/Serialization/BasicAuthenticatorMessagesTest.cs b/Assets/Tests/Runtime/Serialization/BasicAuthenticatorMessagesTest.cs
index f112889f22c..7ad075a56b6 100644
--- a/Assets/Tests/Runtime/Serialization/BasicAuthenticatorMessagesTest.cs
+++ b/Assets/Tests/Runtime/Serialization/BasicAuthenticatorMessagesTest.cs
@@ -29,14 +29,15 @@ public void AuthRequestMessageTest()
             Assert.That(message.serverCode, Is.EqualTo("abc"));
 
             // serialize
-            var writer = new NetworkWriter();
+            var writer = new NetworkWriter(1300);
             writer.Write(message);
-            byte[] writerData = writer.ToArray();
 
             // try deserialize
-            var reader = new NetworkReader(writerData);
+            var reader = new NetworkReader();
+            reader.Reset(writer.ToArraySegment());
             AuthRequestMessage fresh = reader.Read<AuthRequestMessage>();
             Assert.That(fresh.serverCode, Is.EqualTo("abc"));
+            reader.Dispose();
         }
 
         [Test]
@@ -52,15 +53,16 @@ public void AuthResponseMessageTest()
             Assert.That(message.message, Is.EqualTo("abc"));
 
             // serialize
-            var writer = new NetworkWriter();
+            var writer = new NetworkWriter(1300);
             writer.Write(message);
-            byte[] writerData = writer.ToArray();
 
             // try deserialize
-            var reader = new NetworkReader(writerData);
+            var reader = new NetworkReader();
+            reader.Reset(writer.ToArraySegment());
             AuthResponseMessage fresh = reader.Read<AuthResponseMessage>();
             Assert.That(fresh.success, Is.EqualTo(true));
             Assert.That(fresh.message, Is.EqualTo("abc"));
+            reader.Dispose();
         }
     }
 }
diff --git a/Assets/Tests/Runtime/Serialization/BitMaskHelperTests.cs b/Assets/Tests/Runtime/Serialization/BitMaskHelperTests.cs
new file mode 100644
index 00000000000..dbe7ce4e7fe
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/BitMaskHelperTests.cs
@@ -0,0 +1,54 @@
+using Mirage.Serialization;
+using NUnit.Framework;
+
+namespace Mirage.Tests.Runtime.Serialization
+{
+    public class BitMaskHelperTests
+    {
+        /// <summary>
+        /// slow way of creating correct mask
+        /// </summary>
+        static ulong slowMask(int bits)
+        {
+            ulong mask = 0;
+            for (int i = 0; i < bits; i++)
+            {
+                mask |= 1ul << i;
+            }
+
+            return mask;
+        }
+
+        [Test]
+        [Description("manually checking edge cases to be sure")]
+        public void MaskValueIsCorrect0()
+        {
+            ulong mask = BitMask.Mask(0);
+            Assert.That(mask, Is.EqualTo(0x0));
+        }
+
+        [Test]
+        [Description("manually checking edge cases to be sure")]
+        public void MaskValueIsCorrect63()
+        {
+            ulong mask = BitMask.Mask(63);
+            Assert.That(mask, Is.EqualTo(0x7FFF_FFFF_FFFF_FFFF));
+        }
+
+        [Test]
+        [Description("manually checking edge cases to be sure")]
+        public void MaskValueIsCorrect64()
+        {
+            ulong mask = BitMask.Mask(64);
+            Assert.That(mask, Is.EqualTo(0xFFFF_FFFF_FFFF_FFFF));
+        }
+
+        [Test]
+        public void MaskValueIsCorrect([Range(0, 64)] int bits)
+        {
+            ulong mask = BitMask.Mask(bits);
+            ulong expected = slowMask(bits);
+            Assert.That(mask, Is.EqualTo(expected), $"    mask:{mask:X}\nexpected:{expected:X}");
+        }
+    }
+}
diff --git a/Assets/Tests/Runtime/Serialization/BitMaskHelperTests.cs.meta b/Assets/Tests/Runtime/Serialization/BitMaskHelperTests.cs.meta
new file mode 100644
index 00000000000..dfb1ab175bf
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/BitMaskHelperTests.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 923082b03eea0934e972aade59852606
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Runtime/Serialization/BitPackingCopyFromOtherTests.cs b/Assets/Tests/Runtime/Serialization/BitPackingCopyFromOtherTests.cs
new file mode 100644
index 00000000000..c64c536bcb6
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/BitPackingCopyFromOtherTests.cs
@@ -0,0 +1,148 @@
+using Mirage.Serialization;
+using NUnit.Framework;
+
+namespace Mirage.Tests.Runtime.Serialization
+{
+    public class BitPackingCopyFromOtherTests
+    {
+        private NetworkWriter writer;
+        private NetworkWriter otherWriter;
+        private NetworkReader reader;
+
+        [SetUp]
+        public void Setup()
+        {
+            writer = new NetworkWriter(1300);
+            otherWriter = new NetworkWriter(1300);
+            reader = new NetworkReader();
+        }
+
+        [TearDown]
+        public void TearDown()
+        {
+            writer.Reset();
+            otherWriter.Reset();
+            reader.Dispose();
+        }
+
+        [Test]
+        public void CopyFromOtherWriterAligned()
+        {
+            otherWriter.Write(1, 8);
+            otherWriter.Write(2, 8);
+            otherWriter.Write(3, 8);
+            otherWriter.Write(4, 8);
+            otherWriter.Write(5, 8);
+
+
+            writer.CopyFromWriter(otherWriter, 0, 5 * 8);
+
+            var segment = writer.ToArraySegment();
+            reader.Reset(segment);
+
+            Assert.That(reader.Read(8), Is.EqualTo(1));
+            Assert.That(reader.Read(8), Is.EqualTo(2));
+            Assert.That(reader.Read(8), Is.EqualTo(3));
+            Assert.That(reader.Read(8), Is.EqualTo(4));
+            Assert.That(reader.Read(8), Is.EqualTo(5));
+        }
+
+        [Test]
+        public void CopyFromOtherWriterUnAligned()
+        {
+            otherWriter.Write(1, 6);
+            otherWriter.Write(2, 7);
+            otherWriter.Write(3, 8);
+            otherWriter.Write(4, 9);
+            otherWriter.Write(5, 10);
+
+            writer.Write(1, 3);
+
+            writer.CopyFromWriter(otherWriter, 0, 40);
+
+            var segment = writer.ToArraySegment();
+            reader.Reset(segment);
+
+            Assert.That(reader.Read(3), Is.EqualTo(1));
+            Assert.That(reader.Read(6), Is.EqualTo(1));
+            Assert.That(reader.Read(7), Is.EqualTo(2));
+            Assert.That(reader.Read(8), Is.EqualTo(3));
+            Assert.That(reader.Read(9), Is.EqualTo(4));
+            Assert.That(reader.Read(10), Is.EqualTo(5));
+        }
+
+        [Test]
+        [Repeat(100)]
+        public void CopyFromOtherWriterUnAlignedBig()
+        {
+            ulong value1 = (ulong)UnityEngine.Random.Range(0, 20000);
+            ulong value2 = (ulong)UnityEngine.Random.Range(0, 20000);
+            ulong value3 = (ulong)UnityEngine.Random.Range(0, 20000);
+            ulong value4 = (ulong)UnityEngine.Random.Range(0, 20000);
+            ulong value5 = (ulong)UnityEngine.Random.Range(0, 20000);
+            otherWriter.Write(value1, 46);
+            otherWriter.Write(value2, 47);
+            otherWriter.Write(value3, 48);
+            otherWriter.Write(value4, 49);
+            otherWriter.Write(value5, 50);
+
+            writer.WriteUInt64(5);
+            writer.Write(1, 3);
+            writer.WriteByte(171);
+
+            writer.CopyFromWriter(otherWriter, 0, 240);
+
+            var segment = writer.ToArraySegment();
+            reader.Reset(segment);
+
+            Assert.That(reader.ReadUInt64(), Is.EqualTo(5ul));
+            Assert.That(reader.Read(3), Is.EqualTo(1));
+            Assert.That(reader.ReadByte(), Is.EqualTo(171));
+            Assert.That(reader.Read(46), Is.EqualTo(value1), "Random value 1 not correct");
+            Assert.That(reader.Read(47), Is.EqualTo(value2), "Random value 2 not correct");
+            Assert.That(reader.Read(48), Is.EqualTo(value3), "Random value 3 not correct");
+            Assert.That(reader.Read(49), Is.EqualTo(value4), "Random value 4 not correct");
+            Assert.That(reader.Read(50), Is.EqualTo(value5), "Random value 5 not correct");
+        }
+
+        [Test]
+        [Repeat(100)]
+        public void CopyFromOtherWriterUnAlignedBigOtherUnaligned()
+        {
+            for (int i = 0; i < 10; i++)
+            {
+                otherWriter.Write(12, 20);
+            }
+
+
+            ulong value1 = (ulong)UnityEngine.Random.Range(0, 20000);
+            ulong value2 = (ulong)UnityEngine.Random.Range(0, 20000);
+            ulong value3 = (ulong)UnityEngine.Random.Range(0, 20000);
+            ulong value4 = (ulong)UnityEngine.Random.Range(0, 20000);
+            ulong value5 = (ulong)UnityEngine.Random.Range(0, 20000);
+            otherWriter.Write(value1, 46);
+            otherWriter.Write(value2, 47);
+            otherWriter.Write(value3, 48);
+            otherWriter.Write(value4, 49);
+            otherWriter.Write(value5, 50);
+
+            writer.WriteUInt64(5);
+            writer.Write(1, 3);
+            writer.WriteByte(171);
+
+            writer.CopyFromWriter(otherWriter, 200, 240);
+
+            var segment = writer.ToArraySegment();
+            reader.Reset(segment);
+
+            Assert.That(reader.ReadUInt64(), Is.EqualTo(5ul));
+            Assert.That(reader.Read(3), Is.EqualTo(1));
+            Assert.That(reader.ReadByte(), Is.EqualTo(171));
+            Assert.That(reader.Read(46), Is.EqualTo(value1), "Random value 1 not correct");
+            Assert.That(reader.Read(47), Is.EqualTo(value2), "Random value 2 not correct");
+            Assert.That(reader.Read(48), Is.EqualTo(value3), "Random value 3 not correct");
+            Assert.That(reader.Read(49), Is.EqualTo(value4), "Random value 4 not correct");
+            Assert.That(reader.Read(50), Is.EqualTo(value5), "Random value 5 not correct");
+        }
+    }
+}
diff --git a/Assets/Tests/Runtime/Serialization/BitPackingCopyFromOtherTests.cs.meta b/Assets/Tests/Runtime/Serialization/BitPackingCopyFromOtherTests.cs.meta
new file mode 100644
index 00000000000..9f868c39c48
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/BitPackingCopyFromOtherTests.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 0fbe9dbb117513140978987f0be0beda
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Runtime/Serialization/BitPackingProperties.cs b/Assets/Tests/Runtime/Serialization/BitPackingProperties.cs
new file mode 100644
index 00000000000..068dec04541
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/BitPackingProperties.cs
@@ -0,0 +1,110 @@
+using Mirage.Serialization;
+using NUnit.Framework;
+
+namespace Mirage.Tests.Runtime.Serialization
+{
+    public class BitPackingProperties
+    {
+        private readonly NetworkWriter writer = new NetworkWriter(1300);
+        private readonly NetworkReader reader = new NetworkReader();
+
+        readonly byte[] sampleData = new byte[10] { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 };
+        const int BITS_PER_BYTE = 8;
+
+        [TearDown]
+        public void TearDown()
+        {
+            writer.Reset();
+            reader.Dispose();
+        }
+
+
+        [Test]
+        public void WriterBitPositionStartsAtZero()
+        {
+            Assert.That(writer.BitPosition, Is.EqualTo(0));
+        }
+
+        [Test]
+        public void WriterByteLengthStartsAtZero()
+        {
+            Assert.That(writer.ByteLength, Is.EqualTo(0));
+        }
+
+        [Test]
+        public void ReaderBitPositionStartsStartsAtZero()
+        {
+            reader.Reset(sampleData);
+            Assert.That(reader.BitPosition, Is.EqualTo(0));
+        }
+
+        [Test]
+        public void ReaderBytePositionStartsStartsAtZero()
+        {
+            reader.Reset(sampleData);
+            Assert.That(reader.BytePosition, Is.EqualTo(0));
+        }
+
+        [Test]
+        public void ReaderBitLengthStartsStartsAtArrayLength()
+        {
+            reader.Reset(sampleData);
+            Assert.That(reader.BitLength, Is.EqualTo(sampleData.Length * BITS_PER_BYTE));
+        }
+
+
+
+        [Test]
+        public void WriterBitPositionIncreasesAfterWriting()
+        {
+            writer.Write(0, 15);
+            Assert.That(writer.BitPosition, Is.EqualTo(15));
+
+            writer.Write(0, 50);
+            Assert.That(writer.BitPosition, Is.EqualTo(65));
+        }
+
+        [Test]
+        public void WriterByteLengthIncreasesAfterWriting_ShouldRoundUp()
+        {
+            writer.Write(0, 15);
+            Assert.That(writer.ByteLength, Is.EqualTo(2));
+
+            writer.Write(0, 50);
+            Assert.That(writer.ByteLength, Is.EqualTo(9));
+        }
+
+        [Test]
+        public void ReaderBitPositionIncreasesAfterReading()
+        {
+            reader.Reset(sampleData);
+            _ = reader.Read(15);
+            Assert.That(reader.BitPosition, Is.EqualTo(15));
+
+            _ = reader.Read(50);
+            Assert.That(reader.BitPosition, Is.EqualTo(65));
+        }
+
+        [Test]
+        public void ReaderBytePositionIncreasesAfterReading_ShouldRoundUp()
+        {
+            reader.Reset(sampleData);
+            _ = reader.Read(15);
+            Assert.That(reader.BytePosition, Is.EqualTo(2));
+
+            _ = reader.Read(50);
+            Assert.That(reader.BytePosition, Is.EqualTo(9));
+        }
+
+        [Test]
+        public void ReaderBitLengthDoesnotIncreasesAfterReading()
+        {
+            reader.Reset(sampleData);
+            _ = reader.Read(15);
+            Assert.That(reader.BitLength, Is.EqualTo(sampleData.Length * BITS_PER_BYTE));
+
+            _ = reader.Read(50);
+            Assert.That(reader.BitLength, Is.EqualTo(sampleData.Length * BITS_PER_BYTE));
+        }
+    }
+}
diff --git a/Assets/Tests/Runtime/Serialization/BitPackingProperties.cs.meta b/Assets/Tests/Runtime/Serialization/BitPackingProperties.cs.meta
new file mode 100644
index 00000000000..1dc463bf93f
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/BitPackingProperties.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 5a96aaa0a5f3acb4a83b659c28316658
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Runtime/Serialization/BitPackingReusingWriterTests.cs b/Assets/Tests/Runtime/Serialization/BitPackingReusingWriterTests.cs
new file mode 100644
index 00000000000..5a2c39c7299
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/BitPackingReusingWriterTests.cs
@@ -0,0 +1,159 @@
+using Mirage.Serialization;
+using NUnit.Framework;
+
+namespace Mirage.Tests.Runtime.Serialization
+{
+    public class BitPackingResizeTest
+    {
+        private NetworkWriter writer;
+        private NetworkReader reader;
+
+        [SetUp]
+        public void OneTimeSetUp()
+        {
+            writer = new NetworkWriter(1300, true);
+            reader = new NetworkReader();
+        }
+
+        [TearDown]
+        public void TearDown()
+        {
+            writer.Reset();
+            reader.Dispose();
+        }
+
+        [Test]
+        public void ResizesIfWritingOverCapacity()
+        {
+            int overCapacity = (1300 / 8) + 10;
+            Assert.That(writer.ByteCapacity, Is.EqualTo(1304), "is first multiple of 8 over 1300");
+            for (int i = 0; i < overCapacity; i++)
+            {
+                writer.WriteUInt64((ulong)i);
+            }
+
+            Assert.That(writer.ByteCapacity, Is.EqualTo(1304 * 2), "should double in size");
+        }
+
+
+        [Test]
+        public void WillResizeMultipleTimes()
+        {
+            int overCapacity = ((1300 / 8) + 10) * 10; // 1720 * 8 = 13760 bytes
+
+            Assert.That(writer.ByteCapacity, Is.EqualTo(1304), "is first multiple of 8 over 1300");
+            for (int i = 0; i < overCapacity; i++)
+            {
+                writer.WriteUInt64((ulong)i);
+            }
+
+
+            Assert.That(writer.ByteCapacity, Is.EqualTo(20_864), "should double each time it goes over capacity");
+        }
+
+        [Test]
+        public void ResizedArrayContainsAllData()
+        {
+            int overCapacity = (1300 / 8) + 10;
+            for (int i = 0; i < overCapacity; i++)
+            {
+                writer.WriteUInt64((ulong)i);
+            }
+
+
+            var segment = writer.ToArraySegment();
+            reader.Reset(segment);
+            for (int i = 0; i < overCapacity; i++)
+            {
+                Assert.That(reader.ReadUInt64(), Is.EqualTo((ulong)i));
+            }
+        }
+    }
+    public class BitPackingReusingWriterTests
+    {
+        private NetworkWriter writer;
+        private NetworkReader reader;
+
+        [OneTimeSetUp]
+        public void OneTimeSetUp()
+        {
+            writer = new NetworkWriter(1300);
+            reader = new NetworkReader();
+        }
+
+        [TearDown]
+        public void TearDown()
+        {
+            writer.Reset();
+            reader.Dispose();
+        }
+
+
+        [Test]
+        public void WriteUShortAfterReset()
+        {
+            ushort value1 = 0b0101;
+            ushort value2 = 0x1000;
+
+            // write first value
+            writer.WriteUInt16(value1);
+
+            reader.Reset(writer.ToArray());
+            ushort out1 = reader.ReadUInt16();
+            Assert.That(out1, Is.EqualTo(value1));
+
+            // reset and write 2nd value
+            writer.Reset();
+
+            writer.WriteUInt16(value2);
+
+            reader.Reset(writer.ToArray());
+            ushort out2 = reader.ReadUInt16();
+            Assert.That(out2, Is.EqualTo(value2), "Value 2 was incorrect");
+        }
+
+        [Test]
+        [TestCase(0b0101ul, 0x1000ul)]
+        [TestCase(0xffff_0000_ffff_fffful, 0x0000_ffff_1111_0000ul)]
+        public void WriteULongAfterReset(ulong value1, ulong value2)
+        {
+            // write first value
+            writer.WriteUInt64(value1);
+
+            reader.Reset(writer.ToArray());
+            ulong out1 = reader.ReadUInt64();
+            Assert.That(out1, Is.EqualTo(value1));
+
+            // reset and write 2nd value
+            writer.Reset();
+
+            writer.WriteUInt64(value2);
+
+            reader.Reset(writer.ToArray());
+            ulong out2 = reader.ReadUInt64();
+            Assert.That(out2, Is.EqualTo(value2), "Value 2 was incorrect");
+        }
+
+        [Test]
+        [TestCase(0b0101ul, 0x1000ul)]
+        [TestCase(0xffff_0000_ffff_fffful, 0x0000_ffff_1111_0000ul)]
+        public void WriteULongWriteBitsAfterReset(ulong value1, ulong value2)
+        {
+            // write first value
+            writer.Write(value1, 64);
+
+            reader.Reset(writer.ToArray());
+            ulong out1 = reader.Read(64);
+            Assert.That(out1, Is.EqualTo(value1));
+
+            // reset and write 2nd value
+            writer.Reset();
+
+            writer.Write(value2, 64);
+
+            reader.Reset(writer.ToArray());
+            ulong out2 = reader.Read(64);
+            Assert.That(out2, Is.EqualTo(value2), "Value 2 was incorrect");
+        }
+    }
+}
diff --git a/Assets/Tests/Runtime/Serialization/BitPackingReusingWriterTests.cs.meta b/Assets/Tests/Runtime/Serialization/BitPackingReusingWriterTests.cs.meta
new file mode 100644
index 00000000000..b2b5efd2714
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/BitPackingReusingWriterTests.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: d600aaf09129e234c9ccd9b98223cdc9
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Runtime/Serialization/BitPackingTests.cs b/Assets/Tests/Runtime/Serialization/BitPackingTests.cs
new file mode 100644
index 00000000000..2fbea6aa71f
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/BitPackingTests.cs
@@ -0,0 +1,194 @@
+using System;
+using System.Runtime.CompilerServices;
+using Mirage.Serialization;
+using NUnit.Framework;
+
+namespace Mirage.Tests.Runtime.Serialization
+{
+    public class BitPackingTests
+    {
+        private NetworkWriter writer;
+        private NetworkReader reader;
+
+        [SetUp]
+        public void Setup()
+        {
+            // dont allow resizing for this test, because we test throw
+            writer = new NetworkWriter(1300, false);
+            reader = new NetworkReader();
+        }
+
+        [TearDown]
+        public void TearDown()
+        {
+            writer.Reset();
+            reader.Dispose();
+        }
+
+        [Test]
+        [TestCase(0ul)]
+        [TestCase(1ul)]
+        [TestCase(0x_FFFF_FFFF_12Ul)]
+        public void WritesCorrectUlongValue(ulong value)
+        {
+            writer.Write(value, 64);
+            reader.Reset(writer.ToArray());
+
+            ulong result = reader.Read(64);
+            Assert.That(result, Is.EqualTo(value));
+        }
+
+        [Test]
+        [TestCase(0u)]
+        [TestCase(1u)]
+        [TestCase(0x_FFFF_FF12U)]
+        public void WritesCorrectUIntValue(uint value)
+        {
+            writer.Write(value, 32);
+            reader.Reset(writer.ToArray());
+
+            ulong result = reader.Read(32);
+            Assert.That(result, Is.EqualTo(value));
+        }
+
+        [Test]
+        [TestCase(0u, 10, 2u, 5)]
+        [TestCase(10u, 10, 36u, 15)]
+        [TestCase(1u, 1, 250u, 8)]
+        public void WritesCorrectValues(uint value1, int bits1, uint value2, int bits2)
+        {
+            writer.Write(value1, bits1);
+            writer.Write(value2, bits2);
+            reader.Reset(writer.ToArray());
+
+            ulong result1 = reader.Read(bits1);
+            ulong result2 = reader.Read(bits2);
+            Assert.That(result1, Is.EqualTo(value1));
+            Assert.That(result2, Is.EqualTo(value2));
+        }
+
+
+        [Test]
+        public void CanWriteToBufferLimit()
+        {
+            for (int i = 0; i < 208; i++)
+            {
+                writer.Write((ulong)i, 50);
+            }
+
+            byte[] result = writer.ToArray();
+
+            // written bits/8
+            int expectedLength = (208 * 50) / 8;
+            Assert.That(result, Has.Length.EqualTo(expectedLength));
+        }
+
+        [Test, Description("Real buffer size is 1304 because 1300 rounds up")]
+        public void WriterThrowIfWritesTooMuch()
+        {
+            // write 1296 up to last word
+            for (int i = 0; i < 162; i++)
+            {
+                writer.Write((ulong)i, 64);
+            }
+
+            writer.Write(0, 63);
+
+            Assert.DoesNotThrow(() =>
+            {
+                writer.Write(0, 1);
+            });
+
+            InvalidOperationException exception = Assert.Throws<InvalidOperationException>(() =>
+            {
+                writer.Write(0, 1);
+            });
+            const int max = 162 * 64 + 64;
+            Assert.That(exception, Has.Message.EqualTo($"Can not write over end of buffer, new length {max + 1}, capacity {max}"));
+        }
+
+        [Test]
+        [Repeat(10)]
+        public void WritesAllValueSizesCorrectly([Range(0, 63)] int startPosition, [Range(0, 64)] int valueBits)
+        {
+            ulong randomValue = ULongRandom.Next();
+            writer.Write(0, startPosition);
+
+            ulong maskedValue = randomValue & BitMask.Mask(valueBits);
+
+            writer.Write(randomValue, valueBits);
+            reader.Reset(writer.ToArray());
+
+            _ = reader.Read(startPosition);
+            ulong result = reader.Read(valueBits);
+            Assert.That(result, Is.EqualTo(maskedValue));
+        }
+
+        [Test]
+        public void WritesAllMasksCorrectly()
+        {
+            // we can't use [range] args because we have to skip cases where end is over 64
+            int count = 0;
+            for (int start = 0; start < 64; start++)
+            {
+                for (int bits = 0; bits < 64; bits++)
+                {
+                    int end = start + bits;
+                    if (end > 64)
+                    {
+                        continue;
+                    }
+
+                    ulong expected = SlowMask(start, end);
+                    ulong actual = BitMask.OuterMask(start, end);
+                    count++;
+                    if (expected != actual)
+                    {
+                        Assert.Fail($"Failed, start:{start} bits:{bits}");
+                    }
+                }
+            }
+            UnityEngine.Debug.Log($"{count} masks tested");
+        }
+
+        /// <summary>
+        /// Slower but correct mask
+        /// </summary>
+        /// <param name="start"></param>
+        /// <param name="end"></param>
+        /// <returns></returns>
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public static ulong SlowMask(int start, int end)
+        {
+            // old mask, doesn't work when bitposition before/after is multiple of 64
+            //           so we need to check if values == 0 before shifting masks
+            ulong mask1 = start == 0 ? 0ul : (ulong.MaxValue >> (64 - start));
+            // note: new position can not be 0, so no need to worry about 
+            ulong mask2 = (end & 0b11_1111) == 0 ? 0ul : (ulong.MaxValue << end /*we can use full position here as c# will mask it to just 6 bits*/);
+            // mask either side of value, eg writing 4 bits at position 3: 111...111_1000_0111
+            ulong mask = mask1 | mask2;
+            return mask;
+        }
+    }
+
+    public static class ULongRandom
+    {
+        static Random rand;
+        static byte[] bytes;
+
+        public static unsafe ulong Next()
+        {
+            if (rand == null)
+            {
+                rand = new System.Random();
+                bytes = new byte[8];
+            }
+
+            rand.NextBytes(bytes);
+            fixed (byte* ptr = &bytes[0])
+            {
+                return *(ulong*)ptr;
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Runtime/Serialization/BitPackingTests.cs.meta b/Assets/Tests/Runtime/Serialization/BitPackingTests.cs.meta
new file mode 100644
index 00000000000..e0da5dfe8c7
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/BitPackingTests.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: ab6374cb6820dd4488f5fe62d1b816a7
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Runtime/Serialization/CompressionTests.cs b/Assets/Tests/Runtime/Serialization/CompressionTests.cs
index ca627e56734..c188518977c 100644
--- a/Assets/Tests/Runtime/Serialization/CompressionTests.cs
+++ b/Assets/Tests/Runtime/Serialization/CompressionTests.cs
@@ -7,7 +7,6 @@ namespace Mirage.Tests.Runtime.Serialization
 {
     public class CompressionTests
     {
-
         [Test]
         [Repeat(100)]
         public void QuaternionCompression()
@@ -52,6 +51,5 @@ public void Compress90Degrees()
             Assert.That(Mathf.Abs(Quaternion.Dot(expected, decompressed)), Is.EqualTo(1).Within(0.001));
 
         }
-
     }
 }
diff --git a/Assets/Tests/Runtime/Serialization/EnumReadWriteTests.cs b/Assets/Tests/Runtime/Serialization/EnumReadWriteTests.cs
index aa2241eafcc..41906d6b224 100644
--- a/Assets/Tests/Runtime/Serialization/EnumReadWriteTests.cs
+++ b/Assets/Tests/Runtime/Serialization/EnumReadWriteTests.cs
@@ -39,16 +39,25 @@ public enum MyCustom
             M, N, O, P
         }
 
+        readonly NetworkWriter writer = new NetworkWriter(1300);
+        readonly NetworkReader reader = new NetworkReader();
+
+        [TearDown]
+        public void TearDown()
+        {
+            writer.Reset();
+            reader.Dispose();
+        }
+
         [Test]
         public void ByteIsSentForByteEnum()
         {
             MyByte byteEnum = MyByte.B;
 
-            var writer = new NetworkWriter();
             writer.Write(byteEnum);
 
             // should only be 1 byte
-            Assert.That(writer.Length, Is.EqualTo(1));
+            Assert.That(writer.ByteLength, Is.EqualTo(1));
         }
 
         [Test]
@@ -56,11 +65,10 @@ public void ShortIsSentForShortEnum()
         {
             MyShort shortEnum = MyShort.G;
 
-            var writer = new NetworkWriter();
             writer.Write(shortEnum);
 
             // should only be 1 byte
-            Assert.That(writer.Length, Is.EqualTo(2));
+            Assert.That(writer.ByteLength, Is.EqualTo(2));
         }
 
         [Test]
@@ -75,10 +83,9 @@ public void CustomWriterIsUsedForEnum()
 
         T SerializeAndDeserializeMessage<T>(T msg)
         {
-            var writer = new NetworkWriter();
             writer.Write(msg);
 
-            var reader = new NetworkReader(writer.ToArraySegment());
+            reader.Reset(writer.ToArraySegment());
             return reader.Read<T>();
         }
     }
diff --git a/Assets/Tests/Runtime/Serialization/MessageInheritanceTest.cs b/Assets/Tests/Runtime/Serialization/MessageInheritanceTest.cs
index 45d91cb672d..b79f2ad4a67 100644
--- a/Assets/Tests/Runtime/Serialization/MessageInheritanceTest.cs
+++ b/Assets/Tests/Runtime/Serialization/MessageInheritanceTest.cs
@@ -40,35 +40,40 @@ public abstract class RequestMessageBaseReverse
     [TestFixture]
     public class MessageInheritanceTest
     {
+        readonly NetworkWriter writer = new NetworkWriter(1300);
+        readonly NetworkReader reader = new NetworkReader();
+
+        [TearDown]
+        public void TearDown()
+        {
+            writer.Reset();
+            reader.Dispose();
+        }
+
+
         [Test]
         public void SendsVauesInParentAndChildClass()
         {
-            var writer = new NetworkWriter();
-
             writer.Write(new ChildMessage
             {
                 parentValue = 3,
                 childValue = 4
             });
 
-            byte[] arr = writer.ToArray();
-
-            var reader = new NetworkReader(arr);
+            reader.Reset(writer.ToArraySegment());
             ChildMessage received = reader.Read<ChildMessage>();
 
             Assert.AreEqual(3, received.parentValue);
             Assert.AreEqual(4, received.childValue);
 
-            int writeLength = writer.Length;
-            int readLength = reader.Position;
+            int writeLength = writer.ByteLength;
+            int readLength = reader.BytePosition;
             Assert.That(writeLength == readLength, $"OnSerializeAll and OnDeserializeAll calls write the same amount of data\n    writeLength={writeLength}\n    readLength={readLength}");
         }
 
         [Test]
         public void SendsVauesWhenUsingAbstractClass()
         {
-            var writer = new NetworkWriter();
-
             const int state = 2;
             const string message = "hello world";
             const int responseId = 5;
@@ -79,25 +84,22 @@ public void SendsVauesWhenUsingAbstractClass()
                 responseId = responseId,
             });
 
-            byte[] arr = writer.ToArray();
+            reader.Reset(writer.ToArraySegment());
 
-            var reader = new NetworkReader(arr);
             ResponseMessage received = reader.Read<ResponseMessage>();
 
             Assert.AreEqual(state, received.state);
             Assert.AreEqual(message, received.message);
             Assert.AreEqual(responseId, received.responseId);
 
-            int writeLength = writer.Length;
-            int readLength = reader.Position;
+            int writeLength = writer.ByteLength;
+            int readLength = reader.BytePosition;
             Assert.That(writeLength == readLength, $"OnSerializeAll and OnDeserializeAll calls write the same amount of data\n    writeLength={writeLength}\n    readLength={readLength}");
         }
 
         [Test]
         public void SendsVauesWhenUsingAbstractClassReverseDefineOrder()
         {
-            var writer = new NetworkWriter();
-
             const int state = 2;
             const string message = "hello world";
             const int responseId = 5;
@@ -108,17 +110,16 @@ public void SendsVauesWhenUsingAbstractClassReverseDefineOrder()
                 responseId = responseId,
             });
 
-            byte[] arr = writer.ToArray();
+            reader.Reset(writer.ToArraySegment());
 
-            var reader = new NetworkReader(arr);
             ResponseMessageReverse received = reader.Read<ResponseMessageReverse>();
 
             Assert.AreEqual(state, received.state);
             Assert.AreEqual(message, received.message);
             Assert.AreEqual(responseId, received.responseId);
 
-            int writeLength = writer.Length;
-            int readLength = reader.Position;
+            int writeLength = writer.ByteLength;
+            int readLength = reader.BytePosition;
             Assert.That(writeLength == readLength, $"OnSerializeAll and OnDeserializeAll calls write the same amount of data\n    writeLength={writeLength}\n    readLength={readLength}");
         }
     }
diff --git a/Assets/Tests/Runtime/Serialization/NetworkPlayerTest.cs b/Assets/Tests/Runtime/Serialization/NetworkPlayerTest.cs
index b769f774f3d..ce826196c47 100644
--- a/Assets/Tests/Runtime/Serialization/NetworkPlayerTest.cs
+++ b/Assets/Tests/Runtime/Serialization/NetworkPlayerTest.cs
@@ -73,7 +73,8 @@ public void SetUp()
             connection = Substitute.For<SocketLayer.IConnection>();
             player = new NetworkPlayer(connection);
             // reader with some random data
-            reader = new NetworkReader(new byte[] { 1, 2, 3, 4 });
+            reader = new NetworkReader();
+            reader.Reset(new byte[] { 1, 2, 3, 4 });
         }
 
 
diff --git a/Assets/Tests/Runtime/Serialization/NetworkReaderPoolTest.cs b/Assets/Tests/Runtime/Serialization/NetworkReaderPoolTest.cs
deleted file mode 100644
index 951364abb31..00000000000
--- a/Assets/Tests/Runtime/Serialization/NetworkReaderPoolTest.cs
+++ /dev/null
@@ -1,129 +0,0 @@
-using System;
-using System.Linq;
-using Mirage.Serialization;
-using NUnit.Framework;
-
-namespace Mirage.Tests.Runtime.Serialization
-{
-    public class NetworkReaderPoolTest
-    {
-        int defaultCapacity;
-
-        [SetUp]
-        public void SetUp()
-        {
-            defaultCapacity = NetworkReaderPool.Capacity;
-        }
-
-        [TearDown]
-        public void TearDown()
-        {
-            NetworkReaderPool.Capacity = defaultCapacity;
-        }
-
-        [Test]
-        public void TestPoolRecycling()
-        {
-            object firstReader;
-
-            using (PooledNetworkReader Reader = NetworkReaderPool.GetReader(default(ArraySegment<byte>)))
-            {
-                firstReader = Reader;
-            }
-
-            using (PooledNetworkReader Reader = NetworkReaderPool.GetReader(default(ArraySegment<byte>)))
-            {
-                Assert.That(Reader, Is.SameAs(firstReader), "Pool should reuse the Reader");
-            }
-        }
-
-        [Test]
-        public void PoolCanGetMoreReadersThanPoolSize()
-        {
-            NetworkReaderPool.Capacity = 5;
-
-            const int testReaderCount = 10;
-            var Readers = new PooledNetworkReader[testReaderCount];
-
-            for (int i = 0; i < testReaderCount; i++)
-            {
-                Readers[i] = NetworkReaderPool.GetReader(default(ArraySegment<byte>));
-            }
-
-            // Make sure all Readers are different
-            Assert.That(Readers.Distinct().Count(), Is.EqualTo(testReaderCount));
-        }
-
-        [Test]
-        public void PoolReUsesReadersUpToSizeLimit()
-        {
-            NetworkReaderPool.Capacity = 1;
-
-            // get 2 Readers
-            PooledNetworkReader a = NetworkReaderPool.GetReader(default(ArraySegment<byte>));
-            PooledNetworkReader b = NetworkReaderPool.GetReader(default(ArraySegment<byte>));
-
-            // recycle all
-            NetworkReaderPool.Recycle(a);
-            NetworkReaderPool.Recycle(b);
-
-            // get 2 new ones
-            PooledNetworkReader c = NetworkReaderPool.GetReader(default(ArraySegment<byte>));
-            PooledNetworkReader d = NetworkReaderPool.GetReader(default(ArraySegment<byte>));
-
-            // exactly one should be reused, one should be new
-            bool cReused = c == a || c == b;
-            bool dReused = d == a || d == b;
-            Assert.That((cReused && !dReused) ||
-                        (!cReused && dReused));
-        }
-
-        // if we shrink the capacity, the internal 'next' needs to be adjusted
-        // to the new capacity so we don't get a IndexOutOfRangeException
-        [Test]
-        public void ShrinkCapacity()
-        {
-            NetworkReaderPool.Capacity = 2;
-
-            // get Reader and recycle so we have 2 in there, hence 'next' is at limit
-            PooledNetworkReader a = NetworkReaderPool.GetReader(default(ArraySegment<byte>));
-            PooledNetworkReader b = NetworkReaderPool.GetReader(default(ArraySegment<byte>));
-            NetworkReaderPool.Recycle(a);
-            NetworkReaderPool.Recycle(b);
-
-            // shrink
-            NetworkReaderPool.Capacity = 1;
-
-            // get one. should return the only one which is still in there.
-            PooledNetworkReader c = NetworkReaderPool.GetReader(default(ArraySegment<byte>));
-            Assert.That(c, !Is.Null);
-            Assert.That(c == a || c == b);
-        }
-
-        // if we grow the capacity, things should still work fine
-        [Test]
-        public void GrowCapacity()
-        {
-            NetworkReaderPool.Capacity = 1;
-
-            // create and recycle one
-            PooledNetworkReader a = NetworkReaderPool.GetReader(default(ArraySegment<byte>));
-            NetworkReaderPool.Recycle(a);
-
-            // grow capacity
-            NetworkReaderPool.Capacity = 2;
-
-            // get two
-            PooledNetworkReader b = NetworkReaderPool.GetReader(default(ArraySegment<byte>));
-            PooledNetworkReader c = NetworkReaderPool.GetReader(default(ArraySegment<byte>));
-            Assert.That(b, !Is.Null);
-            Assert.That(c, !Is.Null);
-
-            // exactly one should be reused, one should be new
-            bool bReused = b == a;
-            bool cReused = c == a;
-            Assert.That((bReused && !cReused) ||
-                        (!bReused && cReused));
-        }
-    }
-}
diff --git a/Assets/Tests/Runtime/Serialization/NetworkReaderTest.cs b/Assets/Tests/Runtime/Serialization/NetworkReaderTest.cs
index f2a7f805636..3b724065e25 100644
--- a/Assets/Tests/Runtime/Serialization/NetworkReaderTest.cs
+++ b/Assets/Tests/Runtime/Serialization/NetworkReaderTest.cs
@@ -18,16 +18,10 @@ public void ReadBytesCountTooBigTest()
 
             using (PooledNetworkReader reader = NetworkReaderPool.GetReader(bytes))
             {
-                try
+                Assert.Throws<EndOfStreamException>(() =>
                 {
-                    reader.ReadBytes(bytes, bytes.Length + 1);
-                    // BAD: IF WE GOT HERE, THEN NO EXCEPTION WAS THROWN
-                    Assert.Fail();
-                }
-                catch (EndOfStreamException)
-                {
-                    // GOOD
-                }
+                    reader.ReadBytes(bytes, 0, bytes.Length + 1);
+                });
             }
         }
     }
diff --git a/Assets/Tests/Runtime/Serialization/NetworkReaderWriterTest.cs b/Assets/Tests/Runtime/Serialization/NetworkReaderWriterTest.cs
index e94b53d9b42..c526dc5c537 100644
--- a/Assets/Tests/Runtime/Serialization/NetworkReaderWriterTest.cs
+++ b/Assets/Tests/Runtime/Serialization/NetworkReaderWriterTest.cs
@@ -44,12 +44,15 @@ public void TestAccessingCustomWriterAndReader()
                 id = 10,
                 name = "Yo Gaba Gaba"
             };
-            var writer = new NetworkWriter();
+            var writer = new NetworkWriter(1300);
             writer.Write(data);
-            var reader = new NetworkReader(writer.ToArray());
+            var reader = new NetworkReader();
+            reader.Reset(writer.ToArraySegment());
             MyType copy = reader.Read<MyType>();
 
             Assert.That(copy, Is.EqualTo(data));
+
+            reader.Dispose();
         }
     }
 }
diff --git a/Assets/Tests/Runtime/Serialization/NetworkWriterPoolTest.cs b/Assets/Tests/Runtime/Serialization/NetworkWriterPoolTest.cs
deleted file mode 100644
index eda2509d06f..00000000000
--- a/Assets/Tests/Runtime/Serialization/NetworkWriterPoolTest.cs
+++ /dev/null
@@ -1,128 +0,0 @@
-using System.Linq;
-using Mirage.Serialization;
-using NUnit.Framework;
-
-namespace Mirage.Tests.Runtime.Serialization
-{
-    public class NetworkWriterPoolTest
-    {
-        int defaultCapacity;
-
-        [SetUp]
-        public void SetUp()
-        {
-            defaultCapacity = NetworkWriterPool.Capacity;
-        }
-
-        [TearDown]
-        public void TearDown()
-        {
-            NetworkWriterPool.Capacity = defaultCapacity;
-        }
-
-        [Test]
-        public void TestPoolRecycling()
-        {
-            object firstWriter;
-
-            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
-            {
-                firstWriter = writer;
-            }
-
-            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
-            {
-                Assert.That(writer, Is.SameAs(firstWriter), "Pool should reuse the writer");
-            }
-        }
-
-        [Test]
-        public void PoolCanGetMoreWritersThanPoolSize()
-        {
-            NetworkWriterPool.Capacity = 5;
-
-            const int testWriterCount = 10;
-            var writers = new PooledNetworkWriter[testWriterCount];
-
-            for (int i = 0; i < testWriterCount; i++)
-            {
-                writers[i] = NetworkWriterPool.GetWriter();
-            }
-
-            // Make sure all writers are different
-            Assert.That(writers.Distinct().Count(), Is.EqualTo(testWriterCount));
-        }
-
-        [Test]
-        public void PoolReUsesWritersUpToSizeLimit()
-        {
-            NetworkWriterPool.Capacity = 1;
-
-            // get 2 writers
-            PooledNetworkWriter a = NetworkWriterPool.GetWriter();
-            PooledNetworkWriter b = NetworkWriterPool.GetWriter();
-
-            // recycle all
-            NetworkWriterPool.Recycle(a);
-            NetworkWriterPool.Recycle(b);
-
-            // get 2 new ones
-            PooledNetworkWriter c = NetworkWriterPool.GetWriter();
-            PooledNetworkWriter d = NetworkWriterPool.GetWriter();
-
-            // exactly one should be reused, one should be new
-            bool cReused = c == a || c == b;
-            bool dReused = d == a || d == b;
-            Assert.That((cReused && !dReused) ||
-                        (!cReused && dReused));
-        }
-
-        // if we shrink the capacity, the internal 'next' needs to be adjusted
-        // to the new capacity so we don't get a IndexOutOfRangeException
-        [Test]
-        public void ShrinkCapacity()
-        {
-            NetworkWriterPool.Capacity = 2;
-
-            // get writer and recycle so we have 2 in there, hence 'next' is at limit
-            PooledNetworkWriter a = NetworkWriterPool.GetWriter();
-            PooledNetworkWriter b = NetworkWriterPool.GetWriter();
-            NetworkWriterPool.Recycle(a);
-            NetworkWriterPool.Recycle(b);
-
-            // shrink
-            NetworkWriterPool.Capacity = 1;
-
-            // get one. should return the only one which is still in there.
-            PooledNetworkWriter c = NetworkWriterPool.GetWriter();
-            Assert.That(c, !Is.Null);
-            Assert.That(c == a || c == b);
-        }
-
-        // if we grow the capacity, things should still work fine
-        [Test]
-        public void GrowCapacity()
-        {
-            NetworkWriterPool.Capacity = 1;
-
-            // create and recycle one
-            PooledNetworkWriter a = NetworkWriterPool.GetWriter();
-            NetworkWriterPool.Recycle(a);
-
-            // grow capacity
-            NetworkWriterPool.Capacity = 2;
-
-            // get two
-            PooledNetworkWriter b = NetworkWriterPool.GetWriter();
-            PooledNetworkWriter c = NetworkWriterPool.GetWriter();
-            Assert.That(b, !Is.Null);
-            Assert.That(c, !Is.Null);
-
-            // exactly one should be reused, one should be new
-            bool bReused = b == a;
-            bool cReused = c == a;
-            Assert.That((bReused && !cReused) ||
-                        (!bReused && cReused));
-        }
-    }
-}
diff --git a/Assets/Tests/Runtime/Serialization/NetworkWriterTest.cs b/Assets/Tests/Runtime/Serialization/NetworkWriterTest.cs
index 60d03c9bce7..8e081c1558f 100644
--- a/Assets/Tests/Runtime/Serialization/NetworkWriterTest.cs
+++ b/Assets/Tests/Runtime/Serialization/NetworkWriterTest.cs
@@ -9,43 +9,16 @@ namespace Mirage.Tests.Runtime.Serialization
     [TestFixture]
     public class NetworkWriterTest
     {
-        private NetworkWriter writer;
+        private readonly NetworkWriter writer = new NetworkWriter(1300);
+        private readonly NetworkReader reader = new NetworkReader();
 
-        [SetUp]
-        public void SetUp()
+        [TearDown]
+        public void TearDown()
         {
-            writer = new NetworkWriter();
+            reader.Dispose();
+            writer.Reset();
         }
 
-        [Test]
-        public void TestWritingSmallMessage()
-        {
-            // try serializing less than 32kb and see what happens
-            for (int i = 0; i < 30000 / 4; ++i)
-                writer.WriteInt32(i);
-            Assert.That(writer.Position, Is.EqualTo(30000));
-        }
-
-        [Test]
-        public void TestWritingLargeMessage()
-        {
-            // try serializing more than 32kb and see what happens
-            for (int i = 0; i < 40000 / 4; ++i)
-                writer.WriteInt32(i);
-            Assert.That(writer.Position, Is.EqualTo(40000));
-        }
-
-        [Test]
-        public void TestWritingHugeArray()
-        {
-            // try serializing array more than 64KB large and see what happens
-            writer.WriteBytesAndSize(new byte[100000]);
-            byte[] data = writer.ToArray();
-
-            var reader = new NetworkReader(data);
-            byte[] deserialized = reader.ReadBytesAndSize();
-            Assert.That(deserialized.Length, Is.EqualTo(100000));
-        }
 
         [Test]
         public void TestWritingBytesSegment()
@@ -53,7 +26,7 @@ public void TestWritingBytesSegment()
             byte[] data = { 1, 2, 3 };
             writer.WriteBytes(data, 0, data.Length);
 
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             ArraySegment<byte> deserialized = reader.ReadBytesSegment(data.Length);
             Assert.That(deserialized.Count, Is.EqualTo(data.Length));
             for (int i = 0; i < data.Length; ++i)
@@ -67,7 +40,7 @@ public void TestWritingBytesAndReadingSegment()
             byte[] data = { 1, 2, 3 };
             writer.WriteBytesAndSize(data);
 
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             ArraySegment<byte> deserialized = reader.ReadBytesAndSizeSegment();
             Assert.That(deserialized.Count, Is.EqualTo(data.Length));
             for (int i = 0; i < data.Length; ++i)
@@ -83,7 +56,7 @@ public void TestWritingSegmentAndReadingSegment()
             var segment = new ArraySegment<byte>(data, 1, 1);
             writer.WriteBytesAndSizeSegment(segment);
 
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             ArraySegment<byte> deserialized = reader.ReadBytesAndSizeSegment();
             Assert.That(deserialized.Count, Is.EqualTo(segment.Count));
             for (int i = 0; i < segment.Count; ++i)
@@ -95,37 +68,10 @@ public void TestMaxStringWrite()
         {
             Assert.Throws<DataMisalignedException>(() =>
             {
-                writer.WriteString(new string('*', NetworkWriter.MaxStringLength));
+                writer.WriteString(new string('*', StringExtensions.MaxStringLength));
             });
         }
 
-        [Test]
-        public void TestSetLengthZeroes()
-        {
-            writer.WriteString("I saw");
-            writer.WriteInt64(0xA_FADED_DEAD_EEL);
-            writer.WriteString("and ate it");
-            int position = writer.Position;
-
-            writer.SetLength(10);
-            Assert.That(writer.Position, Is.EqualTo(10), "Decreasing length should move position");
-
-            // lets grow it back and check there's zeroes now.
-            writer.SetLength(position);
-            byte[] data = writer.ToArray();
-            for (int i = 10; i < data.Length; i++)
-            {
-                Assert.That(data[i], Is.EqualTo(0), $"index {i} should have value 0");
-            }
-        }
-
-        [Test]
-        public void TestSetLengthInitialization()
-        {
-            writer.SetLength(10);
-            Assert.That(writer.Position, Is.EqualTo(0), "Increasing length should not move position");
-        }
-
         [Test]
         public void TestResetSetsPotionAndLength()
         {
@@ -134,8 +80,8 @@ public void TestResetSetsPotionAndLength()
             writer.WriteString("and ate it");
             writer.Reset();
 
-            Assert.That(writer.Position, Is.EqualTo(0));
-            Assert.That(writer.Length, Is.EqualTo(0));
+            Assert.That(writer.BitPosition, Is.EqualTo(0));
+            Assert.That(writer.ByteLength, Is.EqualTo(0));
 
             byte[] data = writer.ToArray();
             Assert.That(data, Is.Empty);
@@ -146,7 +92,7 @@ public void TestReadingLengthWrapAround()
         {
             // This is 1.5x int.MaxValue, in the negative range of int.
             writer.WritePackedUInt32(3221225472);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             Assert.Throws<OverflowException>(() => reader.ReadBytesAndSize());
         }
 
@@ -154,7 +100,7 @@ public void TestReadingLengthWrapAround()
         public void TestReading0LengthBytesAndSize()
         {
             writer.WriteBytesAndSize(new byte[] { });
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             Assert.That(reader.ReadBytesAndSize().Length, Is.EqualTo(0));
         }
 
@@ -162,7 +108,7 @@ public void TestReading0LengthBytesAndSize()
         public void TestReading0LengthBytes()
         {
             writer.WriteBytes(new byte[] { }, 0, 0);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             Assert.That(reader.ReadBytes(0).Length, Is.EqualTo(0));
         }
 
@@ -170,15 +116,19 @@ public void TestReading0LengthBytes()
         public void TestWritingNegativeBytesAndSizeFailure()
         {
             Assert.Throws<OverflowException>(() => writer.WriteBytesAndSize(new byte[0], 0, -1));
-            Assert.That(writer.Position, Is.EqualTo(0));
+            Assert.That(writer.ByteLength, Is.EqualTo(0));
         }
 
         [Test]
         public void TestReadingTooMuch()
         {
-            void EnsureThrows(Action<NetworkReader> read, byte[] data = null)
+            void EnsureThrows(Action<NetworkReader> read)
             {
-                Assert.Throws<System.IO.EndOfStreamException>(() => read(new NetworkReader(data ?? new byte[] { })));
+                Assert.Throws<System.IO.EndOfStreamException>(() =>
+                {
+                    reader.Reset(new byte[0]);
+                    read.Invoke(reader);
+                });
             }
             // Try reading more than there is data to be read from
             // This should throw EndOfStreamException always
@@ -192,7 +142,8 @@ void EnsureThrows(Action<NetworkReader> read, byte[] data = null)
             EnsureThrows(r => r.ReadUInt32());
             EnsureThrows(r => r.ReadInt64());
             EnsureThrows(r => r.ReadUInt64());
-            EnsureThrows(r => r.ReadDecimal());
+            EnsureThrows(r => r.ReadUInt64());
+            EnsureThrows(r => r.ReadDecimalConverter());
             EnsureThrows(r => r.ReadSingle());
             EnsureThrows(r => r.ReadDouble());
             EnsureThrows(r => r.ReadString());
@@ -241,7 +192,7 @@ void EnsureThrows(Action<NetworkReader> read, byte[] data = null)
         public void TestVector2(Vector2 vector)
         {
             writer.WriteVector2(vector);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             Vector2 output = reader.ReadVector2();
             Assert.That(output, Is.EqualTo(vector));
         }
@@ -260,7 +211,7 @@ public void TestVector2(Vector2 vector)
         public void TestVector3(Vector3 input)
         {
             writer.WriteVector3(input);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             Vector3 output = reader.ReadVector3();
             Assert.That(output, Is.EqualTo(input));
         }
@@ -278,7 +229,7 @@ public void TestVector3(Vector3 input)
         public void TestVector4(Vector4 input)
         {
             writer.WriteVector4(input);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             Vector4 output = reader.ReadVector4();
             Assert.That(output, Is.EqualTo(input));
         }
@@ -297,7 +248,7 @@ public void TestVector4(Vector4 input)
         public void TestVector2Int(Vector2Int input)
         {
             writer.WriteVector2Int(input);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             Vector2Int output = reader.ReadVector2Int();
             Assert.That(output, Is.EqualTo(input));
         }
@@ -317,7 +268,7 @@ public void TestVector2Int(Vector2Int input)
         public void TestVector3Int(Vector3Int input)
         {
             writer.WriteVector3Int(input);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             Vector3Int output = reader.ReadVector3Int();
             Assert.That(output, Is.EqualTo(input));
         }
@@ -336,7 +287,7 @@ public void TestVector3Int(Vector3Int input)
         public void TestColor(Color input)
         {
             writer.WriteColor(input);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             Color output = reader.ReadColor();
             Assert.That(output, Is.EqualTo(input));
         }
@@ -356,7 +307,7 @@ public void TestColor(Color input)
         public void TestColor32(Color32 input)
         {
             writer.WriteColor32(input);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             Color32 output = reader.ReadColor32();
             Assert.That(output, Is.EqualTo(input));
         }
@@ -372,7 +323,7 @@ public void TestColor32(Color32 input)
         public void TestQuaternion(Quaternion input)
         {
             writer.WriteQuaternion(input);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             Quaternion output = reader.ReadQuaternion();
             Assert.That(output, Is.EqualTo(input));
         }
@@ -389,7 +340,7 @@ public void TestQuaternion(Quaternion input)
         public void TestRect(Rect input)
         {
             writer.WriteRect(input);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             Rect output = reader.ReadRect();
             Assert.That(output, Is.EqualTo(input));
         }
@@ -405,7 +356,7 @@ public void TestRect(Rect input)
         public void TestPlane(Plane input)
         {
             writer.WritePlane(input);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             Plane output = reader.ReadPlane();
             // note: Plane constructor does math internally, resulting in
             // floating point precision loss that causes exact comparison
@@ -424,7 +375,7 @@ public void TestPlane(Plane input)
         public void TestRay(Ray input)
         {
             writer.WriteRay(input);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             Ray output = reader.ReadRay();
             Assert.That((output.direction - input.direction).magnitude, Is.LessThan(1e-6f));
             Assert.That(output.origin, Is.EqualTo(input.origin));
@@ -442,7 +393,7 @@ public void TestRay(Ray input)
         public void TestMatrix(Matrix4x4 input)
         {
             writer.WriteMatrix4X4(input);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             Matrix4x4 output = reader.ReadMatrix4x4();
             Assert.That(output, Is.EqualTo(input));
         }
@@ -462,21 +413,25 @@ public void TestReadingInvalidString(byte invalid)
             writer.WriteString("an uncorrupted string");
             byte[] data = writer.ToArray();
             data[10] = invalid;
-            var reader = new NetworkReader(data);
+            reader.Reset(data);
             Assert.Throws<System.Text.DecoderFallbackException>(() => reader.ReadString());
         }
 
         [Test]
         public void TestReadingTruncatedString()
         {
-            writer.WriteString("a string longer than 10 bytes");
-            writer.SetLength(10);
-            var reader = new NetworkReader(writer.ToArray());
+            const string str = "a string longer than 10 bytes";
+            writer.WriteString(str);
+            // change length value to longer than string
+            // +2 because length is already +1 to handle null
+            writer.WriteAtPosition((ushort)(str.Length + 2), 16, 0);
+
+            reader.Reset(writer.ToArraySegment());
             Assert.Throws<System.IO.EndOfStreamException>(() => reader.ReadString());
         }
 
         [Test]
-        public void TestToArray()
+        public void WriteAtPositionTest()
         {
             // write 2 bytes
             writer.WriteByte(1);
@@ -486,7 +441,24 @@ public void TestToArray()
             Assert.That(writer.ToArray().Length, Is.EqualTo(2));
 
             // set position back by one
-            writer.Position = 1;
+            writer.WriteAtPosition(2, 8, 8);
+
+            // Changing the position should not alter the size of the data
+            Assert.That(writer.ToArray().Length, Is.EqualTo(2));
+        }
+
+        [Test]
+        public void WriteAtBytePositionTest()
+        {
+            // write 2 bytes
+            writer.WriteByte(1);
+            writer.WriteByte(2);
+
+            // .ToArray() length is 2?
+            Assert.That(writer.ToArray().Length, Is.EqualTo(2));
+
+            // set position back by one
+            writer.WriteAtBytePosition(2, 8, 1);
 
             // Changing the position should not alter the size of the data
             Assert.That(writer.ToArray().Length, Is.EqualTo(2));
@@ -498,7 +470,7 @@ public void TestToArraySegment()
             writer.WriteString("hello");
             writer.WriteString("world");
 
-            var reader = new NetworkReader(writer.ToArraySegment());
+            reader.Reset(writer.ToArraySegment());
             Assert.That(reader.ReadString(), Is.EqualTo("hello"));
             Assert.That(reader.ReadString(), Is.EqualTo("world"));
         }
@@ -511,7 +483,7 @@ public void TestChar()
 
             writer.WriteChar(a);
             writer.WriteChar(u);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             char a2 = reader.ReadChar();
             Assert.That(a2, Is.EqualTo(a));
             char u2 = reader.ReadChar();
@@ -560,8 +532,7 @@ public void TestChar()
         public void TestUnicodeString(string weird)
         {
             writer.WriteString(weird);
-            byte[] data = writer.ToArray();
-            var reader = new NetworkReader(data);
+            reader.Reset(writer.ToArraySegment());
             string str = reader.ReadString();
             Assert.That(str, Is.EqualTo(weird));
         }
@@ -581,7 +552,7 @@ public void TestUnicodeString(string weird)
         public void TestPackedUInt32(uint value)
         {
             writer.WritePackedUInt32(value);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             Assert.That(reader.ReadPackedUInt32(), Is.EqualTo(value));
         }
 
@@ -589,7 +560,7 @@ public void TestPackedUInt32(uint value)
         public void TestUInt32(uint value)
         {
             writer.WriteUInt32(value);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             Assert.That(reader.ReadUInt32(), Is.EqualTo(value));
         }
 
@@ -606,7 +577,7 @@ public void TestPackedUInt32Failure(long data)
             Assert.Throws<OverflowException>(() =>
             {
                 writer.WritePackedUInt64((ulong)data);
-                var reader = new NetworkReader(writer.ToArray());
+                reader.Reset(writer.ToArraySegment());
                 reader.ReadPackedUInt32();
             });
         }
@@ -633,7 +604,7 @@ public void TestPackedUInt32Failure(long data)
         public void TestPackedInt32(int data)
         {
             writer.WritePackedInt32(data);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             Assert.That(reader.ReadPackedInt32(), Is.EqualTo(data));
         }
 
@@ -641,7 +612,7 @@ public void TestPackedInt32(int data)
         public void TestInt32(int data)
         {
             writer.WriteInt32(data);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             Assert.That(reader.ReadInt32(), Is.EqualTo(data));
         }
 
@@ -651,7 +622,7 @@ public void TestPackedInt32Failure(long data)
             Assert.Throws<OverflowException>(() =>
             {
                 writer.WritePackedInt64(data);
-                var reader = new NetworkReader(writer.ToArray());
+                reader.Reset(writer.ToArraySegment());
                 reader.ReadPackedInt32();
             });
         }
@@ -675,7 +646,7 @@ public void TestPackedInt32Failure(long data)
         public void TestPackedUInt64(ulong data)
         {
             writer.WritePackedUInt64(data);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             Assert.That(reader.ReadPackedUInt64(), Is.EqualTo(data));
         }
 
@@ -683,7 +654,7 @@ public void TestPackedUInt64(ulong data)
         public void TestUInt64(ulong data)
         {
             writer.WriteUInt64(data);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             Assert.That(reader.ReadUInt64(), Is.EqualTo(data));
         }
 
@@ -717,7 +688,7 @@ public void TestUInt64(ulong data)
         public void TestPackedInt64(long data)
         {
             writer.WritePackedInt64(data);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             Assert.That(reader.ReadPackedInt64(), Is.EqualTo(data));
         }
 
@@ -725,7 +696,7 @@ public void TestPackedInt64(long data)
         public void TestInt64(long data)
         {
             writer.WriteInt64(data);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             Assert.That(reader.ReadInt64(), Is.EqualTo(data));
         }
 
@@ -735,7 +706,7 @@ public void TestGuid()
             var originalGuid = new Guid("0123456789abcdef9876543210fedcba");
             writer.WriteGuid(originalGuid);
 
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             Guid readGuid = reader.ReadGuid();
             Assert.That(readGuid, Is.EqualTo(originalGuid));
         }
@@ -764,7 +735,7 @@ public void TestGuid()
         public void TestFloats(float weird)
         {
             writer.WriteSingle(weird);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             float readFloat = reader.ReadSingle();
             Assert.That(readFloat, Is.EqualTo(weird));
         }
@@ -793,7 +764,7 @@ public void TestFloats(float weird)
         public void TestDoubles(double weird)
         {
             writer.WriteDouble(weird);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             double readDouble = reader.ReadDouble();
             Assert.That(readDouble, Is.EqualTo(weird));
         }
@@ -811,9 +782,9 @@ public void TestDoubles(double weird)
         [Test, TestCaseSource(nameof(weirdDecimals))]
         public void TestDecimals(decimal weird)
         {
-            writer.WriteDecimal(weird);
-            var reader = new NetworkReader(writer.ToArray());
-            decimal readDecimal = reader.ReadDecimal();
+            writer.WriteDecimalConverter(weird);
+            reader.Reset(writer.ToArraySegment());
+            decimal readDecimal = reader.ReadDecimalConverter();
             Assert.That(readDecimal, Is.EqualTo(weird));
         }
 
@@ -868,7 +839,7 @@ public void TestDecimalBinaryCompatibility()
             };
             foreach (decimal weird in inputDecimals)
             {
-                writer.WriteDecimal(weird);
+                writer.WriteDecimalConverter(weird);
             }
             Assert.That(writer.ToArray(), Is.EqualTo(expected));
         }
@@ -950,7 +921,7 @@ public void TestWritingAndReading()
             writer.WriteUInt64(9UL);
             writer.WriteSingle(10.0F);
             writer.WriteDouble(11.0D);
-            writer.WriteDecimal(12);
+            writer.WriteDecimalConverter(12);
             writer.WriteString(null);
             writer.WriteString("");
             writer.WriteString("13");
@@ -967,7 +938,7 @@ public void TestWritingAndReading()
             writer.WriteBytesAndSize(new byte[] { 22, 23 }, 0, 2);
 
             // read them
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
 
             Assert.That(reader.ReadChar(), Is.EqualTo(1));
             Assert.That(reader.ReadByte(), Is.EqualTo(2));
@@ -981,7 +952,7 @@ public void TestWritingAndReading()
             Assert.That(reader.ReadUInt64(), Is.EqualTo(9));
             Assert.That(reader.ReadSingle(), Is.EqualTo(10));
             Assert.That(reader.ReadDouble(), Is.EqualTo(11));
-            Assert.That(reader.ReadDecimal(), Is.EqualTo(12));
+            Assert.That(reader.ReadDecimalConverter(), Is.EqualTo(12));
             // writing null string should write null in Mirage ("" in original HLAPI)
             Assert.That(reader.ReadString(), Is.Null);
             Assert.That(reader.ReadString(), Is.EqualTo(""));
@@ -1004,7 +975,7 @@ public void TestList()
             var original = new List<int> { 1, 2, 3, 4, 5 };
             writer.Write(original);
 
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             List<int> readList = reader.Read<List<int>>();
             Assert.That(readList, Is.EqualTo(original));
         }
@@ -1014,7 +985,7 @@ public void TestNullList()
         {
             writer.Write<List<int>>(null);
 
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             List<int> readList = reader.Read<List<int>>();
             Assert.That(readList, Is.Null);
         }
@@ -1024,12 +995,12 @@ public void TestWriteNetworkBehavior()
         {
             writer.WriteNetworkBehaviour(null);
 
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             NetworkBehaviour behavior = reader.ReadNetworkBehaviour();
 
             Assert.That(behavior, Is.Null);
 
-            Assert.That(writer.Position, Is.EqualTo(reader.Position));
+            Assert.That(writer.ByteLength, Is.EqualTo(reader.BytePosition));
         }
 
         [Test]
@@ -1037,12 +1008,12 @@ public void TestWriteGameObject()
         {
             writer.WriteGameObject(null);
 
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             GameObject obj = reader.ReadGameObject();
 
             Assert.That(obj, Is.Null);
 
-            Assert.That(writer.Position, Is.EqualTo(reader.Position));
+            Assert.That(writer.ByteLength, Is.EqualTo(reader.BytePosition));
         }
 
         // use networkmessage to make sure writer is generated
@@ -1062,7 +1033,7 @@ public struct NullableIntMessage
         public void NullableInt(int? value)
         {
             writer.Write(value);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             int? unpacked = reader.Read<int?>();
 
             Assert.That(unpacked, Is.EqualTo(value));
@@ -1075,7 +1046,7 @@ public void NullableInt(int? value)
         public void NullableBool(bool? value)
         {
             writer.Write(value);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             bool? unpacked = reader.Read<bool?>();
 
             Assert.That(unpacked, Is.EqualTo(value));
@@ -1088,10 +1059,53 @@ public void NullableBool(bool? value)
         public void NullableUlong(ulong? value)
         {
             writer.Write(value);
-            var reader = new NetworkReader(writer.ToArray());
+            reader.Reset(writer.ToArraySegment());
             ulong? unpacked = reader.Read<ulong?>();
 
             Assert.That(unpacked, Is.EqualTo(value));
         }
+
+        public void SByteLength()
+        {
+            writer.WriteSByte(14);
+            Assert.That(writer.BitPosition, Is.EqualTo(8));
+        }
+        public void Int16Length()
+        {
+            writer.WriteInt16(50);
+            Assert.That(writer.BitPosition, Is.EqualTo(16));
+        }
+        public void Int32Length()
+        {
+            writer.WriteInt32(20);
+            Assert.That(writer.BitPosition, Is.EqualTo(32));
+        }
+        public void Int64Length()
+        {
+            writer.WriteInt64(21);
+            Assert.That(writer.BitPosition, Is.EqualTo(64));
+        }
+
+
+        public void ByteLength()
+        {
+            writer.WriteByte(20);
+            Assert.That(writer.BitPosition, Is.EqualTo(8));
+        }
+        public void UInt16Length()
+        {
+            writer.WriteUInt16(263);
+            Assert.That(writer.BitPosition, Is.EqualTo(16));
+        }
+        public void UInt32Length()
+        {
+            writer.WriteUInt32(65);
+            Assert.That(writer.BitPosition, Is.EqualTo(32));
+        }
+        public void UInt64Length()
+        {
+            writer.WriteUInt64(22);
+            Assert.That(writer.BitPosition, Is.EqualTo(64));
+        }
     }
 }
diff --git a/Assets/Tests/Runtime/Serialization/StructMessagesTests.cs b/Assets/Tests/Runtime/Serialization/StructMessagesTests.cs
index 1053e1e65bc..06d6e8bda3c 100644
--- a/Assets/Tests/Runtime/Serialization/StructMessagesTests.cs
+++ b/Assets/Tests/Runtime/Serialization/StructMessagesTests.cs
@@ -11,10 +11,20 @@ public struct SomeStructMessage
     [TestFixture]
     public class StructMessagesTests
     {
+        readonly NetworkWriter writer = new NetworkWriter(1300);
+        readonly NetworkReader reader = new NetworkReader();
+
+        [TearDown]
+        public void TearDown()
+        {
+            writer.Reset();
+            reader.Dispose();
+        }
+
         [Test]
         public void SerializeAreAddedWhenEmptyInStruct()
         {
-            var writer = new NetworkWriter();
+            writer.Reset();
 
             const int someValue = 3;
             writer.Write(new SomeStructMessage
@@ -22,15 +32,13 @@ public void SerializeAreAddedWhenEmptyInStruct()
                 someValue = someValue,
             });
 
-            byte[] arr = writer.ToArray();
-
-            var reader = new NetworkReader(arr);
+            reader.Reset(writer.ToArraySegment());
             SomeStructMessage received = reader.Read<SomeStructMessage>();
 
             Assert.AreEqual(someValue, received.someValue);
 
-            int writeLength = writer.Length;
-            int readLength = reader.Position;
+            int writeLength = writer.ByteLength;
+            int readLength = reader.BytePosition;
             Assert.That(writeLength == readLength, $"OnSerializeAll and OnDeserializeAll calls write the same amount of data\n    writeLength={writeLength}\n    readLength={readLength}");
         }
     }
diff --git a/Assets/Tests/Runtime/Serialization/WeaverIgnoreTest.cs b/Assets/Tests/Runtime/Serialization/WeaverIgnoreTest.cs
index dfefe8e9165..09e064222d7 100644
--- a/Assets/Tests/Runtime/Serialization/WeaverIgnoreTest.cs
+++ b/Assets/Tests/Runtime/Serialization/WeaverIgnoreTest.cs
@@ -19,15 +19,17 @@ public void DoesNotUseCustomWriter()
                 first = 10,
                 second = 20,
             };
-            var writer = new NetworkWriter();
+            var writer = new NetworkWriter(1300);
             writer.Write(data);
-            var reader = new NetworkReader(writer.ToArraySegment());
+            var reader = new NetworkReader();
+            reader.Reset(writer.ToArraySegment());
             MyCustomType copy = reader.Read<MyCustomType>();
 
             // should have copied both fields,
             // if it uses custom extension methods it will only write first
             Assert.That(copy.first, Is.EqualTo(data.first));
             Assert.That(copy.second, Is.EqualTo(data.second));
+            reader.Dispose();
         }
 
     }
diff --git a/Assets/Tests/Runtime/SyncVarTest.cs b/Assets/Tests/Runtime/SyncVarTest.cs
index bc162c61b54..30fd0fba00c 100644
--- a/Assets/Tests/Runtime/SyncVarTest.cs
+++ b/Assets/Tests/Runtime/SyncVarTest.cs
@@ -21,6 +21,18 @@ public struct Guild
 
     public class SyncVarTest
     {
+        readonly NetworkWriter ownerWriter = new NetworkWriter(1300);
+        readonly NetworkWriter observersWriter = new NetworkWriter(1300);
+        readonly NetworkReader reader = new NetworkReader();
+
+        [TearDown]
+        public void TearDown()
+        {
+            ownerWriter.Reset();
+            observersWriter.Reset();
+            reader.Dispose();
+        }
+
 
         [Test]
         public void TestSettingStruct()
@@ -122,9 +134,6 @@ public void TestSynchronizingObjects()
             player1.guild = myGuild;
 
             // serialize all the data as we would for the network
-            var ownerWriter = new NetworkWriter();
-            // not really used in this Test
-            var observersWriter = new NetworkWriter();
             identity1.OnSerializeAll(true, ownerWriter, observersWriter);
 
             // set up a "client" object
@@ -133,7 +142,7 @@ public void TestSynchronizingObjects()
             MockPlayer player2 = gameObject2.AddComponent<MockPlayer>();
 
             // apply all the data from the server object
-            var reader = new NetworkReader(ownerWriter.ToArray());
+            reader.Reset(ownerWriter.ToArray());
             identity2.OnDeserializeAll(reader, true);
 
             // check that the syncvars got updated
diff --git a/Assets/Tests/Runtime/SyncVarVirtualTest.cs b/Assets/Tests/Runtime/SyncVarVirtualTest.cs
index 32c1caca027..4bf752544bb 100644
--- a/Assets/Tests/Runtime/SyncVarVirtualTest.cs
+++ b/Assets/Tests/Runtime/SyncVarVirtualTest.cs
@@ -53,6 +53,10 @@ public class SyncVarVirtualTest
         private SyncVarHookTester clientTester;
         private NetworkIdentity netIdClient;
 
+        readonly NetworkWriter ownerWriter = new NetworkWriter(1300);
+        readonly NetworkWriter observersWriter = new NetworkWriter(1300);
+        readonly NetworkReader reader = new NetworkReader();
+
         [SetUp]
         public void Setup()
         {
@@ -74,15 +78,14 @@ public void Setup()
 
         private void SyncValuesWithClient()
         {
-            // serialize all the data as we would for the network
-            var ownerWriter = new NetworkWriter();
-            // not really used in this Test
-            var observersWriter = new NetworkWriter();
+            ownerWriter.Reset();
+            observersWriter.Reset();
 
             netIdServer.OnSerializeAll(true, ownerWriter, observersWriter);
 
             // apply all the data from the server object
-            var reader = new NetworkReader(ownerWriter.ToArray());
+
+            reader.Reset(ownerWriter.ToArraySegment());
             netIdClient.OnDeserializeAll(reader, true);
         }
 
@@ -91,6 +94,10 @@ public void TearDown()
         {
             UnityEngine.Object.DestroyImmediate(serverTester.gameObject);
             UnityEngine.Object.DestroyImmediate(clientTester.gameObject);
+
+            ownerWriter.Reset();
+            observersWriter.Reset();
+            reader.Dispose();
         }
         [Test]
         public void AbstractMethodOnChangeWorkWithHooks()
diff --git a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest.cs b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest.cs
index 07cc585e56c..0012c54b51e 100644
--- a/Assets/Tests/SocketLayer/AckSystem/AckSystemTest.cs
+++ b/Assets/Tests/SocketLayer/AckSystem/AckSystemTest.cs
@@ -20,8 +20,8 @@ public static void SendReliable(this AckSystem ackSystem, byte[] array)
     /// </summary>
     public class AckSystemTestBase
     {
-        protected readonly System.Random rand = new System.Random();
-        protected readonly BufferPool bufferPool = new BufferPool(new Config().MaxPacketSize, 100, 1000);
+        protected readonly Random rand = new Random();
+        protected Pool<ByteBuffer> bufferPool = new Pool<ByteBuffer>(ByteBuffer.CreateNew, 1300, 100, 1000);
 
         protected byte[] createRandomData(int id)
         {
@@ -74,7 +74,7 @@ class SubIRawConnection : IRawConnection
         public void SendRaw(byte[] packet, int length)
         {
             byte[] clone = new byte[length];
-            System.Buffer.BlockCopy(packet, 0, clone, 0, length);
+            Buffer.BlockCopy(packet, 0, clone, 0, length);
             packets.Add(clone);
         }
     }
diff --git a/Assets/Tests/SocketLayer/BufferPoolTest.cs b/Assets/Tests/SocketLayer/BufferPoolTest.cs
index fec42d600b1..5c0b7128ec6 100644
--- a/Assets/Tests/SocketLayer/BufferPoolTest.cs
+++ b/Assets/Tests/SocketLayer/BufferPoolTest.cs
@@ -1,14 +1,190 @@
-using NUnit.Framework;
+using System;
+using NSubstitute;
+using NUnit.Framework;
+using UnityEngine.TestTools;
 
 namespace Mirage.SocketLayer.Tests
 {
     [Category("SocketLayer")]
-    public class BufferPoolTest
+    public class PoolTest
     {
-        [Test] public void CreateBuffersOfCorrectSize() { Assert.Ignore("not implemented"); }
-        [Test] public void TakeReturnsANewBufferEachCall() { Assert.Ignore("not implemented"); }
-        [Test] public void PutThenTakeReturnsSameBuffer() { Assert.Ignore("not implemented"); }
-        [Test] public void TakingMoreBuffersThanMaxLogsWarning() { Assert.Ignore("not implemented"); }
-        [Test] public void PutingMoreBuffersThanMaxLogsWarning() { Assert.Ignore("not implemented"); }
+        [Test]
+        public void ThrowsIfStartIsLessThanMax()
+        {
+            ArgumentException exception = Assert.Throws<ArgumentException>(() => new Pool<TestBuffer>(TestBuffer.Create, 0, 10, 5));
+            Assert.That(exception, Has.Message.EqualTo(new ArgumentException("Start size must be less than max size", "startPoolSize").Message));
+        }
+
+        [Test]
+        public void ThrowsIfCreateIsNull()
+        {
+            ArgumentNullException exception = Assert.Throws<ArgumentNullException>(() => new Pool<TestBuffer>(null, 0, 10, 100));
+            Assert.That(exception, Has.Message.EqualTo(new ArgumentNullException("createNew").Message));
+        }
+
+        [Test]
+        public void CallsCreateStartCountTimesWithCorrectArgs()
+        {
+            Func<int, Pool<TestBuffer>, TestBuffer> create = Substitute.For<Func<int, Pool<TestBuffer>, TestBuffer>>();
+
+            const int startCount = 5;
+            const int bufferSize = 100;
+            var pool = new Pool<TestBuffer>(create, bufferSize, startCount, 100);
+
+            create.Received(startCount).Invoke(bufferSize, pool);
+        }
+
+        [Test]
+        public void TakeDoesntCreateTillEmpty()
+        {
+            Func<int, Pool<TestBuffer>, TestBuffer> create = Substitute.For<Func<int, Pool<TestBuffer>, TestBuffer>>();
+            create.Invoke(default, default).Returns((args) => TestBuffer.Create((int)args[0], (Pool<TestBuffer>)args[0]));
+
+            const int startCount = 5;
+            const int bufferSize = 100;
+            var pool = new Pool<TestBuffer>(create, bufferSize, startCount, 100);
+
+            for (int i = 0; i < startCount; i++)
+            {
+                _ = pool.Take();
+            }
+
+            create.ClearReceivedCalls();
+
+            const int extraCreates = 2;
+            for (int i = 0; i < extraCreates; i++)
+            {
+                _ = pool.Take();
+            }
+            create.Received(extraCreates).Invoke(bufferSize, pool);
+        }
+
+        [Test]
+        public void CanTakeMoreAfterPuttingSomeBackWithoutCreatingNew()
+        {
+            Func<int, Pool<TestBuffer>, TestBuffer> create = Substitute.For<Func<int, Pool<TestBuffer>, TestBuffer>>();
+            create.Invoke(default, default).Returns((args) => TestBuffer.Create((int)args[0], (Pool<TestBuffer>)args[1]));
+
+            const int startCount = 5;
+            const int bufferSize = 100;
+            var pool = new Pool<TestBuffer>(create, bufferSize, startCount, 100);
+
+            const int takeCount = 8;
+
+            var temp = new TestBuffer[takeCount];
+            var temp2 = new TestBuffer[takeCount];
+            for (int i = 0; i < takeCount; i++)
+            {
+                temp[i] = pool.Take();
+            }
+
+            create.ClearReceivedCalls();
+
+            for (int i = 0; i < takeCount; i++)
+            {
+                pool.Put(temp[i]);
+            }
+
+
+            for (int i = 0; i < takeCount; i++)
+            {
+                temp2[i] = pool.Take();
+            }
+
+            create.DidNotReceiveWithAnyArgs().Invoke(default, default);
+
+            // check instances are the same
+            Assert.That(temp, Is.EquivalentTo(temp2));
+        }
+
+        [Test]
+        public void EachTakeIsANewInstance()
+        {
+            const int startCount = 5;
+            const int bufferSize = 100;
+            var pool = new Pool<TestBuffer>(TestBuffer.Create, bufferSize, startCount, 100);
+
+            const int takeCount = 8;
+
+            var temp = new TestBuffer[takeCount];
+            for (int i = 0; i < takeCount; i++)
+            {
+                temp[i] = pool.Take();
+            }
+
+            // check instances are the different
+            Assert.That(temp, Is.Unique);
+        }
+
+        [Test]
+        public void TakingMoreBuffersThanMaxLogsWarning()
+        {
+            const int maxCount = 5;
+            const int bufferSize = 100;
+            var pool = new Pool<TestBuffer>(TestBuffer.Create, bufferSize, 0, maxCount);
+
+            var temp = new TestBuffer[maxCount + 1];
+            for (int i = 0; i < maxCount; i++)
+            {
+                temp[i] = pool.Take();
+            }
+
+            LogAssert.NoUnexpectedReceived();
+
+            LogAssert.Expect(UnityEngine.LogType.Warning, $"Buffer Max Size reached, created:{maxCount + 1} max:{maxCount}");
+            temp[maxCount] = pool.Take();
+            LogAssert.NoUnexpectedReceived();
+
+            Assert.That(temp, Is.Unique);
+
+        }
+        [Test]
+        public void PutingMoreBuffersThanMaxLogsWarning()
+        {
+            const int maxCount = 5;
+            const int bufferSize = 100;
+            var pool = new Pool<TestBuffer>(TestBuffer.Create, bufferSize, 0, maxCount);
+
+            var temp = new TestBuffer[maxCount + 1];
+            for (int i = 0; i < maxCount + 1; i++)
+            {
+                temp[i] = pool.Take();
+            }
+
+            // have to expect this so that noUnexpected doesn't fail below
+            LogAssert.Expect(UnityEngine.LogType.Warning, $"Buffer Max Size reached, created:{maxCount + 1} max:{maxCount}");
+
+            for (int i = 0; i < maxCount; i++)
+            {
+                pool.Put(temp[i]);
+            }
+
+            LogAssert.NoUnexpectedReceived();
+
+            LogAssert.Expect(UnityEngine.LogType.Warning, $"Cant Put buffer into full pool, leaving for GC");
+            pool.Put(temp[maxCount]);
+
+            LogAssert.NoUnexpectedReceived();
+
+            Assert.That(temp, Is.Unique);
+        }
+
+
+        public class TestBuffer
+        {
+            public readonly int Size;
+            public readonly Pool<TestBuffer> Pool;
+
+            private TestBuffer(int size, Pool<TestBuffer> pool)
+            {
+                Size = size;
+                Pool = pool;
+            }
+
+            public static TestBuffer Create(int size, Pool<TestBuffer> pool)
+            {
+                return new TestBuffer(size, pool);
+            }
+        }
     }
 }

From 783e02f5d43bdfe731196abf61356074663c3fce Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Fri, 2 Jul 2021 20:19:15 +0000
Subject: [PATCH 043/166] chore(release): 98.0.1 [skip ci]

## [98.0.1](https://github.com/MirageNet/Mirage/compare/v98.0.0...v98.0.1) (2021-07-02)

### Performance Improvements

* replacing network writer with a faster version that can do bit packing ([#805](https://github.com/MirageNet/Mirage/issues/805)) ([773c58f](https://github.com/MirageNet/Mirage/commit/773c58f75eb77be2a893398d1e27012ee9ba83e6))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs               | 2 +-
 Assets/Mirage/CHANGELOG.md                                 | 7 +++++++
 Assets/Mirage/Components/AssemblyInfo.cs                   | 2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                      | 2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs          | 2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs                     | 2 +-
 .../Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs      | 2 +-
 Assets/Mirage/package.json                                 | 2 +-
 8 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index 372109992b2..c5f79ffa41f 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("98.0.0")]
+[assembly: AssemblyVersion("98.0.1")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index f1521dd605c..7b78ac11387 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,10 @@
+## [98.0.1](https://github.com/MirageNet/Mirage/compare/v98.0.0...v98.0.1) (2021-07-02)
+
+
+### Performance Improvements
+
+* replacing network writer with a faster version that can do bit packing ([#805](https://github.com/MirageNet/Mirage/issues/805)) ([773c58f](https://github.com/MirageNet/Mirage/commit/773c58f75eb77be2a893398d1e27012ee9ba83e6))
+
 # [98.0.0](https://github.com/MirageNet/Mirage/compare/v97.1.2...v98.0.0) (2021-07-02)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index 18b9c5755cc..e3cd0e383d0 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("98.0.0")]
+[assembly: AssemblyVersion("98.0.1")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index 8675cfa56d8..54a318e4417 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("98.0.0")]
+[assembly: AssemblyVersion("98.0.1")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index 4104b944c1e..717a984eb41 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("98.0.0")]
+[assembly: AssemblyVersion("98.0.1")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index 372109992b2..c5f79ffa41f 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("98.0.0")]
+[assembly: AssemblyVersion("98.0.1")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index 372109992b2..c5f79ffa41f 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("98.0.0")]
+[assembly: AssemblyVersion("98.0.1")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 485973f37e4..2948fe37ee9 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "98.0.0",
+    "version": "98.0.1",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From 3cffa662fee2b09fb54f549d42d820300c61ecda Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Sat, 3 Jul 2021 13:38:07 +0100
Subject: [PATCH 044/166] perf: replacing network writer with a faster version
 that can do bit packing (#805)

(empty commit for CI)

BREAKING CHANGE: NetworkWriter and NetworkReader have been completely re-written to support bitpacking

From 7da93839bcfcd52d6f7b8c7d4e4223fc91a9b58f Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Sat, 3 Jul 2021 14:58:32 +0100
Subject: [PATCH 045/166] refactor: fixing sonar bugs

---
 Assets/Mirage/Runtime/SocketLayer/AckSystem.cs | 16 ++++++++++++++--
 Assets/Tests/SocketLayer/PeerTest.cs           |  8 ++++----
 2 files changed, 18 insertions(+), 6 deletions(-)

diff --git a/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs b/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
index 14d1fffe73a..0f0f9a8557b 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
@@ -685,13 +685,15 @@ public bool Equals(AckablePacket other)
                     reliablePacket == other.reliablePacket;
             }
         }
+
         class ReliablePacket
         {
-            public List<ushort> sequences = new List<ushort>();
             public ushort lastSequence;
             public bool acked;
-            public readonly ByteBuffer buffer;
             public int length;
+
+            public readonly List<ushort> sequences = new List<ushort>();
+            public readonly ByteBuffer buffer;
             public readonly ushort order;
 
             public void OnSend(ushort sequence)
@@ -717,6 +719,16 @@ public override int GetHashCode()
             {
                 return order;
             }
+
+            public override bool Equals(object obj)
+            {
+                if (obj is ReliablePacket other)
+                {
+                    // use order as quick check, but use list to check if they are actually equal
+                    return order == other.order && sequences == other.sequences;
+                }
+                return false;
+            }
         }
         public struct ReliableReceived : IEquatable<ReliableReceived>
         {
diff --git a/Assets/Tests/SocketLayer/PeerTest.cs b/Assets/Tests/SocketLayer/PeerTest.cs
index bc5bdbb748c..17d516907bb 100644
--- a/Assets/Tests/SocketLayer/PeerTest.cs
+++ b/Assets/Tests/SocketLayer/PeerTest.cs
@@ -15,7 +15,7 @@ public void ThrowIfSocketIsNull()
         {
             ArgumentNullException exception = Assert.Throws<ArgumentNullException>(() =>
             {
-                new Peer(null, Substitute.For<IDataHandler>(), new Config(), Substitute.For<ILogger>());
+                _ = new Peer(null, Substitute.For<IDataHandler>(), new Config(), Substitute.For<ILogger>());
             });
             var expected = new ArgumentNullException("socket");
             Assert.That(exception, Has.Message.EqualTo(expected.Message));
@@ -25,7 +25,7 @@ public void ThrowIfDataHandlerIsNull()
         {
             ArgumentNullException exception = Assert.Throws<ArgumentNullException>(() =>
             {
-                new Peer(Substitute.For<ISocket>(), null, new Config(), Substitute.For<ILogger>());
+                _ = new Peer(Substitute.For<ISocket>(), null, new Config(), Substitute.For<ILogger>());
             });
             var expected = new ArgumentNullException("dataHandler");
             Assert.That(exception, Has.Message.EqualTo(expected.Message));
@@ -35,7 +35,7 @@ public void DoesNotThrowIfConfigIsNull()
         {
             Assert.DoesNotThrow(() =>
             {
-                new Peer(Substitute.For<ISocket>(), Substitute.For<IDataHandler>(), null, Substitute.For<ILogger>());
+                _ = new Peer(Substitute.For<ISocket>(), Substitute.For<IDataHandler>(), null, Substitute.For<ILogger>());
             });
         }
         [Test]
@@ -43,7 +43,7 @@ public void DoesNotThrowIfLoggerIsNull()
         {
             Assert.DoesNotThrow(() =>
             {
-                new Peer(Substitute.For<ISocket>(), Substitute.For<IDataHandler>(), new Config(), null);
+                _ = new Peer(Substitute.For<ISocket>(), Substitute.For<IDataHandler>(), new Config(), null);
             });
         }
 

From 0fe8cf0336407a7643317cb3e47af5888b5bcef6 Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Sat, 3 Jul 2021 14:15:27 +0000
Subject: [PATCH 046/166] chore(release): 99.0.0 [skip ci]

# [99.0.0](https://github.com/MirageNet/Mirage/compare/v98.0.1...v99.0.0) (2021-07-03)

### Performance Improvements

* replacing network writer with a faster version that can do bit packing ([#805](https://github.com/MirageNet/Mirage/issues/805)) ([3cffa66](https://github.com/MirageNet/Mirage/commit/3cffa662fee2b09fb54f549d42d820300c61ecda))

### BREAKING CHANGES

* NetworkWriter and NetworkReader have been completely re-written to support bitpacking
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs         |  2 +-
 Assets/Mirage/CHANGELOG.md                           | 12 ++++++++++++
 Assets/Mirage/Components/AssemblyInfo.cs             |  2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                |  2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs    |  2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs               |  2 +-
 .../RigidbodyPhysics/Scripts/AssemblyInfo.cs         |  2 +-
 Assets/Mirage/package.json                           |  2 +-
 8 files changed, 19 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index c5f79ffa41f..b08ddab2a02 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("98.0.1")]
+[assembly: AssemblyVersion("99.0.0")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index 7b78ac11387..86047edbbfd 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,15 @@
+# [99.0.0](https://github.com/MirageNet/Mirage/compare/v98.0.1...v99.0.0) (2021-07-03)
+
+
+### Performance Improvements
+
+* replacing network writer with a faster version that can do bit packing ([#805](https://github.com/MirageNet/Mirage/issues/805)) ([3cffa66](https://github.com/MirageNet/Mirage/commit/3cffa662fee2b09fb54f549d42d820300c61ecda))
+
+
+### BREAKING CHANGES
+
+* NetworkWriter and NetworkReader have been completely re-written to support bitpacking
+
 ## [98.0.1](https://github.com/MirageNet/Mirage/compare/v98.0.0...v98.0.1) (2021-07-02)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index e3cd0e383d0..a00710568a0 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("98.0.1")]
+[assembly: AssemblyVersion("99.0.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index 54a318e4417..57d86e46ee1 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("98.0.1")]
+[assembly: AssemblyVersion("99.0.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index 717a984eb41..ee8ecf6088b 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("98.0.1")]
+[assembly: AssemblyVersion("99.0.0")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index c5f79ffa41f..b08ddab2a02 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("98.0.1")]
+[assembly: AssemblyVersion("99.0.0")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index c5f79ffa41f..b08ddab2a02 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("98.0.1")]
+[assembly: AssemblyVersion("99.0.0")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 2948fe37ee9..a0fa67a47c6 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "98.0.1",
+    "version": "99.0.0",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From 5969236f7a0d6e57848e51cb084f824233e367a4 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Sat, 3 Jul 2021 16:19:35 +0100
Subject: [PATCH 047/166] fix: adding assembly version to editor asmdef

---
 .releaserc.yml                            |  1 +
 Assets/Mirage/Editor/AssemblyInfo.cs      |  3 +++
 Assets/Mirage/Editor/AssemblyInfo.cs.meta | 11 +++++++++++
 3 files changed, 15 insertions(+)
 create mode 100644 Assets/Mirage/Editor/AssemblyInfo.cs
 create mode 100644 Assets/Mirage/Editor/AssemblyInfo.cs.meta

diff --git a/.releaserc.yml b/.releaserc.yml
index b62bccf863c..07e0b4a3566 100644
--- a/.releaserc.yml
+++ b/.releaserc.yml
@@ -7,6 +7,7 @@ plugins:
         Assets/Mirage/Authenticators/AssemblyInfo.cs
         Assets/Mirage/Components/AssemblyInfo.cs
         Assets/Mirage/Runtime/AssemblyInfo.cs
+        Assets/Mirage/Editor/AssemblyInfo.cs
         Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
         Assets/Mirage/Samples~/AssemblyInfo.cs
         Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
diff --git a/Assets/Mirage/Editor/AssemblyInfo.cs b/Assets/Mirage/Editor/AssemblyInfo.cs
new file mode 100644
index 00000000000..26c1b65c472
--- /dev/null
+++ b/Assets/Mirage/Editor/AssemblyInfo.cs
@@ -0,0 +1,3 @@
+using System.Reflection;
+
+[assembly: AssemblyVersion("99.0.0")]
diff --git a/Assets/Mirage/Editor/AssemblyInfo.cs.meta b/Assets/Mirage/Editor/AssemblyInfo.cs.meta
new file mode 100644
index 00000000000..ef7ba0050df
--- /dev/null
+++ b/Assets/Mirage/Editor/AssemblyInfo.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: a81b2a9a9ba9b3948a26235d6e127926
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

From 4bc10d840890345f79c24082d283b06302f86b82 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Sat, 3 Jul 2021 16:54:14 +0100
Subject: [PATCH 048/166] perf(WelcomeWindow): using string builder for change
 log

---
 .../Mirage/Editor/WelcomeWindow/WelcomeWindow.cs   | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/Assets/Mirage/Editor/WelcomeWindow/WelcomeWindow.cs b/Assets/Mirage/Editor/WelcomeWindow/WelcomeWindow.cs
index a499427f05a..3e0bac0d288 100644
--- a/Assets/Mirage/Editor/WelcomeWindow/WelcomeWindow.cs
+++ b/Assets/Mirage/Editor/WelcomeWindow/WelcomeWindow.cs
@@ -1,7 +1,7 @@
 using System;
 using System.Collections.Generic;
 using System.IO;
-using System.Reflection;
+using System.Text;
 using Mirage.Logging;
 using UnityEditor;
 using UnityEditor.PackageManager;
@@ -289,6 +289,7 @@ private List<string> ParseChangeLog()
         private void DrawChangeLog(List<string> content)
         {
             Label changeLogText = rootVisualElement.Q<Label>("ChangeLogText");
+            var builder = new StringBuilder();
 
             for (int i = 0; i < content.Count; i++)
             {
@@ -304,18 +305,23 @@ private void DrawChangeLog(List<string> content)
                 else if (item.Contains("###"))
                 {
                     //only add a space above the title if it isn't the first title
-                    if (i > 2) { changeLogText.text += "\n"; }
+                    if (i > 2) { builder.Append("\n"); }
 
-                    changeLogText.text += item.Substring(4) + "\n";
+                    builder.Append(item.Substring(4));
+                    builder.Append("\n");
                 }
                 //if the item is a change
                 else
                 {
                     string change = item.Split(new string[] { "([" }, StringSplitOptions.None)[0];
                     change = change.Replace("*", "-");
-                    changeLogText.text += change + "\n";
+
+                    builder.Append(change);
+                    builder.Append("\n");
                 }
             }
+
+            changeLogText.text = builder.ToString();
         }
 
         #region Packages

From 79374364ba1edcb6cb27b1ff0d2b7982c6510243 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Sat, 3 Jul 2021 16:56:40 +0100
Subject: [PATCH 049/166] style(WelcomeWindow): removing static from fields

---
 Assets/Mirage/Editor/WelcomeWindow/WelcomeWindow.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/Assets/Mirage/Editor/WelcomeWindow/WelcomeWindow.cs b/Assets/Mirage/Editor/WelcomeWindow/WelcomeWindow.cs
index 3e0bac0d288..3a48496af0b 100644
--- a/Assets/Mirage/Editor/WelcomeWindow/WelcomeWindow.cs
+++ b/Assets/Mirage/Editor/WelcomeWindow/WelcomeWindow.cs
@@ -50,9 +50,9 @@ public class WelcomeWindow : EditorWindow
         #endregion
 
         //request for the module install
-        private static AddRequest installRequest;
-        private static RemoveRequest uninstallRequest;
-        private static ListRequest listRequest;
+        private AddRequest installRequest;
+        private RemoveRequest uninstallRequest;
+        private ListRequest listRequest;
 
         private static WelcomeWindow currentWindow;
 

From c608a5b982ceee0b73021bbb4b3d23224a5e0f1a Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Sat, 3 Jul 2021 16:58:52 +0100
Subject: [PATCH 050/166] style(WelcomeWindow): removing error enabled check

checks for error enabled are not needed unless in hotpath
---
 Assets/Mirage/Editor/WelcomeWindow/WelcomeWindow.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Assets/Mirage/Editor/WelcomeWindow/WelcomeWindow.cs b/Assets/Mirage/Editor/WelcomeWindow/WelcomeWindow.cs
index 3a48496af0b..91e1c621ab9 100644
--- a/Assets/Mirage/Editor/WelcomeWindow/WelcomeWindow.cs
+++ b/Assets/Mirage/Editor/WelcomeWindow/WelcomeWindow.cs
@@ -380,7 +380,7 @@ private void InstallPackageProgress()
                 }
                 else if (installRequest.Status == StatusCode.Failure)
                 {
-                    if (logger.ErrorEnabled()) logger.LogError($"Package install was unsuccessful. \n Error Code: {installRequest.Error.errorCode}\n Error Message: {installRequest.Error.message}");
+                    logger.LogError($"Package install was unsuccessful. \n Error Code: {installRequest.Error.errorCode}\n Error Message: {installRequest.Error.message}");
                 }
 
                 EditorApplication.update -= InstallPackageProgress;
@@ -404,7 +404,7 @@ private void UninstallPackageProgress()
                 }
                 else if (uninstallRequest.Status == StatusCode.Failure)
                 {
-                    if (logger.ErrorEnabled()) logger.LogError($"Package uninstall was unsuccessful. \n Error Code: {uninstallRequest.Error.errorCode}\n Error Message: {uninstallRequest.Error.message}");
+                    logger.LogError($"Package uninstall was unsuccessful. \n Error Code: {uninstallRequest.Error.errorCode}\n Error Message: {uninstallRequest.Error.message}");
                 }
 
                 //refresh the package tab

From ba50c268445c596d38d0857d14a7211fb392749b Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Sat, 3 Jul 2021 18:38:03 +0000
Subject: [PATCH 051/166] chore(release): 99.0.1 [skip ci]

## [99.0.1](https://github.com/MirageNet/Mirage/compare/v99.0.0...v99.0.1) (2021-07-03)

### Bug Fixes

* adding assembly version to editor asmdef ([5969236](https://github.com/MirageNet/Mirage/commit/5969236f7a0d6e57848e51cb084f824233e367a4))

### Performance Improvements

* **WelcomeWindow:** using string builder for change log ([4bc10d8](https://github.com/MirageNet/Mirage/commit/4bc10d840890345f79c24082d283b06302f86b82))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs         |  2 +-
 Assets/Mirage/CHANGELOG.md                           | 12 ++++++++++++
 Assets/Mirage/Components/AssemblyInfo.cs             |  2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                |  2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs    |  2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs               |  2 +-
 .../RigidbodyPhysics/Scripts/AssemblyInfo.cs         |  2 +-
 Assets/Mirage/package.json                           |  2 +-
 8 files changed, 19 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index b08ddab2a02..3a67776913c 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("99.0.0")]
+[assembly: AssemblyVersion("99.0.1")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index 86047edbbfd..2a5b0c3fc86 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,15 @@
+## [99.0.1](https://github.com/MirageNet/Mirage/compare/v99.0.0...v99.0.1) (2021-07-03)
+
+
+### Bug Fixes
+
+* adding assembly version to editor asmdef ([5969236](https://github.com/MirageNet/Mirage/commit/5969236f7a0d6e57848e51cb084f824233e367a4))
+
+
+### Performance Improvements
+
+* **WelcomeWindow:** using string builder for change log ([4bc10d8](https://github.com/MirageNet/Mirage/commit/4bc10d840890345f79c24082d283b06302f86b82))
+
 # [99.0.0](https://github.com/MirageNet/Mirage/compare/v98.0.1...v99.0.0) (2021-07-03)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index a00710568a0..b44a1be5de9 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("99.0.0")]
+[assembly: AssemblyVersion("99.0.1")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index 57d86e46ee1..745cc2c6ef3 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("99.0.0")]
+[assembly: AssemblyVersion("99.0.1")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index ee8ecf6088b..38aa8c8deb3 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("99.0.0")]
+[assembly: AssemblyVersion("99.0.1")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index b08ddab2a02..3a67776913c 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("99.0.0")]
+[assembly: AssemblyVersion("99.0.1")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index b08ddab2a02..3a67776913c 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("99.0.0")]
+[assembly: AssemblyVersion("99.0.1")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index a0fa67a47c6..0b9863c7cfb 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "99.0.0",
+    "version": "99.0.1",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From 31aca8e95752628ed3ad0c6d8e415fcce296b817 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Mon, 5 Jul 2021 20:27:25 +0100
Subject: [PATCH 052/166] fix: fixing syncvar reading when using bools

When using bools they will only take 1 bit, so canRead will return true as there are still 8 bits left in the byte.
We need to check if we are able to read 1 whole byte to see if there are more components to read otherwise it will assume there is another component when there isn't
---
 Assets/Mirage/Runtime/NetworkIdentity.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/Assets/Mirage/Runtime/NetworkIdentity.cs b/Assets/Mirage/Runtime/NetworkIdentity.cs
index bb7bde5e058..d6e7d3111a1 100644
--- a/Assets/Mirage/Runtime/NetworkIdentity.cs
+++ b/Assets/Mirage/Runtime/NetworkIdentity.cs
@@ -887,8 +887,11 @@ internal void OnDeserializeAll(NetworkReader reader, bool initialState)
             reader.ObjectLocator = Client != null ? Client.World : null;
             // deserialize all components that were received
             NetworkBehaviour[] components = NetworkBehaviours;
-            while (reader.CanRead())
+            // check if we can read atleast 1 byte
+            while (reader.CanReadBytes(1))
             {
+                // todo replace index with bool for if next component in order has changed or not
+                //      the index below was an alternative to a mask, but now we have bitpacking we can just use a bool for each NB index
                 // read & check index [0..255]
                 byte index = reader.ReadByte();
                 if (index < components.Length)

From 3ac02de537a41b6cab173b9a85e17f0424607083 Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Mon, 5 Jul 2021 19:46:32 +0000
Subject: [PATCH 053/166] chore(release): 99.0.2 [skip ci]

## [99.0.2](https://github.com/MirageNet/Mirage/compare/v99.0.1...v99.0.2) (2021-07-05)

### Bug Fixes

* fixing syncvar reading when using bools ([31aca8e](https://github.com/MirageNet/Mirage/commit/31aca8e95752628ed3ad0c6d8e415fcce296b817))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs               | 2 +-
 Assets/Mirage/CHANGELOG.md                                 | 7 +++++++
 Assets/Mirage/Components/AssemblyInfo.cs                   | 2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                      | 2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs          | 2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs                     | 2 +-
 .../Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs      | 2 +-
 Assets/Mirage/package.json                                 | 2 +-
 8 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index 3a67776913c..c445f592b43 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("99.0.1")]
+[assembly: AssemblyVersion("99.0.2")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index 2a5b0c3fc86..3a366a9726d 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,10 @@
+## [99.0.2](https://github.com/MirageNet/Mirage/compare/v99.0.1...v99.0.2) (2021-07-05)
+
+
+### Bug Fixes
+
+* fixing syncvar reading when using bools ([31aca8e](https://github.com/MirageNet/Mirage/commit/31aca8e95752628ed3ad0c6d8e415fcce296b817))
+
 ## [99.0.1](https://github.com/MirageNet/Mirage/compare/v99.0.0...v99.0.1) (2021-07-03)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index b44a1be5de9..5d9f8171c40 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("99.0.1")]
+[assembly: AssemblyVersion("99.0.2")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index 745cc2c6ef3..04edf5b9228 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("99.0.1")]
+[assembly: AssemblyVersion("99.0.2")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index 38aa8c8deb3..b9a2ef78b61 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("99.0.1")]
+[assembly: AssemblyVersion("99.0.2")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index 3a67776913c..c445f592b43 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("99.0.1")]
+[assembly: AssemblyVersion("99.0.2")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index 3a67776913c..c445f592b43 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("99.0.1")]
+[assembly: AssemblyVersion("99.0.2")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 0b9863c7cfb..fd5b43e3287 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "99.0.1",
+    "version": "99.0.2",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From bfcbaad6b90bb5740d6d00ab7c40324b6dd10ebf Mon Sep 17 00:00:00 2001
From: Pavel Hodoval <pajah14@gmail.com>
Date: Fri, 9 Jul 2021 16:52:15 +0200
Subject: [PATCH 054/166] docs: Update README (#859)

---
 README.md | 32 ++++++++++++++++----------------
 1 file changed, 16 insertions(+), 16 deletions(-)

diff --git a/README.md b/README.md
index d0385f2f63e..98be7313812 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,4 @@
 [![Documentation](https://img.shields.io/badge/documentation-brightgreen.svg)](https://miragenet.github.io/Mirage/)
-[![Forum](https://img.shields.io/badge/forum-brightgreen.svg)](https://forum.unity.com/threads/mirror-networking-for-unity-aka-hlapi-community-edition.425437/)
 [![Discord](https://img.shields.io/discord/809535064551456888.svg)](https://discordapp.com/invite/DTBPBYvexy)
 [![release](https://img.shields.io/github/release/MirageNet/Mirage.svg)](https://github.com/MirageNet/Mirage/releases/latest)
 [![openupm](https://img.shields.io/npm/v/com.miragenet.mirage?label=openupm&registry_uri=https://package.openupm.com)](https://openupm.com/packages/com.miragenet.mirage/)
@@ -42,19 +41,20 @@ To install Mirage, follow these steps:
 ## Comparison with Mirror
 When migrating a project from Mirror to Mirage, these will be the most notable differences.
 
-| Mirage                                      | Mirror                                 |
-| --------------------------------------------- | -------------------------------------- |
-| Install via Unity Package Manager             | Install from Asset Store               |
-| Errors are thrown as exceptions               | Errors are logged                      |
-| `[ServerRpc]`                                 | `[Command]`                            |
-| `[ClientRpc(target=Client.Owner)]`            | `[TargetRpc]`                          |
-| Subscribe to events in `NetworkServer`        | Override methods in `NetworkManager`   |
-| Subscribe to events in `NetworkClient`        | Override methods in `NetworkManager`   |
-| Subscribe to events in `NetworkIdentity`      | Override methods in `NetworkBehaviour` |
-| Methods use PascalCase (C# guidelines)        | No consistency                         |
-| `NetworkTime` available in `NetworkBehaviour` | `NetworkTime` is global static         |
-| Send any data as messages                     | Messages must implement NetworkMessage |
-| Supports Unity 2019.3 or later                | Supports Unity 2018.4 or later         |
+| Mirage                                              | Mirror                                 |
+| --------------------------------------------------- | -------------------------------------- |
+| Install via Unity Package Manager                   | Install from Asset Store               |
+| Errors are thrown as exceptions                     | Errors are logged                      |
+| `[ServerRpc]`                                       | `[Command]`                            |
+| `[ClientRpc(target=Client.Owner)]`                  | `[TargetRpc]`                          |
+| Subscribe to events in `NetworkServer`              | Override methods in `NetworkManager`   |
+| Subscribe to events in `NetworkClient`              | Override methods in `NetworkManager`   |
+| Subscribe to events in `NetworkIdentity`            | Override methods in `NetworkBehaviour` |
+| Methods use PascalCase (C# guidelines)              | No consistency                         |
+| `NetworkTime` available in `NetworkBehaviour`       | `NetworkTime` is global static         |
+| Send any data as messages                           | Messages must implement NetworkMessage |
+| Supports Unity 2019.3 or later                      | Supports Unity 2018.4 or later         |
+| Offers simple Socket API to implement new protocols | Each protocol requires a new transport |
 
 Mirage has many new features
 * Mirage supports [fast domain reload](https://blogs.unity3d.com/2019/11/05/enter-play-mode-faster-in-unity-2019-3/)
@@ -95,10 +95,10 @@ If you want to contribute to  Mirage, follow these steps:
 ## Transport and Sockets
 
 Mirage supports multiple ways of transporting data:
-- c# UDP Socket (default)
+- C# UDP Socket (default)
 - Native UDP socket (coming soon)
 - Websocket, to support webgl clients (coming soon)
-- Steam (coming soon)
+- Steam ([Facepunch Steamworks](https://github.com/MirageNet/SteamyFaceNG))
 
 
 ## Contributing

From 714dd9d32d6eac896744ee5ac4c7c49d0f90839b Mon Sep 17 00:00:00 2001
From: Pavel Hodoval <pajah14@gmail.com>
Date: Wed, 14 Jul 2021 18:50:15 +0200
Subject: [PATCH 055/166] tests: fix HeadlessBenchmark to work with latest
 Mirage (#862)

---
 .../Mirage.HeadlessBenchmark.asmdef           |   4 +-
 .../HeadlessBenchmark/Prefabs/Client.prefab   | 132 ++++++++++++++++
 .../Prefabs/Client.prefab.meta                |   7 +
 .../HeadlessBenchmark/Prefabs/Server.prefab   | 141 ++++++++++++++++++
 .../Prefabs/Server.prefab.meta                |   7 +
 .../HeadlessBenchmark/Scenes/Scene.unity      |  84 ++++++++---
 .../Scripts/HeadlessBenchmark.cs              | 101 ++++++-------
 7 files changed, 392 insertions(+), 84 deletions(-)
 create mode 100644 Assets/Tests/Performance/Runtime/HeadlessBenchmark/Prefabs/Client.prefab
 create mode 100644 Assets/Tests/Performance/Runtime/HeadlessBenchmark/Prefabs/Client.prefab.meta
 create mode 100644 Assets/Tests/Performance/Runtime/HeadlessBenchmark/Prefabs/Server.prefab
 create mode 100644 Assets/Tests/Performance/Runtime/HeadlessBenchmark/Prefabs/Server.prefab.meta

diff --git a/Assets/Tests/Performance/Runtime/HeadlessBenchmark/Mirage.HeadlessBenchmark.asmdef b/Assets/Tests/Performance/Runtime/HeadlessBenchmark/Mirage.HeadlessBenchmark.asmdef
index 964aaa7bea3..bf099cb6342 100644
--- a/Assets/Tests/Performance/Runtime/HeadlessBenchmark/Mirage.HeadlessBenchmark.asmdef
+++ b/Assets/Tests/Performance/Runtime/HeadlessBenchmark/Mirage.HeadlessBenchmark.asmdef
@@ -1,9 +1,11 @@
 {
     "name": "Mirage.HeadlessBenchmark",
+    "rootNamespace": "",
     "references": [
         "GUID:30817c1a0e6d646d99c048fc403f5979",
         "GUID:f51ebe6a0ceec4240a699833d6309b23",
-        "GUID:c0b2064c294eb174c9f3f7da398eb677"
+        "GUID:c0b2064c294eb174c9f3f7da398eb677",
+        "GUID:ae70f15dce7a4fa4b938107926f64504"
     ],
     "includePlatforms": [],
     "excludePlatforms": [],
diff --git a/Assets/Tests/Performance/Runtime/HeadlessBenchmark/Prefabs/Client.prefab b/Assets/Tests/Performance/Runtime/HeadlessBenchmark/Prefabs/Client.prefab
new file mode 100644
index 00000000000..a1d2e0ca2b6
--- /dev/null
+++ b/Assets/Tests/Performance/Runtime/HeadlessBenchmark/Prefabs/Client.prefab
@@ -0,0 +1,132 @@
+%YAML 1.1
+%TAG !u! tag:unity3d.com,2011:
+--- !u!1 &6160076930074172721
+GameObject:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  serializedVersion: 6
+  m_Component:
+  - component: {fileID: 6066037514153597598}
+  - component: {fileID: 8191650661786190473}
+  - component: {fileID: 1534303551643669022}
+  - component: {fileID: 3937582285524225451}
+  - component: {fileID: 9193644276306203286}
+  m_Layer: 0
+  m_Name: Client
+  m_TagString: Untagged
+  m_Icon: {fileID: 0}
+  m_NavMeshLayer: 0
+  m_StaticEditorFlags: 0
+  m_IsActive: 1
+--- !u!4 &6066037514153597598
+Transform:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 6160076930074172721}
+  m_LocalRotation: {x: 0, y: 0, z: 0, w: 1}
+  m_LocalPosition: {x: 0, y: 0, z: 0}
+  m_LocalScale: {x: 1, y: 1, z: 1}
+  m_Children: []
+  m_Father: {fileID: 0}
+  m_RootOrder: 0
+  m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
+--- !u!114 &8191650661786190473
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 6160076930074172721}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: abe6be14204d94224a3e7cd99dd2ea73, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  EnablePeerMetrics: 0
+  SocketFactory: {fileID: 0}
+  authenticator: {fileID: 0}
+  _started:
+    _event:
+      m_PersistentCalls:
+        m_Calls: []
+  _connected:
+    _event:
+      m_PersistentCalls:
+        m_Calls: []
+  _authenticated:
+    _event:
+      m_PersistentCalls:
+        m_Calls: []
+  _disconnected:
+    _event:
+      m_PersistentCalls:
+        m_Calls: []
+--- !u!114 &1534303551643669022
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 6160076930074172721}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: 30967dfd80dbb6c46a270a64ebecb951, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  Client: {fileID: 8191650661786190473}
+  Server: {fileID: 0}
+  DontDestroy: 1
+  _clientChangeScene:
+    m_PersistentCalls:
+      m_Calls: []
+  _clientSceneChanged:
+    m_PersistentCalls:
+      m_Calls: []
+  _serverChangeScene:
+    m_PersistentCalls:
+      m_Calls: []
+  _serverSceneChanged:
+    m_PersistentCalls:
+      m_Calls: []
+--- !u!114 &3937582285524225451
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 6160076930074172721}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: a2cbc85c1c2f1c249bbe95ae110bbcde, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  Client: {fileID: 8191650661786190473}
+  NetworkSceneManager: {fileID: 1534303551643669022}
+  spawnPrefabs:
+  - {fileID: 7062158270370448714, guid: 28d1af38d0173324ea03798dd86eac8f, type: 3}
+--- !u!114 &9193644276306203286
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 6160076930074172721}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: a7aaac73a16c040fd871cb977b5c557b, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  Client: {fileID: 8191650661786190473}
+  Server: {fileID: 0}
+  SceneManager: {fileID: 1534303551643669022}
+  ClientObjectManager: {fileID: 3937582285524225451}
+  ServerObjectManager: {fileID: 0}
+  PlayerPrefab: {fileID: 4169741493956293168, guid: bebeb0dfd33f4074894ef25112ab4a8d, type: 3}
+  AutoSpawn: 1
+  startPositionIndex: 0
+  startPositions: []
+  playerSpawnMethod: 0
diff --git a/Assets/Tests/Performance/Runtime/HeadlessBenchmark/Prefabs/Client.prefab.meta b/Assets/Tests/Performance/Runtime/HeadlessBenchmark/Prefabs/Client.prefab.meta
new file mode 100644
index 00000000000..1c89eb31b5c
--- /dev/null
+++ b/Assets/Tests/Performance/Runtime/HeadlessBenchmark/Prefabs/Client.prefab.meta
@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: 86372601db7eae54b99b28b05c094ded
+PrefabImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Performance/Runtime/HeadlessBenchmark/Prefabs/Server.prefab b/Assets/Tests/Performance/Runtime/HeadlessBenchmark/Prefabs/Server.prefab
new file mode 100644
index 00000000000..c71c128bde0
--- /dev/null
+++ b/Assets/Tests/Performance/Runtime/HeadlessBenchmark/Prefabs/Server.prefab
@@ -0,0 +1,141 @@
+%YAML 1.1
+%TAG !u! tag:unity3d.com,2011:
+--- !u!1 &6837994460994695650
+GameObject:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  serializedVersion: 6
+  m_Component:
+  - component: {fileID: 7779802723684156510}
+  - component: {fileID: 183183950890642064}
+  - component: {fileID: 9000271836354286204}
+  - component: {fileID: -3198233811877010216}
+  - component: {fileID: 2772631192065167875}
+  m_Layer: 0
+  m_Name: Server
+  m_TagString: Untagged
+  m_Icon: {fileID: 0}
+  m_NavMeshLayer: 0
+  m_StaticEditorFlags: 0
+  m_IsActive: 1
+--- !u!4 &7779802723684156510
+Transform:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 6837994460994695650}
+  m_LocalRotation: {x: 0, y: 0, z: 0, w: 1}
+  m_LocalPosition: {x: 0, y: 0, z: 0}
+  m_LocalScale: {x: 1, y: 1, z: 1}
+  m_Children: []
+  m_Father: {fileID: 0}
+  m_RootOrder: 0
+  m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
+--- !u!114 &183183950890642064
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 6837994460994695650}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: a5f5ec068f5604c32b160bc49ee97b75, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  EnablePeerMetrics: 0
+  MaxConnections: 4
+  Listening: 1
+  SocketFactory: {fileID: 0}
+  authenticator: {fileID: 0}
+  _started:
+    _event:
+      m_PersistentCalls:
+        m_Calls: []
+  _connected:
+    m_PersistentCalls:
+      m_Calls: []
+  _authenticated:
+    m_PersistentCalls:
+      m_Calls: []
+  _disconnected:
+    m_PersistentCalls:
+      m_Calls: []
+  _stopped:
+    _event:
+      m_PersistentCalls:
+        m_Calls: []
+  _onStartHost:
+    _event:
+      m_PersistentCalls:
+        m_Calls: []
+  _onStopHost:
+    _event:
+      m_PersistentCalls:
+        m_Calls: []
+--- !u!114 &9000271836354286204
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 6837994460994695650}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: 30967dfd80dbb6c46a270a64ebecb951, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  Client: {fileID: 0}
+  Server: {fileID: 183183950890642064}
+  DontDestroy: 1
+  _clientChangeScene:
+    m_PersistentCalls:
+      m_Calls: []
+  _clientSceneChanged:
+    m_PersistentCalls:
+      m_Calls: []
+  _serverChangeScene:
+    m_PersistentCalls:
+      m_Calls: []
+  _serverSceneChanged:
+    m_PersistentCalls:
+      m_Calls: []
+--- !u!114 &-3198233811877010216
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 6837994460994695650}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: a7aaac73a16c040fd871cb977b5c557b, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  Client: {fileID: 0}
+  Server: {fileID: 183183950890642064}
+  SceneManager: {fileID: 9000271836354286204}
+  ClientObjectManager: {fileID: 0}
+  ServerObjectManager: {fileID: 2772631192065167875}
+  PlayerPrefab: {fileID: 4169741493956293168, guid: bebeb0dfd33f4074894ef25112ab4a8d, type: 3}
+  AutoSpawn: 1
+  startPositionIndex: 0
+  startPositions: []
+  playerSpawnMethod: 0
+--- !u!114 &2772631192065167875
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 6837994460994695650}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: b750203ddb2d9f84abd799a5c2c32cb6, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  Server: {fileID: 183183950890642064}
+  NetworkSceneManager: {fileID: 9000271836354286204}
diff --git a/Assets/Tests/Performance/Runtime/HeadlessBenchmark/Prefabs/Server.prefab.meta b/Assets/Tests/Performance/Runtime/HeadlessBenchmark/Prefabs/Server.prefab.meta
new file mode 100644
index 00000000000..c51702e58c1
--- /dev/null
+++ b/Assets/Tests/Performance/Runtime/HeadlessBenchmark/Prefabs/Server.prefab.meta
@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: 0942fb9374c1d124bb827f594cad43b9
+PrefabImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Performance/Runtime/HeadlessBenchmark/Scenes/Scene.unity b/Assets/Tests/Performance/Runtime/HeadlessBenchmark/Scenes/Scene.unity
index 056633901ac..d5fc4356a48 100644
--- a/Assets/Tests/Performance/Runtime/HeadlessBenchmark/Scenes/Scene.unity
+++ b/Assets/Tests/Performance/Runtime/HeadlessBenchmark/Scenes/Scene.unity
@@ -38,7 +38,7 @@ RenderSettings:
   m_ReflectionIntensity: 1
   m_CustomReflection: {fileID: 0}
   m_Sun: {fileID: 0}
-  m_IndirectSpecularColor: {r: 0, g: 0, b: 0, a: 1}
+  m_IndirectSpecularColor: {r: 0.3731193, g: 0.38073996, b: 0.35872698, a: 1}
   m_UseRadianceAmbientProbe: 0
 --- !u!157 &3
 LightmapSettings:
@@ -228,12 +228,14 @@ MonoBehaviour:
   m_Script: {fileID: 11500000, guid: 5e6d998ffbd3bb34dbaeaba6d44db15b, type: 3}
   m_Name: 
   m_EditorClassIdentifier: 
+  ServerPrefab: {fileID: 6837994460994695650, guid: 0942fb9374c1d124bb827f594cad43b9, type: 3}
+  ClientPrefab: {fileID: 6160076930074172721, guid: 86372601db7eae54b99b28b05c094ded, type: 3}
   server: {fileID: 0}
   serverObjectManager: {fileID: 0}
   MonsterPrefab: {fileID: 6374416922608025457, guid: 28d1af38d0173324ea03798dd86eac8f, type: 3}
   PlayerPrefab: {fileID: 7039704267495960125, guid: bebeb0dfd33f4074894ef25112ab4a8d, type: 3}
-  editorArgs: -transport kcp -server -port 3333 -client 1
-  transport: {fileID: 0}
+  editorArgs: -socket udp -server -port 3333 -client 1
+  socketFactory: {fileID: 0}
 --- !u!4 &2043118187
 Transform:
   m_ObjectHideFlags: 0
@@ -274,48 +276,42 @@ MonoBehaviour:
   m_Name: 
   m_EditorClassIdentifier: 
   Levels:
-  - Name: NetworkBehaviour
-    level: 2
   - Name: HeadlessFrameLimiter
     level: 2
-  - Name: NetworkIdentity
-    level: 2
   - Name: RemoteCallHelper
     level: 2
+  - Name: NetworkBehaviour
+    level: 2
+  - Name: NetworkIdentity
+    level: 2
   - Name: ClientObjectManager
     level: 2
   - Name: NetworkClient
     level: 2
   - Name: NetworkTime
     level: 2
-  - Name: NetworkServer
-    level: 2
-  - Name: PlayerSpawner
-    level: 2
   - Name: NetworkSceneManager
     level: 2
-  - Name: ServerObjectManager
+  - Name: CharacterSpawner
     level: 2
-  - Name: NetworkProximityChecker
-    level: 2
-  - Name: NetworkAnimator
-    level: 2
-  - Name: NetworkSceneChecker
+  - Name: ServerObjectManager
     level: 2
-  - Name: Reward
+  - Name: NetworkServer
     level: 2
   - Name: NetworkBehaviourInspector
     level: 2
-  - Name: NetworkRigidbody
-    level: 2
-  - Name: ZoneHandler
+  - Name: SteamyFaceTransport
     level: 2
-  - Name: AdditiveNetworkManager
+  - Name: WelcomeWindow
     level: 2
   - Name: EnterPlayModeSettingsCheck
     level: 2
   - Name: NetworkScenePostProcess
     level: 2
+  - Name: SteamServer
+    level: 3
+  - Name: SteamCommon
+    level: 3
   - Name: NetworkConnection
     level: 2
   - Name: NetworkWriterPool
@@ -324,15 +320,55 @@ MonoBehaviour:
     level: 2
   - Name: NetworkReaderPool
     level: 2
+  - Name: SteamConnection
+    level: 3
+  - Name: KcpConnection
+    level: 2
+  - Name: NetworkPlayer
+    level: 2
+  - Name: NetworkWorld
+    level: 2
+  - Name: Peer
+    level: 2
+  - Name: PipePeerConnection
+    level: 2
+  - Name: SyncVarReceiver
+    level: 2
+  - Name: PlayerSpawner
+    level: 2
   - Name: BasicAuthenticator
     level: 2
-  - Name: SceneDrawer
+  - Name: NetworkRigidbody
+    level: 2
+  - Name: NetworkProximityChecker
     level: 2
+  - Name: NetworkAnimator
+    level: 2
+  - Name: NetworkSceneChecker
+    level: 2
+  - Name: Reward
+    level: 2
+  - Name: LogFactoryTests
+    level: 2
+  - Name: NetworkManager
+    level: 2
+  - Name: WeaverTests
+    level: 4
   - Name: ChatWindow
     level: 2
+  - Name: AdditiveNetworkManager
+    level: 2
+  - Name: ZoneHandler
+    level: 2
+  - Name: SceneDrawer
+    level: 2
   - Name: NetworkDiscovery
     level: 2
   - Name: NetworkDiscoveryBase`2
     level: 2
-  - Name: KcpConnection
+  - Name: Tests
+    level: 4
+  - Name: SteamSocketManager
+    level: 2
+  - Name: MirageTypesExtensions
     level: 2
diff --git a/Assets/Tests/Performance/Runtime/HeadlessBenchmark/Scripts/HeadlessBenchmark.cs b/Assets/Tests/Performance/Runtime/HeadlessBenchmark/Scripts/HeadlessBenchmark.cs
index 378fb62f089..6a8c54c569a 100644
--- a/Assets/Tests/Performance/Runtime/HeadlessBenchmark/Scripts/HeadlessBenchmark.cs
+++ b/Assets/Tests/Performance/Runtime/HeadlessBenchmark/Scripts/HeadlessBenchmark.cs
@@ -2,15 +2,15 @@
 using System.Collections;
 using Cysharp.Threading.Tasks;
 using Mirage.SocketLayer;
+using Mirage.Sockets.Udp;
 using UnityEngine;
-#if IGNORANCE
-using Mirror.ENet;
-#endif
 
 namespace Mirage.HeadlessBenchmark
 {
     public class HeadlessBenchmark : MonoBehaviour
     {
+        public GameObject ServerPrefab;
+        public GameObject ClientPrefab;
         public NetworkServer server;
         public ServerObjectManager serverObjectManager;
         public GameObject MonsterPrefab;
@@ -64,8 +64,8 @@ void HeadlessStart()
             //Try to find port
             port = GetArgValue("-port");
 
-            //Try to find Transport
-            ParseForTransport();
+            //Try to find Socket
+            ParseForSocket();
 
             //Server mode?
             ParseForServerMode();
@@ -97,32 +97,30 @@ void SpawnMonsters(int i)
 
         void ParseForServerMode()
         {
-            if (!string.IsNullOrEmpty(GetArg("-server")))
-            {
-                var serverGo = new GameObject($"Server", typeof(NetworkServer), typeof(ServerObjectManager), typeof(NetworkSceneManager), typeof(CharacterSpawner));
-
-                server = serverGo.GetComponent<NetworkServer>();
-                server.MaxConnections = 9999;
-                server.SocketFactory = socketFactory;
-                serverObjectManager = serverGo.GetComponent<ServerObjectManager>();
-
-                NetworkSceneManager networkSceneManager = serverGo.GetComponent<NetworkSceneManager>();
-                networkSceneManager.Server = server;
-
-                serverObjectManager.Server = server;
-                serverObjectManager.NetworkSceneManager = networkSceneManager;
-                serverObjectManager.Start();
-
-                CharacterSpawner spawner = serverGo.GetComponent<CharacterSpawner>();
-                spawner.PlayerPrefab = PlayerPrefab.GetComponent<NetworkIdentity>();
-                spawner.ServerObjectManager = serverObjectManager;
-                spawner.Server = server;
-
-                server.Started.AddListener(OnServerStarted);
-                server.Authenticated.AddListener(conn => serverObjectManager.SetClientReady(conn));
-                server.StartServer();
-                Console.WriteLine("Starting Server Only Mode");
-            }
+            if (string.IsNullOrEmpty(GetArg("-server"))) return;
+
+            var serverGo = Instantiate(ServerPrefab);
+            serverGo.name = "Server";
+            server = serverGo.GetComponent<NetworkServer>();
+            server.MaxConnections = 9999;
+            server.SocketFactory = socketFactory;
+            serverObjectManager = serverGo.GetComponent<ServerObjectManager>();
+
+            NetworkSceneManager networkSceneManager = serverGo.GetComponent<NetworkSceneManager>();
+            networkSceneManager.Server = server;
+
+            serverObjectManager.Server = server;
+            serverObjectManager.NetworkSceneManager = networkSceneManager;
+            serverObjectManager.Start();
+
+            CharacterSpawner spawner = serverGo.GetComponent<CharacterSpawner>();
+            spawner.ServerObjectManager = serverObjectManager;
+            spawner.Server = server;
+
+            server.Started.AddListener(OnServerStarted);
+            server.Authenticated.AddListener(conn => serverObjectManager.SetClientReady(conn));
+            server.StartServer();
+            Console.WriteLine("Starting Server Only Mode");
         }
 
         async UniTaskVoid StartClients()
@@ -160,7 +158,8 @@ async UniTaskVoid StartClients()
 
         void StartClient(int i, string networkAddress)
         {
-            var clientGo = new GameObject($"Client {i}", typeof(NetworkClient), typeof(ClientObjectManager), typeof(CharacterSpawner), typeof(NetworkSceneManager));
+            var clientGo = Instantiate(ClientPrefab);
+            clientGo.name = $"Client {i}";
             NetworkClient client = clientGo.GetComponent<NetworkClient>();
             ClientObjectManager objectManager = clientGo.GetComponent<ClientObjectManager>();
             CharacterSpawner spawner = clientGo.GetComponent<CharacterSpawner>();
@@ -208,39 +207,23 @@ void ParseForHelp()
             }
         }
 
-        void ParseForTransport()
+        void ParseForSocket()
         {
-            // todo add socket options here
-
-            //string transport = GetArgValue("-transport");
-            //if (string.IsNullOrEmpty(transport) || transport.Equals("kcp"))
-            //{
-            //    KcpTransport newTransport = gameObject.AddComponent<KcpTransport>();
-            //    socketFactory = newTransport;
-
-            //    //Try to apply port if exists and needed by transport.
-            //    if (!string.IsNullOrEmpty(port))
-            //    {
-            //        newTransport.Port = ushort.Parse(port);
-            //    }
-            //}
-
-#if IGNORANCE
-            if (string.IsNullOrEmpty(transport) || transport.Equals("ignorance"))
+            string socket = GetArgValue("-socket");
+            if (string.IsNullOrEmpty(socket) || socket.Equals("udp"))
             {
-                IgnoranceNG newTransport = networkManager.gameObject.AddComponent<IgnoranceNG>();
+                UdpSocketFactory newSocket = gameObject.AddComponent<UdpSocketFactory>();
+                socketFactory = newSocket;
 
                 //Try to apply port if exists and needed by transport.
-                if (!string.IsNullOrEmpty(port))
-                {
-                    newTransport.Config.CommunicationPort = ushort.Parse(port);
-                }
-                networkManager.server.Transport = newTransport;
-                networkManager.client.Transport = newTransport;
 
-                this.transport = newTransport;
+                //TODO: Uncomment this after the port is made public
+                /*if (!string.IsNullOrEmpty(port))
+                {
+                    newSocket.port = ushort.Parse(port);
+                    newSocket.
+                }*/
             }
-#endif
         }
 
         string GetArgValue(string name)

From 35cf3ecbffbb582bad3022b93b6d5c09ab266f48 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Thu, 15 Jul 2021 12:50:31 +0100
Subject: [PATCH 056/166] feat(NetworkWriter): adding method to move position
 and docs comments (#861)

---
 .../Mirage/Runtime/Serialization/BitMask.cs   |  4 +-
 .../Runtime/Serialization/NetworkReader.cs    | 42 ++++++++-
 .../Runtime/Serialization/NetworkWriter.cs    | 90 ++++++++++++-------
 3 files changed, 97 insertions(+), 39 deletions(-)

diff --git a/Assets/Mirage/Runtime/Serialization/BitMask.cs b/Assets/Mirage/Runtime/Serialization/BitMask.cs
index 599bf1a0a33..a167ccd2eb3 100644
--- a/Assets/Mirage/Runtime/Serialization/BitMask.cs
+++ b/Assets/Mirage/Runtime/Serialization/BitMask.cs
@@ -1,4 +1,4 @@
-/*
+/*
 MIT License
 
 Copyright (c) 2021 James Frowen
@@ -48,7 +48,7 @@ public static ulong Mask(int bits)
 
         /// <summary>
         /// Creates Mask either side of start and end
-        /// <para>Note this mask is only valid for start [0..63] and end [0..64]4</para>
+        /// <para>Note this mask is only valid for start [0..63] and end [0..64]</para>
         /// </summary>
         /// <param name="start"></param>
         /// <param name="end"></param>
diff --git a/Assets/Mirage/Runtime/Serialization/NetworkReader.cs b/Assets/Mirage/Runtime/Serialization/NetworkReader.cs
index 7067b5ca6e5..188865b2662 100644
--- a/Assets/Mirage/Runtime/Serialization/NetworkReader.cs
+++ b/Assets/Mirage/Runtime/Serialization/NetworkReader.cs
@@ -45,28 +45,33 @@ public unsafe class NetworkReader : IDisposable
         int bitPosition;
         int bitLength;
 
+        /// <summary>
+        /// Size of buffer that is being read from
+        /// </summary>
         public int BitLength
         {
             [MethodImpl(MethodImplOptions.AggressiveInlining)]
             get => bitLength;
         }
 
+        /// <summary>
+        /// Current bit position for reading from buffer
+        /// </summary>
         public int BitPosition
         {
             [MethodImpl(MethodImplOptions.AggressiveInlining)]
             get => bitPosition;
         }
-
         /// <summary>
-        /// Position to the nearest byte
+        /// Current <see cref="BitPosition"/> rounded up to nearest multiple of 8
         /// </summary>
         public int BytePosition
         {
+            [MethodImpl(MethodImplOptions.AggressiveInlining)]
             // rounds up to nearest 8
             // add to 3 last bits,
             //   if any are 1 then it will roll over 4th bit.
             //   if all are 0, then nothing happens 
-            [MethodImpl(MethodImplOptions.AggressiveInlining)]
             get => (bitPosition + 0b111) >> 3;
         }
 
@@ -301,6 +306,37 @@ private ulong ReadUnmasked(int bits)
             return result;
         }
 
+        /// <summary>
+        /// Reads n <paramref name="bits"/> from buffer at <paramref name="bitPosition"/>
+        /// </summary>
+        /// <param name="bits">number of bits in value to write</param>
+        /// <param name="bitPosition">where to write bits</param>
+        public ulong ReadAtPosition(int bits, int bitPosition)
+        {
+            // check length here so this methods throws instead of the read below
+            CheckNewLength(bitPosition + bits);
+
+            int currentPosition = this.bitPosition;
+            this.bitPosition = bitPosition;
+            ulong result = Read(bits);
+            this.bitPosition = currentPosition;
+
+            return result;
+        }
+
+
+        /// <summary>
+        /// Moves the internal bit position
+        /// <para>For most usecases it is safer to use <see cref="ReadAtPosition"/></para>
+        /// <para>WARNING: When reading from earlier position make sure to move position back to end of buffer after reading</para>
+        /// </summary>
+        /// <param name="newPosition"></param>
+        public void MoveBitPosition(int newPosition)
+        {
+            CheckNewLength(newPosition);
+            bitPosition = newPosition;
+        }
+
 
         /// <summary>
         /// <para>
diff --git a/Assets/Mirage/Runtime/Serialization/NetworkWriter.cs b/Assets/Mirage/Runtime/Serialization/NetworkWriter.cs
index ef12043563e..e75d412f847 100644
--- a/Assets/Mirage/Runtime/Serialization/NetworkWriter.cs
+++ b/Assets/Mirage/Runtime/Serialization/NetworkWriter.cs
@@ -47,23 +47,34 @@ public unsafe class NetworkWriter
 
         int bitPosition;
 
+        /// <summary>
+        /// Size limit of buffer
+        /// </summary>
         public int ByteCapacity
         {
-            // see ByteLength for comment
             [MethodImpl(MethodImplOptions.AggressiveInlining)]
+            // see ByteLength for comment on math
             get => (bitCapacity + 0b111) >> 3;
         }
 
+        /// <summary>
+        /// Current <see cref="BitPosition"/> rounded up to nearest multiple of 8
+        /// <para>To set byte position use <see cref="MoveBitPosition"/> multiple by 8</para>
+        /// </summary>
         public int ByteLength
         {
+            [MethodImpl(MethodImplOptions.AggressiveInlining)]
             // rounds up to nearest 8
             // add to 3 last bits,
             //   if any are 1 then it will roll over 4th bit.
             //   if all are 0, then nothing happens 
-            [MethodImpl(MethodImplOptions.AggressiveInlining)]
             get => (bitPosition + 0b111) >> 3;
         }
 
+        /// <summary>
+        /// Current bit position for writing to buffer
+        /// <para>To set bit position use <see cref="MoveBitPosition"/></para>
+        /// </summary>
         public int BitPosition
         {
             [MethodImpl(MethodImplOptions.AggressiveInlining)]
@@ -149,7 +160,7 @@ public ArraySegment<byte> ToArraySegment()
 
 
         [MethodImpl(MethodImplOptions.AggressiveInlining)]
-        void CheckNewLength(int newLength)
+        void CheckCapacity(int newLength)
         {
             if (newLength > bitCapacity)
             {
@@ -181,7 +192,7 @@ public void WriteBoolean(bool value)
         public void WriteBoolean(ulong value)
         {
             int newPosition = bitPosition + 1;
-            CheckNewLength(newPosition);
+            CheckCapacity(newPosition);
 
             int bitsInLong = bitPosition & 0b11_1111;
 
@@ -221,7 +232,7 @@ public void WriteBoolean(ulong value)
         public void WriteUInt64(ulong value)
         {
             int newPosition = bitPosition + 64;
-            CheckNewLength(newPosition);
+            CheckCapacity(newPosition);
 
             int bitsInLong = bitPosition & 0b11_1111;
 
@@ -259,7 +270,7 @@ public void Write(ulong value, int bits)
         private void WriterUnmasked(ulong value, int bits)
         {
             int newPosition = bitPosition + bits;
-            CheckNewLength(newPosition);
+            CheckCapacity(newPosition);
 
             int bitsInLong = bitPosition & 0b11_1111;
             int bitsLeft = 64 - bitsInLong;
@@ -281,39 +292,50 @@ private void WriterUnmasked(ulong value, int bits)
             bitPosition = newPosition;
         }
 
+        /// <summary>
+        /// Same as <see cref="WriteAtPosition"/> expect position given is in bytes instead of bits
+        /// <para>WARNING: When writing to bytes instead of bits make sure you are able to read at the right position when deserializing as it might cause data to be misaligned</para>
+        /// </summary>
+        /// <param name="value"></param>
+        /// <param name="bits"></param>
+        /// <param name="bytePosition"></param>
         public void WriteAtBytePosition(ulong value, int bits, int bytePosition)
         {
             WriteAtPosition(value, bits, bytePosition * 8);
         }
+
+        /// <summary>
+        /// Writes n <paramref name="bits"/> from <paramref name="value"/> to <paramref name="bitPosition"/>
+        /// <para>This methods can be used to go back to a previous position to write length or other flags to the buffer after other data has been written</para>
+        /// <para>WARNING: This method does not change the internal position so will not change the overall length if writing past internal position</para>
+        /// </summary>
+        /// <param name="value">value to write</param>
+        /// <param name="bits">number of bits in value to write</param>
+        /// <param name="bitPosition">where to write bits</param>
         public void WriteAtPosition(ulong value, int bits, int bitPosition)
         {
-            // careful with this method, dont set bitPosition
-
-            int newPosition = bitPosition + bits;
-            CheckNewLength(newPosition);
-
-            // mask so we dont overwrite
-            value &= ulong.MaxValue >> (64 - bits);
+            // check length here so this methods throws instead of the write below
+            // this is so that it is more obvious that the position arg for this method is invalid
+            CheckCapacity(bitPosition + bits);
+
+            // moves position to arg, then write, then reset position
+            int currentPosition = this.bitPosition;
+            this.bitPosition = bitPosition;
+            Write(value, bits);
+            this.bitPosition = currentPosition;
+        }
 
-            int bitsInLong = bitPosition & 0b11_1111;
-            int bitsLeft = 64 - bitsInLong;
-            if (bitsLeft >= bits)
-            {
-                ulong* ptr = longPtr + (bitPosition >> 6);
-                *ptr = (
-                    *ptr & (
-                        (ulong.MaxValue >> bitsLeft) | (ulong.MaxValue << (newPosition /*we can use full position here as c# will mask it to just 6 bits*/))
-                    )
-                ) | (value << bitsInLong);
-            }
-            else
-            {
-                ulong* ptr1 = longPtr + (bitPosition >> 6);
-                ulong* ptr2 = ptr1 + 1;
 
-                *ptr1 = (*ptr1 & (ulong.MaxValue >> bitsLeft)) | (value << bitsInLong);
-                *ptr2 = (*ptr2 & (ulong.MaxValue << newPosition)) | (value >> bitsLeft);
-            }
+        /// <summary>
+        /// Moves the internal bit position
+        /// <para>For most usecases it is safer to use <see cref="WriteAtPosition"/></para>
+        /// <para>WARNING: When writing to earlier position make sure to move position back to end of buffer after writing because position is also used as length</para>
+        /// </summary>
+        /// <param name="newPosition"></param>
+        public void MoveBitPosition(int newPosition)
+        {
+            CheckCapacity(newPosition);
+            bitPosition = newPosition;
         }
 
         /// <summary>
@@ -329,7 +351,7 @@ public void WriteAtPosition(ulong value, int bits, int bitPosition)
         {
             PadToByte();
             int newPosition = bitPosition + (8 * byteSize);
-            CheckNewLength(newPosition);
+            CheckCapacity(newPosition);
 
             byte* startPtr = ((byte*)longPtr) + (bitPosition >> 3);
 
@@ -349,7 +371,7 @@ public void WriteBytes(byte[] array, int offset, int length)
         {
             PadToByte();
             int newPosition = bitPosition + (8 * length);
-            CheckNewLength(newPosition);
+            CheckCapacity(newPosition);
 
             // todo benchmark this vs Marshal.Copy or for loop
             Buffer.BlockCopy(array, offset, managedBuffer, ByteLength, length);
@@ -359,7 +381,7 @@ public void WriteBytes(byte[] array, int offset, int length)
         public void CopyFromWriter(NetworkWriter other, int otherBitPosition, int bitLength)
         {
             int newBit = bitPosition + bitLength;
-            CheckNewLength(newBit);
+            CheckCapacity(newBit);
 
             int ulongPos = otherBitPosition >> 6;
             ulong* otherPtr = other.longPtr + ulongPos;

From 056dc48e0173bcd5b35eb589c83c15c2ea57e9d5 Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Thu, 15 Jul 2021 12:05:13 +0000
Subject: [PATCH 057/166] chore(release): 99.1.0 [skip ci]

# [99.1.0](https://github.com/MirageNet/Mirage/compare/v99.0.2...v99.1.0) (2021-07-15)

### Features

* **NetworkWriter:** adding method to move position and docs comments ([#861](https://github.com/MirageNet/Mirage/issues/861)) ([35cf3ec](https://github.com/MirageNet/Mirage/commit/35cf3ecbffbb582bad3022b93b6d5c09ab266f48))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs               | 2 +-
 Assets/Mirage/CHANGELOG.md                                 | 7 +++++++
 Assets/Mirage/Components/AssemblyInfo.cs                   | 2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                      | 2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs          | 2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs                     | 2 +-
 .../Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs      | 2 +-
 Assets/Mirage/package.json                                 | 2 +-
 8 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index c445f592b43..7722c75bf1c 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("99.0.2")]
+[assembly: AssemblyVersion("99.1.0")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index 3a366a9726d..bd5540106c3 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,10 @@
+# [99.1.0](https://github.com/MirageNet/Mirage/compare/v99.0.2...v99.1.0) (2021-07-15)
+
+
+### Features
+
+* **NetworkWriter:** adding method to move position and docs comments ([#861](https://github.com/MirageNet/Mirage/issues/861)) ([35cf3ec](https://github.com/MirageNet/Mirage/commit/35cf3ecbffbb582bad3022b93b6d5c09ab266f48))
+
 ## [99.0.2](https://github.com/MirageNet/Mirage/compare/v99.0.1...v99.0.2) (2021-07-05)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index 5d9f8171c40..86af9aab9da 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("99.0.2")]
+[assembly: AssemblyVersion("99.1.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index 04edf5b9228..a91ea2c805f 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("99.0.2")]
+[assembly: AssemblyVersion("99.1.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index b9a2ef78b61..bac50307977 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("99.0.2")]
+[assembly: AssemblyVersion("99.1.0")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index c445f592b43..7722c75bf1c 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("99.0.2")]
+[assembly: AssemblyVersion("99.1.0")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index c445f592b43..7722c75bf1c 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("99.0.2")]
+[assembly: AssemblyVersion("99.1.0")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index fd5b43e3287..9a179b28a8c 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "99.0.2",
+    "version": "99.1.0",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From b2e9d9693471097ac86fabd725bad8aa6b444983 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Thu, 15 Jul 2021 19:05:33 +0100
Subject: [PATCH 058/166] refactor: moving message handling out of
 networkplayer (#818)

Making NetworkPlayer do less things, Server or client should handle message instead of player.

Makes registering message simpler, no need to wait for player to Connect to register message.

BREAKING CHANGE: RegisterHandler functions now exist on MessageHandler On Server and Client
BREAKING CHANGE: NetworkAuthenticator now use Setup methods that should be used to register messages
---
 .../Authenticators/BasicAuthenticator.cs      |  24 ++-
 .../Authenticators/TimeoutAuthenticator.cs    |  20 ++-
 Assets/Mirage/Runtime/CharacterSpawner.cs     |   9 +-
 Assets/Mirage/Runtime/ClientObjectManager.cs  |  20 +--
 Assets/Mirage/Runtime/INetworkPlayer.cs       |  18 +--
 Assets/Mirage/Runtime/MessageHandler.cs       | 143 ++++++++++++++++++
 Assets/Mirage/Runtime/MessageHandler.cs.meta  |  11 ++
 Assets/Mirage/Runtime/NetworkAuthenticator.cs |  12 ++
 Assets/Mirage/Runtime/NetworkClient.cs        |  28 +++-
 Assets/Mirage/Runtime/NetworkDiagnostics.cs   |   8 +-
 Assets/Mirage/Runtime/NetworkPlayer.cs        | 128 +---------------
 Assets/Mirage/Runtime/NetworkSceneManager.cs  |  28 ++--
 Assets/Mirage/Runtime/NetworkServer.cs        |  47 +++---
 Assets/Mirage/Runtime/ServerObjectManager.cs  |  13 +-
 Assets/Mirage/Runtime/SyncVarReceiver.cs      |  10 +-
 .../Chat/Scripts/ChatNetworkManager.cs        |   8 +-
 .../Processors/ReaderWriterProcessor.cs       |   8 +-
 Assets/Tests/Common/LocalConnections.cs       |   6 +-
 .../Editor/NetworkIdentityCallbackTests.cs    |   8 +-
 .../ClientServer/BasicAuthenticatorTest.cs    |   4 +-
 .../ClientServerComponentTests.cs             |   8 +-
 .../Runtime/ClientServer/ClientServerSetup.cs |  16 +-
 .../ClientServer/NetworkAuthenticatorTest.cs  |   3 +
 .../NetworkClientDisconnectTest.cs            |   2 +-
 .../ClientServer/NetworkSceneManagerTests.cs  |   2 +-
 .../ClientServer/NetworkServerTests.cs        |  26 ++--
 .../ClientServer/ServerObjectManagerTests.cs  |  38 ++---
 Assets/Tests/Runtime/Host/Authenticators.meta |   8 +
 .../AuthenticatorHostModeBase.cs              |  37 +++++
 .../AuthenticatorHostModeBase.cs.meta         |  11 ++
 .../BasicAuthenticatorHostMode.cs             |  15 ++
 .../BasicAuthenticatorHostMode.cs.meta        |  11 ++
 .../Authenticators/NoAuthenticatorHostMode.cs |  12 ++
 .../NoAuthenticatorHostMode.cs.meta           |  11 ++
 .../Runtime/Host/CharacterSpawnerTest.cs      |   4 +-
 Assets/Tests/Runtime/Host/HostSetup.cs        |   3 +
 Assets/Tests/Runtime/Host/LobbyReadyTest.cs   |   2 +-
 .../Runtime/Host/NetworkBehaviourTests.cs     |   2 +-
 .../Tests/Runtime/Host/NetworkClientTest.cs   |   8 +-
 .../Runtime/Host/NetworkSceneManagerTests.cs  |   4 +-
 .../Runtime/Host/ServerObjectManagerTest.cs   |   6 +-
 .../Runtime/NetworkIdentityCallbackTests.cs   |   2 +-
 .../Serialization/MessageHandlerTest.cs       |  98 ++++++++++++
 .../Serialization/MessageHandlerTest.cs.meta  |  11 ++
 .../Serialization/NetworkPlayerTest.cs        |  78 ----------
 45 files changed, 597 insertions(+), 374 deletions(-)
 create mode 100644 Assets/Mirage/Runtime/MessageHandler.cs
 create mode 100644 Assets/Mirage/Runtime/MessageHandler.cs.meta
 create mode 100644 Assets/Tests/Runtime/Host/Authenticators.meta
 create mode 100644 Assets/Tests/Runtime/Host/Authenticators/AuthenticatorHostModeBase.cs
 create mode 100644 Assets/Tests/Runtime/Host/Authenticators/AuthenticatorHostModeBase.cs.meta
 create mode 100644 Assets/Tests/Runtime/Host/Authenticators/BasicAuthenticatorHostMode.cs
 create mode 100644 Assets/Tests/Runtime/Host/Authenticators/BasicAuthenticatorHostMode.cs.meta
 create mode 100644 Assets/Tests/Runtime/Host/Authenticators/NoAuthenticatorHostMode.cs
 create mode 100644 Assets/Tests/Runtime/Host/Authenticators/NoAuthenticatorHostMode.cs.meta
 create mode 100644 Assets/Tests/Runtime/Serialization/MessageHandlerTest.cs
 create mode 100644 Assets/Tests/Runtime/Serialization/MessageHandlerTest.cs.meta

diff --git a/Assets/Mirage/Authenticators/BasicAuthenticator.cs b/Assets/Mirage/Authenticators/BasicAuthenticator.cs
index 6eb9b700d38..483577e0bb2 100644
--- a/Assets/Mirage/Authenticators/BasicAuthenticator.cs
+++ b/Assets/Mirage/Authenticators/BasicAuthenticator.cs
@@ -33,7 +33,7 @@ public class BasicAuthenticator : NetworkAuthenticator
         /// </para>
         /// <para>
         ///     You might want to use an accessToken or passwords. Be aware that the normal connection
-        ///     in mirror is not encrypted so sending secure information directly is not adviced
+        ///     in Mirage is not encrypted so sending secure information directly is not adviced
         /// </para>
         /// </summary>
 
@@ -53,13 +53,17 @@ struct AuthResponseMessage
 
         #region Server Authenticate
 
-        /*
-            This region should is need to validate the client connection and auth messages sent by the client
-         */
+        public override void ServerSetup(NetworkServer server)
+        {
+            // register messsage for Auth when server starts
+            // this will ensure the handlers are ready when client connects (even in host mode)
+
+            server.MessageHandler.RegisterHandler<AuthRequestMessage>(OnAuthRequestMessage);
+        }
+
         public override void ServerAuthenticate(INetworkPlayer player)
         {
             // wait for AuthRequestMessage from client
-            player.RegisterHandler<AuthRequestMessage>(OnAuthRequestMessage);
         }
 
 
@@ -107,10 +111,16 @@ IEnumerator DelayedDisconnect(INetworkPlayer player, float waitTime)
 
         #region Client Authenticate
 
-        public override void ClientAuthenticate(INetworkPlayer player)
+        public override void ClientSetup(NetworkClient client)
         {
-            player.RegisterHandler<AuthResponseMessage>(OnAuthResponseMessage);
+            // register messsage for Auth when client starts
+            // this will ensure the handlers are ready when client connects (even in host mode)
 
+            client.MessageHandler.RegisterHandler<AuthResponseMessage>(OnAuthResponseMessage);
+        }
+
+        public override void ClientAuthenticate(INetworkPlayer player)
+        {
             // The serverCode should be set on the client before connection to the server.
             // When the client connects it sends the code and the server checks that it is correct
             player.Send(new AuthRequestMessage
diff --git a/Assets/Mirage/Authenticators/TimeoutAuthenticator.cs b/Assets/Mirage/Authenticators/TimeoutAuthenticator.cs
index e9bbb2bb901..a74062dbd63 100644
--- a/Assets/Mirage/Authenticators/TimeoutAuthenticator.cs
+++ b/Assets/Mirage/Authenticators/TimeoutAuthenticator.cs
@@ -40,6 +40,14 @@ private void HandleClientAuthenticated(INetworkPlayer player)
             ClientAccept(player);
         }
 
+        public override void ServerAuthenticate(INetworkPlayer player)
+        {
+            pendingAuthentication.Add(player);
+            Authenticator.ServerAuthenticate(player);
+            if (Timeout > 0)
+                StartCoroutine(BeginAuthentication(player, ServerReject));
+        }
+
         public override void ClientAuthenticate(INetworkPlayer player)
         {
             pendingAuthentication.Add(player);
@@ -49,12 +57,14 @@ public override void ClientAuthenticate(INetworkPlayer player)
                 StartCoroutine(BeginAuthentication(player, ClientReject));
         }
 
-        public override void ServerAuthenticate(INetworkPlayer player)
+        public override void ServerSetup(NetworkServer server)
         {
-            pendingAuthentication.Add(player);
-            Authenticator.ServerAuthenticate(player);
-            if (Timeout > 0)
-                StartCoroutine(BeginAuthentication(player, ServerReject));
+            Authenticator.ServerSetup(server);
+        }
+
+        public override void ClientSetup(NetworkClient client)
+        {
+            Authenticator.ClientSetup(client);
         }
 
         IEnumerator BeginAuthentication(INetworkPlayer player, Action<INetworkPlayer> reject)
diff --git a/Assets/Mirage/Runtime/CharacterSpawner.cs b/Assets/Mirage/Runtime/CharacterSpawner.cs
index c3d251404c4..e32c6eec930 100644
--- a/Assets/Mirage/Runtime/CharacterSpawner.cs
+++ b/Assets/Mirage/Runtime/CharacterSpawner.cs
@@ -61,7 +61,7 @@ public virtual void Awake()
             }
             if (Server != null)
             {
-                Server.Authenticated.AddListener(OnServerAuthenticated);
+                Server.Started.AddListener(OnServerStarted);
                 if (ServerObjectManager == null)
                 {
                     throw new InvalidOperationException("Assign a ServerObjectManager");
@@ -78,14 +78,13 @@ void OnDestroy()
             }
             if (Server != null)
             {
-                Server.Authenticated.RemoveListener(OnServerAuthenticated);
+                Server.Started.RemoveListener(OnServerStarted);
             }
         }
 
-        private void OnServerAuthenticated(INetworkPlayer player)
+        private void OnServerStarted()
         {
-            // wait for client to send us an AddPlayerMessage
-            player.RegisterHandler<AddCharacterMessage>(OnServerAddPlayerInternal);
+            Server.MessageHandler.RegisterHandler<AddCharacterMessage>(OnServerAddPlayerInternal);
         }
 
         /// <summary>
diff --git a/Assets/Mirage/Runtime/ClientObjectManager.cs b/Assets/Mirage/Runtime/ClientObjectManager.cs
index 0532320afa2..466b9f8d319 100644
--- a/Assets/Mirage/Runtime/ClientObjectManager.cs
+++ b/Assets/Mirage/Runtime/ClientObjectManager.cs
@@ -90,20 +90,20 @@ void OnClientSceneChanged(string scenePath, SceneOperation sceneOperation)
 
         internal void RegisterHostHandlers()
         {
-            Client.Player.RegisterHandler<ObjectDestroyMessage>(msg => { });
-            Client.Player.RegisterHandler<ObjectHideMessage>(msg => { });
-            Client.Player.RegisterHandler<SpawnMessage>(OnHostClientSpawn);
-            Client.Player.RegisterHandler<ServerRpcReply>(msg => { });
-            Client.Player.RegisterHandler<RpcMessage>(msg => { });
+            Client.MessageHandler.RegisterHandler<ObjectDestroyMessage>(msg => { });
+            Client.MessageHandler.RegisterHandler<ObjectHideMessage>(msg => { });
+            Client.MessageHandler.RegisterHandler<SpawnMessage>(OnHostClientSpawn);
+            Client.MessageHandler.RegisterHandler<ServerRpcReply>(msg => { });
+            Client.MessageHandler.RegisterHandler<RpcMessage>(msg => { });
         }
 
         internal void RegisterMessageHandlers()
         {
-            Client.Player.RegisterHandler<ObjectDestroyMessage>(OnObjectDestroy);
-            Client.Player.RegisterHandler<ObjectHideMessage>(OnObjectHide);
-            Client.Player.RegisterHandler<SpawnMessage>(OnSpawn);
-            Client.Player.RegisterHandler<ServerRpcReply>(OnServerRpcReply);
-            Client.Player.RegisterHandler<RpcMessage>(OnRpcMessage);
+            Client.MessageHandler.RegisterHandler<ObjectDestroyMessage>(OnObjectDestroy);
+            Client.MessageHandler.RegisterHandler<ObjectHideMessage>(OnObjectHide);
+            Client.MessageHandler.RegisterHandler<SpawnMessage>(OnSpawn);
+            Client.MessageHandler.RegisterHandler<ServerRpcReply>(OnServerRpcReply);
+            Client.MessageHandler.RegisterHandler<RpcMessage>(OnRpcMessage);
         }
 
         bool ConsiderForSpawning(NetworkIdentity identity)
diff --git a/Assets/Mirage/Runtime/INetworkPlayer.cs b/Assets/Mirage/Runtime/INetworkPlayer.cs
index f509f2cb972..40b982d7c1a 100644
--- a/Assets/Mirage/Runtime/INetworkPlayer.cs
+++ b/Assets/Mirage/Runtime/INetworkPlayer.cs
@@ -12,26 +12,24 @@ public interface IMessageSender
         void Send(ArraySegment<byte> segment, int channelId = Channel.Reliable);
     }
 
+    // delegates to give names to variables in handles
+    public delegate void MessageDelegate<in T>(T message);
+    public delegate void MessageDelegateWithPlayer<in T>(INetworkPlayer player, T message);
+
     /// <summary>
     /// An object that can receive messages
     /// </summary>
     public interface IMessageReceiver
     {
-        void RegisterHandler<T>(Action<INetworkPlayer, T> handler);
+        void RegisterHandler<T>(MessageDelegateWithPlayer<T> handler);
 
-        void RegisterHandler<T>(Action<T> handler);
+        void RegisterHandler<T>(MessageDelegate<T> handler);
 
         void UnregisterHandler<T>();
 
         void ClearHandlers();
-    }
 
-    /// <summary>
-    /// An object that can send and receive messages and notify messages
-    /// </summary>
-    public interface IMessageHandler : IMessageSender, IMessageReceiver
-    {
-        void HandleMessage(ArraySegment<byte> packet);
+        void HandleMessage(INetworkPlayer player, ArraySegment<byte> packet);
     }
 
     /// <summary>
@@ -60,7 +58,7 @@ public interface IObjectOwner
     /// An object owned by a player that can: send/receive messages, have network visibility, be an object owner, authenticated permissions, and load scenes.
     /// May be from the server to client or from client to server
     /// </summary>
-    public interface INetworkPlayer : IMessageHandler, IVisibilityTracker, IObjectOwner, IAuthenticatedObject, ISceneLoader
+    public interface INetworkPlayer : IMessageSender, IVisibilityTracker, IObjectOwner, IAuthenticatedObject, ISceneLoader
     {
         SocketLayer.IConnection Connection { get; }
         void Disconnect();
diff --git a/Assets/Mirage/Runtime/MessageHandler.cs b/Assets/Mirage/Runtime/MessageHandler.cs
new file mode 100644
index 00000000000..b5b54014424
--- /dev/null
+++ b/Assets/Mirage/Runtime/MessageHandler.cs
@@ -0,0 +1,143 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using Mirage.Logging;
+using Mirage.Serialization;
+using UnityEngine;
+
+namespace Mirage
+{
+    public class MessageHandler : IMessageReceiver
+    {
+        static readonly ILogger logger = LogFactory.GetLogger(typeof(MessageHandler));
+
+        readonly bool disconnectOnException;
+
+        // Handles network messages on client and server
+        internal delegate void NetworkMessageDelegate(INetworkPlayer player, NetworkReader reader);
+
+        // message handlers for this connection
+        internal readonly Dictionary<int, NetworkMessageDelegate> messageHandlers = new Dictionary<int, NetworkMessageDelegate>();
+
+        public MessageHandler(bool disconnectOnException)
+        {
+            this.disconnectOnException = disconnectOnException;
+        }
+
+        private static NetworkMessageDelegate MessageWrapper<T>(MessageDelegateWithPlayer<T> handler)
+        {
+            void AdapterFunction(INetworkPlayer player, NetworkReader reader)
+            {
+                T message = NetworkDiagnostics.ReadWithDiagnostics<T>(reader);
+
+                handler.Invoke(player, message);
+            }
+            return AdapterFunction;
+        }
+
+        /// <summary>
+        /// Register a handler for a particular message type.
+        /// <para>There are several system message types which you can add handlers for. You can also add your own message types.</para>
+        /// </summary>
+        /// <typeparam name="T">Message type</typeparam>
+        /// <param name="handler">Function handler which will be invoked for when this message type is received.</param>
+        /// <param name="requireAuthentication">True if the message requires an authenticated connection</param>
+        public void RegisterHandler<T>(MessageDelegateWithPlayer<T> handler)
+        {
+            int msgType = MessagePacker.GetId<T>();
+            if (logger.filterLogType == LogType.Log && messageHandlers.ContainsKey(msgType))
+            {
+                logger.Log("RegisterHandler replacing " + msgType);
+            }
+            messageHandlers[msgType] = MessageWrapper(handler);
+        }
+
+        /// <summary>
+        /// Register a handler for a particular message type.
+        /// <para>There are several system message types which you can add handlers for. You can also add your own message types.</para>
+        /// </summary>
+        /// <typeparam name="T">Message type</typeparam>
+        /// <param name="handler">Function handler which will be invoked for when this message type is received.</param>
+        /// <param name="requireAuthentication">True if the message requires an authenticated connection</param>
+        public void RegisterHandler<T>(MessageDelegate<T> handler)
+        {
+            RegisterHandler<T>((_, value) => { handler(value); });
+        }
+
+        /// <summary>
+        /// Unregister a handler for a particular message type.
+        /// <para>Note: Messages dont need to be unregister when server or client stops as MessageHandler will be re-created next time server or client starts</para>
+        /// </summary>
+        /// <typeparam name="T">Message type</typeparam>
+        public void UnregisterHandler<T>()
+        {
+            int msgType = MessagePacker.GetId<T>();
+            messageHandlers.Remove(msgType);
+        }
+
+        /// <summary>
+        /// Clear all registered callback handlers.
+        /// </summary>
+        public void ClearHandlers()
+        {
+            messageHandlers.Clear();
+        }
+
+
+        internal void InvokeHandler(INetworkPlayer player, int msgType, NetworkReader reader)
+        {
+            if (messageHandlers.TryGetValue(msgType, out NetworkMessageDelegate msgDelegate))
+            {
+                msgDelegate.Invoke(player, reader);
+            }
+            else
+            {
+                try
+                {
+                    Type type = MessagePacker.GetMessageType(msgType);
+                    throw new InvalidDataException($"Unexpected message {type} received in {this}. Did you register a handler for it?");
+                }
+                catch (KeyNotFoundException)
+                {
+                    throw new InvalidDataException($"Unexpected message ID {msgType} received in {this}. May be due to no existing RegisterHandler for this message.");
+                }
+            }
+        }
+
+        public void HandleMessage(INetworkPlayer player, ArraySegment<byte> packet)
+        {
+            using (PooledNetworkReader networkReader = NetworkReaderPool.GetReader(packet))
+            {
+                // protect against attackers trying to send invalid data packets
+                // exception could be throw if:
+                // - invalid headers
+                // - invalid message ids
+                // - invalid data causing exceptions
+                // - negative ReadBytesAndSize prefixes
+                // - invalid utf8 strings
+                // - etc.
+                //
+                // if exception is caught, disconnect the attacker to stop any further attacks
+
+                try
+                {
+                    int msgType = MessagePacker.UnpackId(networkReader);
+                    InvokeHandler(player, msgType, networkReader);
+                }
+                catch (InvalidDataException ex)
+                {
+                    logger.Log(ex.ToString());
+                }
+                catch (Exception e)
+                {
+                    string disconnectMessage = disconnectOnException ? ", Closed connection: {this}" : "";
+                    logger.LogError($"{e.GetType()} in Message handler (see stack below){disconnectMessage}\n{e}");
+                    if (disconnectOnException)
+                    {
+                        player.Disconnect();
+                    }
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Mirage/Runtime/MessageHandler.cs.meta b/Assets/Mirage/Runtime/MessageHandler.cs.meta
new file mode 100644
index 00000000000..04ebf865fda
--- /dev/null
+++ b/Assets/Mirage/Runtime/MessageHandler.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: a9b600aef1886a64c82a2263b230f007
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Runtime/NetworkAuthenticator.cs b/Assets/Mirage/Runtime/NetworkAuthenticator.cs
index 8c16ab3874b..f6290fa8249 100644
--- a/Assets/Mirage/Runtime/NetworkAuthenticator.cs
+++ b/Assets/Mirage/Runtime/NetworkAuthenticator.cs
@@ -39,6 +39,12 @@ protected void ServerReject(INetworkPlayer player)
             player.Disconnect();
         }
 
+        /// <summary>
+        /// Used to set up authenticator on server
+        /// <para>Can be used to register message handlers before any players connect</para>
+        /// </summary>
+        public abstract void ServerSetup(NetworkServer server);
+
         /// <summary>
         /// Authenticate the player on the Server.
         /// <para>Called by the server when new client connects</para>
@@ -67,6 +73,12 @@ protected void ClientReject(INetworkPlayer player)
             player.Disconnect();
         }
 
+        /// <summary>
+        /// Used to set up authenticator on client
+        /// <para>Can be used to register message handlers before any player connects</para>
+        /// </summary>
+        public abstract void ClientSetup(NetworkClient client);
+
         /// <summary>
         /// Authenticate the player on the Client.
         /// <para>Called by the client after connected to the server</para>
diff --git a/Assets/Mirage/Runtime/NetworkClient.cs b/Assets/Mirage/Runtime/NetworkClient.cs
index 432fe9dd766..236a631639b 100644
--- a/Assets/Mirage/Runtime/NetworkClient.cs
+++ b/Assets/Mirage/Runtime/NetworkClient.cs
@@ -1,5 +1,4 @@
 using System;
-using System.Net;
 using Mirage.Events;
 using Mirage.Logging;
 using Mirage.Serialization;
@@ -37,6 +36,8 @@ public class NetworkClient : MonoBehaviour, INetworkClient
         [Tooltip("Creates Socket for Peer to use")]
         public SocketFactory SocketFactory;
 
+        public bool DisconnectOnException = true;
+
         Peer peer;
 
         [Tooltip("Authentication component attached to this object")]
@@ -92,6 +93,8 @@ public class NetworkClient : MonoBehaviour, INetworkClient
         public NetworkTime Time { get; } = new NetworkTime();
 
         public NetworkWorld World { get; private set; }
+        public MessageHandler MessageHandler { get; private set; }
+
 
         /// <summary>
         /// NetworkClient can connect to local server in host mode too
@@ -111,13 +114,13 @@ public void Connect(string address = null, ushort? port = null)
             connectState = ConnectState.Connecting;
 
             World = new NetworkWorld();
-            InitializeAuthEvents();
 
             IEndPoint endPoint = SocketFactory.GetConnectEndPoint(address, port);
             if (logger.LogEnabled()) logger.Log($"Client connecting to endpoint: {endPoint}");
 
             ISocket socket = SocketFactory.CreateClientSocket();
-            var dataHandler = new DataHandler();
+            MessageHandler = new MessageHandler(DisconnectOnException);
+            var dataHandler = new DataHandler(MessageHandler);
             Metrics = EnablePeerMetrics ? new Metrics() : null;
 
             Config config = PeerConfig ?? new Config();
@@ -137,6 +140,7 @@ public void Connect(string address = null, ushort? port = null)
             Time.Reset();
 
             RegisterMessageHandlers();
+            InitializeAuthEvents();
             // invoke started event after everything is set up, but before peer has connected
             _started.Invoke();
         }
@@ -190,10 +194,10 @@ internal void ConnectHost(NetworkServer server, IDataHandler serverDataHandler)
             connectState = ConnectState.Connecting;
 
             World = server.World;
-            InitializeAuthEvents();
 
             // create local connection objects and connect them
-            var dataHandler = new DataHandler();
+            MessageHandler = new MessageHandler(DisconnectOnException);
+            var dataHandler = new DataHandler(MessageHandler);
             (IConnection clientConn, IConnection serverConn) = PipePeerConnection.Create(dataHandler, serverDataHandler, OnHostDisconnected, null);
 
             // set up client before connecting to server, server could invoke handlers
@@ -201,6 +205,7 @@ internal void ConnectHost(NetworkServer server, IDataHandler serverDataHandler)
             Player = new NetworkPlayer(clientConn);
             dataHandler.SetConnection(clientConn, Player);
             RegisterHostHandlers();
+            InitializeAuthEvents();
             // invoke started event after everything is set up, but before peer has connected
             _started.Invoke();
 
@@ -219,6 +224,7 @@ void InitializeAuthEvents()
             if (authenticator != null)
             {
                 authenticator.OnClientAuthenticated += OnAuthenticated;
+                authenticator.ClientSetup(this);
 
                 Connected.AddListener(authenticator.ClientAuthenticate);
             }
@@ -283,12 +289,12 @@ internal void Update()
 
         internal void RegisterHostHandlers()
         {
-            Player.RegisterHandler<NetworkPongMessage>(msg => { });
+            MessageHandler.RegisterHandler<NetworkPongMessage>(msg => { });
         }
 
         internal void RegisterMessageHandlers()
         {
-            Player.RegisterHandler<NetworkPongMessage>(Time.OnClientPong);
+            MessageHandler.RegisterHandler<NetworkPongMessage>(Time.OnClientPong);
         }
 
 
@@ -336,6 +342,12 @@ internal class DataHandler : IDataHandler
         {
             IConnection connection;
             INetworkPlayer player;
+            readonly IMessageReceiver messageHandler;
+
+            public DataHandler(IMessageReceiver messageHandler)
+            {
+                this.messageHandler = messageHandler;
+            }
 
             public void SetConnection(IConnection connection, INetworkPlayer player)
             {
@@ -346,7 +358,7 @@ public void SetConnection(IConnection connection, INetworkPlayer player)
             public void ReceiveMessage(IConnection connection, ArraySegment<byte> message)
             {
                 logger.Assert(this.connection == connection);
-                player.HandleMessage(message);
+                messageHandler.HandleMessage(player, message);
             }
         }
     }
diff --git a/Assets/Mirage/Runtime/NetworkDiagnostics.cs b/Assets/Mirage/Runtime/NetworkDiagnostics.cs
index 5f6b424fad6..1101733a53e 100644
--- a/Assets/Mirage/Runtime/NetworkDiagnostics.cs
+++ b/Assets/Mirage/Runtime/NetworkDiagnostics.cs
@@ -74,6 +74,12 @@ internal static void OnReceive<T>(T message, int bytes)
 
         #endregion
 
+        /// <summary>
+        /// Calls <see cref="Reader{T}.Read"/> and measures number of bytes read
+        /// </summary>
+        /// <typeparam name="T"></typeparam>
+        /// <param name="reader"></param>
+        /// <returns></returns>
         internal static T ReadWithDiagnostics<T>(NetworkReader reader)
         {
             var message = default(T);
@@ -87,7 +93,7 @@ internal static T ReadWithDiagnostics<T>(NetworkReader reader)
             finally
             {
                 int endPos = reader.BitPosition;
-                int byteLength = (endPos - startPos) >> 3;
+                int byteLength = (endPos - startPos) / 8;
                 NetworkDiagnostics.OnReceive(message, byteLength);
             }
 
diff --git a/Assets/Mirage/Runtime/NetworkPlayer.cs b/Assets/Mirage/Runtime/NetworkPlayer.cs
index 4879e0f5e7d..17a998e5480 100644
--- a/Assets/Mirage/Runtime/NetworkPlayer.cs
+++ b/Assets/Mirage/Runtime/NetworkPlayer.cs
@@ -1,6 +1,5 @@
 using System;
 using System.Collections.Generic;
-using System.IO;
 using Mirage.Logging;
 using Mirage.Serialization;
 using Mirage.SocketLayer;
@@ -19,19 +18,12 @@ namespace Mirage
     /// <para>NetworkConnection objects also act as observers for networked objects. When a connection is an observer of a networked object with a NetworkIdentity, then the object will be visible to corresponding client for the connection, and incremental state changes will be sent to the client.</para>
     /// <para>There are many virtual functions on NetworkConnection that allow its behaviour to be customized. NetworkClient and NetworkServer can both be made to instantiate custom classes derived from NetworkConnection by setting their networkConnectionClass member variable.</para>
     /// </remarks>
-    public sealed class NetworkPlayer : INetworkPlayer
+    public sealed class NetworkPlayer : INetworkPlayer, IMessageSender
     {
         static readonly ILogger logger = LogFactory.GetLogger(typeof(NetworkPlayer));
 
-        // Handles network messages on client and server
-        internal delegate void NetworkMessageDelegate(INetworkPlayer player, NetworkReader reader);
-
-        // internal so it can be tested
         private readonly HashSet<NetworkIdentity> visList = new HashSet<NetworkIdentity>();
 
-        // message handlers for this connection
-        internal readonly Dictionary<int, NetworkMessageDelegate> messageHandlers = new Dictionary<int, NetworkMessageDelegate>();
-
         /// <summary>
         /// Transport level connection
         /// </summary>
@@ -40,7 +32,7 @@ public sealed class NetworkPlayer : INetworkPlayer
         /// <para>Transport layers connections begin at one. So on a client with a single connection to a server, the connectionId of that connection will be one. In NetworkServer, the connectionId of the local connection is zero.</para>
         /// <para>Clients do not know their connectionId on the server, and do not know the connectionId of other clients on the server.</para>
         /// </remarks>
-        private readonly SocketLayer.IConnection connection;
+        private readonly IConnection connection;
 
         /// <summary>
         /// Has this player been marked as disconnected
@@ -72,7 +64,7 @@ public sealed class NetworkPlayer : INetworkPlayer
         /// </summary>
         public IEndPoint Address => connection.EndPoint;
 
-        public SocketLayer.IConnection Connection => connection;
+        public IConnection Connection => connection;
 
         /// <summary>
         /// Disconnects the player.
@@ -114,71 +106,13 @@ public void MarkAsDisconnected()
         /// Creates a new NetworkConnection with the specified address and connectionId
         /// </summary>
         /// <param name="networkConnectionId"></param>
-        public NetworkPlayer(SocketLayer.IConnection connection)
+        public NetworkPlayer(IConnection connection)
         {
             Assert.IsNotNull(connection);
             this.connection = connection;
         }
 
 
-        private static NetworkMessageDelegate MessageHandler<T>(Action<INetworkPlayer, T> handler)
-        {
-            void AdapterFunction(INetworkPlayer player, NetworkReader reader)
-            {
-                T message = NetworkDiagnostics.ReadWithDiagnostics<T>(reader);
-
-                handler.Invoke(player, message);
-            }
-            return AdapterFunction;
-        }
-
-        /// <summary>
-        /// Register a handler for a particular message type.
-        /// <para>There are several system message types which you can add handlers for. You can also add your own message types.</para>
-        /// </summary>
-        /// <typeparam name="T">Message type</typeparam>
-        /// <param name="handler">Function handler which will be invoked for when this message type is received.</param>
-        /// <param name="requireAuthentication">True if the message requires an authenticated connection</param>
-        public void RegisterHandler<T>(Action<INetworkPlayer, T> handler)
-        {
-            int msgType = MessagePacker.GetId<T>();
-            if (logger.filterLogType == LogType.Log && messageHandlers.ContainsKey(msgType))
-            {
-                logger.Log("NetworkServer.RegisterHandler replacing " + msgType);
-            }
-            messageHandlers[msgType] = MessageHandler(handler);
-        }
-
-        /// <summary>
-        /// Register a handler for a particular message type.
-        /// <para>There are several system message types which you can add handlers for. You can also add your own message types.</para>
-        /// </summary>
-        /// <typeparam name="T">Message type</typeparam>
-        /// <param name="handler">Function handler which will be invoked for when this message type is received.</param>
-        /// <param name="requireAuthentication">True if the message requires an authenticated connection</param>
-        public void RegisterHandler<T>(Action<T> handler)
-        {
-            RegisterHandler<T>((_, value) => { handler(value); });
-        }
-
-        /// <summary>
-        /// Unregisters a handler for a particular message type.
-        /// </summary>
-        /// <typeparam name="T">Message type</typeparam>
-        public void UnregisterHandler<T>()
-        {
-            int msgType = MessagePacker.GetId<T>();
-            messageHandlers.Remove(msgType);
-        }
-
-        /// <summary>
-        /// Clear all registered callback handlers.
-        /// </summary>
-        public void ClearHandlers()
-        {
-            messageHandlers.Clear();
-        }
-
         /// <summary>
         /// This sends a network message to the connection.
         /// </summary>
@@ -220,7 +154,6 @@ public void Send(ArraySegment<byte> segment, int channelId = Channel.Reliable)
             }
         }
 
-
         public override string ToString()
         {
             return $"connection({Address})";
@@ -245,59 +178,6 @@ public void RemoveObservers()
             visList.Clear();
         }
 
-        internal void InvokeHandler(int msgType, NetworkReader reader)
-        {
-            if (messageHandlers.TryGetValue(msgType, out NetworkMessageDelegate msgDelegate))
-            {
-                msgDelegate.Invoke(this, reader);
-            }
-            else
-            {
-                try
-                {
-                    Type type = MessagePacker.GetMessageType(msgType);
-                    throw new InvalidDataException($"Unexpected message {type} received in {this}. Did you register a handler for it?");
-                }
-                catch (KeyNotFoundException)
-                {
-                    throw new InvalidDataException($"Unexpected message ID {msgType} received in {this}. May be due to no existing RegisterHandler for this message.");
-                }
-            }
-        }
-
-        void IMessageHandler.HandleMessage(ArraySegment<byte> packet)
-        {
-            // unpack message
-            using (PooledNetworkReader networkReader = NetworkReaderPool.GetReader(packet))
-            {
-                // protect against attackers trying to send invalid data packets
-                // exception could be throw if:
-                // - invalid headers
-                // - invalid message ids
-                // - invalid data causing exceptions
-                // - negative ReadBytesAndSize prefixes
-                // - invalid utf8 strings
-                // - etc.
-                //
-                // if exception is caught, disconnect the attacker to stop any further attacks
-
-                try
-                {
-                    int msgType = MessagePacker.UnpackId(networkReader);
-                    InvokeHandler(msgType, networkReader);
-                }
-                catch (InvalidDataException ex)
-                {
-                    logger.Log(ex.ToString());
-                }
-                catch (Exception e)
-                {
-                    logger.LogError($"{e.GetType()} in Message handler (see stack below), Closed connection: {this}\n{e}");
-                    Connection?.Disconnect();
-                }
-            }
-        }
-
         public void AddOwnedObject(NetworkIdentity networkIdentity)
         {
             clientOwnedObjects.Add(networkIdentity);
diff --git a/Assets/Mirage/Runtime/NetworkSceneManager.cs b/Assets/Mirage/Runtime/NetworkSceneManager.cs
index e24548a0223..e70d47de632 100644
--- a/Assets/Mirage/Runtime/NetworkSceneManager.cs
+++ b/Assets/Mirage/Runtime/NetworkSceneManager.cs
@@ -95,7 +95,7 @@ public void Start()
 
             if (Client != null)
             {
-                Client.Authenticated.AddListener(OnClientAuthenticated);
+                Client.Started.AddListener(RegisterClientMessages);
             }
             if (Server != null)
             {
@@ -103,30 +103,24 @@ public void Start()
             }
         }
 
+        void OnDestroy()
+        {
+            if (Client != null)
+                Client.Started.RemoveListener(RegisterClientMessages);
+        }
+
         #region Client
 
-        void RegisterClientMessages(INetworkPlayer player)
+        void RegisterClientMessages()
         {
-            player.RegisterHandler<SceneMessage>(ClientSceneMessage);
+            Client.MessageHandler.RegisterHandler<SceneMessage>(ClientSceneMessage);
             if (!Client.IsLocalClient)
             {
-                player.RegisterHandler<SceneReadyMessage>(ClientSceneReadyMessage);
-                player.RegisterHandler<NotReadyMessage>(ClientNotReadyMessage);
+                Client.MessageHandler.RegisterHandler<SceneReadyMessage>(ClientSceneReadyMessage);
+                Client.MessageHandler.RegisterHandler<NotReadyMessage>(ClientNotReadyMessage);
             }
         }
 
-        void OnClientAuthenticated(INetworkPlayer player)
-        {
-            logger.Log("NetworkSceneManager.OnClientAuthenticated");
-            RegisterClientMessages(player);
-        }
-
-        void OnDestroy()
-        {
-            if (Client != null)
-                Client.Authenticated?.RemoveListener(OnClientAuthenticated);
-        }
-
         internal void ClientSceneMessage(INetworkPlayer player, SceneMessage msg)
         {
             if (!Client.IsConnected)
diff --git a/Assets/Mirage/Runtime/NetworkServer.cs b/Assets/Mirage/Runtime/NetworkServer.cs
index dab62fff284..bf876ca4e71 100644
--- a/Assets/Mirage/Runtime/NetworkServer.cs
+++ b/Assets/Mirage/Runtime/NetworkServer.cs
@@ -38,6 +38,8 @@ public class NetworkServer : MonoBehaviour, INetworkServer
         [Min(1)]
         public int MaxConnections = 4;
 
+        public bool DisconnectOnException = true;
+
         /// <summary>
         /// <para>If you disable this, the server will not listen for incoming connections on the regular network port.</para>
         /// <para>This can be used if the game is running in host mode and does not want external players to be able to connect - making it like a single-player game.</para>
@@ -141,6 +143,7 @@ public class NetworkServer : MonoBehaviour, INetworkServer
 
         public NetworkWorld World { get; private set; }
         public SyncVarSender SyncVarSender { get; private set; }
+        public MessageHandler MessageHandler { get; private set; }
 
 
         /// <summary>
@@ -190,26 +193,16 @@ public void StartServer(NetworkClient localClient = null)
             logger.Assert(Players.Count == 0, "Player could should have been reset since previous session");
             logger.Assert(connections.Count == 0, "connections could should have been reset since previous session");
 
-
-            if (authenticator != null)
-            {
-                authenticator.OnServerAuthenticated += OnAuthenticated;
-
-                Connected.AddListener(authenticator.ServerAuthenticate);
-            }
-            else
-            {
-                // if no authenticator, consider every connection as authenticated
-                Connected.AddListener(OnAuthenticated);
-            }
-
             LocalClient = localClient;
+            MessageHandler = new MessageHandler(DisconnectOnException);
+            MessageHandler.RegisterHandler<NetworkPingMessage>(Time.OnServerPing);
+
             World = new NetworkWorld();
             SyncVarSender = new SyncVarSender();
 
 
             ISocket socket = SocketFactory.CreateServerSocket();
-            var dataHandler = new DataHandler(connections);
+            var dataHandler = new DataHandler(MessageHandler, connections);
             Metrics = EnablePeerMetrics ? new Metrics() : null;
             Config config = PeerConfig ?? new Config
             {
@@ -226,6 +219,7 @@ public void StartServer(NetworkClient localClient = null)
 
             if (logger.LogEnabled()) logger.Log("Server started listening");
 
+            InitializeAuthEvents();
             Active = true;
             _started?.Invoke();
 
@@ -253,6 +247,22 @@ void ThrowIfSocketIsMissing()
                 throw new InvalidOperationException($"{nameof(SocketFactory)} could not be found for {nameof(NetworkServer)}");
         }
 
+        void InitializeAuthEvents()
+        {
+            if (authenticator != null)
+            {
+                authenticator.OnServerAuthenticated += OnAuthenticated;
+                authenticator.ServerSetup(this);
+
+                Connected.AddListener(authenticator.ServerAuthenticate);
+            }
+            else
+            {
+                // if no authenticator, consider every connection as authenticated
+                Connected.AddListener(OnAuthenticated);
+            }
+        }
+
         internal void Update()
         {
             peer?.Update();
@@ -332,7 +342,6 @@ public void AddConnection(INetworkPlayer player)
                 // would throw NRE
                 Players.Add(player);
                 connections.Add(player.Connection, player);
-                player.RegisterHandler<NetworkPingMessage>(Time.OnServerPing);
             }
         }
 
@@ -471,18 +480,20 @@ internal void OnAuthenticated(INetworkPlayer player)
         /// </summary>
         class DataHandler : IDataHandler
         {
+            readonly IMessageReceiver messageHandler;
             readonly Dictionary<IConnection, INetworkPlayer> players;
 
-            public DataHandler(Dictionary<IConnection, INetworkPlayer> connections)
+            public DataHandler(IMessageReceiver messageHandler, Dictionary<IConnection, INetworkPlayer> connections)
             {
+                this.messageHandler = messageHandler;
                 players = connections;
             }
 
             public void ReceiveMessage(IConnection connection, ArraySegment<byte> message)
             {
-                if (players.TryGetValue(connection, out INetworkPlayer handler))
+                if (players.TryGetValue(connection, out INetworkPlayer player))
                 {
-                    handler.HandleMessage(message);
+                    messageHandler.HandleMessage(player, message);
                 }
                 else
                 {
diff --git a/Assets/Mirage/Runtime/ServerObjectManager.cs b/Assets/Mirage/Runtime/ServerObjectManager.cs
index f4c1235eccc..8cfe95658ae 100644
--- a/Assets/Mirage/Runtime/ServerObjectManager.cs
+++ b/Assets/Mirage/Runtime/ServerObjectManager.cs
@@ -55,7 +55,6 @@ public void Start()
             {
                 Server.Started.AddListener(OnServerStarted);
                 Server.OnStartHost.AddListener(StartedHost);
-                Server.Authenticated.AddListener(OnAuthenticated);
                 Server.Stopped.AddListener(OnServerStopped);
 
                 if (NetworkSceneManager != null)
@@ -66,19 +65,15 @@ public void Start()
             }
         }
 
-        internal void RegisterMessageHandlers(INetworkPlayer player)
+        internal void RegisterMessageHandlers()
         {
-            player.RegisterHandler<ReadyMessage>(OnClientReadyMessage);
-            player.RegisterHandler<ServerRpcMessage>(OnServerRpcMessage);
-        }
-
-        void OnAuthenticated(INetworkPlayer player)
-        {
-            RegisterMessageHandlers(player);
+            Server.MessageHandler.RegisterHandler<ReadyMessage>(OnClientReadyMessage);
+            Server.MessageHandler.RegisterHandler<ServerRpcMessage>(OnServerRpcMessage);
         }
 
         void OnServerStarted()
         {
+            RegisterMessageHandlers();
             SpawnOrActivate();
         }
 
diff --git a/Assets/Mirage/Runtime/SyncVarReceiver.cs b/Assets/Mirage/Runtime/SyncVarReceiver.cs
index 21100473318..f5f877dff73 100644
--- a/Assets/Mirage/Runtime/SyncVarReceiver.cs
+++ b/Assets/Mirage/Runtime/SyncVarReceiver.cs
@@ -18,24 +18,24 @@ public SyncVarReceiver(NetworkClient client, IObjectLocator objectLocator)
             this.objectLocator = objectLocator;
             if (client.IsConnected)
             {
-                AddHandlers(client, client.Player);
+                AddHandlers(client);
             }
             else
             {
                 // todo replace this with RunOnceEvent
-                client.Connected.AddListener(player => AddHandlers(client, player));
+                client.Connected.AddListener(_ => AddHandlers(client));
             }
         }
 
-        private void AddHandlers(NetworkClient client, INetworkPlayer player)
+        private void AddHandlers(NetworkClient client)
         {
             if (client.IsLocalClient)
             {
-                player.RegisterHandler<UpdateVarsMessage>(_ => { });
+                client.MessageHandler.RegisterHandler<UpdateVarsMessage>(_ => { });
             }
             else
             {
-                player.RegisterHandler<UpdateVarsMessage>(OnUpdateVarsMessage);
+                client.MessageHandler.RegisterHandler<UpdateVarsMessage>(OnUpdateVarsMessage);
             }
         }
 
diff --git a/Assets/Mirage/Samples~/Chat/Scripts/ChatNetworkManager.cs b/Assets/Mirage/Samples~/Chat/Scripts/ChatNetworkManager.cs
index 8c1f730b653..44e20393da6 100644
--- a/Assets/Mirage/Samples~/Chat/Scripts/ChatNetworkManager.cs
+++ b/Assets/Mirage/Samples~/Chat/Scripts/ChatNetworkManager.cs
@@ -13,8 +13,8 @@ public class ChatNetworkManager : NetworkManager
 
         void Awake()
         {
-            Server.Authenticated.AddListener(OnServerAuthenticated);
-            Client.Authenticated.AddListener(OnClientAuthenticated);
+            Server.Started.AddListener(OnServerStarted);
+            Client.Connected.AddListener(OnClientAuthenticated);
         }
 
         public struct CreateCharacterMessage
@@ -22,9 +22,9 @@ public struct CreateCharacterMessage
             public string name;
         }
 
-        public void OnServerAuthenticated(INetworkPlayer player)
+        public void OnServerStarted()
         {
-            player.RegisterHandler<CreateCharacterMessage>(OnCreatePlayer);
+            Server.MessageHandler.RegisterHandler<CreateCharacterMessage>(OnCreatePlayer);
         }
 
         public void OnClientAuthenticated(INetworkPlayer player)
diff --git a/Assets/Mirage/Weaver/Processors/ReaderWriterProcessor.cs b/Assets/Mirage/Weaver/Processors/ReaderWriterProcessor.cs
index 63a346eb88e..b8da4237ebd 100644
--- a/Assets/Mirage/Weaver/Processors/ReaderWriterProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/ReaderWriterProcessor.cs
@@ -188,11 +188,11 @@ private static bool IsMessageMethod(MethodReference method)
                 method.Is(typeof(MessagePacker), nameof(MessagePacker.GetId)) ||
                 method.Is(typeof(MessagePacker), nameof(MessagePacker.Unpack)) ||
                 method.Is<IMessageSender>(nameof(IMessageSender.Send)) ||
-                method.Is<IMessageSender>(nameof(IMessageReceiver.RegisterHandler)) ||
-                method.Is<IMessageSender>(nameof(IMessageReceiver.UnregisterHandler)) ||
+                method.Is<IMessageReceiver>(nameof(IMessageReceiver.RegisterHandler)) ||
+                method.Is<IMessageReceiver>(nameof(IMessageReceiver.UnregisterHandler)) ||
                 method.Is<NetworkPlayer>(nameof(NetworkPlayer.Send)) ||
-                method.Is<NetworkPlayer>(nameof(NetworkPlayer.RegisterHandler)) ||
-                method.Is<NetworkPlayer>(nameof(NetworkPlayer.UnregisterHandler)) ||
+                method.Is<MessageHandler>(nameof(MessageHandler.RegisterHandler)) ||
+                method.Is<MessageHandler>(nameof(MessageHandler.UnregisterHandler)) ||
                 method.Is<NetworkClient>(nameof(NetworkClient.Send)) ||
                 method.Is<NetworkServer>(nameof(NetworkServer.SendToAll)) ||
                 method.Is<NetworkServer>(nameof(NetworkServer.SendToMany)) ||
diff --git a/Assets/Tests/Common/LocalConnections.cs b/Assets/Tests/Common/LocalConnections.cs
index 405c64d76ce..ae73a05c1bf 100644
--- a/Assets/Tests/Common/LocalConnections.cs
+++ b/Assets/Tests/Common/LocalConnections.cs
@@ -3,11 +3,11 @@ namespace Mirage.Tests
 
     public static class LocalConnections
     {
-        public static (NetworkPlayer serverPlayer, NetworkPlayer clientPlayer) PipedConnections()
+        public static (NetworkPlayer serverPlayer, NetworkPlayer clientPlayer) PipedConnections(IMessageReceiver clientMessages, IMessageReceiver serverMessages)
         {
             // we can re-use networkclient's handlers here as it just needs connection and player
-            var clientHandler = new NetworkClient.DataHandler();
-            var serverHandler = new NetworkClient.DataHandler();
+            var clientHandler = new NetworkClient.DataHandler(clientMessages);
+            var serverHandler = new NetworkClient.DataHandler(serverMessages);
 
             (SocketLayer.IConnection clientConn, SocketLayer.IConnection serverConn) = PipePeerConnection.Create(clientHandler, serverHandler, null, null);
 
diff --git a/Assets/Tests/Editor/NetworkIdentityCallbackTests.cs b/Assets/Tests/Editor/NetworkIdentityCallbackTests.cs
index 153131952a9..8c182d812bc 100644
--- a/Assets/Tests/Editor/NetworkIdentityCallbackTests.cs
+++ b/Assets/Tests/Editor/NetworkIdentityCallbackTests.cs
@@ -239,7 +239,7 @@ public void SetAssetId_DoesNotGiveErrorIfBothOldAndNewAreEmpty()
         public void SetClientOwner()
         {
             // SetClientOwner
-            (_, NetworkPlayer original) = PipedConnections();
+            (_, NetworkPlayer original) = PipedConnections(Substitute.For<IMessageReceiver>(), Substitute.For<IMessageReceiver>());
             identity.SetClientOwner(original);
             Assert.That(identity.ConnectionToClient, Is.EqualTo(original));
         }
@@ -248,11 +248,11 @@ public void SetClientOwner()
         public void SetOverrideClientOwner()
         {
             // SetClientOwner
-            (_, NetworkPlayer original) = PipedConnections();
+            (_, NetworkPlayer original) = PipedConnections(Substitute.For<IMessageReceiver>(), Substitute.For<IMessageReceiver>());
             identity.SetClientOwner(original);
 
             // setting it when it's already set shouldn't overwrite the original
-            (_, NetworkPlayer overwrite) = PipedConnections();
+            (_, NetworkPlayer overwrite) = PipedConnections(Substitute.For<IMessageReceiver>(), Substitute.For<IMessageReceiver>());
             // will log a warning
             Assert.Throws<InvalidOperationException>(() =>
             {
@@ -736,7 +736,7 @@ public void RebuildObserversOnlyAddsOwnPlayerIfReady()
             gameObject.AddComponent<RebuildEmptyObserversNetworkBehaviour>();
 
             // add own player connection that isn't ready
-            (_, NetworkPlayer connection) = PipedConnections();
+            (_, NetworkPlayer connection) = PipedConnections(Substitute.For<IMessageReceiver>(), Substitute.For<IMessageReceiver>());
             identity.ConnectionToClient = connection;
 
             // call OnStartServer so that observers dict is created
diff --git a/Assets/Tests/Runtime/ClientServer/BasicAuthenticatorTest.cs b/Assets/Tests/Runtime/ClientServer/BasicAuthenticatorTest.cs
index 6826a7f346a..13dfa0d543a 100644
--- a/Assets/Tests/Runtime/ClientServer/BasicAuthenticatorTest.cs
+++ b/Assets/Tests/Runtime/ClientServer/BasicAuthenticatorTest.cs
@@ -12,8 +12,8 @@ public class BasicAuthenticatorTest : ClientServerSetup<MockComponent>
         public void CheckConnected()
         {
             // Should have connected
-            Assert.That(connectionToServer, Is.Not.Null);
-            Assert.That(connectionToClient, Is.Not.Null);
+            Assert.That(clientPlayer, Is.Not.Null);
+            Assert.That(serverPlayer, Is.Not.Null);
         }
 
         public override void ExtraSetup()
diff --git a/Assets/Tests/Runtime/ClientServer/ClientServerComponentTests.cs b/Assets/Tests/Runtime/ClientServer/ClientServerComponentTests.cs
index 7f20ce606a1..330482ff7a7 100644
--- a/Assets/Tests/Runtime/ClientServer/ClientServerComponentTests.cs
+++ b/Assets/Tests/Runtime/ClientServer/ClientServerComponentTests.cs
@@ -64,11 +64,11 @@ public void CheckNotHost()
         [UnityTest]
         public IEnumerator ClientConnRpc() => UniTask.ToCoroutine(async () =>
         {
-            serverComponent.ClientConnRpcTest(connectionToClient, 1, "hello");
+            serverComponent.ClientConnRpcTest(serverPlayer, 1, "hello");
             // process spawn message from server
             await AsyncUtil.WaitUntilWithTimeout(() => clientComponent.targetRpcArg1 != 0);
 
-            Assert.That(clientComponent.targetRpcPlayer, Is.EqualTo(connectionToServer));
+            Assert.That(clientComponent.targetRpcPlayer, Is.EqualTo(clientPlayer));
             Assert.That(clientComponent.targetRpcArg1, Is.EqualTo(1));
             Assert.That(clientComponent.targetRpcArg2, Is.EqualTo("hello"));
         });
@@ -96,7 +96,7 @@ public void CheckNotHost()
 
             clientObjectManager.RegisterSpawnHandler(guid, SpawnDelegateTest, go => { });
             clientObjectManager.RegisterPrefab(identity, guid);
-            serverObjectManager.SendSpawnMessage(identity, connectionToClient);
+            serverObjectManager.SendSpawnMessage(identity, serverPlayer);
 
             await AsyncUtil.WaitUntilWithTimeout(() => spawnDelegateTestCalled != 0);
 
@@ -117,7 +117,7 @@ public void CheckNotHost()
 
             clientObjectManager.RegisterSpawnHandler(guid, SpawnDelegateTest, unspawnDelegate);
             clientObjectManager.RegisterPrefab(identity, guid);
-            serverObjectManager.SendSpawnMessage(identity, connectionToClient);
+            serverObjectManager.SendSpawnMessage(identity, serverPlayer);
 
             await AsyncUtil.WaitUntilWithTimeout(() => spawnDelegateTestCalled != 0);
 
diff --git a/Assets/Tests/Runtime/ClientServer/ClientServerSetup.cs b/Assets/Tests/Runtime/ClientServer/ClientServerSetup.cs
index 79bda4289c5..cbe4877c278 100644
--- a/Assets/Tests/Runtime/ClientServer/ClientServerSetup.cs
+++ b/Assets/Tests/Runtime/ClientServer/ClientServerSetup.cs
@@ -32,8 +32,10 @@ public class ClientServerSetup<T> where T : NetworkBehaviour
         protected GameObject playerPrefab;
 
         protected TestSocketFactory socketFactory;
-        protected INetworkPlayer connectionToServer;
-        protected INetworkPlayer connectionToClient;
+        protected INetworkPlayer clientPlayer;
+        protected INetworkPlayer serverPlayer;
+        protected MessageHandler ClientMessageHandler => client.MessageHandler;
+        protected MessageHandler ServerMessageHandler => server.MessageHandler;
 
         public virtual void ExtraSetup() { }
 
@@ -102,19 +104,19 @@ public class ClientServerSetup<T> where T : NetworkBehaviour
                 await AsyncUtil.WaitUntilWithTimeout(() => server.Players.Count > 0);
 
                 // get the connections so that we can spawn players
-                connectionToClient = server.Players.First();
-                connectionToServer = client.Player;
+                serverPlayer = server.Players.First();
+                clientPlayer = client.Player;
 
                 // create a player object in the server
                 serverPlayerGO = Object.Instantiate(playerPrefab);
                 serverIdentity = serverPlayerGO.GetComponent<NetworkIdentity>();
                 serverComponent = serverPlayerGO.GetComponent<T>();
-                serverObjectManager.AddCharacter(connectionToClient, serverPlayerGO);
+                serverObjectManager.AddCharacter(serverPlayer, serverPlayerGO);
 
                 // wait for client to spawn it
-                await AsyncUtil.WaitUntilWithTimeout(() => connectionToServer.Identity != null);
+                await AsyncUtil.WaitUntilWithTimeout(() => clientPlayer.Identity != null);
 
-                clientIdentity = connectionToServer.Identity;
+                clientIdentity = clientPlayer.Identity;
                 clientPlayerGO = clientIdentity.gameObject;
                 clientComponent = clientPlayerGO.GetComponent<T>();
             }
diff --git a/Assets/Tests/Runtime/ClientServer/NetworkAuthenticatorTest.cs b/Assets/Tests/Runtime/ClientServer/NetworkAuthenticatorTest.cs
index 43cf973a4e9..8fd46d812b5 100644
--- a/Assets/Tests/Runtime/ClientServer/NetworkAuthenticatorTest.cs
+++ b/Assets/Tests/Runtime/ClientServer/NetworkAuthenticatorTest.cs
@@ -18,7 +18,10 @@ class NetworkAuthenticationImpl : NetworkAuthenticator
         {
             public override void ClientAuthenticate(INetworkPlayer player) => ClientAccept(player);
             public override void ServerAuthenticate(INetworkPlayer player) => ServerAccept(player);
+            public override void ClientSetup(NetworkClient client) { }
+            public override void ServerSetup(NetworkServer server) { }
         }
+
         public override void ExtraSetup()
         {
             serverAuthenticator = serverGo.AddComponent<NetworkAuthenticationImpl>();
diff --git a/Assets/Tests/Runtime/ClientServer/NetworkClientDisconnectTest.cs b/Assets/Tests/Runtime/ClientServer/NetworkClientDisconnectTest.cs
index 3db7e0e8181..6b012ab62e6 100644
--- a/Assets/Tests/Runtime/ClientServer/NetworkClientDisconnectTest.cs
+++ b/Assets/Tests/Runtime/ClientServer/NetworkClientDisconnectTest.cs
@@ -51,7 +51,7 @@ public IEnumerator DisconnectEventWhenServerDisconnects()
             });
 
             // server's object
-            connectionToClient.Disconnect();
+            serverPlayer.Disconnect();
 
             // wait 2 frames so that messages can go from client->server->client
             yield return null;
diff --git a/Assets/Tests/Runtime/ClientServer/NetworkSceneManagerTests.cs b/Assets/Tests/Runtime/ClientServer/NetworkSceneManagerTests.cs
index 4a07f4ce5a3..b5f09aafdea 100644
--- a/Assets/Tests/Runtime/ClientServer/NetworkSceneManagerTests.cs
+++ b/Assets/Tests/Runtime/ClientServer/NetworkSceneManagerTests.cs
@@ -76,7 +76,7 @@ public void FinishLoadSceneTest()
             Assert.That(startInvoked == 1, "Start should only be called once");
             Assert.That(endInvoked == 0, "Should wait for ready before end is called");
 
-            clientSceneManager.ClientSceneReadyMessage(connectionToServer, new SceneReadyMessage());
+            clientSceneManager.ClientSceneReadyMessage(clientPlayer, new SceneReadyMessage());
 
             await AsyncUtil.WaitUntilWithTimeout(() => endInvoked == 1);
 
diff --git a/Assets/Tests/Runtime/ClientServer/NetworkServerTests.cs b/Assets/Tests/Runtime/ClientServer/NetworkServerTests.cs
index d901fba5847..1e5b338ff08 100644
--- a/Assets/Tests/Runtime/ClientServer/NetworkServerTests.cs
+++ b/Assets/Tests/Runtime/ClientServer/NetworkServerTests.cs
@@ -45,12 +45,12 @@ public void ThrowsIfListenIsCalledWhileAlreadyActive()
         [UnityTest]
         public IEnumerator ReadyMessageSetsClientReadyTest() => UniTask.ToCoroutine(async () =>
         {
-            connectionToServer.Send(new ReadyMessage());
+            clientPlayer.Send(new ReadyMessage());
 
-            await AsyncUtil.WaitUntilWithTimeout(() => connectionToClient.IsReady);
+            await AsyncUtil.WaitUntilWithTimeout(() => serverPlayer.IsReady);
 
             // ready?
-            Assert.That(connectionToClient.IsReady, Is.True);
+            Assert.That(serverPlayer.IsReady, Is.True);
         });
 
         [UnityTest]
@@ -58,7 +58,7 @@ public void ThrowsIfListenIsCalledWhileAlreadyActive()
         {
             bool invoked = false;
 
-            connectionToServer.RegisterHandler<WovenTestMessage>(msg => invoked = true);
+            ClientMessageHandler.RegisterHandler<WovenTestMessage>(msg => invoked = true);
 
             server.SendToAll(message);
 
@@ -73,7 +73,7 @@ public void ThrowsIfListenIsCalledWhileAlreadyActive()
         {
             bool invoked = false;
 
-            connectionToServer.RegisterHandler<WovenTestMessage>(msg => invoked = true);
+            ClientMessageHandler.RegisterHandler<WovenTestMessage>(msg => invoked = true);
 
             serverIdentity.ConnectionToClient.Send(message);
 
@@ -88,8 +88,8 @@ public void ThrowsIfListenIsCalledWhileAlreadyActive()
         {
             bool invoked = false;
 
-            connectionToClient.RegisterHandler<WovenTestMessage>(msg => invoked = true);
-            connectionToServer.Send(message);
+            ServerMessageHandler.RegisterHandler<WovenTestMessage>(msg => invoked = true);
+            clientPlayer.Send(message);
 
             await AsyncUtil.WaitUntilWithTimeout(() => invoked);
 
@@ -100,9 +100,9 @@ public void ThrowsIfListenIsCalledWhileAlreadyActive()
         {
             bool invoked = false;
 
-            connectionToClient.RegisterHandler<WovenTestMessage>((conn, msg) => invoked = true);
+            ServerMessageHandler.RegisterHandler<WovenTestMessage>((conn, msg) => invoked = true);
 
-            connectionToServer.Send(message);
+            clientPlayer.Send(message);
 
             await AsyncUtil.WaitUntilWithTimeout(() => invoked);
         });
@@ -110,12 +110,12 @@ public void ThrowsIfListenIsCalledWhileAlreadyActive()
         [UnityTest]
         public IEnumerator UnRegisterMessage1() => UniTask.ToCoroutine(async () =>
         {
-            Action<WovenTestMessage> func = Substitute.For<Action<WovenTestMessage>>();
+            MessageDelegate<WovenTestMessage> func = Substitute.For<MessageDelegate<WovenTestMessage>>();
 
-            connectionToClient.RegisterHandler(func);
-            connectionToClient.UnregisterHandler<WovenTestMessage>();
+            ServerMessageHandler.RegisterHandler(func);
+            ServerMessageHandler.UnregisterHandler<WovenTestMessage>();
 
-            connectionToServer.Send(message);
+            clientPlayer.Send(message);
 
             await UniTask.Delay(1);
 
diff --git a/Assets/Tests/Runtime/ClientServer/ServerObjectManagerTests.cs b/Assets/Tests/Runtime/ClientServer/ServerObjectManagerTests.cs
index ea5c513169f..3733211fe53 100644
--- a/Assets/Tests/Runtime/ClientServer/ServerObjectManagerTests.cs
+++ b/Assets/Tests/Runtime/ClientServer/ServerObjectManagerTests.cs
@@ -27,7 +27,7 @@ public void ThrowsIfSpawnCalledWhenServerIsNotAcctive()
 
             InvalidOperationException ex = Assert.Throws<InvalidOperationException>(() =>
             {
-                serverObjectManager.Spawn(new GameObject().AddComponent<NetworkIdentity>(), connectionToClient);
+                serverObjectManager.Spawn(new GameObject().AddComponent<NetworkIdentity>(), serverPlayer);
             });
 
             Assert.That(ex.Message, Is.EqualTo("NetworkServer is not active. Cannot spawn objects without an active server."));
@@ -73,12 +73,12 @@ public void ThrowsIfSpawnCalledWithOwnerWithNoOwnerTest()
         {
             bool invoked = false;
 
-            connectionToServer.RegisterHandler<SpawnMessage>(msg => invoked = true);
+            ClientMessageHandler.RegisterHandler<SpawnMessage>(msg => invoked = true);
 
-            connectionToClient.IsReady = true;
+            serverPlayer.IsReady = true;
 
             // call ShowForConnection
-            serverObjectManager.ShowForConnection(serverIdentity, connectionToClient);
+            serverObjectManager.ShowForConnection(serverIdentity, serverPlayer);
 
             // todo assert correct message was sent using Substitute for socket or player
 
@@ -163,9 +163,9 @@ public void ReplacePlayerBaseTest()
             replacementIdentity.AssetId = Guid.NewGuid();
             clientObjectManager.RegisterPrefab(replacementIdentity);
 
-            serverObjectManager.ReplaceCharacter(connectionToClient, playerReplacement);
+            serverObjectManager.ReplaceCharacter(serverPlayer, playerReplacement);
 
-            Assert.That(connectionToClient.Identity, Is.EqualTo(replacementIdentity));
+            Assert.That(serverPlayer.Identity, Is.EqualTo(replacementIdentity));
         }
 
         [Test]
@@ -176,7 +176,7 @@ public void ReplacePlayerDontKeepAuthTest()
             replacementIdentity.AssetId = Guid.NewGuid();
             clientObjectManager.RegisterPrefab(replacementIdentity);
 
-            serverObjectManager.ReplaceCharacter(connectionToClient, playerReplacement, true);
+            serverObjectManager.ReplaceCharacter(serverPlayer, playerReplacement, true);
 
             Assert.That(clientIdentity.ConnectionToClient, Is.EqualTo(null));
         }
@@ -190,9 +190,9 @@ public void ReplacePlayerAssetIdTest()
             replacementIdentity.AssetId = replacementGuid;
             clientObjectManager.RegisterPrefab(replacementIdentity);
 
-            serverObjectManager.ReplaceCharacter(connectionToClient, playerReplacement, replacementGuid);
+            serverObjectManager.ReplaceCharacter(serverPlayer, playerReplacement, replacementGuid);
 
-            Assert.That(connectionToClient.Identity.AssetId, Is.EqualTo(replacementGuid));
+            Assert.That(serverPlayer.Identity.AssetId, Is.EqualTo(replacementGuid));
         }
 
         [Test]
@@ -204,17 +204,17 @@ public void AddPlayerForConnectionAssetIdTest()
             replacementIdentity.AssetId = replacementGuid;
             clientObjectManager.RegisterPrefab(replacementIdentity);
 
-            connectionToClient.Identity = null;
+            serverPlayer.Identity = null;
 
-            serverObjectManager.AddCharacter(connectionToClient, playerReplacement, replacementGuid);
+            serverObjectManager.AddCharacter(serverPlayer, playerReplacement, replacementGuid);
 
-            Assert.That(replacementIdentity == connectionToClient.Identity);
+            Assert.That(replacementIdentity == serverPlayer.Identity);
         }
 
         [UnityTest]
         public IEnumerator RemovePlayerForConnectionTest() => UniTask.ToCoroutine(async () =>
         {
-            serverObjectManager.RemovePlayerForConnection(connectionToClient);
+            serverObjectManager.RemovePlayerForConnection(serverPlayer);
 
             await AsyncUtil.WaitUntilWithTimeout(() => !clientIdentity);
 
@@ -224,20 +224,20 @@ public void AddPlayerForConnectionAssetIdTest()
         [UnityTest]
         public IEnumerator RemovePlayerForConnectionExceptionTest() => UniTask.ToCoroutine(async () =>
         {
-            serverObjectManager.RemovePlayerForConnection(connectionToClient);
+            serverObjectManager.RemovePlayerForConnection(serverPlayer);
 
             await AsyncUtil.WaitUntilWithTimeout(() => !clientIdentity);
 
             Assert.Throws<InvalidOperationException>(() =>
             {
-                serverObjectManager.RemovePlayerForConnection(connectionToClient);
+                serverObjectManager.RemovePlayerForConnection(serverPlayer);
             });
         });
 
         [UnityTest]
         public IEnumerator RemovePlayerForConnectionDestroyTest() => UniTask.ToCoroutine(async () =>
         {
-            serverObjectManager.RemovePlayerForConnection(connectionToClient, true);
+            serverObjectManager.RemovePlayerForConnection(serverPlayer, true);
 
             await AsyncUtil.WaitUntilWithTimeout(() => !clientIdentity);
 
@@ -249,7 +249,7 @@ public void ThrowsIfSpawnedCalledWithoutANetworkIdentity()
         {
             InvalidOperationException ex = Assert.Throws<InvalidOperationException>(() =>
             {
-                serverObjectManager.Spawn(new GameObject(), connectionToServer);
+                serverObjectManager.Spawn(new GameObject(), clientPlayer);
             });
 
             AssertNoIdentityMessage(ex);
@@ -261,7 +261,7 @@ public void AddCharacterNoIdentityExceptionTest()
         {
             InvalidOperationException ex = Assert.Throws<InvalidOperationException>(() =>
             {
-                serverObjectManager.AddCharacter(connectionToClient, new GameObject());
+                serverObjectManager.AddCharacter(serverPlayer, new GameObject());
             });
             AssertNoIdentityMessage(ex);
 
@@ -272,7 +272,7 @@ public void ReplacePlayerNoIdentityExceptionTest()
         {
             InvalidOperationException ex = Assert.Throws<InvalidOperationException>(() =>
             {
-                serverObjectManager.ReplaceCharacter(connectionToClient, new GameObject(), true);
+                serverObjectManager.ReplaceCharacter(serverPlayer, new GameObject(), true);
             });
             AssertNoIdentityMessage(ex);
         }
diff --git a/Assets/Tests/Runtime/Host/Authenticators.meta b/Assets/Tests/Runtime/Host/Authenticators.meta
new file mode 100644
index 00000000000..eafa13c4d1a
--- /dev/null
+++ b/Assets/Tests/Runtime/Host/Authenticators.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 20494b0e67c66c44197be2409ebd30be
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Runtime/Host/Authenticators/AuthenticatorHostModeBase.cs b/Assets/Tests/Runtime/Host/Authenticators/AuthenticatorHostModeBase.cs
new file mode 100644
index 00000000000..720bf621f07
--- /dev/null
+++ b/Assets/Tests/Runtime/Host/Authenticators/AuthenticatorHostModeBase.cs
@@ -0,0 +1,37 @@
+using NUnit.Framework;
+
+namespace Mirage.Tests.Runtime.Host.Authenticators
+{
+    public abstract class AuthenticatorHostModeBase : HostSetup<MockComponent>
+    {
+        protected abstract void AddAuthenticator();
+
+
+        int serverAuthCalled;
+        int clientAuthCalled;
+
+        public sealed override void ExtraSetup()
+        {
+            AddAuthenticator();
+
+            // reset fields
+            serverAuthCalled = 0;
+            clientAuthCalled = 0;
+
+            server.Authenticated.AddListener(_ => serverAuthCalled++);
+            client.Authenticated.AddListener(_ => clientAuthCalled++);
+        }
+
+        [Test]
+        public void AuthenticatedCalledOnceOnServer()
+        {
+            Assert.That(serverAuthCalled, Is.EqualTo(1));
+        }
+
+        [Test]
+        public void AuthenticatedCalledOnceOnClient()
+        {
+            Assert.That(clientAuthCalled, Is.EqualTo(1));
+        }
+    }
+}
diff --git a/Assets/Tests/Runtime/Host/Authenticators/AuthenticatorHostModeBase.cs.meta b/Assets/Tests/Runtime/Host/Authenticators/AuthenticatorHostModeBase.cs.meta
new file mode 100644
index 00000000000..140f122e086
--- /dev/null
+++ b/Assets/Tests/Runtime/Host/Authenticators/AuthenticatorHostModeBase.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: f5ac94b5943de4c4cbd220c71cfe0405
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Runtime/Host/Authenticators/BasicAuthenticatorHostMode.cs b/Assets/Tests/Runtime/Host/Authenticators/BasicAuthenticatorHostMode.cs
new file mode 100644
index 00000000000..eccd9399054
--- /dev/null
+++ b/Assets/Tests/Runtime/Host/Authenticators/BasicAuthenticatorHostMode.cs
@@ -0,0 +1,15 @@
+using Mirage.Authenticators;
+
+namespace Mirage.Tests.Runtime.Host.Authenticators
+{
+    public class BasicAuthenticatorHostMode : AuthenticatorHostModeBase
+    {
+        protected override void AddAuthenticator()
+        {
+            BasicAuthenticator auth = networkManagerGo.AddComponent<BasicAuthenticator>();
+            server.authenticator = auth;
+            client.authenticator = auth;
+            auth.serverCode = "1234";
+        }
+    }
+}
diff --git a/Assets/Tests/Runtime/Host/Authenticators/BasicAuthenticatorHostMode.cs.meta b/Assets/Tests/Runtime/Host/Authenticators/BasicAuthenticatorHostMode.cs.meta
new file mode 100644
index 00000000000..1bc2b01e85e
--- /dev/null
+++ b/Assets/Tests/Runtime/Host/Authenticators/BasicAuthenticatorHostMode.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: dd6f1d4112ff5af4abf5a665ec75c1b5
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Runtime/Host/Authenticators/NoAuthenticatorHostMode.cs b/Assets/Tests/Runtime/Host/Authenticators/NoAuthenticatorHostMode.cs
new file mode 100644
index 00000000000..2739d53f8bc
--- /dev/null
+++ b/Assets/Tests/Runtime/Host/Authenticators/NoAuthenticatorHostMode.cs
@@ -0,0 +1,12 @@
+namespace Mirage.Tests.Runtime.Host.Authenticators
+{
+    public class NoAuthenticatorHostMode : AuthenticatorHostModeBase
+    {
+        protected override void AddAuthenticator()
+        {
+            server.authenticator = null;
+            client.authenticator = null;
+
+        }
+    }
+}
diff --git a/Assets/Tests/Runtime/Host/Authenticators/NoAuthenticatorHostMode.cs.meta b/Assets/Tests/Runtime/Host/Authenticators/NoAuthenticatorHostMode.cs.meta
new file mode 100644
index 00000000000..5388f02c432
--- /dev/null
+++ b/Assets/Tests/Runtime/Host/Authenticators/NoAuthenticatorHostMode.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 86cb6f26f16a4844fa4086b040991691
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Runtime/Host/CharacterSpawnerTest.cs b/Assets/Tests/Runtime/Host/CharacterSpawnerTest.cs
index 8872c1fc192..3cd6a119196 100644
--- a/Assets/Tests/Runtime/Host/CharacterSpawnerTest.cs
+++ b/Assets/Tests/Runtime/Host/CharacterSpawnerTest.cs
@@ -41,7 +41,7 @@ public override void ExtraTearDown()
         public IEnumerator DontAutoSpawnTest() => UniTask.ToCoroutine(async () =>
         {
             bool invokeAddPlayerMessage = false;
-            server.LocalPlayer.RegisterHandler<AddCharacterMessage>(msg => invokeAddPlayerMessage = true);
+            ServerMessageHandler.RegisterHandler<AddCharacterMessage>(msg => invokeAddPlayerMessage = true);
 
             sceneManager.ChangeServerScene("Assets/Mirror/Tests/Runtime/testScene.unity");
             // wait for messages to be processed
@@ -55,7 +55,7 @@ public override void ExtraTearDown()
         public IEnumerator ManualSpawnTest() => UniTask.ToCoroutine(async () =>
         {
             bool invokeAddPlayerMessage = false;
-            server.LocalPlayer.RegisterHandler<AddCharacterMessage>(msg => invokeAddPlayerMessage = true);
+            ServerMessageHandler.RegisterHandler<AddCharacterMessage>(msg => invokeAddPlayerMessage = true);
 
             spawner.RequestServerSpawnPlayer();
 
diff --git a/Assets/Tests/Runtime/Host/HostSetup.cs b/Assets/Tests/Runtime/Host/HostSetup.cs
index 46a037ac1e9..f00157159dc 100644
--- a/Assets/Tests/Runtime/Host/HostSetup.cs
+++ b/Assets/Tests/Runtime/Host/HostSetup.cs
@@ -23,6 +23,9 @@ public class HostSetup<T> where T : NetworkBehaviour
         protected NetworkIdentity identity;
         protected T component;
 
+        protected MessageHandler ClientMessageHandler => client.MessageHandler;
+        protected MessageHandler ServerMessageHandler => server.MessageHandler;
+
         protected virtual bool AutoStartServer => true;
         protected virtual Config ServerConfig => null;
         protected virtual Config ClientConfig => null;
diff --git a/Assets/Tests/Runtime/Host/LobbyReadyTest.cs b/Assets/Tests/Runtime/Host/LobbyReadyTest.cs
index 709614e34a7..373f713e4df 100644
--- a/Assets/Tests/Runtime/Host/LobbyReadyTest.cs
+++ b/Assets/Tests/Runtime/Host/LobbyReadyTest.cs
@@ -43,7 +43,7 @@ public void SetAllClientsNotReadyTest()
             readyComp.IsReady = true;
 
             bool invokeWovenTestMessage = false;
-            client.Player.RegisterHandler<SceneMessage>(msg => invokeWovenTestMessage = true);
+            ClientMessageHandler.RegisterHandler<SceneMessage>(msg => invokeWovenTestMessage = true);
             lobby.SendToReady(identity, new SceneMessage(), true, Channel.Reliable);
 
             await AsyncUtil.WaitUntilWithTimeout(() => invokeWovenTestMessage);
diff --git a/Assets/Tests/Runtime/Host/NetworkBehaviourTests.cs b/Assets/Tests/Runtime/Host/NetworkBehaviourTests.cs
index 32c5951e8c4..27f7b623324 100644
--- a/Assets/Tests/Runtime/Host/NetworkBehaviourTests.cs
+++ b/Assets/Tests/Runtime/Host/NetworkBehaviourTests.cs
@@ -109,7 +109,7 @@ public void TimeTest()
         [Test]
         public void HasIdentitysConnectionToClient()
         {
-            (_, identity.ConnectionToClient) = PipedConnections();
+            (_, identity.ConnectionToClient) = PipedConnections(ClientMessageHandler, ServerMessageHandler);
             Assert.That(component.ConnectionToClient, Is.EqualTo(identity.ConnectionToClient));
         }
 
diff --git a/Assets/Tests/Runtime/Host/NetworkClientTest.cs b/Assets/Tests/Runtime/Host/NetworkClientTest.cs
index 0844bc8994e..779b9fe97aa 100644
--- a/Assets/Tests/Runtime/Host/NetworkClientTest.cs
+++ b/Assets/Tests/Runtime/Host/NetworkClientTest.cs
@@ -32,13 +32,11 @@ public void ConnectionTest()
         [Test]
         public void ConnectionClearHandlersTest()
         {
-            var clientConn = client.Player as NetworkPlayer;
+            Assert.That(ClientMessageHandler.messageHandlers.Count > 0);
 
-            Assert.That(clientConn.messageHandlers.Count > 0);
+            ClientMessageHandler.ClearHandlers();
 
-            clientConn.ClearHandlers();
-
-            Assert.That(clientConn.messageHandlers.Count == 0);
+            Assert.That(ClientMessageHandler.messageHandlers.Count == 0);
         }
 
         [Test]
diff --git a/Assets/Tests/Runtime/Host/NetworkSceneManagerTests.cs b/Assets/Tests/Runtime/Host/NetworkSceneManagerTests.cs
index 6329aa85568..9e8f3a2e56c 100644
--- a/Assets/Tests/Runtime/Host/NetworkSceneManagerTests.cs
+++ b/Assets/Tests/Runtime/Host/NetworkSceneManagerTests.cs
@@ -66,8 +66,8 @@ public void FinishLoadSceneHostTest()
             bool invokeClientSceneMessage = false;
             bool invokeNotReadyMessage = false;
             UnityAction<string, SceneOperation> func1 = Substitute.For<UnityAction<string, SceneOperation>>();
-            client.Player.RegisterHandler<SceneMessage>(msg => invokeClientSceneMessage = true);
-            client.Player.RegisterHandler<NotReadyMessage>(msg => invokeNotReadyMessage = true);
+            ClientMessageHandler.RegisterHandler<SceneMessage>(msg => invokeClientSceneMessage = true);
+            ClientMessageHandler.RegisterHandler<NotReadyMessage>(msg => invokeNotReadyMessage = true);
             sceneManager.ServerChangeScene.AddListener(func1);
 
             sceneManager.ChangeServerScene("Assets/Mirror/Tests/Runtime/testScene.unity");
diff --git a/Assets/Tests/Runtime/Host/ServerObjectManagerTest.cs b/Assets/Tests/Runtime/Host/ServerObjectManagerTest.cs
index 44f2add4178..d058487b10e 100644
--- a/Assets/Tests/Runtime/Host/ServerObjectManagerTest.cs
+++ b/Assets/Tests/Runtime/Host/ServerObjectManagerTest.cs
@@ -16,7 +16,7 @@ public class ServerObjectManagerHostTest : HostSetup<MockComponent>
         [Test]
         public void SetClientReadyAndNotReadyTest()
         {
-            (_, NetworkPlayer connection) = PipedConnections();
+            (_, NetworkPlayer connection) = PipedConnections(ClientMessageHandler, ServerMessageHandler);
             Assert.That(connection.IsReady, Is.False);
 
             serverObjectManager.SetClientReady(connection);
@@ -30,12 +30,12 @@ public void SetClientReadyAndNotReadyTest()
         public void SetAllClientsNotReadyTest()
         {
             // add first ready client
-            (_, NetworkPlayer first) = PipedConnections();
+            (_, NetworkPlayer first) = PipedConnections(ClientMessageHandler, ServerMessageHandler);
             first.IsReady = true;
             server.Players.Add(first);
 
             // add second ready client
-            (_, NetworkPlayer second) = PipedConnections();
+            (_, NetworkPlayer second) = PipedConnections(ClientMessageHandler, ServerMessageHandler);
             second.IsReady = true;
             server.Players.Add(second);
 
diff --git a/Assets/Tests/Runtime/NetworkIdentityCallbackTests.cs b/Assets/Tests/Runtime/NetworkIdentityCallbackTests.cs
index db09f4885b2..fd0391f1344 100644
--- a/Assets/Tests/Runtime/NetworkIdentityCallbackTests.cs
+++ b/Assets/Tests/Runtime/NetworkIdentityCallbackTests.cs
@@ -93,7 +93,7 @@ public void RebuildObserversAddsOwnReadyPlayer()
             gameObject.AddComponent<RebuildEmptyObserversNetworkBehaviour>();
 
             // add own player connection
-            (NetworkPlayer serverPlayer, NetworkPlayer _) = PipedConnections();
+            (NetworkPlayer serverPlayer, NetworkPlayer _) = PipedConnections(Substitute.For<IMessageReceiver>(), Substitute.For<IMessageReceiver>());
             serverPlayer.IsReady = true;
             identity.ConnectionToClient = serverPlayer;
 
diff --git a/Assets/Tests/Runtime/Serialization/MessageHandlerTest.cs b/Assets/Tests/Runtime/Serialization/MessageHandlerTest.cs
new file mode 100644
index 00000000000..ec596bd3975
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/MessageHandlerTest.cs
@@ -0,0 +1,98 @@
+using System;
+using System.IO;
+using Mirage.Serialization;
+using NSubstitute;
+using NUnit.Framework;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime
+{
+    public class MessageHandlerTest
+    {
+        private NetworkPlayer player;
+        private NetworkReader reader;
+        private SocketLayer.IConnection connection;
+        private MessageHandler messageHandler;
+
+        [SetUp]
+        public void SetUp()
+        {
+            connection = Substitute.For<SocketLayer.IConnection>();
+            player = new NetworkPlayer(connection);
+            // reader with some random data
+            reader = new NetworkReader();
+            reader.Reset(new byte[] { 1, 2, 3, 4 });
+
+            messageHandler = new MessageHandler(true);
+        }
+
+
+        [Test]
+        public void InvokesMessageHandler()
+        {
+            int invoked = 0;
+            messageHandler.RegisterHandler<ReadyMessage>(_ => { invoked++; });
+
+            int messageId = MessagePacker.GetId<ReadyMessage>();
+            messageHandler.InvokeHandler(player, messageId, reader);
+
+            Assert.That(invoked, Is.EqualTo(1), "Should have been invoked");
+        }
+
+        [Test]
+        [TestCase(true)]
+        [TestCase(false)]
+        public void DisconnectsIfHandlerHasException(bool disconnectOnThrow)
+        {
+            messageHandler = new MessageHandler(disconnectOnThrow);
+
+            int invoked = 0;
+            messageHandler.RegisterHandler<ReadyMessage>(_ => { invoked++; throw new InvalidOperationException("Fun Exception"); });
+
+            var packet = new ArraySegment<byte>(MessagePacker.Pack(new ReadyMessage()));
+            LogAssert.ignoreFailingMessages = true;
+            Assert.DoesNotThrow(() =>
+            {
+                messageHandler.HandleMessage(player, packet);
+            });
+            LogAssert.ignoreFailingMessages = false;
+
+            Assert.That(invoked, Is.EqualTo(1), "Should have been invoked");
+
+            if (disconnectOnThrow)
+            {
+                connection.Received(1).Disconnect();
+            }
+            else
+            {
+                connection.DidNotReceive().Disconnect();
+            }
+        }
+
+        [Test]
+        public void ThrowsWhenNoHandlerIsFound()
+        {
+            int messageId = MessagePacker.GetId<SceneMessage>();
+
+            InvalidDataException exception = Assert.Throws<InvalidDataException>(() =>
+            {
+                messageHandler.InvokeHandler(player, messageId, reader);
+            });
+
+            Assert.That(exception.Message, Does.StartWith("Unexpected message Mirage.SceneMessage received"));
+        }
+
+        [Test]
+        public void ThrowsWhenUnknownMessage()
+        {
+            _ = MessagePacker.GetId<SceneMessage>();
+            InvalidDataException exception = Assert.Throws<InvalidDataException>(() =>
+            {
+                // some random id with no message
+                messageHandler.InvokeHandler(player, 1234, reader);
+            });
+
+            Assert.That(exception.Message, Does.StartWith("Unexpected message ID 1234 received"));
+        }
+    }
+}
diff --git a/Assets/Tests/Runtime/Serialization/MessageHandlerTest.cs.meta b/Assets/Tests/Runtime/Serialization/MessageHandlerTest.cs.meta
new file mode 100644
index 00000000000..482dac59e5a
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/MessageHandlerTest.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 12d20767883feb64ebfc388ed9dac57d
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Runtime/Serialization/NetworkPlayerTest.cs b/Assets/Tests/Runtime/Serialization/NetworkPlayerTest.cs
index ce826196c47..2ae59430bfb 100644
--- a/Assets/Tests/Runtime/Serialization/NetworkPlayerTest.cs
+++ b/Assets/Tests/Runtime/Serialization/NetworkPlayerTest.cs
@@ -1,10 +1,7 @@
 using System;
-using System.IO;
 using System.Linq;
-using Mirage.Serialization;
 using NSubstitute;
 using NUnit.Framework;
-using UnityEngine.TestTools;
 
 namespace Mirage.Tests.Runtime
 {
@@ -61,79 +58,4 @@ public void MarkAsDisconnectedStopsMessagesBeingSentToConnection()
             connection.DidNotReceive().SendUnreliable(Arg.Any<byte[]>());
         }
     }
-    public class NetworkPlayerMessageHandlingTest
-    {
-        private NetworkPlayer player;
-        private NetworkReader reader;
-        private SocketLayer.IConnection connection;
-
-        [SetUp]
-        public void SetUp()
-        {
-            connection = Substitute.For<SocketLayer.IConnection>();
-            player = new NetworkPlayer(connection);
-            // reader with some random data
-            reader = new NetworkReader();
-            reader.Reset(new byte[] { 1, 2, 3, 4 });
-        }
-
-
-        [Test]
-        public void InvokesMessageHandler()
-        {
-            int invoked = 0;
-            player.RegisterHandler<ReadyMessage>(_ => { invoked++; });
-
-            int messageId = MessagePacker.GetId<ReadyMessage>();
-            player.InvokeHandler(messageId, reader);
-
-            Assert.That(invoked, Is.EqualTo(1), "Should have been invoked");
-        }
-
-        [Test]
-        public void DisconnectsIfHandlerHasException()
-        {
-            int invoked = 0;
-            player.RegisterHandler<ReadyMessage>(_ => { invoked++; throw new InvalidOperationException("Fun Exception"); });
-
-            var packet = new ArraySegment<byte>(MessagePacker.Pack(new ReadyMessage()));
-            LogAssert.ignoreFailingMessages = true;
-            Assert.DoesNotThrow(() =>
-            {
-                ((IMessageHandler)player).HandleMessage(packet);
-            });
-            LogAssert.ignoreFailingMessages = false;
-
-            Assert.That(invoked, Is.EqualTo(1), "Should have been invoked");
-
-            // should disconnect after catching the execption
-            connection.Received(1).Disconnect();
-        }
-
-        [Test]
-        public void ThrowsWhenNoHandlerIsFound()
-        {
-            int messageId = MessagePacker.GetId<SceneMessage>();
-
-            InvalidDataException exception = Assert.Throws<InvalidDataException>(() =>
-            {
-                player.InvokeHandler(messageId, reader);
-            });
-
-            Assert.That(exception.Message, Does.StartWith("Unexpected message Mirage.SceneMessage received"));
-        }
-
-        [Test]
-        public void ThrowsWhenUnknownMessage()
-        {
-            _ = MessagePacker.GetId<SceneMessage>();
-            InvalidDataException exception = Assert.Throws<InvalidDataException>(() =>
-            {
-                // some random id with no message
-                player.InvokeHandler(1234, reader);
-            });
-
-            Assert.That(exception.Message, Does.StartWith("Unexpected message ID 1234 received"));
-        }
-    }
 }

From 79a5c9bc28ca68d7350a18923828a22591d1128b Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Thu, 15 Jul 2021 18:18:45 +0000
Subject: [PATCH 059/166] chore(release): 100.0.0 [skip ci]

# [100.0.0](https://github.com/MirageNet/Mirage/compare/v99.1.0...v100.0.0) (2021-07-15)

### Code Refactoring

* moving message handling out of networkplayer ([#818](https://github.com/MirageNet/Mirage/issues/818)) ([b2e9d96](https://github.com/MirageNet/Mirage/commit/b2e9d9693471097ac86fabd725bad8aa6b444983))

### BREAKING CHANGES

* RegisterHandler functions now exist on MessageHandler On Server and Client
* NetworkAuthenticator now use Setup methods that should be used to register messages
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs        |  2 +-
 Assets/Mirage/CHANGELOG.md                          | 13 +++++++++++++
 Assets/Mirage/Components/AssemblyInfo.cs            |  2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs               |  2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs   |  2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs              |  2 +-
 .../RigidbodyPhysics/Scripts/AssemblyInfo.cs        |  2 +-
 Assets/Mirage/package.json                          |  2 +-
 8 files changed, 20 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index 7722c75bf1c..aa42677c45e 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("99.1.0")]
+[assembly: AssemblyVersion("100.0.0")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index bd5540106c3..5d8e68ab757 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,16 @@
+# [100.0.0](https://github.com/MirageNet/Mirage/compare/v99.1.0...v100.0.0) (2021-07-15)
+
+
+### Code Refactoring
+
+* moving message handling out of networkplayer ([#818](https://github.com/MirageNet/Mirage/issues/818)) ([b2e9d96](https://github.com/MirageNet/Mirage/commit/b2e9d9693471097ac86fabd725bad8aa6b444983))
+
+
+### BREAKING CHANGES
+
+* RegisterHandler functions now exist on MessageHandler On Server and Client
+* NetworkAuthenticator now use Setup methods that should be used to register messages
+
 # [99.1.0](https://github.com/MirageNet/Mirage/compare/v99.0.2...v99.1.0) (2021-07-15)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index 86af9aab9da..18562b4c7ff 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("99.1.0")]
+[assembly: AssemblyVersion("100.0.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index a91ea2c805f..c2e8fd9c749 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("99.1.0")]
+[assembly: AssemblyVersion("100.0.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index bac50307977..70b1bac847b 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("99.1.0")]
+[assembly: AssemblyVersion("100.0.0")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index 7722c75bf1c..aa42677c45e 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("99.1.0")]
+[assembly: AssemblyVersion("100.0.0")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index 7722c75bf1c..aa42677c45e 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("99.1.0")]
+[assembly: AssemblyVersion("100.0.0")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 9a179b28a8c..06a0dccc607 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "99.1.0",
+    "version": "100.0.0",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From 0e5cccf1369dd915a2efabf8b4e0e2bb8fd40487 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Fri, 16 Jul 2021 16:06:24 +0100
Subject: [PATCH 060/166] CI: excluding NanoSockets plugin from sonar

---
 .github/workflows/main.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
index 5adb70864e2..1c28e02fff8 100644
--- a/.github/workflows/main.yml
+++ b/.github/workflows/main.yml
@@ -100,6 +100,7 @@ jobs:
             /d:sonar.verbose=false \
             /d:sonar.login=$SONAR_TOKEN \
             /d:sonar.host.url=https://sonarcloud.io \
+            /d:sonar.exclusions=Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/** \
             /d:sonar.cpd.exclusions=Assets/Tests/** \
             /d:sonar.coverage.exclusions=Assets/Tests/** \
             ${{ steps.semantic.outputs.new_release_published == 'true' && format('/v:{0}',steps.semantic.outputs.new_release_version) || '' }} \

From 3f34863b65325a54d6a4542c7b767fedc1abf406 Mon Sep 17 00:00:00 2001
From: Pavel Hodoval <pajah14@gmail.com>
Date: Fri, 16 Jul 2021 17:10:27 +0200
Subject: [PATCH 061/166] perf: adding native UDP socket (NanoSockets) for
 supported platforms (#860)

Adding native socket (https://github.com/nxrighthere/NanoSockets) that will be used for windows, mac and linux instead of the managed c# version.

This reducing allocations from receiving message and improves cpu performance
---
 .../Runtime/Sockets/Udp/NanoEndPoint.cs       |  53 +++++
 .../Runtime/Sockets/Udp/NanoEndPoint.cs.meta  |  11 +
 .../Mirage/Runtime/Sockets/Udp/NanoSocket.cs  |  62 +++++
 .../Runtime/Sockets/Udp/NanoSocket.cs.meta    |  11 +
 .../Runtime/Sockets/Udp/NanoSockets.meta      |   8 +
 .../Sockets/Udp/NanoSockets/Plugins.meta      |   8 +
 .../NanoSockets/Plugins/libnanosockets.bundle | Bin 0 -> 14744 bytes
 .../Plugins/libnanosockets.bundle.meta        |  87 +++++++
 .../Udp/NanoSockets/Plugins/libnanosockets.so | Bin 0 -> 17992 bytes
 .../Plugins/libnanosockets.so.meta            | 100 ++++++++
 .../Udp/NanoSockets/Plugins/nanosockets.dll   | Bin 0 -> 52605 bytes
 .../NanoSockets/Plugins/nanosockets.dll.meta  | 100 ++++++++
 .../Sockets/Udp/NanoSockets/Scripts.meta      |   8 +
 .../Udp/NanoSockets/Scripts/NanoSockets.cs    | 222 ++++++++++++++++++
 .../NanoSockets/Scripts/NanoSockets.cs.meta   |  11 +
 .../Mirage/Runtime/Sockets/Udp/UdpSocket.cs   | 103 ++++++++
 .../Runtime/Sockets/Udp/UdpSocket.cs.meta     |  11 +
 .../Runtime/Sockets/Udp/UdpSocketFactory.cs   | 160 +++++--------
 18 files changed, 851 insertions(+), 104 deletions(-)
 create mode 100644 Assets/Mirage/Runtime/Sockets/Udp/NanoEndPoint.cs
 create mode 100644 Assets/Mirage/Runtime/Sockets/Udp/NanoEndPoint.cs.meta
 create mode 100644 Assets/Mirage/Runtime/Sockets/Udp/NanoSocket.cs
 create mode 100644 Assets/Mirage/Runtime/Sockets/Udp/NanoSocket.cs.meta
 create mode 100644 Assets/Mirage/Runtime/Sockets/Udp/NanoSockets.meta
 create mode 100644 Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Plugins.meta
 create mode 100644 Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Plugins/libnanosockets.bundle
 create mode 100644 Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Plugins/libnanosockets.bundle.meta
 create mode 100644 Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Plugins/libnanosockets.so
 create mode 100644 Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Plugins/libnanosockets.so.meta
 create mode 100644 Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Plugins/nanosockets.dll
 create mode 100644 Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Plugins/nanosockets.dll.meta
 create mode 100644 Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Scripts.meta
 create mode 100644 Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Scripts/NanoSockets.cs
 create mode 100644 Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Scripts/NanoSockets.cs.meta
 create mode 100644 Assets/Mirage/Runtime/Sockets/Udp/UdpSocket.cs
 create mode 100644 Assets/Mirage/Runtime/Sockets/Udp/UdpSocket.cs.meta

diff --git a/Assets/Mirage/Runtime/Sockets/Udp/NanoEndPoint.cs b/Assets/Mirage/Runtime/Sockets/Udp/NanoEndPoint.cs
new file mode 100644
index 00000000000..2e3240d6689
--- /dev/null
+++ b/Assets/Mirage/Runtime/Sockets/Udp/NanoEndPoint.cs
@@ -0,0 +1,53 @@
+using System;
+using Mirage.SocketLayer;
+using NanoSockets;
+
+namespace Mirage.Sockets.Udp {
+    public sealed class NanoEndPoint : IEndPoint, IEquatable<NanoEndPoint>
+    {
+        public Address address;
+
+        public NanoEndPoint(string host, ushort port)
+        {
+            address = new Address();
+            address.port = port;
+            UDP.SetHostName(ref address, host);
+        }
+
+        public NanoEndPoint(Address address)
+        {
+            this.address = address;
+        }
+
+        public IEndPoint CreateCopy()
+        {
+            return new NanoEndPoint(address);
+        }
+
+        public bool Equals(NanoEndPoint other)
+        {
+            return address.Equals(other.address);
+        }
+
+        public override bool Equals(object obj)
+        {
+            if (obj is NanoEndPoint endPoint)
+            {
+                return address.Equals(endPoint.address);
+            }
+
+            return false;
+        }
+
+        public override int GetHashCode()
+        {
+            return address.GetHashCode();
+        }
+
+        public override string ToString()
+        {
+            return address.ToString();
+        }
+    }
+
+}
\ No newline at end of file
diff --git a/Assets/Mirage/Runtime/Sockets/Udp/NanoEndPoint.cs.meta b/Assets/Mirage/Runtime/Sockets/Udp/NanoEndPoint.cs.meta
new file mode 100644
index 00000000000..3f31a9c0d29
--- /dev/null
+++ b/Assets/Mirage/Runtime/Sockets/Udp/NanoEndPoint.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 7d74e3a6115406f41991c18f4fe16427
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Runtime/Sockets/Udp/NanoSocket.cs b/Assets/Mirage/Runtime/Sockets/Udp/NanoSocket.cs
new file mode 100644
index 00000000000..242913a13c6
--- /dev/null
+++ b/Assets/Mirage/Runtime/Sockets/Udp/NanoSocket.cs
@@ -0,0 +1,62 @@
+using Mirage.SocketLayer;
+using NanoSockets;
+
+namespace Mirage.Sockets.Udp {
+    public class NanoSocket : ISocket
+    {
+        Socket socket;
+        NanoEndPoint receiveEndPoint;
+        readonly int bufferSize;
+
+        public NanoSocket(UdpSocketFactory factory) {
+            bufferSize = factory.BufferSize;
+        }
+
+        public void Bind(IEndPoint endPoint)
+        {
+            receiveEndPoint = (NanoEndPoint)endPoint;
+
+            InitSocket();
+            UDP.Bind(socket, ref receiveEndPoint.address);
+        }
+
+        public void Close()
+        {
+            UDP.Destroy(ref socket);
+        }
+
+        public void Connect(IEndPoint endPoint)
+        {
+            receiveEndPoint = (NanoEndPoint)endPoint;
+            
+            InitSocket();
+            UDP.Connect(socket, ref receiveEndPoint.address);
+        }
+
+        public bool Poll()
+        {
+            return UDP.Poll(socket, 0) > 0;
+        }
+
+        public int Receive(byte[] buffer, out IEndPoint endPoint)
+        {
+            int count = UDP.Receive(socket, ref receiveEndPoint.address, buffer, buffer.Length);
+            endPoint = receiveEndPoint;
+
+            return count;
+        }
+
+        public void Send(IEndPoint endPoint, byte[] packet, int length)
+        {
+            var nanoEndPoint = (NanoEndPoint)endPoint;
+            UDP.Send(socket, ref nanoEndPoint.address, packet, length);
+        }
+
+        void InitSocket()
+        {
+            socket = UDP.Create(bufferSize, bufferSize);
+            UDP.SetDontFragment(socket);
+            UDP.SetNonBlocking(socket);
+        }
+    }
+}
\ No newline at end of file
diff --git a/Assets/Mirage/Runtime/Sockets/Udp/NanoSocket.cs.meta b/Assets/Mirage/Runtime/Sockets/Udp/NanoSocket.cs.meta
new file mode 100644
index 00000000000..c2c70c947fc
--- /dev/null
+++ b/Assets/Mirage/Runtime/Sockets/Udp/NanoSocket.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 0ee6e75d87a3b254eb4493bed30c7492
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets.meta b/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets.meta
new file mode 100644
index 00000000000..a960b724052
--- /dev/null
+++ b/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 8e256027de8f6d04e89f606457f3f782
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Plugins.meta b/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Plugins.meta
new file mode 100644
index 00000000000..440ac3996b6
--- /dev/null
+++ b/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Plugins.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: b819f8e6012f0e640835ffd5df519df2
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Plugins/libnanosockets.bundle b/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Plugins/libnanosockets.bundle
new file mode 100644
index 0000000000000000000000000000000000000000..34b7133e726b02782c862c4e447ed3dc4887bb61
GIT binary patch
literal 14744
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
PLx~N4+Ib2O7Q(*)rm9#V

literal 0
HcmV?d00001

diff --git a/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Plugins/libnanosockets.bundle.meta b/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Plugins/libnanosockets.bundle.meta
new file mode 100644
index 00000000000..02616620927
--- /dev/null
+++ b/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Plugins/libnanosockets.bundle.meta
@@ -0,0 +1,87 @@
+fileFormatVersion: 2
+guid: d8b22096e0cd05d438a5ce5c8c476dde
+timeCreated: 1534525764
+licenseType: Pro
+PluginImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  iconMap: {}
+  executionOrder: {}
+  isPreloaded: 0
+  isOverridable: 0
+  platformData:
+  - first:
+      '': OSXIntel
+    second:
+      enabled: 0
+      settings:
+        CPU: None
+  - first:
+      '': OSXIntel64
+    second:
+      enabled: 1
+      settings:
+        CPU: AnyCPU
+  - first:
+      Any: 
+    second:
+      enabled: 1
+      settings: {}
+  - first:
+      Editor: Editor
+    second:
+      enabled: 0
+      settings:
+        CPU: x86_64
+        DefaultValueInitialized: true
+  - first:
+      Facebook: Win
+    second:
+      enabled: 0
+      settings:
+        CPU: None
+  - first:
+      Facebook: Win64
+    second:
+      enabled: 1
+      settings:
+        CPU: AnyCPU
+  - first:
+      Standalone: Linux
+    second:
+      enabled: 0
+      settings:
+        CPU: None
+  - first:
+      Standalone: Linux64
+    second:
+      enabled: 1
+      settings:
+        CPU: x86_64
+  - first:
+      Standalone: LinuxUniversal
+    second:
+      enabled: 1
+      settings:
+        CPU: x86_64
+  - first:
+      Standalone: OSXUniversal
+    second:
+      enabled: 0
+      settings:
+        CPU: x86_64
+  - first:
+      Standalone: Win
+    second:
+      enabled: 0
+      settings:
+        CPU: None
+  - first:
+      Standalone: Win64
+    second:
+      enabled: 1
+      settings:
+        CPU: AnyCPU
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Plugins/libnanosockets.so b/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Plugins/libnanosockets.so
new file mode 100644
index 0000000000000000000000000000000000000000..4bddb3af5dad5134497e3ef507ee37247719e036
GIT binary patch
literal 17992
zcmeHP4RBl4mA;nkL<x?hgg*mWqNavAkO&z{2%#ZTVmr^&fSVsk8j7OWQliC{T<IAc
zFQEbxwju;FEyJ+wb~ejzD6o?$EP*Tya+2n!Ww(YF2tU($mzI$yP#i*tNkg>Xx$hqN
zy=N&yJF}hH8DGzP=bi7KbMCq4{=6UE>+dx*H#*A71gCOwwIFWQWCIDP3~j!;011dW
zVgk-n#d%V;VkB$S)fSflF%=$zr!p$(Qt@_r?P-P_Q_d$nS)SL(7dDzLH*ltAy>ZCO
z%`)<H^Q?5g!{GZBWj$g^Z&>LKD?O$I<PZ{5r@=}e$<H~;o}JbxIi|8sz*_#Ox5;a-
z60p%d3TDcB-+~_b`DGJ_eX%O9R9vc+|4dbNW&O@TVHEB~*DVvVMHj#O4-0-YbLxuU
zJhA@SM?W1{&@hvHxc~=+j`hwWP^GUbdJ$+94w5|^hiXDW_Ng0I<M=xq<jNErH8{@2
zaWRhbad2H`;F{9u1`*Wt&ctz!;)!sKye8~am$HvSV5$<D0D2(~io083(?O}SUsF7h
zX*eb-ev+a@zGAwr#WnSp@g~fEsfGbYnvpmj6bsU8*?e&S5AO|D&hQ3B+4Six6f3GP
z#fK8<vF{Ws@{9cC*i+1@KI99v1I6^{6LaTY9MvEHTB5)E>|Z^9^xsZ<{ihd{KeqCy
z<M8pVnWvB5{{8o-x&2R_sQhB`9YZf%^vS}O=Z?l+`NsL)dw+K1UoLs+p>6%s@B8uQ
z$=Z!uns1$bVo@Nt?MXG8z_=|v1)kc}o~TW|b`bnea1=B4TLh$-ot2O;hJR2({y$6L
z%SzbkDS`jI1pb2(IE@c44tshIKr#RKmhkiECGhnqpqQO|O4z@@ggo_gFAjT(11M&{
z5%_ewF!*o@`QMlD{|4#LB;lbBj<nby;$A5~Nerk#&t*NO<o(Jiurk#vc@IqtNYt*B
z&Qy56!k;u?@usrVuk6!2MQMhTPpb)y<-f~*D)}1>aj{IvcPjhK75*OR6fsHo)qr&=
zN2`^c0h$nzcy6P4U&<@|8JUauNZAk2q=~fKAmR&9lJ8V;dr;vWO5UU7+5ShWT(627
z&&5wD`K&Dtmvep9Bzv~<f0x3ClpUUr?oxQCveTgac}U>_CC~K|q0pL+L_Czz!%009
z5}~H0*M{06$;g^mN{=L$Uc0b85sxeluWpYRdBt-=t=-{JG!_rH$9f{7wLOuFh-hnE
zZx_*IBoc0GOUB~Sgjf^N&DZg8M}+ZIqV*QyNrtWyow|s{XOnm+9AAg)h#rdTiB99H
zQ%}T2N2H^5ZBoR;@dT+rF+}o_R4N23rSQ<&L`s)Ml~4@DI*aPYQlZFqyTa{7GgENy
zl!i&bW_Wch-exh@nuy0Etya%llaa6<v52)HYB4=#1lwGRwn$1(Ce~Sm5s46j8AH6x
zq9rVJCfcp_OGa8Fv0JU>D=d_VMo}w^*;K?<B?5{I>Y=toT#qKhYdRuvyA`x`BEGsE
zts0B3v6WD$5B#__noM+vRHU84MrG*<kU|eKx`jYgsH3#UR=4_63EynGG6e&eSk&CK
zU}5M|-=)6GX~<wW;;{c&u@SBe&tG5u?;{xJXR5AqV|e6ohzV*U;OAz3&h@DAIyBE1
z$c*=^oAlOz6=(jSdY>34>tV>ydBBA8+(UTIg!3Fs_>c)#QwqUi*o3PoSK`$HN#wJW
znyMt=HR1eBO&PT&oSy{=_nUC41E)Cw<BFcm=-?Cx7*~XGj0n*JbT(uW=t61<7?&hJ
zv49G(+=TP9A!V;J;pXSfwI*D>ijlbJG~xUlOL(^l=RQDq+Ju{*zrJt6RaYQ!vDt*H
zTa3gXHsR)Xfh{In-P)x5*y;Z^0!Q5EAJ=+6bZQ$b-@XLhaYI&j<omVWJx=2ZB7gb+
z0M1|V2b|s00=Oc6EjcwfkVm@U9pY&y4fad^b>bbwXC?nj;%O)kZj<~j;%SHtZjt;B
z;%R6NZkGJdh^HYnn3nuciKk&O*eUr(h^HYmxJvRrBA$lMV2k8`Ks*hZ!GPrNC7y=L
zpkMNL5l>UdpjYxe#M6)&^hiEQJPnmWA^E>2-c9__NdOnDCZ2}I;DF@6O*{>W!G6g<
z;u9je8N5u|rg=>e&^A>rAadofekMYFGh`^#6Y>M@X=xJNttjNrk@A;MAu{8nmKoCe
z{xo0f8!p$%_G+)4)X#u{%as9Vejw_eRzIRo?U|nU2C_xh#mltbc~j_8%luKV(l*X}
z0ZeWMYLRQhX>aAT;LE;)vJ2&t{@`uMRQ}XucSn8hX?K&4=m5gPq1<Il(0i&gx7VDJ
z(Q7=fP~3MqFvHcop8IcvLu);_;oa`rGr!nZUn8e&ZBuhi)lPca+;J{W!566~WcKBr
z|018?knIXk{uw)|JMEx0SNR|39yId3l<zU}sSgzLb(ybE+3?XF<1-)U9tW%K+l_kU
zwah_u=jxSI&45^<W&W&foUd)j-%*wOo|KZenU%YZIHESS?i;i285K3|$?!S4ucBrm
zny<dbscra7_qaXd+>?cSd!r}XmvtU;Ya1v1(@aFhQwF#$8_m?$IJC?MJLsJ|_W;@N
z-BW7{8rvt^8iFF<&7-(*PJ|KIuCMX1buu<l+oabx4RfnTo7>!y>p79nA3JzXc7?28
zOYR*jpE<mfLcD|SI(6CHO~|b~&^w%WKiGHd?aclaCf_JNEpVlR!cT#&FdFLWLZEY#
zOvclIg?8tM4}&yij?1XsU6Tgqo>5=ZNvBnGYN1nrPJTLh>EvmqcC5?3L<6Zg^Xn5w
zw5MOBV(T-nX}=k0#<}lvbo#-$&1G~sPMc8wsz-b2*T<H;|M-vhcxhA|8`LuWT3-%g
z$H!}ByR^(1HCk*}4(+MU*sI0%%Bu`Q8|>Xx)|45jd%f;Jedev^%zx$H_%mAO&OPM1
zB>=+QKGX@Q(a$qFfodM7xp^GO*IN5vyxCp9x9&jjC2CMD^QM;BmGe*`*5=<#_R0Cy
z!&=#!6f)`vMnTz;f&{@RNJB5{b4D}G=u{iBO|AV#L0K*+_v~?11P{?AXb_rww9Jve
ztU+jirb)52uNl2vHc(aF0acZMr*byDt6%Njj&|$)e4;+hz5PJ%=Z>zK+CDje_ANvQ
z%jY*@_-4LYb;#-V)YnwICzq4L6r&d3^dRKqoE&V%lw$ICBqlSybT?wJ5gN1CxyrwR
zzkg+XF`hlzrlmDix%B7xJVv5^u?%Wmmclwqg>`E2u%7jzoYFXqrw%fW=OgaKcpR>%
zTi+jbztuM{pU0h{%Dw%1jK1hq*Ln0xX_D_h!5fyeG-W=+EV*+oTB<p7EO+HFwS86}
zFK72dXInkfdUsd7Lbv;7(t0O%3#5C8%g)KtGsMc^&6eSX`2|BZb6CT4vHiA*cj68K
zZ>~zu6<xE_J!PWHpYCypu8Yz=<)W)5-BTgD&QJGLimvK(&p6RFCEYU~&Zm2vqHA2b
zXM)hDOP^#X{bi;vck?mB)rvYyhq7KPc5A)63<nERa}24jca+4)4KBJF^~Vs^FnpRa
zCuIv;rY)MX>AoXC<zp?iB$~6i##x8z|33FBY-jqU;SC3LCxW0+5VVcA(+woAU#(?^
z&E;tuwQ3ELr}uVyJjqELTPk{wPt?P`#~pf9+Zd=t;Je->#md~BFfAK}%6aTFOQTdb
z?UQdI!F`Q#7&i6p<x2mqIrB;G4Ty8ANQc~>pfl*6Jnqn0HqDK}ieRR(Dt9_ctD{Dg
z;<z~)<8@i^Mk7SE!OUBTl9u^`XR*<@v+?S7wn*MA<?Rf&Q;MIq3GvuTb7ezawt=RZ
zcj_~r=T08Y=Yu<`i}wzn)GyqSb#F+MG-jUe2Hdh!O|5SkasC4&DK_CltKHihCK}!P
z8|n4vPP5ba*omIBUiPH*vL~&VJ!!q{N$X`#S}%LjdfAiKqbJQ!J?T%%mD7y^^zw$f
z&+0K@V;)CC21DOLhx&yP+e5Djj4$>4jNZN*u8yU#2#iHwECT;uB2ac-`Bi)1EPZqF
z4(0O$pe={<c_$vmy`SXsUQj>i*FgiI8t4#cC#dI0K7Su*C+K6KS<sh3`$2yTIsp11
zsOQsso_?PQfKCPVU}~k`!#hD+K>I=Ii$NMUsrx|vxb<uU9RPg~)PqNgA<$0HYCLRu
z@Z9tbP(L2>((>U`$lr?Lx+v>eEXuk)W#?6mcWy@6HNfaLGw0)c-Va{5JdLjEYuu;Z
z=1hzE=U#QuWi``*O8t7!0Ae6-@B|{!`^il>hJmZ1B-RP+Q($D05|wi|jv-*r5D;{E
zg0AX%m%q3C9*5&mSG5G3^fL_QcO%C10!(tfj^!>YlO8Dc<G3Ap@^>R>JHF*|5<Y-q
z5AX(1L3qHxhrylzUPU-;T?0!b?}1~V7Qt(Qe+XPw8uF`@d;oX_+LhkS$<7+!<m+<a
zQ-SX$e35HQnd3hSzUs*9N8U2ZBcECfpQuk%qwSY7zQpD9;+p!%D&S8Njxxwxufy>Z
ziWJq~i(@}zK0Jj?Eo7)qb)zqFoRyusrJW#*-eg#$wxe|mCm<{91)kbzCa`Msxy85^
z3uHS5UEbdE`yGyJWIHV|{9OvU7RWtFa`4v?b2&j8<vHwf1^{<M=2ghZ-@Oc5^{!RY
zRx{fQx>h+hnV4Jn8v1i^ybK##(f8$Ve<)yqt9pUU8+6syyIOiH@2_}(deA4XS~w}Q
zC|p5T3pB^lSOmr*FcyKa2#iHwECOQ@7>mGI1d2z1*J<#&3_L>1L~A`LxeOwXDPF!$
z5JnHtNW7*XpcbO?np$2DqTs^X2KjCSJzf_=?_iYZIiFI6LBuLm-qDl!1VP)>OBVeg
zOlgZ!;58QVmt)}cLnEa#l{~M7pm!EZ{H`Vfk`<~Lu}xK+-jOKLkBpRf&B2hWIOBfB
zv)@@MEwKLGNL(JiWJ~`&N*<puCC_ojYoX*{P>$jiR`LZumA$_;;dSixa%Zb{Z&dUK
zMWc$|s^~q6KBVXqioT%eUPa$j^aDjdQ*@kKOmdc@7b-ei(MCnL1`H1uEnGO)Tf1y^
zS6uJ%Ug^8c=bu$~MVDmj?zq(N^M8GY0b`M0IKIYvYb2S%(lYNAKEJPSR^6rET0Oib
zb;;s}=7!*shR_xMx=ZA;Kz={8$HB~(i?YIcek<-M^kXYtUg*zOyuw%kVFqzsjvW!)
z-_2R&Shddm#)^*@+~2IYQ*ghv;uFMBVPKEsl+$QZ?J<IqKc@+AQM^jDsCKc+Pb%yi
zvEnYl^M)078!!E45ZC2!X1~`4N_?{5`No`Ejuoyv&sg!(MX~-}jxQv<{>&<mm0|%i
zVqBMtvjq1)b8b0ijcrBcc~%&arg@-39LCRG)<n(W!0gKVZ8(?aW5PGv;`|kb^E}S-
zSKy+|<PXm~jS?RnpAKb*?+a{aos=IP=ZAq8^S@NRo{)At;^nWh<q=xU&hyB2;4WnE
zCp)B_(ed9W@zL$uFN+!7uijU7?Ctfj#7DP#B`W49GA>R7K1G&cJx!N5)~Bl*3(qI>
zfqSi@l3S_d{p!Z^jFL$Kw>7!Up>Jx%%B62=#qjOQzJ2}muM}=y|NdSHJ3~s|zAoNa
zZ$7$W^u4Xvdh^R9K3cx91Rg4Zr<8q<ZGHXSCFK8E$=lbhKL^}9+8wd0gq^ob;Pm_?
z>#G)-E>|`yabqXkzF)zsaIb1KurghtaQi-h<q}syCK6Zj9^1P62NZ5!U;n7W2ULIK
z{+TUd|8*sA-{0_&!UL+G?^ZsYEMeztJm^sz0;;~;&o7d=sY2><K5*}7SgcTX{K^ix
zrA)~Zb~Y;ce%pS9M}SW+VxJaC6&ptfl^y&3l21#>i`Jx`(z~KjU#l3|rV!FQLfCW=
zkEF1lp)C<w)1FuzZVzEGcoJIzy1GScqNB4tqDR_%bNsXY#f519LM#+cCd2DOSdgAv
zhrJ8fkPvF?>gZSp6%!Yt)$<ln^J?-|2sbVcUfU3AxUQb|RFGjRGnELf4aeJPD@FZ^
z>w?!dEd+|)eW3<TDQNYJ0b$n#t1fE3enGG~bbVvvl7^+BrNITw4KPT>kL-vD1k8)q
zO`e2k&w*u;{i(Khm=(?2C``LBtR;=Cv$x`M<A)V8+b*_AL2er`R_T{k<gEzCGXK(Y
zCg*9#h1`u|mByY3-g{!rFm{w!F|+S-$HvGGmC}L~d9~}pw!=nlWTEXVR%K%ggB3HE
zTxuT$SC$I2Z7-o-Qe=||YtY7!!j2W*N>SPYR-=LnYGx0MZC+ue!qyoIVCgbWv9UyM
zOi_`iwkvH!ZJ1H+Smk8@FS>=vTocRw8k9-3pnXbKTV@T4Wudvvd!ei<=FL#n9J4Ws
zuzB~3v5CbhFMO$W9eQ{*sGc<FTE2=W^oVawyvw(`E7smNE7m3?w>F$wD|~J1;?Ojx
zo-}gQOPqxXAukze50iqr>TK7APfk5PT>91|!0M51oaF@Pi>y_1<k~hUGiRt6lcgca
z*RUM!h_#~FgiaRWR9FuS-|AFK_%LJ3Z9zruC4UV>-%se910E-2qTk0UF|9G!!Wp+8
zOS%*seKTSGRqBFii@IU59)HhZ9t*(*eu7M}K7WT{`l2e0<yl|B@^?)7w88rPordWg
zrAR)KE3D6NN&#Saged6qdoWY}&I1vd`2Nqlh70=U!sYY(GShD>LH3{Jn9^_9^bLo3
zey?WgRr+@S6)f6tLAF_+-@ln=l^~aIuYX+WFHmwr>OGw)f43ridepS*cLSrC@OQGp
z`@DL8=kIe6k%|3aK7|XjKEL-f_1gl@p9PrSVbkaD15DXpE{}Pp|7g?a_hF{Lo4}d|
z<#HL_WYg#ONT&S#lI897|Dn?7_7h$uspuZXGO_FbD>5iVtk2&sm=1G>GQjm_dr#wn
z-uY<^P~z_#{C^qj^2{^c4jsJp7WDah$j~gZHqu`VZiHujdXA^Q!{zgL6aK#!1FHS`
zyDaN*JKP0b5@CJ*zH;yqfJn6lDV$lK>8r>w>x+OA^&51nVwtcW(>IV|*5~gvTa`Y`
z+4Y%!7Z)VM{%;EyIonF;t8f@XI1k_;Oo`*lNUYEE596$FrnW93MLl(fMnF}7zN^o~
s!S&(!lZFTTZfF?imMabF<c3q3TrSJfH-}>S%W3lm(x5>KXS@FY0@)?iF#rGn

literal 0
HcmV?d00001

diff --git a/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Plugins/libnanosockets.so.meta b/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Plugins/libnanosockets.so.meta
new file mode 100644
index 00000000000..84233df84b1
--- /dev/null
+++ b/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Plugins/libnanosockets.so.meta
@@ -0,0 +1,100 @@
+fileFormatVersion: 2
+guid: 2c08207c2b3231b44b4d0e0b3f192720
+timeCreated: 1534085982
+licenseType: Pro
+PluginImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  iconMap: {}
+  executionOrder: {}
+  isPreloaded: 0
+  isOverridable: 0
+  platformData:
+  - first:
+      '': Any
+    second:
+      enabled: 0
+      settings:
+        Exclude Editor: 0
+        Exclude Linux: 1
+        Exclude Linux64: 0
+        Exclude LinuxUniversal: 0
+        Exclude OSXUniversal: 1
+        Exclude Win: 0
+        Exclude Win64: 0
+  - first:
+      '': OSXIntel
+    second:
+      enabled: 0
+      settings:
+        CPU: None
+  - first:
+      '': OSXIntel64
+    second:
+      enabled: 1
+      settings:
+        CPU: AnyCPU
+  - first:
+      Any: 
+    second:
+      enabled: 1
+      settings: {}
+  - first:
+      Editor: Editor
+    second:
+      enabled: 1
+      settings:
+        CPU: x86_64
+        DefaultValueInitialized: true
+        OS: AnyOS
+  - first:
+      Facebook: Win
+    second:
+      enabled: 0
+      settings:
+        CPU: None
+  - first:
+      Facebook: Win64
+    second:
+      enabled: 1
+      settings:
+        CPU: AnyCPU
+  - first:
+      Standalone: Linux
+    second:
+      enabled: 0
+      settings:
+        CPU: None
+  - first:
+      Standalone: Linux64
+    second:
+      enabled: 1
+      settings:
+        CPU: x86_64
+  - first:
+      Standalone: LinuxUniversal
+    second:
+      enabled: 1
+      settings:
+        CPU: x86_64
+  - first:
+      Standalone: OSXUniversal
+    second:
+      enabled: 0
+      settings:
+        CPU: None
+  - first:
+      Standalone: Win
+    second:
+      enabled: 1
+      settings:
+        CPU: None
+  - first:
+      Standalone: Win64
+    second:
+      enabled: 1
+      settings:
+        CPU: AnyCPU
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Plugins/nanosockets.dll b/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Plugins/nanosockets.dll
new file mode 100644
index 0000000000000000000000000000000000000000..f0b0fa47b99c49ebbb3b96cdb13411c8517ee909
GIT binary patch
literal 52605
zcmeHw34C1Db@v@fW6SG|jRj%}3`P!Su{<`i5nGs%H1f#NGH9`7FnN-tku+GEnal#V
z3q&Bh@nmqS5ZX8i%_p4Azb0SfPy&Xei40C`64D4l8#mBINk}SJG&N)sOQP?8?(&v-
zk_^i7wT<6TPxsz)&pqedbI(0@d2imWyLpi1GsX&VPfjv+7$IFg{(t6w{m5Q?(G!c=
zBlEs}@nJ{pw=Zt)i6lMoM65f}-skCPk49rD&$h59k&b#IQBPGvlcz7%87^J4Xnu(#
z9SShk`Ik%BZ;w3Q#(EhGK#)`Hot_1Gc_r+fK&r=`$JpIV5xS|+uHQH)pg7<pH(gFj
z(B(t!9LB01aiCspNO(9{l%*&qq6a!;h_QT9#39B?<`Pt1amHShq&Z}iu{N1CRnQ+|
zY~>Ug6JKQPAQya!On^#L;T<W2$5-GViAZ%vJ<L}d3$>MYwx`+w?57MLZj$Xv+@{ON
zLc^sAi8v1#kcrL5U1~x?)W_O<tIGt8>#+@SqE{|p>c5Y9hfCvv9@hnQ!WDn5!Vn?w
ze5E@C-h)J^A2$(x7jDzV@wO$C1fmvVgQiSVw4b#NmxcvB-Zn$XBzhGlBt$vAh`{4*
zcL=~j+|@R`;nK>+W`efTzhT@YC)t?k@-g3VX{wjY=O*|FZo&&u!ninIBHSD6kTx-j
zJi==<a3}`(Dps!%ismFv0Z4dU62cG{+O1;s+G}_se=!A6jvK)y4$}Ymn7d+i*&3ey
zEd6%_kLY!Akp7S3ty{;_|3?2k60b)`;Sr9v{%Rh-i~f5h-fbMD|06s-aVGM=LIW+q
z%uj;@FMERf7CHJE8+&j$W5I!=o?D;dIrqFgglYyeb?!_{acw5x8Mv#MrB`H~N8iWT
zp5eQfWSvhSHZbPMIKPO<_<TNqoIDTa2vmn_4|VY1vA`H<>sa7LFM@2~#c(hSs)3PU
zmTq4m;-kj`ZxYh@#Q=^4uM3Q(=K+M`Y&`Jz7<_Xu>)iJchAEVA?)H;df#bj(MK}x=
zoO3W+Hw@U}V7BG>si5nN^N~3g9Jp(Yr4ORmttggd0~3z)!pAQH<*^4Z2KiOUspL6(
zhSMG-)+2F@dLMWeMUV()7d0Xn3t!B|I2&<62G~U_1;P?Ss1gXj@(}^*lLL3X$<h~r
z=5qiAGl4^p^dR6M*#e1>e!qJV*#ndfrR*6_U4UdtCbKP`n#{-(L<v=MPmW}rHFtyR
zFcj`X<mBg&Lyh9v^AO=23y^bR<BOHXZW)pqYxE&I6Bq)@eg{wx4k943`ymHpXc<x(
zI|YrMV(BkKkSkD(s+yOQ8oSK{^5w9XXW=WxR*=19olamK12LW$yAeSquooQq1*oMT
z9QIO84|CS{934W2v@x<i!@xkS*k=%H@ni$V&_L!%s{R;_h$izKc-d<zDy;<+HbH`H
zOL4}{&Gqc8vk0=HZ5K)#J4qgHEPA#u($pNF<)u5J0V}uH-khAw1m2`3bnX5%vChT#
z#|s&g80ivW@XvC*0Ge(12}DW1?y)a`(#gk=BAm2yEV5_{VuOkpPy*a;ZiL#bgnEHv
z171B9@OrSM>hs#=r+qfr9fF+=o{xgil}q)<xr5^cgX0b|(%;=cEi;KL8+a4#;I%d(
zNV#DchyMb~{W!_Q9m$~idaA3d)OFErQVerl<YQ}w&5*9a7Ju`mCOD*(!F``E=?4<%
zwO$7kF1qb+8LP=0r4Dj4fR!AW1~8aiw~2y%MHPV6W_}dRIKvQO@?QW7D9}?#W}NT1
z0*HHFNUs6~KT#hzy7HFy__yAAvJ91ST?8u52x7r~?`WhT;~c-7lP&{6l==2X(EaZC
zkuFsS-G64CM+g(r%>&-22@ig1(TlqX_;kv}brGCg@!<!l;<{=!Z4Tb^GIfeIzYgxZ
zv&7>+Or0~Bd2P*eW5X9<NPj#pFPM3KvZx7FM5`=yJyuoXxgie@A+=z#XdR$mg`ks}
zQ^9+V5*_V5PZ=8S8U)8Bz|rO11l{^FwI$bQnoG(bKL;w{z9q0`c(SOUw3zt@>fqXY
zA99XWmGDUmLJv*5YWLNalm#=dJaHKk{=?_v|7206kZYqE>3Tw<)r9}B!%avR3ZxZg
zq;dl(k0ZSX%|Lxc!9Bmedmb_;i(-HTk9~vc7eoaIj{3}%b6r%0sSzK%GXE6J&V!oo
zUNl*BEiXilf-Bitg5&#wnSXL^9(G-ZdbyTVm0a0Ha-D<rttwd=-1A&&smq<`TEbk9
zZFEl-EeE}E7n<_DFeR7Ufs8f7U74zq<-vW;C2(D@_zz#eRdM*^n952im3?r1OMYNg
z5(F!*RLPTb0$aiBQBatYbf1Z|rT<V@$ySwwAdhFVh|2%w#JR%|V&zj@KfEguLQr7T
zS}~xamsh$TeG-`^wWxl{6L)tN^iLKA%xD&S8hE*!ssKwP`!MW68U;;TCyPpr;^iiD
zgxzo2+ysO7!F)5{g<8nw%l(H7krp=p%()axmH0rsoR|bVo(e{ef46R%JDB-q@W_AM
z7(DXYI~~u$guRicX;yIA@yIZRs6yGmHyqT67!)8{<`r}t7<ORI)00K_eT>@Xo}<M1
z7W5IleKxm{yJ@Y;e7iPtESQ0l_!ij)+Uj~T5HH!oh16KybI|&8D5Ko<SUn759!OGS
zt%bn~uCA(YaL&M9NhT4@{3}H8XU4b)OSlLFM_X^Xl?%`h4CddoNk|al5}^F|AVF33
zk&+?g&LGKLDM<q)dEZBsBpqK5I?#dPzesdf6>0=cSmb#%kU7QWxd)}lTtg&}pHxEq
ziTu%Vu!bslAK6`Uhy=N8w-5*+%^E1(&%>&cIO(a4{)OltwcPcTM>4<@P@h7~$0e!F
zJQ>Iw=j>nIk2X67-KB0MpXTctm^df(4*btcmj;jV{(G#t5Y{va^R3EMFB~s)xvNTo
zt|fC^kJXk`Ocoskg|1AsJ2QcXC7GdCv;5iJB{YYt>3Fu*@#ODanLDX6cT#2Uq{@)5
z&IsFD`Fq#o2OqK51TI^($6?Z@-X23pk^WED4%~dv7+3aFari1P_3$evi+tcVFfp0B
ze9a_j-pe&#!Zp9nruj0`yz6V^gU8RI1}K*euy(TOQnT13q-F5o^8dmWbKsue<w_mz
za((Z}4KysI7rGv+al?yVx6z$)9wyqbJ`$7cj|PA0hu;Zio_*q4z{b8%gbHA2n9B#O
z@pFR5_zumn4ct6}1IHFVj&2PVy;_r*z&Q3dR6mDsgBFo69&+j<@FiUXJLgZPuj{{-
zrPufGa<H_we^(w$U*5kfpQTIscNMVoh5fsnEM45cYYs~<?cX&Qg7@z#Wa&BmyXLXf
zJL)=)bAd3^n=Hx)Q<CxGHNyJ_2cBF=2qYLs`0-zJg!B)2eWi!y{&3*sHqq_5jjC?M
zn~#Qzm7qYrmJb`$glNZF*kR_`HP1~Jb%1Q<2&cK{Y1f`lksh*?jnwWIN@b3pbRiV>
zgvA!JhErDsvmp=pwx0(FcDUV%f6vAX27Y%=DmL)Dy!7{j$KX)Gw2~`0TTzgyTsVFU
z&12?F7M*;6h`uJ8X4x`cD^t^$O9ls?Qcd%EP3FX8(N9rUHBB4$!|sYg*OL6nq7Nfy
z&G7iY8-tCse{#=lRXM)7iWJjKGLmcdk!!}lOx^*8HCYq|F>=in$n+LaO{5yBn1_l5
zp+esi<fLmdr~H}MFwUdQ4X<Gims<H{vPev}R+D!+d(Y(EOa1UMnO86;yZ$Uu-(_oF
z7{`bN|NbiS#y<U9Ou?SYoItbkY7I`VSPOcC2#GF*OJ$fR!&g5n;6Ik(b25BVh7Zf|
zfDG@K;k`0U$Z(qs8)aA_!?iM8F2kiV%;TXN|0Y*ld%uw5av9E-;p-og^6^mNtNHHu
zg;);!@FFN9D;DJ6rTD-wR`Sl{9PB(Ia$#-h?+(&Hqc#<2)s}T`!v+=#i`CO)dWBkU
z6bxX|kLAU_kONrP11s}fFk3J}bY22H6POrZhMeWd$+k>T*5t@Q--Kh}t_ha@87AMY
zXuYw{UrbICQ_~V9>-_r|pG3QkIfoFV>BZP>K$gPMIz`qGGYEal1H3-tRg2(7NbN^T
zE$)l+Qp@?8uE@5IdT>6r(}~A;HC7cbd;-;l?7@M+MB(`IU>4C#;1ojK+;hy6ajY8%
z2W7rMWv&TKq@U$<Otpb@SfaaGdM>$LHtytsbv0(}*yN`c@s;3QA<lU=QD4C>v0{N%
zGA-En><FuUxfsjT!F9Hrz)sL;ZKiH4xG!)5wK&MV+}NR|)SHfomBABKb2P>+*mNFS
z?54K9RpRaCcqbqQh#eVw9NuZH02oU7@P>76wNk&A$Yd9lM9~6Rb9SJ}NbtyLUeG~7
ze$as}AYU=G<W6h?-kW_h;023ov(E2NgHh`k1|<(RqcX!p6%<|fUIq8f?a}!;6uTzy
zrt7{K42G}iKe_;tQ4{jL61QCZW>=v$-}oKjEQ(FTD!6YMY#Svr6&|1kr$cib7kesW
zyA~3wBUC2qTj<XmK|PjEQwsIixNjL2P@!Vbei_eHX42cfmSO*4*s~z-415q1F5cCy
zMd2^ZRG7$<IE7+&X5XSOUWuAN14oz*yfiT3bM5{q$ntoBYxlp3_znFCUAw=fatd9$
zzoz1OwBI*D-g<m4B0fYQ!xhuXAapnk9TozuU}iK}X$4wn(Z6k<Rvj3m(S)$dz;L#1
zq7HVPInH(NT)B^w0{3%HFzbBbK1yIaYTu#>Y$lAofZY=8OM))nliQ65?Ui60(0ij-
z+43hvm0G74B1<daT@bWvdYme_i|nGarbocg?yk))dgV4*S5)J;=rR=K*YYj{|57(m
zlX+THF~DmD!G*DZ6-BwR*OPao+L+vEkerWnF0g$MOTn9AkLz8~1bG%{kap~Xa?37n
zq0)%q|Jy7yfFHaf0Gim!&GHal@~+Xjt`B}4-H)OR?p}eM3DQpbd>-=^Ac__R&{v44
zlYHhv9ch7%l-fd3&>kE2AvTuv6_8*74>=IQaWqSW#<I*Yk_kM6=xA_X%QODNWQydV
z@~OuU1jb-zd}F#e@#x7bNixA5^BHVfh&Z>4LQEpYo_d|MLH>StA^4m+c@hp00Q4A}
z0H-hvnq(py#0}mQ@IK~xbeMOkM<EhL-v0!Tcv5!^On6-H|2$6>rsfY!xKrgPvD-qd
zMqQ6G6a<+Oq()Zs6BwI2yJh}Ja1rh0QU1vfs3MPH+rucrPzFU(?<E322R@;Xw-b3t
zZNg-%pD;IaOcIap69(szmPf`h-=x;1I*p89ik;yR!T^vw2!!N{n~RO5u@AfklT$m6
z7$FD+GhBpdvLodEFM~l-m3Za}(T)O-lY)Ly9r$-g8oEjO@$Zi90~3X*xul%)#x*X<
zzLpVePLT*`;N@^y;~NY(+LpuT6MVG+R|fGaEFG&5VJM)3Su)4}KH%sqfm39Nr|<})
z*mdtb3<Wlakaf0o(@ey*=Ux=eIvbJV?xO~gu|X&1Jb^c-blU^NuHcce0`%j8F?z-s
zyzD5gu01d_JtLTL{;CU86z4DSpDv6RWmrYvQN?dBrC`w<q{iZqc5KTVLcGk&V%S&n
zAKAyV&Yyq=`j?z%q@O4Ty~jy$V>QH{&uD1kHJ2|z#+y;|32Xyr+!R3@6=NWRuUV7?
zonY2^-}}jZLXr>jH1*7oK+QP&3AArfjljI0WAb^8#s7FATGm+$B#0#+H(~8XC0(NA
zO2GqT2*AYjQi7uoj<-;|WZ~M}>Gkj{5PJzhFz&<qIO+K*CiNVkgyP{TGLpu*$R+24
z6xB=>L&zrppMn4%40C?p`%9|i6ryLH4*&zb<W3;B3*=oK8B*RuX`0<ugE)L0*}U^p
zBA2EaS*OMmsCF@DnIhpK3G~aQIx>lgG6ASI2zdqn0i1r*$;I;V;=&jWf9@q;Y?>>&
zc7Fp}!+bH{_5PzGmgn02ITd^VArWIKFU@;hdxntCI==!I5RA6}GlJVU_mC2fIX{6U
z*~|E@v0tGtWSt)Z06sGvL5=niF4fs%k{nfq^icT^og}wZIIqpW29G&gP=>B!&Po{r
z(`7^`>s-N^jxQd2z5pBx#|A|2Q*&F?+BCN{&G$WgKvIJb*t;HMT{qO-oRW55Pa<V~
z*9S5GB;okjL2|;HZlHHq6e5jNFo<E8J;n-*7o5<7JeBWMq8Njr;Efglx?AVr7Cgp|
z1%64D6{LL2T#u0eW0WbFOpLDw0J1HFGrlHJoWQ~i$&eTeeT5j)I6OIr;Nuq#1b*qD
zv2rDmaXse4X4>#IfnO$`Q08g~<`YW6(Ed(nGYB7gyX<fKxkSz%UIMVJC$-lXpl!of
z+)f<y`f!o?Q(je{QE->_88z4EG7?leReGQV!k@sV0tio01tOxVa7<OfXH30B6`bpY
zq||M>WjQU9;(;rs9am5m^|KagSdMlx(5%h}Hg<A3ueDC=af}j1tvys$ueI4yq@)&l
zQpL`{7BsoVP=&)5nma&qHk!Ob$WpQb&E<jDSqhhcHKS1DCBcC{x5I1>W?g=LDqUus
z|9P>s?*E7}#Hf1#*PD5=sOtBnoN{|C<!(T^DfLeSDmO6x0AKb+Jc}W1l>BDo$k;_R
zzZp1cG<b*xuB<a4_)$Z`T^|`M68xn3k~5<my_rtQ&c-SC4<b8*HOyTv>Fet|vn?+v
zS^*){2`KY~j&O@Y;GRMHUMcX6C<&9G8LOO^E<|HoLT&NBr6O-3pZ}2<<4dSnsD~~a
zKQ^dZA*37^jn6OqWKbmsZwdu(pm&65KdU%#Zt$LyJT)+n1y}JH&%NW{gO?o%0@%7G
z#{u&3-WUM5chZTg{g4^*Cs!Qk7yCr_%kW+qCS-WC3^&T~S{Yt0!}DY~Uxu&0Ptg0m
z48O@k%l;F!vE2Q@{B?5N3njXP$9&KOZ&+9WAGhH<_}EBk8Y7W*bB*Ts2lBm~-h4iZ
zIk^$z)#I4mu(5YwD##0B=8EQf&l3cF+(TI#`P7-F?L^juv`iHJK8Of%Zvb873p8CQ
zwAvtzje>?0S&2%c_%%<u_F%hCmR1PZW8;(HBNO@P9KsJ_KFAkb5QZk%N5-0nF1a&4
zIawlPs#Y?M-zEfttCKUeeapTMM#KqLC~L))HbHYuLEDrgD~vaH_64C@a?=|r#JJ~{
z^#?U&zB#iEfpA2xm=Kf{iN%1Z5(b?maJ~ZbuLzUZ;{r}`d>zC@z4_9Fw#_I`+h%>(
zHlx&afm6vBc~zi^kHVLl1hGy4<b2lylNu{0Hkl*5G9y832ca)h-LYQgo0n8_a>f03
z3H#hA!)s-Do(%J3`0AYk@5eHHQic!9@O~NYlHqMUJo&~CXvM8xWZ!fRu9NS*LPoj-
zlpd!1eisa4#%uUAe9=EF*P*pS&IuVt%B*s;9D0_*XA*yM4fIB~b$4`VNv-pawX4>Y
zcJ}r%O-qEkBgs@ap>^Rs?ywe#cEteg3{M4rdlK8tZA92dp$rcVinMpwYB%nSt!c%!
zE)wm&W7Qq&%jhNZRHQHL>1vPkrW4_7=W`T)XJ;auOnO$tJw5G7Pc-I<^tE?~S0%$8
zsYoo!Jf2OFL@M3hds8}`*vSirJ3U>ogl9#kXWPzHIO%CmdD?X<imzTSl!&E3OO?DM
zlIrnv;3apDcgKnyn09$uqT8dfJEER=GMw&=dHDOn?Zlg2luyMvV!fW*!-*sTR&<sM
zsb?;?Et2viBfG+8d?lC9XVueCZhzZi&1X63gQ1*!^}fAi;LV}m`XMWRC@0Nw+OaSv
z?aoPia?+t3d4{EZsQPZGti0B<5>~Kb^Qz6Tf*s}Swe@AI;<0382O7EOO3$`*q!+(J
z*y*WAggbgto~HIFEIE0ZXN|XXZK+oglHnP8XY_Z*Ue5Fn<rdEPga6(BK(+Ik@Qeoj
zEH!{Vlk;fbq+f*eJIjTLQ}{UUV#F!*FT?L55vQ;Nw-@m^!uR679`SyJ1Gs&N4<fu8
zuk2MJ?n8Jt?q<S4_&n}5#7`mo;@OP#B0h}pC%97tN4OcUrQeBo8^VWi?<O3CFW|lp
z@lk}o#r*){tQd0Peh_gl!VcV@LOhOe0{7<;XXi4u6ZcmT??<@cJjR|u+>LMq_lt;A
z__6b`t%LXw!kaE&?3aiSB76xqy9cr%yz3p%590j@KXf5u%Mc$zxcMT?*%9}87>nV)
z5^)M&!d;Fyg$pl+P7rq^d>D5KaSFeKdn@7;7GWc}6LAm1eYoR@Q+VqN=mc>JuXrb8
zdl9EFhWi1;DU9Or=@8-+F2pnF&m-<e_&MB%5vQ>03dW8iPT?E4M-Zp*l`EkK#MvtF
z!99jJg+-;%1L72(z|HOz;mXzEfjEUba2F#^VTl(v;uN;x_99N<)3~okoWj4OH@^@+
zgz$0P&4{zLjGc{pE8-r6>v4Ay4#ElCy@*p7DTAFLPT{M#`w?gBpl{swAwG!kuW|1u
z_?hdp8gLZmI}6tq<U2xmO1GfExxlfEQOW`*oJNUb#s_r=-Am@|S&~1m!s#t&%OB1u
zJFkGvb6m~x;*K_lGmkkFGF+RJCU}8^6;y!URN*$j=R4VaN08-vi5k*{PF8rJz?&bE
z>G^Zm{QKv4ouPtwep}wCgY!OD@V3Rz5%4+rY)*wNulUX_U~?Z9TpZ@Ox$e{H#0)RU
zbJ}#dxM0uX{5jk5yi!jOoAf%Bj)~rMIA;8}5?^cLWsWCI@agDGhhv7{FX^ayPZyeX
zlp9|wX`I$_&mjDvG{C>T0AjBXp-&+!lJ`oa@5DWVo5n;M=V%OU!%gEKjg2&3(>P7z
z`6zB0%V~V3v7W|YHOA5yOk*#N(KKcc184q2j4j7qiTgdc{{r`exF5rP9QTX3{|k5F
z0md%CeHHGFxNpH7!~Fr=AIJR<xJPimjGJnZ$MRVLbFw*XE?$wDhfg0YU<=tIwwSr_
zNNfpP%FbfTShPJFOU633hf_(u?P*GDa=%aO4yVj`X1LZ9OQxdO9-S5;5}z_FlGMWQ
z#fIaQnaOZ!X2OJ!LwH*x+G!!y5sOB#C255v!tE)mtexRVG?I$6_hKv2g4-ERrV_E8
z78o?4#o~O+)U2p!D8ysfM>gYO>n$9)-O5J7v{+XcYGpxBhI6V!fT<BvT4yYp!bWv>
zUpSgeC8b4U(QWuZ!**;F=Wx*LLq_vwdxZ`eRquHebF43-Z<=6V0j%d?%vAwbSMg)O
z18k~m=pO|1unb3J_yZaKT!wj%2)t!7^vW<O!&Vu#$uKIzei<s>gEIXI8Gc@dhh;b{
z!*9y)IT^kv!<S_Ea~V#^Fz-u(!$KLJEklnCFPCAN43#`SnXZ@NRvC86Fd@S`Wq6+q
zKPJP2GJI5qM`ieo3{S}LB^kad!`Edv2kk|dTZZS!aHR}IE_}IchcoRYH1glIoz8bu
zg?q!PaAg9nx}&|fNj|r_(GiH^30*Fjec4f+2#0GU+Y;@Go$U6!4dGO6domSBBw`7?
zr$_0!SZBI79K>Ug-msssZx9Smu{z|VGK~58HTuAi%iu(QZMgk*n>g&n{MuN1r{oK&
z_d1(;!{Iplw6nQ42?m?md(&a|yi-1HlTXbU`xgb_&)?{iIGPrTZPU8a(GEz$wD!Ja
zw-(+JNip_r2OdR6QmA$x>Zy@iXIJHG=_rpaE@<BtOQhIE1yB<pjBP0Bf-V?qDd@Tb
z>O<@U1%2VZjvi>@J|2tjWbA_!qXCFLRDeN}7yWVpMnI1D6vcYOQRs<c(T=`2`;UU#
zyW)umMjgg3Vw;=%mA&EiXgbc=7D_dx+VMmYsZTOKG_y~!j^0=@EG8T5(@c%epJ5~)
z%{BNFR`yxe9Zu=V&rymd7(DZflp+dz%JHyDVMu1|5!RE6MU(6?7Kvh*j;3O9ym`Un
zab&Q^StQnh?-}vQ4*LoNLQj%?m0<wBy(>XKQu!K7!pbmZU`G&(cBW#CJ&73S$ax%P
zvN&}Y8Xw-~{q8_xeW3QLwS20D;>%F}_r3d)w|68`g5pZh`$OKFo7QTEv{dOov&(IL
zuB&RVp2L4<n&<Hf?@V|`17|ewKR^Rs?BhbrgP+DfAAB+b&roQnb*OD9K7>RFYjy<v
zLwkn?hxQL092$9O^r2G^u><Y{o&(+kz5}5HZ3p59`VR~q7&>t102{{K6ZpkL-l6g#
zM9y6Qtu=scf9#jgRmlGjuMvKKEl=71Vao^j^dLas+cC~S{wHYwkAzhFJ4kNT{;x_q
zAQ&DwF-!=VqyO1O^Z`!t5rvKo^(~&tHCM~ms64CsQt4>;hVF1QoQQNF*^UYH4R{@E
z72e8P)vf*-)_PW{yDL;v=~>l9FKBgQe`b|<7ZH$XY*jMV-m!fZy&;EbDV8n^OG{Ua
zKY_Jc1Zzt>SmU)@?}$W^POdN0P_8??Rco#bX<PAP<0|oz*H+F$>!X(ix5`(<@Xp{W
z4!COVRzZw)qhfiEIUPOi36@tlw>K8;_V9n{Xfo0r#fyQM^drY<<ZwXV+++`y9v&-N
zfs<zz2y79bn}Z^FSb>g0JuM`07jS-^vGlgyFxVHUSV2KoZ>&AV@(ceKjaQJD=M-`f
zFK2}6No|5fQ)i?joMdwgZUma+8ONNf;qvFSBEPw%KA<&K1_M<swE;6M<Zo=Q@z-jN
zfel(!AQY&t3e;C_VGdKNrhqmLR-P5BDO6k2Oq7~fzLBHKR@eGBa5hcN{@PkrU|`fW
zY-(jrQ#w%B(6~jbt7)q9H&+HVQDBaNP~8HVD$(@*`YNrW(O(awtJbo)Gh?hTV}&zg
zG&PWrO>ABcn!mQi#EQ)~vi+5nEp;um{^o$z(9*o2p{9O==5GXv1qM#2v7xqMLrXww
zX`*b@Hoz7d*?~}vEqjrXO;xQ8_)%uD0Sw`D4O$&n6LT40qF;;FLN0R~;Hrj}3I$$b
zfE9K_h%Ggs3K`I|3~0z-r8NZ`8k@E1mio%(nudC|%$nO6Xl`k&Z(>CTxVoXGQQO#p
zcB-wZt7&Fu8(GkF^Jae|WNi#o2hhl*nTkMtpt`0K=E%-5P-`ng(gKPNU}FFR)iqSr
zRBvJD8emdZO?_omppu<uKx^uo0~-R3T2(bl1b729vGa}mhETKS-_XJ?FhKrI4K-Dy
zcdfdiQS(<-HL`aYxlOeVo3$FWJO0&OwU%0fT{um4IlIWn5oCd`HH2WgM7xsPgU7&;
z&C=A|2%Vr6E;h2zBmA{B8|nj8_f6=~90xjV(3BN5vE>FnsiVmstY(*3VU@MbRjkAc
zt7v8`42Tf4+FuI_a0^`0in<#1P7_Mi#+IgLt)(93UCS;tG8*7&YO1x$hWbrtjHY_F
z(#VqvsD_gXu*(d1pfyB&*<aDbE;pbgf3Su(T6GOnafLOj$&_`aHLJS1F%Sr`RR%QB
z+N_m(uPVQq1cOJZZ*F3xM)n5SUZe1XO<EJ_4c)Sqtu`<S*ix_bU)ul!gyGcG!CJl3
zVKp^3z{VBY8Y^1JU-@pdq-<}}l#aR9irKs+6sQd}K`^4%#ICYtlPq4XVv81PZD?d=
zMkX14BZP)mCVOepnj5rD=o{;1K&ftQsN+cMr$nMw4Ky~v0W`6z4GiJ>Erwkk;wBJi
zgrdt0OlniefQo2ljBBRE5ZplES|gixzED%JrMiM$XMlxel~rtkD<-E>(+WjhZ{!o-
z4gTg}ppo5RKt-uFYs;(a{90wuk5*vs%FSN8ZoMh{Mss#6@}{#2-wcRW!|>ZMO+#sg
zB@?3RR#IunAxV^_RT(+bpKq>d4w4^Z0VB&_yV<{`Nvp>AiP09i(a=3uwSge|Ho2MF
zKt0=FWHbe9s+-rapaHo#Ku)N&850Oi@T#w3HAX&sR9yp_Ms{a%o@}F$UG0Y}5zWTl
zZGcT~UfbMQ(;Q&6MkaTGb!)UuHGU0tUuWdhH;`Wn`D+^e82DJdk)tLfG~E%?iUw1r
zl<_9+S6IlN6RZ)_o12U*Ss_v%Yc#;30c#uNfZxQLj65>M*2>_93f61|qDEfUV!)^#
zqOXt-WSfi}VYjj$VYs90%|^DI6G5R>HGH&&-pS#$8YrTYyxG|n1FYKVCRx*)jjRC1
zaBUMcbW13NZgh*0Rg30hTjgAo76iF-(VO$;JgMfQ{zgpKXxNkUP?-*qO60`T3@Wc+
zVxGx?tz^SucFEHfO`H88Iho`DE(%VGaLkcYc{#Us;(0?fh3>=h+;df2pUGpko!=4b
zi}!|ic*I;g&#eR0G~A;@Ec0}CfmTh^b57g9F@SUFA%_-EVX<+!`y-f|7uI8absKKH
zv!H3*7uMFG186L7^%4zmK&!|@DyWx3d9lwRd%-xZ(%3>Gk-vW4{J$Ym`9ArRoQ3@a
zzFL93xxdsw*)!Lln+6<9up(IESn9}MeE#AUi_daG0gfe(6@_Ol$S*v<(2du0a1hIa
z1@A%<*5g97<}9o=i`b=jo5xw;$S-`?0)kz;;5z3u3mnM9$7S*hFId3X+_Mn@e8Dxm
zOrgV3a~2`YyBJL7mzgqeJokD~TW~R}IcqfvE-YgkB*B`q^5~7BGuIzU19(h|x23Mb
ze~06Z#f$LY0Y^lyfjM$_T=3YkE7H9>a#i_yyl1_$8=EerO@xUS%~ShE`M+e2<;%Ob
zc+>Ch?)KhLyL@?`14Qw}6>NHm^6A)sEjDgeo4Mskg13JmLun83?%vkBiZ+OnNMaw;
z*cB3+nk3wrYX%MEsMf6Z)p{HM;da<))6n1KSzCJ5`cl04edhZAt%1_62=){iqkZ7t
z;cEij4m?uFufVadYPsrV3Ln8jN2cpNxamoc0ohJqTn^@8`P?svwE6$-NZ_Xy97lA~
zex!Ve64iVMJykG@s!sfAKtrd&`4(^nPlNL#;Pjsc=QqHKp9W_UL~J_^&LzNcp9Y6M
zG;%j^NMi_aZ3X1eX-eT^)r`Kl%Js}keGm}u45jeuCx3&+U!ZuY^Twz+3PbZ9$Xms!
zsekIMF-ntk`Fv<lxgso;=Xg<yTY_Vy6+x!H1ST|)&&QqH%7miM4WsxR-1&~{DQdaY
z8Ds>cd5XYsS#T)vHSikNwNYWqS2j;3E^U5iH$4hi1>4_-Zy!X3^?#ETgA0m*b;h>c
z##3$hZ`l050f%}4*ALHs1&~3dXGwu)nEuTHx(`(l?XKD)&P!3f7NZ;{N~TM-h0crj
z6cYlXsx5qoi?#?^5eP?~&qmr6dM>f!$g|!EN9fs$7?x?KOFv%@Fwt}Urd%URZQ%xj
zz_GUlVbVu-=n{HX+UV!{A#HpQUnjm2`LDY^{f|PSN*f+Px#k5JDY^tXrHvs#gf=Ko
zT_lg8jW)!EHl86cuAYy&og|OAE(OUU+@cm{A0^HmRF+8-9HFt75W5EV#T&K`6L++C
z7v8`w^^z*_^%g-3N7;d@sHsQFy#<g_-8Kk20mvx}WDg+25ZLe=A0-?M<nI7!18W24
zt5nJY`DZ{zEs&Q1p+~z$sX|oRYk{l)ByNGMC&i$Zj8Yo_>9;^MK-}p522K)?5ewvl
zfDB;)VBmZPkT#f}0eK3LK?~#ufSj^GUIT<yyGE(=(3nGu6-0S}S0J|V0H&AK<<O_>
zuoVu5%qySStWNK7L&&FA1`a=mu;l7xNTT`%WZfWSvOvnlK-L0TzY;AdA@V%Pwpnp^
z+qmzwaUZpDKhMU!XI9)7+PL@IxSz0bciXtfXT`nH#(js4`-qME92@r?v*KQ0;~uwh
zKW^jxI(oOY-TP<7os7_8QR{ka+=p%4U$t@HJ1g#Q8afocU|pMy`(YdRmu%bzXT^QO
z#=X_X{g93O2^;tQv*P|s8~2cn`#~G`XKdVuX2qR6zqQ?iHts_<?niCh56+7F%Qo&l
z8~6P-?vL8IADR_+Iup=Z_i`KeK^ymjHtvUK#r-84cdw26UK{t1*|-nSiu<UI`$`-4
zejE4uY}}8}iu;Q;?j9TW9X9TF+PII*iu(y0_hK9OxQ%<l#{I;sxIb^>?zVC7v2pLT
zaUY!(_YoWSLL2us8~3d??qjp!{)~+~vvF^=aj&;=KQ$}v$8FpvFlV)RfU=N{yU*Y*
zcRYTJ*_oL8-I3()`gZ^zFE#h0r5#9N4We?4&^8;K3P-MvhfoYd^VD?YN!_$ogBpS3
z!GHTjE2%ah2%HKVf|}DV0G_B<SNry`6|IN=dIWnZz!4hjO7*0p*tjw2P|iI6By|__
zgtaRnCYJ|a9}qP(<d!pPdz-E^$t>IS`Wfo}Cv8(vud-80&r_||<s4~08dTIBORAhp
zttN`qyv~8eQO;$n*V|gBwAy-;&(@pvgQKN?t#8F@N<yTy6sn%`wzxOjxR=|w58Ai~
zZQR|n;vTed_t?1auyN0`aW9?~_bMCrVjK6kjr-4)wJ_E0o>_6f-p0Mq#=XtPeZ=4{
zdmQaxp4QvwbaZc{`h{K#uc`%da<4y_r<LA@=%3cxC>*t-UpHaMEbC5V+;nwUt@9_W
zSJ`1D^9<gmO||m$I9K;5+i+kDCFfG3OjNHs9@h1>t1VL<`#SUzQFrWXP0^-t`Q=Ry
zN<bt&sxelFQZa4`YBx*+WEADas7D^sAV%frx)V4<2>A$$-;a_w_~MdI$KDn%0-JWC
zjmvIhR$hc@-%$kPoJ;MmUI{UwMvUeqIT)ZL_g85Y#<WD@kVRTA8u1UI;-c;q)=Z>S
zThJU^*kQCig%{xQo5&7@tm^Jwa{8H!7ln9ROl2E#CUXcl)6HavC&|p9mea{Rq|1yS
zrY6&ILt>mFs_p31+8GOi6tz;mfb8NwMv@SK*<SDw^_tqo2<Icf838XLkF`ye{ro*}
z9_IQ{R`&!T-;ogP>B%w9(4i9)sdbG@*^dt(p+h52#gzRRI)sVlT%}Nl0?}A6o|Pzw
z2nna;=9_P(+Dwa6+1OmtTI*j49InHu+En1&?3)Qk&QAM*BXmesLRM>BrJPQcUvIBz
zc~#vULa}M(k<TWmUx>crF__4h>N_dmOxJgWJhhc1slf{cOqax|DxU#|(8-=du!hsw
z^TWUseXxUmqaNN7HY{4%k7w!W`=AdzPiH^Fz?rTOih9-f$+C>PBVoEE&dnacX2z-X
zQ?b+Fa66n1hsu)<hu(q?zoP4q|1L-C3HQeFC0ee?Kb{UD*c2DZeCjR8{Gu+i_`dfl
z{(Wzw?Vkn>(e57fWjmu(PgujZ$de<;65|))oIt4)7RXD0?Bn(WI)uVr2jtcwvM2>v
zh7NJX*=EQkfW$12s{o1OT`S|sNF5+F9va+R0r9{HXY!f11BX^OGvRy|IAqMz;n>^s
zWeBmFDyLs>$FJ%-bddF1FZH}~7+@ifeO98z?l|ft{116F>!tk9e&A5`^6@=7hA&Fx
zUSvN$AP8O+x!L;I{VMQ;-+)t3^&~nC)8S>F2aQq0jMn)vAcZJpKz;>?+XBgl`1Iv1
z-pa_C>hb{Ra|(we_yFm`cfJgZ+5*TM5`tfSs&SB)qPqVGty^Lt{&w1H6eW2r9OQ+q
zmuic{kRC#Sm)DAblxmAn;6Mcu2M+>sE@}%pQ}1+b@h0%}w&<fzOLXXzRNWcAdj>S{
z(zEo4z3%9uIhUFPcu-!{JqJN1N#@bFATzy5AY`V3eWWV=dOI?QPzt1`u9uwq88Q>5
z{UVvYkl=KBzEGDr9;R~`Olsyt@1a_7J$t5HI}p+Xz`0Z5@KT=yqzGTAGd$a2Ku%a7
z{|v}Ve5uvI`A<N0SRm9aB_1;lJxy)3Kvn_rv<|WB`R~y1*7>}$jkls_?+mt~`o$P<
zAUfKs7yqr7>KF9(k?0qMgKnI2QG4}+$m!Z^wccKs=xJSX{H9j#7)auLjd1GF#ZqIS
znR`hTrsL?IL_nw(R&5c5KeWc0Q4685!dwA$PjaWOG4dj$7wbhDqrLajY0R%{%)SRp
z6dS1P<H8FGsCy~?O8^1ob&CXHlN>m-FKWLc5{JgSd`CC_Th*^DbC|ad;jFb0`9tZM
z2&bhyv~M6hHWZO_?Up!LUIFK>oLpm7+obEzc&S$*t9r5JqQ*0M<G0u2Jc@-Sr1qj#
z67BWRsGi-kQ+rV>iT3)irMyaze!NHs{df?wwin@1n|31<ZA$M;+Ap$05AaTBhaI{O
z@k%E?kC@nL^jxC)SD+zuIJKv>>lu^Doa^n_PY7}o%PHGSuKu<{=F|1ly}%KkZTfy1
ze+&BgC$oNXcCo5@d+TT;$+LWV&!+SvaHw8?eEoF31^qnm7W6YblYZn(&&TUdc4lj3
zeK$;RQ?*liHI2J`e^o)&jX@p@q|66Put3(Ap+O}?au3dm`y)2)qc-m4Htv_(xQAxN
z{g93O2^)7B->r4`*toaOiu>nn+(&HOSK7FrZR6fHEAF4NaUZsEFSc>dvvKd4755<<
z_ro^sZX5RrIa4!s`Qo$U{-BLJy~S;5<uY2eSs?3wZsWdVR^0d7xF57}r=iBmo%R$Y
zME1D;S#hVixP|h%AshDzczp}b`WJ27_s)v@ppE-}8~0N-?$6n{56+7FeKzicHtu6K
z?%%X=-#;tvG<&ybb=?jd_YoWS&)c{U&5HY-Htum7_v1G1pD?(~=V;`g#TqsirQa!N
zsdjwm#+a%6Ek>$CT*9emDPX}K1<r)RApjczBvK;BZezv4acHEbH?K)|#$_Ah9L31A
zt^(BhT_5$(t8y>3M(YI!s0h3~xhVRIgL(=aAaEdRjyzO|W_oTcSWY+7I|VvIhwa$7
z&_AK7EAeO027SnhuY9MHS$Y70L-JgS0#-z&pEz>B4mh-u%E6I)1#d+^_v!kfS)BD!
zYuKZ@ex{%4wY>%XoCgI8{n%Gz>aCbzh#-2CdQRN~?y`SL{dl<!sqR*JDW&w&kGRke
zL9N$YvLE@JnpP8>`wVZz3@aRct~G<qb_r*g#T~Tu?&F3w<ohiiXhG^nK-Mp`jppS_
zV{eQ5UK{tlHtwUjbzeVh_!ik-zFBeKZR6f=<4*hY*18|IaSzUl`wkm-Q=3Z758JrY
zZ;qrq(yzA7VDoC_5>gWW@$I=RsH|nG=YyhN>&TA@n<w95z0})KUs3v*;cY0rUT@3l
zIu&KTH?=Bx6r}7BgtE4KzoB_)b*)OPZ;N}IjeE$({h*C|)W*GSR@}GRxCd?Ahiu&2
zY}|Wh#XV%>?zM5>Yvb;<agWc6d##Q8N*nin8~0^4?mK41-Dl(OwsG&Vai?EBNjsEQ
z*FP)n<u>j#cv&pGtkuT-u#NlPS#dA3ai36LLho@Q8}}iDyYzK;=)MlWT35g2#Fxy~
z1nAc^|G|YOlQX&kIG8~$vuEnjTxwO|{BcKolFafeNC(MjzlwF4NggK<>~8y=z@Zfo
z6bqcG>8u0J2ylo(zGLc{RTXd!sy3Zsrbp7z?DP=upnTA&Aduz4n>-yF-rE5Re~SPt
zaovREUfF^IvJDVwWuhY>Q9#ri^#amQL|~Q%&i?^q5Se7F0_SspsJGVy<QO3R7GBQ-
zqJAMFaDD~|U6c}#UjcGh)?Gjfz@#5h!ApI?U;T1H;JA?)xA3|M5RV1277(>Q&12#W
z1IENG#Ur`j2%JIrZoHse1IUEVon*Zk5W497AAu7AB!sA;pS>Js*Kg?8rr@RR=%u%+
zR-y#GtszQ1037AD1mqz=zJh$}FamOz=-@UeKZ8`OrCu)r(gte~ynxSsNu}Io$Rc8k
zi>M09mjEK>NFE6h2cUaQbb`PkJ2fbG0%EPj?SLr1A#2)+Rz@jgfU<^%>l(ZPHMF6z
z`;j>cnT>iK1VqgogoIxL1eGvp>=+>GcM}5VIY8owQiTQNCxBQb`~@I%3GQ?X1)V)1
zcDhvEe+Qf)5HRFfDuopgjUK<%H8UUR5Ff#-95`yk7mzAI)Nd>D^iv+x?->P715w6h
zwDPThs9%i<oCx8dQieSD5yaA_p8~`UbffN%0YbGfAWu>$5HTR%1w_3uo~NHI(Q2{z
zQQ(C1QtEt)xCQ4FaMWB&$UF(iFxVOOS`7CV1cVwu;CKM>S|q#<5cM0VJSNT&K_6T$
z*UKmg8o)Vav6ciNhb(m72Z;I|nc$TL#Ne)Jcn*WldC_Iq^T&Z>g&YDzjpl;R*9n5C
z(H771QmS`T`JVtXVv+C{gkx#1d3f~X1(2xbF?CXk*m?6v{ag&3e&idxt^i~hMT{0K
z2V_WZ9U!wRKn`1QZUTgg7<6KQ#4#j6NbnM;qo5C3+Vms9QNMQ}DRE9LAUiC)zDkt&
z<zW%NOG6ZmOPoD}H0myRQQp6xRGWp@j{xaMj?f0-{2Y*jmRh_4$dF|$m`9HRaT(gU
z1dzQtWp&1k+DR6*SPdNYO927#0YW}g*ed*UgvLq_C<|MS^H&Lt?`DWnwJ22v97+jD
zCm^V($-+~B_>gI6{(e9R-H`eJ5)ObyPk9`WLl($UK-5l-;PnF0!DaNO{{%$+`b^+V
z0MZ5=!Cjr26I^cYP4l2F56}&HE(Aoa>;#?b0I_O*BOv5$BxQM0O%I?(E8m6`%~y#A
zc|UQYkC(TgheL4=5O9hu+#dpjE~8gI0>}vq&Jn@^#K3tT5VcYuei-!#g3zefLNv{B
z3mrOdIj&ojI(<kza}jjPfHP((RS5{Xj^r-R@PYM$pHcT#;27f|$<qZ$zux2c8~`@v
zLyl-cjfO?(kqBRKA4DngY=-@O77#aXgV&=-S?5Sc0SQSOd=!q*d;>s}wfqE0pQT>^
z1&CTR@=_gCiY~*(3h=Uk`kkhbklw{6+D2Pk28iKlDfc=+s0Id34Io~CjMljY5V8BM
zY@>_lSR~v5NE_%7XTkjeKng85p8+JKL%5zhgr_xX@nztUHZVj<I>!MyXlcRk0@A9}
z0V4YuAUiCOUjuR&IY!T2gclHpEp*NWq{mX~azGBE6lnw*xGDhgAZkFi03x15cz~l$
z%@WU~2tro}a7HbZ-wTM^s}wl*0TKr;r3B;vAaogR@q`5;POw5-SZeVt;EY&!od86=
z%_1oO6p&V!rJ;>C0P!NzsMq=Um`)FpM!R1Mh|dBk2V~F!2>?Px3_6<uA+AO(l7wS{
zWC7W0k@=&5?6=hGlYl&eQijZ52Bgix{o4f5YoSgd3oSQ$(HDVJZsGM`fDG!TNV4An
z;(^(To(nqsT(eeAN43s;G@n|(qcARyY*0~mb;eq`#fw$|r`RHM2#}Q)$Tp(GFB+-w
zHAyaq1j%3raN-u3-w%k<m(^)&J}$EdEg;TygJ;trMCv0bbx7CqCy^=*_h>j86o<5y
zc80g5yS4U2d$b!zA;=^@T1{nb+m;C5u5x;De42_wXIMSqEDCt06wamS33oE_MJ@59
zis2PFt%ILU$M_t*24B`@;*H~y(nPompLi|RH2gRRN1)OP6?8nDSo)m~3CK9N&W6Qj
z3R6Mbr@*BZxE+_gtPR?^Gs>4r^b-b+CWqT_3I~&K!eI5$B#*YsDJWjoZ;!{d)XsPq
zx;kwMT^pDW(|b1>#_1%Es#8B-@GIGN?b-!;fuL61=&uXlD1Z$$^%$-?!wGz+D~Y23
zMf+-9QJ~?cXdq;UOJFX#*)aGIT=Zs&MAy>^d|G?ddj2hGWXhv*r^)D;>bzYTQqHlu
zZ|Uq_yk0rg*}FIpa4Ili&vfeTw8!Pz4()x*r|`bb(|t+7;bd~!)0IzqLUPUl$R>KZ
zXCtdDQp#x$Y}OI5Op9sVy|HcWy&BF!OeA4O284fZRN1G|z0IF%HjJW^ikf<rt(;ub
zYv^|{UE*dcA(M%49LLLOVSb2bU;7Su2xyYwke%)H^AS3iS)(&9>A^YXyh)G=YkjfK
zNLM7>sW7M-{2)vXbIur!2SuI4uU61&=)_Dd9;Pp=YKe3-73m8LXgi5?M|+a{H~eZd
zr|;vF*?l;2N88q(45MS(avNLfaTo%=z26jQscOJy(rX(k#rLb}lkjh=fCl-wtHJLi
zv<|9`DJ9(R_V7;LVp=bp0}wQv@?&7Z8Z?Dr%S=EgaL=ZEojUZP!*#Y=b8VCEBF#Vk
z!8t}rdZ%5(nWywrD_lbgs(^l&R*kcGLIK%+ImwEh^)yn+T4@`?DT!AdOZY{XnIf|?
zhQ`XF6xb04dk_c(OuTE7^|7cjlA35`I+4IDp&UV{8;+*?(4gGh@Y*dMB8zdW@9mD5
zIm0XspcoQxVr^n)C`P9f@zxUlR5QQy!3_T`!Ss!Ee(X37fem-0Q{fzZ&GNnjDk267
zVO-Y1K;tJ#@h6|9auk-|Lo|~7r@2N_d|G(@x^-8r18FD*eMvtQ)jU>+O!GOfFuv(+
zpG=vkiLE9L=DH1rivQcgiD<YNXUDWdMZz2eSAHm~C}chf7T%>j)h;F#=uKd1{y@CI
z7gG%p*Ux+vNy`DW0wni@jN@Yk*mTS-n9zPIS0V4g)68(h<VDjA8-z(3rxA-;1G&oH
z6n+96)4F1b4zho^x_FX%B*{c7%PbP+4H|vHzr6!<0Q9#=N0L`RiNox1P&^6Ov0cNb
z`};7H(H#f5M4WxBVT1tzBCC!X)--EL`cXpy?tm9<zb%%~lId;9otSa-X}9A?iR5s(
zy6J5jY^*C~2xU!uX7kizg**{ioPP|}a)J?^py@ziLECg9vVkoY@kX=24~s@I+o*!g
zY?#fa^O`M<jyHRBse~wE(FQ4|H+0bt4ej=X+vDbDA>+1Kg`mtQ_#$djfaQp3k;`p@
zpLm>evb3-+)0|W&79E)8u)OVv_mrnuTYAM?(VD6yQIxxX=%mzt`3gg|Q(SJga2F4g
ziX~09H062T26IgL+j&2*47Rf8>5~XG7r@BV9qogA=M|MJkDR$Sx0ZAgiy5Ixxe<l_
z>TlKsRW-uXikX@j<M<un_U%~Z<hWd_e`yc89XU75&p}1^b>h2AHc!V7qK03~o#Jy<
zn%u8+ebV%~JC!>Y*0VG4JK}cEKG(xqj>U!%S`S9oG%|QaU8?Z*j*ebTvrtRETu}|%
zA@Pjnnrg8p)I4Q7TQo$@74wAf4k#;!j&iBOm^*TenXe{PkME7e;(Ylg*rI;sL*7lz
zAdb-{V>HGb%i$wNt;{o7V|^$X7%gubxp~`6p<s)nhvSxpi0J~IxUOmRY+tjQGTCE|
zz81?poj#|jm4QjRYA<+(@?282-+*F$-1S@fspucdizu_7(poKsue6xsm~8Db#rSP3
zCvqo0qz>`0V@gM6osXyyj{9Kq04J;|WwIt?u%khaxOAKSS$kiy8}qRUO|dD{JZ4C1
zm}a&{*wr}ozE(^wW%(T6jc!GKK=eH@rlaTS6na5AXTT(id^(AVKp(SAD#%>Lqyj`}
zDJZ=$FJd11r?zX=V#L<ubq!`h9++#iqc6^KjL+1qq~Mxut}4t+P&dyiaBL6^O6%%v
z?-tV<k{Enw>yCU*&-P?$yVgf*ksJqsW!!ds@Yi#5JwI<W@d!cG!KP$Vd6+bA?xScB
zK%nAjr$ZvoULmgWbd*bH4B6Jk!db8S6p-*Eu?|>)ki%#Syig*>L5$tdlC&e*FH*Bm
uzBy*Lv8iWcGYx0v@m#&@p)1N{NK*`UW<hA@O$`xPzVinyQqz2H|Nj74FDA7B

literal 0
HcmV?d00001

diff --git a/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Plugins/nanosockets.dll.meta b/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Plugins/nanosockets.dll.meta
new file mode 100644
index 00000000000..582d07b7ec1
--- /dev/null
+++ b/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Plugins/nanosockets.dll.meta
@@ -0,0 +1,100 @@
+fileFormatVersion: 2
+guid: ea612cd63b7675e45a42fb9dfe0f1130
+timeCreated: 1523304125
+licenseType: Pro
+PluginImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  iconMap: {}
+  executionOrder: {}
+  isPreloaded: 0
+  isOverridable: 0
+  platformData:
+  - first:
+      '': Any
+    second:
+      enabled: 0
+      settings:
+        Exclude Editor: 0
+        Exclude Linux: 0
+        Exclude Linux64: 0
+        Exclude LinuxUniversal: 0
+        Exclude OSXUniversal: 0
+        Exclude Win: 1
+        Exclude Win64: 0
+  - first:
+      '': OSXIntel
+    second:
+      enabled: 0
+      settings:
+        CPU: None
+  - first:
+      '': OSXIntel64
+    second:
+      enabled: 1
+      settings:
+        CPU: AnyCPU
+  - first:
+      Any: 
+    second:
+      enabled: 1
+      settings: {}
+  - first:
+      Editor: Editor
+    second:
+      enabled: 1
+      settings:
+        CPU: x86_64
+        DefaultValueInitialized: true
+        OS: AnyOS
+  - first:
+      Facebook: Win
+    second:
+      enabled: 0
+      settings:
+        CPU: None
+  - first:
+      Facebook: Win64
+    second:
+      enabled: 1
+      settings:
+        CPU: AnyCPU
+  - first:
+      Standalone: Linux
+    second:
+      enabled: 1
+      settings:
+        CPU: None
+  - first:
+      Standalone: Linux64
+    second:
+      enabled: 1
+      settings:
+        CPU: x86_64
+  - first:
+      Standalone: LinuxUniversal
+    second:
+      enabled: 1
+      settings:
+        CPU: AnyCPU
+  - first:
+      Standalone: OSXUniversal
+    second:
+      enabled: 1
+      settings:
+        CPU: x86_64
+  - first:
+      Standalone: Win
+    second:
+      enabled: 0
+      settings:
+        CPU: None
+  - first:
+      Standalone: Win64
+    second:
+      enabled: 1
+      settings:
+        CPU: AnyCPU
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Scripts.meta b/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Scripts.meta
new file mode 100644
index 00000000000..ceccd234081
--- /dev/null
+++ b/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Scripts.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: d82a73b74cf1ea149aa88dffbedea717
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Scripts/NanoSockets.cs b/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Scripts/NanoSockets.cs
new file mode 100644
index 00000000000..2cc7818b69b
--- /dev/null
+++ b/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Scripts/NanoSockets.cs
@@ -0,0 +1,222 @@
+/*
+ *  Lightweight UDP sockets abstraction for rapid implementation of message-oriented protocols
+ *  Copyright (c) 2019 Stanislav Denisov
+ *
+ *  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.
+ */
+
+using System;
+using System.Runtime.InteropServices;
+using System.Security;
+using System.Text;
+
+namespace NanoSockets {
+	public enum Status {
+		OK = 0,
+		Error = -1
+	}
+
+	[StructLayout(LayoutKind.Explicit, Size = 8)]
+	public struct Socket {
+		[FieldOffset(0)]
+		private long handle;
+
+		public bool IsCreated {
+			get {
+				return handle > 0;
+			}
+		}
+	}
+
+	[StructLayout(LayoutKind.Explicit, Size = 18)]
+	public struct Address : IEquatable<Address> {
+		[FieldOffset(0)]
+		private ulong address0;
+		[FieldOffset(8)]
+		private ulong address1;
+		[FieldOffset(16)]
+		public ushort port;
+		[FieldOffset(16)]
+		public ushort Port;
+
+		public bool Equals(Address other) {
+			return address0 == other.address0 && address1 == other.address1 && port == other.port;
+		}
+
+		public override bool Equals(object obj) {
+			if (obj is Address)
+				return Equals((Address)obj);
+
+			return false;
+		}
+
+		public override int GetHashCode() {
+			int hash = 17;
+
+			hash = hash * 31 + address0.GetHashCode();
+			hash = hash * 31 + address1.GetHashCode();
+			hash = hash * 31 + port.GetHashCode();
+
+			return hash;
+		}
+
+		public override string ToString() {
+			StringBuilder ip = new StringBuilder(64);
+
+			NanoSockets.UDP.GetIP(ref this, ip, 64);
+
+			return String.Format("IP:{0} Port:{1}", ip, this.port);
+		}
+
+		public static Address CreateFromIpPort(string ip, ushort port) {
+			Address address = default(Address);
+
+			NanoSockets.UDP.SetIP(ref address, ip);
+			address.port = port;
+
+			return address;
+		}
+	}
+
+	[SuppressUnmanagedCodeSecurity]
+	public static class UDP {
+		#if __IOS__ || UNITY_IOS && !UNITY_EDITOR
+			private const string nativeLibrary = "__Internal";
+		#else
+			private const string nativeLibrary = "nanosockets";
+		#endif
+
+		public const int hostNameSize = 1025;
+
+		[DllImport(nativeLibrary, EntryPoint = "nanosockets_initialize", CallingConvention = CallingConvention.Cdecl)]
+		public static extern Status Initialize();
+
+		[DllImport(nativeLibrary, EntryPoint = "nanosockets_deinitialize", CallingConvention = CallingConvention.Cdecl)]
+		public static extern void Deinitialize();
+
+		[DllImport(nativeLibrary, EntryPoint = "nanosockets_create", CallingConvention = CallingConvention.Cdecl)]
+		public static extern Socket Create(int sendBufferSize, int receiveBufferSize);
+
+		[DllImport(nativeLibrary, EntryPoint = "nanosockets_destroy", CallingConvention = CallingConvention.Cdecl)]
+		public static extern void Destroy(ref Socket socket);
+
+		[DllImport(nativeLibrary, EntryPoint = "nanosockets_bind", CallingConvention = CallingConvention.Cdecl)]
+		public static extern int Bind(Socket socket, IntPtr address);
+
+		[DllImport(nativeLibrary, EntryPoint = "nanosockets_bind", CallingConvention = CallingConvention.Cdecl)]
+		public static extern int Bind(Socket socket, ref Address address);
+
+		[DllImport(nativeLibrary, EntryPoint = "nanosockets_connect", CallingConvention = CallingConvention.Cdecl)]
+		public static extern int Connect(Socket socket, ref Address address);
+
+		[DllImport(nativeLibrary, EntryPoint = "nanosockets_set_option", CallingConvention = CallingConvention.Cdecl)]
+		public static extern Status SetOption(Socket socket, int level, int optionName, ref int optionValue, int optionLength);
+
+		[DllImport(nativeLibrary, EntryPoint = "nanosockets_get_option", CallingConvention = CallingConvention.Cdecl)]
+		public static extern Status GetOption(Socket socket, int level, int optionName, ref int optionValue, ref int optionLength);
+
+        	public static Status SetNonBlocking(Socket socket, bool shouldBlock = false)
+                	=> SetNonBlocking(socket, (byte)(shouldBlock ? 1 : 0));
+
+        	[DllImport(nativeLibrary, EntryPoint = "nanosockets_set_nonblocking", CallingConvention = CallingConvention.Cdecl)]
+        	private static extern Status SetNonBlocking(Socket socket, byte state);
+
+        	[DllImport(nativeLibrary, EntryPoint = "nanosockets_set_dontfragment", CallingConvention = CallingConvention.Cdecl)]
+		public static extern Status SetDontFragment(Socket socket);
+
+		[DllImport(nativeLibrary, EntryPoint = "nanosockets_poll", CallingConvention = CallingConvention.Cdecl)]
+		public static extern int Poll(Socket socket, long timeout);
+
+		[DllImport(nativeLibrary, EntryPoint = "nanosockets_send", CallingConvention = CallingConvention.Cdecl)]
+		public static extern int Send(Socket socket, IntPtr address, IntPtr buffer, int bufferLength);
+
+		[DllImport(nativeLibrary, EntryPoint = "nanosockets_send", CallingConvention = CallingConvention.Cdecl)]
+		public static extern int Send(Socket socket, IntPtr address, byte[] buffer, int bufferLength);
+
+		[DllImport(nativeLibrary, EntryPoint = "nanosockets_send", CallingConvention = CallingConvention.Cdecl)]
+		public static extern int Send(Socket socket, ref Address address, IntPtr buffer, int bufferLength);
+
+		[DllImport(nativeLibrary, EntryPoint = "nanosockets_send", CallingConvention = CallingConvention.Cdecl)]
+		public static extern int Send(Socket socket, ref Address address, byte[] buffer, int bufferLength);
+
+        	[DllImport(nativeLibrary, EntryPoint = "nanosockets_send_offset", CallingConvention = CallingConvention.Cdecl)]
+        	public static extern int Send(Socket socket, IntPtr address, byte[] buffer, int offset, int bufferLength);
+
+        	[DllImport(nativeLibrary, EntryPoint = "nanosockets_send_offset", CallingConvention = CallingConvention.Cdecl)]
+        	public static extern int Send(Socket socket, ref Address address, byte[] buffer, int offset, int bufferLength);
+
+        	[DllImport(nativeLibrary, EntryPoint = "nanosockets_receive", CallingConvention = CallingConvention.Cdecl)]
+		public static extern int Receive(Socket socket, IntPtr address, IntPtr buffer, int bufferLength);
+
+		[DllImport(nativeLibrary, EntryPoint = "nanosockets_receive", CallingConvention = CallingConvention.Cdecl)]
+		public static extern int Receive(Socket socket, IntPtr address, byte[] buffer, int bufferLength);
+
+		[DllImport(nativeLibrary, EntryPoint = "nanosockets_receive", CallingConvention = CallingConvention.Cdecl)]
+		public static extern int Receive(Socket socket, ref Address address, IntPtr buffer, int bufferLength);
+
+		[DllImport(nativeLibrary, EntryPoint = "nanosockets_receive", CallingConvention = CallingConvention.Cdecl)]
+		public static extern int Receive(Socket socket, ref Address address, byte[] buffer, int bufferLength);
+
+        	[DllImport(nativeLibrary, EntryPoint = "nanosockets_receive_offset", CallingConvention = CallingConvention.Cdecl)]
+        	public static extern int Receive(Socket socket, IntPtr address, byte[] buffer, int offset, int bufferLength);
+
+        	[DllImport(nativeLibrary, EntryPoint = "nanosockets_receive_offset", CallingConvention = CallingConvention.Cdecl)]
+        	public static extern int Receive(Socket socket, ref Address address, byte[] buffer, int offset, int bufferLength);
+
+        	[DllImport(nativeLibrary, EntryPoint = "nanosockets_address_get", CallingConvention = CallingConvention.Cdecl)]
+		public static extern Status GetAddress(Socket socket, ref Address address);
+
+		[DllImport(nativeLibrary, EntryPoint = "nanosockets_address_is_equal", CallingConvention = CallingConvention.Cdecl)]
+		public static extern Status IsEqual(ref Address left, ref Address right);
+
+		[DllImport(nativeLibrary, EntryPoint = "nanosockets_address_set_ip", CallingConvention = CallingConvention.Cdecl)]
+		public static extern Status SetIP(ref Address address, IntPtr ip);
+
+		[DllImport(nativeLibrary, EntryPoint = "nanosockets_address_set_ip", CallingConvention = CallingConvention.Cdecl)]
+		public static extern Status SetIP(ref Address address, string ip);
+
+		[DllImport(nativeLibrary, EntryPoint = "nanosockets_address_get_ip", CallingConvention = CallingConvention.Cdecl)]
+		public static extern Status GetIP(ref Address address, IntPtr ip, int ipLength);
+
+		[DllImport(nativeLibrary, EntryPoint = "nanosockets_address_get_ip", CallingConvention = CallingConvention.Cdecl)]
+		public static extern Status GetIP(ref Address address, StringBuilder ip, int ipLength);
+
+		[DllImport(nativeLibrary, EntryPoint = "nanosockets_address_set_hostname", CallingConvention = CallingConvention.Cdecl)]
+		public static extern Status SetHostName(ref Address address, IntPtr name);
+
+		[DllImport(nativeLibrary, EntryPoint = "nanosockets_address_set_hostname", CallingConvention = CallingConvention.Cdecl)]
+		public static extern Status SetHostName(ref Address address, string name);
+
+		[DllImport(nativeLibrary, EntryPoint = "nanosockets_address_get_hostname", CallingConvention = CallingConvention.Cdecl)]
+		public static extern Status GetHostName(ref Address address, IntPtr name, int nameLength);
+
+		[DllImport(nativeLibrary, EntryPoint = "nanosockets_address_get_hostname", CallingConvention = CallingConvention.Cdecl)]
+		public static extern Status GetHostName(ref Address address, StringBuilder name, int nameLength);
+
+		#if NANOSOCKETS_UNSAFE_API
+			public static unsafe class Unsafe {
+				[DllImport(nativeLibrary, EntryPoint = "nanosockets_receive", CallingConvention = CallingConvention.Cdecl)]
+				public static extern int Receive(Socket socket, Address* address, byte* buffer, int bufferLength);
+
+				[DllImport(nativeLibrary, EntryPoint = "nanosockets_send", CallingConvention = CallingConvention.Cdecl)]
+				public static extern int Send(Socket socket, Address* address, byte* buffer, int bufferLength);
+			}
+		#endif
+	}
+}
diff --git a/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Scripts/NanoSockets.cs.meta b/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Scripts/NanoSockets.cs.meta
new file mode 100644
index 00000000000..0896ef12805
--- /dev/null
+++ b/Assets/Mirage/Runtime/Sockets/Udp/NanoSockets/Scripts/NanoSockets.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 40dfe7cdc1dc8de4f9bea3cf11c3aa4e
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Runtime/Sockets/Udp/UdpSocket.cs b/Assets/Mirage/Runtime/Sockets/Udp/UdpSocket.cs
new file mode 100644
index 00000000000..3d7674c6ea8
--- /dev/null
+++ b/Assets/Mirage/Runtime/Sockets/Udp/UdpSocket.cs
@@ -0,0 +1,103 @@
+using System;
+using System.Net;
+using System.Net.Sockets;
+using Mirage.SocketLayer;
+using UnityEngine;
+
+namespace Mirage.Sockets.Udp {
+    public class UdpSocket : ISocket
+    {
+        Socket socket;
+        EndPointWrapper Endpoint;
+
+        public void Bind(IEndPoint endPoint)
+        {
+            Endpoint = (EndPointWrapper)endPoint;
+
+            socket = CreateSocket(Endpoint.inner);
+            socket.DualMode = true;
+            socket.Bind(Endpoint.inner);
+        }
+
+        static Socket CreateSocket(EndPoint endPoint)
+        {
+            var ipEndPoint = (IPEndPoint)endPoint;
+            var newSocket = new Socket(ipEndPoint.AddressFamily, SocketType.Dgram, ProtocolType.Udp)
+            {
+                Blocking = false,
+            };
+
+            newSocket.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.ReuseAddress, true);
+            TrySetIOControl(newSocket);
+
+            return newSocket;
+        }
+
+        private static void TrySetIOControl(Socket socket)
+        {
+            try
+            {
+                if (Application.platform != RuntimePlatform.WindowsPlayer && Application.platform != RuntimePlatform.WindowsEditor)
+                {
+                    // IOControl only seems to work on windows
+                    // gives "SocketException: The descriptor is not a socket" when running on github action on Linux
+                    // see https://github.com/mono/mono/blob/f74eed4b09790a0929889ad7fc2cf96c9b6e3757/mcs/class/System/System.Net.Sockets/Socket.cs#L2763-L2765
+                    return;
+                }
+
+                // stops "SocketException: Connection reset by peer"
+                // this error seems to be caused by a failed send, resulting in the next polling being true, even those endpoint is closed
+                // see https://stackoverflow.com/a/15232187/8479976
+
+                // this IOControl sets the reporting of "unrealable" to false, stoping SocketException after a connection closes without sending disconnect message
+                const uint IOC_IN = 0x80000000;
+                const uint IOC_VENDOR = 0x18000000;
+                const uint SIO_UDP_CONNRESET = IOC_IN | IOC_VENDOR | 12;
+                byte[] _false = new byte[] { 0, 0, 0, 0 };
+
+                socket.IOControl(unchecked((int)SIO_UDP_CONNRESET), _false, null);
+            }
+            catch (Exception e)
+            {
+                Debug.LogError("Exception setting IOControl");
+                Debug.LogException(e);
+            }
+        }
+
+        public void Connect(IEndPoint endPoint)
+        {
+            Endpoint = (EndPointWrapper)endPoint;
+
+            socket = CreateSocket(Endpoint.inner);
+            socket.Connect(Endpoint.inner);
+        }
+
+        public void Close()
+        {
+            socket.Close();
+            socket.Dispose();
+        }
+
+        /// <summary>
+        /// Is message avaliable
+        /// </summary>
+        /// <returns>true if data to read</returns>
+        public bool Poll()
+        {
+            return socket.Poll(0, SelectMode.SelectRead);
+        }
+
+        public int Receive(byte[] buffer, out IEndPoint endPoint)
+        {
+            int c = socket.ReceiveFrom(buffer, ref Endpoint.inner);
+            endPoint = Endpoint;
+            return c;
+        }
+
+        public void Send(IEndPoint endPoint, byte[] packet, int length)
+        {
+            EndPoint netEndPoint = ((EndPointWrapper)endPoint).inner;
+            socket.SendTo(packet, length, SocketFlags.None, netEndPoint);
+        }
+    }
+}
\ No newline at end of file
diff --git a/Assets/Mirage/Runtime/Sockets/Udp/UdpSocket.cs.meta b/Assets/Mirage/Runtime/Sockets/Udp/UdpSocket.cs.meta
new file mode 100644
index 00000000000..7817eef80bd
--- /dev/null
+++ b/Assets/Mirage/Runtime/Sockets/Udp/UdpSocket.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 170b2f67724cb324986849a3343bfdff
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Runtime/Sockets/Udp/UdpSocketFactory.cs b/Assets/Mirage/Runtime/Sockets/Udp/UdpSocketFactory.cs
index 5dc0c456a44..dad31ddad4f 100644
--- a/Assets/Mirage/Runtime/Sockets/Udp/UdpSocketFactory.cs
+++ b/Assets/Mirage/Runtime/Sockets/Udp/UdpSocketFactory.cs
@@ -2,19 +2,59 @@
 using System.Net;
 using System.Net.Sockets;
 using Mirage.SocketLayer;
+using NanoSockets;
 using UnityEngine;
 
 namespace Mirage.Sockets.Udp
 {
+    public enum SocketLib { Automatic, Native, Managed };
+
     public sealed class UdpSocketFactory : SocketFactory
     {
-        [SerializeField] string address = "localhost";
-        [SerializeField] int port = 7777;
+        public string Address = "localhost";
+        public ushort Port = 7777;
+        public int BufferSize = 256 * 1024;
+
+        [Tooltip("Allows you to set which Socket implementation you want to use.\nAutomatic will use native (NanoSockets) on supported platforms (Windows, Mac & Linux).")]
+        public SocketLib SocketLib;
+
+        bool useNanoSocket => SocketLib == SocketLib.Native || (SocketLib == SocketLib.Automatic && IsDesktop);
+
+        static int initCount;
+
+        [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)]
+        static void ClearCounter() {
+            initCount = 0;
+        }
+
+        void Awake() {
+            if (!useNanoSocket) return;
+
+            if (initCount == 0)
+            {
+                UDP.Initialize();
+            }
+
+            initCount++;
+        }
+
+        void OnDestroy() {
+            if (!useNanoSocket) return;
+
+            initCount--;
+
+            if (initCount == 0)
+            {
+                UDP.Deinitialize();
+            }
+        }
 
         public override ISocket CreateClientSocket()
         {
             ThrowIfNotSupported();
 
+            if (useNanoSocket) return new NanoSocket(this);
+
             return new UdpSocket();
         }
 
@@ -22,20 +62,26 @@ public override ISocket CreateServerSocket()
         {
             ThrowIfNotSupported();
 
+            if (useNanoSocket) return new NanoSocket(this);
+
             return new UdpSocket();
         }
 
         public override IEndPoint GetBindEndPoint()
         {
-            return new EndPointWrapper(new IPEndPoint(IPAddress.IPv6Any, port));
+            if (useNanoSocket) return new NanoEndPoint("::0", Port);
+
+            return new EndPointWrapper(new IPEndPoint(IPAddress.IPv6Any, Port));
         }
 
         public override IEndPoint GetConnectEndPoint(string address = null, ushort? port = null)
         {
-            string addressString = address ?? this.address;
+            string addressString = address ?? Address;
             IPAddress ipAddress = getAddress(addressString);
 
-            ushort portIn = port ?? (ushort)this.port;
+            ushort portIn = port ?? Port;
+
+            if (useNanoSocket) return new NanoEndPoint(addressString, portIn);
 
             return new EndPointWrapper(new IPEndPoint(ipAddress, portIn));
         }
@@ -65,6 +111,11 @@ void ThrowIfNotSupported()
         }
 
         private static bool IsWebgl => Application.platform == RuntimePlatform.WebGLPlayer;
+        private static bool IsDesktop =>
+            Application.platform == RuntimePlatform.LinuxPlayer
+            || Application.platform == RuntimePlatform.OSXPlayer
+            || Application.platform == RuntimePlatform.WindowsPlayer
+            || Application.isEditor;
     }
 
     public class EndPointWrapper : IEndPoint
@@ -102,103 +153,4 @@ IEndPoint IEndPoint.CreateCopy()
             return new EndPointWrapper(copy);
         }
     }
-
-    public class UdpSocket : ISocket
-    {
-        Socket socket;
-        EndPointWrapper Endpoint;
-
-        public void Bind(IEndPoint endPoint)
-        {
-            Endpoint = (EndPointWrapper)endPoint;
-
-            socket = CreateSocket(Endpoint.inner);
-            socket.DualMode = true;
-            socket.Bind(Endpoint.inner);
-        }
-
-        static Socket CreateSocket(EndPoint endPoint)
-        {
-            var ipEndPoint = (IPEndPoint)endPoint;
-            var socket = new Socket(ipEndPoint.AddressFamily, SocketType.Dgram, ProtocolType.Udp)
-            {
-                Blocking = false,
-            };
-
-            socket.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.ReuseAddress, true);
-            TrySetIOControl(socket);
-
-            return socket;
-        }
-
-        private static void TrySetIOControl(Socket socket)
-        {
-            try
-            {
-                if (Application.platform != RuntimePlatform.WindowsPlayer && Application.platform != RuntimePlatform.WindowsEditor)
-                {
-                    // IOControl only seems to work on windows
-                    // gives "SocketException: The descriptor is not a socket" when running on github action on Linux
-                    // see https://github.com/mono/mono/blob/f74eed4b09790a0929889ad7fc2cf96c9b6e3757/mcs/class/System/System.Net.Sockets/Socket.cs#L2763-L2765
-                    return;
-                }
-
-                // stops "SocketException: Connection reset by peer"
-                // this error seems to be caused by a failed send, resulting in the next polling being true, even those endpoint is closed
-                // see https://stackoverflow.com/a/15232187/8479976
-
-                // this IOControl sets the reporting of "unrealable" to false, stoping SocketException after a connection closes without sending disconnect message
-                const uint IOC_IN = 0x80000000;
-                const uint IOC_VENDOR = 0x18000000;
-                const uint SIO_UDP_CONNRESET = IOC_IN | IOC_VENDOR | 12;
-                byte[] _false = new byte[] { 0, 0, 0, 0 };
-
-                socket.IOControl(unchecked((int)SIO_UDP_CONNRESET), _false, null);
-            }
-            catch (Exception e)
-            {
-                Debug.LogError("Exception setting IOControl");
-                Debug.LogException(e);
-            }
-        }
-
-        public void Connect(IEndPoint endPoint)
-        {
-            Endpoint = (EndPointWrapper)endPoint;
-
-            socket = CreateSocket(Endpoint.inner);
-            socket.Connect(Endpoint.inner);
-        }
-
-        public void Close()
-        {
-            socket.Close();
-            socket.Dispose();
-        }
-
-        /// <summary>
-        /// Is message avaliable
-        /// </summary>
-        /// <returns>true if data to read</returns>
-        public bool Poll()
-        {
-            return socket.Poll(0, SelectMode.SelectRead);
-        }
-
-        public int Receive(byte[] buffer, out IEndPoint endPoint)
-        {
-            int c = socket.ReceiveFrom(buffer, ref Endpoint.inner);
-            endPoint = Endpoint;
-            return c;
-        }
-
-        public void Send(IEndPoint endPoint, byte[] packet, int length)
-        {
-            // todo check disconnected
-            // todo what SocketFlags??
-
-            EndPoint netEndPoint = ((EndPointWrapper)endPoint).inner;
-            socket.SendTo(packet, length, SocketFlags.None, netEndPoint);
-        }
-    }
 }

From a3028ecb06084574cbbb0b10bbd33394d44d94d2 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Fri, 16 Jul 2021 16:14:54 +0100
Subject: [PATCH 062/166] fix(NanoSocket): adding Exception when nanosocket
 bind fails

---
 .../Mirage/Runtime/Sockets/Udp/NanoSocket.cs  | 28 +++++++++++++++----
 1 file changed, 22 insertions(+), 6 deletions(-)

diff --git a/Assets/Mirage/Runtime/Sockets/Udp/NanoSocket.cs b/Assets/Mirage/Runtime/Sockets/Udp/NanoSocket.cs
index 242913a13c6..f5d16fd93be 100644
--- a/Assets/Mirage/Runtime/Sockets/Udp/NanoSocket.cs
+++ b/Assets/Mirage/Runtime/Sockets/Udp/NanoSocket.cs
@@ -1,14 +1,22 @@
+using System;
 using Mirage.SocketLayer;
 using NanoSockets;
 
-namespace Mirage.Sockets.Udp {
+namespace Mirage.Sockets.Udp
+{
+    // todo Create an Exception in mirage that can be re-used by multiple sockets (makes it easier for user to catch)
+    public class NanoSocketException : Exception
+    {
+        public NanoSocketException(string message) : base(message) { }
+    }
     public class NanoSocket : ISocket
     {
         Socket socket;
         NanoEndPoint receiveEndPoint;
         readonly int bufferSize;
 
-        public NanoSocket(UdpSocketFactory factory) {
+        public NanoSocket(UdpSocketFactory factory)
+        {
             bufferSize = factory.BufferSize;
         }
 
@@ -17,7 +25,11 @@ public void Bind(IEndPoint endPoint)
             receiveEndPoint = (NanoEndPoint)endPoint;
 
             InitSocket();
-            UDP.Bind(socket, ref receiveEndPoint.address);
+            int result = UDP.Bind(socket, ref receiveEndPoint.address);
+            if (result != 0)
+            {
+                throw new NanoSocketException("Socket Bind failed: address or port might already be in use");
+            }
         }
 
         public void Close()
@@ -28,9 +40,13 @@ public void Close()
         public void Connect(IEndPoint endPoint)
         {
             receiveEndPoint = (NanoEndPoint)endPoint;
-            
+
             InitSocket();
-            UDP.Connect(socket, ref receiveEndPoint.address);
+            int result = UDP.Connect(socket, ref receiveEndPoint.address);
+            if (result != 0)
+            {
+                throw new NanoSocketException("Socket Connect failed");
+            }
         }
 
         public bool Poll()
@@ -59,4 +75,4 @@ void InitSocket()
             UDP.SetNonBlocking(socket);
         }
     }
-}
\ No newline at end of file
+}

From 891fa16b15fbb9293652c9fe1f58521eab1351b1 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Fri, 16 Jul 2021 16:23:31 +0100
Subject: [PATCH 063/166] style: running code cleanup

---
 Assets/Mirage/Components/NetworkProximityChecker.cs      | 1 -
 Assets/Mirage/Runtime/SocketLayer/Peer.cs                | 2 +-
 Assets/Mirage/Runtime/Sockets/Udp/NanoEndPoint.cs        | 5 +++--
 Assets/Mirage/Runtime/Sockets/Udp/UdpSocket.cs           | 3 ++-
 Assets/Mirage/Runtime/Sockets/Udp/UdpSocketFactory.cs    | 9 ++++++---
 .../Samples~/InterestManagement/Scripts/Spawner.cs       | 8 +++-----
 .../Mirage/Samples~/InterestManagement/Scripts/Wander.cs | 1 -
 .../HeadlessBenchmark/Scripts/HeadlessBenchmark.cs       | 4 ++--
 Assets/Tests/Runtime/Host/NetworkIdentityTests.cs        | 2 +-
 Assets/Tests/SocketLayer/PeerTestConnecting.cs           | 1 -
 10 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/Assets/Mirage/Components/NetworkProximityChecker.cs b/Assets/Mirage/Components/NetworkProximityChecker.cs
index 3788b566586..0d817fc239e 100644
--- a/Assets/Mirage/Components/NetworkProximityChecker.cs
+++ b/Assets/Mirage/Components/NetworkProximityChecker.cs
@@ -1,7 +1,6 @@
 using System.Collections.Generic;
 using Mirage.Logging;
 using UnityEngine;
-using UnityEngine.Profiling;
 
 namespace Mirage
 {
diff --git a/Assets/Mirage/Runtime/SocketLayer/Peer.cs b/Assets/Mirage/Runtime/SocketLayer/Peer.cs
index 63b2ecdf2ed..43d39968d8b 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Peer.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Peer.cs
@@ -71,7 +71,7 @@ public Peer(ISocket socket, IDataHandler dataHandler, Config config = null, ILog
             time = new Time();
 
             connectKeyValidator = new ConnectKeyValidator();
-            
+
             bufferPool = new Pool<ByteBuffer>(ByteBuffer.CreateNew, this.config.MaxPacketSize, this.config.BufferPoolStartSize, this.config.BufferPoolMaxSize, this.logger);
             Application.quitting += Application_quitting;
         }
diff --git a/Assets/Mirage/Runtime/Sockets/Udp/NanoEndPoint.cs b/Assets/Mirage/Runtime/Sockets/Udp/NanoEndPoint.cs
index 2e3240d6689..9c89d91a263 100644
--- a/Assets/Mirage/Runtime/Sockets/Udp/NanoEndPoint.cs
+++ b/Assets/Mirage/Runtime/Sockets/Udp/NanoEndPoint.cs
@@ -2,7 +2,8 @@
 using Mirage.SocketLayer;
 using NanoSockets;
 
-namespace Mirage.Sockets.Udp {
+namespace Mirage.Sockets.Udp
+{
     public sealed class NanoEndPoint : IEndPoint, IEquatable<NanoEndPoint>
     {
         public Address address;
@@ -50,4 +51,4 @@ public override string ToString()
         }
     }
 
-}
\ No newline at end of file
+}
diff --git a/Assets/Mirage/Runtime/Sockets/Udp/UdpSocket.cs b/Assets/Mirage/Runtime/Sockets/Udp/UdpSocket.cs
index 3d7674c6ea8..ca3315fa057 100644
--- a/Assets/Mirage/Runtime/Sockets/Udp/UdpSocket.cs
+++ b/Assets/Mirage/Runtime/Sockets/Udp/UdpSocket.cs
@@ -4,7 +4,8 @@
 using Mirage.SocketLayer;
 using UnityEngine;
 
-namespace Mirage.Sockets.Udp {
+namespace Mirage.Sockets.Udp
+{
     public class UdpSocket : ISocket
     {
         Socket socket;
diff --git a/Assets/Mirage/Runtime/Sockets/Udp/UdpSocketFactory.cs b/Assets/Mirage/Runtime/Sockets/Udp/UdpSocketFactory.cs
index dad31ddad4f..aaa6ec233e7 100644
--- a/Assets/Mirage/Runtime/Sockets/Udp/UdpSocketFactory.cs
+++ b/Assets/Mirage/Runtime/Sockets/Udp/UdpSocketFactory.cs
@@ -23,11 +23,13 @@ public sealed class UdpSocketFactory : SocketFactory
         static int initCount;
 
         [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)]
-        static void ClearCounter() {
+        static void ClearCounter()
+        {
             initCount = 0;
         }
 
-        void Awake() {
+        void Awake()
+        {
             if (!useNanoSocket) return;
 
             if (initCount == 0)
@@ -38,7 +40,8 @@ public sealed class UdpSocketFactory : SocketFactory
             initCount++;
         }
 
-        void OnDestroy() {
+        void OnDestroy()
+        {
             if (!useNanoSocket) return;
 
             initCount--;
diff --git a/Assets/Mirage/Samples~/InterestManagement/Scripts/Spawner.cs b/Assets/Mirage/Samples~/InterestManagement/Scripts/Spawner.cs
index 013bbc50c36..c3d1c2ae90f 100644
--- a/Assets/Mirage/Samples~/InterestManagement/Scripts/Spawner.cs
+++ b/Assets/Mirage/Samples~/InterestManagement/Scripts/Spawner.cs
@@ -1,6 +1,4 @@
-using System.Collections;
-using System.Collections.Generic;
-using UnityEngine;
+using UnityEngine;
 
 namespace Mirage.Examples.InterestManagement
 {
@@ -20,13 +18,13 @@ public void Spawn()
 
         public void SpawnPrefab()
         {
-            Vector3 position = new Vector3(
+            var position = new Vector3(
                 (Random.value - 0.5f) * bounds.size.x + bounds.center.x,
                 (Random.value - 0.5f) * bounds.size.y + bounds.center.y,
                 (Random.value - 0.5f) * bounds.size.z + bounds.center.z
             );
 
-            var newLoot = GameObject.Instantiate(prefab, position, Quaternion.identity, transform);
+            NetworkIdentity newLoot = GameObject.Instantiate(prefab, position, Quaternion.identity, transform);
 
             serverObjectManager.Spawn(newLoot);
         }
diff --git a/Assets/Mirage/Samples~/InterestManagement/Scripts/Wander.cs b/Assets/Mirage/Samples~/InterestManagement/Scripts/Wander.cs
index 9f3d333b66e..24929d5b3ba 100644
--- a/Assets/Mirage/Samples~/InterestManagement/Scripts/Wander.cs
+++ b/Assets/Mirage/Samples~/InterestManagement/Scripts/Wander.cs
@@ -1,5 +1,4 @@
 using System.Collections;
-using System.Collections.Generic;
 using UnityEngine;
 using UnityEngine.AI;
 
diff --git a/Assets/Tests/Performance/Runtime/HeadlessBenchmark/Scripts/HeadlessBenchmark.cs b/Assets/Tests/Performance/Runtime/HeadlessBenchmark/Scripts/HeadlessBenchmark.cs
index 6a8c54c569a..10bd36ff674 100644
--- a/Assets/Tests/Performance/Runtime/HeadlessBenchmark/Scripts/HeadlessBenchmark.cs
+++ b/Assets/Tests/Performance/Runtime/HeadlessBenchmark/Scripts/HeadlessBenchmark.cs
@@ -99,7 +99,7 @@ void ParseForServerMode()
         {
             if (string.IsNullOrEmpty(GetArg("-server"))) return;
 
-            var serverGo = Instantiate(ServerPrefab);
+            GameObject serverGo = Instantiate(ServerPrefab);
             serverGo.name = "Server";
             server = serverGo.GetComponent<NetworkServer>();
             server.MaxConnections = 9999;
@@ -158,7 +158,7 @@ async UniTaskVoid StartClients()
 
         void StartClient(int i, string networkAddress)
         {
-            var clientGo = Instantiate(ClientPrefab);
+            GameObject clientGo = Instantiate(ClientPrefab);
             clientGo.name = $"Client {i}";
             NetworkClient client = clientGo.GetComponent<NetworkClient>();
             ClientObjectManager objectManager = clientGo.GetComponent<ClientObjectManager>();
diff --git a/Assets/Tests/Runtime/Host/NetworkIdentityTests.cs b/Assets/Tests/Runtime/Host/NetworkIdentityTests.cs
index 12cbc02b3f3..c997a1681c9 100644
--- a/Assets/Tests/Runtime/Host/NetworkIdentityTests.cs
+++ b/Assets/Tests/Runtime/Host/NetworkIdentityTests.cs
@@ -257,7 +257,7 @@ public override void ExtraTearDown()
         [UnityTest]
         public IEnumerator ClientNotNullAfterSpawnInStarted() => UniTask.ToCoroutine(async () =>
         {
-            await AsyncUtil.WaitUntilWithTimeout(() => testIdentity.Client == (client as INetworkClient));
+            await AsyncUtil.WaitUntilWithTimeout(() => (testIdentity.Client as NetworkClient) == client);
         });
     }
 }
diff --git a/Assets/Tests/SocketLayer/PeerTestConnecting.cs b/Assets/Tests/SocketLayer/PeerTestConnecting.cs
index 5e508070d77..604e8e6d854 100644
--- a/Assets/Tests/SocketLayer/PeerTestConnecting.cs
+++ b/Assets/Tests/SocketLayer/PeerTestConnecting.cs
@@ -1,7 +1,6 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
-using System.Net;
 using Mirage.Tests;
 using NSubstitute;
 using NUnit.Framework;

From 76fab8a563cf6a41463cbde9b656d2cda6a1fe22 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Fri, 16 Jul 2021 16:29:47 +0100
Subject: [PATCH 064/166] docs: adding pull request titles to the contribution
 guide

---
 CONTRIBUTING.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 7fcadfaa157..981011f9186 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -74,6 +74,27 @@ Before creating enhancement suggestions, please check the list of enhancements s
 
 ### Creating Pull Requests
 
+#### Pull Request titles
+
+A Pull Request title should follow [these rules](https://www.npmjs.com/package/@commitlint/config-conventional).
+
+The title must start with one of the following:
+- build
+- chore
+- ci
+- docs
+- feat
+- fix
+- perf
+- refactor
+- revert
+- style
+- test
+
+If a Pull request to a certain part of the project its scope can be put after the type, For example `fix(WelcomeWindow): ...` for a Pull request fixing something in the welcome window.
+
+For a full list of rules check the [conventional config](https://www.npmjs.com/package/@commitlint/config-conventional).
+
 #### How Do I Submit A (Good) Pull Request?
 
 Please send a [GitHub Pull Request](https://github.com/MirageNet/Mirage/compare) with a clear list of what you've done (read more about [pull requests](http://help.github.com/pull-requests/)). 

From 5c216de5411f6ae9e8a7bb14e52323e214be2793 Mon Sep 17 00:00:00 2001
From: James-Frowen Laptop2 <jamesfrowen5@gmail.com>
Date: Mon, 19 Jul 2021 14:13:58 +0100
Subject: [PATCH 065/166] perf: removing allocations from assert

---
 .../Mirage/Runtime/SocketLayer/Connection.cs  | 16 +++++--------
 .../Runtime/SocketLayer/LoggerExtensions.cs   | 24 +++++++++++++++++++
 .../SocketLayer/LoggerExtensions.cs.meta      | 11 +++++++++
 Assets/Mirage/Runtime/SocketLayer/Peer.cs     | 21 +++++-----------
 4 files changed, 47 insertions(+), 25 deletions(-)
 create mode 100644 Assets/Mirage/Runtime/SocketLayer/LoggerExtensions.cs
 create mode 100644 Assets/Mirage/Runtime/SocketLayer/LoggerExtensions.cs.meta

diff --git a/Assets/Mirage/Runtime/SocketLayer/Connection.cs b/Assets/Mirage/Runtime/SocketLayer/Connection.cs
index e8a6c8a65bf..0de6ec7815d 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Connection.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Connection.cs
@@ -57,10 +57,6 @@ internal interface IRawConnection
     /// </summary>
     internal sealed class Connection : IConnection, IRawConnection
     {
-        void Assert(bool condition, object msg = null)
-        {
-            if (!condition) logger.Log(LogType.Assert, msg == null ? "Failed Assertion" : $"Failed Assertion: {msg}");
-        }
         readonly ILogger logger;
 
         ConnectionState _state;
@@ -73,19 +69,19 @@ public ConnectionState State
                 switch (value)
                 {
                     case ConnectionState.Connected:
-                        Assert(_state == ConnectionState.Created || _state == ConnectionState.Connecting);
+                        logger.Assert(_state == ConnectionState.Created || _state == ConnectionState.Connecting);
                         break;
 
                     case ConnectionState.Connecting:
-                        Assert(_state == ConnectionState.Created);
+                        logger.Assert(_state == ConnectionState.Created);
                         break;
 
                     case ConnectionState.Disconnected:
-                        Assert(_state == ConnectionState.Connected);
+                        logger.Assert(_state == ConnectionState.Connected);
                         break;
 
                     case ConnectionState.Destroyed:
-                        Assert(_state == ConnectionState.Removing);
+                        logger.Assert(_state == ConnectionState.Removing);
                         break;
                 }
 
@@ -303,7 +299,7 @@ private void HandleFragmentedMessage(AckSystem.ReliableReceived received)
 
             // copy first
             int copyLength = received.length - 1;
-            Assert(copyLength == ackSystem.SizePerFragment, "First should be max size");
+            logger.Assert(copyLength == ackSystem.SizePerFragment, "First should be max size");
             Buffer.BlockCopy(firstArray, 1, message, 0, copyLength);
             received.buffer.Release();
 
@@ -314,7 +310,7 @@ private void HandleFragmentedMessage(AckSystem.ReliableReceived received)
                 AckSystem.ReliableReceived next = ackSystem.GetNextFragment();
                 byte[] nextArray = next.buffer.array;
 
-                Assert(i == (fragmentLength - 1 - nextArray[0]), "fragment index should decrement each time");
+                logger.Assert(i == (fragmentLength - 1 - nextArray[0]), "fragment index should decrement each time");
 
                 // +1 because first is copied above
                 copyLength = next.length - 1;
diff --git a/Assets/Mirage/Runtime/SocketLayer/LoggerExtensions.cs b/Assets/Mirage/Runtime/SocketLayer/LoggerExtensions.cs
new file mode 100644
index 00000000000..5291a11a042
--- /dev/null
+++ b/Assets/Mirage/Runtime/SocketLayer/LoggerExtensions.cs
@@ -0,0 +1,24 @@
+using UnityEngine;
+
+namespace Mirage.SocketLayer
+{
+    internal static class LoggerExtensions
+    {
+        internal static void Assert(this ILogger logger, bool condition)
+        {
+            if (!condition) logger.Log(LogType.Assert, "Failed Assertion");
+        }
+        internal static void Assert<T>(this ILogger logger, bool condition, T msg )
+        {
+            if (!condition) logger.Log(LogType.Assert, $"Failed Assertion: {msg}");
+        }
+        internal static void Error<T>(this ILogger logger, T msg = default)
+        {
+             logger.Log(LogType.Error, msg);
+        }
+        internal static void Warn<T>(this ILogger logger, T msg = default)
+        {
+            logger.Log(LogType.Warning, msg);
+        }
+    }
+}
diff --git a/Assets/Mirage/Runtime/SocketLayer/LoggerExtensions.cs.meta b/Assets/Mirage/Runtime/SocketLayer/LoggerExtensions.cs.meta
new file mode 100644
index 00000000000..88fca88fdc9
--- /dev/null
+++ b/Assets/Mirage/Runtime/SocketLayer/LoggerExtensions.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 2aa54265e69bdd343ad586b852f9864e
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Runtime/SocketLayer/Peer.cs b/Assets/Mirage/Runtime/SocketLayer/Peer.cs
index 43d39968d8b..71088a11545 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Peer.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Peer.cs
@@ -30,14 +30,6 @@ public interface IPeer
     /// </summary>
     public sealed class Peer : IPeer
     {
-        void Assert(bool condition, object msg = null)
-        {
-            if (!condition) logger.Log(LogType.Assert, msg == null ? "Failed Assertion" : $"Failed Assertion: {msg}");
-        }
-        void Error(string error)
-        {
-            logger.Log(LogType.Error, error);
-        }
         readonly ILogger logger;
         readonly Metrics metrics;
         readonly ISocket socket;
@@ -131,7 +123,7 @@ internal void Send(Connection connection, byte[] data, int length)
         {
             // connecting connections can send connect messages so is allowed
             // todo check connected before message are sent from high level
-            Assert(connection.State == ConnectionState.Connected || connection.State == ConnectionState.Connecting || connection.State == ConnectionState.Disconnected, connection.State);
+            logger.Assert(connection.State == ConnectionState.Connected || connection.State == ConnectionState.Connecting || connection.State == ConnectionState.Disconnected, connection.State);
 
             socket.Send(connection.EndPoint, data, length);
             metrics?.OnSend(length);
@@ -436,7 +428,7 @@ private void HandleConnectionRequest(Connection connection)
                     break;
 
                 case ConnectionState.Connecting:
-                    Error($"Server connections should not be in {nameof(ConnectionState.Connecting)} state");
+                    logger.Error($"Server connections should not be in {nameof(ConnectionState.Connecting)} state");
                     break;
             }
         }
@@ -453,7 +445,7 @@ void HandleConnectionAccepted(Connection connection)
             switch (connection.State)
             {
                 case ConnectionState.Created:
-                    Error($"Accepted Connections should not be in {nameof(ConnectionState.Created)} state");
+                    logger.Error($"Accepted Connections should not be in {nameof(ConnectionState.Created)} state");
                     break;
 
                 case ConnectionState.Connected:
@@ -476,7 +468,7 @@ void HandleConnectionRejected(Connection connection, Packet packet)
                     break;
 
                 default:
-                    Error($"Rejected Connections should not be in {nameof(ConnectionState.Created)} state");
+                    logger.Error($"Rejected Connections should not be in {nameof(ConnectionState.Created)} state");
                     break;
             }
         }
@@ -512,8 +504,7 @@ internal void FailedToConnect(Connection connection, RejectReason reason)
         internal void RemoveConnection(Connection connection)
         {
             // shouldn't be trying to removed a destroyed connected
-            Assert(connection.State != ConnectionState.Destroyed);
-            Assert(connection.State != ConnectionState.Removing);
+            logger.Assert(connection.State != ConnectionState.Destroyed && connection.State != ConnectionState.Removing);
 
             connection.State = ConnectionState.Removing;
             connectionsToRemove.Add(connection);
@@ -550,7 +541,7 @@ void RemoveConnections()
                 connection.State = ConnectionState.Destroyed;
 
                 // value should be removed from dictionary
-                Assert(removed);
+                logger.Assert(removed);
             }
             connectionsToRemove.Clear();
         }

From 7c8e75a4e25e34d3eac3ac898797eddab39ce50a Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Mon, 19 Jul 2021 14:01:43 +0000
Subject: [PATCH 066/166] chore(release): 100.0.1 [skip ci]

## [100.0.1](https://github.com/MirageNet/Mirage/compare/v100.0.0...v100.0.1) (2021-07-19)

### Bug Fixes

* **NanoSocket:** adding Exception when nanosocket bind fails ([a3028ec](https://github.com/MirageNet/Mirage/commit/a3028ecb06084574cbbb0b10bbd33394d44d94d2))

### Performance Improvements

* adding native UDP socket (NanoSockets) for supported platforms ([#860](https://github.com/MirageNet/Mirage/issues/860)) ([3f34863](https://github.com/MirageNet/Mirage/commit/3f34863b65325a54d6a4542c7b767fedc1abf406))
* removing allocations from assert ([5c216de](https://github.com/MirageNet/Mirage/commit/5c216de5411f6ae9e8a7bb14e52323e214be2793))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs        |  2 +-
 Assets/Mirage/CHANGELOG.md                          | 13 +++++++++++++
 Assets/Mirage/Components/AssemblyInfo.cs            |  2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs               |  2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs   |  2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs              |  2 +-
 .../RigidbodyPhysics/Scripts/AssemblyInfo.cs        |  2 +-
 Assets/Mirage/package.json                          |  2 +-
 8 files changed, 20 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index aa42677c45e..f243eb609c9 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("100.0.0")]
+[assembly: AssemblyVersion("100.0.1")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index 5d8e68ab757..6911cd01289 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,16 @@
+## [100.0.1](https://github.com/MirageNet/Mirage/compare/v100.0.0...v100.0.1) (2021-07-19)
+
+
+### Bug Fixes
+
+* **NanoSocket:** adding Exception when nanosocket bind fails ([a3028ec](https://github.com/MirageNet/Mirage/commit/a3028ecb06084574cbbb0b10bbd33394d44d94d2))
+
+
+### Performance Improvements
+
+* adding native UDP socket (NanoSockets) for supported platforms ([#860](https://github.com/MirageNet/Mirage/issues/860)) ([3f34863](https://github.com/MirageNet/Mirage/commit/3f34863b65325a54d6a4542c7b767fedc1abf406))
+* removing allocations from assert ([5c216de](https://github.com/MirageNet/Mirage/commit/5c216de5411f6ae9e8a7bb14e52323e214be2793))
+
 # [100.0.0](https://github.com/MirageNet/Mirage/compare/v99.1.0...v100.0.0) (2021-07-15)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index 18562b4c7ff..410f686bdf1 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("100.0.0")]
+[assembly: AssemblyVersion("100.0.1")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index c2e8fd9c749..a5cd8c806e6 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("100.0.0")]
+[assembly: AssemblyVersion("100.0.1")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index 70b1bac847b..e6d25b81987 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("100.0.0")]
+[assembly: AssemblyVersion("100.0.1")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index aa42677c45e..f243eb609c9 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("100.0.0")]
+[assembly: AssemblyVersion("100.0.1")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index aa42677c45e..f243eb609c9 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("100.0.0")]
+[assembly: AssemblyVersion("100.0.1")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 06a0dccc607..68c1a49a7ca 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "100.0.0",
+    "version": "100.0.1",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From af9b3f8df043708c3c237e59ee5aa015187c0528 Mon Sep 17 00:00:00 2001
From: Pavel Hodoval <pajah14@gmail.com>
Date: Mon, 19 Jul 2021 20:18:19 +0200
Subject: [PATCH 067/166] docs: fix template (#864)

---
 .../unity/partials/navbar.tmpl.partial        |  32 ++---
 doc/templates/unity/styles/main.css           | 119 +++++++++++++++---
 2 files changed, 116 insertions(+), 35 deletions(-)

diff --git a/doc/templates/unity/partials/navbar.tmpl.partial b/doc/templates/unity/partials/navbar.tmpl.partial
index 5f797dee013..44076add92b 100644
--- a/doc/templates/unity/partials/navbar.tmpl.partial
+++ b/doc/templates/unity/partials/navbar.tmpl.partial
@@ -13,21 +13,23 @@
     </div>
     <div class="collapse navbar-collapse" id="navbar">
       <form class="navbar-form navbar-right" role="search" id="search">
-		<div class="toggle-mode">
-			<div class="icon">
-			<i aria-hidden="true">🌕</i>
-		</div>
-		<label class="switch">
-			<input type="checkbox" id="switch-style">
-			<span class="slider round"></span>
-		</label>
-		<div class="icon">
-			<i aria-hidden="true">🌙</i>
-		</div>
-			<script type="text/javascript" src="{{_rel}}styles/toggle-theme.js"></script>
-		</div>
-        <div class="form-group">
-          <input type="text" class="form-control" id="search-query" placeholder="Search" autocomplete="off">
+        <div class="navbar-form-flex">
+          <div class="toggle-mode">
+            <div class="icon">
+            <i aria-hidden="true">🌕</i>
+          </div>
+          <label class="switch">
+            <input type="checkbox" id="switch-style">
+            <span class="slider round"></span>
+          </label>
+          <div class="icon">
+            <i aria-hidden="true">🌙</i>
+          </div>
+            <script type="text/javascript" src="{{_rel}}styles/toggle-theme.js"></script>
+          </div>
+          <div class="form-group">
+            <input type="text" class="form-control" id="search-query" placeholder="Search" autocomplete="off">
+          </div>
         </div>
       </form>
     </div>
diff --git a/doc/templates/unity/styles/main.css b/doc/templates/unity/styles/main.css
index 0d452e96071..15aac9b6824 100644
--- a/doc/templates/unity/styles/main.css
+++ b/doc/templates/unity/styles/main.css
@@ -1,25 +1,40 @@
 :root, body.dark-theme {
   --color-foreground: #ccd5dc;
-  --color-navbar: #66666d;
+  --color-navbar: #bbbbbd;
   --color-breadcrumb: #999;
   --color-underline: #ddd;
-  --color-toc-hover: #fff;
   --color-background: #2d2d30;
   --color-background-subnav: #333337;
   --color-background-dark: #1e1e1e;
   --color-background-table-alt: #212123;
   --color-background-quote: #69696e;
+  --color-toc: var(--color-foreground);
+  --color-toc-hover: #fff;
+  --color-pre-background: var(--color-background-dark);
+  --color-pre-border: transparent;
+  --color-code-background: var(--color-background-dark);
+  --color-background-alert: var(--color-background-dark);
+  --color-tip-background: var(--color-background-dark);
+  --color-toc-active-background: var(--color-background-dark);
 }
 
-body.light-theme {
+:root, body.light-theme {
   --color-foreground: #465563;
-  --color-breadcrumb: #4a4a4a;
-  --color-toc-hover: #fff;
+  --color-navbar-active: #00cccc;
+  --color-breadcrumb: #d54473;
   --color-background: #ffffff;
   --color-background-subnav: #ddd;
-  --color-background-dark: #1f2a2d;
+  --color-background-dark: #262f39;
   --color-background-table-alt: #f9f9f9;
   --color-navbar: #fff;
+  --color-toc: #455463;
+  --color-toc-hover: #455463;
+  --color-pre-background: #fff;
+  --color-pre-border: #ddd;
+  --color-code-background: #f1f2f3;
+  --color-background-alert: inherit;
+  --color-tip-background: #ffdfe9;
+  --color-toc-active-background: #222c37;
 }
 
 body {
@@ -91,19 +106,29 @@ article h4 {
 }
 
 .navbar-inverse .navbar-nav>li>a:focus, .navbar-inverse .navbar-nav>li>a:hover {
-  color: var(--color-foreground);
+  color: var(--color-navbar-active);
   background-color: var(--color-background-dark);
-  border-bottom: 3px solid var(--color-background-subnav);
+  border-bottom: 3px solid var(--color-navbar-active);
   transition: all ease 0.25s;
 }
 
 .navbar-inverse .navbar-nav>.active>a, .navbar-inverse .navbar-nav>.active>a:focus, .navbar-inverse .navbar-nav>.active>a:hover {
-  color: var(--color-foreground);
+  color: var(--color-navbar-active);
   background-color: var(--color-background-dark);
-  border-bottom: 3px solid var(--color-foreground);
+  border-bottom: 3px solid var(--color-navbar-active);
   transition: all ease 0.25s;
 }
 
+.navbar-form-flex {
+  display: flex;
+  align-items: center;
+}
+
+.navbar-form .form-group {
+  flex: 0 1 250px;
+  width: auto !important;
+}
+
 .navbar-form .form-control {
   border: none;
   border-radius: 0;
@@ -118,7 +143,43 @@ article h4 {
 }
 
 .toc .nav>li>a {
-  color: var(--color-foreground);
+  color: var(--color-toc);
+}
+
+ul.nav.level2>li.active.in>a.active {
+    background: var(--color-toc-active-background);
+    color: #fff;
+    padding: 5px 8px;
+    text-decoration: none;
+    font-weight: normal;
+}
+
+.toc .nav>li.active>.expand-stub::before, .toc .nav>li.in>.expand-stub::before, .toc .nav>li.in.active>.expand-stub::before, .toc .nav>li.filtered>.expand-stub::before {
+    width: 12px;
+    height: 12px;
+    cursor: pointer;
+    border: #19e3b1 1px solid;
+    font-size: 8px;
+    background: #19e3b1;
+    color: #fff;
+    content: "-";
+    display: table;
+    margin-top: 3px;
+    text-align: center;
+}
+
+.toc .nav>li>.expand-stub::before, .toc .nav>li.active>.expand-stub::before {
+    width: 12px;
+    height: 12px;
+    cursor: pointer;
+    border: #19e3b1 1px solid;
+    font-size: 8px;
+    background: #19e3b1;
+    color: #fff;
+    content: "+";
+    display: table;
+    margin-top: 3px;
+    text-align: center;
 }
 
 .sidefilter {
@@ -173,27 +234,24 @@ article h4 {
 }
 
 .alert {
-  background-color: inherit;
+  background-color: var(--color-background-alert);
   border: none;
-  padding: 10px 0;
+  padding: 0px 0px 5px 0px;
   border-radius: 0;
+  box-shadow: 0px 2px 2px 0px rgba(100, 100, 100, 0.4);
 }
 
 .alert>p {
   margin-bottom: 0;
   padding: 5px 10px;
-  border-bottom: 1px solid;
-  background-color: var(--color-background-dark);
 }
 
 .alert>h5 {
   padding: 10px 15px;
   margin-top: 0;
-  margin-bottom: 0;
   text-transform: uppercase;
   font-weight: bold;
   border-top: 2px solid;
-  background-color: var(--color-background-dark);
   border-radius: none;
 }
 
@@ -214,22 +272,38 @@ article h4 {
   color: #d32f2f;
 }
 
+.alert-tip>h5 {
+    color: #d54473;
+    background-color: var(--color-tip-background);
+    content: "\e162";
+}
+
+.alert-tip h5:before {
+    content: "\e162";
+}
+
 pre {
   padding: 9.5px;
   margin: 0 0 10px;
   font-size: 13px;
   word-break: break-all;
   word-wrap: break-word;
-  background-color: var(--color-background-dark);
+  background-color: var(--color-pre-background);
   border-radius: 0;
-  border: none;
+  border-width: 1px;
+  border-style: solid;
+  border-color: var(--color-pre-border);
 }
 
 code {
-  background: var(--color-background-dark) !important;
+  background: var(--color-code-background) !important;
   border-radius: 2px;
 }
 
+pre code {
+  background: inherit !important;
+}
+
 .hljs {
   color: var(--color-foreground);
 }
@@ -302,6 +376,7 @@ code {
 .toc .nav>li>a:hover, .toc .nav>li>a:focus {
   color: var(--color-toc-hover);
   transition: all ease 0.1s;
+  text-decoration: underline;
 }
 
 .form-control {
@@ -423,6 +498,10 @@ input:checked + .slider:before {
 .slider.round:before {
   border-radius: 50%;
 }
+.toggle-mode {
+  flex: 1 1;
+  white-space: nowrap;
+}
 .toggle-mode .icon {
   display: inline-block;
 }

From 2f4112c61ab902bcf4afeeb2ffa7a983b24d4c7e Mon Sep 17 00:00:00 2001
From: Pavel Hodoval <pajah14@gmail.com>
Date: Tue, 20 Jul 2021 15:03:26 +0200
Subject: [PATCH 068/166] docs: update README (#865)

---
 README.md | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 98be7313812..0219a29f1ac 100644
--- a/README.md
+++ b/README.md
@@ -93,12 +93,11 @@ If you want to contribute to  Mirage, follow these steps:
 3) Open in unity 2019.4.x or later
 
 ## Transport and Sockets
-
 Mirage supports multiple ways of transporting data:
-- C# UDP Socket (default)
-- Native UDP socket (coming soon)
-- Websocket, to support webgl clients (coming soon)
+- Native UDP socket (default on Windows, Mac and Linux)
+- C# UDP Socket (default on other platforms)
 - Steam ([Facepunch Steamworks](https://github.com/MirageNet/SteamyFaceNG))
+- Websocket, to support webgl clients (coming soon)
 
 
 ## Contributing

From 00945f3f310453f5e57e1b6495be125282d3b8c3 Mon Sep 17 00:00:00 2001
From: James-Frowen Laptop2 <jamesfrowen5@gmail.com>
Date: Tue, 20 Jul 2021 15:42:16 +0100
Subject: [PATCH 069/166] perf: removing alloc from reliable sends

---
 .../Mirage/Runtime/SocketLayer/AckSystem.cs   | 57 +++++++++++++++----
 Assets/Mirage/Runtime/SocketLayer/Pool.cs     |  5 +-
 2 files changed, 48 insertions(+), 14 deletions(-)

diff --git a/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs b/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
index 0f0f9a8557b..86330cb11e2 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
@@ -39,6 +39,7 @@ internal class AckSystem
         readonly IRawConnection connection;
         readonly ITime time;
         readonly Pool<ByteBuffer> bufferPool;
+        readonly Pool<ReliablePacket> reliablePool;
         readonly Metrics metrics;
 
         //todo implement this
@@ -84,6 +85,7 @@ public AckSystem(IRawConnection connection, Config config, ITime time, Pool<Byte
             this.connection = connection;
             this.time = time;
             this.bufferPool = bufferPool;
+            this.reliablePool = new Pool<ReliablePacket>(ReliablePacket.CreateNew, default, 5, maxPacketsInSendBufferPerConnection);
             this.metrics = metrics;
 
             ackTimeout = config.TimeBeforeEmptyAck;
@@ -351,15 +353,17 @@ private ReliablePacket CreateReliableBuffer(PacketType packetType)
         {
             ushort order = (ushort)reliableOrder.Next();
 
-            ByteBuffer final = bufferPool.Take();
+            ReliablePacket packet = reliablePool.Take();
+            ByteBuffer buffer = bufferPool.Take();
 
             int offset = 0;
-            ByteUtils.WriteByte(final.array, ref offset, (byte)packetType);
+            ByteUtils.WriteByte(buffer.array, ref offset, (byte)packetType);
 
             offset = SEQUENCE_HEADER;
-            ByteUtils.WriteUShort(final.array, ref offset, order);
+            ByteUtils.WriteUShort(buffer.array, ref offset, order);
 
-            return new ReliablePacket(final, RELIABLE_HEADER_SIZE, order);
+            packet.Setup(order, buffer, RELIABLE_HEADER_SIZE);
+            return packet;
         }
 
         static void AddToBatch(ReliablePacket packet, byte[] message, int offset, int length)
@@ -559,7 +563,7 @@ private void ackMessagesInSentQueue(ushort sequence, ulong mask)
                 uint ackableSequence = (uint)sequencer.MoveInBounds(start + i);
                 AckablePacket ackable = sentAckablePackets[ackableSequence];
 
-                if (ackable.Equals(default))
+                if (ackable.IsNotValid())
                     continue;
 
                 if (alreadyAcked(ackable, ackableSequence))
@@ -574,6 +578,7 @@ private bool alreadyAcked(AckablePacket ackable, uint ackableSequence)
             // if we have already ackeds this, just remove it
             if (ackable.IsReliable && ackable.reliablePacket.acked)
             {
+                Debug.Assert(false, "We should never see an already ackked packet, it should have been removed");
                 // this should never happen because packet should be removed when acked is set to true
                 // but remove it just incase we get here
                 sentAckablePackets.RemoveAt(ackableSequence);
@@ -614,11 +619,11 @@ private void CheckAckablePacket(ushort sequence, ulong mask, AckablePacket ackab
 
         private void reliableAcked(ReliablePacket reliablePacket)
         {
-            reliablePacket.OnAck();
             foreach (ushort seq in reliablePacket.sequences)
             {
                 sentAckablePackets.RemoveAt(seq);
             }
+            reliablePacket.OnAck();
         }
 
         private void reliableLost(ushort sequence, ReliablePacket reliablePacket)
@@ -684,6 +689,15 @@ public bool Equals(AckablePacket other)
                 return token == other.token &&
                     reliablePacket == other.reliablePacket;
             }
+
+            /// <summary>
+            /// returns true if this is default value of struct
+            /// </summary>
+            /// <returns></returns>
+            public bool IsNotValid()
+            {
+                return token == null && reliablePacket == null;
+            }
         }
 
         class ReliablePacket
@@ -692,9 +706,11 @@ class ReliablePacket
             public bool acked;
             public int length;
 
-            public readonly List<ushort> sequences = new List<ushort>();
-            public readonly ByteBuffer buffer;
-            public readonly ushort order;
+            public ByteBuffer buffer;
+            public ushort order;
+
+            public readonly List<ushort> sequences = new List<ushort>(4);
+            private readonly Pool<ReliablePacket> pool;
 
             public void OnSend(ushort sequence)
             {
@@ -706,13 +722,25 @@ public void OnAck()
             {
                 acked = true;
                 buffer.Release();
+                Release();
             }
 
-            public ReliablePacket(ByteBuffer packet, int length, ushort order)
+            public void Setup(ushort order, ByteBuffer buffer, int length)
             {
-                buffer = packet;
-                this.length = length;
                 this.order = order;
+                this.buffer = buffer;
+                this.length = length;
+            }
+
+            public void Release()
+            {
+                sequences.Clear();
+                pool.Put(this);
+            }
+
+            private ReliablePacket(Pool<ReliablePacket> pool)
+            {
+                this.pool = pool;
             }
 
             public override int GetHashCode()
@@ -729,6 +757,11 @@ public override bool Equals(object obj)
                 }
                 return false;
             }
+
+            public static ReliablePacket CreateNew(int _size, Pool<ReliablePacket> pool)
+            {
+                return new ReliablePacket(pool);
+            }
         }
         public struct ReliableReceived : IEquatable<ReliableReceived>
         {
diff --git a/Assets/Mirage/Runtime/SocketLayer/Pool.cs b/Assets/Mirage/Runtime/SocketLayer/Pool.cs
index a0700e3f218..82650534c44 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Pool.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Pool.cs
@@ -13,7 +13,8 @@ public class Pool<T> where T : class
         int maxPoolSize;
         readonly int bufferSize;
         readonly ILogger logger;
-        readonly Func<int, Pool<T>, T> createNew;
+        public delegate T CreateNewItem(int bufferSize, Pool<T> pool);
+        readonly CreateNewItem createNew;
 
 
         T[] pool;
@@ -50,7 +51,7 @@ public void Configure(int startPoolSize, int maxPoolSize)
         /// <param name="startPoolSize">how many buffers to create at start</param>
         /// <param name="maxPoolSize">max number of buffers in pool</param>
         /// <param name="logger"></param>
-        public Pool(Func<int, Pool<T>, T> createNew, int bufferSize, int startPoolSize, int maxPoolSize, ILogger logger = null)
+        public Pool(CreateNewItem createNew, int bufferSize, int startPoolSize, int maxPoolSize, ILogger logger = null)
         {
             if (startPoolSize > maxPoolSize) throw new ArgumentException("Start size must be less than max size", nameof(startPoolSize));
             this.createNew = createNew ?? throw new ArgumentNullException(nameof(createNew));

From 5c163ede7f422941ae97efd9dadcc8123df1d68e Mon Sep 17 00:00:00 2001
From: James-Frowen Laptop2 <jamesfrowen5@gmail.com>
Date: Tue, 20 Jul 2021 16:55:28 +0100
Subject: [PATCH 070/166] fixing ack

---
 Assets/Mirage/Runtime/SocketLayer/AckSystem.cs | 15 +++++++--------
 Assets/Tests/SocketLayer/BufferPoolTest.cs     |  6 +++---
 2 files changed, 10 insertions(+), 11 deletions(-)

diff --git a/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs b/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
index 86330cb11e2..5a43621cf40 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
@@ -85,7 +85,7 @@ public AckSystem(IRawConnection connection, Config config, ITime time, Pool<Byte
             this.connection = connection;
             this.time = time;
             this.bufferPool = bufferPool;
-            this.reliablePool = new Pool<ReliablePacket>(ReliablePacket.CreateNew, default, 5, maxPacketsInSendBufferPerConnection);
+            this.reliablePool = new Pool<ReliablePacket>(ReliablePacket.CreateNew, default, 0, config.MaxReliablePacketsInSendBufferPerConnection);
             this.metrics = metrics;
 
             ackTimeout = config.TimeBeforeEmptyAck;
@@ -722,22 +722,21 @@ public void OnAck()
             {
                 acked = true;
                 buffer.Release();
-                Release();
+                pool.Put(this);
             }
 
             public void Setup(ushort order, ByteBuffer buffer, int length)
             {
+                // reset old data
+                lastSequence = 0;
+                sequences.Clear();
+                acked = false;
+
                 this.order = order;
                 this.buffer = buffer;
                 this.length = length;
             }
 
-            public void Release()
-            {
-                sequences.Clear();
-                pool.Put(this);
-            }
-
             private ReliablePacket(Pool<ReliablePacket> pool)
             {
                 this.pool = pool;
diff --git a/Assets/Tests/SocketLayer/BufferPoolTest.cs b/Assets/Tests/SocketLayer/BufferPoolTest.cs
index 5c0b7128ec6..41a64805d35 100644
--- a/Assets/Tests/SocketLayer/BufferPoolTest.cs
+++ b/Assets/Tests/SocketLayer/BufferPoolTest.cs
@@ -25,7 +25,7 @@ public void ThrowsIfCreateIsNull()
         [Test]
         public void CallsCreateStartCountTimesWithCorrectArgs()
         {
-            Func<int, Pool<TestBuffer>, TestBuffer> create = Substitute.For<Func<int, Pool<TestBuffer>, TestBuffer>>();
+            var create = Substitute.For<Pool<TestBuffer>.CreateNewItem>();
 
             const int startCount = 5;
             const int bufferSize = 100;
@@ -37,7 +37,7 @@ public void CallsCreateStartCountTimesWithCorrectArgs()
         [Test]
         public void TakeDoesntCreateTillEmpty()
         {
-            Func<int, Pool<TestBuffer>, TestBuffer> create = Substitute.For<Func<int, Pool<TestBuffer>, TestBuffer>>();
+            var create = Substitute.For<Pool<TestBuffer>.CreateNewItem>();
             create.Invoke(default, default).Returns((args) => TestBuffer.Create((int)args[0], (Pool<TestBuffer>)args[0]));
 
             const int startCount = 5;
@@ -62,7 +62,7 @@ public void TakeDoesntCreateTillEmpty()
         [Test]
         public void CanTakeMoreAfterPuttingSomeBackWithoutCreatingNew()
         {
-            Func<int, Pool<TestBuffer>, TestBuffer> create = Substitute.For<Func<int, Pool<TestBuffer>, TestBuffer>>();
+            var create = Substitute.For<Pool<TestBuffer>.CreateNewItem>();
             create.Invoke(default, default).Returns((args) => TestBuffer.Create((int)args[0], (Pool<TestBuffer>)args[1]));
 
             const int startCount = 5;

From 9113da1e2236c6c0749f2d698bed71377a554483 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Tue, 20 Jul 2021 18:50:52 +0100
Subject: [PATCH 071/166] removing acked

---
 .../Mirage/Runtime/SocketLayer/AckSystem.cs   | 27 ++++---------------
 1 file changed, 5 insertions(+), 22 deletions(-)

diff --git a/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs b/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
index 5a43621cf40..09f4af95905 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
@@ -85,7 +85,7 @@ public AckSystem(IRawConnection connection, Config config, ITime time, Pool<Byte
             this.connection = connection;
             this.time = time;
             this.bufferPool = bufferPool;
-            this.reliablePool = new Pool<ReliablePacket>(ReliablePacket.CreateNew, default, 0, config.MaxReliablePacketsInSendBufferPerConnection);
+            reliablePool = new Pool<ReliablePacket>(ReliablePacket.CreateNew, default, 0, config.MaxReliablePacketsInSendBufferPerConnection);
             this.metrics = metrics;
 
             ackTimeout = config.TimeBeforeEmptyAck;
@@ -380,8 +380,6 @@ static void AddToBatch(ReliablePacket packet, byte[] message, int offset, int le
 
         void SendReliablePacket(ReliablePacket reliable)
         {
-            if (reliable.acked) { return; }
-
             ushort sequence = (ushort)sentAckablePackets.Enqueue(new AckablePacket(reliable));
 
             byte[] final = reliable.buffer.array;
@@ -566,26 +564,10 @@ private void ackMessagesInSentQueue(ushort sequence, ulong mask)
                 if (ackable.IsNotValid())
                     continue;
 
-                if (alreadyAcked(ackable, ackableSequence))
-                    continue;
-
                 CheckAckablePacket(sequence, mask, ackable, ackableSequence);
             }
         }
 
-        private bool alreadyAcked(AckablePacket ackable, uint ackableSequence)
-        {
-            // if we have already ackeds this, just remove it
-            if (ackable.IsReliable && ackable.reliablePacket.acked)
-            {
-                Debug.Assert(false, "We should never see an already ackked packet, it should have been removed");
-                // this should never happen because packet should be removed when acked is set to true
-                // but remove it just incase we get here
-                sentAckablePackets.RemoveAt(ackableSequence);
-                return true;
-            }
-            return false;
-        }
         private void CheckAckablePacket(ushort sequence, ulong mask, AckablePacket ackable, uint ackableSequence)
         {
             int distance = (int)sentAckablePackets.Sequencer.Distance(sequence, ackableSequence);
@@ -623,6 +605,10 @@ private void reliableAcked(ReliablePacket reliablePacket)
             {
                 sentAckablePackets.RemoveAt(seq);
             }
+
+            // remove from toResend incase it was added in previous loop
+            toResend.Remove(reliablePacket);
+
             reliablePacket.OnAck();
         }
 
@@ -703,7 +689,6 @@ public bool IsNotValid()
         class ReliablePacket
         {
             public ushort lastSequence;
-            public bool acked;
             public int length;
 
             public ByteBuffer buffer;
@@ -720,7 +705,6 @@ public void OnSend(ushort sequence)
 
             public void OnAck()
             {
-                acked = true;
                 buffer.Release();
                 pool.Put(this);
             }
@@ -730,7 +714,6 @@ public void Setup(ushort order, ByteBuffer buffer, int length)
                 // reset old data
                 lastSequence = 0;
                 sequences.Clear();
-                acked = false;
 
                 this.order = order;
                 this.buffer = buffer;

From c57f64d7695e1bddefb39fa151ac21b5d2176f35 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Tue, 20 Jul 2021 20:35:00 +0100
Subject: [PATCH 072/166] perf: removing allocations from SendToMany

---
 Assets/Mirage/Runtime/NetworkServer.cs | 34 ++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/Assets/Mirage/Runtime/NetworkServer.cs b/Assets/Mirage/Runtime/NetworkServer.cs
index bf876ca4e71..eab65deeb28 100644
--- a/Assets/Mirage/Runtime/NetworkServer.cs
+++ b/Assets/Mirage/Runtime/NetworkServer.cs
@@ -401,6 +401,13 @@ public void SendToAll<T>(T msg, int channelId = Channel.Reliable)
             SendToMany(Players, msg, channelId);
         }
 
+        /// <summary>
+        /// Sends a message to many connections
+        /// </summary>
+        /// <typeparam name="T"></typeparam>
+        /// <param name="players"></param>
+        /// <param name="msg"></param>
+        /// <param name="channelId"></param>
         public static void SendToMany<T>(IEnumerable<INetworkPlayer> players, T msg, int channelId = Channel.Reliable)
         {
             using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
@@ -420,6 +427,33 @@ public static void SendToMany<T>(IEnumerable<INetworkPlayer> players, T msg, int
             }
         }
 
+        /// <summary>
+        /// Sends a message to many connections
+        /// <para>
+        /// Same as <see cref="SendToMany{T}(IEnumerable{INetworkPlayer}, T, int)"/> but uses for loop to avoid allocations
+        /// </para>
+        /// </summary>
+        /// <remarks>
+        /// Using list in foreach loop causes Unity's mono version to box the struct which causes allocations, <see href="https://docs.unity3d.com/2019.4/Documentation/Manual/BestPracticeUnderstandingPerformanceInUnity4-1.html">Understanding the managed heap</see>
+        /// </remarks>
+        public static void SendToMany<T>(IReadOnlyList<INetworkPlayer> players, T msg, int channelId = Channel.Reliable)
+        {
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                // pack message into byte[] once
+                MessagePacker.Pack(msg, writer);
+                var segment = writer.ToArraySegment();
+                int count = players.Count;
+
+                for (int i = 0; i < count; i++)
+                {
+                    players[i].Send(segment, channelId);
+                }
+
+                NetworkDiagnostics.OnSend(msg, segment.Count, count);
+            }
+        }
+
         void ConnectionAccepted(INetworkPlayer player)
         {
             if (logger.LogEnabled()) logger.Log("Server accepted client:" + player);

From 8edaa44e9582b6407c48512f38a01a6fc05fdf24 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Tue, 20 Jul 2021 20:35:55 +0100
Subject: [PATCH 073/166] refactor: replacing assert with error to give more
 details

---
 Assets/Mirage/Runtime/SocketLayer/Peer.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/Assets/Mirage/Runtime/SocketLayer/Peer.cs b/Assets/Mirage/Runtime/SocketLayer/Peer.cs
index 71088a11545..11aab6df3fe 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Peer.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Peer.cs
@@ -541,7 +541,10 @@ void RemoveConnections()
                 connection.State = ConnectionState.Destroyed;
 
                 // value should be removed from dictionary
-                logger.Assert(removed);
+                if (!removed)
+                {
+                    logger.Error($"Failed to remove {connection} from connection set");
+                }
             }
             connectionsToRemove.Clear();
         }

From b1c0a1203f841c2f78514cc1cf17935408985acf Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Tue, 20 Jul 2021 22:48:50 +0100
Subject: [PATCH 074/166] docs: improving doc comments for message handler

---
 Assets/Mirage/Runtime/MessageHandler.cs | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/Assets/Mirage/Runtime/MessageHandler.cs b/Assets/Mirage/Runtime/MessageHandler.cs
index b5b54014424..636d5024472 100644
--- a/Assets/Mirage/Runtime/MessageHandler.cs
+++ b/Assets/Mirage/Runtime/MessageHandler.cs
@@ -13,10 +13,13 @@ public class MessageHandler : IMessageReceiver
 
         readonly bool disconnectOnException;
 
-        // Handles network messages on client and server
+        /// <summary>
+        /// Handles network messages on client and server
+        /// </summary>
+        /// <param name="player"></param>
+        /// <param name="reader"></param>
         internal delegate void NetworkMessageDelegate(INetworkPlayer player, NetworkReader reader);
 
-        // message handlers for this connection
         internal readonly Dictionary<int, NetworkMessageDelegate> messageHandlers = new Dictionary<int, NetworkMessageDelegate>();
 
         public MessageHandler(bool disconnectOnException)
@@ -41,7 +44,6 @@ void AdapterFunction(INetworkPlayer player, NetworkReader reader)
         /// </summary>
         /// <typeparam name="T">Message type</typeparam>
         /// <param name="handler">Function handler which will be invoked for when this message type is received.</param>
-        /// <param name="requireAuthentication">True if the message requires an authenticated connection</param>
         public void RegisterHandler<T>(MessageDelegateWithPlayer<T> handler)
         {
             int msgType = MessagePacker.GetId<T>();
@@ -58,7 +60,6 @@ public void RegisterHandler<T>(MessageDelegateWithPlayer<T> handler)
         /// </summary>
         /// <typeparam name="T">Message type</typeparam>
         /// <param name="handler">Function handler which will be invoked for when this message type is received.</param>
-        /// <param name="requireAuthentication">True if the message requires an authenticated connection</param>
         public void RegisterHandler<T>(MessageDelegate<T> handler)
         {
             RegisterHandler<T>((_, value) => { handler(value); });

From 54942d617aaa247f83dc35768732c647738e599e Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Sun, 25 Jul 2021 21:46:55 +0000
Subject: [PATCH 075/166] chore(release): 100.0.2 [skip ci]

## [100.0.2](https://github.com/MirageNet/Mirage/compare/v100.0.1...v100.0.2) (2021-07-25)

### Performance Improvements

* removing alloc from reliable sends ([00945f3](https://github.com/MirageNet/Mirage/commit/00945f3f310453f5e57e1b6495be125282d3b8c3))
* removing allocations from SendToMany ([c57f64d](https://github.com/MirageNet/Mirage/commit/c57f64d7695e1bddefb39fa151ac21b5d2176f35))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs              | 2 +-
 Assets/Mirage/CHANGELOG.md                                | 8 ++++++++
 Assets/Mirage/Components/AssemblyInfo.cs                  | 2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                     | 2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs         | 2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs                    | 2 +-
 .../Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs     | 2 +-
 Assets/Mirage/package.json                                | 2 +-
 8 files changed, 15 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index f243eb609c9..153f22e3891 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("100.0.1")]
+[assembly: AssemblyVersion("100.0.2")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index 6911cd01289..5d9ae69ba2e 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,11 @@
+## [100.0.2](https://github.com/MirageNet/Mirage/compare/v100.0.1...v100.0.2) (2021-07-25)
+
+
+### Performance Improvements
+
+* removing alloc from reliable sends ([00945f3](https://github.com/MirageNet/Mirage/commit/00945f3f310453f5e57e1b6495be125282d3b8c3))
+* removing allocations from SendToMany ([c57f64d](https://github.com/MirageNet/Mirage/commit/c57f64d7695e1bddefb39fa151ac21b5d2176f35))
+
 ## [100.0.1](https://github.com/MirageNet/Mirage/compare/v100.0.0...v100.0.1) (2021-07-19)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index 410f686bdf1..b932bbc5817 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("100.0.1")]
+[assembly: AssemblyVersion("100.0.2")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index a5cd8c806e6..bd8aed108e1 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("100.0.1")]
+[assembly: AssemblyVersion("100.0.2")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index e6d25b81987..96ff7e71cd3 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("100.0.1")]
+[assembly: AssemblyVersion("100.0.2")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index f243eb609c9..153f22e3891 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("100.0.1")]
+[assembly: AssemblyVersion("100.0.2")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index f243eb609c9..153f22e3891 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("100.0.1")]
+[assembly: AssemblyVersion("100.0.2")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 68c1a49a7ca..59a01895a0e 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "100.0.1",
+    "version": "100.0.2",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From 0efe4babede7726a9dc10590b27194924e4ad7b5 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Thu, 29 Jul 2021 12:49:47 +0100
Subject: [PATCH 076/166] refactor: removing old version of sequencer

BREAKING CHANGE: removing old version of Sequencer, use version in socket layer instead
---
 Assets/Mirage/Runtime/Sequencer.cs            | 118 ------------------
 Assets/Mirage/Runtime/Sequencer.cs.meta       |  11 --
 .../Mirage/Runtime/SocketLayer/Sequencer.cs   |   1 +
 Assets/Tests/Editor/SequencerTest.cs          |  54 --------
 Assets/Tests/Editor/SequencerTest.cs.meta     |  11 --
 5 files changed, 1 insertion(+), 194 deletions(-)
 delete mode 100644 Assets/Mirage/Runtime/Sequencer.cs
 delete mode 100644 Assets/Mirage/Runtime/Sequencer.cs.meta
 delete mode 100644 Assets/Tests/Editor/SequencerTest.cs
 delete mode 100644 Assets/Tests/Editor/SequencerTest.cs.meta

diff --git a/Assets/Mirage/Runtime/Sequencer.cs b/Assets/Mirage/Runtime/Sequencer.cs
deleted file mode 100644
index ae6c938b79d..00000000000
--- a/Assets/Mirage/Runtime/Sequencer.cs
+++ /dev/null
@@ -1,118 +0,0 @@
-/*
-The MIT License (MIT)
-
-Copyright (c) 2020 Fredrik Holmstrom
-Copyright (c) 2020 Paul Pacheco
-
-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.
-*/
-
-namespace Mirage
-{
-    /// <summary>
-    /// A sequence generator that can wrap.
-    /// For example a 2 bit sequencer would generate
-    /// the following numbers:
-    /// <code>
-    ///     0,1,2,3,0,1,2,3,0,1,2,3...
-    /// </code>
-    /// </summary>
-    /// <example>
-    /// <code>
-    /// // create a 8 bit sequence generator
-    /// Sequencer sequencer = new Sequencer(8);
-    ///
-    /// ulong zero = sequencer.Next();
-    /// ulong one = sequencer.Next();
-    /// ...
-    /// ulong n = sequencer.Next();
-    /// 
-    /// // you can determine the distance between 2 sequences
-    /// // as long as they are withing 1/2 of the sequence space
-    ///
-    /// // this is equivalent to a - b adjusted for wrapping
-    /// int d = sequencer.Distance(a, b);
-    /// </code>
-    /// </example>
-    public struct Sequencer
-    {
-        readonly int shift;
-        readonly int bits;
-        readonly ulong mask;
-        ulong sequence;
-
-        /// <summary>
-        /// Number of bits used for the sequence generator
-        /// up to 64
-        /// </summary>
-        public int Bits => bits;
-
-        /// <summary>
-        /// Creates a sequencer
-        /// </summary>
-        /// <param name="bits">amount of bits for the sequence</param>
-        public Sequencer(int bits)
-        {
-            // 1 byte
-            // (1 << 8) = 256
-            // - 1      = 255
-            //          = 1111 1111
-
-            this.bits = bits;
-            sequence = 0;
-            mask = (1UL << bits) - 1UL;
-            shift = sizeof(ulong) * 8 - bits;
-        }
-
-        /// <summary>
-        /// Generates the next value in the sequence
-        /// starts with 0
-        /// </summary>
-        /// <returns>0, 1, 2, ... 2^n-1, 0, 1, 2, ...</returns>
-        public ulong Next()
-        {
-            ulong current = sequence;
-            sequence = NextAfter(sequence);
-            return current;
-        }
-
-        /// <summary>
-        /// Gets the next sequence value after a given sequence
-        /// wraps if necessary
-        /// </summary>
-        /// <param name="sequence">current sequence value</param>
-        /// <returns>the next sequence value</returns>
-        public ulong NextAfter(ulong sequence)
-        {
-            return (sequence + 1UL) & mask;
-        }
-
-        /// <summary>
-        /// Calculates the distance between 2 sequences, taking into account
-        /// wrapping
-        /// </summary>
-        /// <param name="from">current sequence value</param>
-        /// <param name="to">previous sequence value</param>
-        /// <returns>from - to, adjusted for wrapping</returns>
-        public long Distance(ulong from, ulong to)
-        {
-            to <<= shift;
-            from <<= shift;
-            return ((long)(from - to)) >> shift;
-        }
-    }
-}
\ No newline at end of file
diff --git a/Assets/Mirage/Runtime/Sequencer.cs.meta b/Assets/Mirage/Runtime/Sequencer.cs.meta
deleted file mode 100644
index b09a7f3e679..00000000000
--- a/Assets/Mirage/Runtime/Sequencer.cs.meta
+++ /dev/null
@@ -1,11 +0,0 @@
-fileFormatVersion: 2
-guid: dc5e21b720fa04bc8a770b9f3e0a6470
-MonoImporter:
-  externalObjects: {}
-  serializedVersion: 2
-  defaultReferences: []
-  executionOrder: 0
-  icon: {instanceID: 0}
-  userData: 
-  assetBundleName: 
-  assetBundleVariant: 
diff --git a/Assets/Mirage/Runtime/SocketLayer/Sequencer.cs b/Assets/Mirage/Runtime/SocketLayer/Sequencer.cs
index f61e1db5b57..9e45cb0019a 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Sequencer.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Sequencer.cs
@@ -3,6 +3,7 @@
 
 Copyright (c) 2020 Fredrik Holmstrom
 Copyright (c) 2020 Paul Pacheco
+Copyright (c) 2021 James Frowen
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
diff --git a/Assets/Tests/Editor/SequencerTest.cs b/Assets/Tests/Editor/SequencerTest.cs
deleted file mode 100644
index a77fda497de..00000000000
--- a/Assets/Tests/Editor/SequencerTest.cs
+++ /dev/null
@@ -1,54 +0,0 @@
-using NUnit.Framework;
-
-namespace Mirage
-{
-    public class SequencerTest
-    {
-        [Test]
-        public void SequencerStartAt0()
-        {
-            var sequencer = new Sequencer(3);
-            Assert.That(sequencer.Next(), Is.EqualTo(0));
-        }
-
-        [Test]
-        public void ItShouldRememberBitSize()
-        {
-            var sequencer = new Sequencer(3);
-            Assert.That(sequencer.Bits, Is.EqualTo(3));
-        }
-
-        [Test]
-        public void ItShouldStartOverAfterLastSequenceNumber()
-        {
-            var sequencer = new Sequencer(2);
-            Assert.That(sequencer.Next(), Is.EqualTo(0));
-            Assert.That(sequencer.Next(), Is.EqualTo(1));
-            Assert.That(sequencer.Next(), Is.EqualTo(2));
-            Assert.That(sequencer.Next(), Is.EqualTo(3));
-            Assert.That(sequencer.Next(), Is.EqualTo(0),
-                "2 bit sequencer should wrap after 4 numbers");
-        }
-
-        [Test]
-        public void ShouldReturnNegativeDistanceIfSecondIdComesAfter()
-        {
-            var sequencer = new Sequencer(8);
-            Assert.That(sequencer.Distance(0, 8), Is.EqualTo(-8));
-        }
-
-        [Test]
-        public void ShouldReturnPositiveDistanceIfSecondIdComesBefore()
-        {
-            var sequencer = new Sequencer(8);
-            Assert.That(sequencer.Distance(8, 0), Is.EqualTo(8));
-        }
-
-        [Test]
-        public void ValuesAfterWrappingConsideredToBeGreater()
-        {
-            var sequencer = new Sequencer(8);
-            Assert.That(sequencer.Distance(254, 4), Is.EqualTo(-6));
-        }
-    }
-}
diff --git a/Assets/Tests/Editor/SequencerTest.cs.meta b/Assets/Tests/Editor/SequencerTest.cs.meta
deleted file mode 100644
index faad093e739..00000000000
--- a/Assets/Tests/Editor/SequencerTest.cs.meta
+++ /dev/null
@@ -1,11 +0,0 @@
-fileFormatVersion: 2
-guid: 74139033e3ed742a1a749dc09dc63e87
-MonoImporter:
-  externalObjects: {}
-  serializedVersion: 2
-  defaultReferences: []
-  executionOrder: 0
-  icon: {instanceID: 0}
-  userData: 
-  assetBundleName: 
-  assetBundleVariant: 

From ff2abd3c215580a81efb785f56017a0b65053a56 Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Thu, 29 Jul 2021 12:03:17 +0000
Subject: [PATCH 077/166] chore(release): 101.0.0 [skip ci]

# [101.0.0](https://github.com/MirageNet/Mirage/compare/v100.0.2...v101.0.0) (2021-07-29)

### Code Refactoring

* removing old version of sequencer ([0efe4ba](https://github.com/MirageNet/Mirage/commit/0efe4babede7726a9dc10590b27194924e4ad7b5))

### BREAKING CHANGES

* removing old version of Sequencer, use version in socket layer instead
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs         |  2 +-
 Assets/Mirage/CHANGELOG.md                           | 12 ++++++++++++
 Assets/Mirage/Components/AssemblyInfo.cs             |  2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                |  2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs    |  2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs               |  2 +-
 .../RigidbodyPhysics/Scripts/AssemblyInfo.cs         |  2 +-
 Assets/Mirage/package.json                           |  2 +-
 8 files changed, 19 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index 153f22e3891..bc00087cf8c 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("100.0.2")]
+[assembly: AssemblyVersion("101.0.0")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index 5d9ae69ba2e..11fce115ef5 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,15 @@
+# [101.0.0](https://github.com/MirageNet/Mirage/compare/v100.0.2...v101.0.0) (2021-07-29)
+
+
+### Code Refactoring
+
+* removing old version of sequencer ([0efe4ba](https://github.com/MirageNet/Mirage/commit/0efe4babede7726a9dc10590b27194924e4ad7b5))
+
+
+### BREAKING CHANGES
+
+* removing old version of Sequencer, use version in socket layer instead
+
 ## [100.0.2](https://github.com/MirageNet/Mirage/compare/v100.0.1...v100.0.2) (2021-07-25)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index b932bbc5817..c7ddde642bf 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("100.0.2")]
+[assembly: AssemblyVersion("101.0.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index bd8aed108e1..fe7ddb9e681 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("100.0.2")]
+[assembly: AssemblyVersion("101.0.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index 96ff7e71cd3..32d8da95c70 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("100.0.2")]
+[assembly: AssemblyVersion("101.0.0")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index 153f22e3891..bc00087cf8c 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("100.0.2")]
+[assembly: AssemblyVersion("101.0.0")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index 153f22e3891..bc00087cf8c 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("100.0.2")]
+[assembly: AssemblyVersion("101.0.0")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 59a01895a0e..707ff8bb7fe 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "100.0.2",
+    "version": "101.0.0",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From a351222a3a7d2f75404bfebda049ea270f2f4e63 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Thu, 29 Jul 2021 16:17:54 +0100
Subject: [PATCH 078/166] fix: making weaver generate serialize functions for
 nested messages (#873)

---
 .../Processors/ReaderWriterProcessor.cs       | 31 +++++++++++++------
 .../Runtime/Serialization/MessageTests.cs     | 15 +++++++++
 2 files changed, 36 insertions(+), 10 deletions(-)

diff --git a/Assets/Mirage/Weaver/Processors/ReaderWriterProcessor.cs b/Assets/Mirage/Weaver/Processors/ReaderWriterProcessor.cs
index b8da4237ebd..06c8939db0a 100644
--- a/Assets/Mirage/Weaver/Processors/ReaderWriterProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/ReaderWriterProcessor.cs
@@ -81,16 +81,7 @@ void ProcessAssemblyClasses()
 
             foreach (TypeDefinition klass in types)
             {
-                // extension methods only live in static classes
-                // static classes are represented as sealed and abstract
-                extensionHelper.RegisterExtensionMethodsInType(klass);
-
-                if (klass.GetCustomAttribute<NetworkMessageAttribute>() != null)
-                {
-                    readers.GetReadFunc(klass, null);
-                    writers.GetWriteFunc(klass, null);
-                    messages.Add(klass);
-                }
+                ProcessClass(klass);
             }
 
             // Generate readers and writers
@@ -99,6 +90,26 @@ void ProcessAssemblyClasses()
             CodePass.ForEachInstruction(module, (md, instr, sequencePoint) => GenerateReadersWriters(instr, sequencePoint));
         }
 
+        private void ProcessClass(TypeDefinition klass)
+        {
+            // extension methods only live in static classes
+            // static classes are represented as sealed and abstract
+            extensionHelper.RegisterExtensionMethodsInType(klass);
+
+
+            if (klass.HasCustomAttribute<NetworkMessageAttribute>())
+            {
+                readers.GetReadFunc(klass, null);
+                writers.GetWriteFunc(klass, null);
+                messages.Add(klass);
+            }
+
+            foreach (TypeDefinition nestedClass in klass.NestedTypes)
+            {
+                ProcessClass(nestedClass);
+            }
+        }
+
         private Instruction GenerateReadersWriters(Instruction instruction, SequencePoint sequencePoint)
         {
             if (instruction.OpCode == OpCodes.Ldsfld)
diff --git a/Assets/Tests/Runtime/Serialization/MessageTests.cs b/Assets/Tests/Runtime/Serialization/MessageTests.cs
index fcf8a3f14b0..cb21d69435d 100644
--- a/Assets/Tests/Runtime/Serialization/MessageTests.cs
+++ b/Assets/Tests/Runtime/Serialization/MessageTests.cs
@@ -181,5 +181,20 @@ public void UpdateVarsMessageTest()
                 Assert.That(fresh.payload.Array[fresh.payload.Offset + i],
                     Is.EqualTo(message.payload.Array[message.payload.Offset + i]));
         }
+
+        [NetworkMessage]
+        struct NestedMessageWithAttr { }
+        struct NestedMessageWithoutAttr { }
+
+        [Test]
+        public void CreatesWriterForUnusedMessageWithAttribute()
+        {
+            Assert.That(Writer<NestedMessageWithAttr>.Write, Is.Not.Null);
+            Assert.That(Reader<NestedMessageWithAttr>.Read, Is.Not.Null);
+
+            // should not create for *unused* struct without attribute
+            Assert.That(Writer<NestedMessageWithoutAttr>.Write, Is.Null);
+            Assert.That(Reader<NestedMessageWithoutAttr>.Read, Is.Null);
+        }
     }
 }

From bfc5bc9f715b41ef3d68f614c44d41f6157c05df Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Thu, 29 Jul 2021 15:30:54 +0000
Subject: [PATCH 079/166] chore(release): 101.0.1 [skip ci]

## [101.0.1](https://github.com/MirageNet/Mirage/compare/v101.0.0...v101.0.1) (2021-07-29)

### Bug Fixes

* making weaver generate serialize functions for nested messages ([#873](https://github.com/MirageNet/Mirage/issues/873)) ([a351222](https://github.com/MirageNet/Mirage/commit/a351222a3a7d2f75404bfebda049ea270f2f4e63))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs               | 2 +-
 Assets/Mirage/CHANGELOG.md                                 | 7 +++++++
 Assets/Mirage/Components/AssemblyInfo.cs                   | 2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                      | 2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs          | 2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs                     | 2 +-
 .../Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs      | 2 +-
 Assets/Mirage/package.json                                 | 2 +-
 8 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index bc00087cf8c..7ef7020e0c7 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.0.0")]
+[assembly: AssemblyVersion("101.0.1")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index 11fce115ef5..ad78f01ab44 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,10 @@
+## [101.0.1](https://github.com/MirageNet/Mirage/compare/v101.0.0...v101.0.1) (2021-07-29)
+
+
+### Bug Fixes
+
+* making weaver generate serialize functions for nested messages ([#873](https://github.com/MirageNet/Mirage/issues/873)) ([a351222](https://github.com/MirageNet/Mirage/commit/a351222a3a7d2f75404bfebda049ea270f2f4e63))
+
 # [101.0.0](https://github.com/MirageNet/Mirage/compare/v100.0.2...v101.0.0) (2021-07-29)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index c7ddde642bf..962daa6f2c0 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.0.0")]
+[assembly: AssemblyVersion("101.0.1")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index fe7ddb9e681..9f0952230f9 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.0.0")]
+[assembly: AssemblyVersion("101.0.1")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index 32d8da95c70..ee1f9ee9094 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.0.0")]
+[assembly: AssemblyVersion("101.0.1")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index bc00087cf8c..7ef7020e0c7 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.0.0")]
+[assembly: AssemblyVersion("101.0.1")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index bc00087cf8c..7ef7020e0c7 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.0.0")]
+[assembly: AssemblyVersion("101.0.1")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 707ff8bb7fe..21df15b70c2 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "101.0.0",
+    "version": "101.0.1",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From 8ed8005f17405712b07764e638f2941466b7a12c Mon Sep 17 00:00:00 2001
From: Fernando Mirabile <fpmirabile@gmail.com>
Date: Sat, 31 Jul 2021 14:29:21 -0300
Subject: [PATCH 080/166] Add - Getting started documentation update. Still
 need some minor tweaks. I will work on that eventually (#874)

---
 .../MirageQuickStartGuide/image--000.jpg      | Bin 90855 -> 0 bytes
 .../MirageQuickStartGuide/image--001.jpg      | Bin 208201 -> 0 bytes
 .../MirageQuickStartGuide/image--002.jpg      | Bin 265443 -> 0 bytes
 .../MirageQuickStartGuide/image--003.jpg      | Bin 412866 -> 0 bytes
 .../MirageQuickStartGuide/image--004.jpg      | Bin 66456 -> 0 bytes
 .../MirageQuickStartGuide/image--005.jpg      | Bin 31764 -> 0 bytes
 .../MirageQuickStartGuide/image--006.jpg      | Bin 112328 -> 0 bytes
 .../MirageQuickStartGuide/image--007.jpg      | Bin 177667 -> 0 bytes
 .../MirageQuickStartGuide/index.md            | 235 +++++++++++-------
 .../MirageQuickStartGuide/network-manager.jpg | Bin 0 -> 72148 bytes
 .../player-components.jpg                     | Bin 0 -> 78028 bytes
 .../MirageQuickStartGuide/spawn-player.jpg    | Bin 0 -> 132479 bytes
 .../start-server-script.jpg                   | Bin 0 -> 144964 bytes
 13 files changed, 147 insertions(+), 88 deletions(-)
 delete mode 100644 doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/image--000.jpg
 delete mode 100644 doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/image--001.jpg
 delete mode 100644 doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/image--002.jpg
 delete mode 100644 doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/image--003.jpg
 delete mode 100644 doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/image--004.jpg
 delete mode 100644 doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/image--005.jpg
 delete mode 100644 doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/image--006.jpg
 delete mode 100644 doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/image--007.jpg
 create mode 100644 doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/network-manager.jpg
 create mode 100644 doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/player-components.jpg
 create mode 100644 doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/spawn-player.jpg
 create mode 100644 doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/start-server-script.jpg

diff --git a/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/image--000.jpg b/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/image--000.jpg
deleted file mode 100644
index d23aa27e6777f179b804569e7259349e15e1d056..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 90855
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
WrWv3P6>N5NsQxtef9;(8nEGGalS8Qh

diff --git a/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/image--001.jpg b/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/image--001.jpg
deleted file mode 100644
index 4cc9fba8c99482acd449ed026f1fc143b2e6a696..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 208201
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
V;EBa2hxa6COCQwQh=pzT{tu%edP@KR

diff --git a/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/image--002.jpg b/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/image--002.jpg
deleted file mode 100644
index dd648ad4851650597e6c8a086d396d0c4f52f6f4..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 265443
zcmeFZ2UJsA(=dEOfY6a5NDT^#iiiaPX#tfcB34jP5CQ2#DbfNFR8Xpjg3=Wg6$Ozd
zHPS^Cq(~J)Q$UC$ln_Y!cWhU^@4C<P{{O$ewZ66P(UZ*CXP24TGqY!A@4)O~4nZsS
z8k!hFFc<_~1OFiAFyv$4?{Wr$%*>#T5Cm~S>@Z1)13;h(qzjY!2^+%JL-4QVY!DRT
z0<nLuvmbo3F3{W8Hs8M4GTDCA;IYVr|A5&tSyh<?NaKJr+6V3Jj6N&3ee)JbW0#2;
zJF7=<eTCP41y^*+MEAx)&)Fw0aNnAy><VFy2tF~{z1#M{A#+2MeFk3%5lpo^d)A$8
z1q69``gk2O+9h}FxRo4Y3}C|!34?xQ?d-kJ>K{0;kJaao@2~y;{2+II#U1KUX7%;6
z_`d^$92~vv0r3Yw_0taC_8tH(gdp}y_Gi6(Ac#`~l*{}1oMpi$04(YS5Crg97VPv5
zzQlr0e}iv*t#jniZcyh5m=ZoaJ1-{)5_kd1<<8qXfqn#f0KCQ1!Nn7T1i1jLYwv95
z0AOPPZ}RX!vtUpUT7UYNew==R?d(qf?9<N9=_mY+7SIw5yvN1+th-&n*N6W<KRn!h
z0l&Up>%b?UvzPH9@GT1X*5igYWx;#^p7uPw-yFbT4q+4*K+!jtjmO#7_$YuueKu)(
z@7;ixkQjisIN0qm1+X-L4L#lWv*w#se)^1yp$UM2gs}O$_?R34FstnqM{k3}00#ZD
zrFx+ceIJW0^^DhU{qJpa?Ysc=t$v-a+fi0ItN$KnN0T4@&j&gmu>|D+XE@J!7Ymj~
z2mn~j+wCw5AAkc~A<%g@tNd#nFW*Bf{1rgCrlY6PE&v03;5KKx3|X|Z>U(*31L!Mm
z@GH(PCaksqPk6GA^AXk@v-){rZ}%1dRRDhB=&ApmCvY1_?_(_7zS8C3xW@p%fOhyh
zN6(|*>4guS_1VQ5i`91atov8p0QK2<9Nmpr<!b;e?S206_qOc1K3+#y<p59i{bzj+
zuy_dYWIyd{x0faN03UXLXdkp2+5^c!zTiF$p&?hurDeKg8a#b_V+h$nUXT;y2q}Lr
z`O(7i>l;t-c^C?W2#_bJ<NdSUuCH$$q4S`e{<HL3TV?3X*SF`tws3<!fe}0)Q^*}W
z`vTYzwD~cb1vCaqTz)?P7~LM=>JDz!yT6y|1FH6cQCYQofAlLS_@gGL0p}i0V@^ZP
z4eXNay6jr)`@p9jxVN!uu<!hV?O*jdK5?{hjBvc?7~<%)bqVwOQR7E{kQp=t#`(r8
zN5IElXl7prdfmaki(Low5Bg>oW0!=K*;T<v`s^q$_6|_G`#Uu(>VI(lSE_!}0R6@F
z@AbI1aI<lXbL(-h|FfmQMu8naF=X-d8$Z5r?HjJAfAaMQ27e#_uQx7`1HjYtJFY)#
z!mq#!;EnKVcoVz=UINL%aqt)LH}Fap{C#}Gue0d%bF@QW=hzL*jLXkDKj^gsC9E-7
za^SrsXUpUk+P7YO9Q}QO+(Nt2X9K)koSc2+^nvAflr!<P-@Hj~+m>xxAc(b&u<Ah2
zoY>d(0VekPud<84?&#cLGMN>BmF?RJL50N-#54I<nIf>`{GjaBReN8r^WXYoXMJ%%
zJdhyJC<#awl84p<dbUAokQSr|89;j>bLa?k9I^pY=M3c83-W_7P$(1*MS+#}CX@_i
zKv~d3=qdCZDuF7XYN!EfhTcK%p?)AeAE7CT2$3Nw3<g8M_+cV22^bQ#7N!K-2GfA)
z!VF;hV25DGVW(hDFi)5-3<J9ei-KK;CByE(9>MZqrLbyP6RZu^3mb+_!e(L1Y;ZO{
zHc>ViwsmYOY#MC(Y^H2S*iN!Jv7KWJWV^%`%XW+HF545fVzz3wX14ciLu^xQ3vdX|
z3m1d0hAYE0;Je}Ga4Yy3xEDMG9tlr`--YMG%fLK$z=z<|@FjLmb`f?tc4Z*J#_UJg
z?b*+<hp<PpC$m3fFJ`Y}?_eKhC$cj*_&KCGlsGgwOgN5lIC1!KgmWZvJm4tes0Z5g
zk%P?1$tlLE$f*vr@i?a|XAoyJXBuZ7=S$8u&QZ<<1Og#}P(tV+%n^17A4E9fHsT2a
zhiFH9L{PYRxsY7jxD2_hxIDSSxDvS@b5(J*bB%LRxmR$n<<{gj=XT%@;Ev<I$6dzV
z%Ked>$|J<1$fLt^gvXU9l;;*tE>Atr2c9`zUfwmlJ9!WCy6|4$y~X>C_Z9Cj?-HLd
z-$uUOd?)yP`C|F9`Cjt%^3Cz{^RMIA<G14X;g98i#9zxl$WIXv5!ftXBH$o^6-W^%
z7HAjvBFHVcR#0EiMlet?QLsR;Rd9L*_lk8ZcCWBo5wap>Md^y}6$?TlLR*E*g*=3!
zg&qqv2~7wigx3ih2s;R063!B?6&@9Vi^z-Y7O@w(C~{AvUgV=Fr>LT+iKwe+l;~5@
z7E$6#;gzZ@Emr!kOj%jEa!3p=woc4M%v~%_?73K%*s{2cxW2ff_*L;-@pkdWRZ^?;
zRynSUT$Q)#{i<aNISB&^H;H(O5{UsxcFB#B2POR^(<SRAr=>)tw505%BBh>7^+~fy
zZ<IbH9VDG4{YH90Mpnj1=B&(ZnOd1?Sut5XSy$N`vQ@H^ND-ti(gk?~i9>#tTPde6
z=Pq|ku1=1)T6(qdYTwm&R=2FCu2EcbbWPZryfp*zJn|ayXXJ0l*T@qUkP2oB7=;{#
zzO~$IHP$+>O<LQyc5$8JI?Htt>q^#5D6Ud8Q4CbfQT(u;e?4mbx%GF~cW&U^ps~Si
zL)wOS8`(DQ*yy}5Wn-%no06K6i&C0W+a``pJ2!c5y1S`cnNL|?`Mh$D^6+M{&HFZo
zZ7$jTMMXiyN+n*UQH8N(#}@Z3_qOzJ72djcYuMJZt+U%UZnNK(vaNGF|8~Re*zGU2
zlT?*d9aYm+dv=KIFxwHaqh<$PO<m1PEmv()T|xbnda8Q2hN#8?jcAQmJ2`gl+KJs+
zv2#gNP18s7x#o<PvX-0HW335oMQumzd)lKqYjo^%?&u8Z%ITic&D0%2tw!0Q?xIHY
z<n<i%9_WqhZ_szuf1>|o*OpygyNY%#?$+ELy!+)I_#UG@k$YMUgbj`wBpVDGt}%2n
z%rPVy?Jx>5dTGpIY-${D+-)LbVsG-ugt%9IZ}8qaQ$Ewfrpcxw`!??L+E-@AX13QX
z!R*8SwfjBymzYE5Cgus|0|yijoI6l{kn`YygDD3;9ol*bbExsK$YI;Vj}McN>^c&6
zr2pvpqrOLLECel1SUj>=wA^EP-E!!d%CX>M&BrB=yBvREg|M=)dSJC+ZD4)V`s0Zm
zC&Ev3om4#Of3nF&(#GAU(pJ#c&bHtb$0^HGk5AF;%<b;lEu1zvoqC#RzuP{^e#$}5
z;fBMcqmJWs$MG{dXRe=_aME!~aGG>RIVU<#yX<yJb|JYMyJom9x|zFWyD{A@-Sa%S
zJWhF(dJ22GdDfw2(f;VRvr1>f&kmi_Ja_XP(aY59fj7+ir1uLSQQ)w@@m=qG*?0K7
z?)jAS6h8~U0)HWYPyaUo8w0Kej0YM9-Vb6AvJa}ktj2_5hJ*Ek?}WfYPKVTB<*}Er
zA1@ePco@nP>K6JoY)jbnu=$IY7t1cmT)J>+^s>?AoN$3~ukh{&t%!^(>{nc_v|QbO
z_4ZXpq(kKEs4Y>6QM73L=+`k@V{XMTW6#94#Hq!lU*o*yd95oR760(M(DlIUqX}jS
z#W&<`MBbRcX?wFNQ8h6mi6_Z7Y3SCzTQ6=a+`e|3mh7DTK4n)*UaEBJ)zrl_hqU%|
zz4Y7+nT)86<xH2%o;yZ&itnzwo0!F!bw2CUJ&Svd_ciW6dLa2A>H$65GkfUap@(&k
z)E_;1Ed4kxhb_l9XY$F3C-0u_dHNz(IrmPUSYFgK=$Y@c&-thFyPlgquPM+d$Squ3
zm|7%K6j=-_4k#v;IF}5)IR2uobZ==*nO0d*`R4NMiq#b<l`AXbs(7j{RWWgaxP_Nz
zUrtv$Rgc!#*7VmNtL>~iSl3c-TK}rSu%Wh5zY+IJ=T$|MW>e{Fjn^g3YR$!OcDyNi
zyW?$9i&{%@t9t8;cRSyewQ09iwWHdrJN9%mbeeQFzu*79t?Ou4Pxp!Lp&o~xiC*_!
zQs4PLYX5}~93LVFRtzK#N)O(}Z@}jbsSQ;Q?-_nGa(JYF)P8ho%zKRX@zN*$Pl@Bm
z@kbNeCMqTkC*OUx{`_(3>=bo6oFGI<{j&Z`;f&tQ8{#qIN0JwbIU7AEF_%5BI$yJJ
zU}2E#L8dN7QY0u3mo%0dmo1maseUvB?G}9ly^LYX_`vjFGSAw1*?si|;NX+(42ZyI
zvw@#*9D+pN0sq1JTb%c`2JBmG3Sijxn^pV={4Ew_y#PK0lncIC?)vVR5cCY(>-0e1
z;F;yBAJK!@wr~G=gA&%|eP;W%uK<kC3%Di}CUZ^(f)Hg8ME7DcscB3m{T_%FdLiiL
zxo`0$t2XBf2+CAtLG5Dx7g*oFUd)$}5Eok}j|CjI24WL}!G&PVItU4H=KzigxPDZI
zvBB9nI1yajJiMSn(F%wS28Xk;!#OxuNdZ_ecn`4)aR{&8s?RBM&<?TYoanaD_&Z$k
zyYj179%>^hY(MQ4#?2!pzDh!J?K;Kv8#b!$P*c~~skwWPfuWJH$=<_9j#^j(m(1S5
z@r;wRi>tSf?|DD}fWV8FE{8{4xf*#r;l|Cxq+7R>?`GY*{~-I}qsPw+3X6(MUX+&A
z)YjEEG`?zj-QLmpzN@>Zw{Li4bnN4&@rlXLq}jRo1@a<gX_-YA41#|n>nCM@&?N-u
zVq<5Avm;n^!Pxx34HshPSiO}~SpOix?wrV)ZJ}JEyW;QUS98m6KSW%4+N+I6OhI*c
zEr~_iSIYi7!ovPvQTCItzv$`*?larh3(m#{=YYfE9Go2B;^YF}7AGec57*a==ljL?
z^%7uRf<G@N=mZA(U}tAXfd4Caxp`OouP^2RNas9Y_Cb7b7!W475QKu3vlzlp{TP9b
zOelm2Eze_Xj^;9<)?-X)2G4|SN|)Ee?=YcDIVYJ=dOj1v;~15Sw6#`?w1qeZoe3>W
zy`h<m=5bLB;<b$)?{-wk@@l9nyzCuQEh^SvxINl(B@^PE8&;<yu(KB9Oep36;vI^3
z(+xM*g`zGpq3+*@Uzl5@skC0g&&x2OChH8w4x`^6^^p31AeaEq5BiDze{QeGgnp+m
zj<UB1zchuUQ<>0IcPpNV(-pzK^J7A5J+YMc$lo8KU=Ak4ZBfpIbnKZB4oeR-2hC^x
zcg<~nX^t9J>c);g!7k1)p*&k%fE<lt#)S0ow40?&X!Hp7k7t4LcUWQ~U|;)B_Pza;
z{PExU^(Xt{GMUiuCNSc?ZzCGf)+W!;=D$zncq_#=gBv%Y#e}YxplGgfzdv5ky#yqo
zfF%j>KP4e~@xO0=@sH-nUn$AUKn;gr)-j>X8OGiZOo;UO&u3^^gdzME$g0tIS<L|L
z@jp26-?SI}y*;+(I7`-zzsq_Rh6!C>BBn4d;+B-WnNY*SKcC?f<`mN%_@&8j($Wq(
z$ix1x+M|AL-v(sq3`-c~zsb_l97BA(2E8o6gvOq>G9k&VKb|uM@1TC2J`+|4mH(>_
z{uO{<1n6G@$otm<{F4QE{64!8dD-vz6}#?H3kAL=(KZznL32Ga4GQZ1)pSm>)Dri@
zs-CD5srF^}Q)}P!?9H9Fci|Qm66`|N>|R`toZ)x>$p+@0kAx<Ex6ps8__%YXK-52)
zvC_Wv@T@;Z0ZaBThC1!;1x=NIGDNIF;(j0GH(UD^Pu#DT=yx$<4e*<#`@>SQQ2dt>
zEcfbPMtt`(|7FC#jQGu)`oBgs=8(evQ#HCm4(39iul1U&|B#=ry!yoGSp$yz_~_A<
z^?$nXuz8j>{^@o9zI52?{#pIcXV^UQ*XCfk_{}B9Ed3F19sJ`N1Yj&%{xgEO$Lhf5
zFQ5Lu=>Yp{2Oxs`#VKEy`wt-qa@QYT7l`0kA<TED{y(?Z2SL(retX=nOIdeo#_u89
z-y%5fKfG?1OF#3&rT@>(5q~uQ%_0A9rtkl***}_N9*g3caa>WG*YLzx;`)ZWHrPI&
z11L>sG2>Uh{~61Cl1t}(C|_C}?-=eV5PNCc^JlN*V!7n68JOzH{3gJ^%l`?2D6H)d
z0r`D?wG1Gi-{kL40roCDfH3%{N%}g*pF;G96t=YK$%y}xp0P#&BKuqX_PZpp5VidW
zMPUu`FDF3GY2jZ^{4jq1a^hc3uu`JGE~x*?#J@7}uT1>(SO3+H9~tjVO2J9g?Dvg;
zuPGVq@W#J(6Ihue3s!RY`%cC9M5e&S|BstJ86dGE`0IuV%kBGhJA^ez#P5S-fbAaq
zkL{k^5Rl<Q{fZ{Y99hl$+)eu10PTP7*OY!<4`;qxUK6=KQ?Ml?ZYJOn=E(cPIr*gn
zQAeTef=Sb#`~BrVt}|4So_ibc5f{EP3*i{pSbu8|PGSd*OjTqg7#;3CZZsCV9^Q<&
zY#DdGGN>9^fT%}aDGPK>7kGD>o--~;PI2}QcholBDEn}rJXooN!B0W%BjM}$5!Gd>
zL4*ZVk*9>bu35$P*rPWV4$^j$CT)+0bTFa9q*#WO|5L^)nj&_(KSoQ|w_$aPQ<|tc
z_w0$9p)svk>Cv4!m!S|WrJsC?l0}>{4?f(WxuSz$-(X8n>#*PSSR>L>=VXxIa`$yW
z_<Gz2y3&Fh`4s(Lg&#?=-i6pWQp<!~PPp!z_1wy*MZ5Lj1@?NMC>*xJYgFUa7p0FX
z(YlCs8ZT-0N#dCl+2-Kw)8&RHjcI7<?8GxVU{g<srg;GI8byp$SyWP+s@+(+<Tk*l
zMc%jjEOv0N9ty@WA@(QHF3TnL6M@)QaIh0qh3dkc3hB{tn}svDt43PuY{f1NsguPg
zl5Q@i(eLUwOZ3p61$J|gv_`r^s{o%4QQ}GRhZ(PkpW?^pkEfcFN1Lg8n%J@BB_;|U
z?Z!E?j~cwr!sHVuaU}a{EVs7AL)tFN<wsaYf9&4bkPh#Url_Rx*Vl}wFN95`w*9RC
z(VXAkdnk@3iX3VU4cUxwBMOY06Hw23n2_rL6T0(hy6-J@%CK+_gMZ$D--f9~c)di5
zVg#8`SatIgjCWUSLmG-9G!r4ahN|9!3L@huM!HQ-ifK$pHj(WUmC(Ifm!Ta^y2*(P
zWB_t0M0%vIm_KqPkDxw;hiJwfsABD%kFn15$K5T-_&2kv)Z1C~F=3-Mg!q+J77`5t
z`fG4l%sCQnsAO6?gSTphwQ~kBj;7hggo@{a$SLKx>5Kx8GA4AyzU)OQ)$DB-zDm1d
z{N^eMdDqrmwlElQQHI4(Mw@IQtj1q#OfWh_q#qST6`wD1CASs}S}he+`;~_%V~jBL
znQ3f$Z%z-c(C8_2n36_vdx__y2|mIYQ{o>nAqRhN<Jpk+zGH9CeWc%Y2ty6@-@C3h
zsc>}Z$mmWDD1H=GXi117Mv&c}MN>u(_CFpNpDqqDYn!Vmj(S6%-m>p%{yK}LvU%xo
zStJwUSp9-(J8er6#_t@U$1l5fh2vl}kr5o6=1C!->f-uE>igw7$xO)kWN?^0Id0wC
z%!`YGRt<;kVplGSdVa>&86!Re;S1}g_)!l}#}He^Z0F|a1&WK_j6ABA-{2C~ioS*p
zX2M<Yl5JsnhH5%{XT{sSt?0g|+9@|@F%3!0^yzoI@+$4lECu>#k7`TMV^EF{+Bw58
zA}KH?v<YZl5po7i#k&kFmQF2Oelm~54W(kmbXU>P?HEU@`e1;jYXIY9OY<2<%iFtk
z_;Osu`HWVl8(ug?n-nt$y9@b!21Eq16ce>a=fK|dn*0CjnFu+>=)e(=`q5LXG$=_!
zuW2eEyK==pXc{}og!-`#b5-3={P^XJe6tdCTER@}sJ0V)#x@Ko%-Bg8r@Ar3&1=w<
zqqx&72^|S`dP*;UGp9X6nKzilq&-?Jz+sU--Q!91*q)7eas;J~)LNgeTg-R~21#HD
z#ZmTP3@QeekoJYfMX32zo_F!M*T=B!P=jA%sxT&J59KY%iNSq`X#G+bL5aABt#Q>h
zqUVrLA_-!BXtH?EmpAR$`}#8D{kpy6`h-u8v*!sCO*~xm57bi&d0{vgeBbzJ-t<Rc
z@>L?chiqvIwgTEZWE2JLlMX8u6awPL8i6*+?&(%4{)AS%)1pqymLH0vU_LI=h4N@G
zBAAfU=b1WW7!wl34c(V?s+oxvx5CrbRPlG>is$UeZf-LaBke>}+l3m_oq1IQJJOlZ
z3+<SmkA}zKU-Eh)$P?&(d4`A?g9lKo#Sjvlo>{tzbq>y^?k1q-3Frc+UMAExP+q)~
z+D*9Fh0|n0j=0_~mEP`ARKsnI;&3a)s7jU+#}EQQM89tLCwgo<wgmem+4^$-xeZL{
zWc2vh>(ICtK%R`A!Zpm<K7^7IMuMDXu%{V`Pi=b1)l;@={+k!k^?6rjGAikD%ho%B
z#K~6{G6l!|7_uECDnl%<9}`D;fSus4YGwrIGa;m{-5j=yF~@{tCT$PX%z+*>G!aJ|
zHIptPYE%fw=@~^JZ2gS=Oh{8S=}T}ZDTYFA)Mzd8uEN%$DS?VKr5Va@EEd>eBte1+
zO`HT>b^1)s2G5Wya~3)pGDK+Gi8Fc`b%R?vQ3dnOC#xK)j$9`UPD#@8<@1|0V_{S2
zw=<1Ku{4yJ?eZGjk{5QdxD?x$!QhD^mDdhx17-#dry_|_R=}7(T_UJdFd?;7GT70P
zrbzd-%OYumHMmn%q9N@#Zia@nc>obthwMMl?=dGeU82_Sm&99Nw>2R_YJPrEf(9Id
zut#nooW%D`s5Z^qhL}WC@UzMzSJ@KgtO7!I^{yX=!>{R0Y%QsBhA+U$Hk7wmQpb>O
zc*sWAV%y$sD}29S^`|HOx^Dw^JX`A02z_-0`C@CTcPDkRAMrGRoFtoZx2OJrOZ<}9
zyDvQ{xAR{lYUe9H(wW*#-4pn3`z50CE2M<3VsXeKS!L4oeM3lZhA_>ASWb2)MZ_{>
zKHK){uI@k;Fq(bGYQZ{V+h42rW!xyH#Bdt7E!9b$9d4;D9#k^YUFX+2$Y`W1CzsEN
zP1wkgx+8LFN+UVw5*NQg+cd#jq%X5+4z|f^7OQ*_VVb8%$q;RrqC+)cw1o%|_h2Qk
z&Uuo-C5C0KWY0Kynmv-7*mSQ5$kpEbtLcKP`!?wM&_Ai=NyP+ZSDW_(R^g>|m0Ym=
zs^<LkbY=6_{vdJ_5}n|&wwm72*O+?iHJvoox_jyN<8?TyM@ZY$9aAhl>i*z(OUi50
zjDmpku#Pb%Way&ZSlr0&(P9qI=;QWTq{tI*O`zb~GW4=O723sl6ao2s3FlIZM=d)J
zCwbzxnS^+G$6S<H#cs#wL>BobO?L=JI90sE6?fZGZE2NKXr<`~LbNSr<$h^|XunqE
z&H={zDlPiGLa8)$vIj|#wt8^W^Io!>d4BCftjkhdnfV~Tn$Lm>IYmlXe`>v54*$dp
zta{Jk(Y*Q$;F)yhRc$mOFS%nf3S9k*qX_Bl-D}L}gPcc&0(PmIr)cHB@XNc1b;Dn<
z!cGs2p4>j7Qqx=2m^meTeoFa)`7{$Ms7FKeg}MS0^)!VRypQ|jt7-^&mI+mBGqf>2
zloDT(xEW<Q59>bQA4HX(&LLZCp%n?I3HLs=Yt(uQH7;Il&}c9VNo1|HubB{3VUS4~
zuW=e(n-<Yigq6fLQkU`+Q|M`%ik}g8-6a?_zKTknOL!ZEW2v|k_mK59-EA0icd+`}
zw!hEm*9CsUr&f+Z0;Px~Gq;EX+HQI#@ATJY<EvNHTBS~Z7$S|?Nr`eHjy9MEKR97?
z4=qD`wsCUI^d+4X+=B?$QhW3{uv?0%hjAh~RTHGlNM{nV>K{8l^5YA<x@pfN(Uj00
z1W(8piRat&<dZ2m<O+ILl^Es-QTO(69zuou;O=JmQuRYG+ft0lGNc?0M36KmT<Jo9
zq9}|ikks}nO2J*?7#r74cG*jk4rMo15a#Y38QhgS!f7(W8Pr{m=Vfe|#PXxgsPOui
zj|gP4Sx>fIszoHaf0<papOL)l0^j-SfeQk<C`wAuqmUj+i;Pk8@a~TK5gGO;mLZbK
zW2Y5dwj?D!InVi7yP?4l8ilqXrb~dXdJU=&8zU;bvzqTvuJ;oxt`BV!_i2%^eY`FG
zu~s)fk<o8MTnw9!5vkX_{l3UrgYCpgX$GlUd#>r_%ciO5ZhMw51fMk@zQ{@3d;>9H
z5D(2Cx!DPuhF;1<tQ_o4$87Kzgthl~gOf6Ctu_&QVIU-6%dglv9EZd>kQn!g)M3Vb
z^e`1I*k7%i^SBk!m%Og5DSXu(1*PrlmFHG$5tNsn?)Ik2ouFrobT@>YD`yDd+xtc?
z?7$62g(zX$JeW|kCs5Ao&P*s=nevng8I&*~<#IH`B(D@(SUJIHU(7tOEBUv#S&UUB
zBPDb(Jgu03TUuASdt`>-GSqr8WNR@|t>BJZa@T#|Q^{8tO-13uVu(azL&99c%kb#&
zkB#!Fsr;>BxI)}z-JKt%$TrgLMIN%FwHc1oBY{tZtV^k<t~D0fCmwEJv!75Q6g_^y
zLficJ!Qv>V@sap>YwT=)F*rw*Jf@28pQ#JXzKCxC&w?Hn^{dmpVseew_In=N^0MRg
z*tEt{<@QKw)=L|(TwcPz9F!s5DWQs!87WQ=1EgrJii87Cs%+>v<(|`?ecPjld@?s-
zVwe!0HOZP0g=Scv$I}vwXj{?s=w)Txl1D#w*6h?2st`di9|4Q8>4<H$Z5X+VKgyiQ
zF1c?6y<*+nbs5yXZHn^2_wI*SZbH3}-mICLob(b|lvf{j#g;Ebv9~I2c!nEugkt}w
z{{Fy&ydXK^T=|=vafxaZAsO~i@pDUIGIeT@m>Tv!&r|+9PGZt>QPGgmUXXIEC~QOS
z(^I!?j4wUrvX?b|tWLbXbEP|_#PFmYMzb&G#d{mLmoncY@<qra{GgcM^uX+whV2dB
zdea!|f2KJ2D53!sZmGK#&C&0VGft}GsTW91zFcmDkU8=a`R3Jp{|ToCT%Y-H_e(7q
z0cvB3XLg<B&8piTeEi%ubgGrc%bFGZ!?Z(Y_4a>=6>we|$Mv6ts;cE3%`uabVQyw!
z8+gC?>FJL*J(bs)jBLv0gEt&EL0oKInMc1r15n@b2kJIQhgEtDMiEy+6#W-pKBqa%
z-XSKDEt6De@?B3q(W?d?pl|HsA;?P?IQ8ETNyEAXb+;h-W=Pas7-wMmC`Kq#@k|Tt
z?0=R!Y7*6SFpi)Sh_D~d`$Hy2F(y=X|EwDIv&SeAqvO3!FL>;2DF#^ytDAUV?|bR+
zXv(IWx*uam8oZD!7_QB`GZMW*|IzKRh6JrfCsD6$YgE0&;zu_>%<?>T!T7VT5wRto
z7}kqEJi?LI74h_gmC24qay6qR=sMN!mc3hO`J3SWEsweRIJZV}*bh8mLiTZ2yUEvV
ztuSZj<Vp>$s{y%p{orXNaroj{u2(vrTYr~k4B<XTpQKV-UOpp?Q7q_G#R^m-(zXxw
zZR{U-(tdAmSGRERJzYZEwxNd(7IqW(`>0jAa-VGltAr{2jeXkZPS{f1c6SzO`H%Cx
ztLQr4zAsA7!eae#=+r7{AGtZbV@ue7=H#-}5Tahkegs!-&OtLFv2U^ZY@^Uln8{sJ
z#P>`gVe==U2&Yq7#m6!NXK1FQOo)e~Vy4*|?OU$QYtFaggYAb#H-XW20oR}Bnm=&n
zMap1n#b{uSz6&f{;s7vc3czRkO`B~UDcA;J2F~1;Eg3#()qT9<!7J004ecZ1^0~e8
zo3dpao?(uXu)`&xo8<~gxG0|tL31y41KBJr+Ig05bYp>LqQpEfjEDZC441vHT1P?Z
zzZ)W{m5=CX?Qi>X(?+U4<%L~w{0UDBlapavPI+-@$GR>?X!{LkteSMm^*1_J(5>2Q
za-=l>MeHX|rB3cOXAT*K0J@}r7xf<qJ83?>ofOrWu?p*?Bi@J=_BAJX1b&%26loo|
zPAa$w?YHS*+-CL|&dviGC(^SOlb7d!42K@0fzznS>6@h1TB{vhrNj8EiGv#}pU2!k
zsWxs9+vItk?^f5bGw1nwYKWYH@m&=u)q`t`NfF^bOh~wIb*$FJqNt*ljEUum#lDx(
zi+S%efKt$0DG0#%q+Lv?B#*u!@q$h`YxVj+a0~9GCuwgOo>_r8L>erAVjZwpwr0}A
z_2a-^<vMZL%f6SVmRFqhGUU!{LxYS1ZH|89%OzP|N@i&zEfh7sZ-I<w`9fz1_^UqU
zGJ6}1$}$`Wvp><()bjCTx#MGOoUm2}ry^IDhc#3}6GK{e&R3cbRpn=ykJ(sZYmA<o
zJ?_WUcXSemE?zSpvkVPsMG=pvTm?&$K}1BA;%*RKZcad?l$|7#gVY0Zb*+Qec_;bE
zU?bioLyX&1Jvz>;Xf#2WH{?Bvr%KbMxLcR^J!YzO@e{tO^klh}o^F8M73nLt80oi{
zd08<5!X89zM!+FChwqc`iX#Y3=}9Ywdg@V{NIC_;XTzFW<hir@O!>p}uZ;S8bKDI)
zWnCT0kzS-LW8Q%#<EHKn3R*#o7a(Qy6|t8p6lHGkTa^vd-USR{WH(idrt}3(Sy$iM
zi#?5tIN&6OEdp_-74aQn0tb)+d55A#taF?dij~PZo6b=RA62X)gW#i{u549V0K(WR
zcjCz}_$XT;Jjewh=Zjs*Dl8(T7IoKjJXzpX-uTHQ$tvRZ*t#w)+Wil-(9lrU47hxq
z0X$6%UT4)1kwX*fF650Xu<Zp?@Uf`~iN00Lg;xs8-U#L(F{FhF5sxsTRTK*iRl(@9
zSohxCnfU>d^>k}86Z-tr{Z?wC!BoTc5AP83=<nRbP>GGB86X=O)n`s_4E043xDbQ7
z`$+bme34UG(W$rkOVAInt5HLRiUd3{JHMrsVvMz&o*`xm;_*PTK33Qc#|iq68zt=~
ztu5($y7r~R=E>A;xFe1_NBr_GVTV%00h=QkGWw|=jBdKGTdl1(i%$?OfpV(4g7-db
z@t}jA&dRmEP!MoA?dtuC#xr=V{Vw<vFMt4f-n;wGJGr}&>!JUX_milCTvyGOm?2<=
z>!r)^R}{BcOI#H)d{}<(CaI;<##ovv8)5T=B4DmazCiI+%qHU)@jIZvY1`-Oap^nU
z;v!8&FFD>+J(hN4nR9!XQ7IcZ-4MQq)JR`xOS=P@-L!IHksMKZ7}rhk={KsZz;0ee
zDt)$po1QdZ`h(D(C3S{`NCTk$C~h_aq&^i60@HqVG;Vn#ZfQ42zg$-uZ@ro!O*=Z;
zJSiWEem;3o_JovuaK*Zr)Ve2L&FLX&N)beklIR_1q5jEq{+*q<>eI-waR>KCx(n~(
zZeLXHdZ7h8ZJS~&YT_{y`Y3>87-#)4q~*IoWS6!HNIqT0II8!d?Hd#PibM!I56d&Y
zY<d!6b<@WDZKvN8RE(_@O@*j5oLEXSY7ih~Pqc9g8N{iLxU5n*(7@d=DHAqE<UB^?
z&OEPe`Nt67sKPF9#DAwMk+^t;386D&CoC8{LMudud^+u|qs#;k6yd5$BR6o4nKobf
z6us#dYD<j9gr0log8BuF(da8}xXUAqv!uoC5e>2Po%?TZiZC;Xwd7VnpNrsnclkX2
z^>zJ8y(j+Sv~5U0a1Qn-y^YA99JXw$5~Ji0nNXw3*>rA_ZqkTYArm^GI@PoJ&GFIk
z*^|YL9dixYBy8h(VCy;Kh+#73=!;(}_&4XTO-kS%2q_^zNi7@3`3%_zf(2C{=Jck4
z4Fr?+7kTS}4D4pf0Q$QOC{9;`WemB(7awCWsPW!lq2!YGxyLS&&Rc4^iaQ8lOXoy{
z*U?K++Lv!F+S}?mV^>v4P%@4u)TT?3&d2AtwsATY6yi$Khj-COPRI1Vl$q54PCdv%
z@kOv?<vUmZHZ1aru9|;|0lmm)CR{wQ^Lz-0E<EEzX-T4n@Q#XD`klGH;e<CwkA?Fr
zg=)p8yG^$8(hP{`nCW|+72<h4Zsd4W;+)Ik!IOr$s7n=_ULsF>1Lr3L%<V7iJcO-X
z<3GxXEMXiN2H{KOG83X2(I2A<gC|zTUBeE?Yo7yQm?aZh55oRg10?ZPx(4uNa+uH!
z4eZjIswzfXYapvOFESkkelJ2<9Ll{Z7*(Vqq(4##nMsSsko6tUd5o)dUfZ}mXY&Yb
ze5ZWuz0=(txT2dgDO42YvGxL0kdatzyY&F<L~e=Sh$#VEI|w80JJ39WTKS=}GUtR-
zQ@F<AH|YUvvwK|TPKCUv{+y#yBfNwv60F&vg90Aa{09)G3NadxVuL#Z7^+VWZQ+R5
z-s$-{`vqS&bWO)tlnMRe5&x67jQS(WahpV5$v{>~VAcm6qXj?3Iu?Bb><CUD2_Ce0
zi~lT-u@78mw9%BLq}xW~ijV{)UzMv^C$uoOhJWZGnI3nLx-Jdu5jZ;pcriwnR;LTD
z@pm-8g`t)R-q@^vY##duYJVHvbO=R&kt8r~sA`oswTv?)2kVgfpig=r+Oxis_{DbM
zxWQQUn8C-qw~DQunBJA-402K>%ziikWiJ@zBBhO#v^Xv*{E#7CVqo7RW*w%dn<+_5
z6P~F%4+79D82G63ow&LX(Nfc(2PLfus@{sX*-7DJ+#;W<>Dxn>D?w0Wo5)Z}Y5|#*
z%}rDEP$u-?V<!LJ^>;6*RjtCTB`r2oZbXZ_q_2snNrojGZ|a{8Bae*j>bKdIJMp+Y
z6pq-5h`qEN@w*kvZ6%vk&f=Va;ciUN@MJ>my;Bo7f?yzL{H);bRsUx25-HospWlO+
z<|G~?T-L6fN#uXuawp5V@6~bk605ER(QPN|95$bJI5Zu(5~k2NC)1PnF6yaQUqhdD
zb8q|LAcu;=^(}k$9K8OfZV1|`@J@a#gW_N=jcq&1gkDRdXz@nBBanATTZMFSI6G$M
zL5H^Z2tnSqqU6wQZ8pAtz*I6!v_N5h9b_ya|LCDF_`w~DS9?PaKcZfCds|_!*)xNu
zpRzpAJNY|=n%0!)ya2`(@t=(ABwmODHY2M9I<UnRC!h8@2ZjvcT&hZA`(zrgX*V6W
zRDAZ<Jk!6smZ8)k-&LWKV>Km->E-rz(mb(?GF5Ecdt<ccof1+R_~*Z=Hfs19jit;W
zwEm{d!G|CCmm74w?VIR}sa$%NM({MKc%+hW4vCL6yEGl|J*RXkb|k0If4o*R{HAwq
zk1N?v(<38ge8AwGRJC}*oAR+kN6*`TYLW^X0ZU=f|47$g=1plLC?g6luqoFkN2^uL
zWy=Y-$hhprweviSk>flboiDb9>+m?~<U~?BsKyv=3cvkb8_MkDjj83BsuVOUY~N8W
z-{PBSOk&5*wl$m|JNGKnC=t-On(~YJ`a6y0cl~SiNowh3CE*K7ARE)XvDIapxsapA
zDcNnWjkRU{pJE9}5Hyb=DGn$g10YiSRR+E<LV0;OVB;8VVDs}r{w(5~e0+a*|9@~9
z;wq7SJ7@I%2MZd2tpnk2l@3Me{_YWiY25+;JUtO3j?v(2$4^)Xye(4TiT>RD;zB@+
z@#rJu9ekhe!dy1NG3XPcm9a5SCj|H;_n#fmLT){1Aj<WsT=P@blZin=;**2TPbp#E
z9Qn86MO~xHOl+kI24kVE`4hopm0qdFR>`8q`n8d}w!Kc?wEuB1T%ub3L#U0x&`#})
zKKO8FdPW~O7r5vBGKzj@Mz390{||~pS&IbzuSH^j5=2_8msO@`S8c+GcDhfGv}q&U
zvdqB_zFgVOA}Pn@gWFXvb6L1=?mQt-s@>hbn7r^H%}tqn$6MxUA&-rT<Ebl=nu%xR
zARRN9{TS|_weN0)3dw$WJl1ow2S$7(O{Gqx_kvTLd1V-3gnbCTqI~6e_sYsF|MFd=
zm07kF?4goQ!p%N;<tI(5r}qrsc)nFC>BZ;uyhx?L>qERY`geV>8zG1vajWatAr(~I
zao>6KrET}Zxvx29CAnxx!(SJ3JwfqfjuH_un{%fzG9xi6Crh7=j41K;Y)+RwN3Flw
zldbI?$&LX#cK_^8%qKn~X}w%Vl9R~ztEvMis)T*eOyS8|@m?{zTW_cz0_++Glw$@S
ztE>QNXT+uXW;1lXjbewYhb9e<_6`c-sMyX43yn3AIXcTF&rW3J%f5~Im$tE-i9ICT
zUp~x&XTnH~l1)cum#Wgl4k_OIc>emrDAjE$`?BtAto<O_#%M<k0<YxafAUIzL(GzH
z-FXg{bpK&ee)tC<cl*;nSj?gt4FawCZr1;B>#*M(XUlGUABu30l|lO-l*UM9I%c#p
zCK*3+y;)A;Xt0=qh3@4`W1(MQdC$HnCP)mUwkQjfX1i&&UZforJ?9pJOx5?YQ>b54
z_9ga6tCoZ9EqLp*i5;I?;}qs_&VpB-2ZDWj?4<B}SN4@f#M)t%xT+nKhyBa<kwkSx
z-|@BUpTRqbmx!+s>ziHaXK?fb*Q%Ybw0#uCs?z8QXiOg1`K-ww&+f;~7Y9P4sQ=_B
zm81F^NByoa;32JpN|gLzC2MPf^)4|(F0_SF3A%8w+P%LHEtRTpFM7)u-`F{u$xQz+
zkHfn<icD(ml_b7<GwfZcdSzAU_5IuYL8j-}AG7;aL4g^}`{Bh&0V5+`CGEfNlah*r
ze~HOEPsQq3Eh<I%<XngA>(BdxbIy-93`!Ry><^!@C=4?@MaZ{I6CDtSpI&h+Ac7s4
zq%8z|Mepyv;`cfFTNv=U@^F2iT7<NSo95-J^rY=;E6mPqtW!wdFRZ%Ra2!2+uxVOJ
zs@_(FCOCA=u9Sqks)`ph@Y-9q9P>dfN?zd3zLw1R^iGbr6qcX)n=1ZIj-GW?m}I+&
zt#C~?7*p@E+$g(YDBdx0kB-Di6ARg)_d4ngRkB^GSc-9Bnnf3NZ{H00g`$ZExz5=8
z)1wWS<-&K4B6NTeU@eM&EEs=`49+fL`?e3`Y6Qc@ZN;?>9x0PA^JMKNbFWUeu9d&U
z>ngd&<e1Yr80A1?kzdFPO2V+Y?4-#Pijif}d*#SG-X7YAZ{6<HFwuT+Di<~;0=QW4
zor}MOh`+l1N>ejn0s7`b%l#d_KNKuDn4UFb1T+xXO|W9Iyp|s;mdRJM^Op%wnqoo(
zB>5quZ86j0f41qriVT%%qytvC#mr41{xop3eiR>8c0_k`XN3VGavr97)<(UT<7RzH
zYX2d<hb>RauOL##Vm0HVZ1*#|EUVC9vvB0$T=z6;*_s1Wug4*JP!Gv$`*v(BEJQJP
zCc0`hnTiCb!K}zzL&hwyb)gy2Rck<qhN7>FEt3+J)yotp8BU7bq$`0jCN9SLo|z@6
z<`n^99BnP}x4dkrbHe8^#W%0CN-Lx_u%vEA*n}kh(w^|#_1K)q$2h+P=>sa;_uhJG
zsJ(u2e#g?xj#SI70f(Y<?3c!iP7rZ1x;tp91t(R8v60yPCx^A{sVncdY&#zJ_G~Ub
z;KRbq^m_QbJUM`#Ofwj=74N6?*SFErzcgbL#OyHv@us}AwtcnNUI!c|eCTe(A@@J^
zB{kQVXnxG=$+Ml7b<pZEdr@#j<xR$h*F&VK$dQ>4RYvEWZNGmwT4pIZEgT$fv7N5e
z@R&OyPrIv}t<)$-^|sB_l_eo+XZnMNX_3IOsL>i#5g2W~xE-9XatzM(E*P&bR7X08
z_iH;fw+O8Af-RMPv_w5J=<Lq+Ppat~zgX0t$45!-p0-L$Y}J&RT-Uml{py_I@%=|b
zhtgkYcOxDdZgGZxM)k;IpZi}N31BcGvdTo#(Pe%5qZ!-V*nEeY{*#m|SR6fJdF|U^
z0$BR>_l|$W(L_r?I;B2NxG1SU;VBmFuc$w_)t(&WW;-od6dc=6_q(N7L3J4Q`=Gmj
zYfWl*wJw|v4uv2it3>ljGhy1R>5uNZrlWhmU<)^$!jBoh!+rTwYP8D7?sfF2ygVoF
z-g;jbxof5(9*z@%3!{~o0+Lok3F>)vtrjQ6gg8pIuMSj6Ar~=v#F$Vo-sOe4Qp(MA
z7ur%bwmj|DIFBKePvIXzUDj2i<cyRfVgB;wjLxnFbM<NRpw9vHth`IcVuGezjlAqJ
zr&SUfE4yh&>9-k57zCpk{CR=2OspLf@(ci`AM70$m(7K|EqKd>;sWmXm%KHvj2@33
z8qK3@C$XWyp&8*q?A7yqmgEn~sJ^XE<56gJg4nEe#^B8a&$e|lW!}-}QoCo8!l&1f
ztSQzb>cHe8ur)hIaRR~R)93MhYv!n0gxg`ZgVs00u(}+EOE;zmLc`hLDa4A9*HaFY
z?1#`brf43Fc~=PxHyw!RCE!L(842DBxXI#K6EcwfM=EcyzKaM<@KrEnCj>zv3fU(+
zFYx9SG4W2x2sSPQg{3OZm$)w263hda@U`MEC|5@<8H;4}B;4{o);Z{%WZEJb50<Ln
za?e3}Aj#(VP-~z4a7i6f*w){)#%i&@$PD#*?k-ii&KlFxcXa9g)fFEP#<9;=kFyo_
zEuGwplj|PCHnjE>)Q9ksHiF<@)yDBgKz-Fj(zHaZhIwm%*IV_}x2vf*Mf2Tyt|2{G
z*P!lk!TOB;oYA<K_~|@~l`RaLk17T!{d^!)hh4ls(Nmh|u%mr_C(ALN)Sedq76Dx)
zWZ?`U`i<&Z5|XwLH=ft4id$sNB$Rw1buZ+ZQ4my7x3clb);JJE^KP0XEIz?>GNG%n
z@`*6&l+v|#0etf4^11oR1ih0P4{<PE)wiUQVYSO7&0u*d$3jNYnPvjgb++oQw=!<|
zUHq4Uk6)-4B^ouF$bu}kDU#0+vEb+-O^ApO)pl~Er#+d>aGx8RlTUF<^HXh_tNRkM
z{<FV*^w3<q4T<F-yE^!r9_S~b8e21P^qb4pMS*$b>`KhcaMTCP9ui261X0!JLvz}3
zg*p@b`>E8!gE(0xGz4CdwgDNm#y2zi=^?d@l?^m+3JL7m0$Gy@*?Qcc4f)*7W-IG>
z(3z)Yic~>zaOxf=lw~G;RXz2(D&}VIVyQ-BJB|zGXsv_`4^)i6xiqU#j5qsWK?=-i
zQr4x2(MUC@i$g8%&(Pgm)v5hR*9-H+<Amcw{{2Sa977?_2_J1+fQ!<V_Lr{*`Ge%a
zJhEUxKh_Da|0y_qdC-qO)<w#!F?`$1Hwss{5E4TV&8@1ZuJae`M|o4t7dpSh*n=fX
zCZs82-W)gk^bvN}08>xhM^mTVCLU_8#jU7f`<&4mvVv&T$7psL>u;rBq(86=Gat0k
zPOu4n?xKLcZQazuDar<Q()}2nz%>NS*^0BrUG*SYkN7nRMvAzgdb}wY8A5b&hBMVX
ziEJ7ab&mQjKm3D;--lH#I~&aLSfB))4~#Aq@#92jm?bK(6SnuuEkS}5NM8$MRb^wH
zxg>58SAaE^tW=`z9=y;=D`i5d1y~ns#*$cZcNeb6@k#RtIsz}e!xTvXCoznu)>I2Y
z)!jG(shXptCHw8FB*da?Z-W#(nSy0V3Jzt^RA*?LRlqVgh<#_&QV#xZ3bq&98E_1o
z3u`4;P7$8kll$pu+DbWZ@3{_cp(-yF4@}ZCLa2TZ?OyjkPtAc>X9}3thNu(q1Q^wn
zVl;xUQKNc>4rhS;m76Q7B8p(^(ebvZ<jdy74f3;NS34G+{p`I@oyy2S{ST5e4-hFC
zpKkQhPid3_nswl<9#+Y9$(&qCX(QS<mUTsB*?_GFy=6pS2wLq+cQf^nHBMjh%Rouz
zs7!$#@;SCIeV(PP5i}Gf{w~dk7!wgqLn+?Q{;Z3>(Q__io#oXRzJ}CSfe&e=xy^uw
zp`ZUdsm~`NqE+K~T|}nJ2#vk&9_N>?d-(NNhN-*`z4h^y00&#=9J=@Q9NDd;f@DtH
z{+W<gRZGtUHrP(R7dN^Xo9?uXqlmjMiBy9vD!`fn)QDwWjGF<ewYS0~m>x&J??+F$
zk0Zz3^lU<W8F+IxK<GM7PHMSi$53ElA8tB=G~plCB}hn<L@q>CdN4Z5UagtMEXFkl
zPz6(DBjP#+Tq^jfdoW7LuiK{x3~3VQ!1L*3;1@cSveWL>%hko(7oYp!%N}A&ks8J|
z@CT96U0}KGn&JD5Ix{yPS6~%a7@$rlpszC$e$b?!5bg9OU1>qR-nK^#SwQGYp&tH>
z>n}U)&gd?mmF<7~_H$9*m%`D~^ZA#te%%tDyq32^T5Ms3xUgi^Ma#p%1y-GEOL;|E
zv$X76Ds0DvN)*!aV`<&BxWe&<31IJR#U}BB3>gFRQ}KOsB?F!t$au~5PRR0fjdYa_
zBaXwdUn;k7A*PaQWOfgKuoalU#Sq0*t(3*~G|n)g@rrab4Z~QZgZx@0<y_=^9?Rh6
z46n?+JcJgAyPRxuhfK}m1-bO5*>q)`$92<N4ALpDRrGGp)Y1EaII!TrJO4L}O~@m9
z%G1ei$^Cg~nU6R7R(%RTDkzoZ%a<LdG=`F*A?UYtWhaueqbf`vG<i7N`y3HJlrL;7
z@V;c%hgaqU2svMHR(jsrb#LVHSV%&#52sD@$eqL$!OGiJulCi}Ewgtc%!^$FdwqGg
z;Qc-26nZ2S$TP7=IQ@}VDojSOF|upgwPl8NRQp}d@18ExjrTN(9bDtpGM;6O4>@j~
zr!d4P*b&#;Kdg9(A>u4-?s$$fXGH4yX<X&in{}QMpGu<R${yB!LR>er&V;vCiPLzW
zQG$kYsJzx)B_zXq_cpUfb+90>(aRA!E6opApWfcMiqcpcqDqOOs?zi-+KX0ni_N~0
z{M_4f%X3um>ZpC&l?i%ajsRDt5ztq#Mj-pr7sje2NtYuc3zbw>Os3Qq&7a;Q%%977
zE^K@Eni3RPF=Vq};<>D`wUuitF-(Y#TpMT>fUQm(Aa)y}7DyodBW(HbfH6q_Ko%v_
z)xKnOl&$zu12`rE92%FLb&nXWi|g<s-SyGZo{Sp0^8HL_>J0VBavS||uv-hZFzzX`
z&!{Wx2?j~EJnohRPTs2Be$=<Ai)=o8#UptFVZ4|!+0*bGR`RCLkE7*Wi&7yya&?za
zt2pLBRp&^;>q<u5tS1ldrh3xKS7_xPsNV#ZpDL>~X)f&VS1Y?Y#-6k?%*MT;Yi)eD
zM1u^^vxd=V*@}gnK!Kz?{-=BToW)!mMSQu_&zeXmDh%aMO&wovnvuMGUdLo)%M3zt
zW5$eV?#BUZH)IS$f}~uDs}4{t5X~hxKHT7Y;2^JRxt}yCmDIR{s!!a0cmvUVc-H9)
zCCCJM^WITn1-`(y;kJL3Xj|dUgj#W@=4A7&u-J7{88ffXc)WSTDW%k36r4XCWR2$Y
zcQPivzt)Ss*W2H>r&N)f-Ayw3dgI+i1#0q!*Jf3Yo^|%mD9*bQ?i{{d6rf~%lRUSe
z%L~lx<&RjZ7cDq$C_V4aM8{jl;iAeHT^`wGj^@)7bsp~5$~F`IL_Rsl>P(`X(P3&C
zaA4M2qez2O-u_wjx+>)b?|t9e_;-m_lqVc4rp9krqtTuAC?U*TLryTaVh0gdtGkl&
zbQBpa>HB^xxiw}aKb*Y5X1j;vB#G<v>`{BmLq{A-v>fJNj^trZQG$m-x*03r8y7CS
zv9zqHy{PE&nd@)cHjC<S+g~oZC!W)4i@*U=dPH*PT!1+jB?X*l=E0J~C_6}>;A4}r
z$^~)Nl2jkt`I{n>&r9rzeOIT>>v0C;iIc=*wauQ=Hq*0k?kfDP3VvmEMzuELrO|0b
z=Rluk59K#}J8d<c65SUp^bC~<$Vfb|wmd0nI0j!6C$3X7sqW%g<y(IDL|s=)o^*V9
z*5eoJVOm^r@zIi<#KzhgPJhec%SqK#t<}E6DLPuztxvyfVFZ`2HqoBu;A{UFbq!j3
z^=0Nx^IJ3zqTtZ}n^XatlanDb9Z%8oaokuBE4Qt?C0!AR!deLj2Y8Fv4$bc4Jp18d
zA?C%(actq*F_Z|-F|W53?A8HPP3trhONUj<%F0S&P3}d`uIc7Eej{V^(Bq1$i`LN>
zLv4yt4oIG+Ed8OAyBl>kRuMT0?wIqNVI}fsvrbKV&Td*W{IoN)c)Q9fX_5_|WIb#Y
z#!$iN0zp9MJ?WBkS3xVMCI>|YOg|`+t6p2$ca#TqK`lNy`hb}31!7D5FqXq*LncMt
zxZs`7tJ`VH?#iP@p~qW}T^ZrY%pXhja?51A*DV^>WpDRIBK%$P`tP+39{S%MVf&c3
zu<mNE!-rm2^ajacBlyP_&FcZVwN&HfcUrPBEKMHIi;%o(8;4zmL<KQ~!1hVg6pqoZ
zTQrm*nD>e@N^%58EuLXb)iXB*Uj+4?Sp$uufab>$<frtG5pjJ+4QhiDr0&|_kmU^z
ziVHQLB{Us)bNAStxN}X=#xKpn{s+u3DWoVXVqPr9s;u&MQRir!9zwDC_MK~{^6u_p
zeN*M}snOj7>6%1rM3tP&NQZT(Lo$23$0x0;mzqn?!H#<gyyH@2KkNS%6aR$KYQ>1c
zuAz7h>R1deZq>TG+vTHyy!4pr?F47IPQQ+SuKV7Ur~^jt&dxu(mM1ad)a*82R#ez;
zjenIjin>}QjlL*}4)bZ^UzjdCpB$~s=hf(GH`~0a+}dm9EIGa;3>;!8#<}Pi<EE!b
zX4@AllyU`I8eEs=UIKqN!sm2J)%s)TJ_D_%b!;o{htZz28ShCk*1qO-Hi&1Lw;@?4
zBDO*%mm+VOc<hPxZad%X6WV-YN5j9YyZpxS=8Y{DYfTPq@07h+f$k)cw%kiTlH&H(
z+E#gfXGYKB!L1?98N8#d1Ml1;7`s;v@n=tDh-1+iq7yjLO{cnj@?ezHug!S(SH(CL
zny4I?9GTV|$}(QH6!c1C)t8*BKFD4*L0;!#8yVtEgUS`F^S872JnQe@onxhN(C{M9
z<Gam}Kux8{2;yaip#P{<8^+0Tgx|JSck4S3-D-jI2m9j(&0GVv3~<Z)KiJia*><)r
zKK7=OPMkJzZSGBC7J0dg1}C<6DJ#~>DiM!Z4Q4+${xGs#W-o7tXA(D$o&1?-s9NuX
zt)fEYFz&P<hrjp;If*1Sil`qDZmdsN>%ts-czjUpDOzUqxW1?SEWzI7{Uzf&aXg6T
zqQLd=N#tb|XT?@x-jOcM;s1xZ_l|3-+tx;dsHikSdW%v7ML?xVkzk>Thz*ghAkqXx
zT7ZzCNG}l(P*8%>EI_1pf>Z$o>C#E)Qj$<YAR&I!{ho8rtMC5pz3;i_?EC$({+Jlo
zT63;B#(2gU&lpoI>kT!z$y$7+`Bk3ts$A1zSK|qh3s<-#A~eKhL=|7Yk7c#qepamk
zi}glB;mplqho}K4f+@Fim!s(w9oGO=wdaJCBPMs%Br7LDp!2i7tf*<TF&9FrThnU7
z=CQhOeLE~%>{#)K^3-$PY<zKMPUg;j9tMi1Kb^2>qGg@`7CkQC#~g%sPmxX9(5BAQ
z&Qsltb`R96^lybe^s1D5ObC!w%U?R|bn#+AJ+68vci8SSXZt6}fXAf5U=>KG)sisb
zxpW)CY0f4wt^)OY>eE@@MbCcks@<|`RdOp#k}O@yn2}tq6N0h>f2)&?E=!Ggi#SKZ
zhL@CLtV%*fZw#$0TI;>(gxpFt<-Qnm;;FlP<@bzJ`}n8RkJ+I<suDj#3&X-PI!>V8
zGs=2QM=?V={k8T~MN&@#iW$M|Kw79bHT5-jeOh)vG8rq9kW`VFecxPW(sH-$ZXS<;
z(=L55V8EFR=ElK)#K|(407FIUD{g546gt>rzhZ%G+oa(jAdw$GXG2*BVBzG~!|2<9
zk|QbeIui1~eJ$Ybws#iM&r@I2;=bXw#GPr(z`p}r2v+YY`UUE<)2IT}TAKM*2Jj~y
zC3d#MsIoE)P{tWz3S8omzq!QJh3$kT21<Q94!Fe$oJ*WkQ!6@d2{o{YWb~0X8aM|h
z2`o(kpCm|qVb5LU7r)HZsVs4#;|=VjrS@zi)1R*_Cnawk&fv?-GMKXZSY?N|5Ptd=
zU&wJrBF^T6O`-IX6z%##d(NCg1CI2<$#90Tx|HJcyi6-#dt6ejJ=&WAJ!f4&3Z{rs
zJtwX?y{CfU3I1T;q1BVm(gxg!C;S_{+8*TARQV^^cn)^D=9uYaf0Isd;qy6cXy-BF
zr*_)lw4>0)rQ#a*D-{Kifj2s7TJvS@!Jo~1ZavZRo|w8t?l}bl0RRWq0dybG^)sHZ
zeo|BFjVl#1IomnTXxo+>sxke!Y`&zXWi4@dAHeS0sax88^ESZmWxZAl+-B@d1BJPm
z#=qn`VVG;@K*?Fiw&Jw$XFNs~pI#u@Q4~sO(o1p^3+QE(BeF8EZarOaZJf^g6y*fs
zjPHpcS>%Sqfk4<kz&mHIr138%Oc+|H!b)IPmw?k@zRAMacM(<$!&~{T{D74FfY=n!
zXr{e31ptuV*-k--x^H(baSmKAS7N!g3<W*~tmO2<L&jI&&j0I<;@`p}d^yvYzxQ5r
zZ$>NS2L$#K`3Y2;7=%&6=(70?8^Hggz);RqA|3`PIV^<6D3wH)DW?{VeBZiZBo$ia
z)D>&Ck5QxkNXv|rR6{`TaJDleB@!utbMw;4BDnh24SP16_cJfz8a4;!tPp__sFkO>
z)T!F=d5srs2h&U!eXYIUZ@>Q%&!w=u6c1BqU+F^LTmG&w@EyDd2sB9Jee2T|@+TQX
zeW=+<RlZ?VKWDkTD905t)!{An1!^Me*bs&;n>VtF0y$Oc#y7CwK?UpMi!9zC6DwVp
zRHK4&MpnM;Vw6x6enyQ>)A&0n#)CN@`+q=27+<%&S%Yn^{M;H}Pa8k1-Cz0x66SB{
zzX|fQS{K$*z~=~-tHS5Uq828B%u8Y~r$70367GIJ>kUFq8jy4GYanerzNOozZ0~f^
z&qffz0_b%)jQA8LXgX|2Y<(Idgmt?^b;!+nwLMSM8pEuT#r(<Lr64NyJ#R5-E2L=1
zDxaF!tgGL_p?5I2_p%k5XFGMhGqkcaIe;|Ylq4*#Y@=|}uZ(3$>zom6G@J>V1c4&l
zHs-D8rO*#?_6qyH_#HqwE~tl&zA)m%OdAA`c^O5(5DsEBS{&r$hCqk<vKUF$*+Gv&
z%h$6Zoo!aBL={=)tG(4GlQqUmLeUtvDmQAZd?X7gM3e`4eZT)kJ%*1O+=LR$rR(H&
z&USjt_;r>X(2%n_@YqC@#|vuS4wO=StB1nkcJ}wB1IF2NNU3i365h)<g>@Wa$~Y#f
z!_|n9>$u0Y%&6VN?QgyZZ);6LrRl5R?pVKD%&WNRL#WYfG)G1dM)!d*nwC@%`bu}n
zDeJMBG5b-G0{!D{dOf%+y`E>B#Nu+`ku9b@OWv;X)AG4kTZ4%dm63QI@ld_1rw%=R
z#F>SVqdASkBIs76b9k*X2~_=|Nlu<!{kPe!YLpaThs)VZ2*#S)C3Z@k`OYMmqPO@`
zHF$|Lj3G+5AfrPy6_ZxhJ}Deb(YRw5pVa+@wUvA8!6iS*ly!E836=&>w~jc{!{A;R
zFwf3#$g&h3Ho6orkYEbplwbUs2-Ye$FNx_MDu@;>A8vxc2bK)+u-ynTvhPP&1az;G
zh5{S)8MV{s>!4Q^d`W9K+a@>4!~N*lcap|&+9MpJBeznPyaPI^-)4g4{Sm4!P}5fy
zEb2kAS$<SDwa0+G5nFAOPuK3NR)^ALX>M@qv8E|u^PBibGEYD2iP<e{?l`V3(Iu}X
z2zQ>HRL*IUuB;MTPm3JlJ}U+*6n1zq!hfXb^Qx+d!{=c%zEf!zIvKeKK2SHdhg7y?
zMu0`weI^xasSh;2;_IG)OJ9$8wQtXe{g?!^gjA^hg7s~(s&`H_&H*dv2xajCw&{i^
zd|1D%xUwvz|Fo`!#z<&c+EB;-g50>3kJ+|3uY7}+fe(xh47*+kLxQTlP4s40B!uR8
zzjuz%eETflEwX^7p(n(1bC5T|XJyY+TH?$Arl2#l#Ff*qr-T@8E!S7V$zeG(>R1`l
z|4Jl&-u>>!jN>}fdsy!?YsOVgupJk<%y*J;lnSkf9RNY(bfoZCgvT9aBXL;Rl84lb
z==w4ItKKP@<UM=1n+3vFhL4(Ef1=%Flm)kIfbBuKFC92fy^=jl4bUe87Nm5)*Ql0q
zS&^KpM!39Yc-?v1w*C7vs8vM{-POJ{HL61kZokraB!8OpfEVt7lh8>=N?E0MuTQrw
zpWTUa4cnm=tr=6@-F!DB+B^2lftWcDAYwLvMtltQs{RrfAGOLdLN4Ds(Dr)Lgn9FW
zQc|vgh{t(>-ACWIKQO4PlK@I|35x2kAo69G<-uL9c2}$Bwc<x_%&-_*ot1f29^h24
zVlaIPEga<kUP0pE{`<PB|3Nn3Xqld^1AXiEDS~)8x)RfXjYv~VzCap(EUnjvo$OXB
z5FL?QJtz7i^s~F_KE*1AS-v4;;?Q;=$Y|#C0|Eki33^TY=IZzma-)MPOt`uFVjJWW
z3=d&Bu{zrs3W)Jw>qCHF(+V)t{ehR4FFvZs6S9$@#8HhEHbBX;1+$f$$6kd5nl}Ad
zLJ!UJ2Soo3H_QN6Vw~p(N*kg-AOxr;`G^aZQA=EoKOlG8+>T(1Et}lb_8t;A>97oK
zcr)<RJ)0gE(%h9px2HPgB2@ZvR^*h?MZ~~dD(!TmFLMaIb>_GhiSEC@O3aP~qagd1
z*F_x&xRy~v2DdvO9J5H9TuJI&MA@3jg?+I<9%-YZaBRD2xU7oXWnp}`qm~GW3A~5x
zf$I(|3K;>0dc%x?e5Z<TBE!$@#q=mza=mVHN9~TUj3bP1W9&VXU)_-$z&yD~)uIUY
zpbmg9IeT;X8;&0E?zmM|srRhg@;dfsH$zG#NJ0SmXM4*<&?DVz&l1jw7&gueaDf<=
zd6K1GZ`B(MFsJjT&-h&XEXuio{XKGJy8dt@$4JI(PTPH#IZ$QFFIOv%Q0>+_WOk0?
z=<QzYiuMSsJ-?!jw2ezh5JS$<{V_4_NEPI_l&q?ogY?~uhNO$OL<aXu`Puf5I~jA$
z%x=u?rJh4IvlH%*Z1B+f(F6E}(ZJk!8>j8%P6c0#=dm9UU&OPP=jdt_$5W0LfGdB3
zWcBsu0JRM15gKu0ARcyXSK!O-%s?0X1|T%1BaZ+=Bj9OgUf-Kh_7f#<a1K6NZKDd}
z->mj5VYbYaEw(eYPGEv<b|J1zw!34lmXscM>Uvm_*()C&+IM!{eXO#8nR+H)n&Mf#
zQp*na*Ic97FcRA>Fx*H%syiW%7$UEE&C{3SzSsG~!g2GnbEO;nJ`>?aZH0>J%?5`|
zk|kH;ns$Aomy(;xqBP}b@^IM(h8XqQq?~j!j#c3{8Ah3&jwvru?W!p6l}x%`;TLU`
zbn625c}D>VhgQP&JEX+?4~R&$DouTUudh^Dkk(O`(yPvM@dAwngu{kvRvvw$y=Y?k
z>FZouOuot`>$&}^1-bnjd%9YMqu*ylpM2u~h+_}-*)f#8!efBAcDB@=K5M0CLh7p-
zNiIEUWhp(Zv^n}YvcE`2BtS(&&8n?s=2p|wIPII18qbeNCaUoSpewfH9fFl&_#4%A
z!w{tpzBy4y7th~+epR$9{jP4jl9a*0C#Sw33TXQgqErpS_+X0;xg}atBOBh{sC6Qs
zebnwsU*7FrdFcw(lNk~Q>Q#`3+QXQdr0)h;XQ~q^>?$=dH^%NdHI9H02+vFFm$kB8
zIpTUn<n35j3(s8xZOgr)5fIEZYY&#iWc)biclA_+Dw!Brz4z6EV$GLk^y~2!_V_Q-
z<1QYOCpCqu7H`Mym;h%1o@`EjMZdXSO*ejpxcDL1q8qUbA0_>@c;Q>W%lUwQ-SWzt
zB0NsaPz660W_Rza(j>XGMACc8Mt?OkX{cXLwn6MD$<iM<)I$e<I@H3zp=Ra&FNZoF
zw6T$(vyo=e^fQ^%N#p)?o4r)r`BIh3F6tNOMSGK?AKWVE&W!saMoi_XRy`Q&`HGY?
zF%ZJw{hrbpDbZU3<)-E|THowderauAUXyYvR3hTSQArQ!JLj3RJwxjFG&d-Rarz1{
zM;70GI8re}e<~qpx9!wG46;)wS`qmXCLmb`I5H@zk*Fxgv_0JZ;G<IqV?%3#Z)_*f
z+22w-8?_|M$O_?JH4;r5x*HZ>@3}KNvz__b8)J^X^Q*F-{bKUOt>YvM?+9Fa0vZIu
z2vIgv+4NEC80JR9x5qvcIWgSd9b1pqUzLhEyL<ba%(qF6H(cb?<8`RV6dTf|0JNCZ
z+-2vqW7VXZ?5ynq|JMOjd!6V8kpty&Y*!9)WqKr91+(ovW}L(5zhSN##b840BC|xS
z(OgZhmk-d7u$7r!&g{`teX?8;UiGM1Equ35M}OT2$F4wCZ<0&BDr!eE1rfhOg?oFI
zuc0*!_=my7L)dZcD;sz}Eo<0dHkCF}_NZ0@AzeT{hc)&SOU-JzTk3oNLc!Q@`>l5$
zF2(N}l7u|)xiv+e<7nv;6Y4@JOw=4vg0eXA`SU$LpqP~xQtk6WR;`^&<ia~vF@u)F
zAX!%&xX?)73z&u)4L7zp-V$U%cMVHz%MwPWt;=&&6>YnHy5(2uHa%lAQx=h9prpDI
zm>@ub8(#-@NZY>)@OQLt4w9W+{0Blyz%KG1NfYgJyX95VD;_BvR+<WxOuIfuE@ydH
zxN?$-Whe3qooxU&k)fqPrM;!AQ=d;h_rkJM&w2%#Gfqnwa*fuHE1ekpbgy~!euf5a
zI%Vnu#|~&OXg%-;rATxD7*IHL2^KJmU?(5*>p->u3-@H;70Pidg{&}ia^nkCnIHg|
zJD4p~c8Fge&y_PfwfGX+sI#OkW8)?FZ3$=E&-@<_R{UHO8(qr`tlzaC5CfyYxSxy>
z{Y~bHrkU~KPD*$(4A}r$8$I@3gDwe^neo`iS^}2s<ZHTGhr5*xt26|>yhGfeS8L+!
z16;f#+A<D^?{0Wfe(lAYmIMJah|(sr00spY!mNw#N9f$^Vl88MlbEbiTUz?Czk}z|
zp|FxT>h;!k%(M98r}&gngBcBJ(p0}U2n}*hjOG;rJRf_oSI(RL0^^9n+QR$Wv<f+?
z*gbtG5*j4DmDos8H@#t;4B(RO#NzPg^Eg)Bk{o#GkV~M-_p!UxkAx+TO0}6c@LaGB
z%)Fi1N?eJaGpAqc!P(hF!9?iFxwbG4mn6=~PR_F}_a0b()~V@xO<|YosC##!g#Yvc
zFg5r@B?H76JXT~JPHR$S94FN@7`o?<j5R6E?A_lY^(F$ZGSB+<P^qq9p`oHFFU^3i
zQ9vD}okNI`^7_M+zhFYsh!%ay2M%mMzc=Yff3K1tESQsWT#(hxWQy$sDF4Mx?hcuR
z0R;X*_xUR$S!{SUD$m>sUO3U_ni+59cB8z?EE}?Ui=g2I-RZhh<k6Y6JSbkFX`0$V
zYH1!5pz7hrLnuhDig@<3ff6?&?^bu`+pT0ix|vZD{CRleYlW?F+#^q$JAmvh#!rpI
zpEj;zC>0nP>+}&;@(&_{+Mm=t+H<t6?&ODq?;&S)nnqA%Cqy?Mt&1KZP;(~P4fVPt
z^-8*zvFR=k;<mqKdzYDIg>$GVP71JyKm4`=WuqS_aW-)dH%xjDG|C;7Lw4#Gkw!k;
zw3bO}%89Q#m}23(OA6k5vZZ=|)whT7d%mL_6+*<6yOAg6aH0s|iPN$Kbl4gOB!q7p
z<6S-q894EH3WjvND9kvAbNFQHwv^!<Ts6IcVF#^Q#zPoK;0=TsjJNOMf=S2RLp716
z(ZjlxUe?!jd9RyZH6^<Fw9dySb|TJD4d23t8;uF4B?z!cP4U&?tm6J5lMz|Rx#yex
zNAOSej<5%d@4wHIo_@?<b#a5Nfgf)~hX}zUko-=;XTDl=gm`tiC1tlcX5LoXEx<T`
zbQ7k)q9*Dx1W2h1b)Zm*xgN%X;I*4j*jZ1SFO?eh>ab67vbS9^JQkMZYipp%Q3not
z4*97PI*5OORDV3E<<En<gPv4?2<AxZMmf?LCH33Ye`t=_g`b)P+u=T((})8Itf5NS
zCIVH|870s0D9x%iD^n-?rnQl~gi3Gu<91ic{8)X{tBo1A!`d!&{!MrN!SM6TS?qEl
z4;WHiTu`+0@D~dV`975q14wCcDf&`OSi756E8AH;(K~lPjjmvsJp<Xn8(K<J9<KkS
z@;<~!P_vCyCzBfmPooM^YcbBw?R`_L$dl9+W1B_Xwj}S{GpYOjf~4Sq{tAn;e$xmc
z(wg5q1-C7m^f2QIaHu1!{cr^>jWVl!Ubt<wp@IH1&fXJvx&00dOIO_5)qxngE!7iG
zj2Y)pMu#wD|CZ`1fTUPR>o4;!uD09<xvs=Na$PTOt!PH+Z>PEyTSN)o0tKhL9q*Z|
zSonFnTw~2W&n5h(Xy+^DojXnu&)hgp_rQWGgN#X3c%@!Y?Y{XmSnpc57m>?lDAjzh
zzU<0ycvJDUcHX8&G@CQiUZHnf1Cj?;%R;Nw2%w_-qY|BY^7KB_1VEx;mr89kKi_if
z`;bb;1I>bwH>Fp3S+2g(*teB>c{{mU%3~6{AKs!*HVt26h4NpL_s)YF^=f^w3)DKk
zOuN=$tmN={W$Nl+-9Zm4n+90unDF)sq{srOgLwnml!P8*3<SF8Smyd3?%qAFl+@oU
z;=ICg_nvI>U1{d{2fNUcJz5g;HYJ!PCQ`T2-fH3=gl5+g-R{j{--G=nrzlR8Zhymj
zS<|9wpWZN7-~sjH0x(A+T1%da%^ZR!TqiAK-CxZ=alS0o>!W^0pQag}#rAe~((|~W
zv@}fduKPDVyg6NldVDBr`RSHQ-lXhciP@4An^Z~JU0J7l!=&-5@ZAlNa~gMRq(K=Z
zL<wYpXBG$!j}ce$;GB&^FSv%CRn3oeiQBa7X+$}N!n0z=l<^|qK(+*JNe@`z@W%<*
zknH5fN8%oZxQRgS1-;&5$3S2U9l)A*p|{<e=jf^Pz6_?Is^gHEau9uEF)953cFcXh
z<ZF`qn=+}-s;YLGKpm^666&zo3~q!hDePmOIPDUtXVk`ef!{dbt+V;#aVH$E5?MH6
z7%~#L<K3HCX32z!eq4cjgP~)ID1@5Ocolwf%WpZM;qbO@!p_zB;iN-ivo}Y=VkGZs
z*YR<JWLc-c{E*69U^~*fXL}cKRaJDa1*qjorbxvtO}nf`w;nhyC6IA4$x<{k_VK`c
zPCc59s_;>attXGppFY2})3m>TbwnQH!u#&ak%%+#XSm<oZ6S-KtjKac(qby63So*y
zyDEA$kCn3L9Pkj|ew%UZrdqs`&RAaP)%_4{LMf=K<D12shT`!22~GZGk$HHT(r)LK
zbCRVb-G|&fju}x$A>RijH(GdhXvO>iHpa@0m)JHkmL~fjz8nV#KpI^4aX_h{968N*
z`q~VE9A=*9n4FQjIjKJ@3+`@_&`_E8nIoz4@s)G;DLr;m32iUMR3Ym(taY^yPDH!^
zC!T;NW0;kRRGH2whSql!N9|$wjFoHya{o){4IEm(yV3W4*%vmS2f`<+M`SvPn|CXY
zF$aaMZveGXZu7@IK*dKV%853vG2tFz*WpQlZ66D*)~eyBMAxh$+2Ns}9#EQ**kJ8_
z=Hxz^*AJmTy8mDi2iM9S+d?&casIA9Y~MC?@=4~jPWi5KmLR*^39(KT^AX$qs{6Kn
zKpMw(kWkTP(8d%?(?Z=HxnU3VdANOuXY-;HnmsJt=`t{I-q{Y2IC+m@XlRS=uAD+3
z>a&EVY{o#}p<n-1@7JNW*n#Z|{yc|oE<>Fm)h0RA)w&I^DXkB6)5nV}Hx0BpwG`Pf
zRjFPMCyEq~dc26$R$f#6^%lS15ejR-j*l2fEf;xH-nWux3<|FKjPXxjl&PQaFiQz7
z5_Vv>F#tY#@Xu4qv=!(nfX6mjjQVX1!4+)xdqYJo=7cf6Z1YW+4rA_Vm5}-W;j_;e
zVBEGpZ1sM1_O!TAR5xtp89eZ&#h>cQ;DLfev6xU(eVu@pnDOf{T@7td4Wwxx6sWh!
zAc#qTg)AYe!d7sFuD&DC#b|AkC1b_lh2?gpn){f-@|HqgK+7;^9zq8s8#uwabP(K%
z^Xv~uY}aq&ul!o0wA<?$OJV&#S>Yip;9RgEn@wd;Ku!YjlwZdjcJoAzk+?}5zY22W
z8%*EG7ql|`rxVupg#MgxPts;r@R5(aWR`!pJmA;9sQPnnmIh}%7$9yHa@l3Tt|Ha|
z8xF&tp&thPKYoUhC7^T;{XS-XM)L*JK$k+zsZqbK-d`6pr&{BIUM$^mkT!m6`;hWD
zc)@{28&Wz09E!*K19CVYMO}jaI%N7BxQl>#2;EWbk#9-OXhw1Y0<?mU-v-RRIt-N*
zC4`8(@aA}AMv!83ny0x9Cz6YPn5wh=3aofp1MVAiXv`Gg;2wFm>TwBFB50V$ZBXX^
z3<OUEJJss2DFDm<<N58F9mavxCNQM8(_jun5%}xbW`-ikmy(SODC(?Ybk&5Rl7;Fq
zRgw15w#p`WU5|tgBe>~5UTw>*;Ezyt&_D7x&7CeA$U@_!8Mf0*w@jKkQ>T_e+GC(<
zX}G3#SuxFj9})R2(1oBty^I2f=k59dNic=cebB!SgJ!hSNK36^8e~rgVqoyv;{g<<
zVZny$chUKM%yI&Ryx2@glMHSm)c{utBbWif!xRBg(5%K$H))rMHM9=Q;u_WxaF87o
z28S(c6F~Bt7l?1^W<1Kt=I~Ow%;wcwyLp)Eux!8Y+~3E%oq&fPYPtOkH+L2k9%h4&
z)UpspO`sh@Xi+2H>AiO{&!LNV%Om<$q-$3nym{Yld3dyn^GpZPdFo&IPy=F|q~(|i
zV~!!XX+!I@6GhA6X@yTqs)YVXm15w`X#@KEEFg8*aNIxn<}9BBPveK<HGK&)onthX
z`Mvp2%5#t{M@rDS$kM@@axRq7YgcH{1kPu1%PVg9#9Al8{kJct-Sn!P-BIoEkEKA~
z7IBj5N=7w`af9`7As02IS*Nnl{l~Wpd$%!OSP$uCR}n?xZ6QQw%avvwe^`UfpnC&~
z4H4)t>B@R_^BDb0Y3)VKN;m&w26@(#ZeKgUwvliAj~{A!8a;{r2zX{6=Jz`bC4b|;
zK+}ai=q9dyb|@~G6uY_J5#YO0!Qgbk?OfAH#XhWLq0Cfy7PTcTIk`}*(4m{|lJRPq
zpQfI8Zg{jv+J^m;?QQ&R6_05$4&$#?=|diI`T?=69>5hL%2x9-SCMV<yyd07CPVqb
zPZZPW1H<G0f-+nF{eyte`oE?-m)Ldede>+#RebNnewU7jR2kSe@%Ctdh#0#q)uBO5
zkQ5kwLrk<My->gR$Q>PSEsd&&NzxU{E5`qLihpR=fxVM9OmIEIo<cxlPy1|H^7xVd
zvs)?}uTHh<F4wRl0CD;s+X0c5;r)iZ#Yf!lMe$q-dKa$p?%`L+sU3v~&`&_MLEW;l
z7OR@z$}##S^q$+TjF6q{5+#U$-)`C$<^B+}FYmA!;p>&>dkz{Xttg1STiK6%d|9Lk
z8+^Q#v*9$C{Vqeve8ug-!#>y64nC6Y`7Rs)mpd5S->)1ha9vy+^6p&*1ab<(@hJO`
z3@cVW2__8ZZ%(dNCyBmLZ}k6syy4A!j}gTuE^kFVN$t}0{h4n^V4CDPa8ii|2%A?C
zh}+!b^n42xxe|u=MOcBh2^K#fiS6zTRV!W|j@f_VN4q+F8T`IY<6Ba=O-qmpp7cW1
zFH@_2K+XeaPBv+r?pAqJhV=ztrW2!ZYlf(m3RiHB<{XfsQL-;1!ku9%hog>qUBAq)
zHcqt~=SR&Yfi5Bsh5>O97~o%CaqdmJyeE!SRVxqL`vE$1+cbEDFgOwO&yV-+x}t44
zi~4OgdcQt?;q~jFiVgr;etpwwVgpi(+MWRiZ>V)F8J|S0*4xHR=TQ3I3{p;AH2QS)
zlEL!s(^~^Y|NUp6f1Bihjt-M2=!p5tazKBdWPW7ij{gh4hQ|=52^~|p6g_k)c>=Bp
zJKg=PX}$R^Z(E(ft@2n&wwvCfev8ht!PUyHpkRw_o*`81Dd}@!NnTgAio4_6Qj+9k
ziC6Ju{+}rNXFcBk_9cR;{{h*5a}LH&cgeE(WLw^!a4~)m1Y18?v{yf35)e48KbsYJ
z<);}w3Qw)G<|Ic+P!kLzDf)FLPnHdKJi0VGXHpOk?~sl8-Ao>x?W>h0DFjt}_~tl+
z&I*8(BJYLPSahdEOspWk^4b%mFAqO@v-$96yHRhFWmeYfo8}6Mu6#b(2F;V@D}D=K
z5P%>3Pc;v~HJ~r}zk<N3z%=y!C15Mk(laJnA<=@A2hIFGAfKcV8UGS|`3Z-ylBAY8
z%){C}19H_@CWw1MV$p@qf*yq~8#5~UtQ*5Hu)m|Gd;8O=4!u)Y4C<d4@g1|hVyYma
z(n;|BhQr%A+6<!xYaIqr-T89WSPl2*j8{EAOHms|(H_110F`LM@YtP>z#SoZqbYaM
z_P9@Ft9Mczo-IkxSBliyi^L3?@1JTyJp5<t`fow@*WfuncT_Dl!^QeY5$)a(=aANC
z%~rdXp~S0~?7T&JyjgMt@~5nyM%+SAM<|x~PfAOt)wmEie}#>IMUg*0Lq01AZm??!
z(l62Y>Bn4IY3?-D&ol)9PRkN!T~}ef>TaV2NQy_Sddep1AHxncG?sn>5AFt+I9E!-
z1?QrQlmg@!I=EEHVa*mN=xpNi4y$J?mlPj1A7LCMTc_e*%3Il(rnZ)bxy>}Fs2;yk
z|HwaXsP^=4BI4XsR@WJFBjFg?QRegG{gNqu{Ad%uJ+QMf9JT`=pWO+=r-c_j%8EA?
zWGp6V9NF4`hIf9Qy{4M)iJps#Py^dhE-r|P$(1082!!R#wLj_$e%2WLyDn2@tW#xX
zvcG${ChVxrd&lnQw^kq6-JiS{SE|+!dlGi3q`OOd2i=Am`i{?-S@y&C_P6!#jNk0q
z3w^1<;OA`Q+~R_*yan-L;p{H$W!SHO$^?tmKxSq<Hm1Kj2h7hr(2AnK{)G`(w)bE*
zuY(M5OgAuCcq-V;XQde?hklycHW^m*Z~yV9W&PzwPcQR>hW)?X=%-=*^No9C(&c}9
zA7E8~d1GMkP;_}{ICM=MHGLJzP&N4d9**hqV45u8edf*s+nfobgH}xC$b+b_5dc!?
zqo|RtJi9<<=eH@Kej9@+y%>mCCyF2pN~6y77e6az7ye@4X1c`csYFn$xXc5Q`LuJ&
z;bEs;cbCqNeRxg#^o3;KN`*+el#++bn8?eSk^>HHiBeVxXQv)8V+9#zpO(Q1Bpyf=
z#4R0G>4sf#bsz2f^ZE?dA<g<?&B=d756l0P7(=zWGnymIj(V%0LV#_kuS!NMbI(VK
zZ#Q7UUZQT@8|Gx2D5+ShfJV>E4RN;3E0TtVGEdU<btYk*f~QA$cGZLSk9x}Z7~h}L
zotO31%j&QkO7~=SX*(sPG==HV$S1=`0(at%E4I#lm<Qh0eY!R{_~O71$WaisCRe)h
za7^NU|Dz4n61E@qpC8HXxek-Z_%9!7^w;k;suH;a1U!Gg4ea+n*#C>4_kU`~{w7pl
z$NsYUe!lhZbLYYRI?<DVcV^RcV=R1<U{q|*QIgq|?l|Ub_yFf<@jQp?Wm`}>ldiV3
zgeFITSW@H;ybjN0iIjoj(W{0vs*PgMMDf02r;8u_Do&Jpl<E(Q;9CTtIp*`G1Q7F6
zzFY_wv<kanb&2<Cptg)YeeU(c5#L{A%J6rY0&@A+S^grIUD}ra{2u>rWgDR7KS}z<
z*Fhk#{p+Sd|2q7+hd{r`KTG?lG+mza|4|p>sekM;tv{)Qzignts~`HQAIV%#bCE39
z?YdI0MFeSO?%df8w9(9(sK)hJ;#D$BxRimn>)k7IEr}Sp9qa|o6|;LzwQl<l7=ZRe
zvMHqIs!3F6fA^fad;%XXL(tm7o_2QF2=Zk4j?_oClLi8UQ>)(q24((zuK<te??}^M
z<-qvYrTCAD{z>nRD*R6@=WjCk_jm4JUit6JB<9x-^&f%)oSy%*K8;s?-H749VEv~4
z|FT6YzQ8fo<d()%$6`?zgDCB;>fWSj<kvFAOA;E1Oxio5gD&a9MJT7`crO3!!O8ri
zhqlV#dD*hPi*uU_0s~J`^$B2`rN8<C!9lkRYhO1a6BF{C<K|K<w{pJaE6`u!%8Suo
zUTz$>Nj#|-J+)f5^D9dSij=two0CBifnm7^LYMz_zr?q%5SOZq1>tEfF|5{ArOAud
zMz4pJ&`zb|P=pQ{`V4s+U9G0PO8iKS9FqotGJB&#C9tK18aLx&_kqK!lDf@VhZTJ~
zEb)-=0QyTA=3yM(U<CE`@(;*3nlY$HKca!&+6SeP!9g9eqtzz}&*;V!3^l=7-FUDR
z_37;Rr&ZNu8b;A=xNK(a(|W!F!KT@m6LG4y7|R|59N0!{iGiIl4q5Xa#|9KcY>=j7
zpCW`d?z&qt2M2Nfgig{xqRs#)fP~TPp?{tx)|Bc^<~A0~&*0q%QAY0@b&3&c<;!!6
z+k5_1xTBb=cbsnbUY20%<nV17=IL?jRbS{D4{QUd@KW$y_g$J~JPKpbQIxi=D6Xw5
z|3CZ)j}@S*uh#QlKIb8mCYvZFBH!&Zd0#dm`i^hDdTkVy&V#z`DgaV!*zGJE^~+2;
zyffCS1Imu;dk`A<g;e;uY<T~91FMHjgBffeIhIlj643oYr&S_JvYaCDv;kyzG9Ule
zm*OVr2y25&2lmkTeZZco`$X(i9;X^M4fubV8oKn>b$aZ4-XX^);U?GLE!uv*sW0#%
z+AE!7D^j)-lnTP?$CL-WF&uN~LzQ30?_~9z)o13B<6<+Ex&26A6tv~_7yVCnmG|lv
zqvc|8{13?0^4RVnuH+;KuIBU?_RqtaG3JG_@#3w*yKg`qahzd!wL3^u$74*9TpKqL
zrQs5ztCpXykhR}@Xej5ohsO~Hk0rV>9<ud>-G-GqG~1~DxYB+j%=<LA<LlLP*5@Db
zTRwaoC;HIM&$>LFV>vR*>8;biilvU7H*dp`TBLnU-{-3wZzc|u)S#7pf`CW;>m~b)
zoE)Vz&P;V%ZBnl^l*&RU*WA9`4Lzw7ee1-PzED3A)4lE>uK9@3++x{XVg+%&R51MI
zjk(`ted5M-{oDrW@rS(=mstw_fZO+LS;=q6fdk>LA(%nf2k#@r^vyJf)TzmhXG2w<
zn5vGStfHS({Qui8>?IQD>q0!>WOu{ml`C6x{qX~z<%%Z~R^`=rXOt;n^|vr2>{@Q@
z&(n4?rqVej{-J2TDS&1nHp#;TObk*GbsL~v{)r_$(5}hGX%*1N*EX??&Z$ic)y+$(
zszld{4xblZN=yLJ|4Axge^xUVj8oKY=p)3H06dy{V@zp)(KHR3Th6P)hH|r3CCp&n
zswq{a%R?h<$0bT0U`TyOK;SKapuhkSaJx20{#T`n{<AJHt%5_FPEd#IDb~`A=3Xz(
z(oM{qc?oXN-F9UP<g)@eW`?WWrl+R$PcMLWDF^7v6XSwZy}F@X{*%sPO7Y)ir9-%0
z>lW+yY4$r@O%D_Hd4Fg2R63{BKU^Ri>RYmG17;6`69p8~fsY<qFLRV+#m&Vv8#|9S
zR+$X)&^r{9M35!{X5^Bj7%bIY+g0{*wfg}jf<}}J>g3SCr)Yhn-qf(CA|lc((&9my
zhJV)jf5(bEwS`@PZ2JD2epN$ku04eQ$Y39+wsfr>*p9gE9XLf?0om8{-HYR)U_}*!
zW6Mt;MK_@NTgWVR)=+X?5sihi^pqdtu&OyO+i`hVb;;;khhniq_y6ML5@*v+ki2If
z%cqADu4tMby>QAZbE$d4R9fH@(dGdGc44z;l5}M|q}Yz3g`*@w5c2@)GW~zPcxTGQ
zH2TCm4oAI4IXb;(6fP{u@_j}pZ@5*(TFACsbjX7EoABxx^~#l4$PgEY5hrJzK0>_`
zPivpnvHq`S_$5kKhi9$&<knI(_qqu~(t;ocu%O+A3th+qb_~AViD?)d2oZB%X0iF3
zXw_!_J%F&zC$W~nwRM@L9rtJR`YVc<1#vv-C3icL?HRoL-X@UBix4JerW^7ItVoJE
z#=@tJ$e(<s9_VFzuCM`)OY^8~{S6x~OrscIHGi!G-GDLRclZ@&vO*lK-A2=O6mtS;
z_jI%74KtDWXIcE!F3<h!Ig1A5?0I}r?;8EgTl2}K8?)^<(1`e4lz6)=Tkd&!OIk)O
zM*E*`?HYHyaU+o(ahqgc7F(^b>$6Z`Z^HQqpYZt5kk77(dfv@?P}K`-2)%i2C;%nD
zK(Jr6Mej{?cl5veXI%r8{lVGRgHDx++cjBZnV*wBv>(-zYDgbx=PuawN#sfT#Eoo;
zwRFy8)StEHui)(aF}-=+|K^XZ{U)I-*6_36_qa(NXnK&D5i)dX#BJ9DkLcL-4S9(*
z>`N`!F6cK4UD)ITIEC{vOUKhICd<p|1tlqz`NsRh8TyNjkaxk7@%JGRZzU$%NGh5T
zwiJx7IVyLqVT`pbjc95hRbsYJPg1AOi!Fw?4pqw&96ed;VIxgNO+s6+d#K5b1L*xI
z*AXZFtD7<Gv%}V{wthPs&tt{Y>yNOm+PUdna)chC3F;s^Nf^p&l0uW*RVe$A#pt*1
z7zZ;+)gx?|HB;kNZiYYqHa$MQ^G;B}z}L$D_pa%416$LCB8&O{m61>TcT68TyU4@M
zbV}q-<W8q9Ye8tsIBQm7KKAY0P)BN()#6~Fhdm=EjFwsLMi(3Lv>xXvFy=O9jgWY<
z`^GiUb#5p0oHqC0putT(#=*$RMpL9PpRa*b=8+TS@Pd2z4wcO3(_tR5vdBMR$<f5n
ztQ_Z3&^@Pn`E_+rk-~G<+=z-x0&Z7z&rHPjaTMh`jX}HfOKPldyF1tm12W>vceM@i
z0T4CmhuT73rU{PYym$KLbG1oHCGK`_)g}4kEpiegINMfsJt;iY;mg%sb2n(;QMK&Q
zAwhY0$(yeu3^fY&y?b}kKspHW-MQF2>E-F5zT1_NhT>_CFRd=>9#_P{HGC#t%<?e#
zM7Ckf3XS+&{Xf4v+kZ+7uhkwA{VCFd>lQxBjy1S7XKpLSMcpJjPvn4k-iV7#Bwn-P
z$?=W>%NNI&6}5$~U(tc^{C=6n!!d+Tx`g_42MCAlagR{8DY^$Z%Ajc^%}Mn&u2uTk
z-|YDPy4b!}`1?tpw@#$lMx;Vlwc=aHjTGoNdhtMR%Gi<G9`#0_oe2sBo-dAnlpO%}
z_O(ntC*uH)nh(S8`PrB2Cg9&D4+2sEBL`%-&@tmA&Z-TDjXx1!u?mHq@Xib5jW7cF
zaFj^b(C3wdW_>2B!n|txKC8#7y&uAai+8UF%IXDZybtY5F)@1;g*d)>LEt$?;?_Mp
zTuq4y_cs%8AIG8TtaXrjb-a<#xhRH6kWQTOD__Yx@^aWTU$G~0frwr7YBx{-NPS7}
zm7w2U4-x0R&1TPn)Yj8ky>4)Zds8(}zcR*_lr(4XFbTI6p*vEv7kTbk#*9Ajn@_Ot
z(3gslg5;Ap_Iwmv1ZZ39FQ=fa<XI5%vhphe@Y~Gidl5RG*{=LCc0x+`71<ukFQ?bS
z9y_e=G!001Va3k#ZB-6g-i!(|j`M{kYTDm?%klh_nplktv+dt*E6drKGKCcCa`Udp
zlXs8*cI5bw-b@GWnZl>%g3S;7=Juwuw;hT5^^LTC1=qiW?f>>TU&5Mf{mRZ~%OR{7
zx0FgHS3*y_lAj15ma~xa(%5@IhYWXFZiLa#h*gNBH%(cdDf<%Tvy@s?HdDuP&>?cp
z@y~#p`A6?Ideu1ZL7HlE3zQUX4K#eYx-U4Tvx=rbDSJs#SdW_VtJNdI`j&^ws0C??
z<_xFx+&p(<_5SB7&nfMxoEq-LJjs=8qg>%>gouNH=7YUFOk`r%oozsJ#A}c}K4|S^
zbiqIc`n^?Di6(kox^2aWKJH6gCiX;vieS7aqYFc79kQj~r<yYM<Hr4LTxh<O9QtF7
z4^d$Qwonv}+6{{YCs#3q$6?W$Mm$?%RZi~EZ`G+K6(?%OY^BQDu5tT0ObgI5f~|Lv
zqVT?vUY&#P21e&yN-IAjkxP6wCzUL}pR`kne%O3DLJ#+)J4maMYOm13Nqvs0pVk6F
z^d#7AMjg$8hV;cyu+-gOa7zv)ez@lGP|SWJ!tNE_fqL589Tb;2gym%w#@BB|1)lBD
zmA4&_D`+_INS{Sw#?o^Ua1I7Z14Af+$D8jsCoo^=h8QZj2<AC$>7cna;cv=2*$y~k
zH-zZ?D2{txMi%E)+KMck4|KZv$e*iF5D7<%)raT`I2<GdseyWFTybpbBqs;_ot3X{
z1&J7m;Bu8}&dV720m(fh;(E{#!;Em_53Q4skl1DD7xr;{4;+O1Q4d{_vQ#2LAzUey
zxWBr`e9$r3#oocet?;DoBL%s}u<2HXv^^}+k{d7%BscsiwV??>Y^`GkcJc)Tn*Lh<
zhaP%!Nm+r;zRRr#Z^Vr-l}|7Q$8xYpPq;&nT`(4}2rV%x$85vaMyP96VsZORbHg`o
zdA5n|&$9KolC*OhV{#P}+M<sJ-KJYntJsOn?br}N(~4Ba?xVUi4Bb;b(3;+Ge`6qd
z;M5({lp(>iQ}K!~AXTYq(m@J{Q`DD)ZM})vruR<XM!F!@#3dZ4Q*3p2Yp<NUbcu_Z
zWSQ?Ow~CXk{lVI=#w=nr8_~5wVA96aIL>B;5MLkYaI(tY9OohA>pO;qa~X%?&&MC{
z6nUe|bnp>G<biN@sv)&#5*C(roJ5R0)K$E&<YHV=^ubUt|8T6L2Xjkm#GM%9F?(A0
zeZ^j~HdM~a9B~IjaVe!Py+auG<*kpZ8kFG*iwnIB4{!s50=n4iZbgzwyV~7-0!xrL
zvwaM8x_f`I0y9FbqzIRMrh@uVs-hZK^f2F{xM+W7+2J86Gl4eWkaH#Bf~Pw6EVv^N
zP~&GQ_BM~^Jsp)_z1GRzY?`7eycBwuG&)TjY+<<@_!i+wa=1Y@4nhdpWje<>Su2pF
zzbz{*jONMVhFo9YoQl<{yBlg%uIUhT-|s5Z%s2~D+}MTudi-M=51Bt4VS#6NFiJ6#
z99UYeUJ#~vmfuSw2t>r{e-u_@s^sdfodbdoHx2gYM60SdvQCb|8v50*I}&_8R8*!B
z%v9*vQt?XHtwvrp#hzOD62O@f=*WESi&n8;PJbc2XF>1hxPhTjOI(DxgVv2pM>kh$
z0PA|0(L|vcGkUPQ)AuEl47}|;T-ajR5_ISCb6k$x(!Qm4Rz29}$lR7n@*9_-nvL+1
zJiDbK@6o1cPm2-kGl`IoCY%T5$~>f*nNOX<=H@(UVvB#5ERz|+EIHw|qgFi*VdRqM
zk`GSRuC)AadQC#=MTnUd^&t64pyLivmj<ET!Mh6x?84XkLep=TCrZbAt+Gy(ADeqs
zOWL_QkXABC-y8qkReNM~%*b2r3;M;36Kni(7x&2Oiw(_zUAZlU)NT2d4j8*LZ8lWD
z`QB8snZDoxI9ZN_s@uYb<+^$Y+HG8GzZ16yX)lv2aZg?Sk;wjYo-G$3-)m*5)o^H?
zd47%X<4UegmBCZn^l@=0b*~2cgYv3q*6bssAUv#2XdraGU3d}@-|Ss>3=!1KYQG{H
z6nEPC<mNUe3|{v)?XEpRGTDgMyoRqJrm&DGF_Oui!xhI?N0x>;TZ{7>TczbX^jrLW
zV`>Gc?oC=ey=%fo>fIeP%iM>a-#&k$4X5N<VR~OUs6#zE5;BEUauMo}^Gr9C>SMgb
zo5rJ-Eb@+{GIc`4F5TSGDz><M^mOHfSc2Y*pNhX%K}!sD`AWgRDvxg?EZ_E!#uQCO
z7qD(vKxLz&C%QzSd|ovy=Szx>q_0+$mhK;qn0cw$dSG9n-a#}qsD1aDR>B+Vfx0wF
zl3NI2Z+cRb@)x)77QLa$9=F{kAiNNP2i1s1NFWOj(<cP9Z_U+qYc#*wG}nmWcnHvC
zFZAA(d2NfUmSsM;X;NVo_AsWeW5HUpn9LtT*UNSpJJeS!s&Vd_xw%ee(+MZ3%ZS0d
z@iLj6U+P~Sv@5$ButqYC)ij=TWo|+q54+f7+R%LC+N~8s<#zolpQ29@r6&eN(lTnD
zrw4)&PIz~I=UN#mf?|53a??QJp8InGt2&$Chfk5;MlsL0wvRJSX&vcP?i56Jn8#*e
zN3HY%vM$>Cuu?qWZ%-aoDkz+Fy21Vs{mfygHi4uXHm=<z9<y#SdTnX1NGjIe>>}#m
z<~8Sh{^68*GD}Fc@gycJr7TqQD#gb?_I0MND;t_E;6imkR8Zrx&9k6WbF%5A3-DTY
zAq``}a}K<tAN1pLr~J6j>oEI`y}O<;oC29)$iSgD$=B6y6yXCJ3kRxCYgi5zXB@A%
z#oSC6*$wdwo*x$vdsuteiW+88K~jzOYSn}hq8u;A?ALgmq7`}*`XYKYHZbC2iw$9x
zOjodnJreI(zM}cjn|;+l@V?LD3C&wUdS6~Phztm(!&RFqvFKNz3ooY7+~~Grf0B>S
z#g!0lZma3I`l%Idh#grZ=ss$<rnERbr)dK-T$#$QV3{T%_!3c-t1w<Jd~(sVb!VXL
zwU4D+8%@K3*P4dH!q?@*dzKO`oG6uE^*bX4E-|;RBuErYEl-jTa+Eb#bCJ=H0TbBj
zW?&?-VeC+~YIiYO-0F;kLI>~J#9Nn6ta8APws+H^pj-BV?<u|ycc-E<oK;U+X(x9Z
z@+8F@Z47KUew^HS=K<$x`aWwRa!&X<XK0#A@QupxJnF^oK8Kf&?{DkxIuUz|g{k&s
zb3jk6*g1kswV)kYqbcoBO|N9sMVE(nV)=R-3*2_=44E6~3r8h1h%g1ozW!P(WHpE3
z)I5VPtv0N2X><ut?rYx>S2IfBm4<Nd_xP5UBSNSg-$T7?BwUx`@Yow8kI&1!+KoDv
zAdFX0*}Lz4V4V`viY?+yZwV(Lo7X#WMyv-DW?_zz^|EFi&&yEz?{WFv%Z5!VyjV@4
zSzM@5PfB)pQ+)S;H`{}!ZtrW(xoS<G!t#@dp}@AY7>n_eCY}6i(QaQTYS=p|g7}zc
z9}I3N-J*GZ+=&!nTB6{bX~$r0GHyN!snb)3>4;&^j*+#_Q|YY#>2knxmUzK2U+#@C
zL!0fRk>z<vC?CSQ;44DT6<<|zK(C~{w4$oES4DUDkWCev^XJA=xO=DI7k^?CC;+!s
zC+&WZw-VQXRaLux(W(8IUHfxMjmY<6ksd*Q`7>?&rG;f>PabvYhU?EK3IOkegBl|L
zaJwLY9e^KiBXxSC5G%X#@P@#dQ20d5lt$`|RLAlAr}E7hvhcJX3bKoCBb+<LctdDb
zdwFJujk<nyv-RVp=(J~}y>^k`7Xee3zhO+8ELkgpxtL%?R&K2bNPQ)1Ih-V5zo*=6
z$L!Ruy7iU|o!wfT&I7Q$GgK>rS$eqHMPkm_u%gE77pJRwx+X(sY%_N}Q2eC%l?9v-
z8Rj1v;pgz~yVkLOWyA6_iY>~YQ~<k#WkUmLvU6HnO+fH)HD?1uxwgw2D*)GM(1773
z$j}HPq1dlHbm!&TJD-i&E(i94E}o}3tKoJGejeW&KFA|RqKgxoZt}PMKCePDWhL!R
zOd>wsd*NL-Z<!0-)pNOkY?U0I6?3O={rS3)*34jPN3lao(&o|f`+A?54#sZRvAnWz
zih4yATwBs>EaS6rh(K(cJ00kN9+w}^VtZ$iC?Z-RFtv{i1MSmAVT7EpVjDJU>a~I5
zmp)^Qmh!Lf#F<P)e?qgi3NgR9wfKqN<YO&CQfTDlM`)CMEg5d-A6RQIce6{p7~|?o
z@mz`MeVsVM`5AIMF79L9+W<T?G6fr@sW_Q;eqMaxyx*kC70q^m&>5J#-s<z4MH{Ri
zm|}BMAi>72o&?Z!&e&DHA~3^oOz`Eg^f2S6+AAGQtCEQ%Lx^5m%?axC7=+AGmH8dT
z^_nd9R;z?FbW9~8tG+DhN%iAhmwC7$9gv-?54&@1;GnMzXN+<UXlxL^wjkAysPJah
zm|E3*ewKW4*R3<RJVWcWCIwolQrX!Vev`EKsm=Yl-on$RE@cq8u1N8slS`XEAj=|S
z4XI;^gse1DgWo!ffvx_y8+u@YrKtni#ryb1(Mv@)#=&pmD}xtN%{FSY$_wK>bi=$R
zC%lolQwh6t{lL4G?>+N%+u1wF@6QSb9SawD*~ms&2=da@z+)mAOg$|jh*Lw>*o@(#
zz*v{T!=Z4yyT`aqVg$5CNN1p75Z}sGx?ae!JETP+tJ&oOKi>8)9QJiHd?u)5HGHT?
ztRoX>3XIWBZiwqlUl<S*FH9VapP9L>nQ^L(uRgA<D-@sRQiheMT1^0^?XDr`4WZm5
z!m340K<mMxtEC^@AUo0bcTQH+b>@g{#r!pn@Oxb0-!$fJfe$qLmxZh)^(oaz&}`b9
z*FYA1sr_i|O%=~_$`a8khKFf#oLx)$`#6{C2&(?{HpceZHt1^6Z(Y?g@-1c~0UGPl
zg2UhW0qL^?eL4a_lmeSqysgz^SRC8j3_H4~sN{i#aD;Tc!FQK79G;b01kSw?{sB1x
zj?6ZJz&Gf}Fk88(O?MQ9m%<B%hfsW|xeU~_IA97#VsEGKsBNN}9<pI_vSU;M3eqe#
z_Wgo;=t*9ZRtjvPj1lV(S%)fZb<JSR+W{~Zb6QX5d|JzI!RSgt3XmP16EORz$&JPo
z&c$5oaci@45uhI3dGfOnNbkO1*(#)u?CW1e0mr~547F+c7IeW-o=f8-wS?0ZGvEVF
z2Ecoi{zh-_d3&&?geDSmkaq0tzD?v^Lg5{i>B-18Kvlf;1M;ql%n2IsgUrn9Agwsk
z`Px%p^V+sE_|$rEc=7GoAzUGXSb)lPS7-ytB0mP!ZE3veg-7J30tJI3vnMy>9+n|_
zKSW*cdtKQdQ&YSen5HJs;I_xfr*`b5XYpE7;JFD5J7yQ$w!Hy1EEHQqfhlgQnv~N_
z7HjXsNE7XceukK;*<_eY{4kA}(8?c>Xyj4ENpkaZ4_99FquE~jYJ=zfPJGKUU7Anc
zwCT(Ey4g<(e1RYaX=d=8$+RqzL?a(kiF6}1W1fRz?cG<KM|rzH>P@7r!XZ_+TTGjw
zOr6dfoe^Wl$YN-6)I?H9mb0Sy{7`S@JDW4YiLv<G#W5M&oP>RiadR#xN+i`gA9#{_
zxm1>hWWN5P(AShak>q>xd-hxE$-14$jA?t-%(J@LE2cqp#ZoZ@;|5NFZ<ZE%4ij$`
z#>i3*+@Iw0x+Pc6X2{-tx;z3}zkopSOU*0f(1vClFT&*&ys8-~K}w3kTZHr!FQ7Pv
zNBL9WA89&GpZh7RZVf@)Du;Y1nh7WqY7JRzgCbAnk9JpBUPN4Z{khceO?X;|U$@4$
zEAl&zU(MFH+&yt;Hs`{+Au$Yk05pN%w;>Zh&U>{laPli%bN0XVR`SD9tHvq>&F{6r
zaZ8cP!u8hH2{~c}au+oR9HU?wj@V1!?^;9{<SL0niwy4H%ZQW>&tjT_e-0tV#7i{a
zKhgV@#b}~)Hyo??)f==aYA5V|rInXEA2X|=X^=I4ueIFJg*ltQl|j!Pu4`XcUfCu#
zimKMz>_>`OBb0%2%_-25??M^U&Em_DEK~O)S#ifmUiIS|4%3|zcTcZVUPm`6gl%BB
zw78sqKsXN8^6{I;#A_EtKQ$9STBmZ{=Y&<>xRa(2HjQpTDx-vveS!gHdr6n{C2=6g
zTMl-)prBY)T)3rB!&CBeaI4kxp$K8`=}<^IN5ap}JdJ2BWKW7|gE1?-aJC^u86*Ky
zmPsE&y;<SkyR~!o9b4SdEP2c4tt5M$iF<eoCRPp+K%!9`NbZsAvI6VEhEYq`EYox_
zCh^@nrmx(Ufy6}~m*<z5Ufknu2;<Z=@+5B<QY$>=GJW_MLh2X4O2#YI&o8qzX4~!S
zg4`GQV2cVZVw|8KC96hi8sV{#Q1%j5SB++Co|Bp4Yih;SB`>%n4+wnp7Laz4ne>>u
z-^Qd6i4?;HA@?ILv_zJSbLj=9+XSV2nH|;)7R?<zaYDy_ylQ4=+)A`<txX|`*d!`U
zG40WkYap{+?Z#HaUJqH$`@6kp<$ICz_3^&46NQSF2IBP3W{*NO&L)a%UmkL3#t6YB
zn#DxOQ$l>Hhl{c-&2CCP9#C{mA^acq-aD+xZQC0S0s<n$MlVr8QE4Jgqy%&cA|eRV
zOHg_f5rF`KP^32j0R<r_AR;9yy(RP_0@6DnbdW$o4J5?xb)WC<v-F(1*FN9<?)RK~
zpZ(vO&ytz>&N=27WB$e%zriD9UzvET^`uxO^RuAWi$Nx-SQe_L2jvR7;b~PV@3-Ew
z{fL<j|J3eS1Fc6JyQ{MyB`O1SJ&4=n=o#!0bA%AN*^|YJIQ4F4$MhhrigLk1@7Tji
z(eaMwiDvnG8p9<jq5#7^(vgE$9R6P04UeO9#5xQnp1+iOE$*$98$*`=eB5bU2;uQf
zLvl7=`*c9pHS9AbXLo+XG4Jppg*@}m!aKSJ8fR?|jU=CXUoT$Ys%=f{z#JP?k|w4N
zH>;daUQ@a;%fgQKm#J-^@(ntaG#qjLwb!|@3-mx0;;%}UO-E*bxCbeK^WK3}j3IZD
z{le4yof`t=Rn}Kwe*+e-frw83%XsO(CpjqS@WWBGV>s3+a?&c!g#t;X6wxf#uiT7Z
zcXhG$^7TTap!huGiYZW5+e7QO94G1D7*x`nR@T4SYel&^-<B}nR;90aUc>EG`@K+x
z4d+=bSr2jwx&)LsCdvH(QJ(~=gdAil=^PZ`eGu|HZlV;h+q(DKX278EXaC9UM-$fh
zJ!SrkFcm5b5nyWIJE#JT!nxED+9>dEcN02lIyb$M1$M3S>}6XVAjIYjEH?8D5f`Bm
zZbuA%rG#3E-wBqWo=&J%SFKm>ku4z!wRro=zKfULjY8s?GQSh}-cpzcsDx0^Uhwl8
zwI0m6(+*E5MJu|-c{zJh`5j;?Kda*|Kd5A45*n()aynqd2Y)t{VXlY(a9GGj#U5_S
z-C}RNobUr=tUg((d~GrF1>L6GpA73N6p%w;)!-d8)euHZIY71l0KN1cQR%@VKjN?u
zq5x(K*~mq*r$x!r^nkjZ532}~x8#aj6eH?66(BR>SxDC?fPK7aahxMe)*P59R@ith
z$6foz^uRKdSV$nPr62(g=t$qqvGoA%49wMjodX~@r&m%HVhi9-@iO~EFaUP~>@x_d
z1O#5`hID|u*W(!;Un%z}g6r}D$k}dwf12+@OcQx<+GrSR3t@-T+`{ApIY>axu?y{6
z{GHx_MxyILb{N~r{V(Y=JbdFBZT$R3b+mrm=h(bfO{PeyxUigx5Dc@Ca7y34BgW_5
zRpEpk4W99&29*qzd&trC9ia043EbL*G)Ucdd5II4%KK1OV7(i1iNtZ$3M{m4T?f(v
z3hmeYA0Ye+{o}t<nD(J#UTdSYck7*#@u}-iCvmv}oqGUnt{a(&DA|Oguaz5n^qOHT
zc1UILv6r+;$2kX@XVm$tCb#xV;zHsudw^2{qIMG@k=wv=0VJNv+t6e1hcs7d{nDxz
zP44uk5|#JUgj^r=UuuR}TgH;EL86gIYcJw)G5g`o0=IW9{I%}JZED3P$lP#!+F;30
zF<P0-0G1u8c`_lzJ@66e`Qh$J5pjYZ62|n$)p?6vyDOZ&YQ;BDHBUuJuU&+!>{C1}
zYe+Tt)CiSx2<cBmyKr}BMnc&F>T%DLwND(SkGtvq@amwS-wVjmWfG<60?2?0ABKq7
zbOQ3Vh&0XO@CZ*fW=MI%GuY=8PeV9fGGjGc*nQYRSv<2W#}UYU!A4Qlh`X&7Q=-A*
zlJ~1i2PM{81_$(VORnUlaq!%6p*u3`3*dL;jqfw_b%U>Q?BY*dulHCNO=9xIb~aLk
zU8FQm+^TH#K5PkZ*e1G4<L%JIwrONbXI+4^R6hLOu<^h`S-(MI<F^in>6?H>2#PcQ
zuox6~MODFHs1d@YWJKg_nwf8FQGPVs?6uG9BxktuS=fu=2Gh#|Pd-uErp}5hiskh3
ztfe3q_~uUh@EVPsDu#{Pfq`*|KN5rn+*S!=GtOpyj~QpjnhS({;&3Z8!!edMx>G8G
z4yaN{B-VZ%3>Ugy_3gp8vMx?m&w+V)7C&cu_hTj}S67Po6F*4ZcRw4_a7IUV)$$6N
ziEXh7@CD%>^}Z2(ve@v?W)lv>Ns=$aj8BOcHOA#bO{8$Ik0+lN^doxD2=8Ed#i=}a
zo#XKE7R<4sr=z)v+5uDFyFXzo6vH~!&P2SNi#cBMobQdmMbwd`R%~f$rZ72j2F&LS
za4}{LtjQb*X@6S_jfmqz1nhV-cL|l_hXd7CRRsytlQ(9&x<4Hv@9Ge@<C1x=W)w<1
z%BxJ##$E&va}F+V5qImjYnztZSqLd|7tzCVn1BIyyj{VZB(bfgJ@Yaxt>D~P-j%lg
zdc5`me&#AS(`!1MSUrDu8!~+O3IawJ%9W2U`?kyGZM~CR9izijR<8HR+D(*IX|%a0
zn42z?0|)SEDp`m$>l_N`2CyCV>^!r{<;@k|;!g`gD<x)T^Fn{T%rfv1xVw9VT`KMh
zpV17m2^*Oy9*qY|BA)ui0=Z5)jOMamKi;y7zgs1L{8{BK9QbUU%Jur!o_XZ&__k)q
zF=rJpxddNTN>FUW@CV<L5V!NO=`Su?Guka*Fi<-^rYVK#&P(VAaes6Y6eWw0unic7
z)aLzEKv~R^(Qp44T;MV?G)lSf*)7ih!-4|+rB#>dxqU;11nMnv0!0I%N%nV}_19>c
z;_P$Xip&t>KR5QOD8$FB@7m|a;`vPVBgV<PSA~b2v#1Jy4aY^9LR)mA6CH<;#AvgL
zn>mhYHi_Ml;$y36J`2f0ogCap3gYP6PcP;X!<&k{0XgAQLXysJ%#3dJa5Ut$IP<$K
zJeAYkd*bs!_X5MgWZ|fQyQ<)NUZabcc;V5FiFAiVsGJ>6Ed3PQ+JtR7j|hKS)t}xy
z|C~wwGF(X5769MtU&D0<uZ%h5xCE669QoAI&dpR=WSX5n8mpmQ)8AS8aE0gWMBdSw
zfnv2q2K%@R^cz}0?-Intd|F@HLS#{`-pKM;Y^Rynf}F`*7)>Vj@`}N3zS0GT9dv&W
zH(9Y^n8rS^HK}!{B(7CaA@DqRaQ)l!7Ryz)-`o^o;x}5fZw8Mh&ESF&Y9D}}dxKl@
zQn_2Z&x;BxBz=!5cIP%fe&2n{o-KByVclGx`k4HkbmBO%an#uS6Gf~GR7=rh@Xw&m
z2z$g}dtOi`HJn&|Gjvwl-ofq0cOprQ&nlQxysi^mxNEI6g}uKOp3&qMjtc^blm#Rs
z06UoIIfJ4w!jMbh=(qqz+84|@Vt8a>t=r7x^|Lf{kBI4%8<H6dH|0hRjkzc}mnUD-
z&SOSNkCHslaDCHng`+3@)xRu^$vuA_v=E!1b&RD|=PJW&8AHi@#<lfUK_xOY2cbY*
z414qjU><X@8$f&AbV@j5cts=3F6rtlKwMeeX<A0oqw4gk@R5<0D6M`W;)YN6OUZJc
zJGQe-m(E#zsEJTi6Mn+zrxPT@*TYJdS0@rEZRff(oKKyQ`QwFH2t&SA9z<942$IR^
z3Du;WG}Fo4kMHBHe`B{<+b@-L+I75wsd#m<?9f%@@vh>w8Prh(q<6b>9ByBhwnn+<
z$gw^bcIEonFGh5)f*6Arx!WGw#Lb$KJxD@LQ#}55o2I==`T}1r;o3zqr)EZPteHIK
zE;w|!A7~r#fz%URR;1O;3yo7cqjc<h+LaEjRL`3Bs)`qg-kQ^5IZy5f`Y1(x`9#c%
z+=lTO!znW|Lvr_)?r90c<`%{+C7QFvi+yg-PgDnitlz9CfYQ~6${cBO@bK$tYa0E8
z(oPfWz>2j#jR#eMt2(~K2GUUgV|RmLNGc^cur{UTTvNxL&9XvA@Nu5nN()<iH*8hq
za+{kau`?If*26hrb~)vOOy`A+7jvSYCQc>bKm%#^A+*y}C}yCjmgNBTe#tbsbF$6N
zU-+Y@qZrozUIM?2&k{33fK8x>;AwK~tiX+ifWsgA`6wcmq!%5oG6X@k$~$7+?<ZMA
zgp?1vcQbFZiQ=29O(){Xx3@d9Js%OJGFLS}y$)Gud$A|XJso#ghvU_(4jnn9mB!y^
zS5;HqUu*DoLVUh-2R}Ayr@wpo2S`DkyQB4qbj)LKgrsEi9y*+QUT$BzEKOaFaw<tv
zv@;=C{=<iN(rqHSARp-JBz`!$@v<{+Y`FWKb0wy=FTa%gMJ!%!5y{iNmP4|{&%#(u
z$-|A+siEj|4%P!_M;9)1s54wCSHuTiUGJ-eg{c5Yec;$)6Bq1Z6>+~yX=j*ugEi}%
ze}mwa8hA$s+um?CITrE9m~1^U+wA-YId1I{54xt{h8@I+=yNIDDLVWZQ#{p#xbp*~
zO*CrpJ4aDkO)0<DRUx-27*PVAet0cY`BtlG3DtkLvN%9kXSz<`WZ<bX-|f;k6F#jt
z!^+C4^rKlFN1t3#fA8y_G_f-|j1VG;&S>m-#m`=qnH13|sg7Ei9@7%uyxVKfoSuCB
zVn>H?!uq!@%kxB7WD&v+d#sjG`6D)M#ME-k(#=@nq5cc2B^DE|tgENv?>?bhs8%T|
zfS2G=aiv-WE!`BH2G`+k+8@q->Cv!@Ie(;nRW(~n_9*3KsxXDI!LO?k+5OfD1l{Pa
zV_(m1_J0ZQj78bpuruIW`zSmQZwDfWw$?KT$m@fpSUwGFJ6UE+=9HGX7jJLJ#98Fr
zXV|Q#7u@~|hcv24eIy$60E(RRAbM4Iv@W);E4#f<lds^sg~0ubM>MWKaiEVQo=^6{
zuLt#$<N8goX+EVq=c6v#8b%HFaoS$Kplif5keQq@gFHpXfI|R?aobhs-qXQt#jYy~
z=e%9+*u{33+?p%6%vVrOYzv|K0eu?u$UemY|Hq5?yJ@Yh3oPdj7GK6i*&6CR2dTT)
zU<E&}Adi-P?*WlT8b6tvv0~Y#9Cx{nT2L#rZd%Pqe@wg^U>>@AHt_PcGmI1HgpmoZ
zPH*8F>!At*^g{lO9cnJ##W!x8cz@hgDUd~3q1B_H$ntyURdRvnw5WyY_nW<2q8HX4
znRZYMq9YehzukLzPWK{VU{P6J5h?&z)F-J_;FWJT8e2!J4KPm37+Q64n?H~%IE2$<
zs`IcEBgUbb;*DA@4-bo#PTDPeGn*WPv5|U?RCJynw3^Q6Zl8_Iey%D_6#%$F(J`hK
z&)l{<i(o(n=EF?7C-*<6ya2y^Pxta@><B|#l~U$4HkS$bx?wL(7@lnekV)<A^4i?f
z+HqznY!JLVG;*)=sq11UlX*}9v2}{JI1BjUqILJ36UQ8Pc82BM-y1VFVStLd(^Yi$
zjJP`#7(R8#*38B;Q}2@2QoZqPh62ZB#$N@Q4LWAR-x^KiKCo#^FSU9;?YXQfxOda2
zq})vLmN>_&X6E-iamJzC9V&Ts#(z&`W&fvgw>GqefaEb@+>tFdx7Gl*S`rk<;c?m|
zlx8Rr%6ktI=id5!>O3=^@u4&E$(LKLjNSn6B!HhXcUO75MK<!yXdA7LL;GB0)>X!|
zm(UxU3lfBy@(O++XIvME8fZ(b?YA}Z$_IL`vzcJi=j&QulzUyCmdSJ1XmoR#W$l#5
zI2-~XOcj8>xKX><%mGCVBPZRa-2DOCN<UC+FOPpHP2KQ`t?-&GXcJRix2&)fCDzP@
z<<CNnkhS!Op1#W5Y{t56ihK%+jYW^lc?$Z~e2V{SKzGH=!^YimP*sqTB7^KW52O^K
zqtOSvgB7z~&W8OoVT5wOSn*tN|Gl(>M-L4fzX*kz(6f_8&Q?J{WW`xn(>hxdK0^lX
zyTELd(9|V6wPEwHP4OXp%&=<#9NKaX$kkP1o3YSbeVg9Y<+a;!vfUtU=5o~OiC3qO
zcN4I&peMe5&ZtvLo-=-qo}C0fb>i1$TZU_hw@fLI!LNkT!N!MF43^{DuAx}gsn=<j
zNUh<;EB#L2b1ckm(su=3mvISL!K*1fst090zGh&y&P<M0BLS@82o;iGhD~)(s>B<6
zM5cYx1<UiQh0J2?k4Km$tWO2dk9V9en$0kW$rUknXY*_M*3)?iAD_{%z)DPZZG=uA
zrK`^ZE09g_Zl|1)EGT`QlNL)u<xp3@3r}~Bb0!Fk)HOXfX?S$#(Ba<Kb7_;L);Ia^
z{vEsU=CPu=-pOdV?aS-e&o!|;)95mP0>;(1b;V5>6(JOf=h1k{u-NIz+YZ8YXII@K
zU%dqw!tHJ6lg(nAppuIwKr$xlHcJ3Yd>C)+fTrJ${_(W4UB{klF1(pHh?+Y}$}FV|
znss(HtA{a^`D<wom+?h6apWZQcwF{5Gbw!A@XCiu^Al1%rl=W1^ei)gBJSQImcM_x
zR~F)xBppn8{;}1&`stIvk_$?lt?({K=c!}lpjk*LZ))&%OMj84iQW{qO_-x8ld+|o
z#9UjI=GbG9GL}80*^*_@6UhmOSd^!5R1kZs<S(r@;JQPtVPcG@r{laiW`_c=cAW=a
z%px;W$#_Sl8~(+P`-ITuz9LFtn8LKeB#(hblm?#$e`f82>VN9Mm3Pq71VFlH9tF+b
zvVCT}?3H@?c1+ho%1cD9s$LHJ-UIS5mp>kI+(AWVXd4|qCDdP-YO*muAhw?Lb;Fjm
zxt$}3F{qmlM2WFFG~5WpI*wtZYTe&_uPz;{Ugk3FRo%2Y7Rv{zuGH1x`v?+w&7Qnw
zu!*ks^AR4b^(cs57|f~~u#R*y21(ciE8Y5DF+W~~(XFKmyvng<@b{PyV!m*RrUbP0
zb+vD`1ed^$E%6TEoUr{3<DN$=_vW5WuQ3&0)^TyKMw7>9Ir7Q(xMFL0q)s@MXxOuM
z2rg8lT)&YTV=oqDM*sXSbGy=3#V(YWu#R@!8W-o>=+m^J2ybXB>G0o->rpr)@HLxf
zMBVvt&vZsLLL#Z&J1t0l^R8R$s&kOQvMav#>Yn<c*_fCukwA8c8tFk_tuuby?dbP?
zT!gEvg6X(kw0^LEWEIj|##Q*1P}8=qdwh3ArX&{}JF^%~6$MAEZDpKj6lLLYH5Qxh
zU{-wKbyVo+sJ+#d$Drx7Edh3&7%dM+M|49rpTjEvzSrxvNoLYZaG^7&l+zLPmjr<)
z1Ugdi5-GI#V_8ZSN1|%PS6h8o!M3R*p*+f$+W^O;2kw1;5a8U_x=*}Y_Fmh^`u*q)
z<hzb1lu<;&{Dem3wlI}Ed#HBNoa7zl7QjJXoH2;Y1)?JJ6OK90p1kGL^63LhF<D=n
zFs+lE1veGBwHcba_Jq1U>@UkuSh%05_XTTT9no^lmLu*~>(%W!&jO4L*;Ar`n1&3a
z@xZfeE6OW^^2G8Zgw@Y|5#@iL_o)L4D4?mU0G+fak_%`!ml^WDBPZ5$5G{#5+m?AI
zR;PpSm{$phf{T5^`02Ip3EIT?hJZ69C0<N+QSIf6QOdVx39S58Be{16tyr&4NVoGp
zM9m_@$ENc9v*0z2@{dj7@l9W>bxIG*?H;Qpz;i@5>4q8D7ctCz+Td2fE8ogu>1Sjy
zC}-REYIChAC$xm4+7!GTIgCO|--9+3vcRY_q?U!`!{IY*Le14v6-AxO*qzwqmcp4Y
zw{m}g%+KC9lH(`6!J%9;{Dx{UED5+kBWg3TM*81s`NUD3-tSHX!g!?0eU6(9dRfzR
zi=fu6^S-&L$T)DyVSuE}NVzwzHu*=r`!%oK{+7pz;m~6x2%wm%R-AK5x5#nBi4FL1
zWg*?ZyofV#`<mGa=5un>?^j3(aaWZc=yQl4Kf}NyfOq4R=q%SFEim_4tmjJNEjv$;
z6ydd3(f;OoDD6mky&$-ZIN$YU@-Fa}kg+OMn}5<`t>13Y&4jj;j@sh=-`Z_TbRI%>
z#O<eGH#`6a?%~0~Jpj!+a$_d^fDXA~hXe8>beRgMm&vGuI?@e2U<2F|0H{?X=?6%>
z!UyuO0=aYeXCbV;;P$pB!kdW3!{U|XXS*a#hf1*}qvLxtn@ogcEU{YhOPuk11pg7r
zi9jX48Cdgy8GfoWo~(f_6@x*s6w{V|D@wWmW^<O<#ib%USOy7C%{({AM?02*vFxms
z$emw6iqV$uKbj1zyE>UUxKbU4a{OSbY3&b5XQ-U063xgt-hO(ULkISGuuR~*pE9c+
zfc+=ArFza4(k!_-561CkPl9W=y8U#SzF>);kt?47zNWe#pb;bMX$TOobtacL0lG6Z
z8TdM;^aY@#_Xo(@KdF2Cr2IYsfXN?y@0OaX0h6!O0C%Dn$OQdz6QFV8FymzkQ#rFd
zR?3yO9*Zn1w4Pi5pn7{XrdP>lknm@p2@m<=D%*TPTWLVB0QzI_z>oF?sM=jjr2)Lt
z_gBwW4vGt5KEdQzJjy;F_DTdZF}*K<I0^zC1)1Nm5H~f=w}6=H7UBinGHlcoMcn{c
z>{6)?f12ZtbIwhPRgU{MN%bIutFlFM3xnvQ;+d4uE2j57ZRmUy9@GOr4|LPc{{iZe
zr1~IR<5!DxXg<i<PMU0L4m@0gboiB9k%K(Z$<%*_<#bhff?e2sWgg+{2H};mxjRAM
zRoVaaa~eB_c>rM_mNfqZ#OpT3RAeg>`BXtRUrAmt`_WkKW%2&eNZpB|nol>A-*yv2
zgLIp%o~wJP@&at0|LO9zDXQD=%Er#7dL03Z9Hv1R4(a@Tc``^_C*&p&3lM~n3XAxf
zeI+BdI{n?6#zHaqc|eDwN3OP-_+*cmoQT^W+gsI&prv3_koTV#2>o0J-2+w{FG=nX
z_@?Xt{8$##pJvUbi0c0UWx~k7zQ)QE=!fEePC@F44qzt@l^p=Gz&sUukUO_WbKAdj
zd3AFBXAq)Ep<%h7V-`s)43I*819VE#4wh=+9}jGm2CyL@ggbD7+Ge>9j==Vy&OmSW
z-rvT<fCg|7EcMUw{l*03xBoKDZ^Qqe%sQwD1|f|8ChA0VIz!bM?oqipL0FKLe!yr9
z=^$9PfMs4_A@1J(ySQ)G0?nDl)I8m6B}2WsJh7dy3NwN6!)DJ%xCP7HXdLmalKZEy
z8v(;VK+))|TFu8$yb95$=YRpabqjriatp|lh{NKIsSkm$4iNSbAt1>BGs3UqebzQ8
zw~7E&c7rLlY~*Q&M37Xg!CdkS{zu1~3n?D0?lHRshFA_ICjaTZTBL2!4fiZFQJIQ+
zYo0L@@`rU<!+3b~supuW2%y^TA0If{0b3g0pmPk@lDixrUh4d6<dWFiTlCV8L5>Ee
z5`B*jmmK8$6b9I@!l2hrr6-vgl*G}R8mC-NEIRvFk9w3QD@p&{HW;8K7GO+vEX3Jc
z=35jET6|)l3L+hVms_I!3j7pmMa!LwXr>3%BWoj9Cc^6Lw+n#jX#hO)?=s6#ghi3S
z4WAYjXn>IR9;$<_0_B@3f`A^hCxz2OC8?+~z@J?DZTx)|%<<h<CzvXm4@X-jed*tN
zFF0dIFJ5-|akf&)(|Z%oMK^?6q2;(%0cVqx#l{jdvY)o0ib1tm%j0=PpTs-pl<l!o
zfF>RS*f)M%5+MJ-EYb8J1t?G}K*ew+ktJIViR0w3sgp|5sz+{mo;b$uB1}kl!UDpF
z-J<74m(g1NFVN%H$%aU7<Pu=2I)H{T5+6o@KJ1_JO>+sUp@?>y?jefj$8L5oW6+A|
z8uk<F_68(W9t3C7;sNvk&<ajriGC4BHiU9x|2_jy!TjeTrUj6$V*OUgF{N|U0_Vzl
zxSc*Or#L<4)!$UKR<u@2@oKXLI38Mg*H?#UkSAdRT9#yIM?Wvs!zL00`H%O4szQPv
zU*#cKsAmw7GbstSoEf?Bvx<twhfiE^b3J~_@6yLZb$-+91iCDQ<3O#38@`i=P*{4>
ziPJCmO|eS<!iEsf2vc&aaZ;vgtLV^E0G(OlEiTA+@b!Ab(fTGw#@YLjoXxW@HT`fx
zl@C+i3>yeh@SA`RD%8@EET`7STHTHiGS`tWu#d_WYd@vT$sJ}Y^3UE$_-^SwV-iFT
zpDyp2r1c(HouZqD{wkZmLH#eQKeP|OgH1x?rI<uG$S;j-57ZXAzk}P)Lc+Er!A{Yh
z_~^q4vTZ>^X$rh<3D+@0Zd*vqlo?wyL80{m{To0Stx3_p2<M;2-@j`MHJd^s06*4(
zeV>n_7|O=~?P>xy<a!lH-cNG|;YT)pBDVm1RH-zbF@SFfpnm*i?73Z@{K3DvQS|Mo
zWKBi(@g-$Z4Zt=8s)%FANRqX7ncq0>$ll|&*sh)L)-lhS=pt8~hN+^^80gkT<lF)J
z2Z#%HooZOgRDUh2he`x4R)=NPjx<oK3Pv`TkO4gHPrv-j*mD;=(v#~0bU~1WgPXV{
zt(E(yCjPixZJPJ$Q~1N?5BB3;8or>taT*7z74moem;LJy?Gim(5sY@3yXGRV?<D@L
zqQv1=q7Ogbz=ZYv+-A2wosv=U(lKX`rJWLZ6m!uwmv+Af%eiAojlr57^gMGhi~PDw
zt+?Or;qUj-AMNETc9wE;t9QKRdCi<vbW%N!@X@rAzkTKrOES|8Cc|kr6~nQCkLOD#
z47Kr`W~V<nFxd0kWlAB}F(nb#4U_tTn0+s47zW6mD$obu*Aw}VCzR0>@ibkLVsUA0
z=YpGL#X%<5<Ih_2G36~H;-ydAVHYZZ^A$uW9b}y*yUk|YW%IaB(sJv!iMxQ$?Ci2L
z&UWXGZF)SK(jml_`8M$EUy0Q64-hxJvA=;PFrak9gJJk>BNJ+MrxWADsZw(iBc13=
z*D+JOIGx(&e{$9?)<56TOM1D)@pGX^lN3ACOP1@!m-$Zf6PdHX=YRX9mDegDGTPnS
z!x|jwt>akI1(-QDjMbM7GbW)vOfR5m&{v7g^@!`FZ2NVjJ#r~TRgnI-%lx0a7iIH;
zlH_e7s@}H=j%>*k3TwLehY{RMOXyPNm$i-F;6w$`^eoexEHIGU_mA&W9~55@KnIwO
zNidBbDD@(J*iMHEkO2kT#4@X8VLDlQ@vJm!>*MDU4Grhgxf>XcJyx6ERE0?X<sr(4
z*4pFOd6&Fs=ZJMHxaA7lX8lW_!=!4|C$1Gd{-Pl?;cfx`PhF}(AfXLVd@|!kb#+8^
z>QVRv;89%d00QWl?=XFUn}=2+7d-|Cda9xJ0E?Inm_{GqI~_?OzvzuWkH4>hKl|yM
zj^5M40NylE`3zJHf~lf9F_6FCYK>oqFh}DF$LchhG}i%nr|_c>5^O;GCvpbYKeIOm
zszCmkpS!oC;{+ljX&ia2;6GpIKM&EBDjfukQRVmaz=x0xQQXi!Tc$q`G1C;0GKkGi
z78uwYyeR_6-Tag9^Xr(RGWQb5W7gT*+k}!@x*QIY#{T1)S4#gTogVJ?fOKj*mwf#x
zoi(jSi6aVv$-6qE$^~CaHI5-}kY4yp9b^D3ynv|zJmi1u3yoj_$7K%15pdodF3~sC
zb}O7<TAqzvU9J?_PYm6&v7yB12>W@c3X1;KOi)OD!8+uwEG)_hInGr9f%`nft+8d(
zl;;g7A2MqE()uBv<r^{kP}&{yAE1q!Ad9~c^_5iW75PT&K5)b4T6%zLgnIz{Yb+5>
z3;Y4vlLFqy9jEBLfAu{9-TP-(^aC43n0oQ1#J;M*y+rM<b`Y2XFPuAgsluYkk=yK5
zPT-)pR=E2~nY;{k=b@<cPoE3|vYEd9)lJc&@$lhc2f!uVcnCO~i5CD^Tb*nK@TViG
zFM))uxhN2jJ^T;%eNd8Y;}(kCVgkM*8b!O6{ri-M)~TY97}%eM{m;YuSbPG81JDA1
zV4s&j?wyVQb-pZC?5`fdZw>;WE`D1w^tTBEB><fM7eo9X)c(Kr;cpI$=kNP)k#FZF
z*-#z&>3<4HJZfH*>#v?aUx5?3K{og|A*uulbzck}B+>*-X_PykQ@(i4+lH-pda7il
z%FzApKK^cT`nSNxscK}={DucJvA1WNG3=G@Jef<cBxN?*j<o933H#GAB~Y&};jGTh
zJ$c)~7p?&cR$vf(#tS0L8JEQ>8e_l7QoyT}1L&7cp-nv(pZvN2n=c1_V215&^amPy
zG{GL<nvj3vaC16=o3DXV(q2beUWO@C|8T`|QVplD4}O69Y|wBr-({U=nGoQz1MR+F
zbgBxb%NTL)dJRcSjIQnOX+8J$u@-Niw(=e9`8&oSyO4SAB_tw%)#U(3fDF-DCjCRi
zBj5YOs3Vatof1KKW69dyaLRsS`u=m+_(XHb`0dZlvzOX$Toi0}S3L<-QvMyg_|H*>
z{|!LJUruqP{J6PON&?RKZ;$R#dPPm9kdOg`KYu>*mxp)qG5|i6(uw@vfGER&%$y7m
zCYMvp)9X>}a}-%BAA(Z*2hDI!Gilc&%W&dNYS?T((3s#$|BeMQv)B}Q>gGY-Q>oNR
zF_or>MfxmyViveW7APSxgBNI`)JW%FapvY(xSkmA`84}n=&;3?yX@Tb+Z+XgvB;y&
zM-A~mxpOap=mSAaS?FlwZyMuw6$CEB{yX5)`zOc?a}khrjb9XIfe+;pLa_f0Mg2`)
zo9l5~?TyLq=&J5hw#8D3cR_0o^lRXM7m`^RCskm!$eAKaJ6^{}(dyWw;<jEs7_I3X
zr+o_Z2<d+(+Q7AQpRBYSpLZU`XVDt0{>-A==Du}cOF-{)76$shB4m>g0<dUV|0j(R
zjM$C?iu;xT7cYqmN=?xC&AjO{{^O@^{_l&1{5GK~7xFhu<#&t)fX9Bbpuf-gf5IyN
zYa{**Df{rRjri9_{OYj&H;{;Kx6zaMdkVC+pRQ><?HV#ep2h>l8~vNVJNq*Pbr|&z
zol_Gi@vSTpgd#vguMu{`*WT<sJL{d+cL#a&W4nnl1Tou(c}6xONo=;J`FEpcMDM*L
zM{7P1AXFc;_DrUTZGJjXXqXkYdJfK@-o!&ARZjM<$sQn^V74F2Mi(@9#=Xbu8YREP
ze0}njiGHgn9^?eEBZs~jU7g%Pmr_StC!b3#$9Y)JlfD2?E*2$Kz#~WL99)dTJOG;P
zz9HAN2||dwk>Ua4c@_ugu4uoun$Bm{)ZXL=VY+bTPXORL`){><XjZ^XIg$Y{`+5aU
z#}Y|ef#TBw7?IzK00lmbqWT6Z_x~H$MXe-_CvV#5;0SI{8F<*Xz5o3WLAyW&%g?ew
zB9?523W9BkBImY&r-LBi_y6*T^pi?|qs?$`1m29l{8;?2f0zY+3anCpK-^{9j5R}2
zFI2)+@+{mgO07yb?&hVHdg6^kYJ$l#0HWIkJ%n8{1P=3i4^3HvDy>tG-siw>_yUov
zcwMH?j-~+_Z<fo)RN`F)GGbpipSs-q#yU=h+rZ!_L%u0c<M{u9efXzWSqAtHTgX$+
zuu&K>b{REhse@Xe(XM(u+SmbDbA%Lr#*%LQb|(MfFgMUZ-0=eP8{pq3l><dR1`uK>
zRTp^PTLYmDR{$3Hunqh5wEn{}cgz#zo2#<ncEtCI3Ur2swdH4mrh{3Zustb<(93Fz
z>L;1@(RdxpeV^r&Of(KjeQkNEaQ-G;q!_)RZ_GA23;P$saS14+kp!Z~tdKoLHy{Ra
z4~U(?TEP39&<!sjiX4Ro9vc5xwv`G1rllyzmKbu5fCWOU8bGluP{?Eq2+}x`cB#(j
zzr0KL1~B~aA0U%Y>30SZ5P`|uMndAnM}$}0o(+rzKoIUPK8cmM+X&%=>kY2f%1=AU
zEZMkrf1EUvSlG6%5k7E6{<>OA;E{B+pD0QTb)#n10<Wn7WRnaP@V?%d0cV7UlD9!V
zM!$Yh{BMWqi~jYl09*L$jCAv`-_IQilpMbS^hF!(?l=I=8LVLc;`$~3tc1Ej3yr5{
z0P*V?KymzXY(^gdSnt<$Lw=o6RS-DIUye5Wzr{|>E8Qe&z(_6$T{Ai$Gp7@cHF}zl
zT%$iMD&7Ekt$W1GU;q^7FC<X^CfQ^b#%{tUuS&dg&Hw$m+DeI{ds>1yfj%Mwo2Izm
zcmFSM-QP;W|8ze0f8G6pLF8Y^;D5(!^<P&$ty?`|Q%b#J5Bp`@4&QiS&%Q3f>X&Z(
zR=fGrScEFiL(TfR*Moo>`&G&PAGr_R)$8>ZM$N-*dczojG0Vy4bSYZtuB)f49$AfE
z<v+SpoPC$<F?(?Ki@4%#;!`iLk4J@dC&%7i*fBVLWJmHZl<t4S<2N^~A#xdzWJv>M
z>)~Fh6*eH-#D#G`MsB{Ba(9{Nl?#^8fALXmPuIg$pnYO*`%BSG8ureh#+z)DAI`?x
z>VXQd|GFXnYv%dCp``pjx4-{&Me(m~`032k|7#omwGDrN+Wku!{`SKC*EalX8~z>d
zp#L#+aGzrF7{*#G2S0fSrla@+q@nD5fS#(vh8qdOLY{8*=*a&7sn>yg&;%d64lf*s
z4-G|!Y_*b3@miKWc)zmGd)IZ`q^~HNFZvjjzBbu4FKjgC#P!#Zpn%f{8M5ol@L@wT
zAO1U%#VOH@S(b3x1W4?)G}U(FpVBiQ195P>J!ewA@kIVar686BzE94ue`jh=7605<
zCc3mnS6wlfmo_L|J~Dc&^XL;oYQTis^%`&Q7I=7204JHYJ7W}sk)~dczSHZ8I<fT0
z!E4O!l}xIX#?hOo?&>P|+bds<Lm92<bm@{t=o?fRfg<5LV$+TT*><K1A^I*pd<ZpK
zZP29SExA*>?DIrCcH;P1ZavwA)&Xyc6?sHp)IMbv)w~{sVkfwj0q;oEk#UDH&!mZ<
zBAgD}<Z7>|V#A@cm(GlV3?=41&8zaLD7q8rTN7ztEIG-iD#qZ$Pv!ee9ls{|CxnJ>
zd0%lsihNc0<BSJ)r}b6-K^*}E8#$?nYC>v@l4-A1ELgTw=r4LocJoZmG@Cqp!F7x!
zv5zq(CsI@@^^ozC#RU=2bFl6()=}FM2=OA1=rk2^vZ6Stupo)2;}+NLw6w0C=yj8r
zuY?cO6f!q>WifVepRG-A61+mv2t_)@L*Ny&jCHXw7(uePtEY!VvT%}Fr=zo<yY!vt
zE7{quM~}LgF+SlBzEp&*2gsp(?Sp7+D`V12pWwUGs~*NT7%EP7yj$TsIWGRXA@`VA
zf~K&0HoCpREMK`g_T+R$b36w^ofIFda%FN^{K2da3$jsOHYKrttxO|DZwW2qydar+
zM#XVVE0N)Ws_>yy;2r7WZ*NWl2c0J!CpI~tju-0zi43;~RfdZk^(LD8fuu_@S1Y`i
zR+;`6FVNchR7GoiH0&5vZ8qKQ*%)WMJ3gKsrt@~P^Mi#B+t3@ND{tL^*VO$-&kM~O
znVw&^`$<B9WeMO#7?C|7;kA7EWVeRu@>lrTqbxHVR~quQ?A<~&<lgp%kCoG<Q115O
z<TT%Jp~9d77(sYJn=h<MtBa9(Zg%qFqPe_jWF^Jxm1n>QiAFVkJB0?@$zxYeGp*Y^
zR#oQOIbAtQxj>bNX<r4RM9ZQp=rW^jSV>QiC;AzRvGyVn;KS$Ky_OQ{WR<C<?j7{9
zz2}AFaqgJQD{t#ign%u&e*X{gWk%9FSYMUlbyWfRvG)`M52*8Q_W!&86LW<eE>BRi
zC7o!xNsNyy$zGwk0coNS`>`H7@Z;l=PY6|=?6=w~Tl{tY=hFCiT~f=3?lrxiIQWeB
zsI~}J9u<yHhI4a6Lfuh6RS4Jrr9xbPst{zjH=sgF|E@wF!K1#@M6t{e9Rm2^gy=Vw
zVN3ZLzC!Y1qrI{UfNs6L>5X&V%>s*(yn`@&aPO9}iZ&$w-Cgym_UjL7Hgd~?I1DtB
zc(kXitperwOUe)5YWqSv{B2tcJX$dm9wi}uH{%^SBd5BbaE*D|u--~h)aKIuGp08@
zt13{k{VZ2J!a8r%(GtSj7E+oL<^D+WbcI>fr_@dFc687#Q)j<0|LbA14_c&<HW(Yi
z2rrHVSWb_AHqN>BRM%4N?3d97o#dS?1A3m*x`!FjO+fV3`3LB;l5gx<ypt@SGP~c%
z+R!PpAld5LC`3KIM+I9_`%E2f$DJgXJp&2O<Q&*GF?B|rHRhR^f93ivkwJJ@QP*Q&
z`0KTR5Q_Q=gv~Voh%h!P+GZ_Jsg|I0(>5-e*Xwj2`eRMa>M>ji;0W_~pN6rIkim_-
zM$euuAARolJYu(kaU`*O&TFFiwO1F&7d7_18|WnELOh&;$wUIYcT*Ht-D4D+gc6ov
zxg#^v`zICNx>8Rm;y&?C0Co(vuMN9(5aDaoSuKV^wn`p)=K-Mq2j^sWprcFl3)nGe
zy>D9_jTv6jBnXM=d_Q3(_OTV~YgnEvvN1eR8Sfy_fnH3xH6`MZs~7hyOz*OqfErUB
z(g0_VZi9?rTWCx~qc(9r4N_iXtfaZ7-q=d(mbPb}_O;GKKJii&o+hNL2~Sj&tdgQY
zn{FfW^<#?>0kRD<oyO*l0elseey=`yaaBc5#{tD6@O25Mw@I*a*h9hOIppUR|B`99
zu(ELCHYyBqUvmx9Voev!5xa;yLu`2!T`%--RnuirY4{t|K8xLX^+q2?pKRtCf5<U}
zR)Yli0ZRjVV2p^%)onqgy{J7P+bTOVP+@(nnABDeJryyMfA*^l|6{k)4F1g1!;8q~
zs=3r@u7<&cPFG&?++q+s5M2LQxnTQ7^S)r{toV`dO_t}%xvE{4?#Z0Xkaw~AzIn!w
z+m_*&#%&TZ0s?4)TKnlqkw#uK%{MK0pzdRtaNIEkTKduFM&YxPFe{e5pq_xNKm?Kk
zg`<p!$j0?3%hTUvPrh3*#EulXosPAYJd^hL>`49M*X|yd1x(Mtn((KCH!6_th99G~
zwVJDyx2`o`Y+EDDm^_qFOirCU>Qhf&=8h~uHbPG#gfS#rR3sug+EsNV-30I2aUrnV
zIQgorXq|6d9ZRe8_){Fi@{py<pvqYbi!T3sSc5>$A#<0~@;jVyr<pX|t0EVnajMFx
z1kZYM*sOOP^(=0Zg8a^06kkRe<|sA?>JPaQ2e@+Drz4<kT$xck)sB?fyncl2rHBg?
z6wnSJL`PPf=sFZA_qjgTRPQcaKOrt$$s6Xpi#|>6!1qJ|+~-?fNU+lFDM(F3$*qEy
zv~SFOMm=g6<x1#Nk4y)8yr|olPBYhIcsdYW;g?B|KQ-zc>lE+sh&^Km`nkRDfl!=M
zu<;wEd_~a1`XP2SQRD6q)qZ;1E!;a18eZ#*7Jred%2V_Q!@&oIL&Vl&EbZU>mAe<C
z5S}EarW0*hR0PqrB622vK6rtolpf5L6}1n>)Q#{b;W+x?F#UtK7*W$PM+|+a(n-9T
zH6_U=taXsfYsOIRm9221*`xc3n)K%bRo2Njh$w)pf2-!Dl9Z#8{I#%_nzRMCE1I-!
zbM@wnQt!`<2I^jQkr#@GQ4D<Ao=p#xBH2flGtUm*Ez37+D|aqA(QNCI$lfw-Wo4h=
zsv|sn15mr5uf*}G3An@*+qK12Z#Jw;4MV#7MUnYO?CLiW!^91@vEbdAbF}E0^^?{b
zeM)F4T1#F4g>Xy}ef+_&b145w)PuBrzQ*FAG`6A|x!Z1pl~w0AfKmWGr0Q4o1a3<K
z#eB%ECq{!m?-g)vltMC}9uJVk58YP~U6(BR#?%AhmOvM}lxAEoFHg-`*@f9-v1*%U
z&8m$dR26$6pK0sNvQ5c02(tjVc}zVd%j8tQ;E?R+xMOBr2`|HyY-(e?<~DAP6JY-E
z?hE>jV+p9+{_aO_2DI?HIYu8lG`sTT)*M|zJDP{+4Tvk*SyS8Vd}$R)<y%TGuJ-e|
z<Ir5<!-#x4@sMCOkk@)8eNO-wq1dM+U8L#w;e9pfgqcjm-DljTrS75H)Oh6$O`*3T
zaSCpl<QqQkSLD*_o>jONIQrW5hBfJ?Dy|7FJ{CUs0TLr&-}IE3my)$-icCd5lI#kc
zt#iIEXs$kmn{rfnDOk(&P+EHsb0}ROv}=E<v%vXQHhJwJ@gmm&VfU=Y4{?owP$g@k
zcPLPT1RkTz*oV?CI?7E60iljMzUyWEPix32Gwl}6pL#spy{w*}ax7O*5Pg38{oZ3u
z*+E)ss!{pAMl(7zNe7^7Ar7~iW=7_ecK6l#8XFgjXI+sJn^JwzS|!5#;o6aPB}XE9
z1|6az=LF-YF^?>pu3|*{ic0IeH3r>m`wcZ+1iCU-<)zFf5$%b!Pt<z@JAw=O6bM**
zSO{-kBZO(Cm;8aorr#1EIpjvYSv)aTAYS0a8*+#=9=_Ksr5<_WQNtPUW74G{fDjm)
zL`0jV_OIgh^*QVhimPE`=b@t0ixH6iRn)!#hfm(v!4iESxf7^EjPlivHeLZ|JCDiW
z9QxO@yB{W1zdq(w&UE9ss!A5sKA$R1l5B*WT*mTZ#K_g-_fb04n@ULwI_^)~b8_5$
z0@<1~D-TI+dh}tohif(M@slThfGn{HGskb5?jq18-ju7mGgzn+z!KuUlSWccp49<6
zTRsYU!eDgyu4<Bo4XA@FMGA|&@4kzT2I(Fa3Ep0h!IeT<osm2ayFED)iF+pf=cgJc
zP}^!cCuBl`^VYYO*r7U4*-okw>k7*QARj|?qI@hJIT?-@Xr1YlqOTGmE?q^31YB{L
zQX-4Ih5PA}wV)$Z={L`ZrJAb}){Lh+y?=m|@3nRI9Pz&*wWZO3iWx(;VA(Kvr`YV@
zn{dQ!2;LTpVPWK}E@$DHd#aK{zl1CsrpJ%Rz`wV29jt#0c%C)_Ts?PFj#ee>8SkDc
z3fJ=SEU*Q|AV4}`a2-3l8)Y`U3f;fS7*GZHPgr@V11uPFvet|QGa_k(ZF#(3-j5oW
zc_REt;;131`OBBJ9R4@TQo+hg^fONT(3$gZd{HICjmmNgb6O^Mt2h4Oj+pG*owKui
zR=m)le8qiW7z(^$@FX-XG!nUf07M7*(eGt-Mr)dB7s(f=*TLo%8hP;Wri%eTKz7f=
zqjbu<?MC{}6AH5=g&ubUt)}RgbVem+?dxIelG#%~K+EQ3TkN^#2wg9pFAqblD_vYu
zt&$!w|4lh*%v!P#S(~aCgD|I-rg%ughlX`aos)#sQnWF)&2iW(ochUDaOLkKG{EJB
zh#{2Hce3ipk;u2?n&y$-t$5L|$WM+q4CN2@@6E=ZV|WdQ#SuG9EIH2uMYm#2s{}ml
zxgs=Rffz|D-&GC|gdrE>X>qqf6v<Uf+~OuWkS68ej&MKts3c2KAUA3X6VHd>FCt*?
z9V3M_*o&U-;vQ6lEuA@h>%r-c5=E0rD-HUs@YNa29r8R;Wae-QNxl(R%2ZFd+oVIn
zg^7#w6^qM0xX@qbe;yCCQOUe@L+hl5$og4NL%R5{%vnIw&VU|(=nmb4f|xjG9wEMq
z#K&{g753Iw`)b(Al(!wypZi1iR(8y%8zFIO=rd$+A-td&#Zs%|Pc&-s<qXXqCwE$w
z`S~rc(b^;v{Lbn;{+ekMY+`))(&2i|*2AK2iEV)Gi^s?u<S2=g+GbLsv*1Q|iSMG{
zFKgQ8IaToHwlt>__<Ww#Wqdv>(VZT-P)Ug&ZQDs8VprE^aG_XM*@Kf>BxtmfQNhX;
zT;1S+=;7E86P=2MC(jke3*hxWt!=#07yHr@oCZprMz_IYu*azGvjkDI-lwcs7V?QH
zhjYU+j>S`BvnCOTov*Sr=B1snnDThvSU$+GP@C4aQ%~MfIS%LB2^kC!Sk{`xo|tmn
zN0eWNwU2c*r*7=ADu1}lxeQ4U{Ub$tO~p<sq-_v;7$bmqNYn|*ChO<JwHgJvh+e2%
zZF?ITZA;qD^xdW-Hd?VNBbT3i-Do$jvVJY~P$Ru!HJijt>%bljU|_qU^^<e5!8b0{
z#}Aqg9hr;QsxymxCONkk^EHH-SC(P>w1+Am4jdqku!IV7O`}^S!46|KV{PHNB+hh+
zcyHz51b!~5@eaqQ{TkdpOfUJq#$4h*M%S(Jax9<^%SSaM_E;Qb(*(&k{-`6vvgO_=
zaSj`$9{=u}nV#EDnwV_VlXhcKxgX1am;0lov5ozTxc>BR#5&f=f@$`tkz9ycAN8XD
z8!dVzl(TbsLHncQgNL}kJ`g&cblPS1h=$NYEI=fBkV9o6A}tP50t7AKj#N6JzSz-Z
zd4HSGGPaWTDCt9|aMJZ17W$j+O4l7ZFEW003efvf*#dGy+&;*2bCvB0;{`WG%4lC1
zp9x4fUuIoMe&<;9bSK_Mk}c;Uq|WowS3bvt>p`sxR-&ughx#pCS#{h_o%`&3cuELf
zerMfDLM~qBdLN^Q;3`3kuJwvEObH;hlbm%3;3NA@ql0Qs;voWLKFwa&QgjLY!`i}_
zLvCq=+R^DI$0x;{msv#T+xgBJ+Z<nol<YPVVAHz|ZcJ3E;q4UC;WzkkW`bRv>qx?j
zq%!#vQ|4By@k*-(-Pd#(C+&J@mwMQbB6}8TQG(mku+l;pq?8RpI}!hkcQ}cyV*fj|
z#6-@!R4Q-%(PwoQuW3KQ!EM8WJQ>WnZ^df$Ap{e_nr!-^>iCi<5D5}m&D5-|*mN1)
z+y$e+j9tgaSBYkX=J+`AjvFs7_V*8@ZK9-Cfm8@3S4iHD8!gFb2xZR!R3=L%kfPf(
zUt3e8e}FV^g1m6fXu)tTZKIh-MLv(Oh$G@9$Ne#UZv-<oEpTH8-=k~lXbq%G&g}Bz
zQ}*2otvCtgf;Qo~%z9nv)FBt9W@v;jHbho_GzVzmxcQ(ppm*mbL&4@n4ehu<Vw?BJ
znS3+H3M`oF_KqynWTaw{QnBd6`cZx~pbPw(+HR7w$<t%V=VzbmD;ZVG#1*ynV0cSg
zgCeaL?w#a0_iAVDNGzqoQ$Ja+Hg1o980<c+bCN89N5JfX+ymDYYp9dT9j_^*;C%$A
zt#%Zyv354|uEX)g9aCIedJiu)1fYey8M}Fq(oUFUd4YJz(=FBHM=`3R8rM`+ej_0G
z-nHvdT8vn&asxKZK2Ca^SLQrje{j>=S1{ML$gy{2r?c#l#{{af#V=@i*<8JhxHjH0
zCGBe8^34pl%<1)zmCtUXSxaaw%}5W#bmT*&NT5d)Xd!^hyyqR<qZta8Ws>y9E7(<B
z$N8+z>z^w@eMnRe<Y;z4Zk(s`1I#~LK-rqKQBD)FT#}vKDDKv9d2D&ib^h6o_s*!z
zMB75xeceLV!}!nYT<?4hT;=hYD*G%r)9n;LYst`JL+7_VJJk`BQpZOVpERvAW`SM)
z$;QL<FGya|&V@_Ea;eNbw(9x`nQz}y73yA-MKrZSQp1F}pp%hNlC*1#+Oy&h#9W{y
zMcow2v>tbxC0xuOw7pGr!X)!L`nqB=V-pTBiVW;RBeU#7;Die5eUg^%K{y~+DRt@7
zU2UmEv?@%e47q$Kc}7JF$Td2NxI2Y?2qfHlqV>qy?(@_u-%<hi2<Uo!Au&imBjS-f
ze7#Zp09Qf#7_|j1GfHqy<sqepL7?6QY~l49WEtffQ!|c*%7=FwgU%SWKqG+Sx~(OI
zK2s?5o<H98q}ISGb7NyON2h4ve3!kL&d2LjlLH^?K|w9PI?d^5rhs-R>o$xV0U_Gv
zu)SZYcJWvq8h;aIU!AG=&^rF{AO1xfL1mh)EA!x{_!tNaMwndCieiL*_QbK1r<R;d
zQ^G$?Xg%E7Ptg55VLH)r>U-qJqfyHPY<Xp7K*6g{ES5WfX9B=*0B#80yYI%jll)y7
zU+?NQaTLW4c%LY&05dzDvkHGSa?c}B$1sZx%uoA<JE6kkNaOof>t~NIg0!k!8z|21
z=X6!S-}m(3THoaPG&4%R-j$73GrN)C!kBiBaM^yuX)<L-GKyC+PR8$ojJ8Ir;E_tR
zd*@MzK8FgNW1x<+jQ5emYeI(%Z;q|T#9Yy#mz>2lYMafdWKRR$4_tF=mn0ulTx?fX
zJ~(s5aX4kSH=?*`@knt;m4S)yk#Qci@rfsv;$&MAbVj7XjTg?gg=Qzy8w_WcYpG@T
z$b9>9=7px1cVbal3B#-V&DTYb#Z6>Bqc0@;kk;EwD_Xv<hXjZNR?1Cx0CGLmq@?!S
zqjzaj^1)9l{LFHma~XY&Y6!bhwdc_veehc4GQu*oVG2sZwK@~z)|)IjfzE~tJ&*cj
zS4Hl;Oo=@9R^2r_mj8^%*Q*wj+V*fRykrYtXe7e|E}Aa|ocgx)-9qrYT1{W6qe!Hy
z>s-pkKKPv6N=X%b=jB&-26F@<QA3Nkj%SMAVg*M+S(QxF{MQ3(9leXD)O_6BFRh%B
zEkBqqEhm6e<U~6tgD)3ZH=cL}dQ8zDeA>?NXjWlJZ`NpHdy7!7($X>$5WP>aEX&pM
zIH~Qtv-GJfBy?0_Q0L+ZeGPUB=Y$SbIYE^nqlpVpFkD`rhzs#_m2PU~KG}T9HbgI_
z8+Rnm^=3A>%!OWjCnFc*k_3AQ_`88B#{VoJ36S^rx!Uqyi|rYg;8M&T5t>ZAwPzF*
z6a>`80&kSRy>Af`m7~)ZQvOQo2mIT(gW}qF{A63|G(lOqzYEYdXp4%UubF3Lo$S`M
z2ZOdenTzYFU7mrbSC<LqTp`pm@2C&^HKJ?Hm9|hcWdhBXqB7)wT8zxbVLSD|kiPj2
z=fZXFMXL_je{)kY4uGB8U)wXm1+s99@S}2d2USk3z{aGV08T}w9aakhMU`@P(kIh2
zRA>7$q9))`$m`9%ppvL>XoR1P<r!j1Xu+Nl20}S6f$3rO!8w1$uHfb^3X)ewzqj4C
zZ^-bQ8IG2<eosy}#N~_~kP*=j7TruvA$mhS$5z01eV-PGYxjGCpH+t^f%gr=JqM`y
z^DcTC4DEz!O(;0mZ^Aw2*73uqbcGgmqSNe(NUWxA%nm1Owebb#2Q9K`q6_UM5&Qg1
zZf`gwW0iEkF&MTb+PQGh)Z}vP*|^9{6K~tGL@ov+ogAvrH?-|Q84BXKlUDvIe@aVH
zh4*IM+3QUwq#3W?8uVlL7^+$hIPpEDTA~7P!Rvgh)GyX__+Ec+rmEG=1mVo{bj%=*
zgAs;BrJ2BMuF^EEfT|xLD>LYUz&T&S<MIG*Yy~+wA6_*VF**hC??nVwqzOl9*a^F~
zPF!y5LOHFy|8s}S{~iBLR~)rs5awZdeav_12k6vO!u4J+f6Ns8d>dc#;q9IoM&He9
z^;n^g2D+NU)1YgKen&QH%u0u-ni4fET^Vn=tz3@R#pB#FC*Si}{}1-wJ1VMW>lbZe
ztAL;cB{m9*5=4=l8by)_D5#)>R#Bpel0!p-hzOFSVrUeRpybdbX>!gWIp<6_v7v*n
zaPM=@)^qQ7?zr#XH@@-4{-ejRWUZ=Ivu4ejHGeZqO4Yr_Wg-xW9B?<f;ym$w|LjB<
zFcB<ogL7cu8+@V#{JqK4WR{|Y+W08HE>7!+*9L0+7V!t<)3QofwoANpyfYhQ_;bkT
zbPa3AV^rp{N^LYGn>A}YlI2<gqZjxChWm=XY<*hfeD6L6b;V{E9$0S>y``O`os>wO
zpylDy1}mqd_dV)T@6!F~!=2ZW*ZZ0fHNiXcCPRCC^q^H{`p7_Sq=`3KZ1ROxBlXHb
zqtGXz=+JZ6@w)_2mhst>9}quHI3cKqO<2q9oc)xgaF%Y%`=-5q+PsAc!x?VeRq<gj
zNr-W^E+@N_9EHV&cDnTaT+WsLP3Pv)<nF2PM3^#{kA}ex0@DbBPAF8F*R-^!k)qR5
zIzK%$pbIf)Ylx(|^YlROX`bg&=aWy(pSYJOCGP*eZf}e?Bt+N4d{n^gf_Eu(v&KzR
zk4$1(`zP-<hI{yqlsf43kB-y7OKkeO$kB28)}TO>RQ2|GHMS?8UC)>3vR|iaP(1K7
zENu%=kzi0U!a<Ip@GsP<;NXEyrmhB6hiom=^15;onj~s5Ctj;?p11%p{DP`FOA-eG
zMF@%pxKmDUP;F!Y+99NV|Nr0H|CgTQAS91xE@8)P2^(l`+jw}u>gN|%!fm)P{U_XB
z2L)V@pEpW<aA)7qdV%bW002QyQRoO5Jua;O?XFwd_pY1VLTEoZbhjHCIvytgG5{DY
z1HM={B%NmlY_>}WLR>w=C~%|V(Q<@u8COt`{ULJP<<Q*;1#Op-Z?SaoGbTHaYws6w
ze?s!6NYp{8eUvi?tOjgnfHNBmF!Bb&4@mtsjN}cR+J9;LD98N$+~0KZ{+kc}-XDAN
z;cq_pn-Bgw^1&B3*KycW(tf<ch0^w=(%0broi%blJ#52)nOT4)yw*qgJvhg#zt76s
z2PwKwq<rcw-9J_&_3qdMx5SdjU4{#%gO~3Gil1=U2i@WEp_+T6!>#kAgd&6LkcAQC
za=#91*YGLgzFu1}Q^1+TONV!U(l@R1qU(E6?~>~DGQ5bNmDEZF+0X%c+&eQlccLnZ
zzN=J2=$Sa>*c`_|v%b5y?a8D^k)lO)vE^9i_tNM$isq73OA25Z`5?$&w7MR607+|n
zl*2k=(VP9do%1{So6g#APEQv4$4d*3X>mR{VZ@@Mc*xKA`cG~0of<^OI?+1$nhMk2
z{JO6~fAkVj6b|uc*jb=_9s`!t>YL2ZN)ZY3-mv`aZ^dgfFTJPxX1U+Jm^#hN<SlkR
zQ1HuIZL@?2HAt|wB194z;Q-Njqoe>KP@+fU*Cyfx!pe<6cZ-;PwGJofjg2ccvq693
zidw8EQ&IcCA7ep|ISh#clo2_gY3^m5`&WykGz@jJuPCHkzsJ0aA+Nz}|Kkg5ad~Na
z6Yy7w^-%>!cj;*<7yr{M@>WR~;w~l*-FvM9D}v$BZpIW8YK;d?Qv0Rh&E4@I{@$Ii
zuiS#uyd7mghHflS5rMsD|F%DN7U=uO8URT_=+Q52!||%~=Z2~yJ>xG!$o0T3K&%{H
z2lNjIWs@dO{ni%2jRgJod}`SsWbMAVJt}!;BEH#Z3J1N=cK|}J{q6hzx91amcpv{5
zn0noB9g4idC5I>~e467Z_SzhcQ8eBbj}tI=%sqHRbIukY)rKw&_6n>|Y&GAG(cBn-
zE}XTZ*-|ya$NGXw9?T0@O&?*hiHNs@Ja+5m2TIu+8a7C_=^&NO%W?4?z>M`EwF;h{
z;9n-Nok&COyg+u;SYh6dTC)eK76wNNMr8n>M6Z(k!DRt3yeMKns%@KcG42QCMP{{F
z1gzvFe1sMy+7&y56`s#?793-4gMx~LgV_K2&6`2`(zVYLR_GnP9Dw<cx%Ep<&bzPs
z1hNyDhs1w<)uhg^)OvhasLI9T=k(1irq`w(K8kqdkfx!E2zI&(U11KO93!Z=O@M;S
zYObj1`2ov8N{4vN>Hb;cXuarT=CPALPey}wODJ3-V{K$c_|9p7Xx4t&3IFH={|o|$
ztTO%J8z8meR1)yU;>xf`5ORr9g!J?`H4=S`^erz{>?Mmb7_WFluk+g_`_|W>q@%Aw
zHwLhI8WsLmzf3?NV^r48KJeA=3jb>(WCoTpO^VT|<MLzQqzt>uu<X2vGcS<QY?iwr
z@PVDsoo2LbmVfMl%1w|P>^<5CkaP7{n*6p9RgI@;wwZqwYhVvD9H~UC1Jpk}32ZYF
z+#295aCQ21;oEHZByi->7m~JfXE3UkTVYZKvV$}H3>7AC(U(c4fItqvN~&L5BpL98
zeWs%MSo%d8Ta>8l*=*WRSqiBF5mm={Zp7eM{cl`Mp8@n?dqqPbWL5=%4;7%Wt}>w7
zRw=4cfQu4;X=PSzxL{iMGtV7_?CzrNe?V?X4qetYSrsaQ)U8WW5mB&E(&@vrq3Z_}
z+#OJONw9c&rNGh%$L<`|qa4RFBfrBvq=b4ScB$#O6IMb9GO$J;_ya}PiD70#T>2I|
zd1wc7c*oe#Jj12_tNR0*gv@-@_{TCvkeUe4CNd61vcbN7c!4~_H@LSIqQ52SqYja3
zASfL;t^+}jnghvV8nm$#DGidOVFh~kC~8fA6{LSPTo;?t8noVG{PY7NZ>uUC(i{v~
zxsbp-pZP0Gq<|>GAOZkhRGBH4K}IQj8s+{e@EG<#KPIepHPLfpNeQ((Iy*;2-VdC5
zTX4NKV4d@Uan{j@Xp!i;WiKqAJET$4R2VWi6Df7gU*8>`?vD6%-&W1ss}u5(KUi)6
zBn9>s-V)55#X4$kw|Qcraf(V%ho}6k{!to#C?`!QnVJ2}n@JdCZY%I^k~aIhJd}%U
z`qU+uN(!C#32;te487%XI^?fCh8S(7Z<P{S+*QYJ-aN|x^zBoTBUSR)%2oP4Uhyhw
zG3EYOMVb?DVwD<%wMaVN;^5sv6fPTi0xaI>&H)7Fc$Osgs1?iNZtI5=J^ZCac=RA_
zX083p6N~_~2g@-BBtzIQi~Va0%k&?gI2hr2Kgyq1Z)a6i?rz>=zXS^QHiQfa_`h);
ziA3N>UpgrvDlr4zXvdi$?P)vH(4xWP+0)SnpJF+!z>@wZZvICrZ!^2)zl}FhI5_?)
z-0Ownp(QJtT>y^!#v$;3W6;q8xe3h)=M}|##CH{VMB*~Xa@F7|zLaKeoT!m^G!^+A
zs!9zB+?hUrqxl5Lj79hk`;~nW%_|RK!P-a4Zt7JX)oX+M%h{#R$UaA!XTAbyzIZ{_
zgeNMnF6ggJ4rB@wJI<2w97c*R0al|Mq;~E*h7a;O>ftX|`oU<+lk<eF&t6YK*2*t0
z8kNj<>bgWC&^8dtE9`G`2>VUwX3pqqP6akQq^k2?I0}#W4CHI~Xr6e5rBg&cDaR7J
zgh5(nl5$f2ofcfDXm%g{8_jmK5rlwo?zSLhF+6(`g{)veg!WIbC2^D9JPuonW;{FO
zK=1hk5dc)e71%G^Bjqz57y~l|&S`rVai^?J^U5vd6a3U5-faVfT(yoN;HxS(0b80Q
ziudz9^p-fS)HZt?hRc;=-sOd_#bZfo-lx)Xvo6uS4u$YU0?4InCA@1(_`?2`ePfuy
z`AuR1ED!b9$A5eGnhFef-2eA}K-m8})u*ZV7XfaUytCW6KZ!P{NZ(^@a_1^^8OWLz
zRZ4&!>2u~E8pB^&h@cT9wp!IQixG8OvE7?wQ#T(*rUl0mK>z(;r=Z&Be?X!^B=4S1
z_)A*^Z|o!#`3z=JPQE~K0xI&^tpVo6`2VFBoAh=Tu!L>GwSURy|CRTyeTY$?QHQwl
zcRNuL5kSbE-^-ZL1qzOS0UEAB*TjRdyEBBkX59s+F(A%E4JYiBuA6(}64!;=0U0nP
zQQ+~a3P>~t{Q<eFg9^N+nREiL(de<1a|%VxdK`Or7;}fppBK8bdL_XX{!o;J7<;4j
zerbV8sT=EUt$)*z5Iu=YhyQx;BLbqY3T#%HmKAiDq9#NJW!8^HExj?OwPf*e<LCQW
zjHPm`Qt2R3ee6dJyBi1%IF#@fH`k@5^6txgU&aQsy)!5RGv(Rlwrlz7j$j$=2Lyv9
zpN{lVbiIm?3s@mtNJLz4F6M^kxu<8>j-G><9hjQhHPrcCpYLS53I$-&|MUvsbxaL{
z1iI8Ow}5}U75wL3uC+)?w|}dt`g-kB(z`zY8#g!wL85wRNvd`9uXnHCu3|UJgejfH
zLcXh_PU7^|%af)y6zPaNU7yxtPqcQQxqIuN(d+@Jik3hyX+QCTcQ+_qFyk+Hn=joG
z<R+kvYiD?s5F{2?rmlHdF5>+qTE9?MS)ro|%<X#r#rgA1VO%D7f)IdftKyRm@#8hu
z!@R%Z#414rV(`oFGr|wF<L#^M1Ii#oaEtUl)k%`s0;-uMrSsd<w$`<R)iu(r>7eVG
zB}-1ug;O-MnFrjus)}`eZIee$cMNK<4m%FgG74v>uZKP_{!KwfXc!M0n+~dZT1)8J
zONd6)2XpcseQ?X@@dcizvd4?`_9N8@UX!aps#NZu@Di^^-Ra*#FAesIE23pw+Rit)
z^q1J$wVwA2eeR=p{u(~a*V)Ls&C7L0C^_!z3iAWL81>$|m&rm=pWQG^c$DiBH+eTF
zsylwSH5;iqp~vi|tyzeN2IXs;a%<;te=aV4EjAX+>T_G`KuW`8lnP81RoUDPpK}5=
z4{U(G!}e>FeZlMiVHt;*P);Jh9E0=B4QwUmzrEc*sw!4-efrg<^wN|SmGVr(1m+m*
zxP=XDLmo9Ph1$D5|E00}IS8_2OyRHqxe`>9DF%i=^~ztGnQ7oi{=18xr1_f`|6-H>
zuV~?}e6sM`4B@LLxo>_9h#8(_RAnn{LsFaqL2a>bklE<kqE|oxA@Wt)p3V6)6HsNN
z=bDLv9%({S$*^i>s47<t``D!mJ|9o3&<svxeg@neUg|l?L}P@b&wp^&c?RTGw5VKi
zo|kz4HNlBKr<AF!1`c4W!EH*El;?IG3`l!^Anie7snAkrId<(j30#}(M|ZDuQ*G&X
z+`66A-E(ooNbp>C6p!nU79}Rr&xlXpxR{dA9lbb7)v#TwN;o;*H!-P`bp6x5&3)j?
zkXH(;cFGuO$s=D-y?x~<dR$Rv+KhL9x~xT{K+#dZ<qMX1TKB_`MUKY`@@n%i_mmP5
z_!-|skrOF0xy-8h=QkJ4j58KJVroAq9yxMm{-{bqHb1ow-h@8&@qq$e9ohn$A;NmK
znIK*oZPj~nq<_Vn+>AKRa+HT}7B98(Mh*FGY*QP}Wt}Z!x>U6ggxEFgc9T3TW0h!?
ze5b=t1$N$ag#2<MAlMyPXn-4BCpeEXwLcPOFX4IL*zm!+(>FzKL~33s==_=@7#Jk~
zNMC*W&IR5O_t_c+5hdf=5t()=jtDVlO|kUpv-Rx_Ioem#^V^>r_*Fo`;f?eh9}R`&
zcqe@&h?MW9H&fX0#cynHP3YIEhx@S6fs3olk*P-Vrkt5d|7PFi&{&Rl8Vq&D<dr(#
z7oXA$qpyG6AccKE*}z_ooF;!&7M&l>MO1Q<TBvJhWqLLBA{24x5gmbp1zS}Lo(gL+
zurpW$_WlnD#LaUYQ;uRH7*~bA81pfa%(0`^nmJ$SeqZ2A0kj>G=mR0pZ0Qn?J;0r>
zK-+y!)WBO52A&|5vQj&1-&YR&UQcWr@+l-s6Zn})!sH{A5rD{FURy^Bj(yP2tPz<X
zv=u0!x-H@GO#0@|%0r|s#0>@vL<M_M5i?<fFfeIlK}uWOC%1#ui-xzo6D?Cs<`uS3
zHn#>Yn;Bo(9<K6VxO~^44?2$y1i_S*OsS|r7?~%g0eOk=N|}wIUR9k#u)T#>%EQ>&
zDa!MHC@aE*^r*`)9|*sqc~#_4{m?<?%Xqy@c>Dgv3G`AIKI$r_7>5WDRXjhL$*7KR
z`ZR2f>$e%O622G1LVNQZ#3eg;>^}6s5Mzk_<aQme?POgTg_d**7aN6g9(Qv}P3YcK
z2u#Sugl_fe2$=2|Per^utC{FeCE$1-Qo5s@KkeNPIC-_Q?ZxPRMeeUw<`wHhCbkrT
zZl`{yPx0-wheUl}2@EM98-jU*$S$!JpO89;=kS8jI#XSc>d2$EC~2tQ&H9W`$1)d1
zTiTe#Tw<{1b+G+9)7)1!-$F=vJG280DU&1g){aQv(G{yN2gKe7Ot#T-TMJQIBDI`|
zg9`bh>@`Jk+d=a5H|4kkRErE-D5pvG<YdZzHxK3@>>)*kan-Rtal5<SqM~OqExwDT
zuOu18^tfL49oA+l*Ldo|b3X`nfTVywUyC}VEJ5kKZRQ7xAY>l4K4i_un)`j6s5JDs
zb!fS$@Tso3)*1E#(2Bvg!FSLv6s^bXR41TIy(!lFac^pG*VSsP1udHNIKMFtxF0(*
ze!q~Y*n1duR@3j{)xl#52Q|kcsdkGj@qV`gwqA8B(=8TA<BUw)Jj7fzOD<CG6D`)x
z+>H`Uy>I{eqL0g(7x3n>#10hb1!E5>A9FJ_>`Lf#%4D`LZC|B1OKI=?P+XWByZrJk
z-QkOJCI>Z@<kp!7rjV+=lH$*?d9LNCgEj+Ufs$>@40JghGKWS_e8yM`n%&<bD%NnU
zrD2*Opw`^Mg?01*^O#I^+jDOi!Spkdv17$qftblSL{jQGnfp}h(#_sQZib>OHps#r
zN68R@yVtYi*r*mM0_3bxy95#y&b98`xZ5Lhd|Xi1mAtIL6Q0jIW+KP$MzFexIUiTy
zRKNIc>|U`NVTY*V2GW!HY`}xdSUM!pj3mv{D81}3-O~73{jNtY_JQKJV(x@v4j|t{
zg<K(0_5&}+pC?&@V(oRl6uvo($2;^h(u47E^IS}%%hSqAIrH<E1#S*<F_jFBtGg@q
zY7zAai0U$aLKF_vI=ayLXj8-vR+H-JC6;$shxaS>amD`EY%jVLAKim~gSffYf-A_g
zUDst|!Vt+KPCcNiYJ8D#5p794h9;^{-l3kIk}!8^SAJ;8yBJPjofr);qatMD7q@%~
zb`}Hn6=LVL3l2OSlio5Mc$bqJwRG;RnylU2S?ZN=r<?4n-scF`PbM-4yHxQ<UMLC=
z)cN1RaS!HCe-A9|>fEqlm9Kr^Wc93q`?1N&fMYP%w*3HXTyd1$n~H!LH+)`wQ-&+a
zH?%?JP-U)4ljNz#XH!~(KKYi*)j*It?)cuVFCEI9nafn^1d*zcvHU!pn_e6YCD`RY
zNes2>>37k_l7WZTIi(L$aWX}iqL!g}d*H!=%kXA(Thwa@IwXg+*;%|^KxY&2^6`mb
zXWB^3jESq>+Arc(qPDg8d&3C<lNuqU8$?AD5<?f|h}&m)pnS$Nq@2{(0h5S%oVFCU
z|3tCf1#CxIE0v|jh~t`HaHLe343Zab_`Hk;Nkgzru--O1R)TX4DisxfUpr##6LG6X
zc*rD6?ZmO0a-!vQwD;SgpOD7nkKQNT;9E~S%jl5GI3%A?NiR~~S=%Dg0%P>Z`@7(Y
zl?T)2`Ju8++51f2>?_Sm7x#m6d5hR$SxX<_;1iUv#C|tSm5cPiyY!wAv8wsro4trr
zv?k0_w|G*_Nw;KaAO$X|<0w`wqNi2axiHNVJ8E%=j>WFeQ&kI$#x+Y8&aIt$7tzu!
zgW0X;baBc4ByD@5gWGHkhD&GYHt*=OyhSVff&Cnvw>lr+7JQW%+nN~pA&@2?;x4}Q
zVUl?ORXuvR?8I%i4C1BkJRN}=jEhHni#tlR$3hZT)EUv9fH4U9crhSD-FD-789jl)
zJ)Lx#u#Gndx7wGb=f5VCgp^OcG46Dh6+MZ*5<f5_R;|>1r;b$v!^jh=E8jaR3Av`m
z_TT<z_}0dpaz+MN$(Df?_tJq4kM(zYl*|A656C9($0EJ{?OR0gN-_FT7iq6Ao5j(+
z#(oH8<nbQm22f-TBNp-=wW#>~C6mBnCP5Q5kjX_(a1P5y9_vltwnX)#v{OP1z=riB
zr>)z+EUp`%@Y(bbbFuYgq2R8pC6Cb%$q++RoJ+|^E13Y@?o9@UFP_HXnrlL_CpD+)
zryhbDaBi8+i2j$=XzJ3_3G;{?%re6mH}gI>qK-Mo@V#12G3VD;o+Y(>n@qhW7(Qt&
z)^z7mOR)F?JTTujjG5qgqc=ToXVW@wP-{iM^}FkkN#40Qmg;X);UQ@Xks|9dTk(Xj
z1n+Ld{uSjTZmQ#mpv+QNFHss@9Rt<)@_E*s6f^gXX>zwPi$wOVeGiuvd7f#FQobvn
zAtyM&29Au?`r_KIcBM<UILwgw3yO+MpNb5=y2B)FbDBE5{dkO(%ZftNBgmcJF69%&
z<iy^pGTwY#=$mm@JbSgibhe|XqnqTSHOtBG1wpc;ooCMq7+!7p&&si{hb<o(&*X7a
zFeIauPncMH1O$swxQClKN_S0|-CfkazkMv#S&1!mJ{a7rQeWS8yOR9DdD*sl^bm!|
zEvm-*2;QOyXRP0889%Ah`EZqEmT0El3?Fa_XDeKL=INqNvKQhfmHT)esQ^hIKq7b$
z{Ke+Y?dGS|AzCI#l6%ka7^m$>4so&{w@w#S@H08ilI*tgiqZV7?=(6~<|Wojj~l6w
z->Zm9u`X_Ve!uuT>vGhvnTf5%ghK4qfEEMh$WJVVNPmX9Yq#Jz${}zclocXq_X)xM
z3xQh|-z+bk_~C-mO9r>)uOH&&Zn}SvP^E2dg*Cd%Jgw1dsc}YRZH^S-R;vKgmOC1P
zJoj~8nZG?>?B?XMqtO+~rZ?7)7$cgP=J>SjNBy~T9zSVsr-xNB5BOCgm{IrU%4CP!
z)SE8(irb5cZiulfz7Q(4Z8#nx(7OEjB4ecVLHY?QS%Xy+<EHq)<jwCJUd9uTqQ;qo
zsxXb6rv0~?kh}TurB^yWZ_|%xv2T6#v4cDs(53h0!__S<;#EO;AH5Lq@~wEO)~HE)
zW?NVJ>DV`^7q=o?PJG*F&Ca>PlKGk~_-X+SZ>f)i@*v>>Q3qg!1{%1U*{ZOkR$Rj~
z`UHekm#TSkV?-=UdU>nXT(rboB=%uuqr_vXO^yyTPrSG$ekODL^)iLmcC?QR+ce#>
zW%LL;{gGow=$P`@-L?!5U$a0zbtZ^6pIg;dJUO$JF103+kXwzuTN2Oyj&;eyq$uQd
zwDdjyx*GzVZM-6jdi@w<@)wH0!sA7X9A2*<DSIr)NiS<Yb1P-#Lqy`k%EOvl;UP~Y
z9G}uNd4)}m`g^kxUOq`QbqgA7jZ-Vbls#LG@b<h{Lw~5<*|Arkn`=YF)+$|WA|GQK
zaWU<Mgf6=}qyf}()5^P+XOLx8k-+?;o$%y(_P{rri{n(9#LY*u^K<ZqjZc<G``(H#
zcw>PiT}+w#t1~ZE<4VA(8olfqt=SgR732Q0ySv?zS7}EcdGCsN9|aKA6Lo^#NO0J;
zE_5;e1+^yRetev3OeG9ma&V-Igi5};A2_^E$Ld|7!Qks>ag&Rk$6r)q;^infInrb1
z^%Sdw{iU%>jT*#ql)Q2qoV0FV5BjH4)0u4>QCF^>x;A@`*!aoAj%M?yBo!08G$Cvx
zn0Z?Zy4eCNRC?{T#=SA&bL`{i{zJqZbMlzRS__{R{K@x#Uf3?jDQd3hljVFDdJ{Im
zv{2|zqZaYXmpLAlBdhSW8sj^}p2y=a!dZsbdwdSP${rfF1_dn-{PIg>r<bXJtZ;C4
zo+1eedd>Z68F&;Y9URPpREGMIwm(^jI=Im!EYV5(9Eh-pQUC4&aiQ&Y0@Oji+d?~}
z>8&L;hm~p*INE;BGZ(sT<hcUfsNue=2<0bcK<D(<e$GF^dn%}IF^s(LfMOuZ-xXD?
ziV}Vv1o5mpZtfA&mQr&()!et7SMQFnX7J0%jBB3Zs5Z&1qVSM}m21O3_fU!y(-i8H
z4`}YYS1jn!{(x+z$-ika*iO{<a)%}GUn^#9xX7G)$2$R_fB?pM!-8@TC}>BSbWDp|
zUq@G?&Z)3;7`PvH8SwHu4R4KaZ%lL)fGC7pQOp0NMbZsXm(1G`h@cO>R;oj`*9f9F
zYuA%VG0XFhp)%SLdOA8jPw|dn|7SU5wrgq-wzTGChsb>^r%!?9-N6RF^pt6a-&PzV
zZ`>rE11`Q3A5sfnrqGf1)x*fB>CHJReyi*Bk?=QJ2D@)(aWFKmQSA|hS2^eedmJh4
zu$Ev{r1dFk`!nb3qp4Q*!4u%EVJAu?A}Bam>xYj%C)b3QxnYkbgt>(6mA%)_Z3!LU
zV~O=Q#i_6rUsB4tfZ|afzG}bSC{hYFcxH&Nxon4N_lbIa*l-kVl^PyvMa|`rQoB8_
zF{77|+5@2{FH~i<4pH1D=XI=Bc&48IfUJ<pJ)e~CUZvGtB0v-76qu7FVq&6~_b%rr
zex3O>z3ZYfd@RoJu0<7U0cFiO`S(?es%LAf_j*tLFz5m~daWJxexvbc(c4_!=^;&l
zAXhbB$UW#36MPw1^I6oDn$(}69W)!1XHq*<jwpXWG@brYsA#8Ful+0y?r5U3?_^Vq
z<ETf05<bszK4LS?=_*~Da6_S1AIva}fe>Q>Pl7#At#&=6;KKQUY(%vapR5KkAu<6!
zn42FB=D9`C8EjEu9_F`(1=6%wk0B=?i*%(n)X@|zUsGef+;<eh80m3p6F%GLc+-C<
zHtlXsOt`d6ab!vT{QO$z$Tz(^5CIEg=X13eBA#;w@Y8(1{sVG;G+|Qii=pzc1FGk2
z^lp9H?0hWk<Um;d7e~=UnqH3$!alOYK3h@0V|Q%Hd1OWp?GUV_P{o8Tst?k%y%wG=
zsCnpV`M9l@W?qGD?hD$|XAPrCHD4$T4`mA`?@wF;aK?UhrKk1J(08aBlq-Escig<6
zTN20^Sw5GTDy%}PPwNJX-6`5|NP{FKMw&zXThp!!41uz5>kR&iaGEB2GAE~QlfKz-
zLG=G%r(gFv`>p5|{R_M`+OsXgP0XtGq!3m8Jw%C9C}Exu4~e;dbXZ>G^c>`XUYR;@
z4uPvnX4gC5m+K&>1;Xm27|xj&6?a~x9W7Mq_sZhloCpD4DExr6nCIicMt;*^zI{t`
za|k;3*y^9WdWvSlcwCS4boK|t2SiZoAzYEbPd`!{h+v{8Fb%yH85j4zVtnOocEgUx
z4@l|ew*9a8h?0KLsRZg=sW)Egi<gTrooC8wka$d#^!LY+sQtnfzMNzDu4E~&@<=9k
z{L6_}w5yc=%-4JGhX>?X292k0>F$G<EZJrdJSRai>k(<ZT1Iej1INz#86IO}Qh4&n
zY}10<wG}l4`2+IMmT`TlZF1d<j2A&mRGliy8b2VuRDLT^N3(RCUIh#n<Ywy3(6_Z9
zpLOeg{j@;cO4p!YA@MC=G}Yp^jC9Y<&JnZA;TNcL8w7*d53$|PJvRoC6WqwGMTepC
zKZg-jkScy-na@g1t;a?Kw55j)5TzE^ON>H|@1=-#1bZ*bu5&Y1pJFGTQ)C&cI+5RO
zE2^KWp+OZB^L!sa?gFoxx0rV)BIjM)(&}WPx3U{+CC7V7f=BL=9;BR`|71a^>iVlj
zQp2HzP>H(_AJNGsFn6?p3w`F25Dq$COmHmclkLhd(8jnMUE*EMoV_tr^D1Ff^wS+`
z6;8;V1Gv%t+_6{;@fra&5x0B{Z!t<a31=0}+(@VAlruKgP-Tf#8m5lXOoR`s+fQcR
zCukAj-W9MsY-RSu=yUG_UB~=xU?Mpc(>p*tIMI?@f;zKJ@h9b=F^Xp!!}VHGxzJ_0
z3`*l|c+F_P>!ehx6v982D>Qe!e_G+@Rs&1(@i5n`HIYW$F0P2N8i+>#iFKEm%ZSn%
z%Vik6G?nYgq)uVDa7I<CxG7dv(ML$acL5?0Y}g2{sMp1*N0B=C)$%qfYr6uXF^Xky
z(1Ww_*3oF<c^~HN%w*Kqdl_X(EIB@J*tpg;(oFe73S#Isr~7@3yY6^Y1HHY}b5CjL
z(XaLcUn<JP@kf?Lh?0vVu=dq_rSliQZ)!<#e=)YUc-kn(6kA&u!S?m?AU9n-)VfYp
z1*S++B!6}m`T=?RxWuS_jWAF}Ii;<6p?cX%j^*|e^xeGm@xr#7!M*!`KxhdaNORmL
z?{1*XU3b~V1|oT-lG5M09+=@Sc_+6idHonC_x5K+#zRjvI=^XGV6!c&?Vwv7-N<W7
zDSCd{wssRuH;%9zo%()B^v;DxJdMxy&w72mdioO2TK*h53vepZejFZ(&8r2;JD6?c
zrJjGAxQ^B>{FWC#!riAf^LgY!Nqt(*=YE!zi|U-ZkJVKa+I-;!&tvecTc&tu-72^7
zpmpyE3(>|VHa02tyd=L;@g+fvyR%<vUq(6}<9Eu81nJXwMYenhgT%AoMp`ieW2$p2
z_G((Zy&ACb{jJ89f={}&zz5gprDtcOL(SI%%MVn$Uqa=A+T-Z0K0Im(^RXp&JTuT)
zTb#pIx?>I9Ur>^fh`GaD|Jj-pY%aKC*M5NPK$yh$==o|?tzmpf7bcd4t`jet=!_H3
zyA7bikFSyXYQHm_+#1l%9Fm1*LEBI{meuIKu1V=H4<_`Uy+7QE<eh9e-d{D3@2@iV
zWYaA<ajKn8`&Cixiso3(2mTu{4(}cqXDJH5YD%CYin-Zpbe|y!W|A|%x;@pZiPo>K
z5Dd{Dj-Y5U$Gy!xPhUx=UpJGvpCEFZuuObHFq{mlWPUz?t;*atXA`xsz56b1>rPoA
zLZ<cpi^E^nzkI#I5~*&Ak1|z{Ng`b#hrn(1UW~HXBcbVTz2n=}4aud(E!5qkCdN97
z%MR?5`qE48f){x*riB}|=&WcK;e3=16bs5Stbc(xVZY4uaXz3XeB=$c0`Ea<<vLH%
z#IttpFH7&Fm6R=or##+Yt}JCqyhZ6iFqInPx+xueT)1J3zw)UT-fv&y1u+P_&S`Yh
zS`SWlC0HZAq#9}dgehjg32ws-CFE}Pkz<q56=tkGic;xT#g#T3TxQrulElI91%VR}
z)teiiUV7JjzkoBGF?goTf?%46q<P+3Rjl^{e!q=Vb#n1!e&~YcLvgyNrs~(F+TL#;
z(3hxco;eP^k~QVyWldD2^r8<dvv_w>SP93*MxhlG^@>`FNmGy2O~sQ+<FyMvhMbVt
zm-rI7@4l;QwoLY%Fw7T~uUGrcd@J%h%3^hZrm|Q!@aqX*Y)+g;q=w1|j;oQJC!&?-
z`bdkpjGye}>Srk8ZVYwuXcAlExKQZE=s_DpZ>}yU8m699_D^l*_TnTRWvxf-S2RaU
zbvb=^;<_KCk1_Mekl3aOID#WEtUog$pz0~#iGrhd)|KlpmIE$3#+WA|{cXHfG;j(x
z44CY4WvZDuyjuZXr$*=rPMu#d@=KVL>o=t5I^lgi!yPQqrj3G2hGLP|y)ub%B-<{y
z75o_&bB&UG`}}h1*FZ-rV^sgj9hac%Ouj{~XQpLoQ)zu1MDTGHsNA;a0D>0har;t%
z&eJRZ<~s4n?}_7#)$J8OJEifn)G8X97XDPu1DA85>WpU_RSg%nmrAV1x#9k)FyAu1
z1r+0k#kWE$r*~#D&sX0Sy_<}fx_{V(JM1!K_srgT`G4SdP^K2eq9}mds&LjjiXcDj
zUk_MIic1vU2;|vxULIXE+4fVGB1sVZy$2A_q|lh*lM-ml!k1~e&aslbhf20~4L{fv
z-*}F>dnPVTZT5Bx#^ce0)*ePVedenQz1+CL@d965lZp<rsvbh(3bt*%B(rgaP`f6p
z*baRU@QXUaHZTjJen8GJh*Ln(LL*QE1t<_<KOoZ;4}c$tVH*PX`3GcS7?jRi0Y;=~
zROK7s`vlxen}CB<0jN<u%7dDUB=}K=;TxajapKgDc!SE(J?Q^aiy0ALN6`|0@lz4K
zY@SJrI|64%{tK3S)OCw%NnPjoBF&Ra>yXWJq^eDJOhKxRbg%18hYRM8TUu!D2YrHr
z^+MC;ei0EWJff_EFLKl?I-XyE@`srlM&2g9B=qCCx4setCVDzI5gaQ)AO>?q?Rk9Q
zlLFb1D^*-tSs%jB7)NzKF-s@PxD9T_5~5s>1eRJ)U~>o$wD#%v`)a3GT2V;0JP}JV
z&}-{n^8O}7jcV7$gSk#1g!MgYm%5iO#m0E;yde@HRy}gMC?9h(QcE!*Em4rN>|tm)
z-sUg=Jn>~F3%visqlna<`fVj_o8<o2=mT~G>ouRJQcv5_hLvPlRQeL0qJ(#Ct-me{
zsdh<f-?jZ*o|V8GAhcj>Xh$soy!UN%^6V0r+3}+lgZ4)jnKJqo?2}BJgQD&olhDe#
ztJ~RlfhP1DWU{v{18ecx{*tZd#HB)(`kaI)y_<u_dA?*kkbR)|RF3z{!nZuTjCi+!
z_At?toof$k-8>vzqYb<Rn)eeG5cKqV?B|6Z7u?lV3X6ZTW7w|D*Di`Y|8c-d{?74%
z7U?sSv2t>vdOX>JXh-8gtHEo=toq4#!O<^8*XJ+74rI?_S%EhRfV}|nx`%u5y`F^A
zY1}<LWHVxdm7ZEVDZ3LY$KV%X7E%zBANT>FsFn6(db_~=bgFceq~m_XpL80RScyHN
zXor8^2BJJ|%wz*}pD&DPyRIGMdT4gVLR6hwRL-v1eLiT{(2m=R2AD3Njh3S~fU{qN
zJC+a+AD6)ik?B!uX7-emB_V)j2VoRe6g8^d61W1+0Ou;J-`-e}?kMn)MG<sJKtH&E
zCdB~`4g_wwe|^Wca8P{!0@UTd_8#`@D;bl2f6w3a`I~?K-d}&qpFI)!w><pcIWHy=
zhMiKVKrU{pUW82$Ja2kS!r8CGN9jVQ&E63dW}V6KW^5$cRxx!P&8n5ur;r!;a4Yq(
zz!`^&xf1V+6dAp}Y)AG^G(`pqyHGH8&ILFgIw437Nde$BXGN_EdseM9BZ04B4`Wjw
z37&GGk;vsO;tBRP{rTEU|N6Z=3Q^!FqgDdpil6=%G|@VBug`z#A^ZM|hu}Xt2muX`
znm?gRq3elD>!6;nG%#@iL+$kuBzekwNmq@}5muU}@wpv-&2P^jZ2y8h2fSsR!hxZf
z=+_@NdJL-z4C=ym|BSEdn2OrwHS&4_T#)bi9Q(se{Ms(r(f^`G%9QuL$cqiHe1sMJ
zD&V&v7l~AwZDz^6KOpH8?}$D7@Grm1d%;C{5Qr9pF-jkQ<RZhaUpRah=&Oqz`wu-$
zbEr$D`0b+SdxRmvYVkL?Z}d_1v0m#?VRc_~9q?*Qg*S#tDC5P)jNw16!OgJYyQ_t;
zE;hSoI3B;1Lf8j*<4-HGFELUCmI2@3Kecv(!ouCJX})`1@+!@U94mKshL`&3=#9ur
zt+gU()u8N|Qe?d<HWAXdJLQc=CqXW<U!{+V>i0xvVirjY()a2dol~z=1X_mN3Nxs0
zn^H;qi!1mZO2JQAXSPeA6eTvAb*92!Pym5GeqIw?&Lh(6quxpV!;ib2*6AOF*i=!U
zRWMu^B<iQ7a8C)+v>!|c)LPZ~2gCpoDOiG>O$0`KrTOS<Ds*gr{)BT+4}E&75Of*X
z$Cd3T?v1ppGxvnaz`fY9jHo%;6zjQ?9IeXGWYTuR{_AzeDnOp-?r_L<>%vXjhwNb<
zG`+I-P_fGB^owl~`Rd;{Hg~&zH?)ThKM?4B4Es>=6RQX$s@DxM1_2!5&mg~qeO9TZ
zGb?Et!~~SEVtpGuKQx=40z!_2_rQj2Xs&pfs`uM#IRe}F>xkuH)A5k!(LZ6L*LTi5
z;r;^47$q~Xt+S;as4S^-LA-%qlt;Y<c6QHaCMOwOm7Z+;fWVqYxNhDw$oHjnk&ON~
z`2PAYfuGm~>|!#-?+2upf-s8!$idqv6`FqpdIB(l!}_|N;T`B59fh{2vaXdIT9g}1
zY*aGw-zN5AszNyZh+mbqLBPu%!wl{plY<UFhF?U*@adyVjz`VclQpS-veG~J$AIr2
z%oB5$p;9K&PzfRk0zVc}5ld8D$=p-*W+Oi!dh0b(ud*A)4*F%Wi<mUeIu@)`+L^*W
zd+56-kO|+zx?sEe+4i_*PVdA%<rd#vKhj(^Y~=289;|l{^OA{!SsUV+(9;?bLUzf0
z5>cc%uo2at-{5|IlxoQDT04~*+f^z9wf%8|S(nVd_LsL^sMXa=pr~}#>~mfhyvuWE
zQt*D%Tw)O^AeECXvT5e-b-NJnh0R)zNY5w`J8}gA$!SbNzH$(NDsGxDpc0mMqUb=6
zd%gboqnV7<e5=LEcDLQnZzm{si`Z4w+{wIBG?Ki)&Hr8A;ZK0-6!pNcV!*@j8vczw
zR(zu!Jmd7tL=zn{7-rO$*^MOrfFv1MT$R>%%l8SV_XBb}F@fP#mbas*S>G)<&oo@r
zThg7QrP=kE23hhZ^aq4@=p5m@{3+_$zM*xV2>C7LdzpYR&DY3iFOu|1RrU=**kcV^
z&mdsq77-C(dwe5$%&&sha2~PrxY)iH{&bWTZb80r&+ekFMfXPBV;Ru^tMRa7=7pL@
zVOs-OnVY+tY{yMB(-I+2eh8e4D6_?qhmToZrul5k2U|<%a<cUd+;ksiKd#LYoCv)G
z6|He$+~f{BU`4HW^cJczkQ}>#r86CTX@8V-qloK$LPp{HLCw5}#+Mu$cQV(*uA1r~
zwakb_b&?s3lOn!2a^7uwzD2x0?+4^{Ol;#&OaNr+wD<kHVWlmbnFojO3_Xm6Z(&3x
zDKz<xJ3)|SH4~Nr&5Jd1Oq78;-rU+e6n63c8>ns_o(%bSL~63ka$C3M4i_ZV|K%zp
zHu>)6rt&B{>5`UUq=Swzkq(@5hKHg(>ej<P8wx0YH#4&EEw~cGedz63{z-hozPXPj
zuz=Wt-ZD6@C1y$MiT#t*ehoo~Q%+9q?GicfLDa8b1shfST$v=UH^7Oo{BVQYRM+@L
zrAb+mEl&+Y%3(>`v;0pb{EP3;q>;37!`Og)CccGkVYN)_*xipG$M)59$?bzc7^#9C
z!we9~Slrh#ZU7di0=Y0ohXqkM2qj7n7f0ZOF{a~NO?ntiA*KwI8>%^R$*Dk7NaR2k
z=b@((EXahd1m?B{fJ4I7{)<qNvO@%e9}s?U`5%Mtvi2ssxoUN-kYJy5o^Wi#tr~`^
zD7Pc}+My%ShE)h$*gR|<+;L&{_(aMfvH-;mHMvZYq}mo^$Muo~b~Q*iP^oE<WLwaw
zcxc=+UH<fJ&d_p+P;<D`Jq0O<mj)`i-zGN9Jf#xDu{P=SNFv#q_P!?zlSw9sCxhVP
zNCec>EfgUQ{?`U%*CjFj=%eGFp3iRGi@2O~mhP4wEsGm}Z}TY5$4#4pgs+KWNuUPm
zUm6ex@R8X2Vhj`CN1`SWG`0pvCA@TS7@OgM{wu}4zLo274OVZa9>yHYT|d-zlr#?v
zv8>*G$|t|&_aN0WlB*k>nov2$!&2o(MlFYo)Mp-tj&aBi3q(Xx)p(;(l~f?s8cel5
z2LwQXB96Z_sTN`TkgUvADE|?5oT%^-BCBpe0n#<*s(bnm2(?!oK2t68wZZtR|ARXb
z^EG`N)LL4g9H^5ticWH{^jv4DztU9f4YJJaMuMnk3;W~|7}bVmyVSR|D^KbrE+;FG
z%E20o-n999@cP0ZcJiH7czt5<2gHlMh9=v59J;hPKKiUo3XiFN@@3TRW%Y<+q1I}q
zGYzL(r$i0^Gxeau$4aQ&$FDkFLtN}_M*Nj#j^1231dT}r>r6#nFY}DSL2R68?2%EM
zOGrywN&T}-esB4nsDx!%WrjO@$&AATHklN(dNY>t2AA*Y3D+{bSv_f-D)A+U&7DTG
z|H09#x|+N-PVm1D0P#{#LuPx8ty0g&8gj)Z(YnOOMwI62h*j0`T&rbJC^_$wmT*{0
zmL}@jd>Jc_J~w%AVL<T-!f5zo6C=)~G+UdS@r%Hhm<Iyk7x>$u-<=G9oxragus4|3
z#7o$-vVC2;xsxI#N(ZZX%e*${F~OJzOoBoCm3(H3Q2X7Ix190QyYps@_>&P|M+@&2
z^c06jx*T9QeEje#KSYb)iH&MohkgABiJ$K<h@598y%hghjrNzO3QV^Haqc%p_^nB`
zvHW*8|Fb>wH*Nms^5p*zZRX*>Sg!S`Pz^V6nPe<#{``$mUV>iLuAWc+mloyT#@F60
z&(}emVPfJr-u-Fbkl6{WKWZ5$AX@Q0%3T$S^hv;cYemzld=e=E0@e|XZR035<DH%^
zJBr*9?)zHs={Fx1{Jyzx3`oDTPR@v-h1~wEqJAQvSxd1%&)_x@WPyP=7Ned!*`0AM
z$}PANgOfQF2^oWUL2ZUBQumSvLSE7bbH#y7F9`=lYOpM&G-I>{QFY!YyA);PlB%Kl
z-<~#KF|WmQzV3Ayu99t)INwv4NwC89uTp|g{#cx=IXH%F+d<NOJz7G)*d!huu(9lA
z$8c2rgEdq8i!vFu!(Z%%eczhPvhNJy7{=k1%X(Yi$e$#|G%5z9M&5kFKKFn3wb;2d
z+}ORxLGt~ThyLax>c&=_iXcSwSbP33a}AeH*|+g@^}(B6XDX~7rJvLqi>AIF9VyXR
z&Y}TLIi8<oTU%<Ej5NTtzWzwC-12Bg$~>_8h*HXzjvr`kU`thd-qWa9-+5k6_Wq5*
zNG+RnlrNf(WH{laI^pW4eBNlj82+M+tqr;r(;B;0hL%d|W_rSg56l%Ny{L%^Tpm5{
zqnr*_qHG_|zU~KPz<$E@skpMd+mVVgzL({+rY*_y10loBx2KnrQk~8Rvg_nMXgnN|
zRZ**0zRz*PaH$`!eUs3SQ?10Z<(J4x5|_RAKZs@UsueufCa7{|&G;it!=ehWM)fy?
z8(E!B%jeb5OL6g(MBC3N%BQNfA{{1&AWt^iZqFx>-zziii?)%!G7!?L>>0Rv2HDSD
zBHh65;1z9n1b_Y2XoUmHwYvBT3DcX8vh{3N;6ahj_m+>KaiOTGX%ND*SAu?V%%04E
z-jM?^OWl|0QJMu=a!HvGC^fKePGBwGV?v5Kuy^zTMT7!ki4W%u8m(rO!aor1?VdVu
zFS~JT>&Qd)pf#%1APCWt!a2Lw7wV6`_CoaC2|#zcI7-nq1!wibj)5lmv$xc3x2W-q
z50gJ2(D~aM&y<BsPogb(WFlL>^tVZU8M+|WxWr-?t?tOBAbBUa=#H8iPG$nJ44n`k
zfKFfnN)6l-hY5yN@iqA+mjuymc|pchq9PWGSzmcybJ<Jf?6)hT0=O$P!4mC@-2m{<
zKj-<^Zv*q>rF0_LC`Sm}Rk6zFFt|^}uotDO)*qRa>#n`mc{IX%(SZHi;MW%~D!gyT
zu*<fx52ibN^Ai^F8r9gNz$@<=g3jsPaZ8*|QcP=6ifz=8#=bY#)ME!aM-=W`jC7pY
zipWVjC><5-<B27mZz~_&1*wkK99BV)H;CM2T*t{!{IR6BB_Qtq`x<ZD@|%eWT+nvS
zK(ash<nePw_)nC5olY;#^bNM8GWgM6G>*OUjLLMllF@(cjN5WvSSXy^i8;jk00EBI
zP;bBNmQ#1*8&_!96Nkow?;~WQj}@v3U+^}{rKe?KdwPmy&i+4;W2_!%pb1Bg-0T5s
zoPHlygk#)ov`*BO|Db%zR;Gl=(oL7OL%phOACZTNTDQ;i#viGJ2k{9Ku$f3f!s#Td
zb*-^43L@_uh$inRWS<QL<;C`dpU64?$SThBa{qyS-1`^k!pu4-jFeWsV?h&MG&%*{
z6M2QPofi4s87GZ0`0a8kr-hE)S09gFOMbdn601s)#02a!_Ml+<8IW;d6PZtBwB>q+
zW=6Uyr#~z(>;lnjohB-gJ56kvu5oHnHme8vsS1K8WqC!G5zF=-^bufZ{@w`;*9NCS
z%^3r9rwL0@G7Z?me1i>)Y(P){-+K5!9qhN|2DRvao0`ksC+uxc=zoJ}Ie?GYe_)m@
zO3!v8(Rjpn?JW=||21#-fq8Y1(^pj-{(koV&vfXm1pxgba9BA>(1HQ4Q%k1fw!`*D
zB`=rb!bb-BmEI+l?DtkLia&04i#oFj9WE<dUoQf?@^5?LaU2&Nri%GRu}}a~O0iA_
zFDYYecQPW0qicXaJnvz3)=hmX+V>8QUA%Esa5lGILma(t3Q40Ao>h8H>=R<Z<)YDN
zql|95IP>x~^=q#<uAHk3KX_1O8u`R|3mb%DhWAl=$ab+l+4HZY{4FQ!nQXXbK8%OJ
zZ{`*CIK>36ihe8%S+R?KFw7axeq!=qvak_TRYd$;K|BFEmIcR+!t)Shzr9?)pANMP
ztiI(sYx@fStu1(|RNU(cj;NRST~USB*4iGWaC;zEG3aY&W1s-tB~ikS69vnlE@0Dp
z9zq+wsS?FU62lo!hQ1!}zlR@=A%nd3<Fh5yr}O$q^B)VfbF``7J~wd;l^>&7`U-}a
z!TOBy<fC51Cs&6-36$1eHM~$&h=s98%9sU9!=1&M+h*SQz#FgG2cvxGJts<=^vIbj
zc38_0$E`s8!KWdgM;4E8@UdlKEJ7!*`wV%-w<K9h9GY=<d3c6HYKZ3XKIo9F<elD{
zczB(72!)>TZY+}yiR>(uEw-=LI+@qCQmUlXlpjL6w)4f_1;e8$2orALqaUxYlX{&=
zX~**BXAVH?MuAgUC4Aq!%=Y`Ee%gh8*S`zBXW+KV6pOXKjjJivxVMtZ_~ewR%y|};
zDVmjsT<ZvKsg=|T=7R*TfypKCkNnlBJ4mkxj=O7bEoJK%;e0Wp^Qzb7O<(s^3tU?>
zCu(Ab?y@fPS;k>!`b!iXThG0>ZAIQV<~M<@>PMB3({~3?B^(^{ZiCYq)1#PoLOn18
zE43&pF_}HJ#041p_pQP=clNX#+Z;;wHW|MAedjf<YYbh{_7X&`9$98cLF(e(g}uml
zNV;&By%eK)B|^X&AG>eyxygIC<Gy`lYM{}$5rB}sI7`trL*WPD<L{M$wXYr6Z=&MR
zBp0j_NeLe$-uDAigW^UqrI?v5mQmx(Vm`YCT+A&hbYBr|{Rkq<<sD3PzLAm(?;lzb
zYSPzh))MMd=JfvVeX7@6$Qs3{XzDsHroUbz|6qFSjm&c?X>4fcOuaypwZ}odQ^d#{
z1Kj42cjX*PWqLG}`Yb{xJb=|?{`5pcoP#w}x~3F8m16Tt`#ksLDY~-NVcHGOj9Cij
z<QVFwlIOlR{c%)ZMVX)p!Ea*b+eC;=)%G#ulL>M8304IJlRhikMcGf0q6}(RKAux3
zr|{``SVRytk-F_=QUv(8W%VnPh*O!QErDH<VSeSzM#&oymm&tI+>fhT?3^^T!7B^r
zRE%~Ve;ZLipCC?@v%+w2c+|eLGgtm1)Bkl6tzQ_pVmW|l^uPW1zE_&=_l9zzqwJN0
zBa>yB6D{@=J#o&-Rn$m@?vRjNfpapaL??@ePijCNV<z*F*om;9;(!|Rku5#K>$Cy2
zyRMmp&)g0C&tgNRJsGm|wH-8ie6qL0NayPS7PNZ=zUBa+qtFg;7~^qpihmpFZ7I;b
z^4C!1qk)J#p%)<0I4o#{53e&5;XIBwXtUL`%;HWW8YN{Nt}HNbJW$ae@p)bMf*6Kh
z%&UT&=7nmTRxtuP>~9<pMz9R?1v#$I0R4Iv*nu;uh}Quggl-I5Hdv&fgsFe(1AqO5
zJRk#+%s|y~1gefWoUjbkf#hBi<vPj+jac8g`p1F%OQ%3-|7AV1K>QeXb}jMGp?tD`
zYBRrd3N#-W4e+%x*;9SmC<;LJNd;OgJm$~A=tAMYb_#I!UwM5Ap0Ag=LrVE$tOQZ8
zp?>RA<2PdW-u;748h;K&Wghl>r@wEY66Qb1^ygR%d-s+9dI9_XAk($~?n_e7+z-|a
zb?{HVNcu^Mz01*`qGS=9&kV?$ipp04xC<qp$~^q{NA`$C{}*Xf3|!>&P+b6Q)7VPJ
z&i{b)B)G_di%%H1`22(aezM9R_q(54Kl2aC*Nw9Aq@c+*)OE*x?g(%j`Ey77WXC<t
z`ycG+3@*69c`q4&9$|kDr(!hq`?vh$`+p6afh8J@0sw6B8aZ`!7qywfz!R{ylB2)v
z#D9&O4<Ob*z6t*SiUOhzKUp31Pfq{ImH!&I7xCv8{YePAP!$T;8YOQ3nD5WmvHyJC
z6!j-<6aSpiRgr%(<<BeKIuI-0d9}B^2)0abFwelGmqIi`qINJxxZOE-1mmn5ryLjG
ze=JiV9C9a`7<;$B7sJD9VBpwzK!Dev?o?w3xIiw7`$VSTY;^39d*@E>L*65gJX550
z>BwJJf69zkB)Q%d<c+ZwxLNUxai)wC{HfuE_EU3ZF@s~hF-S&(ACLpNmq0=iH2HMw
zH(TojjUSzaM}Kt~eV=0VNRfX5mE05aKgzp$)1k_09D0H5o%cmDP5Mg~P1eaofFrI?
zt>zJ9^Z|-^57l-8939x&JrME#08Skv_<Bu?_Fz)EEJ+u2Oob)w{9ADXb92}0ry+q|
zML;s`MZKlVN93u0@>tui{D~U6v)d(e(f!ngt%uCru-QGJ|DT!56ag^x9z^knq5L7L
zYC8W)P4=(UkpMOd`Wd!#T4gUB?86_Cgg2<J%L#q)^kAf5XZabb5l+uhAi@cZ-qy+W
z7mwSRKSOLz0K63~gFk0)u@kVU@m6nC?e0b$#ScKrkT*z;RgJK1Em)frzwsR!&0Bg8
z${!M=B7(vgj*Lu`6__)znA!Pjf55t|5{d6dtY*7eQ2hHotr?Mf^p#wxc6qq=`l(0f
zJ@hKCPXW;M4za$j?`_Z?7~T44;S;JD3Zn9YarYpehnW}j*7o3Q>|;*};*`vM4fk=l
z%N11VKFY11sP<QK-AxjZ&>!x7GPZ_{)SI|4w4x3TlE@JL8%IY-r$`MOYzndE<yYmY
zIs;`^szN@w%==#XcOT=oX+~p@p$2^iuABA?j%yfDJbRO5o|CA(Sy7exih5zJWNZVa
zX$=OqT-$d4Y_bf8H(@v_XWm}dwNZ#UI<#)_BqXqslDtTPQHn!@gc}5JC0)xm_2KoE
zTvgU3>J{A(+5wIXv?Dg#fm$SuHAxHRm8|U{=J}r_eaQO`%Raf&F@2htb6WXrShtTb
z7l8PWBgUz|ML&lpotum}_wDj*_r2Hp>YaWCCx!Js)IiSudm!g6rf$H~D@)pr=+7R^
zv!erWNf?$Zdl%R#FZ_(R8~%UT`_8Z?w{6`ZO{MovK$?Q|E+t^0h>A!PP>?3Q2}q;`
z={<r1QX^6oFw&*>CMs2`^xhL{fF#}zU9ROi=j{EQ=j?Nzdw=Xdf<V6c%{j-MbIdW`
z@xEu~Gf79^LvF*;nS+i$DOCg=E&hN#%xwtbxl6J6f8rki^Sb`v<*6Hvpnd5->IUxw
z{Ach-FKF!C0?Oq58XSr7_ecMjbwC^LckIY7^g~ilYE2?%Slr={+5aN2_4@sf7i+tF
zHQ-gs!edd?+jtgy@;C8}r70F32G-WN^NDjraS8CWv|WK-e|e=3^7*`R3y(G*X&-_p
z8z0jXD3-KIT5U$3ZzNm<c~ic`xexB>tcT-9L4f=<HSETZ8dxoG^+)x0(~v7c>TwX;
zk>jUvxBFDisuBf?UE{kh@DfB64LXpjclXlg!SzBCP8QXo8dMyl6hXQtaH#W=irM<0
z6Ov21b7E{2m;Kj+VYOnA8v{e%#3mL+rtZxloJM*M_dAKs|AKI2zO=M(1=#!s2a)uj
z1H!Mzruv&>;wCe#JmfqD{o2nHl>LH}0AKHxmDV(T(9&Y&ob~!LGIwXwRl+rkcba^-
za0POv7PkN7`e(-EMGiRIm&WR+gNNLMu^RJBNX~kn83b+jjIafV8zb$r`Rg|A0Lw;P
z(1QfQDz0doOa)D3p9=-_I^die#7){gZ+s&d%4sR4xId$P9eWTXm&K6uMLat`%B0S7
z19uPQ?%P~M@`AR~eHI9a=-@8`PF#)X@gZ>aV|}O4>JLIgLeKadyU2{dx?6c`@7JRn
zg}N=5$es@<Iqbe&nh^-!u-LJxDiexEZNt#jhw5`K;Yh5wZ3cU>ZN_~SMK6l@>z7qY
zA8^fAo_$0@z{~y=kukG*seQKi_UkIE)D4$(Y`qN$sT}go>)6<(kAJUNr8iu+84A&6
z`1*;gge5~-K+b^629<yQ6&b?$gJP8t)j>ML2u|zNO}pg`t|Zl=Lg_Uv4bHV&A0ii(
zX7-c0UDvAghXd8QEXNt1UIY07(0dA>Im8j+O2dmO?4u9h@F{j_0CIQ4%SuwiP*h8O
zPxxbbU2XXISD@5$plf^Pi)+=&t}@d}Wu_n}&xeTd_uZnajZ~ld_Su4(i2=XGljA<T
z_X6+NOSjK(5yaaP?wZY5D0(|JYvkN@?BpTcQu5vkfz4kByzvddg;pznLe-oZBjJ{Y
zn?wM=JNVo0Kn{HX^@U-!EqMD(5S|#=(^z-BcVh_gs$#IlhFu;Nw%?bPgRR$r!KKhO
zyR)>(bD2#X>i*?x)h>}m^90i8U11I2J!3SR9g$(NIG4*u_pMI6{?Ij%^TM1_h0v)M
z<J%q~W80pfb)7Qu=$KD_aL3^<rm~orSz+^-gt95~3ip_2wAn!&q6hE~UzFZb(XBeT
z6q<Hqz<@jD>!I3J`Oo`EC+5Ra!KIayGmiTVowup(8P4UclRoi8b+>Uc4<M~w)?v}c
z*Y?_~EVp9}uhv&ZWZgqaI?96Y=y@BiJNcVHO{SCDOtwaLX8eYO%QOptB#+XNh_neA
z+wL*_C$>8ucDUo5$xZHPq+4-EZs~(K)l}I#+SkUB;gE8sAb&32LJzYun4Qb0*bIV0
z-VYHeYdVjV40PFzI3D{LE{C-WA>b4R*Q`;myIZ;*RLp9+NLRg!V(Av!&I%k=ZM>ab
zqoKTi3gs}5r1ND)+XP_=kCmVgr*2k%-McT)Uj48L+2cg_?a+&^?D^!kTj<bJQi+%A
zEzMm?l?1oi+6LM7!v}dVO*3FxXm?}0U1C;CVv17jfdLqZ=O!V_uMxgxNiL!O^f-8a
z`auBIZB$r0PJLEj9gU`H%edHkao7mu?NI%&AkW#ZP(;LIge6<GW>M^8ApvO`t%Ucm
z5YoT5a*7=Ca4G~s<Et>^V<y^Kc}XeC&cLm{Q+SKp%XWRvfT((%jP`lpEs7^eO#quB
zyyZKHSQ&y9tU)=y$+RDK$Asy;FP3pe)xFEIc;i4^izbP*Be<W+^H4dt2+Ra!Yp;Zq
z%C7Id8i&GeC+YTiZjpV4*(W}i+K)47<4RtN7FiyWP<b>>4CFiZ_%KuGo@NNGB3+iR
zG3s4RF4Sw5;#;DOrn#4Ndsf~z$0^qPrGhQo&h&@(C~s|oTuO!Jd&VFw8QjCl+`hDR
zeNr_=m!~w**YBBXx)6R$><vdR-sn6XBZ<BFbj!@Bmvm{Vg^J1!%-LWEk32C%2hMV9
z)b_p-;pO+$I>JS7;9g?_G-85QUMg3pHM;Pt8^<D|p)krKtg7{Fw;8!z#nDh|!}>w7
z@imUt%U5mFE=Fd)?`)+>dobMLl~^x}dx=-TbaYhsGY$G0p_XP9TAn-}yUM@1qcvzj
zq)<z?BXx)I;X@7r_61iwdKx*#q>YJ~tpNfyhE4T+GKQRXRbO4oMlW7;GLTCil<X-_
zpJ;xir+ZLxix}hvP=LUWZ(vBTp=Db+B(I`MF_ta<em$c$RkhD`s){Rlldrta7FSS{
z4dzDo#zPAr%rM*TEdpNw6cxa<XFD}k3?0zv=VFXzSz;VZqf$P1y1Ux(ygt$N^UuEK
zo-;5S=s**K8c;Eoo#}|E)kjC-_T)CU-f_q6rb1r=>ZzqEMvOz}EzLd@2X1~l?<~GL
zd42$^HRl2p#Bzj2%+x)Yg1WStGKJkPPrCIX*2g@zvG>~zbcr){7S&$1V-tHXsn0BA
zj0vcWbeaQ35=`w&oNH=~LEXQSZFeL+AHOPd@a%P&>;2DScTZcaa%!{>vLSdy*ve3l
zc5u`_gw08r()VFsnTeg}2LFA-n;-i4Kg3y5D-Q?4%7`ycTWzT@Jq>vDIIp9D0uyx?
zGl3E^=$EP~SmWR^7__R(IL&#tNN1x@Ki8Ak(trn449Xzp6h%#izk@j<K$zF#TGdHv
zrKrUmqJuYt<%M@T=d)eJ*cehv;?HcTkQMn_WAf%i!~M^r1RA?3$Xlj^$S);kBD-CS
zwS6R#j-|^Uk2toIaH`9ZyD~+m`56Ki97xH#V)TJ}UuKv|?>FQ7D@h{#*C^J#;>K=-
z4A@y89%OQa_jsd_w7wiDNXt|V{?f3&xUWPFx+kR8=5cjya>2^J#Hy&ZVnAxD!^>C7
z7N?fZk8AL7bdgP9jR6_!cmD01GN`2{v#_y>Acpz<#VHLx8Cy{i4j19%#n|Dc7X^Y#
zyo4bFAo5<)-bn(qO9zbJZY(cKdWzi6*dW0(ue?1hw|p>5H{P%2waL<$d5AUhjF;4t
z7ONmr_X4ab<^a{*UQb$#DbImAyHH`K45F^7_2tya8hCke9V(1X6D6Es=F|5EJ08K?
zHR^fQk0ERCu@{Xj(U0tOic;Fe<y@(+^N?oOo8r<B=GbQ&6l<?#+Ilg9$$j0YMMF$4
zhAuVXdHVK5X;xFxV_H+9Bk15t^f$KL9*u9WTWSltlBlVG!0+|+eH32Ql?86|d1&@o
z>Bq6k5`?N)Jz%+O^Gt;cW#9HU2k`e(>%a588;lMzpSFhB-}ny7>aPN%Td;TkKoATY
zp(XK}Uw|m2^VE@&&~uC*P@H7b-0-6?u15vz<do$E0do4Fhhs7WD1c0b<Ujua8LoT^
zquyo=*>F2ngFZLxLpplIxM5{Hj=MIpBgb|+OXIAM6$?*kEff>%)0L&MvmT$o1VC6c
zuApItS38E2#DyISYxNhv0H4WxVmZ_K&St7G3D?yS+Lvg=MYA!Iy&<Aax=8vNW`h8g
z=e3!^!BozQ1cg{7)InPee^c4jl&1O~;_Sy>G6PTgo2^1wqOPAX_$)-G$ub-j|DdNa
z^p!yaJZ7k*Y2Jp?p;A;VZm)rS<zR@%?8%HaWh%|$`&zq}Ct+4M5q!66;-WJxm{!0e
z{F7R+QL34@*UuIgC!_p0S0CzP0x5KXfCF&vW`Y*nszt#glx3myKmeOHcDHKa<w)U<
zD)-?lpRW~k%p)9y3hz{B>yfCA&@ycjjQb5#QfLulhh|^V>$0+^k`?F8Z->81dmcc_
z8}I!*1+)W;w&^ZMr6DHJ6i>0i2?Oc+4Rr>Juo)(F>{DF23uM&ADK~a?=#Io2#j6_^
zl}_`5-}x1E`og1n{a4M-<aCRYXdq{<TCTqR4iW<!pS`iY#f}k}MTFJMRCb64i`%8N
zro4kQ!V6Ydb3P?r)~`s&37nl=l*>E2R+}Z1J5eXE_{b1Kgy(}I8zHPBwI*IUW0>*T
zh1bRx8T&sSc?L69<c{_8r@yAHVoT0(W8$mVZ$$cyqHXZOz+o9A1Vd-pv>}e@sPN=P
zfUZY?9Kg&Zik6LV!c$(e_OuO~Swvdqn;pWrXxp5ug-cJ1vwUkyqXs`{f22D5ys7>y
zCTiLY&MAj}m?1U3Me3`P(!W2e{vlCVt$Fs#Cle=)tD^KPJm;uy6ekdWumCyl{N7j$
zf)TcS1A>vL1ib81OD&0rQl<_L*(O%A5bjD;!k4TW7a9|2gmhB;yuB$`#@O)&m+7Ym
z{1eH{VSWSiZ}ZPKi0y8%E0?3X=gcB}Vbh543~E$;-khK0&F8JGW)b`k#iWB>T!=T`
zbvaE8a#@YdFhtHjyT!C}|M!NMq!A?0(pL92&slJ&jB$3a8{5P^qg!1;h!-Dt-B(n=
z3>eZT9Zc4~sSBe$UM#4^>oH!r8XX&iTwPAw@BbFHsHM4S$uCVa;cQ;!1g<4kWhN~}
znMGh7&}91+C<7qZL2qk%z6w<lRH)?x4%J887_h9{<_<BQRgar|GHMiADni3#PnDdy
zX7ZT_P#LxuGtHc4epfhgxr}zoxb~X5icU#3)eZgobS<XxsIR3)826dBiUjA4s;sh_
z(x+tJ3DF>JfZ7lYOlTm422W|+H4Q$4v1ytVM3pf;|D3bRTBGTbKRSNz#sIUx)v~mE
z%u#V{5xQKU#{uGFYo>&lf$4^rdLc{}%K7HmqwZOXcj=r3PDNU7WX2OKab?usE<4S^
z#K{GySk7w^gc8QBv-u0ddSAj&)-HIdnm@l+xzC=rJ_kTG+Zs+|d62gC5`#t3H`NW%
zlm&%sQDSRsIoL^yM0Nd<rT9)+!3;vN#ri<}SC=ir7fzURAT(<J9n_Ri_t&#kHsOXR
zzXyW7Q<KQ^<7kIJY}Q)_YYbcr!~hV($H{=IRUl+pgj<D_n;d^#`0L|pQ&DES{9r7L
zNiUO<*|APTo%(*N_we(L-y2f~E_%OuLfmr~Kj2~vDH|WEMf?*xEri)s7J<i{)=afa
zXM1pG!oGt@41nx{T2B<@XM=#I34#02$%Eh<GJ8mYf4tnP)=nOzzMlp2{ts<7FgE;L
z8?QvXJN64;-tY|r{N9tldev7sJN!rEyTm>Jiz5YWVCp9g)@Hf1A%E@+%fAi&sU;xx
zW?y*#qz3-U+}+!QoxCsjWM;Nw{_M<ek0i@Lo=j}kG0>i=&TpOh-5LnozkUY+6AMJJ
zD-Q}j{yy=~|9U&JjAGnd81U9_fDuxjih}L(Be2Zlz(c2SXMj*PiOk^1<bH(!t?7LS
z0YmN5)^J3pjVE`?A4j|3g9m`Ekj?(oQX!CDII%ZaovHS3A9lh3JJe-6z&>NjPbRip
z`=s}fNu<DUpO(P_K$A=<z$n|tei~&AZuO9E{|gQgwjqit5v8(&({u9nZO&B>IP=XI
zx}9-jlf4gT5g;sh?QK}{SFdCKTmzOaDu7Hk8^-Vo#$;NFY-TBx?&E+InZ|~BCjsKY
zVYZ{^6E=~K8d`e_gXIZdJrw_~$H3J1S2Pzt{&R)2PgcW;F`{iu%6wt%%94=^7cQQQ
z7gCU$r+pz2tr$DEz>5S?t#tDD*pHhf%ix93R88=4^*O^BPh?nz*l-zy-q@CU#MIWC
zVJMR*#?F$q`?!^Wa!BD8^UPCHpoZZK1+x^bzmG2rlY^F=MKs=2zk|6p17@|Q9kJi1
zSz|1<dv0g^^-HX#L&N%l<)UO<xt4k-TiA`^p8ZSeA!Xn((dmwMs!;H0MV*-`V!J!`
z)sJ&v?m6G;Hrl>qS@n+BK9jr&?Q8!WnxTJIOQwHB9v1;%@d6;cFsGigzL!z(_BsJw
z%vA#+B)nP&rJOCHo+OqioD@u{C0wBB)9{o&Emm^ZWkdZ~@*A{g|NcNdov(OF<mz0L
zaPEYix9>c!S3$05qSL&E-ov}ehrFjST`U)YoQx?(@-;MRPBye&a!q#FkjbC=eNE|r
zBV|vCs`OU3(vZxSL>Uym<updhvRD@dypIH)dIemvhUspRg!=41K?Bw3<`jdxWs~6Q
zNMXSljZY<$3KuzzIj@BBg`U2bX87Kh50w|OJ2kE_*AeN-ac+C~+R(*XsYKcS@y^7`
zo5UHTS0%;HaL0Ub%?4N_S&wypdUR-)@JCO;G_}M6dHZ?z@ay}ZSa;yzrZn|vas%(g
zIR4M-H+B@^FW3*q8Sp#A$FKHC$5TM%xSUwYVeFA%`z1&q#1;|OK(EXPt!!k(GYm>K
zaI6{}^rhcAI${e~jIs)%V3&Es-E{~09KCzs&eRsHpdM7)gxlI6Ge<N73mLYo1r!Cw
zloQ|QB=$TO)tZBx^1V@t$(kh^^tD0XHeuVi{DqLAD10EYE|~Fs4db@c#1)QDtfpGj
zPdJvEi@>w>5rr#jb7rJaQSI1v0j(GlwI|mmy4MAf3{@rJm)UWshmNN%FV>N|0B#9@
z0^iPZ0`@$}E|8B{Py-g$;^b+}&Dkvq3@H$)3tkv9AK0S`zjP43ck|MISGG+F{O-+)
z&GC2%{&4Ik>Sw3f%<7=p!Tto;hbX|4Zg#TZplYf%!HQSe&Q}iPRK@Jcy>sI1U)(f#
zZhy9W=SiSUOn0$Ge^3*U#r+2_FrCyu?yq30ERRV7@-S;Uy&C|1w8X4Jm+01w4OpJm
zzJ5irMdjU3cM{K%JNAR}5)Imi0PTuX&;d;pQzL}zo|)Z-Ckm+(xpT)V-jcnq!$pzT
zgzogk@f;$T)8ZLEV88Jb@2mlvf3krA=L_smr{a}}t3Nr)rWF|MC+LnSN4lF0D3{hV
zg<H;?S`ik57o9Jzw^g(TtDtYiOK^9^OT4O_<RUrJJ~qUD2gRN2u75lS*nfYGs>;b0
zZMK8I1|Dlz!bYBK(!b`G&Hv<B1iF{NW>5NK2Zr?=(!=b5py;*`un8Lh8yyfC6_got
z!ju9#qZwY$DgR_YFTle(v;G$v{dvZmG<W_4hYFcL@e%%P>Cf@GeR8n>=%V^Q^6)$8
z+{uyktABs9niC)4q?eF#peGD~m+)5yfA7wZbM&M=ogZB}aXS8ssqk+2*&6)E@SPmV
zzs&QuG5mRQ{V$H2``aa8GWXszjKNN(EB(ZW{kar5&D!99EEN^F0UkKaPCAeW%mwno
zHvS^)kC{|#hywpwMoK2f+9#%=zK{4ZZh769;$IW_+ebiqE*p>^Ci0_Agy?L?PkYSz
z?e7V{HUJs969WNG$P)wc{i`APpPzU|_5b3{+TXx;fK2&GHW!Q6Uts&;@BK7v8DD^q
z<_|L_*bxPABcnW5FaQf#8-(rwc$sG%GE%UE-@={M@~OYE*&!@|ExQE?8}wWFnNdD*
zM*eyL>>*ZvP;aau3{r9c>xPw&Yge-4K1DAvW8Hy0YaC0)f-!sz8}Grt=r%2{c<(DT
zv+OJUYHV5NbG^cSj2zEajr???lF3jtJL?(9_W?}UN77A=LjMoIG7QM-Ov0$RSaZWy
zfUFG_bpD3RovJ<NT-|<6ItAu;ev}vRe+ol^LUYc%Cw=C*{6pw&MFtI)yjqBR%G@zX
zPPMZ#bPg?karu$=%m<t*qzH8N)7?$yvV^~CfPbky-6oRKo4lG{fq3vydndO{BL7=w
zBjr3RDE7}3v*0z=m@OdFw}OY@--52)i23w5e+y4o_g^xO{$eWCf2dofN#sTU;)Hi}
zs<o{ybrD>|=>}8)hXIwPlqcCfCp5T@6EeXIQyfU(eugpvt@Q<PR?QviX@rzKqNmK>
z{WG!DOSE20P$I8Jbw`y5uY$&Fzk>foUTFU#ap>Pyd_Z_E6Cl`J+TsCQJUXcgcag7o
z8;4&81C`j4P2mLV8W5l=`y}~?Yg+H#dN!3u?--05Jq_f}9{4B!humrcP%|EU6QJ1K
zhKRR;E)(#AByMUYL~U;4>%s=6rndJofmF!LM(%1_C^pPxXE)#WcYfMGzE2IWN0H;h
zfb!@yV6nV91<EIs>r!GGADr9$4w8>Kp?9_Ajn|atj}Q1;_7r2esz-PDgQW4ZDf$9X
zs;w5?gd5^Keu@(Z%!1A-sI+pn7IsN72lDuuz(Cy5Gh(1>{^q<EmP@weS;ua!;v;_9
zH}{UBbuX;&Mx;j@Du>a7KK@1~Y6P0PFsVRtSbDe%?l~0C6LCK$MAJCuOxovq{*>$^
z3_A!&9={$zOn?*a{+>Y%*hw^VBs`jj{V1dEhL;s!LVLDPgmnkjSv2t;Kwa>Kzz1i<
z-xH1u>itm^t#teSH>m0$fP5(e{o;(h@CoY(=k__q!FuSU7ef1*DT9u1c7HFUe)UY1
zlt{1McjDXoT}Ai_|1QzwpZ0SBs2U$%nEnnbaXVa+rp=OX1_&#$pXFbkA4yk0nBglA
zk3ctWRtLT{GO3zrAQ(U^;nOWo=y(b6C@y^RkD~EJi02FV{YL*V68O1a<`Y04c!uaf
z<n<TYVxTk31e<ogzlz9DQuV)O=(EH)#Q+<E-Jtq`SNP44a_+LKouLydmTQ!gSGqI@
z2?41Z%J3mSi?Evai9gH36`~O?rgdW0+s5NB!xLTf6oO&lc+o4po<tefNYt-{-O2lA
z5kQli9#wVm(<9A!fMfRWq@ZWdzq$Mt)c;7E8`d#^#n}=t=uvFb5-gMI0(;*<ZYiU@
zB0=xtQ*l4ZgF$(PC9j(0b=KW(`~-c3D(9#|lCyr<)d}X~m!k47vpT^leAGR#y5lDg
zegis@gCqANJO$%E*^z!JBR8l4AQvP(g<(sdQ8)ieVQQCKjT^gf)mFT+1r^d8yA)pH
zzvHGe5ESSa;wOGAhIu!qjh<Vf-GYi*OlI*|NC^nYA4ZAEaj1ZHm;I?)9ZT0(9CH)j
z4=)TKZ7cfjQ1z(RcdX<^iUhOXh__(|l5Lf3FluCYt%IK%dEng#?zA)m^Ky`Bzc&9@
zSXcBpj6>t4(0u)gnWqy5iX;!o0!S8h;#)0w{T$Hf+?~5!?$t&niM|0wa04!KtBhM>
zO2odh!AAENbm@<5>&&oJpSGbcR9=GcOkx+H0%ZV-Z1skPZfpsA97?k!GJL3iq3T5A
zGMjk$v_8id!Sfzk$1hnI$?PIUZ_`Wq6LKLM4Jw0bsgTf}wlSBdSXt^+!>`W7W#Y=Z
zl-^ss=9dGsI2&2<fo;|wQqD>sZ|P_|<RVx6dh&C^^JE5j(`zJGVO03$2HIK^#fo|c
zv{$fa@~hk1e2MRzS?JS9%-Juh^sq>yhe~sLGS`^Kgg?b~%ODghHqkPe(bpEiS#Alu
zu5O*kp{;N{G3M#9qVGBQw9WeQjFP4Cu&*k05}*xKTAUoTMa29dPH+0z^=R-!u6O5p
z_aO%?XVv)rLObG(akqn~9Z#FoolNyujV?ojI}&Gs^_TgM$0CIOgw#PdL5rOdwCY2k
za{8y}u4_QH-%+Le?k;%#=#FHx<1MB=h#3$M+5=<&kAzWqcvW{m&keRKfHXrPu@S})
zTrF&Q2+8%gqG%+>5P!7@jGu(;I@~6yJ88*V4Zv7(y@X7g9nm0Vks7^_c{)-o8Q`x-
z5fuMc{7>|#jlI({;mU<o3K_PTE84S+$2WK|?AU2o$y6`iqA=S<h$u#@cp20s-8+iW
zHmPZ0_5~_{6=1g-atPI99awMT8<5{7npw&06zlIjz~;YIQ+{22Q&i=BfBSNhZ{0+d
z^r|c;$zYbs&~|nQd(d{;vFAyF@Mj^N_W~P<Tg)7thcMu1=tEp%Sg=D6Pe;d}&ccMu
z3_WtCw;u{#T3PJn`Fj5CkXNF2NTFc`U5C4iL}={YmzOSOgcv<KeZZi88BG#28zV0b
zr?58|D-X^|5E16roOyUzKLFZ&K~R-6gNh_T`WLq8d|{Ex{XRwMoSq^K{B~u3*_u<X
zNov)d(>&x&hQ9IC1&Lhb8Jefcvf}uzCGu0o5*Uzj1@#84s8GF*Jpc1J`tTVxOBJjr
zI_pA-f!rTd?k>O-Z}JRqZRfzsl-{1<XX`Vfvwsg!5b-8YSqJFWi^~u+7$4KbBMLIT
z@<FQs0SA-vigbPlpWx%Z>(ue_qMnX4-*n62)V9hTv12aOKrbvzza+kw9_%`uID2nB
zf-J6Dt!XTackZbQ>+T5##E@l1G+db){q+k#j(GpdMnA^kc9Pa0)5k=}xoz?%aSyNE
z9_c)MF6cvdKmC84Q2Bc@rM9G{)n!JMb(xbZc6g)6VZZQ7L-$1eIfM^Iv~$m`5u`3A
z`8$Yr2>{Ply5Kkymhj8~-*L=L!?EvoP#=W~XDWc85EjLeK@JswYsCq4HZchwg21K&
z00-%TJ{9&3tW;UUE^x(|-}(-+%fho7n;kL2w!Hw{`LOmikUJRF-w$|pr2vk+0hbHM
z*xA9Bfjd>#6n@~olGSQTq4C2WNld~N>V_4SzXQA4Ir>+tdXF{k#9v?k^0(HcU@cm}
z9pG{g{?>QUe#**nQRqK^I6c9qzkdWWlam9u!8QOI8FqZrWA`?x`2W@3{mU;PDR|)_
z7f3>LnOL0&b+4VjBF;K`*NXco78uute>SfFa?Ahf#QysQ{yhT!9)W+4z`sY}|MwAq
zE_J}d>m_=nsmQUC7zdY{wn_P8mwn&kSx)VJi#9h%muo2F#2NFQ>bbX@j%OFK{P=Uj
zyBN{EsWE}$vzu#PM^xBz;uBANSdws$9>`1+`q*$3l!TJF!!M050<Og;K?@$HhkjK5
z?4;FF#qgm?O;u%*k5&DOAnSU85FP9tsw;X}eZXS^pZ4d13boYpqI<A>6_Xe7{U3o!
zGgb2izd+*Wg-+Z~?Wz-QmG#hMbL0LaAke2LH>7=}*7HyOl1Hik+;K6xfQ8}Scpw6f
za+7l=mI2oXng3)IVr#3|aKXa7|BRROj-Q(NRwHTezj6+{;xA$PW+22ElU7bXBjs<t
zvisWQS0XIN_q!P7@Gioo>7$2NJet}#iBJBF6>8Fg=d)98_SM{PC~1kXp4gXXl~;BV
zc8jSx4BTt{4D$M?&K5nv_d%d^;)1?W>{p`aBey|6qdNEkd^Kzt@<Z|^IJ`+;-Vz8_
zsN%GD*M5_a`LCs8W&yn+s$9q}`w7y0d=}!Z2&>k>Kgl{Etr4vt^sm*Emg!>>4V(zO
z=Lc)qIRHJoLL0Ef)wG<)g?K0V6tjbU*;kW3{<U-pV6tnw{DUQn4~XMvkI5)cTj@#Z
zP1z#w-m;5;63o98%z~eDnYlB$wnNn)z@7Kj%Gt8q&(HtGchLDfNo&7qI=r7fKprR%
zaEY?<_Nf}@M#8g~sCFik|C1`664PT%IUQhdGIl|cIkBW5Po;o7$@6SHM1+GGK<2e*
zL*vWou^@ZA6~fyZq)~c3%f1GraLNu49zt~t<_qjd|6^7=QX7{xDBk1Ab^rB9?L3}6
zuCqTXCVmA&Z~TfoB;PXhkXIA*iv?iiuV_^Wc?Y{MetEp~<U7cL0^XCO_~q@{@UQU8
zBRt!nScutz3eEhr=IMrmI%UM%q4%Kl-`MO((@KsXfQNYwf5brV`Q@0k$^i8+zk;DB
z5y2aDAkCNn&i2=T)lcMr)Ck48IRWm+Wk{a>tjH^-T^_EJ!jh!n?5pvb0=&JTAF<XK
zfAJxnJwrt8dhItA7a&--M0e14*AMW&U(Lq+83-MeK7TVnF$k#&#0!Uj$iB)MeJ&oK
ztr#B<r>R?rr9Fq!^YXOBgaM~{z&C6T2g%!F7uPfa%E^oVYZo|c0&tWRoL6yKmYXEk
zfOy~qBHGhU^a<xP9)M`Y2*33oexA^SAE@B<PT2dB!O$d>Fk(sVfuecR6c_#__{&LT
zbo9(|2@M|Ah?7)LKzvx8iiPZ61V(4~@}VN=()0dY6Qh^T?RuVqSNsFBlAzp1*9m%o
zf*p#7fKnGwc(Nz;@wd{N9|2@Rjn{T2gdl==?Q5KQ*kejt0-l%!*Ki5#L*9%=FKLBK
zD!FpZ3SupCoy<x}a*79#up0}!aWv%A>_G>q$CE96>gH2#)`{&w7uGK3i^b~su<QO%
zZ&H|nzqzfwXuD%rdtG}L5_b~Ot5ls}Lpehd*dDBJV32>PFulNy(j#uEud2`kYEms=
zl}1D-uviJlF5I^6%|8Gl>wVb<xKVC6yJrE|77A!K`owO860W4}0JpgzDFVjdMSEWV
z2-fE8xF7VHpiZiTWSjkWtzgxzkbAvA7=7fg@TlU4<LeFKj(_k?{^B^z7P~>fF9Y&n
z1w}>*t%;7(O&elGU>uY8?VlBnQH5q2Z6>_$zPPh#Vtakdph<9>uKY##zSv=#RKTH3
zBu*ETbxdt{5GA}6@@!?8eS=2CLLiM0?CewI?}yo%A&tdz-kQ5VFj1uUOvHkCmM0_c
zElTo>V9w1<{wE<CZ|Pn9)5DP8K_*y0LtBNVU30m9G7p@0_{s6aif)S=MX_gqmK6x@
zGX<6RVAN`La~!fyRT$EAHZHv&r5HfeAW+g;S9<rrH1^^vDONrU{+fz{=T|@ZoCm_&
z<nhFQ%nhViL62o&K1sh^MHUg7{j#vMn4+pvJB@^jl-j&)juJ(;^cG5QLXsKIWv7|x
zjzAocOq(b~SeeOVA_vgD(k$8{T4G0XSGCz}0KFIE@4wv5pMzvO|HYz`toA`rUA=Q&
zK3Px)a$&DBR*}YY&OIx&PX9H&y*Nrc%ESNRviWgHz4fOs0UsC>JGpxo6gG`L;?Gf<
z_bQ&?9oM`VDnmqW36|ptaL-tZUHXRN;b~s*T)83^9|@OA^>H`5g@e%hRw$4e#1iyp
zBl-6#_m=PV?V`zrI_&$aD{BJvzU~TDc@#N+Vl1mKPbk{t_NA8T=42=Q5J<4B?cJL;
zK6)xjuwLPvTinVsNOP5vx>+E#8VbUSpKQCxZyDm>-=8DB?a;kzv#^V+J3AaRI3RyP
zS=rYoV(fxH4>XzM40)bm9TCkS&Eg(Xu(rN#(8Xr3oGe1bdDF@+C&f^dH(vhRm(AA1
zhkzA!DSj=ow*{&P0O7xRcum731iG`8(v6(C*L^nMLhyF<yDWa><d@+?M2-1s)j;%E
zdB4@<uTXm5U+Q(z6iRxQJ}97ir`M3CSdbaPH+MGc%^mln#e@t}HWk~!$1|mSiZI0W
zkZ<**Aj$xbT;QAo>d{mnlSJSFsVBTZF&g+DZ22y*{;2w3Au8{Z<sj?3OPGv0pXP>b
zJ|JGQj|M=k#<fAe%SxFx%$Ob0mcfpJ1=m;fGdjeu!b*w_d;lopz?Ri&C+m1rzJs3K
z0HZ{4r+Z1-egq+Z?x?I|9JsHsnbl*LgL9$FuIf5dMc$jKvjtB;H?OmUw>oeJwQ6Ik
z4C^;E*nptjHYC9_PAig3{q-8BENbWl2lwOJbQJ}9Cqf<`cd+HS^iEO?o(CFr*V5Wa
zcEl-d&Wh*_7rGlaw<!s?4{AM18DC>6UP4R&1=i)rOR?^L1><VUjvuRz9tN5yg*>7s
z9A-G|J0`;lVJzpUMoTs8(Kf*zF%MULKCAMkY&Vld7#Yko63<`$MoFsp7}=MC?ZmzC
zKkqO_j3=|hgV2V}Qykg_WA`Sn8w|G`P|%%Ov{B(r>egvu`2yN|rS66bx^4z&tsukw
ziJ`_ubWO^9y-BT)FZn2Faw0qgwyo|~(&~d9;vwI_Ejk#;-1;OfF4Co52BX`YVgQ#(
zR%{j){K_drZE}b4)3{zJaS)Rn#Ji4aIuC#kf}v4!q!AE1sz_r)EKg;1QM9*mR90=2
z)V{a9TwKP?b3wj@L7Co1RS&#p>+Op%UT6ZyblRn<r-+tIDVTVZ2qUQ$Yq|Odp206@
zTuMLjbhBa1YI<$~3{8Fl09>OrovoRZ3)6&lxiWy2pN<lini@5}cClnlfcd<L-qTZ3
zjWNXqjA{=Gq5QRLcvhx4^$;mQPYtVvNqS`~lR=7hnn*7-8Ts~2^X-aVK2V@qTPe&%
z{gH|5I*nd5I^}>W8baYxFNi%ggl9AE6c*jPFCsT1v7qm4e&(V*t~r^SWRA-w_AA;9
z=qkA{(SS!0+g0@N`f-slX0ho(;HH8T<Ln}fh(&XGtE>iIHR7eqw|fLz(a)&z>Un)#
z0ashN+bjSmG4U|r&~2UVIM%*X_th#v3U_Jny&mOzxP<y6LjsNVg|&FY&p_M{LW}Ru
zpvNWG>b_eY_U23|8ohUI(bU$9ski#BWb51gh4#G<62%6@6^Bo_E8XruH(T0ZL=d~R
zo>&yrMF*`OtZ12iEq7I2vr^V8#qVpeDtjo=VG85jVO|fu($3oxkaoW-cX6*_4`JXH
z<uj=EQgfe+njAUxMOH(SlWb4URq>zBRv5i|L7!J-k(n@)iv>)FwM4TuBTA4FwSdNv
zDrzc%bBIHJx;XmVx6ujJi~GwIBOmlExgJh!&s!0u>}p5ASQS-g>MWbg$nY%7L)CdP
zzSe}=L|%^+FZqR}*P3T%Ot+IIu)jUG-OBk0<id{WM%quYd<R*A>FxX(P`P!C<rEdk
zwqs61$!-jD+7xZ2AB(T*dSrs+t%zLxC}r^%FkWr`q?j7i)c(`{UA8S6J7eWIk%%Ir
z6;$$8(M+;dn;Sdf;<Jm<SD*SnAiXj|_yJYfE*infjw#N@a$x3iR$R@Xxnr|S*9Lcu
z1dchn$3zY{<|CIR)XxcgqMXg9zLc`)iG;(L%E7Uw(ijfZc=Kb{gvB7rbm{s`AF207
zCLNy6rCNM*{EIHh3Fl(@zD<b>oONI@xsS_)*uui_m--bI-Y)x7U>qp3To0=2(h_OS
zOzmk3wJ2&O33zyY2qhB;LrrVkM*w!dsqjLGgJ=vVPksMpQCYe{Ps^Ik6JE;117V8X
zQ6h<Fw3lOAhz0DXdr1wCAy`wiS?gmoETo=m<#CElWbKLUiH#Y|rl!kU&U1>r_pm{Z
zoZ!$zAOQNMZxKw3m+<eKBK2VQ=Z7AspqfxGWD|R*jP8D$=ze3;<Sy9C@z7I)<Hh^V
zGw>_1R~yKDWzl46=!OlpH!H^X+d?x7rg*E_4_u`T4kU|G3$@ugPiX|+&kX0K+(U~-
zVVV5qkfXrG^tyHkUifRhuyLW`r7y^W@muThs+Vf<S4%s6o6b=bw>bx|%ku<kkbVOL
ztSIw~FdOY79GVm#*Jfs8*w#R6Ii$?x`w*9o^_iKV(skmT^mCrw)GV}#D2(^f08o=c
z0-I!F++K5TD=Ej<1C)7iaM-;4iAaz&A%LIlUF(C`O)=fYK(3+q+P;Ir))g;TCq?Z>
z(cio*d2U=2l3KBN(UMLb{%pSsnO;u`-7>)l&%vT)G6XPQb8NfASnId;GKQ?qLGGR|
z!e#N)u_d5aq3wFnfv35KJ%JPF_DK~B1mjeMF=;l&)fi)T)H7zk9Nfqt>lEIIeytVp
zphe=c1Oz%I3Q!O3nuSAH6#d-M&fupF#AS7tc3K&$p<ks<aOR7QGBTS@mT)WPcugx_
zY68$HDjv7H{w%&$nDip7>kys{tJYigSz_*LpT%IzmvqI_4%h7)#bME%42d!n2OM5P
zrzBd4Q2vtr_1wPfxExQHm`kKVTUeJFB+ClpK2x!s3FrRD&EB`|le#6FF>&f#(X@}$
zK#t(RqmHOr?PF_bPb;TLZ%3H36)GXV=xMS|$|PfzF73BVz8UWMBKnW$sjGPDRM^#<
zAhf>LQ5_JrT5*(1%b4faQFMEer~8|==USAhXA@69dpjPQXp~k!OTxfJ4F4oFb`dXw
zRRLT|K@743&stK}>w7<|<<0112XBA4)8cyrCR&p&X3<*pot6y3X+|z*1w_d~DE8V6
z4mPJawx8sg+wm4Ur(09%@RF0p-HHG6^UL=r(3Lj#-mE*sV2DqU;Y<5Z0KTEmTGy-k
z%WwMVp(Tvle8|S7qM#w%&(55B&i1^;gD3M9<-xw@P`x-NY(_iG6A_`iQaR?inB*WF
zGblNs{pQwP>x|tmnX+-QI;m;HU-h>U>rt~&RrU0?FiOt`DhF1Qs_C`Uj!4}*#ffA5
z&~7fVPt&}aft!b#jXX*Pt3UNj&;LOX@ZbG9i|2=R$qz#|#=nEqbAY>LC}chh>Vltw
z>|QZ^<$D9j5V^mDjaTB~*8#v0Ijl<!HHE8(Er-6M@<2YX^_+u6_*0`fzQm6ei_tBr
zEKX9T@E<p9_vA18H6aTfy6Q!t5In6JrS#rw=Y|17EzV1|uy(|=&I9Hx6)<GX*8r31
z=Sh)}n`@onrFV@HWt|)g0+_Sc%&hFh%*O2!d+jU14z*V~J!<r?Kpve60QKCu<TLyk
zaS99GPp$I3?~ACZ;1_z})2R+*kWkdFN?n^mtJgt7Vdy06`|qH4vfyJr`!&2^U#-0J
z&Z=a-6<ftAN%$R20`(edp=Qr?msvCTZ2V4>x5wlC_gUfdRm#R6i=u<S<wS6~wyBVo
zQaZpdeH5A%la^;p7tL88DB1iX_#yI9{`;=u&&b4@`tBn`<>c4(z9>Y;>CYI{aI2O;
zuV={gVN``|hXH$BWxZa>(}Tzip{dLawwH-MUPe4_3D)vNoYRqGG0@LGg$Lq?*1nS0
z3q5?42JR0SL*j(#bxhb#Xx~Xcnb9@a)cJJOU#LS{hqbvdVvH}$MN>eoH;5UvTSQ+t
z|8lyDEp;&7VH&8kZGzD?*lrQ7nO;Cc+Fe-f+*eW}O0SlFwI1o3@8F+XWR&lYYeJ4h
z!7&F(xFNj$VFIB0SO(0l>TJ(3B?8A68lVhECv6C$ko(@lwMr=1EdQG~+WEN=41Hfk
zXdW6_JmrIb`tTh3IK!aQG32t*2tn7JTK9fF$}|f#)HCZ87N&U3-6?-n!Y;AegVihj
z%}qtyo`gWz2h>32|4X0gltY_2XN37%Sd&IQ&6vFbdO{T!8t<5J<sByVPP|OhoZu=m
zXDgv;+p#s)8(rB<IIT^F5!oMZ*@h0^_AyC+yiKEc$x&QNu-_5(EbV4(5)rXlW7o$3
zZ*>3<Glpn1qpNjyM|G9OxHOvzRtA5gP%tZD)a|AX(Bd+D=9(>YhUlFJ(J3{v7?>k0
z2tkGC23BEGL<*k5rlkUXlS|9|+`ZZrvNq!P!0qFmz&(*hISUPa{(5qhdU)BmHn2LH
znJ#s-uDOI?IhJs^Qsh)o@$?;EWtCn<^f-bqc9Gz5DedP{zEGiIUz)tTX0Rshdalnt
zF6`TPm!D}9UJ4c0+84g0w2~21Jo-q!iKh<a=Y<m8Pr<kytB90R1>ZTo+0e^ku-&a2
z;<U+QaFK9^^O{fs7k2cH@&gIU#fW1!tlZ$H=NUzg8KAzmQmuc{R^aPy4A-}n)l~@?
z)Y_o^wBoDjpx#K-)@V~9fCzS?8YAA4$$6dKBck42+H+_A=|<XcFy<`|W>qJRKj+_#
zU@k*aL)GupYx1JnT2T}AD{7Q9%vH_#l#SQ8ZWBsc1SkdJ&t5@`tW%xw<qe%O2)a2a
zYEeCyT^W){HlqEp0<A&G7pHl#&l0pQkY+jM4~91EJLA&vH1=RRsTe|C%#%#}N(ZtL
zd$)VSd!Gl->JvTQ(G;>C7T^luVsr%Egn~CZiY72g>Ntd=I?QU!=}W;IRWIR!CBNF|
zMTIeRR)jAE?B>dWz(SLz)Hnt<qYoY0AJS?dvt_NF8hcw%N18UY!MV2*s*!VBn?-JQ
zkYHCf7~(h;YRZd#7&kouQ$v#my3}5#UvZk{fUMu1a^Vtqey)p4p^HGXkvD)+gP|X*
zk1J57^JPKfl3IE=KYQ6c@ynCRtrR+2_f|y_MJVQXJkt2_ZN4U-$~+n^x`Cd9kYFv#
zG3L`#!6|il5x%;xw=9L<L8TA1BDf><^ogUbULGj7AHH`DM%3IlY%jXh4FHt_;n;Jf
zU%6s8xifh~cvU`Hg_K{QsYr`1$hY3*qEP{>ts*LHnm6cX_>$V4%(RAzq_lAQW#O6e
zLwq$mt&gs=w?Ax*Nt95X$Vf8~z{=(|@}Vb?fq5SWg*T87#Z-%KIu@_cmQ*x%D`>EH
zG%V~W)}<dfE!LLe&qe_uc{1QiurCRe6|FEVnEOv0QHEy-;xcNL6RAaBR*#l3HcL}S
zSqjH92U@bpL_4(uC=WlnY0+`r>8V!jh{Oi6vb%d)4mi#Gg(65{#VD<>`ZgqtqKoEV
z?`A>=WyFU;I5)EtSlK<DYsYTBB-_vU&sk4fE*SAP9+9Jjc1r^OF6aIq(Ov)l{$E)W
z)A9tDdaUQ)lL9|cBnSpT4V(j6W-znst9UYdW$L7v&={XtX#J3r^1%G)W+J5QNfIpy
zZryTzw8cGrg7}Ho#<jN{uYB)e6yAMO)`DO(+<{doY<{cp=m=m93~r!tbgXAve%!CM
z(220`8oMQ_7?#_zW@h&M&aKFus-43ZDQ_}?P-|-g2&%Pie5=wS7Z)jP((^el{bGjp
zGabkfQ}-4`RyBGqW!_`Frwr0~o~5#j3d?5_D}GR-&T+|50qruUlu<R?HCH+WD_=Js
zpZ~n??sD)N?)A}<;viIhw{z{@RLh2kJzf~2>&)g_hM!mh5Fti%2-TG>{n)5|ntGsG
zU`0ZJ3~OZK1d;NqG?Vx51(W-8`>NxcfFYr3g^hqmr|gf_kJy<^UD6kTwR&%*(z$&l
zZ7CzLJ_dOjP?|iUQzV2GH_Tl44thB?rij>U*xp#!1kQN+hMhsrjtU=Nw_Wva80r(O
zOaMo3hRweFgJgMlzX=77_HcqUj)|1J<4W_#VRna=KIbZTyvl2kn{kovzH&nq=ag=G
zA<7ThP0S*I%fW?N@M-OZl}ez3cqhqDp|&8(!_+#4**vbAV5?nd%$Mm{8)`FS*bF8W
zh+Wu0?ul+tr8-98b60AvkRc~Lcd<Jv;8zUozA9*26eM`7_Lh_X_&!AFzyw=2Y4rv?
zIX2S1zN;jDKV8+0_A`qiP(v97Bl9JlL5|7J4iyv%!}l5C;5dMLcuGdAaB*}1uPl4{
zJIJ2{r?9asuY3VY)nZnf)K(;P*8#jS!Kn?w^VK^herPKZ!1_8T<FVsMkH>q_D+mVV
z(?HSFLAb9vx?0!<FTe=4Jic(ORC%PG5@83xwJ(4Z!!TJ2HSV7UntKAl48B)p!IZwv
zNdVL)0=Qs|D-ZhjIN@U!c*fMfgM?3ME^^_S+b2&tm(xInHCA++Q2^6LnHBq$e#QZz
zcS)Bdp^k%!ckY!+r1uPM%#s?)8i2=)5l(*xMGtWhwt*k^?p?&iLW+%)r})p`XprpS
zNvjRUj_l9neF39J0Q3(GM=^D%4ftF0-k|SaF)`*wlsx|FUZ)_O65_XPQ8HIQe)O)G
zmc+2L!;Wx*B<28}68sZF_r|L;wSVauZO{Q|do}Fm6P}(WS<gF=3Bp62-w1n7QWt>0
zd$Qj)+wN@4GeiwHc#E8B;D<ubpAmeW`I}fllL>!wK*C7sN7iH@`VPryy+A)`9xV^C
z-U3_~N4f_Y$UpTrovXhQW&Mce1JV7Qv-yNT_%Q^CA8GIG<utb)RKaewtZi)^9_jr|
ze-PFC;<C-xDTz7%QQjv8(AA(qorLTwnnuUbrjYc1C}qU@XPiD^f>I|EVHpW>Vvt3M
zqGh%Y0$i5vlf=FLW-qi~@G|&u!I$l`TT9G0T%V8%kTNg`s*$DK_@LS~CLs4#ybhyt
z_<Z^N<B0$gdJphYo!5J)Y0vFPZ-lOTQ@vzh-UyUD8a#kerSOrA9r$o&W^q}LK9$FY
zJi6Ep-{BA?Ff3l8H`IXy@16EvkJE6EzQBc-2l<!Ztd)Lup2%2o={Oj&RF-CdYST^Z
zSCeQNj72}>V0dVvQ1i$D$|*sjVa)??FEChn`4dYCgfZpyiW{dX^WM|v|H-0+;IWS>
zSXtY9MQp=7%G|gK$a-P)JpLz1B&oMKv0v9zXrGcj16f0YY!3B4L_+o+#Y}V)b_}op
z31U&*GkyWtHb~t+(o7opr(F2{RMg7qOf6yL%!)faVd}bbnwKW<f}oCKBZ&6_X;scn
zYV{lN=2L9`NlNmUz*%%7v_-UD6(<HsKe5vix&td7+|1LXhj1Z?+t&tmAU=GOObe;~
z<Qi3r*u+kCOBKSMT~`gX-C`Pk<Xr)hwRiV?aWD1{ATzj2tv@rN^#55_D>8^}Dg>uJ
z03@gNGEafFy_V~GhI?UgYdWQj3aLdPA#uy+jU1#8E*KcyHfPV@m&?`pp~%((zViz4
zsc#VpeSv6&@!SSL^v*%mveVySf---Y;0c0$LDWtU_`NuwY2_%sOMV6$0{m3zbppx#
zvv9XaYx(=V3(Rl!<qF(bIDEUZ$(ZH3W9BnvRJRT(lX)URf#+{j@dcjSd-#RKn^NMD
zAL%wpqLCi*Ipx&{OBscJ+PfSL5>|<8pPCQtdCaOmv`Y@Af9O)`S$NuZt)A{6iw8IG
z^d~u4>z|oPorR7uee4yRpD9YM$JRW!X-GQv9~k>yBE4VKT0f>7kgWSj>E<r+v_wor
zNplr;G&u;$Ng%j;C=fU`vx4_eVE9Wvi{Sc?yyQ>nJFkmMR6N_##{$3=Xrga-q@Dqj
z+8Wo$q*Ff>lieSvh7lIdjAs~6&vMYd&<RTa77yx}llDj8+rW$-NJ6aekd#SkS?uE>
zzAEu~mot2I)j~9brz{^(`GT+9Bsd!Cj1^lweell21f?FTs7luK_HKtnr`RZmDs$7a
zMu+{OnE|e_mOER>ui#FstZC0VE^HS*VG*c<KA4`62d}Rm#MXwy7)5NfNcq5w?ZzMS
z=*}Y6iKnL+fE3Ym&D6TkC>yWi#F;Oed<5+AurL>f!yL5XzB{G}6{yLNHh8v?djVum
zO~{vP!c4)hd|3-bXeq$0*@P_FLt@TvzJ(*Gps>%ngZCM3cr5EacJDEVd+%_-@Mjs&
zS$ec4D;2CaV+v6E8)Gvc<3bHYnodJDskHA^0E&LMvFx}cWwvhAc#Ajo&eZtCT8eed
zMqljRaJ$?}bw|dC*xtJvER9_qx*0)u7886f92*ZnNB6eCr?(ys*3&~pb*k>hn-tOA
zOc-L$3gqf>V&Og)VIXxcgMt1$JBXBF*+}}WRp|^Hd=x0Vl-d5wF@#WPFKm`dQQ1`K
z)Sse#r>&YuIQaClZ|Q8!c%2}ArzJi!a`vN<@TLmatj0*eD<OcPBv7?!qr+_U-te4F
z8`a?jf8ja21rUony1iE@_+kBOmiuB)xIh1pM>nR>W6dC$li^X*Gx9|9*t?ul*S9~E
zgQ-_(nd-pS(co&0hf0uY4Z{32g#A8*ak-MUzLIu)gV<>}F;4aPlmF5r#1xU>{tQZX
zKY_Z3SL}V$gQ^!E@}T&1^cQ)KkjEC-yG0?d-#b@FMph(MZCNYR%@uE0<eR778QSdf
zmy!D@)SHFz6gtDWx~gU*N8p;OCg!UCc`I$66DOX@)G{H*V3)OHBpEng44Q*<8ZJU(
z<y%Cb%KMY9d;k-<%a4!W5<8wc6m8ws^|PcglepcM)_w{*B}SA!?!U}DpXT17Ymhwp
z#RN+_FT~TjLA&N<P|=tz^UgxQk@>=QrM3ZS#)ppnin3JC`jn6TCgB^`TGV2s+JfD-
zxR@SgrrIwFfYLlj>eBM0p{bKHtG-^0u7wg`IW>3e2M!;fdtIN5wpmX?hc%ljp#bXY
z4dHUO9%j&(=jRti(rJ<M&yuf;5NU?FR|a#3I<zQS&qTqAp?P|!^ofmknQqx%hPFRH
z+~BLx1XI$C>b*Dk_&l1HQbNpOO!?xXEfB)OG5$mFyx}unz?FP<4+!^wac9<su|hzB
zqyZeLYXu)k=M$QqoZi1@)P_@se`j3-jr@rck34@$-XhjY{A1>eJ(5(4_RKsqnO`mq
zmeSu9pf_2Di5uLJO$b!W8QBF{r7SyQ1&StSqLnXaY;!c^ne{)->X44%{|+)6-gKU!
zATG-=6A|;*)8_%}+~-evb=S_)L#y6&^IHm_SVw5D^UC4L9m`nN!&`pU@P&Jy7ZdVF
z==Qt4qABNn8(z)^*!H}RYyqwr5w)_j6Od!G=IZj?Qj7ap$Jbt<zg?^I-`<KYnfGGp
ze5JO)kl=*0^-3vU46@4~*M76o&Gv09yK|ti^pvHYCFvtlP{KtLAA_R5gUStAkXThz
zSP1s!%oOQbb=asUj8Uo8+lo^UxgS=p%G=^Cbk50ubji9$_4x@P-B30g+TF~_HMmDX
zr#gJmQ&?ToonxWA{FClY$C*fm6e)|oXCKv=37@I!Xrl$9d@oF|$(4hd91M&(vinb4
zrW`FQ*iIS{2MS&PNJgC<K<P@A1M-miV+V&Gv}%WDTtxd912JpeS<d3=l?OrVTf`~G
z-;A%zGVZXly-a(OHs`7YVxG;!+(c<##^}4fbBKB~1%<a}2qemTDw*iUSyg=ydvo_0
zk>1r<F^#J_jdQ#NaGQVaMk&`2f!My~*>n6D$kncx!e-!y=O@_!xO@+e`s*_Icjls6
zK$Zi%ty3!t*d5}CJD+gkB;s0NZE2G`mXi=HL`1V>&($0qe~WZ*u?Xn*lW#Bz4^8Q0
z&msd&X+}Hp;%nk0=U*P21rY)6^QhdM9P;v2jX_>}2EzbSkZyjF{cyTk+Qdd?47=im
z+)R2T^3wuVXL^bf+TJ<>4eS!p4J=gSVD_*!{}?wCn_$?8Cof0IJUdcKpFfC`Dmqu*
zLSjvU<qDAF%!_}*8-Me$o*|?ZE~`|oFeLFdd-;O0+LptL|NbUG*<|zy_y@!d3OwB@
z{Rv~z#7T~lP8)*-dQd=G_A6<hlw8R(ZnI<S3aA-1*C&1t>SAeZ`+=u_GL0Zv<>V_v
z=ir0P-DfG3A%f#Ni9-UlfsoYs*vGo(M89B#2zF%OWVL0SMTNnokn0fE<qGdjM6Cu_
z-BW?+ODJZcKtl2~nx2#D0!}A^CS>q)&DY%mK~j(K>|86^cN>*E%CSxJGs-t0pTyy*
zi))`f4De@API(cVzD{<pMy|{XjkM~nYC6zPb~B&N<eV0L`SBE2lZDt@g|jQmuP9Bl
zQL=#^={7oO#st9G>d_w}V5)Q-yTZ}dE5LhGF#idGVtVT^lQoKT+Bvnb1BeqfvQkuJ
zkwx%iC|#Oh`9JKvcRXC}-v2uyi0DMGQ9{&+7Ilbd5fMFll<1=OVU!?x3lgFQ5j_b;
zC!!M(ozab6XVk%%{FZy~``-7n_u0?h=Q-!R&N;v5`NK;lFJqRqu63>J`hGv3_lJoo
z(u55sWX*MLuGu>pv<gvLsKiINZ5N<kgjtlsGP$!HT*@u$#rNF~I-cuK&X5`qgcvhq
zr+;wNr`j+YD3CZdc&KeB$N^*ylIeN6>V+J#S8B<#xGl1V&0m+nh2AP%$RXH}V%`oe
z)wF$1e0N7ySBmFZ(N87=g@60xR%8PQ)}*sANPtFYCa9q*!Y!7F=$=y*FaTa0H~x~c
zys=yQPudKFpNWL3cqlh7v=aE1AT%3Ma^V(bngwcWhH8F})a~&8ROv-~>R9Jgoz%7k
z|LYrexulNTNZYWZEcf<~vzBm+z_JY!!?{7n8@1w7k{92<7b2E(8k9V%|F&$$`;&6v
z-}*Q8Hwd77c$rk)PbVW#0)VW{Ow5$%Gkf9@Je!CYQ}^iaNp5vXPe`%`%ZaNov|_j?
zXK=cY^@^ZqYLNdC^>PlfvPB&F^B2%DcwMTA6-+=I%rk=5p#aE14-o0m%Cpoe`Eg_T
z_Tq95!2oB0cLWeU<zuN&x(3gHPTzj2J<z)ONl-pyrUoDn&Jng3WWPYC4}r4y5+DN&
z4@6aABY%M~g+@@6C(f3qK{E7P3wr7oNbwg4t6dI8H-Hz-AwbasFv$J_-PX^+n1cLg
z{~H{ZA~$eBR2ab+?kPCo<pps;Q+q;zbGOK8diRX%#%3%0B<&=*>()L;?Kk$^X_y=-
z>0|$c_)(nMOA4x%k}tNn0HZO{WL^wMJ9a{+^zZmdvz_BLol86*JYBvS|CDOyop&zT
zv-eFYe|NQp{^3I5j;~j8{{7YZ`wIm+YT)brhpWZ<cjG5m_C@r*=HCq>mA@N5xn#!w
zJrBzQ9o7zJ5G5iQ<wDKBiHc3wZd4cx1uW%fKM5NDa$Vicq%sY{zSVwNH)x%j=wI>k
zI8_(_-jmm&a{AbSBm3<D$gA2QL16(Lm-65XP#FxU_4dW~Rm+l{k4gOh<TPJv;m0rl
zsK1ZZ6Jwb@&BHQ#Uo<0K_;&EYBFlyx`ZJ$H4s4l~`Bng_pq1tgv_D*0mJFz-In+i<
zQ=Q9+b|F&wXQ)O~%z*&oe=(PMKj|L-P;VhX>|n77j$$P=h2Wu&Y_?%oAoI=a&b-r?
z$iut8K<^Cdg9cl#$=&qzK2RLTK!JJBR<kg$s6T8V)P--5G9Q9eReXV`$%eRx$T(^J
z7lXUpO|sDFvsO|TKNH*D4gXodw8xTOc4`iP;y3qrCr3n3!V2t}pkU_p54Yjp-GN?f
z%qm2viDRdqEu!cE&7XiT@SLK0P@*@zFCeSMqhn|PbZAY^Op?2jS@IBykGYMUf7x{N
zgRe^exe0@9)=G<Y!Ud$9&#gH@f4BQgPv~D9_rH5nj&aq-Kc8%mX0MH>p3INl|5xWD
zmjrl>U?h=6@zyXXrD0&@b|$8BPK{+=<i+06i~1i!<8^~*+t%>bLwvyJ7?T4;l1KzE
zqEZX7pNr6~CfF%oxxp3IDkbNYU45HhAia}XNVC7y%tXOYf?wnRG27sB-}3I`57*WO
zu*kz##@sjMH#Hy9M~HJ@2j30U0I99XsIPom#vKh+)<i>d-uvzQ{H4<K8!g~Z<avpU
zL-4mtulw|WMQE-&2S7KbTjy|Evv})0!Y=vpr{p|W$S(=l4kl&ho+}ptWJSd%m}Un>
zu7*%*QcZ1Af}hq@*Z^JMziEOm2?Bp06MCU~zd$V$m`iED&egA!R?i4NfBg6-hQ#LK
z0C@-A>=|)!UkAo>xBV;#;%2B{&fu^wR`^iI`$0A%^5@vQ0YCQk>(9cui7(E)x=*P$
zZ&5jZcG_t|(1B>dY`8=IAZcO)L5^szgGY+cl6S1j4grqp!;`h%k@J$PE#|aQscNP>
zlV`+oETUscrD9`;`Mnu);sDvgRb?f*7_WSiQ<-#iJzpl!Ppp=Bq5%@HyPK5$^I|C|
zH9cS{(BMsV!7?ftM1SU0@jSrpMPE8{)~G|yq}6|RXpbEh`MrUNf@40Xt6mg4ZLieT
zN<60@ggkE@Zb&LdJJ7WSEAP$Jai0z+!@}I^`yAbs0=>@Py<@`EgNut4?4P;T-f`is
zz`VN%FnB7XRjB;6iuV_&KJ0=Qs2;~uziGJ9U}BA_!+JRsq`iuN9Qy+cEMJ|PL*D^M
z|CRtN9la_hM6Bq-CsmYA#1t#1db|ck7$sD0NQK;DluV8E;=YpcWz#+O+e?*QwTfup
zjHL5N-#pn)qVK#%j=k>j@PC#<z=-IhnqDPH=qqlGDAM*eQQ|S*O;(c&14VB(eJ81f
zkoHNBl?v=XrqZlQvt5_G76w=#OohLfl+XUK4gGM&gu9+m`U_MV<{lq%O*XJ9=U~Hd
ze{xQK<yOd8WJ$*Hh75R#=v&M4QEx3DUH9&-4Ly~xvT{L*eyKqYPk|I86-h@=#eM^2
z-=x0?`4343QahU-rfe+vs<6G^y`a0^Cq74B$1Xi9Bd_dxdxZr$vt`_VFJ_MahoN<Y
zNXL5R(^lks`15yx!A)+6tN4;<anr4X4&_22q8o&c(i_yObovS$WM;Y_!G$hN<1w?7
zU50^5KM$_+HDrGEkFF<wRH%H%8joyQLf^WDY{HWND(?bI-dBQ|7r;azo&s0xTyzln
z;&DSibG@PAX5v);X9doeoFG}%4P8hP!AWo~vpZj*nry6z(TruWRmfLn&1e6F`_XZ^
z+4>J(C1u?Xp=#T=_2_@xuszfHb96}VmE=FQEK2`Lp||*as93Hk;V1cTq?w;S${5Ck
z73E23=^(!DgUilCQ{fJ83OZqx2MB<OkP8U`Cj$RVP_3QYpQp7e{HTbpfhnI_uA7=I
z!-kEjDLXS_uU|6vnuGIuL36xD(mJ3C7`e75l(}-Tq7pPoNAwE>L2#c2`v19-%l?~P
zAo;_e%eh^Cl)<uX1cwBtmyUtC|D>X;rJr_hQH!ffogy`1)SKVqtL*1qmbdu9l=t$l
zan*6@Ui_3hu-f|RJt%WXKtQ3+_i*YSh!`ZrbI7_jbD+kVz?bfk4DA7V<9_<^<Wf5G
z+t;5ezF<GPbE+hjcinruNgLH<qt7nq%u5f`9e~NhIw899l$A3r&Y*a)wLK&1caiv$
zokkEb&pLR}AM~~<jnOhN8r&qwjT}70dJb{|hLQHIgbO0-OPf!Ugf+jc3daF8#ecM+
z05xl1I?X!HaWByXGEWkk)X_A9zlBXy;UI`xP6-abVm+N-BALQ=>sa&t!t2=&IZx(e
ztpFdg-PVWO-qUJiR+SDuLx|#BFSe@j9}9646|NQ^QDgY5-N~HdXM$j(NE!sTBjX=>
z7=)`V<O7mIfqtAUo`O6+zS{0%&3d5N1q32Y)gHT#wn%MB7%;q?U@(aA9B8#`j^~0(
zIj?J!J=z8(b{NKlC#vl4=`<@`@PE08h1wdc^92}U#JH9}b-fzthx&4+zJAvDYUKfO
zcS?<(yD#XOKJB&`kVZF;;W5_S2BR;|1J{m=&IZw#8Sx9iA%vA}N~qsI!<?6H^NtJa
z->g~!$FmZ&2>MF58Hug63(;?$urMQG*+T=4#~;gVVKCTBR*CO5#uifiZsG9r0`0qv
zwXi9u<%Ley9LEquZ%K%1YeH%u#?*MqsC;Gg<Zh=}lQaJsW!m+Ms?NCbWZh-rD?uw7
z_pO!WOT$5)vaJl5_b@aXY@I`kMl6b&-AH%}lUjzSR&{=CQYR^2X(DmKIbchgN@i<(
z^Z7K2-sy#-`%jh4z#wtV6F?S~zBGSMG!L}D6({CeL@vsL7=5ptd>hZ^`8-x`g))2l
zyi^f9m2bDRQ>lhKc*XP_0e=+3P>;L2D`T(>@P=Jpd9(1KDqpQ3t5;1$v_=KjjN{7b
zGj12!n(&1`$5Z_w&;0@PLnoOz9=EF@E<3+WMJ)EcUWC~F{&xfhR&9Heq4y5OLhP5I
zR2#S_B2YW|`iq&D{J9pd^q>vUaNRou^!%$;fQkiQt=Q*U-6NV^e+0m+N^eb%@Be72
zSE{_$n2e&45XzCG%uh&H*@Ve*tD|Eqe1vP>y%8jMI&;G<g6|zmZlWttD>v<Isd2uC
z_mt^u;)etc?8NQV=Nc1n(q=*E-2!(~!ex&~5rMXkq_=G)C`cj2WZwz6ug@ofF4PU$
zR!zvqRw8{&8*&<uYjF?tixLv}c3}XW$b+(<b693XGFgq##zvA~^Aag-T9^Yjx+jnX
z>Aj|_2WO622W`#gQuiAhYH)6T>FUc*>p9#3Y&VmW=JWPGu(Ry9Zd`>c1u^_0_g5v^
zlSo%Qz1T``gF;CaHq12>EecuedyVr>D_L!HHyb>Qdu6A$TIMSkf{+l-bp2sDs*U+7
z{nn*7PFTSl(pl4|gdF%9g20InCA;IX+DT7ObijK>o;NqA9ZX?olpcPxqu8F!UX?be
zGh&-Ow@T~smMbp$)4Io?VoK5vjmHp2#4VHr=2nqetK7}`Rj7Sni8*YKsLBT};g<<R
zWleQ6^F}l-kpy%y6u{S_YWT9uwd<!>XU!g+Q1#Z_uh`(^@4gPAmjU4gQk)KDy#hD2
zPuqbj?Do^EO8`UH8(=p6Z)+$)x1Y12(~U2(MKy8JgXRtPL5vWiw9VmNl_gm|BUoeh
z93kQQ=fN8f>2mI?bv$E*Uq^c!2cU&nW5JdKjEe-F0xWBf0@iEpt<^S$?Ch2o1S&5*
z<)Y}r<*U$s(9=dIQ@l)3vmkqaPz@j-N;x#dz9&)_;AkJw;P6yMz*65Pd;(=4iY`82
zMbweU=5R7i<c}C&Zv($goUfU-YEju=#6PE2e-)Zv%6b&aPS%exC0vBsu!iT*f){V2
zdoLvtuv$0S-2{upb+O1$rBLkL9Ak`iHoXbn>sN+E<kM9r$f*hr;K^eCl9fzGj4U`v
z3PLh^Bt&Po!wKve9t{h6@tGRkS?-h(`TB6zn(c1OFd6sNM38LjaVTo7%M0C&v;l|v
zr{&N@EqOO2|F{iw8={XjtD@-43wRa6wNl^1>GrtUh#8ItuVD;O-=PdZ8Rij0_0vds
zrJ#&7X^o>>k>~*Nm$DY6(T6r|H;q@#UyIMFRtlic3pX<atAJSYgh+@$v8gY#jn@65
zR`UzYeh(n<2x#*hxX|0kshZr=c8j%bw!n_LqR(}PgIF*SG+(ZRQRFMny;?(o_lDnV
zW9-YOnk?0Fr&oDGmGs+js$q|%g2@!oROgS?fE0ulY2=U6qV~d#4AQM;hHVkD+KnWW
zK}W8BntRtdU%KCs<fySsfai2@FG@tn*t;zDRLZEK7@uZ7Ms}rr5#{5=w}~g*EpYDC
zRerB_Jw7%U?`qN#lsSkH@&N6V2N54>A+|SQh&vjLd?7<vs$ox@e64&hO`KNy&FHCJ
zmERW;7_~ZXlG!Y3eo?u0ae#Y~J4TLSgUT@p!`2)OOLxMluN#pm2sOW{hO?>^_pnmG
zw_Aps<Sihow?vyGgs$5`nGc&uHK@AMOAFx+{>14woy7>1Eh3hrbJh6^$SVr0t|sEC
zqf`);9XTWr&yk?(5E&qurP;3x0F{LrN10t)$k`F12zZNsf4ac#>5lexr<R{Zf)qNg
z%mIKvlSRw1_^Pzc(M*Uo6SZfvRip4f7jH2@8l1GaLhFp}UM?D`SqmymUNa+A?PZB6
z1`<ECgQhc7VyM&`oGFEH`|VDa2*gX>U8Xv2IXO{MpTcatCA)ZV2j%!p(Ag6Rm+cWB
z6!YPEpbcXJh3xsHXlN(B6M`$>9=UjBAsO8*wwFUF$M5(HL?<@u*ug-PNnP8XDK6e%
zlXu6>t7JxbGQ-#4rv8{JZ$YTZzHlf(B6bu^R0L3wJr?E?p!sGFL5xC6*Tn40^Ivy6
zlZ?Hyi!jWmi*dVp)AFt|zQ6v-SNot_5blY=?Gwa~)QQp0!$}`skB(19J;%dOb8iX=
z6~sMMka;Lx?2a1}->4o8F-4~BZ!IS5XjEXdlJ!lgy1?X3nhOIe+{^I>zAwtiKA729
zWcQI3m(Qbln0F=;j!29jRi#EGAuC26*EPU>1C31@qwnQg%=cI8yRDngHA|6&v<RY3
z+A0&wZb+H_$gDKOD2&&%lGS{7b{J73GVXU2CF9W(9{8MZs4x}5?Q?aUyTc`H{>IWp
zBE$%yp08N~QA5ERUCK6L84#O&C655g0<9RRh^OmxSJUmAK`;C>K<E8ST!WpHT{-s1
z_ua~AYOx=7*9<c}qwzFao~o9QHkF;aEXg<eakDoaENFJN(xKPPQG@OCug<*U5~3k^
ze$IHK8CE^x2IO-c&qGx^=9{$j9xGB!&yd{$5XUX8G)+tptGq2NJ6h+MF~r9<x7$tp
z;%Vz{+_rw%7nz&l+uGi{g9M4L(C4$fE>|Jm=*(vj!V+H*Wz;(<4QveYxRb!}+z<L>
zy^N=^Ns4?T5&KgoS2|cTqe0~hE^ve6Wb|ib%i0oaFof#8QQP}+#N1$srfcFHqrS)T
zq!P`V4aLV<&iLY0%KY6F^CxJ<C6`xNZV1`1+%1gk(9ZIBO~0y5XxG`|``UQ@M3p<q
z*2<Pi7L(*}U2{Q%hz{uUgzLUV?ekw`S{Nq|9cM)hgtvkXXN`MFemu|cVBO79#4Ln1
zc_c+2aQ(yzqg{?^kor-JaePm|jFm0dnmTm#NeUb#6<&PMuUGfH`P|U(;UOa|Wm*(x
zw}GIuH8zMIJ+avOGKcPP=ejD!);2)ytzTYq&;IHsP4TBi>hF@p-Ra$a+}nCNDt8x{
zA?G{6lo&}gZK2(O{X)Vm0b|_>GemDdeVc`|3v=y2JxF>s3KX_~F*`48xDmuSBqxoz
zg)TyFExNoqWWBcW#X(=<q-tY=%tyBKC|?P;mq@f$S=1^_H25~ZtMS!|GCLGT<07j?
z7^Bko1&LpbNFc%7Z%r`x+%Qb6!PPucN|;-3$Sf|ny4d^m2^nW%E=wiS3Q-gdu`kCw
z8kXbSpb27hiS(H6l$a`Vd<jQ3ed!ral;9z(S5=bM{GRuPAZ74e17nlExZPUKlCzja
zi>0pCrdQ4p_}*@w{@Ac7#r+!K<j@CiU46isj&7iOdoH<twwD0WIak@pz6*;{ZALNA
zHm8p24+rK6m<8PC@O}A?kcG>&tR3`;^BIMiB65DQ@*7!XHbdlBFtZ%~rhj^@sCP0h
z^n*RERBA;zox5c={Q{TIU2=MJdxDfuRS>H=#Qq{rMrnbS93wp3gtLgo=(kb?!EeU+
zMe7SI+(=ttO8gl69N)n8KAS*1->e*q8tRrg8KE3+d!a&wXoa`ko=jRlVRssl37$J5
zv77F&G9!o!ZLSAgub>}Nl@So>K>Vop%(^o?F!u(hyOZA%yWM;1Eo7W<GVwxy0_fD?
zKd7g){(<Q54+<-sPRyf!>Tao&{}-&ZjmvGOxd0XpsLcspLTy~=(UITasXvlRjEKl?
zZ4T>)`ku^B=Q|}`vq-fpB1lxNEaqEgogTqzNOwbbH(Jl!V7X*O=++PDgJU0{@gD;G
z#oSA_QC^L+#`+^=wnH`jiyx=wx!`G@QOvk}Zn1zpjV%-hY=T}pjzB`gWQ?#lBZuWy
zopYS9kQXn?L>V~(1PboDC%CG!t2DWn7`t6%dKSB%Ljo*TBK)bbVJHH<bX}BLtA)#r
zG#{zmJn_6^achD*oROB~K^yRg3)E~AnGn2j&xET%Kf%lpNkq(~=zx#@Sox8<q7Qq=
zi|Xz;Oj^{txGi#NV|w^wGJnun%3@Au0zTyF&kC>k>n5uBInwYs_-x1cgtvikAo|74
z6yo^S^gOXOGm483klTm>%f68|EImrF`28lWh9iD6X&S&LChc1lhsu1ipnIlUpYTG(
zXy1HlfA2Ahdj|(~vcwX?@8Nq38^}8#m>A~h;bmo~y)zWq*G4G)#?>b*CF1~ZObGgX
z3-HpihRMlQp=#TqHymB<k-mUmrJ(_4d`cv;adPLgkCNr%aYh9W>9;XY2*%+>QKF3I
z@cV=EDJJ8sFz_Nx+K#7hrqqM9EziCe#D2XEGvY$59#@*$7kqZ~N+C~BwNWy+%X~$i
zR>k)lWomw@i&4*FuL%{M!7t)y<Ofu%ey*S%x*~_xeP{;vMapUG;nG;nxxnU`ehx|k
zQ5msUd9!xxIVx+c&!}g!N=77CxFJuH_bU@Q5AIkCg>UOOcXgEFlgJKuMV@mmI_8On
z(owxZ&qy{N3BP#cJ$2PczIV@T>V1EKoXjI^##zZt*5^2?k>MThc`$0?DZF;u^f3PH
z7mzka2^{#H`aN_0cHmLLf#y3m++d-LTLs!RL7)1W<kOSyW#8sf!c8_3dj?uwW8Q){
zIit)MxhA$X{J63|TM3i{y;#7_;Iuvb6z&33vtx^%wIuL)%T$La-?zh^I{*q41O6V`
zP&vwVBXAVN)V=qEqklLo6R+c@nOO3UVX}&4Un#jRR}MFB#z8Al&{z(Mi~+)#ukDGU
zqm(_0_U%Q&$4v$&SVquCOVfd4wSqQCC0ptfU(oVL@Lh-<a=fr8=sUCuXaqRAteSQ%
z2@%50re_4Vq4_-t#L=_f2}vP`V%z35l)MmiH0~$7>7`{{re}Vp1T~<*oZrhn|95;h
zApnw%H?w7sG@lm(iHsYOtHpkV=eP2n%cLC`&j<}LzIYXJyAHIK^Hz=JXnx{0B8LGT
zusHG33&@VDST?dZ5+!kyKKXX2$2>b3uD9EPGaf8=<tNkud>J7~QjR4umbXA3o(wJ)
z=ecz@-fwLln+Zv{eG~stJn_4d*IiI~2<>7ogkw=ds9k5%$A1(KA-s`ZJ0f!;ahKH0
zkh!1I@Qd3!o>LXjbxiBnp-@aKshBMI_+VThtA<2>8P=N1F1Te*Vp8U2%(ft$apQp>
zVfS|f*Cz=%V<fm{!!kN~lfEhP4eGNJx}nmU_6SKs_EbeavX5XR&<_;Ylok68sEePA
z`L*t702$9_6v&(~2;l<bNFh3X>2a-9uCY09L;#&2*_l!wZky+0+Mlq+9_kGi?ydY^
zph;z*Xkt@&<>Cwfhan5JA}T`HW>^Misa$SL&+F<%j%Gdk?HAXW^KW`!k3g2b2P$Jw
z>sD%rEGj2b#<0>cn+_#d@4Pr0)NL~Qd^9!gtTq+O_(&}pKr^S<;D*xLRsMX4W;|{f
zt2U4J0oJW#XptwiV@KxXzNMODrp{c3O<A|vtdo~EqA9O{+U@U=^k}=8Lw^2I6#P#{
z$5mQ$)Rx3~9Hz9ZNq7P<A$*GK#`c@_1FbHWDrnt&Uz1}yvsc3TwHfGkHO_v~4#`pi
z9flO0x~LiNx|v=p2g;gIMhRxvB&!?i);TFanK)CG^}o93QiW@Me>uLh7gN(3JI}n`
z#Jr$k834w^$O@ZpO~9zCt)7hDGJ$XO^IN+_-8fD8$YuQU87bdPkdPhR{8bP&x>b3+
zJbCxW+QTMFWdz$2&9lH)Y~(6z!7A)ctj82X)y>?;W=PL7uP+L>KGYf*@aL~)c-JQp
z)$e-0uN;zJ=fT~A_af6V@fi~rjnMTE<qm&-l}naUfStG~Y_$Wk`T|?W4x@_51@my!
z<W!6)%dv)>hN5mWu%5Neru=dvSg<p}mGRSD?on%1LadBd0RS*aIhXeBe_D?sp2Nuo
z4so>7{CiW~@DWebBqIAUak6}na^n8fafRZ-z(B&cJ$Nm`HcZCQgXJAoB;_%RCV_L8
z!?@prDaw;WAo$VUtU{H0R}r{k;O&DI-;?8P^eiez(amGAnDp)9IZ@q@^@`O`AwlCq
zpB7U&uj5`(7{m{j+x(N9?@v9Yzk*=@3WTi`M;BhkDEy`wq)XipTb;krx@?ex#RY&J
zl))U$uyf~k$2Nv+2M9Y%Po{NL9YsB36>09V*y+Hz5}IXXp)v$`SgE5kfyXGytp4uC
z8BK<aBA@K+VFxcHIwbm*qMUFxE!(HcArjlCBQmo2^Nwd@-{AIV)|9g*-+zI;c`UT|
zrLDev<eXSNX)|Z_B|va@0)hAG=%S@84z-$*M-4tNMFV#3!|9!NbW@Y}pJvPJ+t+vb
z(aY*8%M-wVfv#Yf5v({E{+~^f06wiA#rkR~s<5T0;cW%efCxQ<SW>TzYSm{oneajS
zuiF@4o?#zYyQl(mY%xauw_5XjGan}yAm{R(OC}#a<?1ZxmEqT2yrl24#j^N{y+xRx
z(zt+ka<H*RAfSF}pAeH#)TSA1G!X}piV<v>(~Eyofh#mEbc;fHnT0Hkt~ac0I;^cS
zM@|4u+Xc9#+ttkz{0ZWl6qW>_?IM%?ON@c)T4|fzPhoX$*&38!iKnjAcVC3(<MwOC
zYl^MU!%kk-RNlaT&nR4r+=1_(v>SM5{0zZ2QZ2Kc6$fFrm2%c=27)HRR5IKs+G9&O
zCUijY^j1b|C!y#x3F-Kpo?it^z?(v=&uY&py2_i9UOM5o<&rh=3zgSM6FEQZ#q<Z%
z4ckqh_p(Rmpu_aH7~2~juCo9b7fz_K=hjo_FsSeS5E1ke%<i9#nLmvy+)mNKQwFiU
zb6_qQvT5*N{f{p}zb4R;|19SF@ubx{9o6Y|D<xjy25J_>jXw9rygp%_Z8v!m0O7xa
zy)}zPl3>;k6wXnltN>t*65#p!e^6ePHkg>$(5XyRKGm_?zJUP00cVM2&`NT>_NKdv
zbJUZ2Evxn!PB=5c>E5H_rau@=GU-R==R43YfN)j#JAx_tPd2=w_q)B^*QIg}=7K4H
zH)gCp$F=rr+tj>z8N=~M$NBCb@47*Gjcp<NpGJH${?SPJ4SKdqc9OF1f-K_X6Df0r
zty+S#i`=+#K{ol(w`~)ZuBUqgoa#!g;ifyDjntzLLMkT7XReU5^zW+Zph-otP4opt
zQ|DF>@9cj(6c&xU>A7ay_z|-e(kJLjHM7=QR5Wqbi(K8=qu*F!!G~-_?6U(GO@zIc
z-nFjP9*mnwY+__{XBkHL?D}a*&5E|kuq^z>YwDy4MZAdFMrM)C52fGX&Y$J<5XE~{
z-~|Vl?VZQtc%F@{cXr+dNs9H%s>v31zcJ;6yUXiw9F|$81Z37f&DbB7uADdSci)@b
z0r$li$61cuzbX(mNaymS!pQesKYKTGnVW>SyFBY7o7(G|ynZ9IYtVa9!MI2e!-!r!
zt?U^+cc+fZzKLN}q`UFzg+2S&;c3Df&j|j2$fc6G>1p--qVFo&fUaz7tZs0M?aJ(X
zZU5yE4C={3t-_D;`XEyu2TMj!E-?rMe#`!8HJS0P%#Je2!Xci0mFax8MMIqCdpvNq
zh{+MA_6w7VN!8~y)(eL^oqdtx^}RCNk>gk8d8!i|6I&XiHjS_S^oPQ~A`+0DZZvlt
zym^_m-r@cr(ENIWH8;!h%6ZieNs%PkV2=Rz<+bH26%Ss7ZudQ^a`u=Y8r(9XX>cqH
zRgm6g?ndjy3{p(<F&PuMnC2;2sNE|3DDHgs<*`PG6|%^t$C(3|d7{eG1i5c>DxzZ`
z^J$LygT`s*voUOHlB6@(`%T`f@Z%pY=r=CU%`_`l;0*&D9pV(*sshVzj&Xy*R1Y@n
z^ITtRn!%*XH(w{>((jG1hFfgHNxo2?Bm-M(zMM6q2Ibn1GEYN?dBUK9QBFbBwmM(x
zM&DoYyB@!&!a6!}SIkEyl$n7j1{U3+=_)e8sEXl(!H~1FarItr^IsEhuYu!UOc@*6
zYf&)XwMqsIV;Q}pG6sc)`vh?7L#AIKsUodr@>A`xH!zP)T8UQcRLqB?XW(qU(m?ia
zcz4bFM$Ykh!NO+FA01AN>SwRAXc2I{z+sJ3r0yyyG=8GvM!ufc;xIN8@Ych@$D=lq
zTD3NkWczzp{dt`9llo_<yr*=msRiAvyD1m9H%d498ZF73cG|ckSU>n*e+CQPsO|P^
zQM_1f!<1O<ZtECu1jypCi=U+NaynfZU@gigg&OrX{q&^Q^}FNbwEWtZHS)Xa1z#Zp
zNqge3Dktt(-G`Y;!%1bc)lKl7W0FL<(AuZPl@X76hr;G~mJGh7(F(1!aeh2q<9dp7
z*@eu=2`>5+^*nxC^;+*-rtqnV{%#gkU|!M7rV>pYh1CYe^_t9e$j6-r@~#r%L#O(v
z?|j@Srm;J^^Xe=-qKy%jNvVkmyK9vbba~Z*8t!u6cM^8v=KIAqVROu*3)&0a&5iij
z8vAsuFD8%6a-lw)L8&7bm2$mrnp$#{2XAD+mu9199t=@Ty)ItMJ|YPaJ)xQS`KE#^
zNp+)*da&@FTYpwkUq03!w16eR@V%$6J$TUN=VQ;}q4~hJmzh9kGSKlS_m`m+jn=6-
z9a4$Xtk&RN2a&}9zkEuLZTWkrXmgKLY|Ri;U*_C;+k)-Sg{j|#HFp~rci6v;iBKam
z%uiRN8d>9^g<P!>UdA;fE-W5XE&3O}7mmJ&+u&+zWDTui&imRTWLM*hHlv|TZ?{j8
z8`zC|7)No$<52;Sg#MRrjQ8eZ>$}bJYn&NA2Z%`OB+uShe;@tj%B8v|`gULJ8W9%v
zK=hI+Iku(!XG3C%2p%I<kq5As9S3NLssNP!uWOgWtD)EKu_psT6@xiVv4K%N`9G{q
zQdJM(1e<p*17Vy2q#_;bZZg?c2G|wal#>Dte^BzHjhx2j9>`ry%*E5Yb#ofhj*gsF
z#P;q6o{>&11QS9^9fJ%H?qCVbQ#D&elEIA$m0l&~j6I#0PWQ)Z0->51BK%xHL$rTu
zJ3R8^a**YFz*j@Zo?J-v9dtz*6p#U6{W1qrT1IyD)UdjKNheXzD^tIPqKH4kZjl9k
z#lFdR;tpPB_4;~2_!kW0YqFW7rx$L3S{6qoNeEf7ccSXDB2PXVU4nlq684jn5SagT
zzAKY6c(T>X`(iXtf!E)D!%Kq7I^#7#p3K1?hW<`Fp{1!uH-`amjE6Ts?7u(QA|P=k
z;*~{}<B{%@bk_;wrF3|3{>X;;1(Gvgy4gI54=%rS!L9xwp5XawG>9J1(LWyCwndGo
zqAiw62d|+UpNI!BqiDV*_ot8)?q_}6_IVjEN&Y%bBQo{XXI*`cW8S{wew{D1qn^{R
zc6S63Y8DyXWK2mt5`6iBihNgqXJ@<;R3vph8y{VR;#(~Hh$TQ#uclJ=>}PtW1eW%)
z`#J47-&!|?1>fya{g%`hDk$<P1DrcgiB3^O289PKxloyLMZ7Iiex7YF5^fd@!m+X8
z<ShyP-oYEHN{u#$3g(~R#|}}N`gy36MIAXQe<@MmomBSjimT#b7DyCycW>wX%$XyI
zO6Xu^f+#f8V#Ow0#NKMFJ&!f{KFA~>Nx~K(vmNy`WWTE<7X<oxrKRN}6vH5v5M{t}
zt1kR`j7CELefNhwzd+)P8*#a|vZ$XKKC9l;Wr4H+GmHdDIk-S}9bNHl-U02^(z8=X
z0z1Lc(_LG&WHw+zB?n9_OI=DACJqD6@B2PxWq{lnJ5)oEa)uwL;e?9IVF^L0^c?d=
z_bS(vxBDGsU^>cqd6u!lwW~T|S#`T$vLA&N`Mk7~*OmQ`<XSI){GsR%^AzVph>KyB
zg8|k$*{Q%!j7I=Q5s;Xe*e3Dd&X7app;;`y%S|p_ntxDc|5_*HEft36CI?&xT~Plg
zHX{r#-3T}R;OqwWV4~9Ze~a{vRhm}DAY${G!mNaZYND7Z(y@41{h`^Y?Hg*zb`%?j
zmo}mMNN9wN`r_a<$Bbau80P5-#YUo^b}O7=>}qn{dRbJ>Q`W3>*)NV&f8)gdHo09+
zaDV!0;_d><ax%_KU`kU*EG;^}0&T>&9LM=NR9Zb#cYpNOGs8ujSFpPs!u^zirL!M%
z$pp~q$b@!Q0vSoSTwibF(y1DvVwb(Wy~2Y%As6oMx1#$N3Rc1QKyD+PDVw_gb=v`x
zdB@->x76C@ZuqbgjO@m|b^&Cb(`(pQ4u@p_+yOL-v-=tlZ&4>y`Uc3O^i$+Qmg4SC
zKOGT-osQQg7IsiNJ=<!L#N~4aoE-PqSl+{Ua`BaJxGE=p3%!Q`?uciA#}TxS=O!nD
zwnDBgvDLE3Ab(^n;X3AURhC<3<qtlI-Fz4}gBv#2n8Aa~p^C(YEncuQ<0_0eSMLbU
z61%~t?<anJ<zLbj%tIg(%op=hju^s@{7?^^XP|LPoo_Eyd#|D9Qz(79&m4R`xFP^S
zzh{=N1hQ<6z)0U}$>t9f9IL4-A9!#6hJ04wv-2v2xWub|$h1hU3_>i*3pu@bbP`jJ
z3G`cRmU5wl6Dt*qmD%iow8N;J=f5Qr$dKZBS3kiQOj>LuMF**$Rx=AuXr$=Y1vGZS
zLT*Y(+zmYaz=MCv*a&-iBGx$#xq$}TE}5ermCI1&D^~bryEdy|qj3}TSS27#JjLET
z2$(3+lBa8!2M%uO>5c`8CEc;4+sci3wqf>b%BvTagXyA{^3&FjvMTPhbK}S9v}dzS
z2zs8+x~SKT3W~mM8M5W-Amp2VgfG)$*e2Wpj&cp$a)<`~yX32X=jZrn&5-kv5FP6V
z+o;1vQ?mhUwU-i!DsFUXBClPO@flz57ts?GI%~;OyEv5{@kt);D9=fks(*yv&P!G7
z=6oUkMe5Vd)DX7NJ1Y3ac1HMNi-Ei(MD0?}u%r+02y*z;w=|?OeGGF_7qtPu+C8RZ
z4M!l2qc!Sm9iX;Q033^{QuyOwFAXL`2O788sX2K{)xvA2UZ$APinv6*khZJtQWN3m
zHB)3{<l#r5CVTMIc7~Vgv{U8zQkkwLoAGYMR`-UP#V-(%&I0%X54?}J_6u~$obhE`
z&}@fB_(=G)k~J|FqWxFVmiA8Nc@ZimYZlKz+k-bfs#(T1z*Fh-2ZKkf2y<%aw^20U
z@KDgig!lnvBCUV;oj@<!#vD2b9)-rS{?FTfJI(()pAwrn``S`l*Ht-63GSqyWaYlL
z5mH+~J+clMw2r;dMF$800Q@e($^%8WCB6|1Nd;Q5gF*LXjwok`MqQdS4yJp7)Z-WC
zAvt+?h&ak6g{{Kp_UDY%>(YF=_0>4Mh~s1L^!53&#b1+kh=|Oy3!)z`KNKR_7(aWQ
zX?MNd(f+!^Rr%x&PPcHqtANc?Tf<>U9?#bIF1?_PTUq<HnVn+@Y1U1vxoXEQj22?>
zr9bT}!NWbuc|V4NAoF)EdLvdmW$(HQgEpASCNe-Lt;`rkB)H>TI)Lm|5X~pl4VqXp
ziU49Ax;IBW##|mD?<lg5hS%kYKOtdB&bhvh4}oB+ey%CJ@)8wdVIdPv`*5vnU+R4_
zjDTkFFVNwQU!We^9E=hxvPKRlGXB&7lD^EKC}3?_dHnnYb8w-89=doN_zNWS3#5e=
zLmB+f`~JI}mx(tJqv|>svO2;O&Pun;w4{14+ycz0;l)T+Y-rBum4jcPS07qCS%bga
zRvFzVySUQ~+(JCKb7IWWnq!COS={=t=;N+q?oeNDrR3X|Ne`RcIj)qI6+~zQdyR=y
zXuAvs@FTvrT};4G8A4Gd#|%8URP8PFfW=1i<Dn4YhIocxCZUbGF%JhUgedE~{=HOP
zN;PiWlmRVNB_>89=XmfJNLj#3?1yiyHWHh(cwVm3dDl<M#8_sv9VQ`Ff}#^Rd9^Or
zWD_i#qBc@dG;%YEW0rBZn<M8<Sew`ymi{6K=v#<%qyW85GyGxExEBcTt$t%w_BSr)
z=Z5lpjc6D`_P|{3f1WA-^Su1?vgA+COP=A%-mfv-7c0L&4Co>(P0?5A*>&hL(IA#R
z0d16n12D=jDG)+nbTsIwSp=&b7l56G9vW6;HywNp;zp818C_t=JdRTcQjc?zt-E&S
z%+D5N8H*6`X3}8rub+SOUj2pgv<<*@rjM|mbrkNCLKpLzmFS?LREkUdyeLTIlDEV4
z7hA!VP=%{Z6xyc;KJM*5_rbs6b^JOm4)s|dLD%o)Lsa&Z3C;_`&Q>oSSQl;B{U8nO
z4X0NZQ@|bROAdWBD#l(C(sEy37IX=$ImF?e-eqj+oEnkrmJ1fY&2l>vhl7jY5v2Wq
zS>yiqr^`qJg~{vA|CnzvxZZjKa4*9zcekr5b6glA+tZ;pWOUC@dcYqDe)AZ>?gwqZ
zgf`s)KN?!WJ>k>`1MGVFONQ3mgVt}2t+O{<Q<ZzxT{m^lW1rwUsJ>6OnWF3642%R|
z`x!L(m9yoAFa78lmt{Dgt)<B}F!{)q!fzsjB6FuAL{5j})md=ln$Em|j==<}2s6XO
z>8etaa4*)RRViJ23o2EV8Y9?XSEcCFF&1LwF8kP<E<tM_SQ)s2zcqZUVdSelmwEMt
z?T~d*Pt257DZnR7ftWykk{;u@#%sy6;wPZ#e#1oXy+^HP@m!a_vmPDJw_t)pY)!uq
zyll62R_=(I5xlH-F2J;Dz-T0HH;TadY*tz1E77k1sh~D(xj!Dqp-5YJc!j4b=F8~e
zR$}QY;kB)l;ZH{cnwrrrGvd_#i_ld6?FNZ(tNWBA{bmJuTBq-9kIKS6pb2lyx@Pun
z(x#jusIQl~d^$Dj#<N;dS8(~fWJt*50)jrw_bC-<Lp-lzJs2<sk2muGK2`$Oe(KWh
z_*hl&@H_6G0-8BRsk2+04l`IixiL@q4MP?W+rlk);sO7X8>=5z&l7N#BOEQYP@C!F
zN<a9ViR?!$H%cgKmvf(AaH`#Fn!%Q3M(3^AosttDkB9zWPD7w+xBE2nC``K*-?usS
zB}-MM#5%M7Xpokb6F#xDmpY8J0~~gr2)6W`fF+KQbHV%D&}k=1D1+PBuJiKgu0g_a
z+klm~{qvs?RQrp@!s_SrTlJbpCF$;VHd6&`oVlKDvzQI*G10AjZ1UGyOKT3+$cG58
zm;t#NdVM{QZ1I$w6+ODowVrnCY2FeB-<Eb~ns|H}L$QANjROW+L(k%@;;je|waKty
zVP-lO_~pg&*6}Zzuf}UQaEI?X-!OHcz3me64o}<dG-Ie@yR+|{p*UuLNuDdbfd)@=
zlkdk7k?-NagIBaG+-Oy9@Z*}%-Xcea*4^z}?-VcAZmO(<3!lg_MD%{27<tR7FsRR(
zrE48Ym$p+A^9rF8mp>LiKVHp=D(ujD`T2@kP+{xY*qYDX-T=RqDWLHY8&aLq*Eq|n
z;`oxB(9oP|Ptv?wR6Uh%Qa>di6<pn<QA~1D<RH9N%gw5w&rzKiez8GJ_M8Y)`hMSe
z8x)NnHRC1y3H-2F@^$j(IzRA~RS4$vqelyzVXj}hI#`A90Qb?_2Up=!eQR~M)ituP
znT+K1`KPLtGTXSvi>)8U^6WoGw)?G5VfS;e&3d!pG_^_+;U4E})&!U%F<UGrjoO;Y
zCo634YPF!3XpQ`|#p~?FPXr5&auTi0c#E}h<R@^ok6Hm~8GOvo%xy?y$GK$OgPa02
z6bZtECcFHErUwXexmp#vx76JhdnE!(Y~$HAp(&>sMVz$a`82i0zd$qG;M{V-hHD$S
zbrYhx!U7FHvT%bHgPvlmKbvk%aAok_7yhB{3KfoC0ip#qZtdqcrYD$K9c>w}9DR9H
z*CK@e$ohegmf4FhyECR)v4dPbXvmq0QqDwG<jg>bCJ({*wy9Cq+FYNWwa~QgfcEa}
zeAj}fX*;-3zjoq{+Hw?*`HP%#qqww=19sG~SSf7aFc;NJXO3;QoiXaPYD>zTq#E2Z
z)s{9h-d3X~@)n522A1-!wZFukCO+!E$W>Xli)~CCiaS1rU+-lKY+1J?fH{8nR6Vr!
zj3h8ntY6}3+hl9%bEs{*U1MRm4m0vL!+HBhVV|4&J1g<_u(?-iepxjwDepPirKM#)
zud7LlxeHL(+y~%6k+=dANU^nJqmluk^rAt2yH?Mn-m{E7(SFHF@zZ1x;k|fA`p)vH
zYOA~yAJXDN;VI7)ylq|FgpXy73A8e9Z(MGg1r-2CJGLw8n;RUJ?uT0z$==khn^Y;N
zlvS<e>Q;A47(GNA*y(9I?a=VN-MJ2?=6*+}V?JafB_;Z^U`Vdni#MHDUUU<_#(dJf
zz6qp4kin;O({?qhdoO<0b=q$E^Cw`FtP4R{CLF9-NhRkFz38Klofy@X7c#85Fhgs*
zs-Jven0BaC7Zm^g-YY?_F6des7JLPq>Mx#By#B=a)B}&I@=3c)LSAX*l4CvC$ENJb
zJ7R0Huh-%C&bA&~(S{XZdl4S!`^VHa_6SCmn_;o%WUt3vj&BvR@j27JiRo>l=U#st
z^rq5ul$#1w^7y6>=9-VNSQgW`esM$B!Y*@x$r_4!ig>(8H{S30=-h-%MIfUAOp)_g
zM>&k%iqUy(o~~?MU#BMIs<+s7E8M-Wa3xMb<^^MfL-@>B-txA-ltjj>WM9X(Bmjj}
zR7&4iMS-6Z^)5{YO(fLGCVNhTmvE-EDrM845@Etpns2D+wG3CP(L8?y<)2WJ8PA**
z_2?JMQFik*uw@O`c5=?K2}pStbpPEPQ5{!PX^$$i#EQo$t}*|&m~&<KuVbd9ywM|>
z59_1#qaOAcoEL=r0wv%m4AnR{jt?7{@A0OwzUirWH6AwgMoQZ_|85SG3*SqHWN0tv
zF>ZY^4P4*p?rXYU{%au8H6Y{3eprnmFJfL=bI$V4z)tXE(BU9=$|T97PTP3u+b=rb
zM$n_;rNfV9d)qi-Nj>y`&nN!l`;$vwwH*$x6Ti9d^9yOR%Hm_p1y5h+i67LgePeGA
z2=WpI9i{1UmL?ikkQqS%8YKDLHZJS<<?`Y{_hNlC$4q7Y+Kt}{f0s#O<WRpz*iWd*
z(C>)9O9UX02n7!eyAA%4@v|@Ag99X;=pdzMqf@VT)#nE2HDFVm@91pKTxBg+<-9JT
z!B8)YFOJ&uMgYoGNl>^h&m3@UzeUZ9z4_d`KpOUmnopf6(lcq{GL{~5pmrWMn?8-x
zY6fT*cwGcVdS2t~UIXWXe<W}<-c7<H|B|@1&%MLQ>Ux)#;g1>}-*MG33lfNAX(6g@
z$f6e%jLcp@l(kB@$kVj4%FyPjEooBO!ym?$cl0sFVscknA7aDh2-kZH&@blbCLBtL
z$sU7n_o)lSogN*5DUAwu<2+p0cU83M{6p_Rv!K%R)k5K%$jXkL$Fkw<EiTo9(57xu
z@Ln!d3JdH>4xFEB>WQHd=P!IEwU$s!Y7ww>Vz*wk$7J9=%kVPA;?ohO8~RqiF^qq2
zz5!k>!lqTQpKgLiZcsjc!d;QJS2)|M;9{U*Ui4mMIX<j-Tdo?1w@jP4q^xdDMgncM
z_1J<`T<I2p``6eD;cW2W@SpgnzxlpM?z)l&?QvYJRhs=jk{^x_i-dYveS85+%)6Z}
z#Y8dcvt`!!0bMdDPo*76aE=1F1eFx9M5O>KN_<R_942AK)LMHfbZET+(EN%O5~!M1
zaz7#MWR&mendzQ99)PSMps(iG$LXewHI5l=?@i(Gs>-+n>)Z2K1Uwfd_W^d+x$U=h
z0zDIO{E`1|-r;yCA@goU(A(U!K?{>`&`~Gg2)PZkIc<o{Cx09~LWki;ee@mP5PRzE
zoJ?mk4&OAirpXk?m16Gn{(Mt@ueNfh9HMqkjJa!0h#?uOkTG5q&i8#UU3$PV|1>cB
zLaTz+2Eoe@kb7rP@$a5+bRL=#b!O8~K&=Ldy01JKFXxz`v0LRHh|+lHd_yx^QH5TY
z?T~}HbQ}B%UbMpvbnt6gNjwLMNf;l$Qp0r^nQb0J@GHz*4bi%Z^CjAFn$tR%#Lb)$
zBe5i4d>nx$DhIMh##XcP=N#h#J&4IT#Y@Es9O<)_@T^F`hVv_{eyzkGFLS8@$Fh=F
z55@t=T{T4MdFi)os`xp2n<1*l)*T8@d(sknNQw8=dt?t1<z-6^E{gUBx5F-jGjr|9
zV-U{7ITm%^b`R#Ajc=#B?^x#5Qp>Qs-7^`CYPGA3Zz25z+?btYRA?dfksuaFgJW-J
zXRhzvW)X}dFzL7CWH)in=N=n&-TzF$FC(Oh9E=nE1zO0;09LA3k+4rKg2=;&AC9<1
zGk#U7@SggCPuC!a6yi%mySP`gB`X1?oTDbOZ+b@#=r9ftPHD^)e^e@7|03I5MyYwX
zK)X08nmrANfZr`-E?5>9LC{4;?rYH5LXXx#u6`TTLghq{`z<*u8$^HW`!VLh)!7zH
z&&a*<;1P}F@-tkrw!N5aK@@EqMhls~<Q1P|ztl>s<m}5mT#&Tw;#AQ#&41rzj)Q}w
zqD+(XS(2I1xh~|UhVfEDnA}~57UJ|J+KB2>!^37rRaoqxccSV5r-VK-l=y>$N4?6u
zu6vx7?}G*#plys$@=XIUVGE-}HbrXrl|iUq!HoUS@0p{g*C(!u)ZMeBb_H#1;vB{O
zpG8*v8$bVlwZF7xP7}lpB)ZMFUl=T@L|fG7s1J4AvaVK2_E`I#DA?(v1QrdGwCD;-
zU9Z_E+u8U9x|M}!J@K5sxHtU-KP~m#%=fwr#d-@P$|VA$zL1W(QH-DCQL&Npyt*#q
zk<){>oJsCeOz&`#fFL_V^EcUSDDbOaAYcc<43WFY!RRb@p#vTBYto}u0v}r^@9Bhg
z8q)AlzZCUz`s{8!Q$jespE!4ls_M+Xi<0OX#0wf^p_~we2-ue!nmRIc<y+ObwDh{v
zbA-ZG^eL)(iabK<h^>MZL4i<1nlo&;Pw6b$e?%LWsryNFxxQL0sp6)ZvR1(>=5?mP
z;jg&x7OBwlE>;j0jHX?jnd2J+Zg#RL@=fyhjyf^@{X{!*V(AbcMm@MBF7LL}!tz>(
znezfTJe?tZCk17OhpK(G4M^D8hg@Q&=N`nlb8AX$AEXe@UWK}g(%rnruPKUirf!(=
zqbA?i=TVLk3h$!jZ4o?p#ANniVmlotj}S*<2_c)ie+GIDQQjR&5PcM&;fN555@mKS
zPg9qrm47=p8QPI&W*orhXXD0!S^hqG^V6L>j%`64=!A|Oy4Hnv;`8Jfy|UR4<s=Qw
zy|tdv(#N%<ByVWdtM{~TsNUbXSRg36ihBs{Hj}7A3WW(loX)(C8=b9_?!ksF&P`|f
z`ATq!Endq>ypXy0sp+s)zDg^OGQqQ^ENPjbv#7JZ>dny%;X;LJqQGrn!0X>B1!T6!
zI98f(cFjMk3*E==Jg=)h5ERI_Tku6BSW;Wwarcv%P(-PB$%&&}I>C`pK$;aHwv|KN
zR%x%jWi(!7t!rLW##eK*HfijoGiS6<9b<6Uy`E=e)gLQgEwrEj8&Cok5A7oneWXbP
zSic@fz2wOlUE1IOcCH!se4e>$%sXDbuaWVdq~wBuBs;_ioq4W}(MH=A`2v*pb~CbJ
zfoj7-nn!ZetXX#DD~3(cy#yI6*@jorPIbweR6*z1=u?7YV-!Kmh#5K$+1M#{F(0*n
z6s%4gr#%ZJ6f%M@2?=Z4gIFvc1ulv7uHPY;82zvKef|&MV?c!B>xO}eWhhE~4|GQ=
zz0{dmz;a6ha-wMq_pi;fsj=MABltcqem~T$(?{<HQqk*b+Jtb~r@lgFCVYK;I<~O3
ztF8duaS>g!a1+^xrM)@&)7M~|6%Gb!Ss$c5YF*4lz_$jQTUWL^J>`f{GC^X<59v#j
zqUX(m%tlx1<Kd^2(y!wm>wJIUbKTH&az>SafPgLNfv<=ra+I~&0XraJbeMu+s6{c4
z9lw2n60T_&7s!v-AAYnA^kOw`J%U8K=Ee=<npchD^r4Gsl!mR`QUmXUR6frd1%Xj2
z!9h2CY4*B<#NJJ9_(R-wd0Et~lkd~qdoS<4FHK&OU%!USY3rL)k?;#-!3e#`Xz{<O
znB9|kelCsn-di26gg9D>t_LCdopQgGPlg)S$=cx#$<U%kzRj_t(%vqBY0(m9NYe79
zYXzCArruYhWfd$;hgGQBMe}TwPBXaSU;VTBHiWiGB(Q$ia-hwTvop`Jfu%%0Ut%On
z*BizJ<TYnj&d<%+@kl4Oe+0H$yZ)dK?AH<KTF&M?Lgg4g^S2I(K2Qamejh9h{v<ko
zx^`9z^iD!P0JM1USZfz-J(pPX_fHUoKC^EHI+iY|@&=&jeU7UEMEF8WftKVXgA34g
zF~&H)i2i@|6C|gza5ZR#bA;YYpd^aMn+Csq{9IAaK+Nkv6)YP8KMtrwA7x&2Vf7GZ
zbX#T6No53(BbG~g_Z%S+?pYag25oaTBWh%JeEKC|izv!U;kozcHHelf)8|xqORYp#
zk!%AgIdOE+;vlYX<hMD>=7_Z?<4qRc<1q0wyJU5k*t}Rr$n2H2>kB<ooYoc^enLC;
z$d;4t9Fo>WK4jUq?k+Q&^m7m8Mmpjz@PxanQQ&r7!8^YE<h7s))^k4NEhtS<<3&jm
zlvrzXjyvoetXvfrn`GahSC#7e@}OnO%huhmOA?eM&+1?xy|~5bI8X0*Wl_TUTuzdM
z{?%IEaYghO2-hzV$A=mqrD6W;_D9@MbP_7;TQ(lbtFpbBpxwVRuF2TV!6oO>P`(-`
ztcs*s(}Q!klj-5Wey#vu5mS)0{g%MuONJne+!Y%nQS`8v%kdJ3&nuc&9zPkUP5cEa
z3tbZEc8m>c1MW_-1#p#gOVRnmpkb-;!h=nU%`?5^wDVp^7Z>(#`9rGohzgO%Xax@7
zDOyX=9muMA>Let(M>aRZe$m-L)23*ZYpc(Bb|i{(Z2RZI_{TsTpS^(-^|!&8@cTd%
zs|9oye+<U_zYRp^A$hu--v^`JA4A>P^9erp|2ID2vSIr;<+=T0?}rGPd(&Yl08ob9
zM{LXM?@bf+=gjX;LT?Moyn<^Aa?Nt=T-{OV`d{q5XH-<%x-D7=f(Q~MXCx{JD1u}P
zRI+5rNy$(YIj2HNl9S{lNn(NIEIEVZoO4Dp1yt2~bFF*!K6|gd-#Po;_gXvW-FAM^
zCNnT<GHZ-)j`8*W^{#!6DVlO^q>3uxs`3%v)|><)(9O^Oet{H^ywPmgwa{lei!%#;
zWD+cKtz;Jw-ef29+LK_*s8DiXDcSSM){ud4_lL$+gv&hw(MFf|qgFd8(LUL`!Gh}r
za^!yE#R!=bnOBIR6*2G{dk~c8>G{yx{znQs2~R!;Nr%@=xEbUYw&6Q+X8kRa1=*Ps
zPh34@8;~63iXBiM&x%}Hx)(GN`uGb6Q)DX$R1yVLzVucC7#twxd2T#{qft1p%5V>%
zbk$|Zn$CB~DgQ|?wK#;TMv7F&+{8Z)@H3EGxdYj@BlI1o$DZWp0=b8^WiTCQd|caI
zuNkdw)|_Sf-k9<siRerEM!-*@;2|jjq25xX%iH=o<=Ifh=X9~dnp4h=3he~o(Uct#
z(@1|uE*DrWJTMr^3yx@$3a~oSR<P09d@e_JK(F&kd>2g|*+YtP;r35^$OJuMbMpj}
zHQQP^k-|;$<=9Y+|CXryaL+`_PQic6Ao%}PAU{TtQ^Julr5*R?!Y=g*noZc7UE&9=
zGEey+%a;I^HhakV9OJi9MDP{PZQr#3LbZbV$`li|B8hsTGFFrzq6G)ZGnz9>_s_1E
z3f<6BC-x?Yt18qMo#Ko{;-ZcEA8KH{6Jjs+^2A5CY(H1I6D`RYPAsPuvIW9m28j*v
zq@lwAH7p*)AFzt4&zezd4J@6??<B~`+yCZ0O!#*lyuYErdPt!9$fBkhZiq;KHzxlp
z3s$v4m{vGme4P|D_qgzTxzCZ&`1hOJTVLNVppP0LD<Ssi7C_#|x0>d;Nqxh}|8k7@
zdl9kUd1=)-yS2IjS!%DbK*&=IkO>v$#H~8tkdQ5Fq~7AmT-*RhtSo&dz{#FE-6bD^
z|42D`gc<ch2y+Ied*(26p}ZLR8z^QupiSs@Y$nIf3TBy2!<Wn@Bl7vD(?qPa9RD|e
zX;aRZvw30~eMaLS6`xthGVqGzJOVE=5>7?$Qhyn<O`@W7#sn~&Jhhv?j5YnDUO1ny
zx2aFY3kH;vqs&Fox5+YX>BPGpXqH73L~UC>wx5J`Akb+hrpwHVSFGuqOq}C(_60aX
zep)T{02*R(eDK<tcmY<0fpf~A$P<E{#ioBKo{WWlRk}B}Z0&IEdg=IG)RB{IUTWe{
z-EEdY`NJm|oS*WjSN&+<`NHlkaz5a}{PqJBr#u&=qZb$A-iBH58fBeS@1+`|@uBC+
zkD-tZ`z!M#BjzE;Jv1$5=FixOD-uW+|5CYCAt9%dpLFqZB!tqS<RNKVOk_R(g8-Ou
zQr`ydof~9J!ZVJpgA{|4Yc(m`br1$(V`H)i0tuOfnB<Nl74mJKe}3urOdEC+XuRh+
z|4Ay>^bsJ;nYpd=B&&|<v#7NPjV$wt5LNck#_mZ$Q;JZqS>J+qqdUs#meq#}nECH}
zbOz8QrLunmh$I|4nhKUgR8-73w;g2tZ7!vYXBNb=^S5<eQJq^=;L44A^m{+8HpP<S
z84?tQB$!{?;w{n^V*-h{-o8@q&78VM%M!ns7ZXvtTBUsOSK3!ensd*mAE;SHK+F-b
zqfxi=(!a|1IR=b>4MKNaiJ=;GD$gUONv^36v0Ps|*o8BGIXCVa-kK%bPE4%fSY>K-
z?>p#-x!8YK>BNroT1svP=}*~m9SxD1jGW`8D|ZfpM~?&#0eJGDu2e*``9zO)v7wjn
z<Zc`CI(r`d5YKK&HoS08dU-r$1gfM-W1%`s)1V$|_-drBV!{R*Lj8qx9u*gk*4J!3
z0l^mLI?0(Qh+}>0$dcVJ;WW}=Tm7i#eMO$I;A)-WWc)zj0eOA$Dc?l`<g_xT#iV+X
znL{YQm&AR=4QcpvAkHy+N--%pr}J4@(pqpCemz*}VsN3YP&d{V+F8`x$_)Hj$yCEQ
zf$mz*7JcseapAk8bCN_SC+(>c7Ph<Z_rM{kTnLRJ;wp<UmrfhG-Ar_ODfRj-_id_(
z6<LpBfh=-gOF7J_cJ9%44`#7rY)&0D&2l%3*RTh1Z-%fQM0zlTe6gk;)LtgTc$B`d
z*Vx0-t(Fb<%tx~$C(|29uFB81>cjM4#JTecgGHCuvg~JhWM*}FWv?5nWNI-kwAte)
zEbM*OPua-~xAn@qdyjFlD8YH}<#0Z8PvA1S4$~;WlsMIf+jNJfs83eDf4;J!05Y=b
zXRO6s^83YBQ}elrt~9qTC?`d|Vuj)4_c0&QXFR`w^sc8RmdK8$k{Kx|V)TJUBuT$8
z3Zu)QHca}dcz4(fXBrC5>sSs}K5-fDd=@^pG?E8(uhHX#n?wBG?7l3792}ku%D$e{
z-}H0}?hk%=jh@nuy4^6jC_Zavj?l4f_Y-FNh-OQy_4&j%=2<!Te$1u#m16zvEB}l%
zv^%<*b@H+h%j=Et6VL{JEN2naaBnh9F8Q4^KByPPncOmws8XjHt5FjLb~Yt><+ey&
zYxfGC5myG0wP1HPX{>3xF^}DDzsJPN{`&briOe3PGORmBTNlrMNJurXKioI_`_^Q4
zQM-cwgC>($1<-O3!Cl?B1E*#sdYua>wj_oM^F_Cm>l}Ttha*N^i#N;xWHeRoGGro?
zFn%zqxb^HPAE;0X&aWP{Ph_p}jK;ZOOIshT=H@Lwno1P*3a83=C4J9P?|P!5IwJ8`
zO!nJLQ4)k!NE=+CuEXq!>yBfW%pMrdVU;K_jd8?oAs&OAK{};G73Vc_@XveE$H3Mq
z!uu>kJKYxj!0`^J%lpEqwh5c^7J-^LWX4=nHj@fPKC;(Q+nPADT;FHknDiEgn^0u)
zIoh-)D%KJ<>}jb_*Rk)0PSiI4sEC3#w>SC3H~PA;)Ko0ioC%kU2bHqL+n4*zSl9Py
zf6h+xEL?b7Q~dnM1gNN(>dM}&72<8*SwenPks@0xLpB84&M<1S6&69lI!BC&XJt{=
zOr@626rTCP&Lvg-r^4q{ltA&7j0b(Q;O$fE;tYY8it3ehV^lFm%mW#+wqU~+xUC#R
zkVRXNHk^%aB6>LkmM1{=P_-Hr&)RS|<yRjL!i285kN=Llmt5>?W;vFgGH!65DOX~0
zkZ?cgFwWriY5uT9o(w>Hvg+UTp~cAj5E?MEpw7oO&eyAV#|aZQu9P`eX<-GGbN?2k
zVRYH3CE}DPp7&(li+g-Yy$<b8mS?eQz)RZk*3|d#Cs<tzV%uwFtJyFCwT+~`Yxj-;
zWum6X_m#x#MLW(C<FU_odt9+VgXXBW72$z*{ni<6S#B`80V*C!XIrtWb12{=vV2sc
zl|g;sCUf_rE^FT4Y~6kCjUQj0T9j^MBxP*y?1=c9j>g#JMz@*d(@Zhbd|uB~{z4oD
zSIm=R%|$zmuP4&Y*nTjGuMK$<$z;sbb9~6mFqT*oi+DYo-ypihfVVKjDK^1`b*{3E
zE*i1Bw{r%nxeBkiqEf@D5uVP44}}j_Hm{l=g$>i6-}X8~mB6v{yo73wFplaZ4I@h<
z^=|-NtbDw;dx=Uoq0PveD5Otn6GCy4|7!D`%xz!zyb*n=$$arXyRq*as&r>4zjG%i
zy0H%BppE;orgY$$N-Jtg6kR=zKUU^EXqKohBoc)WxrA5fv9nWMKLfmSa7Ax5-%QnN
z9`rfjbq-AM#xsl8msx#+bomdp)bcRYNOZ~B`9MTdp&wW>K1!f{AZBTD-m1?NG#g}(
z8#tGvf?1muPIdLV>Nb-7gxL4;Q-<n}4FV*ZPV|KOz?`xzH@J6dBb}6s%y|b`M{~N!
z6zGbla-SC5@97f-mH~vyXXmB;K7`5-t4mnF+yw7m^q*fctZIQ*u^wO~8A1iGwFVY&
zuNcD#Tc>pgEicS@Fg2V-Peb=?McHAX1-1|rwl>LiDOmR>6jRgi4b7?j%ZhU3$KhQ)
z88XE~7PF`PQcXHhQU;ld6I^=Gp{jC{aYy1bPg4z!S-#8XmH;u__z%qIiNrq$EY@Lk
z8c6W$NJ{`i2{0EclMP{sRg%m78{3h81t|K18gwx5D|$JfjH!!2AhGp;k~nif6c%$x
zbmtjWkoGyl1n^oy33m?;x;<yf*z)7E`NfZiSNH3Dpu4s{ScEn7HOV(=am{Plm6$G{
z<W-*emi5elb9d*wiqQ+#&qTJiP_r|Aau)1czT>XbPoy7kKo;yQ$k$RLA8+meMewS_
zk<5>8D1s%A9>4)cIP3HP!^0nf-m-{tCzc=FlLGU6vBJ7~-QV@POWQs{C8(v|f`T+%
zDQ{<4GN0(=sa6~K(S79mC9ZU<T(7}?tyV`gs_s#|#L9lc&^ww0Zs=IH2Y>q=3WR>o
zz>M~p#yn@gR^5DZTk%9ZEo#E=50H?_XceRROAt8k$;Wk!ZA~dL-sg?GnWvBM@W1MC
zSjACCiC2l(wqo8FCOlh;`8Uv!bnXx2@Lx9v0$>lcq_7>T24LU@f_%uNyn$u8kDOu5
zS6D9_A%X%O09h5@t6D~!MxCI|{lw?8f4s={6CeD$O>e^Et=F_gRLUw=-xsW@VMMia
z9~fG<w=q!(=-@N5)4SExLmLBjRwTom#|5D}A(xmb7m7G5iJcGZY+`jD2$Q2lzRkdX
zeN047sPMV!cE`cW_OAr&gFekE^CVJ&IXGgX3QFS?MxOGOH?S`AxY;T?-jp3|u0brZ
z8Z?j;V;Bh$9|N{W<rWCnG@INEj*UW__>?cV62*!zqn?%S0M#E9957*woIPF6b>aQ2
zW1L8CzKhAPBRsj4W=pJk9{1z->)tzx-Ka3{?g3Xk#ysf%ht23XpO2ny9Ym43-|Ko(
zA?a}4O8+q<Ifq}G>Bme!>gOo*nn(Tk*JnN{Ex<Xe_^wl+08x`fCUnKTeCLn$J~L+Q
zxgWxFtiC0GVq$zcIA{;TjFnr#P->{Iuc(V1JEi#Ku3g;26z}q3f;WvwChIF<xn)`S
z&R4?9$NwdpZ{q)f@p+O0pr3#)1o8pkbK&zp`=0+^nOSxZ^-Y`thyheT?ztzfmIWSh
z!Ck~mb?=!rxye%WHU_yajpl~)mPbF!PjjY?aszsmDPr@OK^+ml(n6@XD)x$tWDVz2
z1|FQ`opHNhe)!{rC-;k=2dUJ3s5&K$XXdc<evObj5$M$2{`i9zp}Q?Nj%Goq%_%?{
ztqeW*QW4zhByC#(I?<fumZ<~1>{~egMjEOT43FKNR%N;vsFCjhDK&4KIQeow)JJ@7
zi;hHgj3s50IpxAt*~vk)kACa%%c3HaKp`x;pA+H~-kQf{hlE8)eT2Jnx`OmcU|wKG
z8MI)Czv;5OH-JPhX+6g1%HvwkR&PG#rY01GD3(Wvob0!@5dUB_aL2yt7<cztqyOqc
z<?=wz)=2fc6$PaGdp8-IcAL0-RZ-3lUdf^3;DgEaNmM+bp)i}-Rh#0CM_C^%Hvu(G
zFcKDMfb?c;u|<ehuso7|wao1m>AMX)F~O6v_Tfk{8GsZ+VXF+`agyWSiY{ak@Z8H<
zEgp-fu5psg3QsHrx{U^GIEr2S=o(<54A`P(h3=_sU@|o2vi2Neyv=n?hfg>-`I7Ec
zzw<oHL(%uWfl9gp_wALLzlj4iuHq`k+wD=I;{1rVETl1FmMtEbC*AX@9u#Ja$(7^p
zm*L+#$k<x*h!q=Dfoi<#x$k&Sq~RBq_mdNfpdVnQJfhgg0m2ry&gsKMBbehRKwKTz
z63?ENcL$^wKX({2O~<(d@UMX=8<2V5`}GRX=Vj6+qY{1HA&Ye%rMb&KMmH;yNXl><
zHvCYs3itbi&zFAq0ajA~N_o=1at-ItADp`_L>FZkdnp3#^8<<kox-2+-0gVi-zdC`
zK8!Ub&JE0a(-%&Jeelr!nGbm==vt%)ToDy;k?E%i#_?unzckNU9ZB>Q|JGSDYF+*i
zn5D&xkPrUU8)Brz?hh|o-vMKEt!s<Y<?11&yo9_J9yH{gClLICKJ7bAX6BV40j*$j
zs6bf?dO;Ztp`cBq^0dtF;yNwpAss+kN1R~jB(7E1H9cn!F9(s>Q9I>173{lbz;!{x
z+`!Bf`PK$k6Z5OcciB7DO)^$qPGn&-9ox;-3+iMG6q|3i;|!eX`6eEHdaN9HMLGJe
zcK)3$qlw^rw<YG*H-y1S%Q|~x6BXRst!9)DOn|t5;bO^$V%qYWo^Y{zS3=S|E=3ed
zDfcww>^V!2pb&%kG!+m|e`NgzdR2>723AQVGDx<YVATEPYta^@BFNQQ>whlzSDu4Q
z;y)8pGRQ^qO|X5^mI=H}CjKHY|L%|l_^y6(#vE_v9ad=#`w&K72{;Z?*xSXQL`s3c
zU7i}<jjK?TH&teG7kDCJ?z4UO=(T4_%Ry<TXMVo%TbY$*9T85e3~excZ=n;G%PZl8
zF#Pf%)*O-6uI*UK@?6=OaKWGNoKh}}9)n6Uabdl?aM*k;I@Efq6!tdt-3U^(z`771
zJXq@KUu)BQcBRL}i{}@fA4<^ctd#|3k|J?WqVy2M$Gi`CG=LG@KQ=dSI9ja`Vl$->
zMx-`(wB(-i1zWpMM*1yrEUrn9&M^hRi2Ce(*J};f7!mV8T^Q()63vmn-gz+s{#La?
zv!ca%3Qmj!qwN6^2N*V|f><{_f7`_vj#Kv-&N*Ql09*Qm4`X&z-{OBxBNhMrSOBd;
zH6UAQ2tyE}!{w)duVz^VP!<5luI!0`@<^#dx97L=wTMSm`%s(%8;68jwZ6<`y(~P`
zvf(*snM`W!36iHoa^?DK?R0Ksoq@PQNvd<>^Y0(?<|q#yLb(FjsanN2SBCw;*e#Id
zPr7$6W4`kERdWs*p6a1qtNy5;%x!9_ix1)9EV)mB(F($tKy4Yr-T<Cy0<AJ@c<$B<
zNEJmc(bo;if|iFOItL5h%|R<qljkF5>6{`th9h7bIsnR21G{++DJ&r*nbqGDrW;C6
z@raYFwBEp9oyd^G{Q4EgTMMC)jf5hk;NH)tb0J<(>pLOB4~DQ#dRc-rsHkR{icOg9
zu`E)q2Rgy`fUwLEp-T{UoVu>JL+(rXy}mkCw`JVcmc41(q{4y4;pxLSVYaL;nn{Vq
z_pSw3P$nj8DEYB55i8LbTMZUGmy`M%apQKB#YTVXfgDAT-(YA+gJ?l_xg0Y8?j)?;
zt^hUy$Ogs@041R#I2Ka>bHP7-4mmv(D`%_vQ8#EKG@G9w^l$4`>eH#0RjF$V3zqeK
zk_@hCC_GzksyRFuRt@+;u;0cIE`OD2dY@zLeB=YWS>E0W@1P+GWJnhOmMrlPPJ6Pk
z@-0toI@rIm!=Jw^pKG>$)$dp09oJ@e49sM~@}Sg1LWUEMSkGu0hF4B#PtOTM>&#~A
zxcy!f#+~13rT->`@y?j=S1sxk-2MBpzev^R^v2at-e3bMc;G1gsJuUSpiEsCZ(8Y&
zWB9vU+IJa$<&pkTnX>&WyLL4Sg+po=fZFN(4dlGyTmSVQBzx>!{TYQo(EvGb@h80P
ztQ(l{=onI5n!EHXv=v$Y3~R&fy~8y_&sYO{LsM-kbZSsQaX)Ia%R_LmeQ8r{SOzyh
zc`5lpWiQP@-yAk*4g_-U$y2;E;;%{27_Q|ng9!Q-l30ABy`OLdk@eLJdv)Z6|BNBR
zU9HiJeprEwxoZ3=PP&8RXr@W#{@YZ|h6ZI$B^LkDFjKUKVk~FdsnwoVrO^KQS|Lwx
z*_sm{-X<r^rH)jJI}gkxb-Y#SxC}`+Gy=D7z}}`TR!!xOt(~%$&oizFulS#r`jomv
z@IfQr6BaO{zuX!TL8f^&{b}nCOnQ-uBwFWK2hLAQm-S6MAbfQP65!qmtrQfh>F(zE
zW?;`-g3MrDi_758_+GS3k*g$@B?D21FK+kOvScLg8Eva%v$Logk?v1dTtAx)ktr?(
zr@ytS_Ubl|eU4Mw*0Zn4#XqLkuaCKGh0d;BK1{U7fYcow2(h0YzFW-b9C+t&Dm@k8
zF?MuGr(7%V(7;vo)PdWRf*tdi%zXb<J%MT6!{=f_(qQ~|3g6~l4;I!ghM=px`#ZIF
zvPRdNYt(&;Kv6$?i9lkNZN)JN6N%ao-Fr)NI3jf{DXn<9osAKQYKIZbH1wU4nSD1l
z#To(mdBHx~OwXZ0F@<oYB0BOtZTtj$<I89hZ~`ZXUWEEvyYm9(Xo5W4;SDFfn&*Z~
z6)zOeGEflnt2chqitX2>Icdn2{)&3r0jG}*CsJR&U%%)!Hdz(~Cp=d!pFH1XK22iI
zm~90lnFLg7s+yYgyhH?%t)8D`kxmAzQ9)er3B>}^g+=lgnLn!<zO&90zD&Q{pK!{I
z(HND4*5+4qUjB|gopQpx>IQQ^;4b^Npr^2<cW1;Cf14rCc6UDuPa{J{htA_s<UJIJ
zZCf(KTw*?vf+#PcrW)ba3w0^_O!grU`;U^>eqt>v+HirB2L<99@CG7f4Jn+nZU{Mw
z`dDDj;OU4n4p!VbsZ4Xg&`g>4b2EP{8*{G7@<#UKQi#T+ExmUKghg)pX`{>vs9??V
zd~z8pMxXF@vv6C-L*+Yn{W{8A%7{lLlv{US_4>VR+vk0>qGL(`FGM&rOhd%UKOA<k
zcQB1rk$bCMYp$wynWFKz#wtfDQu!SVOkX`RC9Ch;JR|HIcNAf!^GuIKt9h0AiG<W6
zxAog1UNFb$e6x&7(DuPDb1%l;&^R#Xpl-o55~Lw>T6O|~MdQ?Vo9FMESBYp&yHLHW
zBIgl~4EU;=*=nBQvP?$Vs_@}q!BNi5G#~4f3C)UZO}>6F45bm~v<BCddAZx3LHUg`
zb6=*?&e)^mXNnQ2HFq~>oiTg91T4>VLCT@{WiK>Ge8u5r%B7RH<jw{*{$i2|e=2#4
zm*pyBKf(4_GS%E0#&p@rlIr6FPxnQ^#YfwLICkq@9DC|kYR0s(`31kuu`3w#>nE9?
zmGs*SiQ$%fF8PHY^lHWA+lrL9<`vT}b4{FjZPWD_E>?QCG+19<>S9A%+vL5N0KRYh
zr`ixp!nwSN1y}vJ8<mEIBrdvCUVy|L`^52qqW0)Sb+RjlgN;t`36PPzzy4K#qPFX3
zGQi}knh-;V^-@lWLcvGq-G&6Q38(AHA@Me@R|EF;+Zob|mdz6nge)Uc#TYuqpSuRR
ze&}w`-9UM2rn-9^DaTnST&fT>_9udatz*YKseKA&PR)XqGa2$U>L#jCQc-C$!#`wB
zOK4NgINrp%tIJn~dGpFRJ=;%gMMiRdo@Q)F3louwpvbw~4av^zm@}I&?O{8(A?b2D
z%+<GwLPu@@fG7-Z#h~I)F-h($MgZ}C&~&>(IMtXJx^#CQVsrY|-9nA*#SZ7NE&rja
zY;99qzZi&?;iNbr@sw<lhN|X90CP8OW0V8B*Q>r08F?}kMbgFSCgx@)v#IeQ4?bwe
zT<<|B;kZ0Vd^71$T@_3Gper{|#syG>!}|^NP?js;<x92Bu!WDAom-!~4gw~xIHds9
zTuSO?7BAw=-u3g+KpxS8EB>m_i=hda;0On5^Ky~JqwX=0m$+<=R}<X7?%;O^;QK6O
z?s4Rkt62!zHC-bc`!=P-<iIEg-2sN+#5+2jx#y~Nar!?CUM?i%4{R5L?l*t1%h#2;
zOyUkF{N;ah|66>>Ryq8V(@G`D=I8jhmmlm=oHj*+-Xkgur#;-BZ7n;|*Y?VZB&a-z
z+xeGMc>CdHvDoOD>(9snS?`0LN0sBy9L;n$xjj&UdHpyka%!wE>h1l)yW5}b0MCvm
z3EZ<1N@Bj&vti23X_$_~ksX#so1qaTlW|Yv4kC?zscoa^7rJqZEzaQ)%vzs0sz=Qh
zTS0z$XFDPm)6;3rPgXgtPFVY*O``KRvAklHchT6v$3p>M?Mzut(mO;wooPMq7s}t2
zluMwveYwB=xL=v}gCG55rl_#@-L!?f^ubY^YQw9+<pIMFIw*Tr9y%b4Dddm0FS~Z7
z>fVLZYey4~*s@>0dwd;HrI~6#4!`}}G&-{~X@0_r&RxSKRmGS%Y(pw~O7#RBRIO0H
znWjRYC!@&gQV$7wRL&mM7=NKp2S3&5iKjZ_a~4*qR-?BFeX$T1dan0C=2a*+yXKek
znOw95*_ltQPw21y295aW^{uVuR~?-Wx<%a|?_|vEUTg9*{>o|*hN$OFk9n1c32Gmq
znPeH(I7*|wzP8M8Ip7oxPOGG5Ke0`QlHXPk-ukC(mWo=?tvuf?W@O(}KI>vtavfoQ
zoZ;`mS`YwVD5N!YX3q1NXz2PD=C-|SF@$w`uV+(-q(^MO*dWAgxDfNa*hKl$J@3|!
zGG^WnVH^$4V~YWsvoy~UMNng9ZZ<ub+JdhJbk%{1w<(bY7|{X@A;0vaPi+YkpFa6G
zf~lm<ws`Be2U}Y4C6&juVX>2Qb7R2%$@2C+{)3sDi;^?iUpz?#@9C6q(K_h(95eD#
ze=mLRHWZS8L$8b|)&32J*%vp}o-Iqoa~dh^nugQCvBGY_VYaL>*0^Cd_f`!tWxMvu
z?TIG!Lh;>4PIiFv%e5f#F4SsToL<(!bv6lx8B5@^%QrUR6?H;}N;|%GXejT-7D7F6
zbWIqEUv#AExqY)TZNuM8|LF87hsYrw@^fBh=Z#F<*3*KSbrS;R^P=#%nMi4;{cn~P
zrMe>wS@X!EpuE*oX(QowY^fuG^BW8HvmrpLS1DK|DP^{U;d(PBv%kov!iqBN-UjCP
zm`I4HduZ|D3##8W0z1Rr)WlpWyl8)M_37Hr$Dt+x_COSR8`f*4p628ql`nV&|9&N}
zoc8g>#I5f;?CRm8DH)Slint5@N!s=@rxfkS;=xbnG!CpaSvA+=qH%95a2S-DQ5?Aq
zP$UPvg2$bVV5^?(v1W4-I^QFVOLy`K;*J5v#i(x_P3Q+H?{r*5R)y%^W#Cj>S9<V-
zFwq-OREmbge>r?FNf*KD<t;2(UE9@Mp)a)~ZZ{IHffFq0NTD(w&Mx-$l{jq4u)4(Q
zbMu<{X`i!2)Tm*ZN0z&^yZ>w)Y1%PWXxdF2fF}0%pBJuU)6_FLq#bqo-I!oN+_%1D
z+)xhi6hsMTH+mpR9BEMGEAl@|0)>#n4BKR>JOLL;eR$M;k$WAP!(>ekRfc2I%6O_i
zaVgo=3~we!Ls7BPjO&|f%Qpnp0ny4N*N)x2*WHvvjv~el%zT&T++4Pwi|j6pF2(_9
z=ilI?*KYCc44I7tOC5l5tG0CrX{;Q}MvDC3$Y_QB{yPWshZeWEZ@-sU<}o^5f{3k^
zUUK^D1<(j!1d5x7RZ*|zxw3w(j{64~1r#V<!$N9dO_(rY(Gg#yb<b`T3M=&Y(lBTC
z*Z>CeR+J>#8JOKayPN|=1A*fx3dB3mID1>~HSC<dq!{qP#@cPUoCmUCWQE81Xi2Bv
zK&`)@Y5bcrq!?kpi)kBZ0t{VxRWx{Tn)Ba(AGy2t_}?)xv5pnPLZ|%wh5*emQY%K8
z^_GO04Y%8iOY_vVMh}pp5<bJP9+c*f`v?s$y3BAU9a_fvAX#Z8UL{Jx!uc*AGt#=R
zRh}=)*J1cpl4ImveIs{NrAK&qF`r+GeJo2sKSIi%5ad7{@JW1vCYTwx3BN>Rtfu~A
za7bg27gZ=^q3${*83wrM=epC8?l~$Cb(9ls*DbFWyRd5PZ@7lwk;NZ8d?@C)4!1((
zOwc#XcLs(FD9dtxuvjg<oa8C}!S0S{kf}LRihVHmcAqsRkSbDE@~(#0iu0!5p0Cw7
z{NZmPmFn_XXCN=6_JS{;xSP(8d%L34(WiK4IhdZl1!1+8gj6VYPkkHwCeY{*d+vh$
zRt+km%4C%MQ<j;tM|J3q=yIz#_9#*-%RNeail1$qd1P!(`GxKI{EP421vE*1EswFx
zK2yOJmN5~WddHE4YepcWWrdgio7J1mNQYukHM(rsaMSQRxQww5yWIdcCVB?4M2bkK
zRhP=sT|$L-kDE%}Z|)2v>-YaSD%Xu;_^A^9s1gBPQGPhLN1Yyj1YZ+etE#Q7tW!vj
zE+%2A;C)zhPf#^24zYq6e7u<7@dOHIKH;A#u(Q=K`7|b|`542vNI_NsOljixJk1eO
zkh-c^-4Y^dvMSK*!Gi>wPbZ{G+;NuDx&K{ABvh~!r_@W!!bGgO%->tYWyOwYHwB;g
zb)%LQo!WKjYqLHYT`hh4&~(_BCB_rB)Ld`h%99d`%W2)0-{0e(3`S-zX+K<27Lx3T
zZmgD%`HAjJBh1JPk9*Wk8W(wu=95`!YAENqsvD&%WxbGj!^+B@Sr#h_*x!$x6Q>{M
zEr*tc`|2Kcx_;6K0RQd*L3a3YtXa`pVHL`}W}duq%k_#%loRr;FK57>MIA4!(~33D
z*L8i!Y{4li5$@1{Zq8LaagzvYKYBSTDk7e4f^|FHe+o5l>uV8lO<0((40lQa%_|2k
zKUh6UYauMX*q?Rr*ou8jzw~%+=?<@n&g^G%N6-Qh2zNdMw?G_6dyg6x)@1Navc3#n
zW$=pZ)KR}bRyxOA=;vy;P|?ej?%0+pW{9E}2nZC_8;OT(Qm5V(JrA}lY?r;)N|9pI
zRm}oD8Nw6h6CbJ-(na3sS*4gsvPAJ#8NXyPOQq7M&6vO#-5p-1qgd4n1Fu>RIM&Ps
zsCMP+?GX%#=x?Nt<_0tbUTdH4W^^~9uiAX?9z$zVq3iQQk{3|vMeY<DtT3|@M^xLR
z!~}0giEc4Zl8wZMKy)5YX2HUM3)}MsEejhT?Ks2Rb;Xy%Yt>V!YlnC`<8V_i!S~Iz
z%?%1xTw9-^<{j(KrjGZwcO__{fFt16aZjfr=9}6HY6V42$diMzEE?K22S!{b|Mb#)
z@aG{rfPYQ!^+dUIm>glJHfgr_P0CBKF*#_LC2;cf+fI6dgYr8ih`27{yW5>GteIW6
zke7+8F5@=3Cy~7yx1yn@iCp1~7ozscZ#8S8N_QN*RS;nXas~5w@XO4iyryra#DinJ
z2io(3#*2RJVg;CA#P1%{m#?NfUbRzKA5P`1&S-kft&v8~t%=QRw_|YE?FpQXn50Dv
z6Iy{EWUfrybl2bA&PYjl&EH8ZF<zW>`jE{L?5u^g;om4~Tn`IM$w>dOx=h>V<3`q$
z=&3GqzjrT!^XRq!_ipNplWqoq9uF~+b4ru~2vcT7+&N_DR&KoWCFP&npJ_Q#FjFz}
zVXX098$zzBPETErx)19Cvu?qH-P1>r(&5ova#ZTk4m)0<X8*wXBn5b%|4)8&646p9
zb@U8u$7L5y3Ao=xthU^G1ES^+3_tK7!*23X-vOk2e;oN7AO+BLz%H)=4lT8x*w`Ph
zA<j*sdG>Dfvtz<Gy$DD<h10ID3o5=et6=WiZP){Gw|TM7*J*;+@91+}C2_DoJ{nTq
zZO2}#JfEJHRz-yv5dij8VVx=ZF>>|XF7^C0c)y<C|CJ)di&fC$Hc(ZJPj+a469oh6
z&@d4U-OQ_#8R^A{+O8+}>NDSt*hCz5RdIbP0}qB!0ya1{EB@iU8<@*GWi<7O@!VMi
zj`GRja!}K2s)-}&F*?p$4)e*T3*HBC>*UAxLXt$DDb|V9Q^Aji*LwoR*$`n`$2QdF
z#jC@_J25g24&U}QGff+AMf34^A6saKr{M>!Gc%`vF6TJcjAkv=%E$P@Q8zVk$AlV9
zagizW6f5ng4pP*`B9-)a3b0~5@BeB7-)egcPG6*xw^a=}$&WQD*w-{jR~J~7LG$)V
zet72wnTu3%6DBrOxLJd49RGNje}2dRzuo8bL*%TW)O#}SOo{SjLEL<4CwU%$O(&k_
z$1Xv<0<UwRqeNW-AUdbBC(KKJA~&38Mv|xkq)!?0Wi5gWiV?g%z6=if7T806cprVG
z<%lhs8$iV?$m>|7PKClaHVS4vjtb;!d7xalxUX(?%%Wzv{Pt{Np;ySm)a|L9d0)4E
z&L%DBF(%I%4w5C}n|9kORO^=MbnW!<;L;m6Dj6*r*S^-iwqe8POZB}-jFSr4Nx-O3
zynBTJTmcsWCK$yvf8#yki4)=sHR=>6t{ZjcvW5{X8?=YeXF+MzhHyA^V$8L|%T?Zy
ztA}qm-UYc^AUS_UWS)b618s5uAu}uoO?K5ie8cb?=rrC6D3F^@L-$ULKdwatpER}`
zGM`8nuN5>2l<Mm0>RV5<t(k@OnlrwCYKbfKh*)dx$L3eUB=D+{H&6)xz<|JFPcsu~
zz;Iml<0Wk5_x&%$%4qH%nE-D5{!f<o&an0$h}qvjuL07D8XSyhxbX$RRR2HS%_y+;
zxLvnE5dw25`6{5)Vt@DMG3FNGe`0W7mJd)R{{Mbs263$nG|Um1Xp)0Nto2)t@ml2l
z25>MyNQ&i7_Q45tF*@`b@ai)m@gSaGC02pXGvMH`i+S`|Uxoeis;KNxMCE1BiA=aJ
zj<@`AevhDw!h9x3X+Ot3QSpTwE4)bmC1XqEL-`!e_d+VT?FCz}Ag)(kbIaX!k(Y)9
z$86<dnV-<~No5!N^SE=*3#>`Fq0XBLyaJt}-hC4f;qA|GfTD|PcXVMcQgOP;sBjJe
z>4ME_KJyS^yuI6WEAR&QdgD=~HpyX{YuWq1!xuqkW&g=HS_;0L8f~(J9*1@Q1|n*D
zzJ6%YL5y%xuwpJB%iuK2SRce3Ojvo8Nux(YJmQdcQI_XRp}%10{o*)caiL7~Y?qvn
zC9*4h5k6A+f?ke2R#_Kx@}GU?{}H|Dzr(oufbj1CQ}f~B0OnfDNg?4;2aS@GpMdP)
z&Ghu2>ZDk+iw);}YJPgXcpB|-Qsrx^Sn+1z-a^D|u!<KoatoD>B(yr#Y8`;(Ar%q+
zMTj!}WM>qfBK@QIjH4T4GI1%1E|N!?l*4$@+A27^WR8ZysapQ+wG}&BEwj@Dn;uTr
z3NHtHvwp~2D`_!jBo8?<{O?=ENYIMXV<Kkx6nK#AjcyiE2gR>}px3Pa50MRP-e3vg
z=_Mw9Si+qjq`g-EPKO$o@|n&ZL5?m0N^C6J_a{cg$cO&j8RV!kQJ3SZPH{n?4AI17
zwV0;vXR&=rh*)R8spZ!Ylc47_(6{TK6hWTL|5+R#KUcvS{BtOd`qMBoQXZ9Hc=qQT
z{)dR}1C|1LxBWR517x~DpOZ>75R#C2y08<Ma}+7Y8Q?hZAHQJ!54bTQcLD|~U88+q
zX>u`qnCO3iR=wrZTr%7=2T~SZZUfWb#D+W-ov1C45!6?x20(tV(m)KrC&v-N&UB+K
z*z4D-pTR$tuK<vb`u9vjzu{OR_%qr#is>%~IKa`Eta#}yX^<P^gmckgzGLjYBMu{R
zyEWsbp)<lMz_I4rnbXy%-f<7wKUARI_uLfLU=P+G!Q$Ig>%sIB&S-ttA1$t(5FulT
z2@4jVC}H|gBXlP}$3p0;_4oSC{jc|uzdVTfgt4cr4!9^>7VO#mMSUi!au}#1o<HTo
zc<^@u4(jU>n+~)lPc3b*iz>grxtkmb0yLOC!GTDy&DX^}yaqLK$)7|wC(GA9p2oW=
z^tmm&&)O+5t|C3?PIkaX!+>NGxd4#Lt9cT+CxLcZGjV8|4t(jEq|ae^{&T9o+dVJ#
z6<VM3=hpTy)xI|M<mQ(HNtTKXBk<Vw!3NPxzSy_V=UqWaPVytVCz(SPnNLM%;|xuo
z7-@RSYt5V+aF5Hy&JV>p5{Nk<yDY3VFMW-UHY{$o@02?qO1sO3z*!tUpQ%Y%TF<rK
z^2A1$n@p?&JoCy4??tSdiHn_{M6>$w2}hXjauCEr!pGQ3w2Q&@%{us)h;#V-P+cW(
zK+0wh=dEcRvRHRrWvaA$oVLpd@eayXWcel2B)hJ0{0lVTF;1NzxYYWKK!Z<FrGh|$
z@+<6LI~>)){z$nZB9lsp<$T2H*^PsqNvq1796*@DHPlj8Ba<wEa&hA}$3#z)Ur8Kf
zSkU)Npm2+LatC-5gPxe;G{P?SE5a1VRv6#Bt~JwSzXnhsR85BT)akp2FA}4<!32u0
zir+hDYI?k(#?EH&>{M+u-SAOHz~bN-lO;;rkIp2H(qZYIJ{u(MqTSE$V%D)=@Q2V>
zCG@{Jd7^xYy?l~0x15!0oY2DwR7*+tNzpG`2=%OR<htG*RpoUmoorL7kilLSUs2q-
zIhLc8{V;q&)_1ej$b*nSZ&Y}MnXA<Lp5qZFAc>L1SMx^kO0@l~U8_7lCEqLKE7A6E
zAh^!uT=UPw$JG!sd|?0|+Sl^F0?$1RVGNk>ZXUq+4HTKO)uhOl&hpx{cbvx?^LicJ
zU#<2dJl;3hBpZ@al4S}>T2TeM<TU$5>7<!LUAUXTw{^FxNU)?KUcP}csSu7`9X`&M
z1Q{H=#W^{2G<*=&Sj&j^C~5Xzs5RgYF2xfO!Q8%=h*SRo1tGucJkd+g)7Dw8!6Dnq
z(5&=vXxQ70zSNHch5_8YDvk(sn!sMjtpvlL=nvOCnBv#dC0T?BqrbvDMGK-R=`#=|
zlKH(fg93U&huzBS2KX;W=H7RI6?m_FeqNMFo|s6u#an1{4*$TC5M+B$X;)-T9&-)7
zFOT!8iD4|~)-{#cd=L8}J+HVowcDk47EUs`?BQ5`K#ygMSaIAA1yhBubV|bE0bg-E
zcSW?%y)NN3Wy0NcpT#zF+Pm|urH;RWjMDX`FNdHEMWuujDQ49`lAo!0Jh}3!1!aNc
zK&AKDRMv1AZ}8_zMZ1Y=snk%%zG1X7seL`_d)>3EBbPld8B(Pe^(ffx*)wE$7x=)C
zsqWFY^gEerBC=q(`BDRKNkeQ|;5zrXvg?u0E1)pb=)f@mm9Zo5LwQ&<rn98GrCRi{
z_O?76CJy=1P%-5ql$5t)ul&^a^)+T_?);t%lZ+y#zHaTW!>fF!I$~`%o)1q`vzSO0
z2w-rX+T+fTca%NH%J=XdKB=u~Fwdx4z@<Y0y+q&0*lfmIpdr8^3C_AqVZTBop1yn1
zIt{9xIXxLodfW&2zQVXChx3k2s@?7$5Ru%hRiD@M?QHPwkt+)w{OpYCFS=yvBvH&O
z2@+iQD)j5=eHjicm6YZ42r>)yxWZybrAD3r>-T5M`-aITMOK5Za~=5l&MGgiP55(}
zB9cw(Qov6dzJh>+w|h{iiVU9FYKOVoYo~-BN~O#YrZPYfh~LZEO@HYHL7O{#V3AqI
z<*Wp+yC;??5FA}<EmvJkH*9kzTe!!&oUUAD(_)b&yQ4*{Piezo!lVCv0rJXhnz7~y
zAFd#sKtV4O!og*t>2{VI7=}5K0qbrMbRl8F<q_>YLybpG!v!329S+74PLE3B<<Ly-
zXpM5{>SsHgq{=R0F)|^$iQho-b2=sF#zpwSBcFOM*5aM@!kYS^CYg?H;21J)pZgO7
zKHOV<p-=03UMX2WYX~DM#C(hT?qq;-=`)%1z`-uP8Ripn?W7po^+GQWVgY*VkU^7K
zMy3iqP<Uo~oPGemgsZydpmFH^!G(Zkj`Z<Ts&GK1V|cTZUScIg;Mn(OPY`3p^dSuX
zUdqnR^tNdtEpv@9YCF_>>`4Awc;h0o&bSHhYkSe^D|AqKcJovj%PH69D?+tx=F`$_
z^u9`cRPU)N$D*vkav48Ns%G>cUU$u)RA_F%|7NXFG0(M{p;BvPs0INmF(MTA`ustY
zs(*uFUw71<S+i0R=si!wW+&cz;cr#jx}5%eIO6C36_a1lj;B;Rs806d5oskXP^LP1
zfxuHaD5WNglP~czj-e7*f3gbU;C07ux_AAyn31hEQ8B~OH1VA)eG(%~RFgXg-&HZp
zt2QQB4K6noH?|&b+^f~5nNXrs$kis<ryaTxRcd|UnHlJudn=ZZY|ko&$7_q!OBo3D
zFz>YE#0O;Tt#_WD`#dG&ljmkVz{SDYd2%L}JGf0JtNt!QOGDu~`B9J@1_}h93_fVp
zH>5j6O)x&b`3(fjpo;3#6;vu~2j3ihvA<sm5?{(+K0UCG2+H&ICm&w}AAKJ_%Uzu)
zZjM}|Iehkz9v_f31w!da2wFqw^xhFRLbRauK>P&7N#Zk@>1%$s@h;|#8XjaNd_<XT
zMHnBZ8&4`il@d7A|43((jTkA^rCv3y`;%zu``vRv9u%lVQ7*3`wXZ&X_RINx%7L>>
zgLbT7xR)5qTi@&&E7roaRGY8-4<PD^&V?@?q4y3LGOTKK7l-^#xek6F-R3O<nxO+>
zt_kx3u^g`!NNZ^XZ(?)`3jy7CwMXTtVl#(NVNXK?#e4M=L?^VZ-L4oQ^`GCQJCZuz
ztn+L7NUql1a(%~_!Mb9IVm>d;)R^W=%|4ljxBog=dBX74xX6l{EG;?X2}P-|>-Gga
zUa7?KTT--@vIBL~XjASvtN%v?zLp|=x&?$fETUj$1*ipjp?PR`aK2_zTZi{#<p(AQ
z>aIZ)idFYbqg!G@e}U1qcE6feBnPJnwM^)&+xq4KZa3^1NATQwhGLvvE#1p#nO$A-
z>{Go&IjtcxA(mrM$q>}o15<`6*B_yUwCZjHlxFYQ2$<$PVmL@CXA$-!e72A@Y}<1x
zROD$E^zGQA&#CJ1PhRVwqS_T)ws;-X1bNT86ri9wD11C`;7>6R<U{N7k(^8z1+)F$
z*<<X-*I}B_CMmk?Yu>rw56kgbw`&a$uQ0e2X7@=OB^|N9z*ehff~EcyZ}th<W)W5f
z;R}X#?T-j`rN(^2XC%9kvPW<fhga|WwuilA&sS`Lmn?PO2P<0EJPpN;>EA%59Qx`L
zc`VjlMKgej8sAv*5yIr!xn#Z(Q1*p<pnYAy@eIbHQ(A^AuGgOH2{pNK(ymSP%we0g
z{oee^uS%L;TB+j5R-29*Gl?tSXd+y5Vf^#zAaNnr0^wPlp$X)&?Rf(47{)wp=6l#r
z&f@YDtWjf;w4TVp9EPcoafsSP9EZU?klfo1&Ay}@zUGt3e>+1cLhFgIc{tT<N<>9$
z{u{^vRO-8}0cpysGNyHy#sLT7)+mhZeyyFtGC3IDX1XA7(1Ks&M|@I%ZpW{zoMirN
z`guC9`|j+U#bbBcXs}_mo&2N?7s0G|ceD$p=(uwgt$CDL#g7RVkZvcl`lLk9zVZa0
zm8}V{zIdyrp8$-bXH--|zp$oU)Ghuy=l6s)^bI>fAucmQ2<_5;_0m@+YHv;>z^SN>
zZ}9r|<4d$gWuCkF;cp<HWUlF&Q%SJ=F4wsp1QO>Uk`PzE9W_?6v@h&Zlv$<NVkgDU
zZ#X*FYfY!qZ%tw??A^Y&&|net{vHaFT{D(j_mQokzCFV}ht`*}R36B=JzK`SoA-5o
zoP_`u|6WSGk#d&cjn71lAn-DevkZPQ#_Hc;Uqh#pIhhOY)ufxSv!~(<w8v4SEI`SY
z+#1LzMS#aXxG%z*1n&6y!?it(Tec4ywJMJNFLHC<SNE4&CAbbmXpY-6myWbrEI1=M
zaI4A)-j<Bcf9-9ZGsW_)gTER5#r8_gr*F5BUvLCjwd}wlMGZ*2^xaI$Oqtij@j8E)
zWd0o2G3T&~U(l03cn?{gIaR`NXNa}D?$dtOZE33e&Bg|r>_AJn#h-ptlMr8o4832E
zjvsklW@)ILXty#uFKWv@fIKl!?VdEUySa_@OwzSG$b6!|>o~8lQT2J~Fb>7>;+qlZ
z-siL%BIS(-Ucn*flM~yunM$KtvQL_RTnkXW0OX;RV8R#RVDiMN7Q7!U$rHAxe5gRB
zb#%?!m1#xMe(1dNF6~*Hdi4dMNHw)ZcyS`?gEnKno*=tO5B7I1hCSH*!F-Y!A{~fb
zXHITeQ?byyk7?uTlQe@N>cS4U_oYKPv4@LFdVI)Teq-}gO)o5UKfHuk?~O<Nm$PBB
zZr>ypJLP8yX`{%uW}kHH298CUzTA-onWo$ro~>F0mLkE05MQE+)f1je;Sf6}S+j~1
z!H~9i)jonSq&72VEN2h%=+h&Gdl(VTm}mYo4+*#RV3v}0S+Q+>2adE-BcIS;Hwe)!
zr#I(84Pg;?=4Q2rJ)^(VKIwSqBPgo*hT3M@MygbwfcKrBa;@%^V85~z(eEyM!lBEF
z9n>3-O(Diwvx(pYryEV@IrBW*#_j3^es)mBGpt)$<LU_Q=HxGheYT-|YX3`^Lzn1x
zFvK^^`w1Woum6YHFYf-|)c{)m-Kl9LCs6058TA{;j^T#C0CSszb5H&;=4QiRO9Gqs
znwcel#@;d<^PujH;Pg3b&3;kA>Hhl-cNo*5LyTd_YG%j}rsK;2$e4>B*}6@{?FPd^
zuP2H|+%NQo1IPt8cKr|x)0{lwK9^mLb)XvTS9wHS6fL7BiIdgSY|qV_VN_+%Yo1tc
z>yH{8(V7L)9sl-012^npWzJy2{U3C-K|+tF$FSn(MWQ7(r_Jxt#{HBmRr)aqB&1(t
z|2N-={@=q-A5UJO<$l)xp$R3%Is8unsCpv`L{ytE-MEP|-5$BHZ+g+dB^i1oR&XUl
zPBpcUO^ql~!|uyP8`-3mz*-qLLZL@jb)?BEM`ypm!GV4D*L#J}{soMJIv5y!EZDT+
zY1DvDN)up;fyO~kFc6ji`W(=AGFI#JsR7eSAq#u%r?FFf4=&ptCY-u{8f?ZH2xvc2
zpFk2!I}-*0$Sh6|ApugV$zOI_RL%!dxEr_B`yIZO_9l>=iq>yQ`~7|YnUm9(;vL5_
z?L2{iuxDNd48vVZX~evq#w=lMmN|Y}Xl@LnuGC{b%}e7Kl{X*4<K&@;JJMqnF4B2t
zB#v+%Zc_JryR>~ze)|WZ*bZi^uMpBFv14e(fN*uHF?U{O9j@jh)b!eZ!0kgmyeR5L
zK#b~^xd^dNdk~gDZMZl4Bs}V{uUOJ;y}%nPbgVr4W3Cu-|9ZFJ&7n=0H92o@z5~OH
z@U#rUTVG(TcK{g7eW?|N;rmvO2uJK?`ZSx>TNb-mHx?0BPSdz(j6TsbMgLWq4jR3P
zhey-xp6^K9A@<|+B7!Qjc0zW{_eGmBeD$4%4J|RxD#km|k4}`^GUs|;AD7sP=R2&S
zKIDWlzKvy3CXMa>>e#iesge_y<_3?#Loi4p+Kz+UwWxpfY{3Y0xzim}ylZYW%4SM!
z+7CV^s{zuyA1d!wc%I&4KlhjY-Hr>)iku@z1OWRYeX+%LJ&EYl)MRnwI4P!g#Nzx@
zuas3=acpmj#uH5U(*4#3mbs3;t?KdJ%fly$LT7lSn`b|NHUE;JFZ>U@;QtlB_<wqh
zetx7kWc63DA@O9B!&+mERi5Ptf9J1dywP`VZpLI<jYK%Qd;9;As~E^v$NGk%YdM%Y
zBlFf{pZw=sP_d()(FiexOIc8<rXW1po^t3ulW4&D7H8dKnc=;lk7ZW$Peu+z<-QuQ
z9;FsZ(hXIeq?N?TXT=9kFu)C(D=H^Sw#Tb!+>hYgIhKHw0^m|vH`lw@8l(w$jJDBI
z=Ve(^69%3a@bTd9*33z#T2sD;SlriZqcnf&DnqHEU(T}PD94A9zUJEiMg;)4{-yPW
z#|4*&%ouiF@uHNO6_&MWiko(hggx)iPK>@Dwx*m;lr!x1-aMcMGr6A<<qrT}WbV#8
zzAR(VY99_XDT(fq4DIpTv}c5*sqsM)g3JY92|u-%l~Ex?kxqzP%4r(`YcyN+Ez#{e
zorb}?GO+@_XBp!9XGUMEw^FnYmXA#&Ck|cUgsb^M=ZCMlrBar*=H<$REX`iWyKl&L
za6Z`}lElgLoc@cq(8%5U9Kdb=qXQEk#;eele>Y^}gZ;(J45X3`ER+AT_g7~#3DU;^
zPwFo|XEJ|j@xQSBI2VA3RSBzG?r(y0(78n2-dlhjR3EveK=)=BgrWi>`Zk;~_YJ95
zBO7{90k+^vT~IrsImgQP5khMXMWb7z&?u75aV$p@?*Ccm<0Ye?B<&{*+R$UzjEwZy
zdFHHF+xYHOA681rqJe%zREpKy)*J5a`nk{+Da@~B@FOVv7uRN0V~E8k7t>e)mEN5W
z{F3}n_g4I;3M@UzgICizmR}t&rQ7B1*7%jYtclJgdV~A)70|0x<XBc*SVpknrU(VJ
zj3NZR*mAC}S^ZC(y!=G%E|*Rif`LvnTh?>KiY|me3zl}@zOPAemdm3zj*5NxC^c(`
za~gfmJ*s2wcY_qX*I9cB4dDs8(&=>V^Gb1)Mh81Ddx_HX{oC4BrnT0VKP?lA!aN9a
z)?4mcE-^RMMD>S4<=dxDW!L+lq2tW)`my!|yiQu8kB(E@V1%)IJQ(iE3ddtcqyl)~
zbmnJ6!aZh8iHdAF>(+(3m4rudWTcGHgFk*3oh$${;owT17C^}o3^+EbY5}^m|F#ze
zXg>flmQg2P?~`f(L*w7}a&CEV0iDboq~)DJGT2{t{-!-p)_+m+T7Oq>ck$PMpzIl<
z+R6dCYK6aBCH}lus553e4`jM8+?~97NPlZIRZ2dtJkFS~w`Fl#{`!7m%sgGZBwLFB
zK=r$A1yhN0S%a%uy1=Bn)QY7kX5&qda+a;hM+Pjcb4wCqJ5TRaD*k-Y+qaj^3zob1
z-!#7hoi~#hjWj9d%M>H*RBI+}Sf4&z8#B!y=df=THTx1RO(;q|__tz#hR45xy#Fuu
z-ZChz_1*R*!4h0TfM7{*4+OV{5Ind$!QI^&LLk9|J56wF+&#FvySuw|_d0X!d#lcW
z*S`12zUQ2(TeUt?OuCwP&R6C$#`rzF8`w<3n4RA8`QiDU+Oe~PFHW*P?YR&|(E`op
zWIDF5)O>A#qvOaPyc%%Ngo{#ETL`^w(p)Ud)%qH&zp@;xu1=F^?1_XU!+p;C4d%D5
z4sSxdJv`YI=F-x;*OUuk4)Vf{qX}miWIkOS77TDP%;HHUnYkvk^0A^=N!WJoVNnV8
z+=(2}l#<*?2oXau3cKP1K%i>@7Xm}Xo#mL+zfrX;XOX@M;Q5x-JUjaT$z$}No&;8s
z3H}Nw+MqM``*HMd{|@kX^B;JB)Bm-()8AH`%wmq#d*z3?eMWUP>`M#uEOJ7iE}mcg
znqTPIxcl<}B0z#6Q62|pUJw3XCLF*&`_$hzpB^UkUqSzWhv2TLg-8M@yMrF%V1@8M
zz^wh7-vYFY=IM`KiK9Au4obAVlzECO6=?v<Sd~gMOJtbg555h=fsrHg7O?B0_*hMo
z2wiva((9q6ho06_e-rZbZ#)6Qx>-P1>g?7e>4_HRjVH%?XUvjbz5cy-E_2pVIOs<Y
zCTJAT-qqmi6n8%(%T%q+b(kyox^xA7;grWfD6#u&A|~kBz2?}KQ(1X41@W$rmhGD#
zt*pIzM-|Y~A-qqxb~!iP`Sr6dJ&4%Cg`<wIY6a7=ZuDeV3pqLi4s??EB=N70bIWha
z*%K&ZIm%huYq*gqvT+$6>8XY_b1c1u^D`XwRwYQ0vzVhNtD!Z&t!(W}b7L7nt1FMj
zjm^<`)|`sBR(gY75hopp_Q5jE*eX+c!pYq^uKqYHX?1TTCGZF4_wpWc<Wj~}TLp>9
zRAn}aAwG4~rdWGz=!)Iz8pVf?wM~(ARW&wi&g=fq3u2-adWSq?l96#@NHC}4_pVBB
zFR*KJL#AelZ&d3a-gGu!ButOoDrKtFqg3#NWXBqDF+%%B$>RQu(8{c-VOTGwdQ|Bj
zveqrojVaKW_ibXcym{XF(f4x|<jkx+Q__ZMs)t}v`fb27$Qi~|%N*Oyi?ri)B!LRh
z9+A6^WW=QA_;}rP)?`|LB9R$Ycb2I?k-7e-N!7MRZJe_W3~&KaCvc##9H39>da{T1
zG`{|+bA|umnB3y>_tcx%#(H?^MTH?N<S+=(9;{Pqb1ugl;wX56iPYVm*f*l2?mGJR
zw3_NlP>)JADiWN%-X_8sd*2-M(k_>nr9IWfZn@$|JzIb~=}WW)=E$eeOutc1M?pCS
z1r)zAiwP)=<E77(L8z~2AM(7u*h$-^_*RI1k?kh<QpN8J@i}y4o#&QE@GZGl9Az8a
zTTRvT&61)RbFV$FUqc5>(ni+ncZ<o69!cmi&f4^wzLxPbZA=O9Tlz_H<=0OM$0y@E
zZVjg^!5Qgjd{1>Ya-Swrkg)N7WwwBIien59s=Ojo(kWf82sI76Jz_WChCdTB!XngZ
zt~C|663j@|ouA)j265~;v{rIHyGE-%wTR+*>3BLt890vRA5zVF6aG_;lwvUYGz$HY
zAHZwcjM&IFs}bW|BpkXEfHN%mr*Lc{8>SN0Z9;wt-t>CG;=_h&rl}?8H@a{dY{4Jo
zWeV>hieVp8oj)M?ZT_IYE<K^rB+z@v|F8w>=I721s_h{x)z=}}WQ*;ms<8b~I$ukc
zcF>aFdf6(C3cl5uYiN!=OFo(K>|=$0U=C?f_X&CxSrIp&Wcl4EJ8k@!W~wyhWn1eO
zX<zb7P_TJhimAyOmJ4ANN!i-2H8Tb1n2Akglb0UhgL`N#*N%_kLh_l$DcL1@Hr$=K
z#+>}or4)#Q3j?YS#zMG4b)fhd2kt?vXlW?-{7n7G0C~V3C{N~fxtp&uD;~YE8lW4i
z#u~eE&DXP}azZjKXu(bS)$}u4p+6Q{I&z+tHMZS7i1h|4(X)%tZ$`8XUvdvz`JSSy
zV>tU4L@_7`Yrh<-SYcNSF{QN0C>3}X>z`2UdLjT$8{WRg$u+qgQ5L~L$0lW1TO9?7
z{bHn><klCVTXAX?G(o;8T{JXH1Dz4bnAUBi<m>0GQH@rv8CF*rlVT+w<D%tG!nli$
zJW!|!2_Pw>TK>opa}rJ)g8G6W+bdJPQTJdXcSFmO`tfaWJ@qsl{-QPu|Dm{B*^*SX
zc*sHxmBwa+&B?Rxc20SNV&uR0N>A9#Kccp?zcb)y2>{_Rq^s%>EBwAT%hi!+dDk-k
z{l~q>bDOxif<}uE^IYFEw|1yD)VNMGI<YH%5(-C&QeQ!bGQct+!gJ0)qYav)cl0L0
z*$$sl78L?fWZAe;y=aAQkSuPXHcyuJcB#yfF@4c`n$%ufBzm@$$(6$WWBaHsysG-v
zgvf4AY`7q%Um&J-3%Z-}0-BgcyAtht_wB&C&5sj5tY;}{(lqUw97!k!4(>JIyY^>?
znz^mE6}*LX>}E?t(|5Tn-LL1J;1V`WHZEK@0!KemOnR<|!SiB3&!}OW@XxgE)i5B|
z|JvVSde&I)@Wp(Hh3%~{v-?P`)Vsa<D6ylH`)Ss}j~ctjl^p$>91EkOaE7EYj+9;1
zsfatG5)bHt_P3$ua`ahbB}t7JbicuL0|1?j{`bqJBZUzlIc&GDS{i#ABm2ucu10w?
z<!jPA5_^$cs-4*~ZCxwL8MDMaf3HO{(#PqBaaFP`3Ci*-|HeF0nt^!AJ>su#g5le_
z7UK-i`;!xQyDKv#?*wDqE2vLND+b^9;CG%+b{&A^XYXgyH7wiZe7iU90_)+W>(a$L
zbf4_Z(&l<n)S&m+Sj?V8`8upgSR6Oy*$bw$iY)%p(PuyAn7I`_n}$is8Nxv#R4I%E
z_0}3ytmH-{d6EA(9u~3p4iIVNBPmwqzNvZ@iIuXkqLu!*?hd<@%9k#oE&a+TBR#Nf
z)XW1C6>jy8>*Yp_73qJblAqG0zu%Eij{aS|D`P9G=#$JD{_-cMIj6vnQLsRyLrvk5
zU5g@hRGJJXg1gme!_WT6<WQ4}0fAzdg)3XrB%koztD*V|{jMMTVJkJtQ>V+x?$A_*
zCu?Ar?0Zf0l+)PJh?$<@3b-U}Cx7h1bhBBSuqz3N6AypMO3xqtd6}V(Rl5bI^-$b2
zBhuD`+EuP5Ge0(!oVHf~6ipSSqcqiM-Qww)f)N20{uGMZgykFEUK(wlnEAlDtJ0y2
zH!3^Oa=mt=#-hY>RjuatUM=#4K>J{6o+nc<=s-o+<~FWw;kVM-mpA2h=0+XUS+Uzb
zA3#|nHZt&#iQq80KsW~e<D~V{yDK90_fz(B&V_4B5t<x6Mirkdv@y2seZawP75iiE
zTgO>N4x1;Bvn~Eup$c$?V-E6QsxBZ6Hn}{SUy!7|qR0Go!$?X+5FC07aMv}2<!361
z7Jk6bK`CfWjcm4Db5As47}tOP@WB}3<R;nUXk`iEQ$h06`k`uTk}mmo>aL8GIT$%^
z4_=_3XpQ=x)>I<zQefNk=|<|U;)+p%T~?MPMb}>ejg1QRz@=~ZkYk{}%`j|2mO~Sj
zczTa(L}QZc(k$)kK|No|V%}^TcD~qi@%uU8(9_Ak!4SY`m8cxBfP%=bI(0QfkG_8x
zTnAJ~QaCfnhAd%l?BkT%65sZ_N(Mvq4!AXZx89CTgM|7g?}ba>j{e-dKh>YeU;W)t
z3X+U%ir=MIterKpt4eSu<4VYmDF;r+xP#BwO)pD*hmx+9oFHFP=M6D!c(G8g!(UKn
z#;%F$n~nWEvyGR?9l>DOFTx0f_+BYVIBm-90C8W=&x(BNYOo5vVrTcpRGkDUjHm9X
zNeUI+Ic025x6a$IDS#M-(!Er-`aV$on6^?16HM*35)m15GXV7}Kh63R<#yTp^&XCG
zyd23&8MIpy^`7jwOq9Zr_!6z?_e4Ibea_P97L0MyMp>3eU-ktx`3F*138splp#A=?
zgr0@{ajKI_TONI0#L<3fnS=kBZRGp70dyo>+uc@z5iV?y!ZRXhKY6TjGQ?nJn<q(=
zx1NsdC5dEPd0^^-A=Z(HY0Kz04w#{*e}0YA>9Afi*_>vjB4?i!Zzejub6j*Eiobfl
zXPoS}xAie^wFMGTT&|CFRK(rvu_GgghCUqaybng7%Ci{T@DmGxtL&c$KNF1JMk*j>
zTaSA;S<AQ?zN4{Kjojm^>{+;2ex|$IE4l_pbrPu7)hb@pF7%S}%V0VUHDeCAV|#E=
zjd>uS;p?44A6|*$*||^*bwgi3@iC&f0E__=<h&m#<~Xst!H%Z>bWK{<$;U}!O`Z#B
z38>#7eN=;?+9~4vY6gGEfY_$M$h6{T%Y^!mZv%4-*QE7{3z5_@L(IX;%*A_I{D@lX
z9d0ynK9@K2qA%=4(v4H>iikVB=Awpk!7MX$!2bR`RshYN`tT#1N!re}kJ4;9Fkp`+
zz{XUcKGDp9PE?R_QE^XO-iLKL&8{>iZ4H3Hl0%c+rXz1MIMFV-ZXa6pF7AzsMUvb~
z`r9p=FB2L`Y{4v$$x_ANdWXn&F}>eC7NriY1E=z8N#$~}KtCKoTN<foevH^ZdZCO#
z9kcb80^bS?u6nfWRJYX50<B&M^I6`*nRj2$wa6m}M=L?l>tqma?GDABjayiY5rM*-
zA0KXtT@L?3;^g<CjNGyr3sv@uMi7KcyW@TwTB0!mVl&4lFoD^zt`kkoxDCS|8RPFg
zEJ{{wO6Z<6BXnN7Ejp)m2K&!k{4t`Mm%#=$B!}U~Pb#KhJp%bxJ60}WT|!znlS7B#
z#CGB{*GOim3*L|uUy1b*S@|Uk4FAE1ZkhM8BwQ>lmFR0EqgHJMlR}`cr7)>`udG81
zO@qMo$?Zg?*OI~WrSHW9uTB?n9Ov(d)&<;)xH~yZm&5}hX-IINH{XuLGw)bVc5&L7
zks&TYI#L7)Wf6OlC(W4`>wv0Zh*9G}>>1amQ6T$mPo`nY&bX0@rn#|!x#qoTY<T@H
z-@eQI)*h7gcZ+k9PH4UI=zNmB;%o|C@=m?}XT8D>HaR2QBCc?{I5dr&1U0v<m<Khr
zLLf$2_-UkWG=EOwe6!yazqRYJzx(QFis&~^93h{UT`J#F&S?h~gs3A!^Gk?mlihHs
zZj==A!E95jfZR|iOFj1cTNL*)uO8^g7QxAGoS&)hlFzi8a5C~^#G5`5>gKBcrZ8Uh
zQyet}(f+JA{Ua!a(L?c*BZz6c7AW;-p+&w8O=-q&K)AiUHffp%&Pp{$1KpFIrO);y
zcc?_YHDW5qZ$vScbi2{BNdU)0bN$0iB)u4~k-W=$and~_z0~E_320s&hmNF))A(kc
zdb(@4Ws;2W%qWlH%l$GLly1;G(BkD}CL9!OD<&d8wSN5oL=RXS%c{S;_I8^H*WPIV
zp7|HjU=t$%PBVTnb^hwPi~*YPz=$2Wo978N=~qVKO+SwF+4)8772UXI^HJ$OmAyRg
z`e5+3ERa$-*#eq?*LoEMl!s*3*9UCN>|9;1g7Ul#|K0EX<mr|*dG^Mp<x-YR48j;n
z-ZD>e;Xa@M)>;5GIv(lO>Ma@g7t-5g(7NFxeinAvzvM#y4YK-w=x4t6P{^f%+t`yk
zP_H>K0B=M;FszaRitrd5Z)Ts05VW0s1i1yY@SI8D2-ih*soVk>I~^d8?+TGu{zo`_
z|0}P_DYUB7$(2F9_P3@+N2Yb`z{5rHo^^n|UnGV-fw#^8fn8Hf0?7qXIKwRsuYhkI
z-3}DirT)3#f6+MT==i6Z<#nHH_3cnsI&<o>h@xC7<{A9ok>;Mp^V4WA7uubkwuijl
z-PJBZNpz&Z$-2TU954dk4in+mesKpRdw>e?cim5aAwe8q0A2dNc%R{)3;uKCP*lDF
z!tKwaoO=sU(*SS2x~rPfzv*x44z|!*GK=aKMNU$VMrTP!XMPmQY^bs*IdIj#Oc%gw
z`=Sm|VMW&Np8&9)`uIOr{O=eK(kB1t0xLV_`JNrpy0eFr>UzFIMW_{E$^id0a}POr
zebTkWKv_6UcFv;ZA8-EWzPr+A#}vl#9d>oEF2L}7FV6BWq{CC5t@7kxFl+N)NP5b*
zJod(kjOb<O>2NA5IEUJP7AC}~1$4N{8LfqIx*puNSj@JJY_@CoMD_IJn@IbHOmO%a
zR(rwMn;VfeNS-je1GRqT*!%J<V{}j?lBPL}2d|E7<Lv>!XQZaw$@!$%NMj0dky`u;
z%u}s)ejv7oR3M?ZV&r+bqj$FojrO%8eKhs6yev)oo)LKCdEOqXVe+ViD!{b2pmage
zt*{cJ4c0*NH;=AZhTK@wio{ekK5oeH-DP38s!cA9p$Xlm3a{`!{}>Gw2T*MqyGhw&
zK6RTC@7IKV>I88w3X4=eXvVSOIlD{9VRP=n5+lLx1t`~hKslOu{QBs~j&p@|w!eD_
zCihK7SV7S{%XUY<1iP)<0Eu*6eYV~&s{-7`ebq3mTX-^l=h$E-Z&)NKpSN6hP)2Gh
zj2s6G)(@8mQD05M=(rubpLqeUI+^o5)QajRpLy9LW^H=Os(GAs&dCqTaO`Exu-)IT
znmnE!aC4*7%x1UVgB6~Y^DdsbQDz)6T+2~>QkqMW2qh)qe~W;O)@@AIvcCN>nfH-S
z<T$`TnJ%Q!JJi~W#LesN<!hQyC*UMPg8ZoQ*`KtT%{*~ec<uO`)Me2OOwNPt%QKl%
z=XNLo?@!i0R_66gpy2Qi2z8-h3X!h%s<V?`F~Vo?vGd|+*P<q}h8>J$mktor#RU{*
zU(i$ZGH&)`Fzi{6RbP&c3lnr_!56-fZgN>%?`)8oK>30?$uABCWiQqRR{V76K?kDK
z%5FgNyZq2~bfi{R^TdqzCD!bR0l2SKN&hp`ag;J11=99kNH-%kJ}F$*J;q6eqtr@*
z-*S;}{yZ-nf+v~k4ra7WOngNLsIP$-lT%dE4Fl6VnHtBrCyJ9zPkdZlC<_bkPq*mf
z9^zD)px6?&UM<Q;0>4Q-f^ij|L;6s_?{qa%QCI4;7fB7**vEGCH?3k$dxo9F2(iB5
z;2w-9wM}9doUu6ME_#uo{y+%FsT?ggOi2kmzAkqz7)yBn#cxJ=vTAd({Dcl<6479g
zmjtzG|LG<##9>T>91*;CS?u2S&WU|dC{d*^mY5XI&}_0(P21FzEQ&e`X;M_{2mLIi
zeVv3u{Uj6$n4$va+?ygi<eIEn%8h~dZxN<uiGrb_gkLu|p!-uMwNmX!+~8V9^bGvV
zsXFcCzmQneHd!Ud7#m`RJK#*$?y7rk-!<ulw?;uq)@yMzrrg^e=uu+o2-il4<A*o9
z#vRG}JIBxW9@Rf?gf|cPK5c(s2IHasJ_Z%R1l&&SU@~S%m$p!}i{4$;IM^Yp!j<lH
zHX7fSLYK?m-CoisB^4N373>wU2Y;faIZ9LBm!`$faa}Z7Cgf0c1M!-6+r`K@Dghp2
zpRyM~c|d)-=MvMrGw2TuKH^ne!VTk;#)rfw)i%0SGVXW}dQ1dSj@3GZK;g^mIcuF4
zO2r?9`qaLTNQQN&P*tz=UeMS!v-6hWJ6Hn}g8<f4f}Pzfm5?9YR3R{38>-=K$-Y(f
z4#VEYy>n0m`?eLDQ+hftU2|aJp(g87<twR~wfe~dEnjgSIm3KhGtfGtk9lZ~f*=CV
zknmG-BZ;0<FF1ilguoQ=j+JH4Rz|nHrZcA=$I|FI>CG#Ut3Js~YvV6O-MP8AOf_F#
zkvWi2P*llNlz&Mb-LYuvW5lV*f2i|Z3xQ5jGQQUJ@x_UqscjT*K+q*Rm)OR97L`>>
z_oVwC@<r*<Q;D<;^ZP!A(}IGn&$aVEEnN=?C7y;RP5RdvMnQy-9ZeN|9yL=dnqM(6
z`M!g&E!Nub-Ds0i7kc9^`s<=ENjQ9#)0xSJh*tBBW$1{{kk_k+*?wi>HW*}xo@n?`
zC*!!%OVgP*mhZtE&U7?T)PpG?P+vDZhYe=!IX<LI5Jg9Iia@AC`QFJaP;e*xw5w_8
zTgd4G*Ev06O+(IO4t3H?^QAruXKR>5+s;7QC?<MCM)`kvU<W;3mql#?Gzyl|I=sy6
zce^|yjlXM}NEfQZ8|F?*)w-~2%DSDkiR7Kf|G0R#-cc(4Du|l{P5UPt3<2A@U06k;
zdCZt*EGJlUx6w~iWvUDxdR#t)wy*x8Z{0cv^gdp}?gl#!o=CI|=fzE<`Z1(qxBzvl
zSs`}zM$-q}8&SJ?lfIk_gym<F&RTO$HY_~S#-W>Dt)}GcQ>*ERZQqM!>`ngU=q$b!
z`ZT})f@+M2n#-|lcYvbuo8nIDjAy>*;tnOLDYD=vN)VwoPr->ZRgL&A=M9o8?1=Ry
z#$IDScaFz{y-w1VIs#8Zx30Q!C)P+Lzv_l7@nzQ{pD6e{rH#s@uu<3EuZZ>&BZL=`
zqFryxgcB4?d{{1C`BV)3L4)Tv%hfxHX=SHrhOL7hjp@Y;!_ia}760~ratyb!`ke0U
zkI1CxX4G*v?~6Yi{undinZ4XZ`^q9GB7n!7`=fhyLVQQ>)00!gTjVPuSFbyhk&u<I
z5jdpr{BRsplQr$$j-(iE_$yRI{Av@2K9)^6#xf|S$}-v+&$x^xlO&2gb|!a>rfKV%
zd<I)&Xh57HVsJIB`Vm=WjC+yMwOXCB{1>P*Cn-xduPMGvGQo2`Y{59f1KA38xC<$;
z{6KNux66Op#|Jwi0N{eku1qQnN$`Z?*Swk^sug+1@c16QfaWXF!?&=&shFitMCvZ%
zyRQ=`AWTTOE_0;UH}n;VgaQ55o1qO8d`TQp^Fu!cq_O&fy^JAN@6~lCPCDZ3inq~y
zQPwsiQZjmezeTC5UV~<T^VBdW6$PQzWtEjym70QGH5KX~7mJf5GtkN6fg;k*shd3P
zpkEE=`xa!ha&LzF+AtN6s<tqsN$z?yt8Jr9y?u3N;vj6N^e#~WP7oJ;)UvD{6rS6)
zW|0L@N;y5??<9HUmwgOTo`YClpAZ{X(vW%5HNbeHXDf=x$a-hTgVZMI8p(DU-$2eB
zrEbceKPf(OcW9l>OuLIZg9L5`hr+{;-0{V?2^XTI0U5P~g6M4{FEM9GT%DuS^{X5~
zY`QxsQ0{?1diZV+BZI(eB>#~7B$bvhC#(02Mvi=M{l9CPc@-{+HkXxsAk2S3l~snR
zF;_D*sWHprj{IYfA6VS4Hy<+p(AtgWvoc+pYO~R3DMba5!d=9sYW79G`tbk(jlwcC
zc03y&6ix@r=88j9n<afKoHm=0q*K}lXTO6cd3)J}A>Jh3ERyR3vt*oH?0Go01oEdo
z1YImXeU9132elt3Q$<f)`;}4deLdo|iRA*%I9M{bxUH_gel@R~L_0A4{!V!E3$WJ5
zAxZY{x{ck1oE<XDaLH9PFOzH;>``%l{Zhrcf4Qy4-sU7D7zK~?Vdb=;<?WVo6vn7Z
zW%E_j@=M8ny$*iyb?$uB`d~VI@d2;<ibtSu8Qb|{e=(vS+u1e)yh@Hxn^v9u>{4Ut
zS4`??K0x8sPc>O4QRwOao<J+x{HBXgT}j^Bg}Xgo>MkA}to>xH5cx8ZYs?o}T-;7L
zw2XTMi}Bm!ijKx9AM#C^zZK={D;hHOCj1Bu-&D_Uj`M^rztkN;+`Dyj%~N>+VlDs?
zaUJDZAWV^4HdU9?FGuHfsT-7M<=Y5x>R!9yF4JjVnJ%8r3@2he-A9v#D>>JMyTV9H
zgM|Kk+aH|N8ffETLiTYu``z>x$F-1;Y6ol)3CgDv&!%Y`<7+z!S`n(c8c<u!VI-#L
zvmm`i>m-8ur2J0>6nCZ;^MsJe8sqxuQxB0G^5a&=AWK-^tDP^h_Pgf|Q)2M#31mG)
zEq4I(ttQT1gvs+?^NI|N7RE}ro8}M25gH{{BKDhC%Wi+x{oNR8G`X+Y4>Z1X3&j)%
z?Kgljys;w_zDZIVsJVp1r-M6O!nVy?roKOyNICgQg3%Rp-D6G`O0!EL3T}>=b#CTX
z3KJ%f7gzoMYKr2ydxrw(UFx12g<MZL{;Elg51NYNk=BPuN1lD;{;Zo9qOcKLx+2e#
zx*ZSvd&p$0G)t5@bED7(TOJ9u&{l+>;OwJKlP|J>FTF>J(bje0Ugo6g?#MS`T<$Tz
zduL#vPiUSm;)!D9r+7^@RaX4+)Qqt;YH&^MXG5ZA4wlzYAdqzQGctzwQRE%v&Q40w
zoP{WXGF;-UylZ3aVmWxcXd)oP8mi0MMGGG09e01Y8i_yYK^qsW-vlQ_Jf{X_`b4g=
z*`!aIPqDFu{-S8yb67#Rg$pfWmdD+?Yo64+=EjaEu4uHu^hl911}b{Rd8R5B+4>T>
zki->=hGX0-?*2jA5SLrfO1~oM79hnCKSppM5F-=)8!wOUF}BOnv@^Gdh+>Wgm^={)
zAA$p$p;4XF*2l=!=Gw+W#=LJ$4m5YCU6+)1q)2}t=Z3vPBn(Nh|9k^t_;e9%QvYC_
zR|_;>aibe{FXnZN)$E|$qx-QtP-%CADMNEb5`lZV2O3R%EX#0TdQVU%%n>$k_-skH
zYtOpAe`LydusG*pvmmUmtK!)!bGkm$cVqk3v@~4lHDC6yzkA3(mAH?U{6arS4TXIy
zlpp+r;x|U_?>XX41Wk7sl&s9>TXlkTn9fdXG=$a-z4D~${0NXyj0=`@vsx4CEfS@&
z4mEb<tAnCKyG$-_xU=YHSn;4e?TJ#Kd=Sr@noF9)t)BPsCKHzray-nk6_j%i8(MtU
zN_I2$%o|?apR<c{qnmT%M-1R>Dw>fwiWCqzE4~=s69~$+J7}qdw&Lp4P2{jxTzOnB
zsd0c*!~D*|+G}z-x}GC>4sD<xXyiUplaiy3rWNkzE-w}S^4=5jCo0Odd5k|UxlO2}
z3`7I#Ecl7bRRzXwZjdJX&G?pY^bvJ-(WiKym}-w_@*(+qArc%`b)wk%>J|(>4QB7&
znmc^zvx1@82=Nd^^Shh6ByQc569|+q=rMo!+!{}A3U><g8#?sPj^?xr^IU|sMz1ro
zmn=EAwl!0h_>?a#(oJK&qey6foatM=|Dn|aW?G0v6|TpghaGXwb?x9uclUDuFGrkA
z!<)UM)WW?zYFkmxK1k@QGAf!A`l+%xwW}d^BPCT{i{E?H-0ZXbsksOB3^+9E>OC%B
zZWH+1dO!K7rA8HrWG%@oV8G}5kWAWyZ8+QFUIuMzCIV3W4Pz(YM=6tQ-3>+9Hz2GW
z0EG1w4ca#h9|&r|Po6;i6KWv#FIc~F!}D@js169;0^Xl3yZSlzZ~bkg$3feK=rBwG
z0?564bMOWo_6-ml0>S%|0X+XJYn}fypS6kjcRhRb6T|a8!+X7PqD#eZ!v&*j9pr~o
z7G7Tr;z_<h4>BnFZ$=6P9PU-Y*uc=>0{D8s5Oy&L+K`6<HQy`{;)~*6NPWyxfEO9K
zQ^CCFYY1QrA2<NQ5P1&b)mj($5r~FwcLOCR=T?C*q${d_KI)&b`sZQzXX5;`GW@fO
z{<BT|v!(uXX81pUDEey_u>CWt|J_P90O{r1XR+3LrG_3!H^(BGh`*4Mpzq8?HAH0A
z>+ik6kUWY1&^Cuq!bynqlGgIhZBcquB!PFSO!2Xo0HRH#2j}bn5}E=B*EX1z=DLw`
zBnF>8^aDp>EPQ}dS_w7a+8UvjRZCxqVM{V%>rYb(VJ+nhLM076=p^cRjDX}b7c^DJ
zzCfKq`{MYTXFdxD390DhOm$_&iq{3moLWaw!#>ABcC=G7+jEzq=|(0lKgjUIoD2mG
z2?eTJ+ob9xzZ;dN2<PY7OVe$N`e87eTr7Wlz*zE=WXNW}EzJG8knrQWOkAREYA1Ps
z>)kYD?7YWS6Y%#s)m6W90<fIdBQ68l$FB6dQWT>(h5Wi60hIR)edlCNlPi{la`>4D
zWdeGBHza?zK52>qMwDzc`q?H5k-^KE#7$G(DsQ}P{KpHmEuxCXMP?odilscX>!UY=
zE!BZ`Gxw`xDe|fa$k{LEoaPG}=`R)xQe-k$==U1@vnN4bQ}5eWmp=KI1bq@4Tb`D7
zNDzZ4x%91A@lge<ra%E)XI=J(_O4j#;-l9dBQd6;$G)9ea4~F+ImNKEJ$x4GdMUVb
z`(Uj80#1RcIfXT|7mpa*&aEEC!Lh?eL&RC~Tj2-v18u2JRfW&lYM1aA{Pg?H4KQ$T
zDSNORNji7w9^a{>NB}t=2*Ww-RFCX1@};Y^z2q4;t+41y-~+cBV%Wxvr9TU29YfpB
zSIh=qJ7=$&DeitR&usp{d$yjDEHqMac-UX;!Mq^h25s)spP8C8r>cEoifJ6{7Vo_H
zsRwV<kCM>4C~#*@-g!pNyS63HB;<Rgtt;*!11p`V#CFRHqk*}=Op#hyj=FDqeu`fv
zp_$;eOFqzQ*&{aP?BcRufE?I!8==0QDw5~oxUR4N1^rHK9jI_?5bIbcEJx^h(A0qi
zcGGpt=bDZ+=h)1oc<OXb2YQK~y*gnR3sq9|qyCubj@t1EFl>lZO>K4um_AE^L{MFl
z5X@0RwAHzhXB`OhaJlR^^%^$T-fAB1J1QW02S?E|moL+<CzR&((?}l2Yo1`8z0+E3
zDdk_K_2B>~!PSB)lc^=u)(53tHv{(qN9<9fBKO4n^KKKx)BQJ_Z<=2uO)2^?AJv&l
zidN8<cD3Sf)OY$}M=^C&77wNLp0B_-oVasgHBA`^7|+01{wnyROy?4|$WBj^Y_yAR
z=|tsz_qM-2Bie6|cY?{%;mcW6vt>FXw;|Xr#{OB`YW3bx;RTUX;w@31;t;P4`?0L@
z!7QWefd>)(3Dv*#FcYyxM-G7(H-pBM7AZ<7Z_Fz>`?fONo3i3Hna_3Fw2h0ot`S&}
z-XHnvQ|45mL<A~!9g<`DYlv2h`P^X$*Ke1DSTLu&o8dw#O@z?MB>u{B^npTC)x=w+
z%YyjU6y50Al0{~%<Q3PCCV{sna#K`Ai!TvCi})MCR>^62CT4w{uyzvid9RJ6RVg~m
z+pw1dei5e~clb2b|10#zmqO66>W}2yr$nv>n&!wvNeu^g;6<FW$3kECP-A%DdE%o>
zG?Yb>pDz@nUBB-e=uLWEFWTWg=iTadERavyg27p7=SK!wQ&iTJTj~ty95_DSCF4JW
zAyXyW-&S`Ox$QYyN6)b>Yw`l#=%**qwx%-_-@QR=^!ea3-~B?0>E}z>ev7@JY>(&Z
z^^>zub0|gNhGxO8ClsxDX5Q;pb{ADi0zDCzj!2w2`l9lrqKY;uAgJ!&MK%ny;H;XT
zT@*P-ixqM?C%qZX2Te@c4X>?q5Lw7goRV-)7wy&?{@R|CDBS1KxG3)UEq<qjgT5D|
z)U`1i{JE~4@A?n*6##3QZnXOCblOW-T!#*qBM{aEjfTRsv4&qubVhG52Y|$2M*@dK
zI#KeQJErt?$W&9@tSvm-&q{?Vzxl9@gDIK3Uhk&&M({2QuMfRNKZ<#r!91Z?@Et+>
z`1k3exEvtxqT-q`#d=>Q!masgnj3SMERyIecY|r@D~I&O-Ass+<EYr5a`@p)n1cHQ
zT|2sMJN;CKU<X7)xhN%eYrI!e{9&*chM>RpZq}u1v*NW>u%qYb2OCAph*!ECtT%EK
z3AM5G6n9vJk6}L60%wU6Vp#YkH+IW$4>L;;tb;k`rk7Y?(Kih?;o2sRJc*Yw2_R3b
z2^@`U@*LVm)a9mJUXsQRluOO>J^c_!QMK+*#H6T@5hYlsHs_uVX#aaxABTDrq`P(=
z<Z1leOom+MP>fon1z(-1@>Im2kGgcg4vU#SEd}>3js9=ooPZr7ejA>rq6c<w_JN>T
ze*87HO3^wX2>xUh^k)^LUJ&)dWNByXVfslrS447DXG^0_f@2;%e0d-+I?s&a)2+o4
zVanPB+S#;b7H<fQ|22&abvo{bZJB=oT|#a5I6|IXp+>3o14-rGN~V>h)$!*olc;Ff
z3!)|eE1rux)CW+4ovtOJ)YTWMd=DOZOS%H+YK|UJ7}8223k2plJMvAOkIFiIh>epP
z#J(#G2R+Vk#xY9rOc&rp8$X9bjj1cl1*50<x6Vr(O!7Z3;QxAMWEXLQJnmX@0`{_f
z(s<j7j)9K6&sc5E>=B<b>~&NRh!sjZbbKY&5fizVnwDB8Sp0iC@E2tYHq89x!KL;~
zV%yo<4DgRSkLfS*Slg{}Tw)+Y+#}knt79MOGMm4hzfh;TztfrJeOW#IdmIKbGcCs%
zx$pNfd8mGz<MlSmbh1C9=%-p?j=9I!>jhwOyYHpv8HCPE>aPn1?`CCgZ8U$5j2FK%
z#+~Exu4dH^hFUS_En_wyGf_(S$<9x4_eSB@hHvHb6@T1cJefkD-o5M)vcQB@YkQ|3
zd=1yNxS~A^q4B5AGh|APD5<FtW&*uV^OPGtmZrc#HCEj6lYAI<pAA&PZ2=XP`AApz
z{Gw@K8uhjpn>*yt?|$>8&gmgZx=Scn^$%=-2>XvE-_;F&JKN?F`-h0iI{+_qr2gb%
zIpM<h8ABlZO2@ej?TR?QEm=ho@T!ECC-|-ezNbh5cY&a^bZV*0a)Kqnk;!yE5ePTt
zUehj$oI|D+Xnzt)?q{D5RAXqhkO8fh0VqQ8_J!|MoL`uvL|X!;v35Qaae7e)tcq#M
zx>6SzHGV`8S2a+LHgnK|5jDnTUmD5JM!*ikCXrxK_d&wzK__1G3TGw!qqfas^)EJ|
z_+CeaXRyDJ@^q?nBk?bMtm`r1_x<!2#gq!=rb3e|!iv;4fJttHb~ffaZH}W4(Eyxr
z!0_|S3_;J79mlsJqPU{O(R&JSR@Tu+rgmS#*Bj`sxFHTjN6D)d;v{`og&tJB*_n3s
z>v)4a9>O4<k<a8Y8E#t?Vl*7$w!<IqOjT2@(lpyKMofPtp7Mk8gt^%(rSUrxZ)gZ1
zolSze17&ItzHJ~}sBYE1oQD)UZR9qx>*e|*IhLx*&Zl2LX>Vw@K#JB=?UOfT5jDM^
z4Yp!Zhvn(s4TtSft^PeL)pDCtF4NxVLwnX~?Xzmc79{sT8CDV-@_5ZMPL6kqhmIiG
zu5WYlVpp;i;M!)AB285}85Ewm0Y}|@Z`>W_lKEP~{OXC{xVJt;o`cu4l8kI8wavtI
zmRlL#QPQ9yZrY5~Jn!Fh2~Ojv>;CG~QaJ-GNGpwQ!XH3T(<RBoy1mzJbYZm29>{cP
z9O<~j>ST5n@*k5PWO>c|uAY}2)uq}M*RWfYMwgHy)K%rqyO!T3YHfX^Z1uPGW17-v
zfX+`@LfJ!%>m!p^egNBPHMn9Ocen2;pB$EDa`U|A2Kya#kbn)v&>>I})hV&8)REQZ
z=EvYe0Ggam+CkPLzQfrGl9<!0FhPO8kkm(nwe6F=s=Aw7$sWlyx>G~qjC~v4MoCf~
z|8STs)LW@N1~&$pXl(hQVu-}EdcVjd@#R2T`#?;{ZuSQWL8Plb%hLVM^+^&5cjF6g
z_b+AwK@uYursW=H<U2>HBaPmgwZrE%KH!EesszjRrkC~-UrRVII53apHRc@NHwTDg
zz)tqjukspNy*^UoY0d<gJWM~@MMfU|NTd;2PXPVSjaAr@S-?6!`%$1$J(7SP_Y0)j
z<6#HYUBG=$6_3N21NA~wJGtZ$)KxVqq<NTvbw+EOS~EN<SQNjUgH$Zz$?no#*^OVL
zU62h+*9Yf|gyW6vh1q)F*8C2xORH3LZbTS27V4_0!<VhKuHhTV*Cd5(FsYJ*twGP}
zp?PL|>T_V$syzuF%ef0+mJ=Lt;3XwqB-~+ufR1>FtiE}#7lqnMl%o-~rc&Iag^|Lu
za73QdSe{v1o^Vhs@h(M2aU}b@L8n6pv5g{q#FPg~DEfH-4)~c40n<D_cLh?p#9Q2P
z4dM2%vK16g*}SFf%r(RF(xHa(f;8H`kx?(|t70b~PC^aAcV&OvGxe7h$UQ_k9yfEI
z^g@$D_@6yOT`FFl#FK?mzYvx|hgmzEG^pQpy-cH8p~0Pv5{-yyrK@zU;2cA4GRfZv
z+o)weN-NNUZZeVzUB0BsuwM53P9smYShfXYy?QfPS)I5u($m4vI7(uqE}^T7>xW-$
zm4EOt*J&js;VGQ}B)d;2UiGqGrbg3!U54kCpQ9o-b|gIGr+VxcTv5O_D=^+X$5IwA
z(Q<q<3WP%$>$pFcwPDop$0?;!zuSI~m*o#k`R*B(Q3zRH3x4U3d@Zn0YSW@YnpbR`
z+p&o1qXz0)NKf@cMZfG*9NemJ+Bb3E<Y19|IZ4E?V~FDfc!$HdP7@^4%Et9VmIknz
zF<VZLTeVK%#fOW&f-fjF?|!0{P&iFs|4DAHb9{F6H%wKXQO#XarG%s;BdP>U2_b20
zmNC}sk3>e&ikc^1_W-P9n#n7N9-37tbhZ&0#r{T(*P~!6opKj9;pH~Bt|a>);U9Xq
zV(Le0f7VT8yfS&{Umb$pJMe=1h}yBh`+PaR^k<S%PX)*~BjOSs<UjV?J4?aliZw>Q
ztzHQFa)W<SYRcc<s{+P)0GYH7dL*0!(C>)PP%6YK=-NgJt@Urr@xMCn%X!QHMbY7U
zR{6h!e)B)@ndrp-Emfu!dD8+Gm*Mg^1H@Ysa&Ll=<po$vC%}R7GdGe?-oJx41OMTF
z_Gc#q=z^sU_uRf@Q_wTf>Ud*V`eEM88K2iEsNMy8p1;?oqMYjf)*VJSrwI4{3+dpC
z+Oz#k3V3F_B|D+jK+zF|!1%njJ2<rF$LHE+^@n668eZ&}0Nkyp8NjrPRee!_2=_qf
zx<g?8Z39mptyK1RSr)x(=R=@3;Qe~=PQ4W%Fzx?^6rz1U^%s%^@Hec@iU^RQDZF_#
zy546T{hw?9r^ca0vkO%7qqCjZS9`AQ<-R~;!-ZkUCg;kZou*zQtgoH2l5?h<3`RI&
zW4}Ale}TJLV89K?Uik|tai!odB&r+)sl}Ee{Ph{E?gVrX_lvtd^S%OyuMyd{;rnu3
zpm#$hC*?mab=~&voNO9ZNh70nCazNgw`uIZe@m6`*?WI^PW@RVj<CzNv2<I))V&Vv
zXMMBsxhmM0k5=4hvt?`RuCJAS9XBAUuc<AK2a0U4xZw3cAm_Bn?spZ;$Ri7v`ae7>
zQZUZ3UdSWs+JoI9_~P-2{$%y0-}7kGBFLZg-u$fBKxk%T!qo;3tDZ3S6=7#_;gDeE
zhPoJlBpF8^ZvXE+i0bGkSLd~*z4cVVEvApikpm^sxXbWBpclZKq3JUI(ba?-008ch
zb$`{ls2Ks{aJH|>uwE2w)|M4A+eq+WWZ2Ml#{Kjx3pcTSBhjA=kemU2=a4<{tVd7$
zzs(Qa$bYW=yjaTk{?ldg0G)dgA8V8Xx~~#?ANap_xBgi+{=Y1rT_W%QZC%GY7%SQb
z6Bu8}cbiGqq<yZf(Rhf*GbP3h{HC}Ob(6G?OE9#Bi*{f@-4OaU^OAfpG~=5ZEtS2D
zpa<hpT)J`FBe2l>Tf<NU+XyYC5N++(`8p^*|LHC2|6yyR`fKh!($MQ6MnNDQ4+$`K
zY^F~xtrz!pP&U}NC-YG*AQF)IsI9R}9%B6t;-B%nMO@+9Wg!}KhN5dq?nA~d3oU`(
zkfDNhB7fo`d-9fM%8fAr6#d*3Ox29bx!(lCkYt%0MC?zsyeXx&Ew4hK_De+o6Zp83
zDBgss!%z7B1>%7EVK;i2^0;jt`|&~)Z}MNdCTNE(>q%FNKA7*nc#B9Oxf=mE)$b=<
zEhC5f>yt*-?v=b5`1Ym|6arVqPE6?z&BqR(zUN=_`+>SNtMT-HD)?U@emo)!o(T7w
zpjF=kzh9JBa8DmTCKh=AhO$t7T_-m(+5f1Wm>O~0k=M`ERmddCynAG9Eq^6_$M|)N
z$kbV7Sq|B*xk5E+TV1L-<k}10YPj1ex$k+Cy!p9xv)%6_#Eq-Y>+f~4^~CHo&*HAY
zvJmUoX34P30@Sa+J!4#0gX7brEKtCa4nJGOQEa2Fo;C$d1L4dqY2A{X%0v~dAFLs_
zyOl0LA@4$ZtBj(<aEP0&+7E4O`O+oZv(Bq!|3q6%C?f~btr5PzN@Kd@hX2KN1#)B%
zo3zTt^eOl|@0~Q&^sM@5d-<Z=&hj!kbtO%VR9)NzwyG4Z&4$lIlHbk_Gy>E;x;#5~
ziyKr*txeY+a%eKZqTS?;ge^yVa+<&NszlJEm*al=m#5<rp@-X5zYn`&_r&mH${^cz
z#XxT5f)#OERG?DeLyXROXGvmmE(&~H6IAfLg3Vr}8(~(OMne%g3VQqtY43pP$iX>{
z&91)Q95)bd!%N(l_ekNW>k%5zOtbeZi~Vw-RIrHc1Ty?{(1Zf>nmf_F5t&1>7`z7B
zP+mUd9q;h%pZIfQ0xMKP{jI7#v)8IjF@X2>@Y4;f<WpCVOl~KN^AJ1564mhBOAqdu
zlfl!)7>g`hs@bL`3XnX+D6><t?}CktyE;sIP^ImAwP)3qx;vrFD@*UBXQLn-Ftu8l
zuUPg{=j<R>@Q-tJ0Qpu8E6Gp#(#fRD;%!U`Wyg;0F#i39J!JEfd3%^w)2Vsq-XR~H
zNjMu7d4y$#K4mA=H2B%5RtWq<!{gq033%}XOPhR41l^6>J1`fEi_T*+F3XbEvM9;j
z7pftmj9gD|&t=*5M4{9Dk2lcxnX*o`GX9!{T4FStz<0vxIK#LlTcBW99t8Olr$Z#}
zPWufhbpAE7=eOk8O{X<SrJ#%AJ7qZnvLd_5FA)JWV+Yzk8rMu5az&8$eKuFizL`7H
z^anBOI?@hN8rvrM!c04*G0V<9Q*DHA{X;6xXq&4WAC&cV^KUdAx?@tEWGu-?uDR`M
zh8dUM`aZ^J`1g1{TP=<d9tHj4)_G~K0pii;m%SN%F}6Ju=jZ-SZvdq@a(<AHvdfN5
zw{>v0irt!5XSFkC;FZ;ixCR9jMoo9Q#(IcLRPDeXBC5XH6Yaq6G}iVKlxN9ZLl8Tg
zxKCVnIRNP>q=H(;>7(qX5Z{&s(!6Jm*9s)*j|Sae3=~sp1W^;>6z!DX$ykTo$@~g2
zRbPS6BYgdl;$&<JXiF*WmKC}{-3_F$Vp^O$Mz)Y}v5gH90(}_~etMs0kFyjbnGp94
zR#VS$@axO9F>Z6+G&d^RG-;76uxwv*drX|IhRusRey%M73RUaAE^jV+m&yj0<;|MC
zaD~cnTjkiUxmu^hH|f7(=cuiNfP68Qri~rg#Qjx`Sml(>)nkyX473-@8l_@YW&vL5
z_+$~-xwkx1qShK^mhdhDAAZa$yVfKi%d_W#PZ5rLUP>0JY|LM&%0OA7aJN7(sheSa
zA9jP$=NJ(LkGY%;J8ZHWSa5Ru^FzX*c9-BDqO){s*ZInxqXzs@A1%qvz7Xo>MAgVw
zl)(HxYfgLubtU2gp1kBhvXN|0*LZaD+`?}5y!7pzY6Tc5HOW(JO^iEHf02S+eL>V(
zs3os1L8>HTy@}VOJ1Z2%#1(0x=^E>RaD-4JeWa8zna3q`MSwzo%7-C^cz&~vYXnJx
zqp|t3yYSC-O$p)d4|E3<ZzJ51o;|3`X3ytQ7QAjsty!~>^99Kliy}hmROQ<txV3iU
z(Jfw}$;J#r)yePqJ}*CVriYLqL53dHn71&Oe!Yd<`B&MkW0adOHc8scP<)+;&~^cM
zEfhjoV2x6rR^!Kk?>v(wF}<HmD3|d+%Q<kS$oDNei|pGqf*`V1Nve@NOYbG{gwcl;
zXMa9KW_NRrc;}s-E)&iuU%(zp7p{j$v__+uID`$c5ky$yt1EbB!2t8flMP$(b((vZ
z|0K1+HlE@nv<7oHaCN(^zd(b&aqusscPiRi0Ezc6q<q7rP~nL`#hAD8ZGV*1yywJx
zikJN2`ZZWOT#+A)!!cA|w#Z;rKD^!^&pMU_3C+Co*^6n~n8rPA1L^FnSFv+6T2h3#
z#OBu<eMoos&T;JsPPBBCGuoR{RVEZOr?NC27Kmd5=kc5x;!1`vo2@ZE#yrf(utHDY
znT4#rimP@7<vCX_V(R|hjS?GpAx(cp7c4K5ySkYAO(L+LiTbvWsJ>u%U%Eq&!Ajto
zYO=ZvNd2>IscVPH^38W7(mWbh_NLn{jnpNCXY&4%4MOxIZ9nbp3%r?7ZCXxIKQO7C
zaq|(>OCC$!x_9Y(!jEcOX}%-si<D#@2p@De-L4Rtie+wiOSj4GDRr^U2uq_HEcy${
zDmx?5J>OBVVh~~EqQJGl_Iv8j&R{?iXVe0C-@2o=MyPG##y(+~W=j7zuXC~*Rr4G0
z&*C%tT&hYj=FHK~oVejyPCql&-*L8IszMH5#i{Psr8!l85&a9vEe(_;J6u~|7q(6z
z?&WmQPnF>IQ3m5PO>L8WYmg(D9nnhQK7lPEtUa%@Q2z_H`%1{<7fC>S0bOzJb(7=!
zA;ll?lVth}{t+idkK*DT^N8Ok>0q6xCC%wA$LBvt_v{s~OB;c+gPM(X=Gz&4Uiti9
zr-}G=M8b$pYeG*)B7y_wbi<|uF?XeenS8GJaG<S;r!B3$i$wQv9?Ue!ar`AC^2LoX
z(~!dg*uN_WKLDiD?%-kL@;27;OX=FGIVhT<WbAisYa;j>WwkW~S5bA;AF?MvjOk&|
zv#J}r($DvI&0N582vRhsKR-ApJ*)c@)HRAKQ7n(z0y1xi8{yl}!lHsYwOdWCZF}X1
z3kUWcsX0(j?0jKedMQj1ics5<uP<bzuN*&6($Z7VkQv0?x!<fUw{yL}WAUI3IL2{#
zaMD8!p3-)eO#R@UMgO2_NLl#?Xiyy7N6x56HTFs&Gw(`kIPCUu@DmGZ+7kWa>`L43
zLcJn=4Q<vf``=0?R7%gv@NcvuXYY+%;^u@wIJGTJrzJFE#!~w2$5)TLWim1Qu9ri(
zk|39=FCP5BzDUWPw72lkDd`t}G<V&1Q>w+aVxtiUryR6eX<S}GZ*`RcijJyU-Ki0g
zB;fT(AD>JcVZ76+w{c1}33XkbeH7my2Wm96#8|!ssj9$DFJsOH;HhTG7`o<b8hh8!
zG+h+OFC5kHuZK{_Hs=e~3FayI?H6|Cf3M2W4<HAw{NRI?C@|X@cL%6Co4j*&xxXGL
zSAU}DTj*C4eYQVrNR>nsO?#vxSCeas(~J&$xoajo{ZV6K^Gybs%Unrv-@fP7?X}!?
z@`y1zN|yy<AUTS$&uyoIIZj>m<1S;!By4j0hM9uy_0!kjln3*^VKAN*U1Hr!kv&5C
z;9BNj_79e0dK`KPaqjODqrr3!CwI{*90n<V(1k;VAv5dYkzTbEsx%G1&BeSlalf~$
zQOG9LH&C@lF7x{Fq8!g}2<O);UxWR0Y36blt%+T-2oFh>XOJ+MJ4*97^r|}4JA{Zd
zKvR!%pHsUlcs>U%yNV)nz?k`!n#U(*WURfX7xi<i{BkVgqx^5d8LCY)$F{Gq)1!uh
zV3A&ayE$d60k0+NLZd`%BM{F^bq_pjdB>>bPsynA<g%NpHZ-27z3;joYr9B}jTnA3
z9>Ge|G8b=e4SB5U`lSrSs4{HmAOw}p$-)CPxZP8yCYc*3%DqCh2WMxRiV3#Cf~|vf
zDyv%OfoyY)_U*xXY3d>V>{)IG$t!(3>RD5#MA9*6!o`*+lk_VzETX4q))qFAdX)~Z
zqdg@Du*BiZZzg!&m{k!9k9HqAa>^U8+Pt6Ouruz1SEYybYnR?A$xm;Cs}|5NH&cU*
zRw8YdMwqtX#0uE#_GsvPI^OmfV7u2(u391d7NE((KO1nOxZ!F##(<}#&a3M`C6a61
z$(JSxW|7{Mpx$f^9XjEcWv*o5eb`R!{Kr3?WZ>U_ZG3IscK;fE0f<1=wd$gi27Q>6
zgN>lkidwpv9cBlL%V8<IW{{GzRsNca7mJ;|gO?o;N^M!Y(*o=Cw<Pwu!LJR}f*SW8
z!}82F;A)7=%loY3;+xz>+PqSK0PZvY2syMWd2i;NmwUCCG3)ZHFEZzs-_PAruOttZ
zXF}H9ck0W;YxEIt5L_$PKv(>ot~0u^Hv$>ZtZsI~Eb|lm$K&LwvS=l2il;|=gD0)(
z!ceC|##YpnAu!jlA@`<CMRxfxEo1xRdy+>yud>a_E754{rG*~St)$+w*(PK}VqOl1
zByl5>d9_<Aqu9q$sL%(k(Cx-&tuI(yZcsE1CfrDWBvGvP_uXltKhDYXq~+-KeY;P`
zDda)a4lj54nBP~YY70Ylse%=29b6>jwZ>Y{7izm6f_LmAwsHKtN;K-4Zc@p!5;#V8
z`ayXXiqOMLne8#c2E{Xs*{Yc`Q>8e`{gP#@n1?Bk7bPUTDl1;W`BQ%kAdCRfEHPC`
zCz_#B7ouSgPA<zhJ^nB3y?0PlUz;u52!e>vl0;%Fpde9lrbQ%+<Qx?cnw&GVisaA)
z0m&#iOU^-ZkeqYQl2bzm@A=Kld+)sOJ9p~Vom*ekS2ch1AALAf?`NOA_t|?r>sia3
z$rbRII!b_MQgm2Qj^llr==J-cGGRJ#7GEIMBq8xBNTD{WiSF)aO!=EBhIi?0fZMG>
zXx85IPv$jlZ|cs<(S60lI-TV+#R-Cn?;22Lk2-!|fKGz2CdSFDyNcQM?=19--_rKB
zO*zoLn{%COvwXX;az32vCz@eT?7R`{Z0&U?T{eCTu$17FCs7cOi)mz;=3i#csN3t<
zM_`C3&u4r^^JqDTZ&h0gIn%H?FxvO(dPm7^u`%9ZCjG>o*{KNV$v|aVDE@$Yx!_1J
z_VdL)mJ%q6V3z~5UJw|X$qmR|_y!de4Xm6my)S^Z2Dmdm>knwY2ODV(`u|Ps0{{p@
zH?lk(u*=YMX`M{p*MOO~ODTN57K=~>(DHlmKH1}CObdJ`C==}ZS3$>r{qxd~6~`s2
zdL2?ldw`TKgWLeUH<n*Cb2jLic<=z_PmKK70Po4e#>>2bz~QirBXu}z9a%I)l6Rzx
z9hY#ClFO!7iqc0M@a!AgVG5SrST4U^07`w>afT{53~{8B46xxK`p{~X5|FpfWd>a`
zw5kVCQoAe|1}=jC<>J?iEYxebchfXV^=1@P=x2pH)>?(!7{%mD*bKs}-*}H=^8fW>
zPYGns3^lpcIu|^JIMCRC!4Qwh>v{SwzixvmbOA0(@4tA^!iH8K_oqY)pHOvjY6b<o
ztVq~+EPQ5xOZp0297`#6IC=eO>Gm|#5<=q3fGMr!=2f}BWIb+#96VMUuvvS+ooL+6
zI`fSH+HC5hGw}yhbs4z^37<RqfW2$5JB?ViGf~Bko)Dj_$=CE*yc5c)G-RDA6T^(A
z{fvLZqu0WQ3G*k|_kTEX?k6~}TH9D(6T_L4sMV4#oX6&yXSI<O^GT8x@4nO62g&c4
z?~;-RXmX@TAzGn4P(Z0#_wD$%KAr``#pk-tnj4uzmp}0eqwg^5^ek6FgW=Yk+?Ng~
z?zQW~Aq^fOE6wA4g;s;vGBEnW-hN%Z#TULkRw*E_{-53cyIo#gfC~l(+5{77*F;!o
zRoeiMM1$S#O56Dn%{Q;@MutSls($M*sF^gC_qrc(W(4j!io!}DXOHDN{Rxf}+gr)z
zZKxXj7v+~{#qS%$vl)x|+Q)8bzpdfdBp~oHy~Rp;#K4B!T!RLhR3^3)gWH}<xvg{4
z&ROX{jpeGaTTSq>3NTd6D(s2r_CLGjj6(?w;e)u<VMGfxlE=P95*ci{-b}NtGwyp4
zrx^aap*qdH{~^t6m;$wkwjSWC7bG4whiqLLX6QQ(SP715V*fr|Xp=#dBHvO!c8hmW
z>7M%u;kqW1M{)^G!E1YJd*0`s%X3O=h^SU8Xb`EDF%HslO`e0Znw>Vh{(_bu$hnV&
z)L>q2OT4a+SE2opp?LxY4uF~bHGo>h;4pH6&gD5E@0QpOCPP$t8ZWUgdasRM2W_q0
z*|ho`;^~-s&ve7igW!|RZ(!)9SDy?YNUT5@tQnph>-0E$t{KQjR<@DL>;L@vxTQSx
zoo+nh1f+X=Pivmqv`{MJ+q$|Ij^+x<2XCE0XjN^G5quRI+$8Z04SZ=lK|~4Y@*6$o
zs=TzaNc}M0PlcE5MTa~2Q3MorBBnAgEtfv}IB|73V%&(y1{R(rKUSP}H<<b90-&kb
zLl-Tot#g3;%@YtOf_(O;^EEu)4$e`b@TAqOo`$@Pm4PjhSLfA`NNTXoHIdYr^3LGl
z+N`NWw!*k)Q(jgeOV*(b^S<)O&DD!lG)w6>5-lm5Ra9JnLhF-Sk$0v2w+2!-%x~Nw
zRaZR@p)EKkkai!)=XBXjEbl~aP3)9uIOW{e_2&gi6JO)F6D+pvod$g|Cmn0tA+4}w
zT<)JL!Rf>&_$k~W_9f72?&?TUB_boixh3<otEOP^BXdJW%SUu{D-2ib(?J)FWuZ{e
zaIkA*BL>>xJ&=-=`Eg6hicC1(*iz;()#hF&3Gppf&+)a41K6?j8vGMKv1O;XPUm}M
zG<S*JdDjnwV$FEjH%(S;H%^XdCdHia*xz9*tj@U&gJNsk2gJu2m!FY-E8s9=zVegO
z&=W?^S6+^=m|XydsufftbRv3enIImoI>y6HCXaV-3++GFBvXR+K!QtPq85_}QQ-yF
z&c+K;xC6w6N)$LWma5v%yX0?&5D-utMSAOmR3qk8R#ZY<2f6l+lt(S5i8m*ni%08+
zmaOTbcPS_lUU*z<ymAyc@Xpo;aH|Y*?6^NKlIeI{XS}MJtwZrggVO%Kc?L>YG2bFV
zxQ*C}z0&Sg%qLdnxHbZvRd`ofB*QIC=J4-}lg7>mOS}lfv3c!Lw|tJQ@lA(kUzPAi
zq*3MVB6#Kz_u?9fR>*x78jyY{8?^LvPjEG-f433Q>#&_&HNV`oS;0<ilgdvFuX;Od
z`wX}7Ea`_oL02Cm2T`vL&>nRoZeXydPP;zeuJ_x?M>YmU`$a);L9M_Ri%@l0RTXu7
z5e^F6s^g4K1Oigk8iF<{Li3(fw{~RUA<Z;X<jP|uxQNxy)YE5hImZ05f6KR6u-(5U
z^-}~d<25D?D}<cx#6CW0Z3l-fzmMxS0hgLa*$nXWNagD-K1KO_BxM<J&ZJUxkL;kA
zhj99`o^Vy7o|$;|tS*N)ah6y&;Aa&t?A>q`Wb5|j%Ww$2m7Copb)hTx;n)#tfP5LZ
zV^WzHj5hH(fviD$fW#Jz59w|~KL{hq$TI@fI?l`h+FuKgSj>8F`3A?c`P{d{O+>N)
zK3FZ7?@dn%hqI84Z;ma};|iAMiQg*=63rL&F}<x=Vt+q>&*@d&GW)IHgMpA|Wd=wd
zl;*w;u)oD`Jb|x8s0|k(d6i#|p?+t+N{pMmfB*aX9gC$9N5LTG4+Q-p;F&zd6ROXW
z<ktF@p{@fZjEBlT>S=EqKPh?LQ|CQ!jAe^0i2_T{H4UtkwIl8$vo1}Mk;j#t2|ALH
z=935IMb)kInX$KszAi1Pmwrp;-6MIifg1)wXkxOlf}S3$X^988E+=Lk`q@J@wO5jO
zK|}(xmacpENEbqBjt)q>S5w>_rEife2sL4WL|v6!C!Amz%}|Gwpz{tnS=@hIk!Ggm
zK^ODtm`QOpf<1}%ciyA-E$@!;3yv$>8OX<*s84JzJrW!q?u<Oi>6rCYpH~Z4_0%z~
z3)^Ix*)qg;{)NBh#gu#rj%?7bE<;`c&Yj{ytMheLi?rH&3(~|zw&SK&-|kk1e3XA_
z=D^I_O`r&xX+?&klzeHB9mh)@Yrzrc%T!iSQiq&zdw!HM4@aDG9a}D+gQPx8laItg
zgzXL+;XPqUq&`)bvc~29@k^vbPq|gC&J8Cz+3+A+#+85HHMDc2g1?aKUNLn*xq8YE
zoVL=V%UECnuYp4|@C4|oUN=l|R>8@_!~5)3ywvA7SdN~U<H@E%l0qmyo~&(~9Ge_a
z9xtzZ?}!F9t}e25{{bntiW)T<4cm?vc{%edoKZZvx%_!lbss!(1YWS7^AE_=wYiC&
ztXA@|%4%rRm8q*wqab{GzrZ3w?AAQ){rWZ*$}&tYwAolL%k#U0gIxL4+aMdOqm{7L
zclD9q(s|hM37PHsMYr$e#fuQ+z~I&y`uP7}?T~<NQ?7&+b{w))CV-ugtbzkuG|+k3
z0rau}UNwAG1njy*hW1Pj_!dS8a{k)&>HLIOt{)<$Gt2*g^2#u52`$Am8Mf1X(8{bs
zq|oZt1<C}dZhw(<$gk-|aqMSxzY35C`^&fOzxsjy8TotThri4piVgIKy}0A-1LvtF
zJ0`~F4HTS_Ch@XDJUe_?Zyn1#{yBZfk3MR-{knTK68i|MaLvhtZDZQITZfnYRR>Qc
zc&EwZKlDm^(IzsDkaWythyQ-C+*H%Rg^g<RPn|S5P(Etdn>Ba1e4}hNPtW@s!7Fk<
zz0=7=L^SqGeNO%1OVY3^`POQSFL7+#1B*&HTJM|UHGaYFXpC5fO{Xgps2ELi%ow{z
z;9ToKxe6?cl{RKx32q}purISVjBe=h<8H^VEc41d>h@n*KcW0sBAyU?Q2CDHQd<}U
zZ*LIhA1JbtI-8o6|4k@BI$~>|0~Yud$ADzJO`7~TH_Cfru>qVUCDGT1{y<qAvm8i7
zaa`p61G)x}H;9w}@p;wKN`8knM)Q4`r&r)wyiV#-&#tszSR<c9^`P-&%OFMXFVXmG
zr}H5`bpvTPKU+&z_qS-h;nTuI@4)O1^TK>=5pY^$Qk(Bp4X|V)1pA&`yOxOPn6Zdi
zg;g$D3o4gu1zcVT_!IjdjM^=|SNE<2kC3DHG;Lyg4%F?W`)osgVh!P<pM1ja%*avL
z`EFONVDZ*(CIuMUw_@~_2;V2dlfGb&L1DG`P7ElQ-7DZfit4cOsW<jn9(?dD&Q!VB
zRzbLQ*i7XyHjNt3kSA_@6Z#9TsFE=MN!=Dd$1iq7Zxi0M5|-yywp>B`N@ii<eilHr
zjYhf}JttcfQ5#k0Qg1ol5G?)C?k)ywkXWEWo&`;c(`HmE<Mae`_Fsa~``NWqwzhAk
zH*k(Hw*~3>3@TnrJJrjtIzNPTpxMcG-M;EJ4>nmC)B~y&)<+t;JFa}l*!JC;O5&Ct
zg6rh)-^rZE!%HmXJ!i#@%97nkaJ8Wv&N)#ZTG>h|v*SHZO`_w)5X^`ZfAN>iFnE5x
zJYnI0;0J(HzAqT|D}s&QPH>LSke;he7(>?dQvCAc8Pu1goIIpDplW+jG{iRoN1T?B
z8@;w{3Fd+MJ_Iy&poSvs2$$hq?3)Gst~Dmvgf%S*dHdEJJtHPr!b`gpT2y=fqNlO^
zL?6uM2Z<LmoJ~Dd*SQbZhUT;T0dYd|=;7YR1=`8b#oD9Qnuzynlow0tL>cEFP}+u!
z%UQus78bNk(T`&bYzfVvi|<GH;s#cra5HQ|$w<$AUZWv-*6i$sNhWlxLZEr{z%sgb
zcxL@tM;h|M?tn0sQ_02sUMDM>M~llJLc5J`a8h+4QAi$m_3WvOx39Mt`Yeu?WN%^e
z`XVn3`m`Hn&Jcmm{stOM<Cj0vknKeuK#F;Gu#$4;EB`5V+?WWy%GNW*Y_af|L#K+p
zE3xAhzI4I-K4_p(4V>)P^3K4MCO^VeFmhTuIVxavMSWg&NO)mvvn7uy%;9oyVaFnB
zj8*lV<M(oZFjpsYdPLss+#*JRtlWDDowxAy!v)mqs=SG-+lW2z<qGUtzaKzCOK7c(
z*Le8Hic@cq3S$i?cKz%q>IJO~#AEBleNw0Vr({s9=e*GJbNPYCr`^JB_8_!}+F#O>
ziHu&CrxkYFcb%c)h)n|_@-ELDwS-6T*<qv(OFr{4e#aN7<y0D{FX@}J{O{8km-fyL
zi0Y=(74A7o9D|{e9$D?8M)4I*b`*yMw>O2MAG^Go)AQK)Fj2SPHBazC%2+5Z54^G2
zZFup~3`s=#vtR4og&fX{d_rlc5A;CvYVv9ql-r5Pj$_;}IH(_<)WI)`3KI5?UgL0<
ztey2?uPujL2=oV&p=8!k3`dOOr^URjA^uQBC;xZy%j0gNc4WUFtDqjeYxsO(PWr+;
zEdXbR(@P6;Jl;Rgn2p$>d_ge1F$dQl9X}wxxlX*#o?fTp2qemHaX}R`EGbGgQjg4C
zg&2f`_GFc4wbg}txBq}9_0%zi=MU1TLw}E1UTa^}Bsn<T5xO%9K0LUmvOxtYk(9TK
z_KL~if?iGr_=Dc(o}ixAx?e>U`LL=H@fPFA6*!C)rbGyb*qYzCp$j)^$;f!<?5J#O
zI<6(hk!z(t?JHIzQ=VU_eD%j8V>`TwP2MqUF08+PXJYTjt~l0x{uVp+PHi5_eNj{?
z^Oh!|UgtB3q^Z>Ksve(GULPud&I@OUN*L>wUR)JZ&Gq9l<ei>!2e%vDUkX8M+g-^8
zjJJGq_ITl6i)+VA-$g5%SA35e>@A^aojmaOQvGo?1Z8W{s?$q2-?ihQ%PqHKY;~4h
zfs^X5cWU41G+@=D2fa2s>2ir&gJnx<Uh+u#on*9E*<HA+By;jGN_?$Zzt*<r&OdBO
zh97^Kjkg<QJlJ-hV!8(2Oih+BCNBqDE|(pVqFT}199QvH=E9q8fj2}c!seLsyJOxJ
ze?XA}M4So@I~qcq&YE+x{I?q+$6MK?d)Bh2B4}Z>JbJ${Xfr3GiH(;a7sSw{BatuT
z<xKLhhZ@!SLCGwSKG@g$O8njTUZ;uR;TkP5(j5Q5>4@zgy(^Gkh&M8}uqp47Ur$QR
z!saAXvYmVOKmtQDdFB?m&Jx0um9V@9F3v;oEbQzxtlx+*LJ80*4&mq@&fg>E`Hg>2
zZQb)K2(q~QlYYGXH9S%sp;liBe;nZgMRD*LJt_T`zkpc$-llTp2-WX5>@E*Y5g5c2
zk@~zx=`{RcI&CXpn&uA*{Sp93GFpJPPfF931-A}4ryT+it9=4(``-3RWM0l*xhjT;
zT?Iu{R9}LffkJ|;o*JFdqjP9M-XcuYZJOQoH-Uf0wYGoKYABbMxt0FI;1ix<%Dntp
z!`*WHis;^~QlQGHw4fyv@h$$rrytN1yDGEP=e-y{gJ=1RuhL&njq;vf8^F+!O4$a)
zvSe36ESQBebeHiLE5QtoXhMTry|1YloG$4^+0Pc7F%2wNFQ5BO-?->ZOCMkS&~wOJ
z=s=3$9wlcvUD}kzy{W-LoR|he5EsRbK7_x|m_M2uo|2y3XmwdVqiM*^%bGpObA-?K
zF=MRRC6p}<7eLE~<jSHsjb#a;RV3fCG;XF0$J!NK?&9p>FK>2{Nc78>tlh4Rc{wZl
zU3#Z!vWx`jC>CnZ_!7+G4AA&1-)7G*3a9YOdViuLy$MjW*6+^Bg;Y|9e_OF|!ot}~
z>;@hvPY&%ESzW&9p?F>@n)YEENZehNJgnKO4edKDR5Cm3a&lZ&5nfVlWcYwPyu+?f
zw7>7xDLBRlcXLNzo8_2j$IaeLz*RJ#;eUao3vnYg)jdB=)Xbh&t6a%0@9XIpbJvx>
zh@Gzx*@5J(>v6kq<(9bXJ~*fD;(mXVsbQqt*sMB09W`kYA@m|v=v<^Yzbbq_;jAoO
z3TzRR0xc6rWT?KxU#{I^s2<4+-Kq;z{hsvD5nq_0d0&aYh7Tr`Sw!EGfc0*V<<8|v
z^|Mi{_93deZSlMT(O8wSX(;e(?#tC}1(7T3u^QA%kYxlLVr_w7Un$xb*vntWMEK?`
zFm!=0at*DgO6*^q@S=+0QxznYZ)xM7EJO_i6<#%LhSsvZeb?y}7vX;^IXL<{(d7a5
z*wB!(xyk(TUY85H$a!A2qG2Xa^>m&t;Pj(zgJ0D&=e9^Y$!wQLvTs84%4?k{l(c_t
z>b4!B=KREWep=7z_bK;khX85sgc*smE?IFLjxfu{7sVo{<6FX5c#bQTcVN}_K#&PX
z6z_BBIl1mQY&!1K$#O42zB4@SeGW^>fM&6&$sAWA?vtD>hjZwLHhxmBp|aDqVeXdr
zO2kyjR9d0bvsi<mRJYqHZhGM+>2o~f25djDyzH8bRZr#%CiHhN1xHH;N39@8HK`|n
zfD!ZAhny{sD6UyV*_usS&EydwZ&mOXc4q^1cS00X)Hbrjmm1+*3`ldP1V{l+eZWL-
z*ek!J18;_Pz|`AUI#<in1<L`g9EL#?nxRlj+&c@y&;EeSSK*3V+0zM!tFl68BM~5W
z`JWX!1+)5l+Q==K21FJB<xAX3`p3Lrj^9*3@!KaWlSsFRo7K9pvkDhO&>WY!?#=6L
znFxjy7?7A@yP++g9T0T@r0yLht_lIc9<@Zpaji71>=b(U0&$EdW$4=+Om^sl6*`yd
zpYu0U=M9Cs$Db`eA~1a7C%@T}6?Pa#za}QTOPZ@|x-Ptcek<T`9ocPJ(|CC4o~u$u
z=sadmxXcpv(d`e255quY{>4Lh{Tu)c1b#GsD_|Y}{?O;UWYW{hyp|uehWZN3!PE8x
z`#SH=N)sL8>AcQ~Go~3!z~Jg7ir2t_s7(R;DbT)nIN2!TKuG`0galnyme=g|l$~~j
zI)_QZIUDG#DPR-#dUOT-Ozyq#Q3RQv=kOnp!C3)$M?+fX*`thSJBx4))d`dK!T5s$
zzFoC$sZX!w4`R@5#q;6wK2(@hV#Hyzb@ruq$!7n2r_o{*NFAOBDRH$~@hUMTGikIe
z&_dkAsU)g+CM-)QC3ZIWhL&?k_l=0yx*)Z?6KRcj`<QJ3`RwW#&7&r$B}WR!22XER
z#0ATqaH(dbV*mE<X=lk1AHeOb5GIf*o153Vn;;1F-_3d{R*7??ap85a8X!2FK!?Ks
z-Z%EjUebLTcJ$EqVrdo{WK$ii{o~Z%kx^<-7Rt7{`Mz{|VaxV>p!v<pU_O6~?hY@X
zk*|Br)b7T-+~-5X$mRa}`BqAps=a|t#`CBdkmYHq{+VG*>&pjz<=aRKKxkH2IsR9q
zk>b+)>jojKy$!l5ui^8O+b5CLoi?|#eayw}hS(#+RTKbv7wiRIxo<wmCoXL3$lh+Y
zMlW}g?!lpd`sAWC{+<|J{0SRPW!99qme(^I8-<!nOBMV6j%!3mluh{eup1f*rZ?i{
z;-Zr|LS6u)(}4Q6BFk40UIge$fRX}7D1*f>Z=n!y1w3OqBE#OUMDNkC;+~tVYC|ho
z=AKI$H~j$t1sb0Jt3X31`aks{2YeJVZ~c4Y@#&Q5Y%9nqVF30vAihQen)$D1bN;U~
zLb&0`q(30$Z9^cL=73>{-^M-!@=lSfttelB<4tV*f8yf(S8V_HAAZp1%Up6r?+Nn}
z&|p;cDzqy60Li_^w0o(7VGn9<PHxIt=Zs9KJ>J(FIeL2Pzj$AMVf&Vr>B(Um3+;qu
zR8l6`QZxglMLmJpUoGKY5AJNH>Ep*pw=?M{Gqx?{e#5(a{Z8u6yN4?u$7`%lFqwZz
z_rE%6J+=W7hNMy+k`tn3D3ksaOu-P}wN97G@ra}(P)gvrj1&j}B*k+x5LhVmOojFj
z2>%ECgyQyab!#<zE(-<lm%5<GBMg9s*k3mb{&jOUuvYy6t^Wbtutfd=1?WPNVYjw{
zyuw`TfjW>11Do`>u>A8aU;wOy0KF~lfTjUhaGk1DlGE5p;C{q`+P(<|ydBUo15y>_
zz^m+MF$66GIc`P6|6L3(3{fU19ZaFgfz<xB4j^Lo4}X_J{%_i(hAEV=SwkRAu>Tgs
zzeJpcr2<&}fR0+a5SG{!NGz}tW!M0%0TvJ?Ouhu14Vm#zcR(TkVT+*EawWdNaft{h
zj`;&R|DT=sPa)yB9Ka7u0063*pls8G959mlhnNX~PW_MDBzKvAQ5FVWg#%GyL)YOe
zQ(!FPKgN{F<yVF&!cKBuW&&*1HTXY-oQa12T@U|TbMmp14Am!cXzss%KL0^Lz^DMa
z2R@gBonUB<_f`4lkRiY@`gg<XZw-RXWlgoP{_~jlhj>2JA2kSd3~<t}gF_^_bF-Ke
zMKOWR;d5V9V@g^Up8IaZ)#kDTubKbuzJHx{|I~e#t(Rpe&DObq>C>`Mpg{TWMoR$j
z@c(Xn{_S!8>n#7r`Swo(;(t!qM3kyGR_g@%k0VCaANub{=ZE@#Z4TTTp^yCM>Gsc~
z;s0O}`QJpGr8Vpg`~(f||BP=0Sj7IL`IiCAzt(thYu}5qP`Lx#_0>Nh{=cn~Zy;4v
zh}M6<AlP%|!kdk8P=bApE3LsQ7+_7^HJn^)DC+@-dJo3!-oQW0hV$n*Ip2IHFMRuv
zIq%Et3h8)@kIo1bzu5L%C0JiD*itC%@?n^KhcF)>Rh<0_iBNeDJ<p32310zmEiJfW
zD&2^}bCH}}pYfgl2V4hM+&`np;350HY<L5~Y1XfZ<98q*GVq?tztm7v;;i3mxh6Po
z!@Amj#?0OUSgof1N%?<OR}^D<w9!s~DWoD89ahzs_Rqj$fOjxm?~dc1CMrT}pIB0<
zd!bYAZYp0o6lc%+Fe7)diQS7eR_x^hW$$uS9rhK#Jvy0@v$Jyy;G)!Y%!Y?xtGCT~
z`Wb$Eh&@Ld+gX&Wae!kV)tKu}=koMjNamJG<r=cR4LZtsOD)+Y67e%yg&-!QcWQ&G
zoXy_T!sJR95Z*SXSV%8PpCD80BbURg*>*9ozq!wMJt-lrHM#aOM&CBP{^6qL_9Szx
z1D8^$*29Z#5ai>aiIN|abxQc8BfRN1A^#W70^b2M8lp(vZLlY;mjo?Z*&)S&_}ACK
z?=@e}#iEXmF>JLnRo6na1|IR=xbe8hdo~XMk5j8@mq%*pxGtF68q>WBS>I9g>#1^u
zS(&>@_;R}{vF-Q3LYnV7O4|WscUXV7hNqKZ9}fk_HcP@>vsYu~7zVIUD>rG=YN>r-
z66c>-9kNY@@n1tW!xF~ZYew%a8YV&J0YM@2MeF;F2UWE(RG2KxZQZfzh>WEKqr8k$
zpUJvLD>+`FyvlJ7#`(10_$u^Jwr!e|wEmy8As7m}j1qU7OQKQ}Z<J%l{)CoS@d0UV
zF-p^&2{M(-OF*7cd2Rnd&-PWD3#wgZH~GM>N!p?Qt^64H@+D9pUpF7APbAlAHpGx6
zpl(88X!y}Sq5QG<EgjD5@eK!O4Y>kLE^S8I;p82ttFy}LoBD8>)`;$tqZpsKh-vy9
z8CpuO1OfYP;j&lbd86M9hn?;_we<j`P%>@7T8+RArRKns+#Y7L5i+@btU$<>=;<%B
zbly9^53mBe4GT-IkR7Wr@{x$Zo?XMk#LOTUm;9cstGk9Lnt2OCe7_Hm<~SBQe+8iO
zC`C<X`M-t<5|4ibj4F%*u6cSYH-hNQ2x`}33~yfyCM3FDHWK1Rf!U+L>x!HTJA%db
z^rCy`u{8rxgWM_|Okq;r4Gk>PIQ!1;!7tTsTY?`7eh183&HPbO1W2ul#3$6HES4H*
zo+|*jhG%3|B}ByM_nZ(9rLYFw$<mfkqytYt&Ti&VZ}NPoV+|_r3Vjb^I(b+eT<7_N
ztm_tH&5;PwoiC=u9{h=qP(mJHeD)naVDS@g-*WQW<`MbzG59nmVOwp+>@z+KBK`}U
zPoA;itAlR^$p#>|pk5h|ozhwpliO5sT4dbHfZ4rM9x9A&R}n9RtODMQpJt<_^IH2`
z(v-C(%Svu%%DDB?H$uAWe9X0Da*}2f7gGHV!+b;c`ZUDMd_2THUPfk(u$pNQOHREf
zmiV2GFa+=GI?BBth|Q_oaY6^dxLlDmw=PwMk`|7j)6o9Bcw3eYtL1r^;BF0jP=eXK
zI5s|%uAla;eRDY7l+l;>L=g+}J2>0O;q#t-1JS@#zWn65)jQ&TtEs?gnb&$!%#A>&
zzWS|Q79aaC*RBMiFb3wvjxyjVU0G@a-FA$bTb%D5r08Q}*!YOZb&5M0zcC_gp);J1
zr{B=xX#KiYG%LAfZB^^wKla*q?)`^t5rVRP1DhwE>#lL~06h;&*+Va__^~Pb^BbLj
z2-e}&r={6ri!zNvQKJNTEa%@<O><rM&3}1NIjW#u={zYRh|;*-S^Tqgt`F;mR}p=u
zCS75ELGYO^XQt1G=~`N5?Cy?a6{l#t&rYNf$+K@Seu&9r9GPO%Y)0M%?J4;h8pei+
zGTIKKiQ){ue7BKVb|{}XXKOD~Dz-6j=YN&Idj^lRVDGI~pr=`ed0Re*rEEaDn(A-P
z!rCUA6l{ck-ME$uz20WJne-HwlLQQQEP`910|I$ZHY4ZW>9!5OV^uw+Z{&;nQ915l
zf3Nh_J+JFf#)cU#*FlNI0Vn?Okus^Hu^(JjC>Z79P?uUa^yVVqP6L@;6gR&+y|cuy
z!~Vg~5(@76xTM|kh504P{m^aaMM={pj0D@~6Ql4G8lEJB!+;qbR{JHU8fgyjGBsA3
z@_BRoN8M^2#Pn2RWlj6G(VJjh&jd*2g77_2yuR(_rxmW@kZK+^=OP4ri_dTqQxyy5
zm3YyM`T2+(W6de1_Nh1I(12lODl9#jWZT2H)=}0BJ7QYUMq7S;??m^xO`<zqekcpU
z7(ez?iC|71XOW^)?>cVA#5B``YC0V~)oqr)1V4mjLaV$f(<=otTMViM6&D?;X&HVg
z0J<3h?Yk@Yhfd+ut-m0N)ad;$iJd`K-Mynfcw*~;M2wk`(3o9ylwRtk)+2C#{MTYP
zHEFX;1doO0Rg61gq#VQctCpk3T<CbkTaX9PQ3tU<5oapyEp#w{u(NPL{l3daYV|88
z{_C6<`;At^+iFi65KC5lNdnKD%NLvW7hZX+@7D^WZOBog=L^1Ab005`wrzr3oS)2>
zkP$Ko$>BG$>O0J?8i*KYh4Wnmu(K#;hkZ*I)_V6bUTWn5Au?KoWeH(NIbw(?5+5U$
zR;zqWL(LT75<MT~rvS2?A3tL;MFzV{zUAhwyob$gVDiILkFT#)iz;^9KIz3)2No^D
z&V&tUEs_xGnja*;y<sy-D$;)bek!j?QuF@p;mig2W4&>!o2pUj5XXRYO@M1mb3sga
z9?3hCw4!TnulM;Y%gild%9kk3aV~TAya7Hj$f^+%?R?wNyy0PAx}J?2NfIl{{7LG$
zIDnp>OF&E#UfwQA{s4_!0Kn2B*wnP3`Jw{#7ZUI<kt=3Xe}UfJGAF!1a+~KXcrm&e
znd%C8!Y-Vojs<qJM~)_YI`ZFjLN(}Y=@6Y$uW$G{oi2+a$5OXhGB%BU8=410$QE)Z
zS#Tc*3jmn{Z_MiHZ$vyT1JV%dJEa(~r(Qx;zUv_x9~c%GAGYEOIG*+`c~)=y(iU9i
zz6$vRV*J5WJ7I2jWxw$URDr)dRQ0&Z!ns|JsYUt8n`iq4S#dVfPr6IQyR8gg4G$9_
zcJ;LrBdzW(&3pAU1)#y!N^Pf`Z$IZ>(2-v-CgG8XTvk+=jU>-$m!~Qd3ed8*J<u}`
z6vc_mf&@wui_UEv*47)fs=H`1g^ftshd$hI<xiyPj<GnEq8i4WrQRKScFr+xM02O-
zsFW$fgBjgjUQM1?!&&m=?2fqYR(=D$kw>3f$grtX&xrOH1{xIG^^L_qV^rs@yfYCD
zt5Z!$$k_Pz*4pp~$9yM~Lj>E&MQ-1%g(~qA<g*x3!b#PYeAb@cBB;jWeu)c$p?qaC
zpP#M|3wtoH@2Y2aug+NS)E-C3?mnUqCb-DYPFS1x$SYsB{{fIkihP4Iww%4&sp}Dv
zy1gtwnUfc`tvoG+|J?i8&!=e(75?T|PP0SZo_Yxy(@sp#1mF=*YdanEzYaz|v^<q4
zsIW>`C*)=x$nc#qnfqSj{G$%fsV-v^3*FdDikldHD%Mw1bvMe}O$>gN>Vj@*W=igE
zAGuC+<{+Nl99lo>g${kMX$*pWGBWCoNpDfbMU=Q*PWjWm*NMUvgL}(zO6QM!QERW>
zoH%{Re;NDg_pgAD7riA!ez@v@J|9_8ndxtr>$gQC%AcLFr*o6Hq6l{tT)wxN@y;22
z-JsV}Fa@v2=rwGGC5x#1PE*4wxdt&~k8uIHB6N}9wp3$n+@MIZ8Fm;FX|Dt?*gZf9
zzaemLgeU3`q;w8?Jcqp-V0l>-;jel9^_u9uiq}0^u||OyIj3m&-LCYt(M?7hn1%!t
z<5k)+Z-_E{tM|)nG6;S%aV?YDq`=lIA*l(;6A&u@_RGM^Lnl)rwgI8-@)2n|^=Wr5
zJ>$bs<1Y4TDXqNFy9uS3@%}}Oi}sY*TI(*6OO=N?0iuT@wW+NqVQVF_mQDV0D}VT{
zS5Y9L{gUE&FMGyjPb+-F?PSke8-RLSKBf)BC{C{5mrB;dy=dhuZ5zRUKMD45ind~R
zELay)Z6&Gh=N;P1r;Hy?DpX;df02c5V`+<2yNcz6(wraz>3HVP(Wll1X%^o@V`bPn
zUEhY$WeX_Ng<IE#xckM^-`L%SrYTSbUzBKdPTlx-A4-$3>&TCpwxpF>#60g2uLb0i
z8n;>lUVoOdl42?#2y-s7Bcp>=M%Es;hL=e37B+CpfXbnXkP@{CUx~H(-CN8)axX;9
zj=S8!B}V-(yB;!4w2Z#d6PJF*p!G{F|J+n%J7NN*Q&$}IbonO(S0Fe!GU}RQbyY&k
z<Z7JbE<7}P{ep7JnAmy_TBYnWJ+f6HTb|!9*e53Rwu>9~REM!9!0ue-&Mf^+&G%__
zZkDUp<Q}zjlf6ghRzDxy?;V&o7lS8J%v3#dBYWET#a4X9(c0##?eDcybGAZJi;C``
zqluwsxiD$E@uw${7)Sv%%Q0mZ#T465{WVp-5j!<>XeryWZbNAQJnv9IWJxdXSZVdd
zIC@Pu>++`n34UVzsL@Y~kCERS%a58q-Xw2tPq?wmSTUIe{KU`F@Fh_j0beO#tB3Zk
zriUA-%p=lKz$t0E@bj%p{kVDS2MK4*osAoDlRvVchEow({-&=S4>n}8qKE|E?KlQ%
zpz;s(8a7fhh8p*6lz(8?x;T-2?xqVURsrWtS<%V_KW+B6mnlCv#%jg8J|dkAOY?l)
zLMMJ&kACn!>19G=*hgDBGP|+vMZRY(E>+$AnOJdBP3~$ixC4;T*{_nqw57a(>oaNe
z=8%UbTa0IEC2pIIJlH;M8{XD7MaiIjD|@Jaliz$&*;UJpzA2eadct>e&+NQ(uDhR8
z_*uQ_2RP25A6t%wvJh2;P9skh=GIJEvMP!HwLSb~g<W0#do5lfS3#fnb4Uzuyqnxd
z%}i0%*ZX*8ML32Lk@>JP<N=-0t?X5kRWO*ZFx+<^l`l-^!8BFdzG|trWI(Oc*_~Xm
zP+n-ww@@A_-G#H07ddl5553!!mmT}moyYKoP6K@n4+*+5eTc0-cirtKN?@1nOkGIZ
zkd{&2DnN}ENH!rx?z1iuxH|l-!)loW75(qPN6#<k!28MKIR}93DPoKD)?XDBZ{}5g
zSg>4=>r-pmo0}3i6NBVrC<=3;Cih=JzPJ7-#S^EHz!${4jwEse!0}hY`|9s}f<ZQ;
zG87=4e~)6Hd7nq(Vx^wL+gi_=UeNwm>0kf1|L+9<Pt1RdMkN2va^mmGE>sB`)PSJ=
zD<2Jmv9#9`E-#1$aOvC%bSL$QK~hXBbklKYZC|7ZLq(3aYgyQ-Ll}1&9{9$(3g__r
zFQS~bVCxzudHaodLr(}dQ+Z|hk;3C1iBBJ6fBAq2B?3JweeI_%+&NcFZtdw0);Lx!
zi0XE+G*IJ`NgPXl!8xa-JUc>j97UL%D*-q)fgs>xVUIxSEkA7CNf5%403}w)MUdZZ
z8DA6tOp2{jVaWc%k_TJ=fM~O@4?McLZ=U>xSEs<SLN6dvY9;^x-adrv0x;(C)?*ik
zKcMa%0F+8Q3CD(-!B@7H0W!h}!HA~LaO-hp3lDsh!vRe<4<NP;&{a#{cL2<(yNnb8
z*3)&@|8CoV_uGGuxBqM|#9<#?b&7$PJp)$L4w~yWlgCbJ`#_hGS_<eL+#ON&pkvEU
zle@@MYFeoVC@cWuR^0!tJ{W_XPxXmFcpqAU%E*x#PsN3Gu*tP&WwvE^kcP++04K;T
zdBM<)=n-&IHgCVkqF(#J#VKL^q)U+%XX5_}HFxZPQFE(ZQIFXP&1u`VO~o-PNO)ZB
z+f~jt@?C?SPx&Q0NIu*IEMNP1+rZm}Of?2RsaIUFOf{t%n^7MAOpl_)Uv6d=Ls^qL
zT<UQyTeYolffxeD=L(h9XmvRw9y}O3I{cL-aJxIQM6bXGCMDH30H8M+bKZ@0pPuTl
ze0sPFXFFNPTO8drI(R4SR&UvK`{QD|2ax1xF?zGMMuD(qg)9Lt=xH&#l>-;e&JF4N
z61ogF_Tbw#H8wGxl?-i^ApiQp3?_Dsj46-ofT73Xa96X_?D1lbo|~5oU+G-VTyzf6
zglqJ&&cwajEl2ywz9uAYDdsq(n(O)Zis5N=Cp9Z;-G=+acRAF06QQpjVcmkc>U!tX
z+{t^4;csl<*!%U5;pg*7Z&fbw*KcT=36I}L#$4JY<?fX3<y7v8tmP=UGV0qqAMedI
zZ#`I|9|f;HYdjsak#_KN%o^;4Tnt-bcmVa^s2AelLU-TbcxXZ5?d0xlzPb{AwMPk7
zLry4W?dVjhXuE{2erbX>!6<z0;Udq}YXeIZZC%ouK)Q5(BBjafgZ$6Qm|9Uoo#2j-
zT8H00tvcDp<oU+(-Ke{nYnsN*0IA2%#x}3c>`JLs;dfZj?6)KytZTG9=wm!&i5<d+
z@<QWnj24z&Mw0bv^GsM$#=wfCVD)Rk(cYB~(99y81@-cI=%>{mpT$2ZMUePg5Z&C}
zEIT)nJd~41#Ie$Wv90=%)ffX+x4U$#e?aL@G3ed1y|LZU!Kw;*?<6`p?E3;2&R;_k
zcAMpmr(DBdaeDE92M5qMy}6Q#=JjR2ky0?sV5{4Q1n8|-USF<~i>z2)K-Se37sCk*
z+;CDaHz2<bAvq#aO3wAk`V51AK!i^|J08`u6=D1ON}cz+6UZJQRCvipEaR?qs2wah
zH;gUXqRR|#-9ZP<?Hur@$Ui1#l@DH{y_pdHX>VxB8#p<*h{RvbwP1PJy#%H46*ZL9
zb9;^R2PAO^8=u>EPtgc`*mLp#_q3N%rgSa-6F-+mxye^ZcdCH_i8dSL@qDipmDM>D
zRNo_>@yC5?e9_zXP@0h-Vu=)HUeZ0beS_Kf<x2zy2?m<>Oddw6ms`>KPKH(NIb^78
z!G_SP(c;c&R6id;9|2^0-nyMiE-n3}V!777g{hgcZQruO(93`4QE{r&Kk8(7+${E}
zmi^B9CN4CA?K1vptTfSek_E)eFkYmv2K%U?O1+}<h4=x46&lanaG2=T)%7{0G1}^j
zH#3p6ugOkK`Al@oeg~vSfaP)vu}L2*bLwuI>Hn};p1aCiePs8Pe4q6py0Bys)7*P%
zR;6itErWYbDPEk|FL~72K%zK6%fxVUf-Vx@yR(gbf`t*J^7Nb){9YMZkAp|&O6^8N
zb6kyWNxLngm^q{Bb}tH>KTjpo6*kY>jlINWK*Pn=YiA}7Ih4|Ks6;O5p^&rqR+L+Z
z+1;4*?Cp$!+Upygu>OtGdov7SJUT97^z_9vB@-Y$y>hkoKAyXLzj<CKw$D{>yxJ2g
ziokR|!nwZdmhIgjS23r-8&%j{+Et{4Lu%AEw14%5ZpyADF#n1gmc{wStT)7v?c_sO
zgAe%|Dt&MIME6{f*uxJd;{vUg`M+juXq_G$W>K@8Y?Um*rgdVdpLXieZD;JN4c#R6
zCu|92e3xjvV|4#=4{kh}WS0li2s(2vnSNXWjV^9BQK<R=s(oFyz-EV^J$BAsl%Nwb
zK!aHG4a+`n{>j)i75rAre@}r|)bu{|g>|avtEs{I;Pe2bUI?_rW{=mJMwK*y_wi8#
zVyfylM`_tX=kW7L@Rc0$uHoS0FJnGX_I^8&?-INpo}=ZrGHI+AoakP+9^Hbb+4jBt
z)((d=BUn^gC@gm)ri{jA6%dME#?qK+=DT0#R*Y5d>K5osaPvazNZ_J5ev<K7Edx}B
zaeLIE=px>S_HSvcr5;OTjsTU9s<B;O#9|kbS<6GA-LTP~Uthv``po<o_Vd4NPv}6(
z^mKnRmV|LBY^P2Y`6W4<$sr^o(H{r(D#vKFg`SDgH?5ACU57o+s#jN>`{D{F(qE|a
z8F0k(aSrbr?ZL3r)he8vOpiQRT7i9HVLf{*>7pL44P$rx`m>mf@taAUeCD=FfS<a7
zm3|uP(yUu0IuL){#xfkJ;ZbzBKI^2V?tm}z@D!kJ@dP^xZdI&Ja2!xPs2PIqhO(S7
z<|cO0STuY#uvqdY{$_1x{)BP2`M4vtz-lBzs&{yeM|ELeeO{*WO<e*A-cShM4r{AR
zSNdQdB$(cIo?lYk=p#t7-`t4%>K*y!`&3@fa5YK0#q%YV7aj-0r$vt8HUwu5lbhO5
zF1@cAE`2NTo5nR*HS)<v-JeN!df#N?E}ZYr_)GAlzg+tRQf>Ge^m6%_bo@qZ4i#M`
zm#LgD#Yo6mszwU`T*HH;DZx~i-xB{hJwlFQPpW*Bdd&$bnAaZ4%KJ9Y-)2@rSg<hx
zE3!9fY#G}K57JG+;wh9eu3d`Qca@~rZO6slwzKw*`g+;P&f~uTg6j8;XQr=y&ii~2
z0oNa6>tE$`m7OqVXl`P%n6Pk)8)w>&(@5j{E!|t2Zj)qy^)kglhRuy1xE{Ok%F?#D
z3~zQ>4SMgn!^XWNe(*xmW!~=zeZQ@cs@VdbU{<NNCR3ncDE!q`uBTHzxBFn8GiGr<
zDg)c_n+wuK*CbTT_ge%T-!n7^<Sj4}UxAb8re?|>f3fAxRIRLw^Ja9ddUhEk(EHT`
zs~FC~#ojsp-!Amml9_@|7p2z3-a}7r(b_6S)fYwYtM{R1FVDK=`)){xMO>hauCn7s
zS-8#LNTa^qR#~mJ)9^GtQIKH^h$-(y58!W~pr6^hNl4x-57Z^|JlY+BD`sEKDF@c*
zZ$3#GHTZa-D1@&Wbi-=FqvXUEGxGsJg6q*m{zP@uQYd|Zer0zDn#pug`fxA7!^2un
zt95bbwj1ia{*fASIfr*N!P%hZy4}e58MR=J^Xc_-A}7r961OChgILiu()hrA2sCUc
z)8*U{Tc~i_vvFe{<`<ukB}v!M#bmO&jM#vk78#1nakj+3aN|+xhZ<;V7U(hEBvD}V
z=fg0V=WbO@MjN0KQFi(8lL~FSimHht6yOjDgbUW<ZIe*Ojhh-`*#mAy0uKmn6Ln%G
z2K_i*TylvNY@Ip2sznhVng}G%U8b<y2v>7P<<OOF8F-u)sEZl={9OGEJL(pV)iv2x
zN>sPds9;z2v9rXM?pnZA`EI77(u%?pXjA>bl;ocFN@WSN>#Cwh>*q$xrOyUd#lA>y
zC{lQ^xqtHOFhfJ>CKcK1R#|4|ll#SfAJoaJKlit_oKK%jc7;AUj$y)C-V|W=whXcJ
zKlgWr``{tQOU#CDeofz+BqDHF!6i7|SIuJ9uxc5f)2o?};I3iIZfFTin=0?Oq`%X>
zfMEm9s*D<+wOeB-7+SrCY#6UPO315{U4ov?w_?t89(Ja?yEfRUIBG>ytN?HHUE{!9
zt3KAV)aN~hsdtZUlyx+t94d$Tq^r)V?oDUGY6ZJ+jTAU$v5Y;}+LZ6c1=SlwBQ1M>
zygacbp0VpIecAJ-Zep8np*1=QOVJI#`&->kQvL-h6YdFu^64e&Z^p;|2(wytu(-I{
z%6VENjVN%1)xbzU2@iadyv7B@>U#$59w6MGHeRm|zm7n(7cP4St2WS@#y`^Nmg>Xs
z>Af5BiGE#~go@3BX56X@6uJx);R=QWEoaF1K`i2YFe@j33mB;PcPp23U!|r?reFM&
zv$MIEu`|{LP{cgl0ZR~UOX!5ddV5s?D`eR)PC7TCGjE}h9me^{Ye~U^Ue8nC#+vLK
zsea$qW9)-BaPd*%vw_bEzv3@65M$M$<B!7!6P||P^s+!O-sGqBzk<>gq6QnC`r3N-
z)$|sF>rd}RfF#(&hACkHaP@uGz-%Ed0^_9PnnKl#zoA6uwGqu1W?<bt|GuV@;^_!k
zrljZrD5LZ4svU8MqU=hhcY+zB)TSy<c|7BplX!*Sn^B}jcU)Gs39}b&0XPmhuAx9Z
zn^zulPvxp*v?@a_V^_JsXFxb&beT%>qab1&$gf7j)FSj33rT0Mv9gus6N9-LLtz$7
zNLjd|jZ@zh>ztu6VBS(C&pcd234*u%U_1O~=4OvtF+|~JY<5`^9&9>qf+a%MueCZZ
z<6qN$y6;k+aaXb)Ym$*;6o1L*>_?qJxs_w{^m;PLe}~Rrq7DO3(@$_Xpcq)-`EvR0
zw!Xse7?SpJ<%L&<hmspkYD%zD6KPZm<ww4&MGq)eoKN|5fr>{<eQ27&Z8oy;^dUCh
zUknwhN-X*GD|pTKU5ef6yeC0Y0lwMdj{%I60V!-wbAMBY2X}n14_*H+J}Z0=><l!k
zZ|Axa<les}qZ$O9K=kU#hJoW*I{dLw8JbDo*0Cxk@2k!{^w*i5s;AHJ`&f~7NpIhQ
zYj1URqq|{#a_n4br%kpzGXdzr0nZ8wL_gt=t800{=(qYXqd1U|e(a0!FAtjGFtN6o
z)+efN76`;JC0%Ip8I6<mjn=$v48F=YY*L;PtU-Cr|Hukmsl<@Bx@)#b-@Qw4H7s(Y
zsch=~a^uD<=dM(J$eizSf{loHb5_~)phd~qb@0KH6iaF*5y=37#^NVaX*4<WpJB3E
zR7WxUzr`$12~wR&HiuMJB-qD)uGC|8ZN0vxsxVb7B&@9-LR`-23Erxz$@mm77bBiD
z?zM-p=05rxxiv@ILhMVloRflz%wp^t3ODF>Gf1&wX!~|8PT%4g&e0HT(6MfYNnI@V
zxeDeiN}@iW`X{Zboyo7bqt}_>QF!1hdR}LI$s=6M_J1p<{}<HK|B|A8ew8<2*$jHM
z$d;O0QeQ|mg710|cB&Ful13_r5zxOd2>9!pT^c=fzYqZXE-1!j9PTBOKbK!q|J9SJ
zMa^<rV3T|jb+%e`jtF4HgUXrao%7?gc^drW^;MgOuL_;m`rCcx(s^AO_jN6T&MTss
zsGPbFtJ_oP+1lk#e@u}eDz5$gN@v1%xMI#C>&!R0gyqPcmutdqnTNU?U)dWH#J}UZ
z$T&AedAFP~zbEq{<(e@u$^^|1=~Ow$xPY9nV*3I421(A#jQU|iIN-eY0f+%YC9d&}
zX&J4J^cAPic?unCt$sY=l97lps*=H8%K$EKmYD+Q=7QdCol5+y)U?9FJ#WM&^nof7
zhf6?mXC890dwPUgUV4aXy690nh0JE5e6SRW!O+#Ge?ZZRH<l?^(CtIJ);+9AV^qe_
z2Z=0{-~iSO(U15&&wafGWotIMi=A9zK~}y!315MKYN0?zBi+}#JoFcv2YPc2oMQ}L
zzN(Opequ$LwkCV6v?A264DzeTq*(j`iT7;EUD_q0&mi%>w5z(}e#Zuv<;S%hL<q=!
zx*#C>7Ujy08u)s#yI$|(GtboctA;fuBqn%ZGrxyL<l6n3DxyUUW^x}ZfPQs69ff`5
zS=qJ(IaZ$A6;&<^<a8h!cDWC=ZfLBls?Km{2Fa1%Z}ejGV#Yn+H)uR=4RS4t^yu_R
zXwXiv!c}(jV3Wdo5uMo-d%uwIk+XNIc7&j}U8jOL4s)2yz2Z6x3#Lb(gdar(wK7Yx
zA~U*|0VTS$md7V72sep0^LoeCv(?F3Av0X%6hbjF_Y$>FWglksFp8+vUKP?#+RU~v
z%^+JZosmw*+iUOR*M~`Myty*gh@Vs=FKjx~d9wFNOPccWoH_+%H}B#T-0R%>0F{PU
z+O}?gMdxD&fnvCHv(vI6lTbLVBqPkEx;q@6y;sq3Jlx@36SqpNKdFmJU)PwnD}72X
zDcn_WMHz}J`M5AGy{3YY<T&2NeDfEYGg9zc9S$BK2<8_fFuRnU<otvw^}0`57oM~p
z@k4|)&>8#!-11MqIZW)cTH9?xguYdWymmP8>GY749Ou_qV-NQ_Wb`A^po3T^kHE0H
zk!Ca06a~boLiD%G=E&Dg5EsL<%PYg3WkDX>9SzfwXzA5S3z9X+Ir52R?botj$6g=s
zaTC;ljEpLF1WH!ykB5GA0`79jBDS?+w_i3pYZ=_Sz9KaMa=x=%3tlNLt3y1?OjG<j
z9Mu4?2~fNu#pE(4Iv6!h2=aA1C8MtZwll4b2^eYy4U_9M7M$|6%irsGoxbL$EsxI6
zF+e%CkKKvUUV6$R3BYV5HZ@2ifMHGUKL#OHSHa)cu!0l&KOCS>o2iNGYnm1aSvMN(
z&mxnv0Dr?Ba!|VhNiO~EG5l@(m+5R#0T}~2Ll_`40SGP&oS=HJ&ycW{`H*6&cB%&E
ztq!HsD!oRO)|kxG_hjc}tCTK{cU7aoqjnBz$B99ipY}UFE|WEdG<xia76<8wm`_vX
z$f)n!JCy6siks0M{<oRo4|qwm+&3~<J!&_YSE1aic#+OJa(<q$v<KzdFx<8~Bc&#G
z{w5^Hn3m;3pG}JRhK8?3f>(#z#rz;Z`yRR-5%0QBw<|@upWe))v^SZ-;jikfga__x
z%0QAnw~5ESfB@*}`&sxf&$Zg$rlm=GMx{xoQXnSRSNS-j!(VW^$!4X#iSI$Z9ZN`8
zhp~ZC&X_@OjDp)e-YSl=I{F-!4<u5B5d3p^IGj$B5v?E42_biDrfP2ipR{DzSio{#
z|5%iN8>1-2e9H8tDiTC=7pJMwp2>QIV28LSYn6S``mDp<<1%jV##!#kWU7no^mFDc
zo~m-(X51*vAE3*UjDK5h(EUiS<EV8_Ol`|^gR&^JiUlT-B+%b@>4w?on`63FP2E%6
zmL=$gQ|8=DN8NOr3z822`u30Er2rLLXt5Ks^{WU;9+>`7momJg<$tjER$*~{Yr1a{
zl8``vV8N*bcLKq!APE+Ny95Xl9D+NA1PBDzpoO~zcXxM(;8M6l6_q{z-F?pKwR-Qh
z&gpe7`+^G|sCwocGRGX_d*9znb}|~qql3los5P^KxHfjPyDyZ8?6t+;FjmT68tP6)
zlc2)5&qTfQd~-u{+Jj30l!ZF9)^YvGV(*;dv%WU!T?zDs_aD98a9~O46Ytl3AZzj+
zV-Mp$`Vl-|qklf+t#-Rs=E-|AxCZsn0E5|39IoLzy$fGLJSFUGMY<F+28{d<RkX1o
zgLuUr=+tqqDg!st_eA-SIyX`4u=yB3rQEF_1V{+Jz}88tl1B+dzxi1!4@%X2Z(gfh
zB7YX)+w{!0zvJj7`cdnDwAk746Hl2FmtYhakScel&iZo)xT!0xGfv9IqY>t^O$1XE
zvXno1Y9mfnSBiCIFfB?BUm>1y8V!WtUq*ayuwJSlMlH1PCGg@i!<G-D`L};~+pCK?
zgq9KABGywix?71LzY_%$!aPmZ!<3Iz%bV(>H4tLdmjtQ^!FNvenoZK#T=~rJm{Wcm
z_;?q2ik<5H03Pja*C=5xYDCwI8YV)&S*cp$gqY$9T8q!$xq^C5dbbhjY18wI+M3Hc
z680}SgO&6xOG#axtpynh&9;Nds*Z_}PwqpII_n&muJA6wz;f%VqGXRl$y55e%5!!$
zL$kvb{`GlMbs7wYm|;iQize%hR#H#h8*_w!t4bH2H&N{=P84r_sYMN)Wco}b``quE
zxan_lv>`5a<UT$84_{*}>i>IxsY3sK>}YhVU!!>LQ(MhegZ_Z98BPPsHaH$375$Y1
z`7h_Y507B^=HtbS8}$pN;~yv$vrHexk3OhRB-j9V>n|*>uXYT-S;xs(vwdV%(?B?h
z^%!guF<Pm9R;(xCSc_k88ZVZEQd2_=iD3Yy^G7%pH9=P*r^u-EXOLgz&?6>uee?h8
zIyU&aSMhGfAttR0Mr(XOJSE)L>qNou2A)z_zJ)wpi-%4!LhFUV7Mf?zThUWe+O!`5
z;HnEWslQ*gB|u95<&mZ&M)>zDK+%-qBk+HWB*?$7NQIY#|NXC<Zb!;beVOpYEwBKz
z)o|)FyUCkei6a1x=eF}h^tG!_X9An0xiJq035wyzue4LXvOPtBZ8jU=sl;E|{EN(k
z7aF{E&|CFx^0Mst$w%19&pGf@3*Hv{yt~FQgl9_ShgIss<wi4#G(m)_=<CMnlQ^Ff
z=WsrNNTF}nckXQx2XS7kIb4#$9#z>BqnbZuSfkb8%KIVAf%09)!cD{aev)$nneM;e
z`rLzSYvo_E#s)><%VDl6M?>g0e(ppdVi<5l6E{8ZK9zMA&GWQ^_O5H+?fjHWgLS?s
zGZ10%A3F$4ExYlX;H;q$w)cTFQ*VWVoSe?DJL!AAccPN2z0mcAJ-MyS4lt0H+-L{S
z`5shf{sHk9%R1=bDL%T`Q^5>?j97eL@B#n7NFze~C;x--XYwX!G~p)M1<}TLo;5tW
zDq-6RzQbWAi+@62pJ?DK+qVP4lv`AkcDIU~enI`|JLr{g%$ULEcEcf=ko60|65I~>
zZ!wt`;N<R?q%?qKq1j?4H8Yj%*)<NnO5_vrh?Z4_GVSuoy|r2_J}W3WLCo=<9y<qk
z_~@O{Y^OoVv4TS;OmW6`O(;8rR@m<rlE*X5R&rmJW)+>ibDw|-VP}R^FA-x|oLOCX
zK4%)5{Fsv}qqggge$nkF&nrS3%)x^-i6yaF-?y{HrntM{oJx9Lx~2L>ptBVBEZ5ux
zi*96s#NZTA*XdBbiYE4d7|4%eeT{O|NlzKp39}#(3+xY^-hgWz=IhJPVUuwbJX6@y
z<q4^v?Ps690HNLE!aqHH-B~N@_#<tvcV8xZFPrx$?6PW#K|nBJ07K&0Bh&pCCB_*o
z3nM$f(xBSCtpUG-hN{xsNbZnrQ0Ae@cgYbKiLsB5U$!%x^xd0XX-vh@hkZY0*WY?0
zFzPj3W}Z1W;t5ae8lE+$Aw{yJO*szc15E86@(hXxUX>wz{s{HCin$3$VNCA^9FW>^
ztEN^_s}Tt4+#XuB2YxhmRLlboAecv0nk6B|$y*}tLU+!Kr4Vcr0rpD0ikp`gxo!(`
zjaGw=IO8$>cS%INOmdWNY3nNWo0tkFN^d3H`oo<^4M4?scKIKDOQdT<U0im~cwlw~
zD_yVIk?YU~ch&s3k;carBAcPsM|mb9fQ_LfQ;J*hTYyrtOYZ7y(!k`!EeFGSsfoG~
zk~S1&Jo|n^HV=G>0iV6(-eUi5!8e_%+$p4!a;v`k7&n@06*#CGmhpU(%lGqCfwgtT
zD;t$qtktC8+-cPD8}~{Q^1+JiGJCkjRSY86x~7#cnq&WpM-D0x39D@C(+MkXgtGgU
zbKk#Mx%-kPz|{*|c}+CAERm~MDuzB;?NCc*uIgqK*+X1@j4YBa?do52D5>^fV+%A<
zVf>B53xH#IyfjxT+}N)<cVBS&>wU6yVwO4Y8Q$~nzvdUl-C3NnV$a;|9IV5uK;8M?
zW8(x<jqN6uuAH=U1q(4Msa@u8Fk%co`>|L6`A#HeLDtIlXbN3K(>GcaP=482lD^>{
zd@1rF0xti0R<U8%so_&i370>`*4w*^J^86wWzOv{?`kucA^D}I(o>nf?`=6^mv4KZ
zWQ&bSZQ50(OKFL8!MW>4LYb+h)z*f*x{HAf1?0Y{>hXn@B@446Q^K!#%CZ<%9uF|i
z%S0=ui#Jk=ezn%{gVR_HceEzwy!V&UXi5)2-hPEjXT+T2%N;*igonDEUjkLS@ENt7
zZ+afmg~d_@kSWY<??vGunm`pAsu0+{`-B{>egpc*gLwr3qjRHOW-ClN%4ffp&nl#z
zUjyfiG@7$~NtyoS!xToPL}HK)ZQd2K=vN6}2Lz+DXO>H0)?@+CzGq)xrNGj+b3QO8
zklMHv^1$V`pYj<M&_qn~OwL<Ize5!GhT<Nl?=0=`EH=me%H&$CxPE%CUBqn8RUf|2
zB}9qDokTJTMtNb=kh2XXRu_R;95eYa5QUIDq5y}YPDU0>+;|bq!xBnuN?rkp=FG%5
zJ%npgd!L+xa(A7bJ(fvLdWS{|6@I^wvCoi6QxTX+6mC1*ia3gfXv^`UW>!8f51`Di
z>6;0F$l>M9MP1gMh$m8j_54A-wTo1srJZB`i_as3ehOol^D-i=Z)0>QzeJTS)+^as
zvet>{Z0V0Q#!Yds&w@>*AM?LFx@T#xD!Tox689CukRKH{wRjVC*!G4~?eH83vh>e9
zve@q}m}&_PgdY;y8~djip`Voq9G9?d%(HG79Kue@1nW-YD;-zlLIo6bp(?7KdMl7b
z=fTFYQfZ_de&%5jI}!1FM~xN6@)+K$F}LPm0qXj?W2gM(mLAL^aAOLZM#<qPR~L1?
z)~{b7n1M$U{Vy`6Ty|*xfPyBf{6gN#wB!uxz$pyxjn6$|Qd<M`EPo!MbUdm9aLHAz
zkpji4_%hE|fH!+rbY!<Ic3g2+;^sq_{vKx9kdKpcymw-r1wR-NZKya_cgl9K&_n%o
z!zI*%N|@qAG1STOmARln4WSz8+LV(n0e=WDf8R^op>wr?_LzMo$>Q?v*R<{wGs9ui
zL$7b`x@ix?)A8=oSYE73v`l<YW5Pc$jazWI-5|<g_-;$vC2Q8F5&D2xKhi!|sbT!m
z5)R`z?7->%sg_+iRpMrbQd*XW#%U5SEPM_KHi4`#^B1#8bqO|c;n`Y^zdj%z+BwPK
zy&z`!BxjfZ6O79duYdu>OB(7gWJi-u7>T-d8lVD`iAICVGTDR~iJCQHZdAgfT+@Xo
zp7)ZV*WY30@4ip8z}l+ydFNnNni@h`3_<g;Xw;q?W`787M!|U>+!<4BHAkRlkoG;N
z>(H){u3+`Q>0eVoh_>nvP7NEqtb+}B)EyFDE+pCx&4kF2^4R&c>9nTVhz|7%u&?!B
z!(kJZBU!A`RlFXwo*S;};Gdh`)r<528M2Jg>smIe_gU@8NBVN~<GO6AjgLgyf2$&F
zsc$)^);~{PHu{lWYHeIB6+S_BYmu4k39)fsMgTk8+0QQ7`ir={D_bPEYn~L|V(L;?
z%gZrV4Z*bN1@F#K)xy_vt)_FE+Y?7@IjdYxQ&J8nA6ZMdSiEF$usO9x(eB+E=EQW>
z%o0<X-Op3{3PEXfl=fd-!@tjnLYp{|_4nowuFPUPITv%5=e5eO4g>({f$F&Cz60fq
zHLd@Y4^RbiJU6eIr06T;T;{)*x1c;W?QVukW&tIF!4TcS4DHxVFZIdI6yxwE7^<4f
zvO6KTr=z(dWQLf-VYq9sSGT7Pl}O}Hii7}<rVpRLE{idMfAVLth3HUFP8aRl<5o%n
zP@Xo(z3urCH-Y$6$vVEo>!`k-$AVr$8kVBJezlF8Up<pTU~+~po$FS)B%F-s9nt%k
zW?=Amo^dID`bZkKl{e`0g%<e)^|pXF!w~kW{892RKRM^xq#?=WNc$nqUhv2-N9)Iy
zi60N7A8vlGc>kp~N^f9P(gDvrA%Wm2H$p(Q79spsx`~dNrv&H^NVbx(s25`!65!5o
z^-Wv%?FvC%c(xkvDdi%J{bAzi-sGu3&SBY@jmRk1)FD#BgYU>{lu}gJSE2^C{_Q(!
z<ZG37;SzVnsV12wZeAb{mf9XFJVor@8eB3vR2TV3BzQfh`0iyW0sj+6>@VAILn?6H
z$bEHcQ1}ygvio<{O`$2VQXQsa8%d4yjc(43U(V((_S6!@>Zd5=?7l^m4fZ1o&Reoa
zSffdhd}hLp>cO{dbH!aK{*v#n!atI%<4NMOZh-sLJ>$o9B#G(Sn$OS}_C5yb)hTT$
zfYbaVVmFAed6k`|v>voQdA#-988ZcCe2HX^TNv<3b~A}YJOhr@{cNx*TtBy6dqc%P
z)HZxGNcA^6&<%-0+ZWu?ZVabE69Xzug6hr*MJ1tupPdidF67$0>xjY%E%;Odr42Rb
zE(N&nnP=uR0NZ4(+YcA@$2E#$Blf#a32B0L^(@am+bs>K&e&e{B-keZsQux#PqV^#
zar?bQn!D)9`fyzEL)=z=%yg8h|GSFBu7=XAXF-VXOWypX1v}Dl=%Z!FR!-z&GfD$*
zkUD{)jUPhqxkNKdM7o<Z3kTmEUF+iZT5<x;W;rL~nmecO5Tp2|e2V9b5gTci!DMpF
zm*aJD-?D1jBQdHiNpl5M#-^5?pj2HAp$yZ$z0(~LGi7tG2IV;D(#s03dN;FYR#J`Q
z`$Q+uBET*$->BWbO4<aoFB^qHz73$E?`buRW|HM5sL;;cCqHElpxRfpyD`kP{7K=J
z#?;|{HM%#EgHSxzUREpV^(yhRgZn4>tH@A?%Gn4nH-8KPpA7mzwTVI;Y||z3h$Fd1
zNbaHcYOZ^;pzYVifVH^4xQM(c*vGa!JE$JB^FkS8PepG9jp|Wx<VL;>ZvnCsJQG-!
z)060|Rjo<GVinc1k^{hQ2KwFXu0k#BZnIO4)Q8O$WHMzCgZ;)DB8l(N4zB~f>%bqT
z@yyQBUzjl%x*xjsZfg)(usLEVah1epWM&e@69MlzHjo5`iD-#2I_s;1_2uO9C5%n}
zd!}nam4W)Rb%kr=X9{DcNxeZ*adhSkVKY3JA9065<k|N5`yF}Lt0%<1Bq(zsXktds
zh$N5LXqiH0%(aqB>FA?YI$qWAlfcA7Mw9MnA4(X!gSsUnnT_y2i5r|OhmO!T)|-Nt
zMF2*S(w@6q;jQlzO3>w<#*>6=7XBeum0f601A<b0#P}=)<KXKYvS3)6K;fO>9en5P
zkec?+HwAim{|CfjAxk;v`xAq5E@JD`w~D<I@XIcdzCR!|%>-iS*Vr`^ZpA`quq^<o
z^@?X{wql0E5n)H_s|0N(o9PnVBzQ?oaQnI06%ywLcTG^P>G$I#Ir^}3yPZ3Ee8fTb
zW_bX{X9&uem{jU64a(D5F(3D@bQ-92-i6@EDYZ<bH$K*pRU_SbX%Mj`ldEs8M5M+3
z9Ki_qtKh3j6?LJ#7Nx&&0-Pg;W{4}f-L2esu2PG&UK$$^-{(CHVTDv@N3z=d+9?$%
z4fG=0zB>`_!xz4|L|Wzru8>PN)ft7e;%G_n$Y;tb<yS_g9cX=KKkTSK2KLXxdbP5R
zQ>)fCZbu5XorFolE1`S8wyn>gzd+RWMbH-thJnk(!`~fgjW<>wB>6`-5T=ILSIGw6
z<~0OJqwteQ&x$EEG_3K4n{X*A@lu$LY%^%VeNgr{LHY1==|-d2MDl1*o4#$?**!}f
zZM2L4eY5Thz13C~o8IIfJ&Vh}hC04>G;&{aQb%N-*#mGRb6B0oyjMB-<$6YD^JE|W
z*@kei7}an8J9OmkndbeBvWN@X9R*on2q?J^R%PYY)|YQq&~%IF>zzvp0R@I6|L-j8
z=}*iGTEBX5AvXE;x}_`Lg>9V(J$`6<HVWSK0ErcHHs2`S#_Te>u=)C=JEG@&=+oW$
zBu!cAgMq{%T>ZaY>^`qD<Kkiu4a6zK=s?~-{sF+Is85ve|CGNlg;w_0o?9;}9ok2a
zdqa%+W;qO>;Ksdu*bd+Vfv~|akk!8;sQ(u}i`I?&Kc^^^iTy+JjTqJ5KRHVHXGaZa
zAGz;Bues6Cr=K>cT^HXrC_d&HeV25m9}GErqTr_9Y_Z-Hu`Y%5BS1Ca0tf$+YLxPm
zhcg5VIKP<CMVqDI8u{rsdF>6E7D*I13db2#szuAj;(oZZWgD8Jf;X1AHzOV*Y9<Jr
zvfNvkN#nxAt=?C)m}`$|a(njGpA@DvN$pSb_xKKr%sytyaPElx0qt+0w^n)pZ#L(1
zI<D7JEMf8jReKmp)WrJjkrWYaiWpH0?YI>1lm0wU<x@bHLAPL)Y-f8PhaLFZ#S7tv
z?)5vU>|`T@M`|r0T=>%(m{`Y?@+OsG;gY-=z^EsMQ%4-4bQPTJ5I>wug8J3p-!9oA
z21g`3YLN_jcz;0Y(SJaz1+6y#tVQr7;{IU*>R#?I+>H>WiRZ?t{u)NGr^{&(u>0!r
zqTZgM<XgKRDd9mnH2n}Rf?7rPyi^N|`))#4`^&(wf4%t!ilFQXFuG)*$5X3+F>z8|
zrBHqVugp95-;gy_BI~Q)sOV-}&7o*Wlgj!kIpU5x^&BIIXAv(O+-x7yaOQ_*C?O?M
zr4O*b3c}itLt)QE*<7>Mp>3p9)(Rg_7vG6iX29)7tqQy_V-adOT~FDc`NU8Q{!WQh
z7$61;k2ms7G=D(ibbmmtD*wjRa9RW3J>|H+0}j)_r?a{SMR=2V%H6CYL|x0)^15!T
z!oXdkufn1qPiU`u@ISPrs9BdvRhAMp^gby>^FQ+sx6ixze5$h^aj>zj{|!uPU8TeJ
z1tBNslyYa%b-pMZ+0`O3l&Pr{Lr_?+hV3KbT9)y*4XFgEOlH49cWGO%_ia(sJ{70o
z$p|{vK2*Q^aR;`Cc4fm&P}$00$!HO4bh7QCQ@u>d7Cy<h40V3Pu<sEs(F1xOxkvZ`
z#epIr+xb9SA3fnloxx@2i32$COjm7U{_2NW{3XeeLLK8F%oj?LMRAlYtI)sc%Kv%=
zKvlB?x^UeE22xqp(k{IeI%ZJd_<lzZ7=FjKZN6Mi0N!hz7on2uwBM}lzswIlckmP8
z0911adtU3dL0~K((m)_>W}tU%=Q}qGfDqcFRlXv7D{NIb-h;?B5GVI55TFb20tVNA
zzVnE`>zYRqtoQjSBG;e|+cqd6lH(+&yCk=$l&-Lo4c_FuZ_p6vyfU60&Q%flIw-}F
zVm1|^uzQ?F1fpooTFFEo>dl#p(nj;MHp%7b^|K0osWm6_ZC)VBF|LmQHzo`UpxF5^
z?)3l3c%;-mTHt#|^_wDewr`b8m<=I&b2QqmkLwu5(w>y?%~JwvVPR=sd4+8{Te*iQ
z&C>2!)F3q{8=j=z+nq=`FUo&*hw-8>QG+cnr-1H*J@%wJ`O=7W6SRiBQ@cua%V#O6
z?p{euVa?!ckX-!9NFEZFmGY$ssd1xldcAG~JDFXlezyh(Q+YzBO<M&&))Eu!UMme{
zaw3iyr7NlPjYai{ey-K^-?jden*`IlYOE0-;u;~O_gcZi8jv6k$&!o~-y+TV<|(Ya
zg_4e?u9;D4frc3S)b6f#(I61IUe*aZF!Q~MEWw0MxX+gsbfq?IU+BYU-cD~ihtI%m
zx{^K3UWiBhWHPxh(gO;3|G1-*oxtB#iIFsj5Bq;Wq~2tyV3l!UOVhl0OWuaq^F>|l
zWc=rHHscc1{fJ^@NiAEiyd``euvY)$VSL+(fb^f9_4b0P%20UX=@v6wo?<hGX@gqP
z>l4yD&vHydT=5n6#nCp5F}5D*N3-nOqN4^Xq)r@qS03GD6!aF}{8-PK-p(r1*UFGK
zYHVl^)h;^UT73S@qnCl!2WR{!4cu^}v?fz68-Yz%n#f-3LU(_zvnWGa-<WVb%!G#=
zncIq>Z&3Iz1N#RDiU2j+^72LlhzPna+V_4@dxETy&04yNCvNn5Yt70S>^E0s$Z1DQ
zV;RFcqUoQ4cVSb#1`P(|ih^%+Iv|zzHDPwdL9hI}53A>GsI{z0*3PD+cp3z>eih1c
z5eaV^Z#R?wvu+pid~`#%VfzFrce>LP@!d#fk_Se?mM!&Rtf{BcmyIxjSIb0tsIpI9
zs|JMQCRDd3OoO1m$(+67nudOfAhf7af(!aI8#h*&f2o$CYvTKA+)p7d`8Md5e}{Af
zVhHW{&yUuuzr7kXqb*!YPud&AssEMwDRFxld0tReE77O!&*r9f<}MC&u@&>fwk)!o
zmQXHUC{uZ1#3HR}c+vW3+ba2f8uJN54=$k6d(k3z!c!H`_Bdx7$g12|=fgXUf2v2v
zC8@fV^)>GyvNKmS0Psh^J0KVM`iM(D039dwcdOci-eEnG8_20?uRfV0ZWxS;c7hvN
zCEk|Uq>njTlWCP2g?ntB9kJWkFod&>C|awkwsoZV<++&t<^UF|liEYlQ`z;a3<q=i
zhz$?x7vzkYZrDTCc{;aTiE&w~iaN0ihf%YXEOV{@WUNLZG(2CPa&(UR0EPI~FrK1h
znS&;`!d>DSCYv+vif-)7Vk-t*GUf^fpW+Ql_+@yL$2wbC2ks9loGD?njjK-@;?tgG
zRg2J^_H8%(>{HYkDEgUn$STXT4UCsjfO_q37xM?bS`zlqzgvF)uBpT{;f$pUf7@^W
zWyPj6A?gQKi+|YF#hLYxzncSpJ2=u=onkc@{>f7!{8z|7o$@p4^7YxBrF#y08W>g%
zhy9!PGuU$x3fjOW{*zJA=gm9`*j65yMZ0QaaZn4`?F?_zxHWz<R)~yesjA@@z7&lG
zChPo7M6b56H(5g!;;j^n-j<8|?5s!X7VXnw%|=YGl0HCW{F}DO&pzD=1iDl*O|}Mg
zpd<>&HM|~yOCD6@<ju|B=!@$>Ub8i4_H~blVQSV3M|<4OChT?}B^_%-IVa!B<{xi`
z696FfX^v`rLjI65Ncmof_?bf@9SvgBk@Nt7syL}By=CmkZ$nRi;Paxz@x}_eu82xA
zN5x%y^4vLDOnn9HuCkyXK$nXSZKD?RK`Ry3MPI05(XuGznVXypoVh`FKvEm#zxV_B
zGj$WPvY=BSoG&TQrC@;JpmS9-v)iJ%@(ZVwUjQlOp;iPvxQRI^Jfsr6lA^s!8uRNJ
zhq-@*kezV49zmU~JY03D!^`Z`8(KnrDURA4mEXV$N-WK*1tN}1)YT|&M{iVNpY6`O
zxqL+2FmBbb`fY_<*@gNtM3<qdZq4#=a$><im|1e3FM4=U3d*lOd6Y=O-ZP)=A)X_4
zZN!ci=O^8FyzF@FgpQwQk(L?NvxhGuti}$N?x#qRqda-kZ#m4JYhv2I#2=S^s(Xk~
z>!}$RlmSY+E{2^KrS>{ySj(bYrU4Pk1i*o?;j6WP(AZT`FL5OlPwLO*w9r+%%wnM#
zASAeyA64ydS73(DLOEV*E023#yjYRB<h?z!#CRmRh58abDm4~|>>VoE?WKW)o99f&
z3<T8_t1wx=(Pg?I(xO}0bi;7)hU8l2niaD}_EV4=@?QWwsKMdJGj*iQc$MdnS`YjV
zh2`Wq@CK8zt!?FDdicp8LEy3*r-@LWF0Jwk%LIzYXIB~bZpE7EEx*HpciofrKTkR3
zXQ&!{d4H5D!6f>fQ0uK1ZdXEidV`(q^W9({G334(w~)}2a|bJ9^p-IwzAAwZ9-KFu
zS?`#1pL6s^y*meqSGp+c)dy|vFK~#mz^WLMzzr(p?foXcca9D~9@SGCoa5s+7Y?u&
z<Cbr50P?OAC9}>HJGH7h>ZAvvy;e=hrSn#}sBc<IF*}-xN!RAdZ0#5;y~@kjtV;p(
z+wH>TJp!Bi?%P{;M#zRt&fLCAjrBI5rhN_39&eapXVuk_BRdjl>wz-odBhsGn>zvA
zaRvOLw0x<Hl22*i`Ct4)TpL+T80S1CkK!(u-YP`XiHz!Z(icNb+QDr3GL0fcVx&kQ
z`F5!kgTKLcfy65|S^*SpsU{3|c!i-{uljBrQqX%=cs;AZo1T+8_z~5{i?O9@eMFy(
zu9O&gmy!XAXOYgcCdFqTegVsDjZZf2-@oa<my>k7XHk^fa*jX3VJ1DO3bN%iqK#O`
z_eZuD(q=xBdJ}rF#D%fXY`v`<5jARY=g7<VfW`2zaS0&*>%TimA<pw!`)OLR-2JI)
zq7*B+=B)I=dARt!gkD0|51YVggEO5Bke|X<jJCkQOfWO2WXFwcM+GA`mbAuA@Z&<=
zT`Cgh_r-mJ$Qwn`pT)e*TEvdU19>gd_pSxeJMTVX#YufR8X2+x^Qq&?{m7CyA!IB`
za6a~rx|@KS-iZ0t9Jd_|JiTZ7WsyedYe&I6A_a1~w|u<*78h1&LG_bJu(pUva~G^8
z$Hu$&b{^OMRX-%Luwp-rcABK0)sKgAf^KIo(ju%hC-3dMPi098An*xKrCZV7_VaO$
zmtRv(Z=tXq)i3L1cJZU2NNnY`L4uwGhdVT#GAD-z=w_Y3W7#;=JFscNT3t5Lj@oY3
zk4189p?~rr?(qY&uQ=8&Li975`LaR1b-<pj)RG=?pg?uAh1FQP^DrqZ8RwVq2k&%s
zy;8@mAWvl`yLpYf$xtW8QG`+T?0nTV?M@0F60U;)cM(Ta`KVqmDeP!ASQo@A@C{%>
z{))@k74!;gnXFG?+J9CDj#JHz!o*IQudbVz?bC_ciR$PkVK^N&mCJx9m~ZPXadj;r
z=fLSitNl)F1vGNf5y(dX(C?jQZ9{8tDhapJ2N6mcloPWun8V?FQ^=^)H&$ce-i$?n
z(`5cySGP6Uen|Y_>i|Ts>e>Z=uvO9bt$&}=<ax<lwH)=s;f6PL2U4UZ0!ixP#=}3n
zD5E5%dnUmrJ5QjmLK6FpY4gK~>%KbNIA~SuN9lrj*NGU?X;D7LYK?P;9IrIKQA-Ox
zdWpNErFBVWnepMX3!|u{k;G0V!7-9YeO1xWxu46}F7P3E63E*X$ca#>0-L2YQstMl
z5%u@7!|Xiz7Sl4^kZ|dqySdm^huRPWcq1NHgk*bhe`y!sEy_E#X>Yw(y-lBZXhCf%
z0KX0fWM^BYvF}9Tib{<(>$!LzYw4{AbL6}m$rflC=1y<c3xR%J*2ZCf!PWfZ8F(aq
zVMouCXK~;&rDx?VJZZwRglir&Uw$cS_#0)E)Ld0ByiJjmTVVxtv3I@$k*GJ9{Dtrh
zg{1Hzdic~muV-TTXc@uF40qc}cezP70aTwl5$WKQ0?TrNBC<)DV%d}-G!YjAXn=9^
z+T`MP6e(h@Qc<LeSo3Tn7N)Ur`z6B`M{j7(Z*}vi>k#Cga(=5O`Ph3rl^0eZ0%s?u
zz1RVdR%<s+9+h^|8kc_#+qah%5kpT$a(M?44bg`|ZK(!%FokxuO?$7u)8e?bU5$Lj
z)(y9ooMmyauBF&~{zx{gh2YaQHL6SVXYfk~@XD|(g}Wz%RU^UeG?NpXw)y+#53n3D
z1t4$j)WMyC-@16NXhvP^Vs2HGS`N}Itz_s>30CjsSA|;TehOK7cbwh*X09ID9Tj`b
z;@2=<#y!jTVxLZJZ|_d6gs+RtpI^e*ALC(Me;&Vih9b;izL+~c{tb-~mlF+zx_q^*
zsbRnnUW*iYKaXCgV%!Fn1C&8D2<uLLu-(Wx<JYg(mm|<Ox&>t1$Mqe13-9)oNr|Xy
zzo(@_?=B~0GUwUq{fGvAugmR{k~WlT%R>t=?Z%i!FG}^Uff_?LU8o`J309Qau}Dy+
zc34eqc+a^_@rND->@f|+yP5=J$XHGEia&kR_B#1usjcxQtV}<HyQZSw7*TAaS_g03
z1_#}s^bjB7lM~M^T%s*z6U^FQ{dQs%LqF-&-Z2U6&ON7Z9!izQI@{T|XiBQ?^hr?6
z4iO6M-DEn|-JA3b!|Gmq<%-<LFTY^rEnwyU_Ap9_h?dMqUzTAYRFy-iE@=$G9*2LM
zGr%sm0UMeTS*gv)yQ7Qbg49!*tr~OpE(jCHSj9>r&+EkjzGGmS?W62h2R`3@$De|8
zEpiicKk@V7G54m~%dD3T=aN^{tluZkOYIE{6-CjG$j@w_In$j<71be6Ll%SCQ75kF
zi!SIF0!4Y^6}4gyCm0Y?;E9ar{!H-hIc=-@;=5=MY(DFdYmK|yRI01!7o%dW_wkTa
zQ|*;~vf@S?2ZmpfVnCp<$okt{mcAHx%8aV5jlQS-a}Ogw<|(zBR|AVLY$cYz1#MY3
zSAMKMeRLu4rjiljB+U<yK0efZnVS1NR}Mb#f&P}d#XZwu(R!O^d~WLvk9B4^eK<`=
zZl%BtQ^u;Pp8~~xq-FRO4h!HV(Vp_WW+Lg4UyGP19Nf{(OciYFh25HMhN3XV?wO}c
zeF=lS4!ZT{HoZY1Y*cGSySjo=Ai660&AWh?D#o+6Y(0Ah(!qNvF}FY{57XH<#ZQ79
z;~KYyiI70Hbe~b$KwTHQ5R`%HC!&HuDeRdNd((KXd=DQGvM9SIZKgAjzjy7PSxAmX
zHRAdz=C}J}3U4CHJ4=J3=!Z^v*`WmQtGUAiH*S*JdbfJo+_&lrO{$Vnl;H{meZ@~`
zbZX|mmM_LEh0ZM8SWFweSzLOGTLZdhrp#0^5gNtOEI(&!Q5IOQBtXb2JiC%t(<m5K
z*wT4CvktkmPH`@nl$<H+>03M75Yef>gNA8G@0;?>ZEZ{&*Tr~s?Y#UQ?SZg=gL2R*
zw{Q>>58-4N1g+j14QqdT+|%E>{y8Yp4ybvnxZ0Dpx|#5f%C}Ag%hNLU*<N)8bHWh3
zGA4)qks@~*JcV$wA0PBQoIhUl|Mn(?U$jnw2ckE5-R+?zT9Z{JMq0OI+pqH~bT>{*
zXb7txdFR{{sMTwpl;XH=VvaSwk+nK&n#Y=BR6-VNq9_kK`wOh>rZ`A};*}_NeHw($
zHr99Saer^~JG<tAO8&YRBW`xCbr>yTJYzo=MFi}OoL+7OwAnz(;vs=iUGFC>IJ5Y4
zQ^0VQTHh>*-i5Ao7Y$0r*o`IK(Ct#5<eJ;uHjKuv7UW(E>QVmYQKIML(_bNia244T
zROtIkO<5;~qP}$8bRvOMLXC)8g-Oq9z1PNVU>|LubdKvms@~bf70GTK)qfz(a!V01
z<1gzGTGHih26#GhA%yKbHY2jh6KV^LV#2;Lcjd!o!tpb8;nKpxc>-1`uw1cxCoS&*
zdLuJ3VNLeJfJWPPi0;wG+4bQ!D)I^TpSQ|S7IU8mLJ;f_=0${8Rn)g|?$8ZNNE=kU
zqsdQoumkbKMNyJbCB{90u*BHdB8mIO&wx@N%E$NJt*@eV8aVt}b7~M0-9rv9z)r?<
z7_&lhc9ko)8qBm<!u9(yeaJ_;)|Q&k3lB%fQ4?L<nX0MbTS}3uD59n>uT1NoBF4AE
zAuBsTl8qqk*Stk*a;zzT9qHOgh6P*eLH@n%{)j%q0^R);+9}^a+Ah=OMCl8G-w`Fs
z-o{~Lmn0=^FJE4RzBD#M2soBq6fyF*oA$C2WNW#Wzo{Q(^3RGcu|sK+0(-XQWUhpn
zqplW?!fvBGFSwgi^l}6Sja{x$e3MzC${l)d?V@`3G#xAwk`kBj--iNc10ZAsk4St3
z$g6|iSEDFJ7B&tQp826O2l~j0Ca>A>E24}%XqLa=+TF&SRJLGrQImyN?-?h=wFR1^
zG{r#^wtyvx8;<4cdqV|iNe5?&_ldz4RC2N7zo2-_<uJstEm)zKDB=pM6IDvXcp0$+
z{#YvMRkYCld*Qm!cJ9nhGy8sya5t}?B1#}!jj=PI2IGu-;9^vmF*5}8|NP{xb2Ont
zGIk+AT<^{<$cGs;!lfW_b;*AZ88Q08>cXe}lr~ykCi~wq2%f$$SGCqKz%Y;#8jWe0
zJW`WEsbK?2zZ@s|J0DXvz%F@+QN89h{agGhD8dzB?w9C^pX8y$0g-VV^n#&G|D+5V
ztPQzug6__wW4r&gnf*^lD?Qu)ROK>5H~jC19{ekT3F$Z->!!$<RKN$(df~1CyD>t2
z;0pxemCpfQ6OTJa*XS*S;Ld#`boZhRa?*>8wZ#T}O*^RX7NG0D!qoqzE&AtUh5S)>
zkS|=+CN7IXdo(!*WVn>Z(uV?cSbcO5IH26sz8p*o1S(q!NI#YTsB9_exm~S>w_bdN
zoK>5m2)$}I%I*npktJFHRSM)zNwfpAzJUW*-}wi`q7Ge?TJ#nK`sVc?(7-h8MiC=p
z{C__GKkfHF<LAFUe`ZIZ*sYrc4EK(ZiDrhwR!ZpZPw1A#D3WE^n;hB)lrZ51s8}?3
z%`%GxS$EBz&g+YG>?iwe`2=M*QybMF(f=Qwbhv+}ZxuAcG8e9b1{QmkextN_=z^|_
z`?pywe!DQYmP*(q#f_9k$JdFyS;Cht4U(Rwdw!tRcb5X2X;Erll=LEFvrzuT6->2E
zi2GIy$=R(@IpwG+$*vTypeW98{vdDa)1$Ja^GZJJ;fRU)MV3^7twl$C1p|BN$H|b1
zA&T%dN)96LUej;z770{{Mc8t5-B1bD+PviI)QsvvTwEQK(RM~JiC59hjBrEFWF%Ig
zsQ)%3M}Z^K;f?*E!UM_3BH8e^P4B?cVb<@WvK)xrNS4$PTs%Fafv~lA$dAsa7sFPI
zX4m_6+$q<hp9zyR8VOU<y0L!1mjl!n7=ucmGMpEiv6sCt+<BH&Du`RkGWK~q{UvD}
z=C!F6tPQrMK`uM-nORBIE)C59!iwoV!AL`@+g3hPvZX|j`I_?QbA?ut67u8{jxRQZ
z4CBE?mRY;C_3A>v9@+;gxP8ec+Cv&pEU#ej96h2Zv%eXe@`}1{s-&;muM%&y7Ouqw
z7d&{!+4vrIuyLo6yO%~bw($#pV2?W}dZNex{8_6ZM6A)eLxL;jT7?t|5-1AIG+s^Y
z-Ag$2Gj43Wo!j)+3(B@kQs2URGvbA3Ib6Mr%?6r!r7m&AsqPqN(ES447+3s5wrwGI
zfc#GNF!ZYK=R1q>)83!Zj(WmzDxJ|PJ;4+T-zhb6eL^mF6K4>v*qfUflhttJG;!?e
zQow&(5rZO1F_*UZD)Lxs-H+{;G>ybX$1G)$r8`gC>-;yZr5>}qCXKDu=ggs3OHf7T
z?vh9nd|ERM+R%veo5?WlwBmXNxySA6B6>u;Cq>+*dF4ns^Tnk(UF=yt+J2;1iZ?0h
z%P$*KJWg3RoR!ToeN;7*0uLH<-qK&J6s1p3etbc}6EF^NDWswG{g5z?Xi7atCVFG>
zrI69u$!B?XF$R=VzcD8eR_f@3;ahpoql?}R#iqdf$L(2qcma}X`<kJ+9hJ80NlZ~R
z22U=z2ZM#h3u*>UIcYp#e?V%yGZW_@VrB9>YC)IA2E(^1mCF%cI3cSl(j`L-*Ws?W
zkJoNBIC)_n9!@)K+23&0diOq|ozhaURmqW1`T>ljFn3+#RSZ9*3$OL#gk0&jI_Ecr
z;j-#O@hB}yEXJZi$FNvi4%jisPK$VjBYt_{9Xj6qyavWuH()7knj#oNji|D^0x(An
z?g=mP8shjz^jt0TzQRPxoHwNq?J1p9$ia%llETy8hn@pa;iM5>?GWVAqQfHLR4Ose
zy=6F;ATFR|6kVxy;WQ$btBD(mBwlJR#}TckIqRLBDDE`!dTfI48TtlsoN%X>%FB{m
zfVt@Qq7yOFoqSfJwC2IIb<R;1x_PNeE@?iH_f_e@-nzibfwK6+L|QBVXJmVkVygB5
ztg4sWE~+mK^YpUYi5K8fHl@k^d>PZez`VSiTWK10%DT6h+T=|elAtCU!0c`M+?ps@
zM^=E=_E_LpRc|;wmgmBxnUD&meN1!u@M~&9ITzlP>D@&kWMRRvmR^zgGwKEUt#6X<
zQ0d!j7eU+ko__7+gh~!@sv@6qi#FCK)e`g$UTj?6{PCSlY2Mhz?ar;b&aQI_{qES?
zwyWFLHr3oPo1yo~8n{1oMvmjuQC=*DY|57!))Oh=T|mO)&5><!U{^e~e`P7|c72{(
z;Gw@j@SCY1aNqBVy0U^O;ge6EM<B{}$cFA^caiQAnn8~EE~p1eu(*nhkPMO=t7y1y
znt@lp7Qc&10{kag;%MOm4@lh)-zt=EVooM4Kg%Jn{9z4Iul`P&sl_E|#80&}V>xV2
zy69vxuzHZ9p<+_hC~AC5cx9x#pHLI6^BNPYRvzu%+@Wzl=-{Zz6pu9t^hl5I+457N
zFhxHa!tP?V9E_UDPtHFwmK0tlPK84oaEW%|Zsxf!1Ku7{YBKWJ6l%W=rHtUKoMInG
zmouk*>Dbo>`LI(hGzd?QH!Gft+Q)X^T%q>;S(qLb^!bGh(oV6rbg2kN^AQ55^#hr`
z%5*T8g=c22bu^o@112HMBzaP~@P*Ji9T^6DyLcN2zU9~vFjZc5cgKDf;mt3eueSRd
zWc@4GwIc<}3^Q95Z*Z3Mq<YYFHnfo1(OG*#<Ai~_E65yoWZ{UcGHI3#WH{rIabzj#
zJ*R@uzZw<6{mr6eWqqh9M;7oD)%PeOeRSW$TdZbrK8k2*yz*B~RI44;T(5>O?i5O`
z{!#5<&8uhcO3{gF?^1jqfJw1>_IKiYVmp%4$w5+Z$y=K?>v7gljJIOop&1(v!|S=3
z#w1Ha!Vl3@bx*ZslWxtthqu<{yDA<e@puHh{q=TBXv5l`EG>H?EWW&)p;VejF&9VM
z!m)t|sqLA&Z*FKR^0jd1e7l;XNz2xG<x_LH!@h<oT-PKlF1DO`MTXX9`RccK+*o(U
zo<-{}C(l7veV^{V=Cll5ecTZbyER*E^U@#{s*vI}IOl5uS37<Ba9+z{FT@4?{2^?j
z83Xmar{4CB@>%-md%3L3O*O1xYBn}a37Z_BTba+Jn|ALl-se323^n7a8E0LTK1_k`
zY7%kRE|eg3sJ(t1tVL|r7t>B2+Z;8)eQVQvHZ{`c%xmB;;C&JC&AbsmVV^Yw=*HsY
zYU@WA%wpoOS;H7SMOD?4w8ZKpCHk(3>N?)m*M_)e=w*ZWuZy#|HQx7xDtRP;Dv;8U
zIMb1>`jUfJMq9Tptb9G9!Y!Hvoks4Lz&R>YpJf^Fdoq=lHUJ3~kx1&rM>I}p$g)vH
z=gVnJ>xW6~$xKSMZse!8sJa5Wmd2Whd;Gpi_nL(~w<0S=w#`K1I+mE*Xr`LMM+0uP
z!~k?l%Lkl8N0sBi7FwB)RS;sKvmw%JJ5a;MhU7o>WzL7JIQO0bu>n-0GKNK1$w9)X
zLx1QSRradZ*k5nQ8Bx~?Tk73TOEZXP<Jd{gnHl7n#3V>AX7RkGNAz$dOb@i`Fnecr
zE1Lro=I8EC$a8H;5%y*00xJ(D;7f-~0|e$OJP0Fu4E&X%uATZwkak+?DDpJZbDOf)
zY2T$s&vQjqlAq8oF#WiT@>OGVk`WzyUSx1V5u-71m_Y$An3l>kzuGr;!@`;0L{<NA
zak71u%$9&7^!pTmN~84kQXdlYCMZ3Otrx+125tk0L5-W`l_o>@2cqx@xN>S*`ntXE
zisBor)`~u&nYsNMUOQH(VK@f3OT!sTkksFhw9;oZq(M`wa9VtID*c^MRyC69%;8pL
z%PP)jf_e&npGS#VGTTWQGg0#A_^n37Rp`Y_18=7tLC*-!6|0l<XRf^@Wp5{ydqi5z
zqPg`QwB&htKHUARP5Q`*e`nu7m0pAoVNL38fOYXEE5%EyET!P?=oQ#G7>xZ|kfsGW
zhEmKvTyR>+azl&_J`oP<g^he4th?Sd)zY{4jI8+~aKV#5ThnL9CD^~p0GZNIur{|e
zB9YbnCRNWMQ0k!@q!4pGD#*Glx#F%gl*|&Vh`oSDh|OGk?bEw83_(0Tz@rg=fGdYk
zKneM4sjqO!0#lS3B!%YN<29@wZi#66K&OiFD`f+Y0;gij*t|85mbG8_aO~mQ4|c(k
zxp(Njy%VK$QJt!&Ko;ADlR!TV$BTu|)mr94x;eye)JScF+pDdc@+ilm?l7z3hvbOM
zioet+cs2yC3oNL`ddFePI@vTDG5&U3n1kG0F*kVC`}}Ya5UC~bJyv56jX$G)xC{@`
zlla6Y^C)L{Yj%NSJ(l_p=s79)=FoA>;!Yw(h;{SXPH5ERN$$eZV(%BvAtss(VE}!(
zD$UOER7U3G8QSQMLX@n%z)1h4PJ#GS_NBCJ)7!}zhI*A9y}tT`?;zy4?q$OwI5t}B
z;59^7?YLr2F48End@mUHl0SPrh)qt5`;eF9depraJrss&c8Hda`ruh>&~gC0Jg8q|
z*_|JMW7=T&imWTy44gR{lT2XQ=1`ndxp6AI@;1DRUrJgaXNezPYSF$|0Puaabe}{=
zKr=@fpnVWs(dd`*6#mbGL>ReZqdO5J#obq#b7{CdcD`F%K35w&HZe2{^n<m6DQ`YJ
zq|KmwA_Ae&j$GCo$mFdv)wd$Jw~UYe#6BI780df`cP>XhE%@Cc6C6H3<SUIBkwLm<
z|Go=WP|15O!=Vv_K2v$ASz405LT^U`PuMssHa9jKp+YvgOQonipsTmLO8ls_Q!vU+
zx2?f*hrd^0Q~#z*H*IqRT;i^t!t<B}@z$Zov#A{Et|4G;R?${wrmX9<X?mH3&{y-p
zduEc*LROh<YdFpA=)$=d`O&1=_h`wH?gVn2f~LyhDfM~tmO(!5x#K)ADTfUJxrVqK
zxuNS%^tm(^Wj5`ZHBMS_FKNP9%-S#Z8u)v6*@N|DJd{{=cN#L*=DBmd^*hQfKW6Wy
zEsKN%B96q=Z0gqQ8-I!p3&=V&OY-5n10wz+&Gx}%N#)d9k!SleXA-rCxX<t+8tN$A
zV|2gd0fs}84ECDeTWTXR*ZdnNhguUu#%NNQLLO5*hik8yVa;r#G<ZK8uGQNm2sP5}
z;*FXbgCE+-?`EYx6GQsu-8cL`+cJi%IBFPOvOeXJ4*}I*<wvkt<B5!paC!UsfPK2j
zi*c!Ri_#F&6~|#&kdF~1Dw#g)Zq5t=sqG?sk|5;Q&5d1bu*thF7d#<nQj>d4wA-XS
z36L%V8>q*sXR7Rxv%pFTV<OxGWi7vd2sU(No3xLD<yz1w_gY*QaW2bRky;xYFJC9h
z05y2Hck6%;P2Z1zcIdIY7o_*>GT&ln@o4m}UwBpF^;6D^B^(H*=uF8_xx}l>c6rh7
zs@{p|n2u_ry#4jAB;fZkST~Q=AtmHi<f&)9sF7(;Xj?5i^pzOlZV}AX=d4y5ZLf|W
z5>6O;|1|3Wz^Xo#6!Gi(1~WkG7wzz28dp#1xg=~{>?_QojeQA%U={&z{MCO1$HxtT
zoMFLGfMx+;;{yj-(9I9yz$x4YAknG*A2|O17NQSiaAk=MgTyXjd>_W#|2jN0(!CHU
zqq&IzLK^^4RB2|j{ojh>ot0Fqv#dct=0QzZ6&f}X?*i}GLvGbYvqdo=@ZkUJpDYtk
zVLy<3Cy0)Qys##H&m`xtEU{~1l{#8l^Ic-PpDB+NpBjpRV#FvP5uHE)uEp<kD&kY-
z1vr^T$0+6Kn&o`gbGUgn%Uq5A;EFMU^%L@fCF%CQzHYDk8o*7FyC}Kvmu176+zbd_
zu&zE!IK)QCbF}GGd9t6#oUC5$AX!Uf02xk|SLMN~;XF^V(3Kn4Z9PKX`ADHL^gI&n
zQsiH}!~fbYo(w08C~<t~tjayhF<bSCZRh7dAp8WNv4iduF-mnVwrf7`4IAmG4~a0M
zOA4l_x$d_en4$e!EWy7B3Wxrgxh0oA=^n{%-6NiOBq9#f=qAd1sz}O@?GNCy`TApH
zs8^LCs{=La->Gr}ap55u_ZhTpxK&&cM*7q{Lhy_WWPXLi?`6TYud`jgmmu65A`PmC
zCnYU>7Q(f9LMS4>xZDAZMf%8!o$W}Yvpo4Us@jMk)}5o!9UdI}BRWI+leBLkyt=f7
zE!m~eRG~vMn?SURNw(Bpq51h>(P^JU3WYjG2@w&v<nV=Gdzn0tXLYBdvEPx6C0n|m
z6hj)l@C2jo3#8yd6|3x$5Bt$qXx-znRq>?oJ5<kt$XG4Ons|@YjRqxq9?{Y~jcpwb
z_pQwbXQ|BQ&V_QdT3rs%;lqu6aUR;FytEAPwG_#3)3bgc+s~;nQN=tlTWQf7V=JkO
zjT)Nhi`34G^oZxdvMy?2da5$A(O&vNXkKD0aO|ljpwxn-YRwn~F25@d@h}izI4i!V
zUV19r=NsYjwHKgr6PD!Xd4;J{(KOmJN>N8RFF-y-MIV2R*m=&n=_ue_+Nw}f&-wW%
zm$Oz6G`ca9NISN7WE|K{@7)M<R#>-Zrnq~>_-1sc>XhgYXjtfpN<RPm>?)7^34PoX
z^_bz<3-TWhH>aP{GS-FqX{bN3>EZ<F*q)X0%b9z8rET(g|7Nz7d4pk!LWwHz;p}h=
z+;St`ga#bXQd2oW8|-<T#RRraVM5|qq-c=wMEgbTM2(B}o|QZ~E;-f|UVkfSWQTPD
zQcjL}m>EpPZNeV;bIOS|3)V~hYbR-w>2*3@#4*#(*|7c;o9wN<)-gIFk(IIDwqnt$
z@he}r8t{gp^4z*obj6NCGYd&7b>40DWS#NTVW0R^DTxNTC3g0#$NO9!hP)g{K3?ZY
z?1~j*qY7}Jnhfp0$1<Lgq~7Q4Gzj!iRCTgw)Kyl)!gQ8*J+2zr+5Uw6)vv0cv1o_e
znUb2y0(s|USf!*#u@U5Fd(l=+zV7`vrVgBU9~`fGuv}2KE~k#WTppY-o{%)_koySC
z|8t|j2!{0FiDA)}c}a8q**gfy#GUp#SHEW3iJ`M3t`59{>7YEEZ~4aW#cPMDkPN!}
zGQ3WA!tgl=pq*x}Zoi+NiZ&gKL%9}&3V)B&vC=_k%&qb<VnM6JS-eMXkL)T7C_wzB
zk3TW*Yji2~p^CZ0?$RtSc<)lbKj8kN_ZwLZMH>UueFHz&gi>E*Smx^<4RYb^kZg>3
zsFRt8JjLe@qPi)Owf?fs^D0_%-otp~ybvE=JBz#7Nis;`2t=%@kRR{@`aJUY0&H8b
zPjlT`mZRn6^IjB)I?N}d8=AxE`?cRHvvS=x9~H~6v2!PWjCpIUCYs`%S)hUsi`sYA
zj?WSNJ|9KsIN$9Uzu+`<N+8@Avlw$b8^5RbsxGonyPf13$Pjgx2+zxxC6Q`+PdTlM
zJ2fjjUBxR8U*^0FgUDA&5_F6<-lxCOy-HoXY7r_q^n0tYVl?bh>+VP#wk_>Bc{#eL
zX43d;a=nwjP3W2F1ve8<`9#aM)g3GE)uvWIV*0w<)Lh!6?)5$aN#B7?drs4-T)PlA
z+#c}lvLrU3##+D5VppH{*yC8NJ>@BQ6TR!sT9&zobh8_9N8T6#FZ*Tbb;>nY2IUuu
zgkblLL+q^>8#J3y``*0CRRDN3tIcIm(buAT(j*OO_*#|1+RoW4N9FP1ykmIQ3=S*%
zP{ZR~3pRZ+Zq)Gl<&3A&9v_31@;A}nF?TaRCk{3SlLHhzE{nF0sI#w!IhVe+Ik6T3
ziL};i#mCu?)^$zuzv#ndJRGv#=dR4WV@bmqpPH;{B(LjDw#Mt<VU>Ku!P$7hZV|>C
z1HL01$rpOD1WDlWw}!eny1f1(nr-0yEor53qU^XnZJqlM$dNz^8`Sn7XKWcYv7S2p
zUD;5aKGWaP?nuPPKI@Vs2li>&ir{+8IL$}&{1#m<e&!4<HBkTh2~V;ETgqO|K6R;3
z#hwi9^;6DH<;Lm7dk$s~?7D8#K_|A@Ap0HLcOg#2(b}9IS~XyaUGHkQqukhn24BiW
zl26$wREMKfZAP=XZ!$w|-sNAtkJn?Ydw!f!O8)KLS^Qy)4?k7&9nPlG)K2UFV(%@Z
z;_BBe-@-yjkU${8iv)tZdm+KyT@nHW5AGCB@BjgVgo5Di?!lel?(VKt_4a!Ay?38;
zM)&Q}eNOkc{Q((_LPibNs{b>eIe)Xsk(#r>-v6aPqd~E^$JChDQ0TQHr4T3wS4dki
znJH0;Rv^ZM=4bKUC#b$p<sMVD{DM$}4zp_JfdVvI*VlN4;04+nif`wsV?pALO^EA}
zUaYOq-FqJUyto3!r=`2m9tTCvcNPh<Ha~J6u4Kb}>$t`RN{H2sB-V4DnMGy%p!(QE
z){d({dSB0(V(3DGmdavR+bl*bP0EGX>hDpy8gE!WF{+4P7zT}kC}9X^1Ls5S`1fyh
znDZMUTRKGE+#|G~CP)8Fl}g#=%lOF#5{1XQ*+Ln^C`+adD#vRRb5|dlqbw`#p>ZWb
zt9UJzJ{nx~2Uv9XGqG^$dbh}(lEr`{K|hNhN?SezM!qNmMN!S1q()H<t~fGE5|x=Q
z*Hok~g0(%v%?pNhR~>y7#D_X<eFX=MruFr9DO+)~bAQVLzs{CRe2fL6AL;kn<!d(T
zIdAKjdrE5?y9cQ8l<{`s1>lTThhCZlHK*9oOfE+0c;(y!+!PYvj6u7VAUDX*k7J(2
z^BfWCd@)_*6KYC(I0G&u&<&Dz2_IxsRX|ZJE=|hCj0VT}#h+aFm{4)}3}<@L@tv14
zY@Aj*7T`4eO|pHi=r7?1TiG_)JWo=NhuS)_tD=yNWo|PwD;J6b)KaGlO$Mjf9uXeF
z;=ggbAm#d5cwOZ$vMwndFP%6$kfGlV)t5-kSL<*%IU^kjGu_MwAc<x}WwN_pBpOa|
znWW$(g?+Jt>J0}SXtDiM=bziiCi@e#Qg@ES)VAT7zBuxZdp+;$Mm>GRos@@U;XC%-
zuljcNzsMDgLOn?fMS^t^(m3|f2GT6itP>{8F29SgedUU8LU*p+WuAr$#m`e;Y~*QR
zpx?4@{#n?w`&I{?Glmd2Ys6x8{4`22DDy^oY{DPRe!bM|`nttQAh=!^bccel*3<uO
zKFsmN)@%nd6>n{%XRB$|BQ&@3`nNama`HoE7hbKWpBS=%kDg#Jg2Ma+ipylbwmiqd
zULg%x76z2HE2uSrQ4kI66x&bBs!o7HG;PguVad>t3w0?Z(#G+6r*L(j)QLV+^K*<>
zItSpM%tX>PU5vE;3ZV>;<9WNf><P7Qeoe5M`Ivn{TPR>ZoHBHvZ`b>iDqi5Z#L6A=
zR};>wg9!{=GnBA%N*gxS8P;nW-m?Wzb|u<_^SzcD*5omKC<N;`bPOoQ&Zl42OMEp`
zaGj>)HlKX*D`pomQMhtfFB4Kn6ZJ_XO#V_qz;X%~-<X?X){5>D?S5uEDH=`Iz;v@%
zRsh}!8O)uGSaM9CciJ>;X<vHd`HE|=6-vn%(i$;(|5n;f#N<g`+mP*#7ory;#2|>U
zmS<VKaBsl`Wt8ekUp;vD>>w$2S!&?coWU$&r0!n!_#i*v4lseRl}kTOd}4}6>CI65
zoFX`X2RFZM9VotZT+}DRBA<IWf1me`Ai8l{ZV@dVT0elWakV$EiRAmuj<*9v(Nk~H
z9@KJ}mMMSII8+OR{&aAgs65iVLNG}4Ej5$f`q8$kewbtlvTR%OtA$y**t3dHFRz;+
z)<fX?Nlm#Ub+ez{j*;(xp>I|v_x#=W!);^z0lEeOB4yrrEHWk9kXNY3Kdy)BPWxY~
zD5*$G)_AH_9@on3&NR;1`-tj(oN!X%r?LY_D~V?36})94Qup%lM_N>Go8If$-x~gT
z^Ugx+3nYRKS;vH{WT2GBX2!hOD$parQd5|->P`^o`8x_q#gtvA#7`xgr5d@|eyDjx
z)J%S9XrwgM)hHt|2N|CVmV6uJ9MUIs`d}72dq0hk*l-&(c#lF++41oB2z@AiCS=q5
z(Wgh<lMX!{R;rgE-4n?jPgoslkS7utV(6>%nS!ia2e016O$~pXXgRh++c!!-80Uw*
zEM2{s!E@gNeel)X4~9MGDFh>#?{l>ijk>e>+Hd#qo@29QV;B26KTGY>?0R5{$k`+^
zNGwmbO_4am6DD;UlMU!uY2^(<oOgh7$$d>zV5rcVez#<M+yFzkmadTMFAytZ&P|hD
z&+M>I|09tI1pAqhic~n?08f8(tHc#t%K23j(12`KpCqU3cSf$oBAH0>t~WZ*mVtb<
z@d^`?r?Rg{Cz-)J(lUG?#6^U8iCT~BDzr*ku^woNSyqzCQ}QkxRC6m6+;RrCAtHm+
zwXf>BUhelw?-_mBg<DN@+6nCt8@anN0xpzN1BYCFX~^UWIqXK(WQU1Nqj{2h4y7hu
zJFe{@9HJ2ube|z2%g{Nh9WfO?BIV4h(KfkWQO&2rMSM$6W9{cA+EsB)mp=<Sk9izJ
zLjz!YA_t!3_VzTKqewIGsn6VlB@Z|iZ#7yM0bIqIaVByhzZq?Y&(4XH`Tj2WYkD~#
zfmdznm-!b+kOO6xxor;fx*w@E;|vVF0MsH8`eGib=}F+W;2XpM83jhqTy{kiT3(Ph
zX~h5I?{O+L3+SLwF=bG5|CA6yp>lsJDJnfprZYKvDE4fWqlzP7=@w#gR<QRU{Xj%|
zaY0#(gHBJ^0vT5qPgU@^fMd<B7p%ZGNONCHfueZEA0mZ(CE&}uo(B5)6NGjO`OxEa
z`X96pPrTomPg3|Xskec6c1ElB@Aiv#fRXP8(5|!f{dx8PcNf!t-~)KJdPxTW0>BT*
zn#luxCQihE)ui;F{C@uSaM*>i>)4|kU_RP6hOWon)31>I1*#uIyqMkt|4&K<3(%JT
z&9L_G&1?VbpEHED0@}zPDkcC5(2n|PBWnL0CDO^`-)SR}2%A|}FVYJLzz@JudDw%L
zf_!i5qHE3mmK)j@c&DRl>@uG{eqPk({Zr@9bewIc`?nrZ{$G1Y`P;kev!uz**xz_B
z;fyWKb|S8iA4m-`mbaA%Be_|1sGY*`6<DRErDgPQjB0mbL?uYt6%RD6`a2=d4<9zs
zwrYc$Qmgd>6R72@f@N%l#iu?vVPR4ifZ%Zeee^xt5fNg~Z4ziwiy4Zu8}P==CfDY{
zV}&}H*H1_Fm5Z43c14Vf@t0M`*&O5&xTdc17eMy*Jk#hxvNxaUgtW+5;#QU%F1&YA
z@|ocpV3bZOMU`WWe`D6fLzATLr`oaaV~Bu3?Vt<gN`KlYeXJVJpdrEx`6e>Hu8!Hh
zW!{B3(Uk0Fa*?>Nq<<%gC&Vj*%8d}&P_t;8KGHDYM(`Di<~rxYwOJne#bAEF%H&D>
z!p6kZ4so8jj;ZR&uGtgZ!J&RCv`!$V0ErfyKu(h0b{=E)HUSU=lhB8lR0r--g>JQ_
zv_tO(ZQgj^)E)Zt!YAU<S;{X8z`P!K3ub*VJQplschB|J1(n`<*o&(H`;$`cR?3aF
z&vo`yTr!r73mqSxMLy<Pz^I}c$V>eK;B-MZV=d=KH2`dx=FBcO)HGBpi2~h(=jf8C
z+g5+m>21)!g7{5&v=7Q70dfkA*MfEae2p?-BldaM8iZuPmC1V2U}>yGmNxi(CE-1_
z*gB!Cg537@0)RfI07oPF;EJ=5wI4R;KV6%ng?c#`beRsc?d|f}D65Im`bkBa^>wFC
z7yaGw{ek}6HRH7N;;wcqV7yq^+!*U#mg&|`wG7&w%062%pBYr}ux**k@Wh6-HhoE3
zk%{_tBqk)rV=0gLE-GvduE?l<WbsHk?7De)FqEWBbjH4=otp0}=<@5`QK4!`_>!pe
zNw;@+?S$t>r^_U`PXYlGhMZ~ii7MUIo?Qu2=H6JCp%2|SRF6_yYJM!?3e+TbBSg6$
zd*t#!+jKwnT=PDSfxSR-d*pX<9_ZY@*iVIqvEhUywz%zDu|35wv>y!Vuq#e-V|J88
zKI6*2OIElGdSu)8BHA#y3!K$x2%Xuvqew885lyNb5M6Pr@#or1e;IML8oXLvf1Llw
zZg9|!*Y?b&4gZ`ku-tyD2{67spF6Q#P<--^#h={&IcPLDbd4|xa~cBN|K`&+l6y}{
zd@#>_^Kx^f9M4wnOl&e-61wT!l6v(-dke8s&==(b-Y6Gw&4R!jE5<(V0A1IPEd+^k
zj@e^m(3k4o%@3e0%<Z5*j%MVHWno7*SquDHx=elBA=DVkn%|%w>SlW&zzxd+M&Tom
zC=ext+l-gj>~TX-j~`w5IEU+<K3XK)KK<6jhk2J{Y;$~EgJNPwX59;Dsu;dCcEx0X
zdPsEhr>^90T~!CTc~t%_y8ag*VuI?!3y|{_Vb|k8)&POFXaf7&j79)pNTz@<0C`gT
z#9Ew>i!P-<yi}hAyP9fZ&BCo6|4-pwXYU;KzMrUzQ}ig@gtvzenLVzuBdkdQF=kV#
zG*aUDp-H-LDiiaPxFD!+=RQ{!a#RP&ux3=nqC$zcp$p4H4&>O3*p3wPkm+sU%f|S-
z_XA$xsu^c-QiUC?8$QzmCz1Z$Gm-}Yc3zBZg6=^O(CzDeoKI((4{v7}eMfX@T$bK(
z4C4vaGs55=*I6f7L8wfY-|Hcq=lA~Na3;oxf$j0V5x-W}g4xg;g$f-f{XXPxVCzd5
zXR!6vXEE%0L2N`@VW{D9d-woPm3R#y<5iDaT_DDr6J&LyrE(ZGD||8Fn`A@obP!>M
zdOw87)Z-dQfghHbROg@^ooGB0(C+66<k7ZZ5ovLHIrVcM>49LlShcFolw%%TbH&T>
z`vD%U$UrTeR3TGo%yi(<GVE0?yzRRzsyrkOX4Nd9ab0kSGG=Bg$)SI<S9HbYgecCc
z*pwS|qrWBo>8tr2SaC9Cc<4tSrIl!c7bsKvQepcXn`dZOJQ5pZ3Q0>kPra^yzC4&^
zTk@;DM*EIJq;!qh*-6rCzbwb?&3ONB(4S^S%eswnJdHaO;%{Jf{!1xqPI7(ucfjGN
zZR2EFW}&oSBqE+&q`0mfCO)}|W6|X%xJ&cs(^#aPn!0Q`YBYo#CqY;>WxS{NO#j+g
zx5hI(USG+hzs-IBBCP#eyWJ50%(Am);qTC=pB)ihnlX;fB5Tyv%hFy(tU(hsElS<U
zqlL&vN`4J$cV6l=8mnv?x#pEy@9z+qW>0&<xr~Dd1!*&WaX38vhAT%>R4<qmo<4xh
zQXeot<NL(gNb>>j`}yOsk^XiD@p9uDngPB?;91x9`zXAo6QpO^F^?UFUa*&Y+KCR(
z$s@;8D&+s58wIU;`b$fDhCxFZ$fAF?c3QXFX^3k;(P>{dsPJGiNCMImyhDibX4pAJ
zaaOW+xEbW5o+&yM?FF>A5?!$Ml3-GiibAr#>;5`RuA2Af5c{3+#JJDVdUG{75POSa
zcI#}Na*i9@@+ir&#K>lTd|%Y+BuBTOpg&Z!e~TYX@Z7>U2p#$Bmkx{WV$A3VlIQrn
zT#tR2kie}O+gk#?s_Z^6c$v03G<$n1r=)A%;7Q!Ifp&Co<tFv%(^05k;ww=b+$mQD
zp|33srptVJ(}(x!pEV401sdC9fO4;)PktmD4Xx@(0yhH&yVY(TBDXQcm;)NE7Tu+r
zefXih5#L*N1M2E2*JIj!U_6=N6R+64KYy69is3+GIW%QoHzD^E;L-i;Hq&*hF6Ygs
zR2eT0QHzK~zGxmg8WOg^ILdbh_g`v^5KX0#Td0%m7+C0#tYQBJQj48wBEA;L?qtPX
zT?cc(!?^da8o0kZlM|3&766S;+iNwAZB3V!imV>m$NKrN2qFd3N^NwL*z1}z)j8sM
zHNWT`Xn=0HYPt|fr9(Kp({C>=oo$PkEO%~t484Q*$<xfxk~nr_3ri5??<1o~ms7Az
zpQCox<EcY`DhbvnZ*{&}UyhN3$a`YB$r})L^3y~Sh(^X<u2i15?N1(m>;|7y_8s6n
zB~M@$Hy5m2ro>QY*_3`FI~QxJvd3`K6h*w@`5JN*6g!i2s>kuOV(E>>QsKaZ|I@6z
zL8a%SxmFgirWz}Qsltsa(M8Jq#8fDYj25-SMd??&)3RCbWmd9G^+feend<OM=G^qC
zbOySsq8R@Ln%c7);Q0@kQ#yER3?-iioc7(kdsHFaf85qA?`JujKlm%Yi-<Lbl**V{
zIlf`O6gG8Van^X}Ymap!*i$`o;~76hj{XSV!m+R>I5_XSf!6jhfu(@9Q=^F${IHh&
zrApfB+{Vc@^^c8KusvmnAT`+m?x(s1<5r>5jHBNfBd}e4=-k&Lix${0Wr?%yj9_ED
z8t#U&7+N9CO^<8mah@uHD}lT1Cp>d1eArFc`hh{yQnH2f%OUd*to_r*YP0U|;X?J5
zYc5n7=ny-uipzJ2odRz-Iel%slqlcbXMTe0E@|m)MGQSLB=^FX;rqz4G+ph0`_{iM
zE2ocEBjI6I`WMr8EIV?AfIW7m(XH95_*}~I;jU~;d&bd>V=u`nLCZX{C|^c%rIQir
zd5U=e^PD{|900hZ^9=oJ$CkxiKSKZ5)A+b0?0^TGeEC#DmD>D36!Vq($r}?ZFSj|P
zTY1;Rk*@J^_Cu0GC$1xk_;$il9mn;tQ(B8G7SL-uvixyNBEI?4TALEZ3udb8O-P6<
z@64;D@VckNQC=w=sr5A9rW9W{*L?H4`8Y2eMvm8krrPq#*;EGehl)~U{WUSSji8q#
z-$LRvv2#Vee#T-C?{iQD_dL}m8hI+wt%Mi4mqlg^BFQCkK@o4DTIJEaE*(Aj)u=8d
z+TRo7uS<;|VI9#bRQ3Fn`44y(PGxj8ZV)Rx_cy151^HkO-94ZT;MU(ao+p|kik&HT
zh?;0@MgJf{-rQ>4oFdL2>8f?I83oM>f8%g+CPnGH<j-_5vIm01FqR}0$i04bak0XV
z&C-{-3LC5dEWFaUW6d94VBRI8T@%qH+;f%K#laM34c|$cx>xQ_?ZO#YFd5!uF~1gc
zOL3^1|C4@8{;ZI;(w!bLr;!0@O$~C-$$nQ>{j$8%d^R7-zetwLh<WP?DdZNk!sHnZ
zf!0`pn_FTimcNrDJ#t|xO}fL?t6OX{l`H6sdiJ~6t)R}aI(DX1Pu4BiZG0WdK2=BG
zdV-uryP8p+L*!wOQ{ei%Od*l|bI37u%84vxlsJ#NoxpCbUg=<)U={4V$CR7&mn=zQ
zDhFc4`3R314q<GVa2rpVmhoiynU@CcCo(%(idVUt6@5se1AqA5D<i&mudUZ;#YJ)F
zkw%XCg#$^1nf$?)Pl?Sq1dDr$gjM!XbkXw*=tnPJ*@{)OJw*`B+yi|HJ(~g=WqR4_
zv5;Nfkb6NVjCWr%c3m9{e&DG)l~~7Sop7MNANu`k|6x72^rMwy`+{Ot%MN747$O)o
z;91!JO74q4fTKZbP4rpZa4<2yo1Jok$mbn}4LSd+R7eJ&pW2r}V}%2*3QkzA;uw;(
z;;m$nL};dzbF`IVUw7-&BcG!jW#3PmpJS_&t5EtC$IcQZrm@A5&Zf?WX^VX0{$@v!
z{NT?N)ey0$+o(Z4Je0xd!87BzV6<TNnFJu6&{on-Qmxi4*TrP+^24n+N-H`4kS2K<
zl6pO9a1}pzN?R{F$Lb%!5YHcGnwEB;B7Z3`Tz5%49~Gd&l7V@Db*Qgqf*~Ht;oimS
zd;&Nru8V#$9mv!ixu%9KuxM%1>V!A_Y?cEIA{xdtykR3>rNP;}073!B6-Qc%Qggf?
zQ>;Tv=$@y!n}y~NuMivecR`FvW<4PJ4cl5&l(&o`z;JmfQ``eiq-NT3hNWH7=w#?F
zE1++erP*AKDe9O}48NA-R5V1HY6tlW6n)p9voLLbrIFkeLLrk$eNVbjGfUO@F^RX)
zY<UX=W!x-xC|Pghk8=x}MBk~^(3-@i@?<<dz+F8ra-95Ncwk<iqVbv_m|2jK9z2}7
zyIUEkr%8>uI~BVFDv`TZ8rCO4$C`V>3~Vo6Jxm{*)P<)&TDs{A<vY>@s}jVCWvO(~
zmN*bNmWGB0UoKwJcV4R@te-=1O_FegvzBhQX143%$ni!y?zXNv;MUv{)+!obn^S@L
zNTDIa9~ZEpSj}5I&)Z$1^l!Q?6+HYM&HD>v<o-u@o{;Y2aEGfVv$QW)y2US#t1HHY
z_gx1K;5>$=xcRs1nA0iW4tXc~k}no1JUS6fyuKzX122B-#pa{d@h}+?5M!SMA%PI#
zzd(%T>j*Z5#`Gl<={qD*hxtQ#22}og{M5V3p#j%IMU{E7&!S=Z+j>LJf{Kuuyl)uS
zX2z|Ba(N4uN4E^GFeS2}-*^Ux%y6^OJoo%vv7Z6k*P{3%i=RPCv)tE=kvqe_gqD{)
zdv#td6Ji8R%nV3cKPcl_nj>$T(;xqXBCpLTUz^gpSz1M+<@!cUqVM}cdp5^ft(y(g
zwsh@w6aDxipuR)(1(v#>Px{TDVH%5-vF`RJh-I<79{nf;UmdKXndb48dG7Ly%CmFq
zg0MBAZd*FXi=y`St4p(lY64eAN5Y6>y<qNC!t=<d!!!@>@V%Hn7sQ17V}lTc%h1pd
zDm6j~cdML9qD&p82E1Kx5l1p*K`>>ubg=BVk@ofX$fFc*oF$Y4nJc(o!|?EtQH)&9
zKUkshZK0u*+|zOEGvy4e5)t&J!@#?LWC1bI1E2E0&Ar??*$&Iv@{`W`<xhJV{<v2n
z`U6nW991-4;!McY%G}DK!<3zoP-=n#wblnW%60%3ePzR8me4_gX-bc3=|R)cC5<U2
z`T@bv{1)OS23Y}M4Lm>sk}tmRq$=*P0dIWm&z92sb3C<vc#otMhyk78X(wSKeTFHB
zfE{gV;(lZq2vmz9H36>;UkcbG`HTg&D{U(LA$gSw2@DE<yIkh69;@(?XB`MGWdmP$
zNra}WKriI9<kL7hV{Qy4$W_EYpDW5%`Smp*F#bK|m68wh{@TVg7ixbQbB#uw)m5l*
z!U4FeVE=MgLAJ6z9FVJ!D@j$%rvC!z^dD}k|9y8=R+?|Y;;}IxK|i<bUcCY`oZIpc
z<lERg15u#uE(_pjF{=FqIwwRqdi>V||Mm3z>!0FZm%{(aJ4Ny3*m^xY5V-A><v-|5
zwV&1b06<^~6{Kc1AapWqmxp#C-?0J57rd)XJj43^5!<fG)ZV&(2!&Cu{6*)}0dwPM
ze=n5&tJ{~q#_#MS()!cxH0zt-T~~QeR~;qTWem?_%RZwN<;F}OsuNISXl}=9ATX~X
zlSNz@WH0lbfyDaEUm%F=9_at;xBchG@2Ik%PpQdY+xD@M*}xJHcql9rCEzs+fY)8V
z0+!feyZaJL$}l%+u!Q#%w<^Y5Em?z;R=}81e<|#7kJ9%*<(Q6+4O`LI?HEBA@SyEV
z^u0j*l+cFs(ts0?+OsT{-}ZA%+QdLm^XjP2DTcAO4eBseemeF|J3-}l=u6B4avn(g
z$kbc~-xQG;xRm9#K9PnJU>MX-P2jh_boQc>hK%tHsOb(d=l@A9`R%K=G_(<0*^ARt
zO?#sA1r3sGK2RuE@{(@w$KI>PsrdJ!y-YC4h*YMbAIfIVhhx;&CGWnMSB+5rFvxOr
zePi*Mqn3C)%H+4&z4I9q5745=8wP*~LU%&=lfxQ4;)^F7eQgtvzN@0SIy%Ql8?VB?
z?aq?zB-z^7$fc?FmMM$mXFv>&^9hEW%}rbY4f<yBC#c{kA8TQ-Qy-!h6C4X*1&T2m
zzVCQv>Xa>2fWN6T(FGPH^+poCy0TQE&9y{BPaGQuO%1q43;*tnn*-nBsOc(?Ck@%+
zDGd**tl>fuWgN2&i5?ZpX!^iZ{bRY#g9$Nv^IC1gBei;L7A*LSlwR)e!@7!?Wz@*%
z(wHMYXo#8Kh%@TF^8!;AMb%TvX_&M7r-^TW6o?BF=WEmrGD1X-t1?4Z#7QW|?SM0y
zXNl+WHCb#b)9ynU9r$+I`GwV_F|;o>eI>;fkYmNUm-UBs;(#T$l6=(x-^Y;aq>Azs
z`;1Q%17jEY28T}ugd6P==b-pw;Ka{zuFm!59q*umS=>&mGFyw?!~Pdy)O6#}SnEGD
z!&?h;wYatJT&HZcI^&=4x<qXBc<y|vai*eyJu?=z=WR#NM*|P5I49bRCEw{W>c2qc
z2i7Dth>wfR)R%paSp`0={j=VrY6qn6D%|6t9I=f4l%g#<LZ0Q4&U8ua9h5-UX@pZr
z;xp&FYNgGBIV>R46#EEKotE|X6$tVQ<j|MKvhMvk+V=Zl@n}W24*Twa1AeZzkl|C&
zi%*L1%v<#E?)ie!MD_M?RPMng?|{@HoE86L#8S}>F>onpI_2C_=9!m%PmX?U_Q$+6
z$aS&#!d(!XLa0Y>ud`tDWbyY3Yb^6Q-v&F!aYS5;P{}JwE8Xw|Lvp-fjRd0}3l-6p
zcWX&ZOO!H)aaxf2tSC=8)Io!K6$JXT+4{4aNGzPvgMMTou_@>wKu28#XOY7IWd~(E
zM^ObFqV$K!2tS;#cgyVPyv)nA{u;pY5S{eDca4s<eR;PVV8l{X3+ySRgL`v6HAk6x
z`!gw-*F||stjB#pK_MjYl@ox3UGL;-Rv;n-h|aotv8`y2yLNmV%rXYWXju8Lg?FPs
zQ)kFRdp`Y<Mw#2OD>|OpWtr#OnN~FRtH3$y@L5MZ64}StNcX2POVh#meY`&L>&k=S
z72OpTMXFxEA0t+accOP4tZYAe4dQd3^D=QAf2*B^xs8qr^s-}arp_eyCS$#xKb|YM
zO$Mx@)(HIc6qx7w<Euq-l`7?S_P&cUiw{Ls)%R@FU&kbBr+;dZ`xZSYZC2<4tf|!9
zT3`KDbyR-4G_-cA*fHv>qDbHOE=@`!W#gAg-~IwkO4D7Gt<0)cUYvzjs?eNac$|GO
z2U%TYKD0p<@pjc0mlV8mO)bLl46`8pux+)Yq+5pR_&?NB_O8pUQ*ji7Nhg_jyN0!^
zU(4)+a$Aau4^ZgtwWVT0ut!J5zr~ao5W|U|Ek5FhJ<Vx1CH&;eU-%{bSHa2-xAusW
zJNF2KeRiDW!h+c1r|_0>uWKg2Wdo$$Qsb8;t$pH;$ujPGMPZvrCG*<a^gz0?eeK+(
zG;4MRXHYjED+=<A4sN~lIyC`a{31ogFbX_T$`ZQWtsdwr!yS9mY^r7c6?{qwDYY1s
z4wOT8JZY-K2dg{k&ic{U)!`6D|8Nu0MYVZy;eD0tQ<XcI@pR0=dc0=ZF6)avsKuSE
zopt(G;F4mpQlhKetrBPN>T>T>_~EbkA?2v!loea|<$(KVzZ<7oL_Co#-yJ*NaKJ+(
zvHd8Pu$nya3^8nhlrW!DS<_E)?Iy<UkD(%cnFC{o5o3)oiGT<p#LqB8C*Th=<O}O~
zOYF3pr(k(rQgHQ?(|vgOPfW9<<$Zz@>sC#)01uf*%%j2|x(ae+qP)Ub4e$P2nizQO
z0Z<UEGVxJ-yXT@Ddfubf-gt45bmlzg<(-ZUf~UThBkKMvliD{hCLZ7T@Cb!Dvb5BV
zDt;nM7Ri?AyWFUX7n-H{uCAg!l3?)QI$COxBcWM%0P4(YCio@5A}r4Cam*r>Bh!ff
z@;+fi++ls-qXX}?;@Hx$I<&B~p|()qQPl-<jCWxpzwj4GnQhmgSb@%W2^+!axfLz&
zl0BXUm(%QG=B?K$D?~Ct->pgctMp!ArO13QL|D6J0FeiKSAp3+)Z+wH1fMarILSQs
zvPUK|x-)%CyowY`i;tJ9CT9TIAuW=8Nj755TTg}`Hz64qAM|_tMyVq<T~hXbHCgg4
z*h&}_OkYmLB|K;eMN?zhy2>s(q)ti;9(6);t-D@*%|`Ih=s<d?_{Z|~8_jq|vys0z
zV%0qmHgYb>y_PK(D!*8vhEwuJ9lI+NBa3#;Ta^CbeI2T^m0YK^2{l6Kii3QsAR-z)
z(!+oPMQh-}wS=SafJ=5rC=sZba4A4rM1NLL%KfQ-Dp{;@l2CC1>xXkpruX%MbrrCW
zJpeO*%?2;8sj;-d9Koma`3_dltP#r^?WE(n6*+3OdYp$SRruVLyjNSexgAzR$d9;j
zOX|xKBZ!=@^oN!~!W#`El&XgIZy2e3l+g`-KKS|rzLXKa1WL6?pkLXk@23j~nBMUB
zZVy49d{)b}sirBBS*C+qovydzO7r%$u?vCN{c_T0xDLi#dZm}L3+djb5cOts`3{{L
zH&{Ide=D#z(p`}1TrbCD;%G=u`U_-U{a}&K4Z~!6(cjs=s1_l6;=}vZun75S#(e3f
z{(Wn(kg8XVwLt>8zC~3}j@4>wje@746ZTgXh~l*6Ic1~M?-`V*Dq6v&ewc47vzqGB
zv5<QQ97Zf{#o1|Y7dnF!qa3ioLXtuH(za_u-?sHYl*<o9V(<_Lu|Le>SG@$}PRe|w
z>!;U=0}<$C5K6yVjFNF#@sC<#_KuQYm*As+fgV2|qcOLXOHRg)7LM_hPE^-~d61hY
ze}?myh$S_kbek=~&hr#gKZMsSkj9N~x?kk{;$l*52%Wx&!4AuN`az@TRlT!)=?faL
zk6&N~D$V6_G@8H1N2c0I=2?1oL3ZS!9k|qrHjdYBPtAxDIfh_-cpr&a(`z@bHP+=h
z7K2qO?(m#eymKe$bFfEyTT<;R`hfsEQ+>h{?Z#0@{Pvk3>oDF>Y6$JM_<&g$av-L=
zc6uvo-gCFI#Jr)Qt#OfzFCpWn_(NfTS&-_Kt3b}YqYa_yUm!;hc##3w&$l$go$=yu
zD!{NOJCNz9I5l|{ZvWC&NS3^U@g+E7qjs<aZ9ujQW$F|_-d4TV4Ru(ep&q;%U3yH2
z(_0A5CR~%WA?OYg_%Pir8g!3L%*EzDQ0O15_2@LL^e&J}3Z<ordCp4gM*)Eh%~aOC
z_XFsEEl(kN)}%~(^naqL0lsRn*2r>#C$rxn17)*60vCt!{qnbpYx3A(O>XVHkKe?p
zqVVO^!*@U^)F6=&w)Ev`S>Q^*+x|P4<r#My4n>_ux>%s~lK5WW?FYd3{*FX_gEhYa
zpJL-pa(jv)28d#3!4EG8QE=o@GqE>mu1p*>VkhA{4sU@U6f_JKzr=XhY@huLG;K5^
z<*<TEd^x5M0>rMyriuS9n551aLbjU!;r~67i=k@~ufXZy16PDX)oYYNnMb1EqmFi&
zoe>N*AdMM4)eqzaH~e{OfCvS6Xn)kD2$&^Y07|y!;cN@=qVrZ8IBz<DA9()Nd-I>^
zz)=+0za}{qdm&;uGEwvCQ18+u6Wbu6#}nKQyGPGQxR@LoH#(2c#=!wi|C>B?Rvhse
zZSQU~UPpIB{iF|s60cHG3OS;1M+VG7ZUGbF@8;E@Ga0r>g{Hud^>MS*`~q72a2y{B
zyGLEP+iZ*UxBAGeaprQ%4l^@5npZ`;Q3=ocwY=ly`h;g^zO+BtsCKYEyNFP&y)U16
z)Z@Le4ElLagpK*OByFd))IRBC*7;E7-~YC%WlB1Z{#+8}r_|_RN8{HeK7NR7I8ey@
zP#;-(jpY)VXn+tnW_iI)fWM{kGDqH`J{>=tnwo?n#^xY4LV+khW>~dMbl!&i!n+?U
z7IHg?5^MV~<0JFi^`b{v%aVj)Wt8Qr_Ew?ECR=%@QQ2LEcq{AmYck`TL%)$5s~gLg
zQa((NAAOwe^3N=LAUG;rUy;i;1-#|%Mf)4XOUv{7j-A4pLJS@^66SXO;wR4jOn>}%
ze5{k$<}LN^=Fbu|HRBbYd$)=n4#gN{*q--xW`7fOFdB|3!JR>OCA!$H@>P)X+>H>W
z_262c4Yq}Aoj=zLlCAmqQJkicg?WNiLWUIeWH+IfFdfw~K+lizZu2a^#}9W}*moUR
zGl{!r?R^-5cYczoz3AN`_`UZ|0+XK}i-I0)dapcIl*n%pjOq90PW#Yg=K3j|&)c+~
z%Wz&u!D)P<lRip$f`*a3GqK`{j_?(2Tj)8o2ONe(J)6#t^7&A@xSz@b|JH*s6%yqn
zd|=GpEKcVX=;eZ*3OfB<W@CIF7TUt)oxQ(s{Gh*Vb1N~}%Sn>z9hiGVuj<7ZFV}%q
zSk8OiehfZSSRZYs3-vMCX!aIS$H3!haU5|vW5N!C#E}P5iDTZTc~D((qa07^uz{m}
z=pe!1zMH1f*0C_Nn)tg_i49%R5rSk-G+HMj&0P{<{Fw$Au8;Sf_{QnWeI(A=Som=*
zi=}4u>oWrh8VlaxKrMG6w_f=dorc9P#QV5W4yS+u_$r6)(`vsVZ79AUlSjPX+v<j?
z)I+tY6G}_`KF_yQRy54VF+_x)GKgfv^?@yBugZ%(?NwZEJkX))odw(12md-j#Bzgc
zW!+rav#u{h@2gHxggXO*zTpjLf=&JyzXMeD4j{wXf>pG#dN;J8)EDLQ(t6SE)aCIr
zZGDQK?jT*g7HcyaPKd`^kg>yA@=foZ*118?LwOL3{bog5m_~e`y!wT_E5Dli^I%H(
zr$MIcx?5&|ozzCk1Mll!AZrtU(U-GjK0M`jy$cJ-L1&vU=*~k#Eo;XdBixQPY8ApS
zPT0LRTKRe)FNDd~igCC!&!vlTLh>rzF`{!yljO?m#W~)7NB3EmLq9(iqlhNDu<TY@
zWLjGd76sd^@SXLRVn*ctvCpnFFmR8jX=whoJERcwGOPOo%;`k^HOT<csLv-vp35WP
znv3jNC2GSwJm)RW0*X0$Ep&bU*zxpCH_4G0e7$MB*!u7@$2o2U<XbA`=K+^KFFz)E
z6x~}Pyh|**yP554dQx1VJ8xoDPb$?Ke30y4xA(4&+8Oi|6oZR}&B=7A^3{Z*jR4Nn
zRzK0=zQONu_*ipkR;!t`v)0SW_rq>Nj))(^p~^3O_8D!apiHMTga0hHTL~49(1TjL
ze#WIaP>ZhKcc{_tqT--Ls2C*UXl#{_ocIfb#^dl>a?OsZ=bQ22>(>yo=r<9bZ@i;6
zhYUiZIt)aDzoVSg=tNnI(xr}VhO`CnMXl9WQG(;I;evK3sS?Q;N_S1Y67-ZNi5c1a
z<s5ekk7hoMccmK$ozA3s$2k+p!U3~f2G4hb>GaJZzwzFoi&uOpapIWq7p?u(;=Hc&
z^@Jzwl)UsbD)U_3%IkW$s*fnM1~`HULo@q3@OXZmGK@OUG(MUvl;3!@&Q5l@t?*TO
zH(EY&%7sg1kEGigR0S@Fi*V416rk-1G9{e5$N12#Dfo(>_AGq&vK1^n5_GMWB@VYg
z;o5%B8x**xjMcH3V2Bse{&_5rlIJ`fhS$Qh`J6?;MCq>nYa0y*s-YBv8ey&&&DZ4^
z6cLn6JnMfdWfAoMy?XXP_*!{75&+fF0=8#pt}ls+z&|{N3c!4*fuKj5wQJIz;)%4I
z0FumNr1;YTs&ppjg?-i_UqUr8jQ{l8gf9a<iu1lg!m(06g-5m*AltzP{ULw-x$}I{
zrUJsvxhllzj`+p@GZC|m>l6T(cc48J#JgNc5qs%*;lAKISO^)6<?-&$K>}OkzYG4@
zp{`+VYfweCI^5CKh;#S>DLtwKgUWK8+|`y}4vI`1+nN8$pd>(k{^d`3-v47I*ZF`$
zF+V4s){VpPfm{QA4-Kz}wxB@;L7|D7l?$!buD-iFQv3&B#L$pv5zcZT3?e)cSzENL
zemd~(9O%7#CSw@QwS$8=Y!<%5nDzqd8CEwAHT<*Px1a?F=1Nr{O26{{XC2IRP~|eO
zhO=O)zXNxR6cqDM-XDV)jsFw5O!UHvO5YQc$qFDs;^+6>{NrOj+u@wAh)VnRq3Sql
zyc|t>f}9lLKh{v{#hgC}WvLr-09FKT7L+ttAsjV!eMuJHq#0ef+;sH4xZnr~dYaDo
z5~UYPokT{<v7~siMVNj3(SH&p?bkT+Ij^4SgGIbVMwkt`ub+NLp_nF0`lpP@;{(SB
zX!<5I1zn4hSwun8&&0CAY?(T}uKMaSuG5Qz9xJ{G7T~lvFG<QkZ1RH&s6MTb@@)Rc
zfl-@ah@o052Bwjls-)~4L=|Ow_*i#|E8@Xpdr0~Ill-%|Ub1bTzNsO{FF{yL^fw=w
z7|d<5c|*<Y{y5F_J!)T#0!-}1N`y^Yz}f`M@Ar$axh<V^M3qy9fgPhKgmL#04N}Uk
z?8HxnCk^P?oAV`>Nt(V&X0iFx6!6sTuDI<tAH73+xR-4%qJEo+c~^&8ZzSCZ5Hn-8
zkzI8Z_GYmQ#BAkPMxopXs_YwH3>~nB!VL0mEcL!1-)M4;xDc{sYm3cXzZ#SiUB3eK
zxZQ<I^@g<DiEwJn>SHwILyully(!w_hge@=JWMHRE9Pn9(f!KPSk~maQhX`*Hdw?7
z7`On;o~40q@1M#=(rXJUWJZ1kGJTeeXeJB2&91{^!#KdhLNq9L_zG-@W^Hiq`o6oG
zi29eAJ!GtKC+tc6Yff)6G`)sU721KsUlcDc?=!F<Tc(a0wOh%=A5f*2?;(SYnso|3
zBqzdoA_Gs#`g{}TKa=jax<#pfG0ln2dbelWtBTiK<;o&`_LA&tXD>=01Zb60n_45w
zc^`#4H&8O0tUB{ab(NEC9bTBD_4qtjCM9K8tHErMwz-*!{@F>S(%f$0N8Z@31j8$i
zzI^|(5_TqWA0-=9Pj89(GQ8`8^t8ExiIbrVUETieYoW8qzd*v%@&U)AjHQcrei$Pm
z!yIu_FHn%RvepZB^WB-B9-twDc0zK^5-)Il{UM3(@GsJPM$(&VXHRx63BgSmE)Q-=
zwo{&cgJ@;Y-xX;}Nh?ZqcD2dvD#%*P0bl;)!KTC?<?2pix23i#p*{m#6C`cp?^XM-
z<>rzEM0bgj-KiHE>Ms)2nwoZjUa3QEbin{AO35-2;x(9aKfGCMXX<o|apZG?-To!`
zykM)s*|3!v|G7HLRBvB8;?MQrh}rx|K}&}I+kP3RqSZno4XyT>e4`67A{o<Fgmr$7
zHCIlG6|bn56NY|J?Fo%*J)T?KkBn(F`~h<C_zXE8Fa7`$hQA=_1DqG+7p!ud(1(Ov
zc8Sq0iOVFcj(a-wQuLgctCg{$`;SbUCwA5Aw2!|aQ0P&24{)K3dZiQzW+ifcisVSU
z0No+SoW)*Bmh*Z97i2Rc%du#w@?#an&-!ml3bEfBQyj03MvL;PMF@jn9pp1<MFvzF
z)_qG`7L6V!u0m0fvPS1{`391QnV+qp^*=BBJL*mEkeYJtm~?hn<}E3r+ws1-3A%i*
z`RrIF3TVy<osDux4H^-*r(}q_CCuH4@@TN)d$zZ9DU)xiXDgn^jy<?qJIcy)3Pj?V
zN=V3O%B{NjnIPLQ9<KJZcX~FL{uGrLRf5NO-T-5>Y;^wvNak`xZOX+?@HZQ$0B`6n
zIS0}ecg##DOW9_blevUhuN9Lgj<&c^TCUEhVebnkQ|=iuAm3OZ<G>;LPBj#qf?9XV
z%zT6vspe3F+YRNEQU{pW&ZBRp*;w;&pe|y@DX7g#5Uq)gH=i0XS_wbRyt@g*xo(!P
z_+cb2f(zj?L?*k~?r?;H8Fpi=MrdnTUy7{Y=r717@!M_FJr1)o{hYRCW!vr>BKHeQ
z?W#RT|0;1}+O9a2yuuYa@8;>}?LEVh*PD-4R9zdX5-dY3-e>51pE^3lW5<gA`Q#ld
zwE3G&c(QKGl-Tpv-`i3a5e(s<S1fL#iM;@V!Q_qp<M1R*2_JH^G^6o)VyXzdeq9`A
z-EQx5ph1ka7i<QJb=ZX;)C>_7MaKwt!uk6#S4I3_uw3m3>2%&R8ndN{88z+k5fOVA
zx<NxS2&)Y8v4RdFAD*UXR_~cCB1S?KNs%BsXGr&$pE?`EVcNXi!W6qMoS^qzEY)tY
z-(c`vthvc<56g05PYK;H6$hLlS-&ltecn9o1o|+Y<g)DUzTn^}=-O!u?oTb#nPRow
z*O8u<G-SW&(=RO^p#9~D&U)Y-^0ut2bpPhh)0yS$@2>A4iNFAfg+;|4BZpa4QP}=1
zU5I$*MtvdVl0`mlRDR~y5<Q4Bi!!<&9!o^A8$N@M8z&#-6=uk`V}tDxsw7nh+zpxA
z5DfE`)+STOI5RZj_~LLzK%~!Ho6>hly6Gr6<L!dWE6c3S7Zqc`H@&Drd^uoK6Wdu-
zMxx?-m>R(T@3y#IQh?K-*ogNyJX9L=z$z#DLkJ4sK8@+G4*g~3mphar2ERaF;F*-~
ztLSjb7h^Lu*WE5;pOx;8pRmSBEyEr0PP*}c2B)Urf*-GSz~*0Ar=Q29(U@#m(=<<8
z@Q0!nK*Lq*54emN&UO;5wcoqNg*owoXMprib?wtk0=<HGh@u@3S@117GNC>g<<zC7
zyWJO_^r94iOKD~d9+E}T5{KDd8YSP<%!DC0=d&rZ>hUJBTV`AizZFxyi1E~-zUX27
z*r+JNaW$80;}D#2x2&$@9L_85k?zh99&LJRK4~fTipWx!qH*l9NQV>v5Sm_upXk24
z$JSickje_a75ploH>2pLDu-Z_UR0l^CjR-<#1F$baAs2l?Wl?tvi}Q^0TZ-SFAU<g
z`zw+tx;B9=Zx7QAnT1RJpQXa+S)5bYp>A@eL6vPV9`}Vo1!Z2-X{Fx1g-ss@p(XzM
zqNqRaF8tguWC)KvIILf?Ut{(_g{16=mSkl0ljFzAXQH{foe^xz9JbeV?RR(%$XXUc
zo#v<X#ngS@)7(Eu5o!?-{!=lMFVa0Wt^tAMK-dZDC-`4}uq<8oO~RpUF03yIW81Y)
z{4#>zFnJ(H={3ZNO`S;DM>q%^(?pf;%nmeP-lqyrL%ewCX5$`EF#!LRQWNgpYLFwm
zU=h>Op~nO1`nT8Wduy&b6d&G0`Tl1`-#9zn1rZJ*=q5sw#D!6$m*M-iyX5ze`Ewg3
z_m@()KdK-2hF@Qv!rNLwZ$Q#$>_e1653oH*zV3WV%nnV$(p28Z?i74Om@RaVKih}y
zR9faSAMJYNZzR%JJOT5Y4oI2IMfOnC#XFF9Al@F{<=^GdElEd%GLIclK}qxu0y9(0
z%1pdJ;QtA)$`kW9>>gtbC<p&XW)u3a%;x`!qkth4rk1hePxUv+>hs@fmp@0D7x}*l
zTWZFQj>a<Q)JSn)g=&O(or%}zhXZi(XZe5_2;i^E^`kYiR_o0^+I0roL-Y~QGg!FA
zSzcLFiR$xoYHDc%i?x;Lpct_un^7Jpir<KSMy_LlH6=>Zqf&P?O@`)WciNAwW7!iT
zLT`H1cD1v~=n7BnVuU?GJdCB$_GV}0*j<z^%EP+O?5H&=e!K1V(0<?s!p91Ch8Erl
zf-w(y&rMi@vySZ3!8HrgPM-qET|)+zE6z$USvj2_ZqFT%@;LQ~ph;jKDrYQ{clYwf
za>Dhwuku(2pRsRoN!)$H7^l5PT$2DR39&b4+_8~p^M=A0iAR}{pMiF@|NBarmlTUc
zGGdE50w4SGp}A}X{9_ntO-vZdYN|U9sY7~BM+v@VH`8ff@+7}@ddqx`x4X!-A4E)?
z_(0EpaVOstA~N14N&;q(--aZz{Z#wm-(+%q6dq;tt-;lNA%1UtUUA6Lb+vy5HnyKV
z>^hj6+_EUT)s1vvC%u~X%3a$Biot%hHlk=}`Co-~)`7my8_4GwINeSA(NHX}<|AbB
z*NY{eh)%E<NYvHV)sWIgXafL!f#4=*yYROr_%*>ZE|r|hmE7^~hnPJV_Gy^o89J%A
zKYWuFK#zd8Jfdx|MfdfwJu3SUhjq<1nFrY6UOv()S(8{+A}5%_{dIGq?t8(^Z<c34
z*m1^}XR+&;-GJ53$MD>w$K)&NXsjz+gsq)je%+tr{JQYGYW@hzmvV2IshJy>S6UPL
zV9($v=X_mpcPf2?!uok>Xw<*UM&l*UqnLUaIS0rBdbdp-JNaoVMJat=+<BjMsWr|B
zv)H-0k~K)RB=a?eEMJAb=nTZG8KTna$J|C+@fZDs_y%YDuvtD2RzDNXk%=oYw3&Gs
zlPmg%yFiX2Me+&71L=M9?>fQQW2rSLmJjB15ZP+z3OV3%simf4Ol@sLFv;scR;6(G
zM7$r7-|rOGbh;p@9%Jg~tHCbwE+Yy$R-YPUn3@ADE=I-U#jQWFGu2_fc_L&+TQ3Yg
zD+csKe^)@b^2q)zC}H)GA9*6RQph>Ll$H|UhOI4Qu97OlFP2S{uKM@WR9zlzj>tk%
zdyw_KrWvt2YyRz6`p5q1`IG!Kt17&lS0|oZui=mFbJk4Wu^^9`Q(Y-2q2XPzw$Yb<
zl=P)AVmaqg)C`o(q&^K3<vX->9e>f+tYsN!6EEdRuQyj$j^p)&7gIzp{jOI(UrGID
z<5x>C<cn&zFbVP#JjdCMaQ#VX<Ex;dnmnOvVx;?gO3k13)q?JfGXD_H+$J~5g-T~t
z;UmA_#H%J&$U0&Dw6Jk1?dr9}*ingCSbbtbVjl_1Di1KJ9YwCUKJQwsE)RfI+J3CD
zlT@f{Y5b&0Y7@SReIev(L9_Phj6E9!5^<YdpAEDX#-i(DfyjoAbrH;un9i`<M?k7a
zOX3UYB?H&fn8_Sz>fD|6k+082!`H@et=e9mP1ny|mA-v?T>4?<!t+Zv@2}Iiltqy1
zN0q`%yq>>6fv+#Dj0x`)3Vkesht8ZRBsDIKsgaSmEe^RC@1`|lKA<6V&Yld|^PvIi
z#yQ^lt$!PfhlL5o-N|np6Qwp29%_rOz;vuE*EfmD?zs7PmE&u>K$sN+NxTQawY*cv
z|Ev~^WyE~=F1SiTkiEf~1}0o~@u`s+_o%Sb(A4bvIp)#WSx|Qd+1YML`PE`g%~{}J
z>ialr_aSGCYP*%nv0aj9>x7`APB9cQ&@<5e<vIjT+l~VHT+BA#*&^q-af)&1CA^T4
z%Jwz>QSJp7eRvMoi{M4k+3R<1Azk)IQ1e%6o6y)73E{8%UYF=JXlpGv?tO7IUOih}
zGwCu3;j3Th3%=UNEiWukD3!k1umK>@j=@}`C!HQ(#x-(OX)$iR02A!ZyYGL2UL9S{
z+qNihXlK~iG=F{5_(>vSaxo{6gqT6Niqca+cpS42@&ZZkvAZdAbb8L!gCv-AVR^oO
zVPHMZw)npKKqnOEw_M=+j}ZXGd7CeV%nb`OY6os#QGJegRQM>k@73g6G^;TUC&T$2
zFOxz(!(4`i4*v17U!c5b_D1;*#DkFOW?PrdP0);&+pUZDT<IQTf3s~MN%yTxd_B-y
zg(+ynh1aBd^>-Q@=4WG6LBm@?y3kr;S0h1^)3PnzTeq!y#WM31HNF>>@n*o**<ZNt
zW^B^7W^A6V_rW5;hN85zG&jdl@)>#z|HKJ4W05~<!O;^?ndMD)+&e_Luq3l01!b2M
zqj*2n%7ST-iJ3=O*8^L`mCz}UN6e^*q~g@N2dmvSi5#_Ks0Nbyn<wy6r;8j}eOls2
zegMUaNp^N!S2Ei0JUZcdJ|Io?$s=BX6sWb8j+WIlCwERy_xDT=fmnFMUaWc;0RNiA
zKCXp#XP;4@kMJpHka@ERJ`WKyi(9K#edhsm>{dPmViAQu@-b^5$D!b|>oc<M%EMQc
zZ;}yC`^Fl+-)KGYtNcCI)}0sHX6oufM;DkB%;yQ87DUE>DPn)3BEr-!O67xcXLQbH
z5Y~;PnS2*%5Xe>?`S`p!@_Am6z(t0F6*X%{z-7!_CLY=yCQgyx1hj@VZT*NY#BVYu
zSvO|xwR-$?+k8a~TJrMF<~Ol1>&+{L*zopBTT${e<H{TGYoB*hJT8;AtearV>8sr-
zTF)1Xu!CLIo*11S;q-!q+MD*kHWH7Q>$4$?of+7FHYT~lu|s85tGP?*yIQIQtZ3ZG
zU%9dPKly^;nH&Z&Hwi$#nz=gmRvgbuG9ne{3FdRZO-`zFiiyQ&?H(g#KghS&+_a}h
z8?9BjhqS&%4!~C*9K9g_;|st<N#X4F_scsZUIf9M{kce6hD*T-d|sM)L6ReKaCIA;
zzU!#8Tph#o9gNyW(s#~)WC8F7^BzebOND1<-CsyL^@kAU*UO=Eva5T3625Tq%*68_
zUN{1ywcA+v@EaQAy*d>8aoJ#y^wp43$W!R@IQ4<4&kc+_d-Jj_kpCFEP8r)d^bYoX
z8<BmKRhr`MnYU>*roNjYSDq)#cDCASj01hq9_G>m3}L}V55S!kk0ya-WV*k*Ok4X)
zmVc)dipZ;$h{c=tcPKUmQXUy(mbHP<TB&?FZ?}g}&bw~cl~zja8n<qM_0GayRQGN%
zfAuc;MhgL}DJRcK7%Q@ABMQ9#WT9t7TbD>Igi0**<~~Mz)O)tf?@uaiY^Kk9L<WnC
z5IxXy?4w*avyW~=+Jp8UB^uSANcoA_X2e5vFAPr@e2zOSUws}5ySZ~Ql33NOG2zwq
zDIPLfQG_+Qu+%%=8!&nYDQv*PR$iRv<!9PZ(pEg0?}nUWAk&eymG`fy?C`!WOP<en
zvDJdyT>d$NNP+%s9QptMoahqP<#3M<92AXIuFA8Sb|L>)?XV0vH-tGGX<``MsaX3;
zqEjFO5vaamtjWxe|JL4jhBeu3+rAXV4k{=`2m%U%iXcU5K&1;v2SGrJic+MB)S##+
z0-<*SrS~dDs?tFWy;teImxLtT6%_R=XP>+GInTX+z8^k;n7l7pS!K>K#~4#Pj9X-q
zWV>aDBI}>mI!hyiw|TkWm8H6z+)(W3@3IAz=7UC~Z1gfySK}qeg)}-lr>^DALYD{>
zSdmHSE_GJ~D9W$#)PEPf5C{H{=AQvcQxw15c@c8vWgh!V+^Rb421s`j??>;?uXI@j
z`+<!wc13EQe8Yd)VlmOA{)f&adcQi0^>ZKcji;~%X37<6rB}DLMYK;Npd;jH?C{;2
ze3JXfl0+1@A?==+=>5g7w<K%&4tczKwx3krLpDJ1611P1X#PGiJG+HIQL-<75>}7o
zzWnJG(X2EaVD|*A%NH_F?yXT+D+#(e`}l?tGj8}P<}TqsmUA}fwU=t}FFb@_BVO1c
zK3+qx1MgRRZwdX>Sgy%^<59jR4+6IDz$ylT9Gej%JL)_{gCiFQB?|&)`1MZDvOk*d
z>@?=eId%UPYlIQ(W7)ulsE1G_j?9Wm&8$s^ajzteny@Rm<Q=TLOM>U!{Veu6MG^jZ
zF_KLB7m#eH#v$wCbiqAnF$|F_`(+OPi&Ur-Hr5qpUV6$1mA(h^rjkv)0)5TI14U8j
zdnAh~J|)G{8b%S@(Bm71tGv1%^_ovans=-Y_8B%mx-r8cF#kwu1hpFfMq9>ckiP!2
zR6n&oJc!+k>Ukz*cdDhoWLrvNE)$1io3As?Q+V*L_a|_gXL^zoHlE#0Y7Oi^qT~@}
z=utJ662q_cX4?DNVNQuqt4{6M8MkHRC_7(krM+g9cUP*l<z=h6GTcHqx_!$`_6d2I
z+CJDUq?k{Q-EvWLYdD+d`@W_ondeTkZTP!aKJ1a{PXLlh8>C1sk>JxAD=RpMx;CvK
z*lxGP_m17v`h%31JLKY+BI;OK@@?M4b^au&i{1s}^HfH+s#F|v<a0~-wxN)kAm=^S
zn8*Ok19Z|O*@@_sEICRV3I)D3w2#~72ruR5Z%gGNNuG~aR1w@9ush0}s*QoNR@yP_
zpX)LBo6n}+t2FI_r#(Kpd89UerlI4mdAJljPR0b0V3K7?7n6uTz1(&oRixsCw*k>c
z>X^V_R<g%={^zMmP9YZ3dWs=_E+y=)izj?!{KmH)l3;b(pBshT9sj0WTBWL*a_?Pr
z(ZJn}1`=$t{a7E5gyk?jl_X<{*5zsGcRXGv<#98&q#n<-+9X&kr#9r=EB+8tPyS6H
z_L;Vp^vOfSM+$^n<kt)X)V$P}ShCG>b6cZ5Id5Dx!*Quxvvg!BIvaF_h+g$5#$TPu
z?97F_+($7*$KB9TQ#$?ljD!9MlJv=yB^3)39{S}9T}?4#Fcg18?es<56mPS+b~Ev2
zWg_{b0=#DW*{{Qkq#B2a@DyEmwV2WUSA>w*ecO<iB3o-=hRw6#TWUTzM?O6w8vzD|
zfJugU>y~ePC&ESY!$s33u`k(snA>Y{9Db_aj;><o8wRgX#VS)~Jfw$;JDff&GutX(
zVJAk;D0;Ul(G-?l?-BTt;fp@d)5`qu%niFE1#_<D>L1!JRiBWH<@Xf84KqhY^IkN$
z|N5q51W&$Te;vpD*O_(_EacTmZ)oN!bf%A+*BEref_ZxyzwKwbMtRF%cIt)2%%}8=
zz$n0b?u)V(wMN1DTgex^8<K*l+BR}R{23JAQKP;U@OElV9h1qge@-EAKC~7S)To~6
zF7uL$GlBxNazE8kdFyTNoAoEcl?q!&_?;b=6s#=nu*DVL|3r+RGI)%*{jN-xJtDPf
zX)iD~?-zE_N{Q#NPwSoiGILgNo)s=8p_b$E?Mj%5w1n;~w_;0<t}!2mrn&F3fQ+Hn
ztA!$q$u8auQt_G-aXI~u2I~u*#pmJ+2E4^t{T$TW_)g52jlU`8j~7dRD0ahd{5JPl
zw)$`4ZAUISUt!9Q&(AA{ok?|X3jTz*rCO;wPD0-+peK1H&Rws4FU9p}@)53=BU2u6
z^gLvzeYzgxbxYf^i6G%=nr3>cS!h01`fKDfw;qa=d=9;6PU4RhFscEPb;+TwOs@BH
zD64A-_mvpusxN%>R`ZjiTH@z$52dzLlzWa{Im(6QsJbU55?3swK4oaJ{u1sBuTPN^
zlD!mMg?vAXm=q)LNC>V~PWBaUx$QqOAnD?sFr#6{%hqT5n%FQMN;mk{GA{nMMM3f1
z1#FIooU<UlD@gSb?r}jmOiwRiqEFpB@+ob8GksNe(UZ^7SC~b(qLOCes1mD|E?J`s
z!l{}VeYF%bg?ZvVpQWE~kVdrSJ7DX3ubvc5w@+>Fc)=si@OJNTK~PPKx;H8(AtX5K
zz4v1QQashGrfG-hBh01@&rd@xXLBrgw0o5qB+e_ccBEb1%BJ+5Z_q3;+<HoPZp2QR
zBR*GdD;^bg$>Eu`uHv1vSW*e9%z-Nv6dcXDX?jZfmzuTRCi!7svy$lOB-VK>Kub_P
zJ~Nbe0i(uVjPr;7VY!3qcNYq?;exC7z8MDHmVC<&bByG*YSd|IJd29K`K1c*>Np{)
zyBpkdPW)6K?~cBT6#>nRyo~BE&Y3^AlC9f+rH}SQda=wyh{OD)27Q)J|3Fgm12KTb
z$o3bKtW@c!Mt<{`o>OnV;lU;R_3X$dl1g$!t>v_5Kpv7&-%M9#wGO9f(X`lHV`-``
zbLP-n|8xXqZ~}B(YsnkOx{I%-WBK$NQ}eD^QkULlE<96Jp(Cy18k6n)EJn*%{JB+3
z*SAm!M_&)w+GRR3zz$rttAHs-M}27?Puglu5-mnHQLxjVdlha&-(0qL1g-Q6UOKo@
z3$|=R{kvYbB?<ltZ-8V{=rWw7K8`*Bo^_O9KlG7`VT7{Ys_0!km&&ZA3QG>3Tp_#Q
zJlcJT+yQ!_npHk@Bq5V>+|ujyXM6(a+JXNVn9hGVp0`Kvkl{+NCm#OtT=+2Dfg9d`
z1(r_mUN;r9Z{W-$!dbxs8FcRXvXS&rAjA-F383j{{#|AG013K<`Yhy62Z?w=61yZf
zSt1sQTmHa~-sfc30ZE57(H(&;bbCN!pNq?^kR$mL{_UOL^hW2z8J`{52P)mb6_1L`
zjN7V)b!-N|(wXr@1AjdYh97{hKGg7WItPeuI@{1947Y!#6Z<>EFp)%;P-`z?76UK2
z0bAt6?duHhjJ*$A-tUIr1295bsO#V5O8hUqp5)DD=r+VM0sioO3mik>1Rkh2{Je(C
zww!=J-eKLROPBF7UkkS(^FfRV2MP-cCuis?5bNk|=sm5gNXt(S!H;0?-~Bzrv32_L
zzz=k_t|MoBN{l+6)#IoCU0Fwo)x^8s4D#GCO=K~M&)u8O+mN^(_9=WDqKm<wKvgVY
z4s1iC0E6A^chZ(Xh$AZ58p<X{@tfPwGV55`OerVYa08B)-je&%t6__IE-*xs1~4ZC
zL1gvJw;ncN38xf{K-J-vz$LHY>_8%W-eqDNs)L#Q_qT>E9pGL-qv54+>?=h2X4x3B
zZyQ20&v9;Q!^z7g!Nl+Zn%fbZKV2!~&HWhsY029laAe)6*@k?{*9K2wv$jB)iN!gN
zAl@C`!0kaSlWs#;b0FUR{aUt5W|Y5w-qZM^Z`)819JpAGB6G`zO|hT_cytC{3|!2s
z`A^p>z3?8n`GUp{i;WtD;jhCxo%EJ#<`G!m^<eCUDEGltDu8Am2f)!s_#ZFSS(U2<
zI@-j5V>Zfv3zU0m-7yPq@R~SKV(=3M1gRG}i(B|-WoTjqo?q%u*V@eUfPbSj9$Z;Q
zI3dvByuH1IXn=u<wk*}7_s4H!@{d>2JJBqKz3N$ncTrqG0v<2ypRe|xulAo+`_HQV
zug-%17aMZ%1VQ9%w9{}!<E!ne9s$)U!`Z@H%0x#>k5`Pj)J!k?PmGuJIBGvU(}#(q
zMX`^FBz%yu>V3FY_IQh-2oM|JrD~f8=8(%`H!=QK1vA-6XYjmN=ETVVv$OuHrPyIs
zp6AUN6+rDf``)m(BOsFf#2qmr3kP}p8qp(io=AgTwqxt2dBCxKj6)u>getiCyru(#
z)ad=+yh(00iygOkg_~T$Pcfs%k$tcQ*3rRX!n3BYaNW>0^n?O&qwS4Z^}20u?>Lm-
z3h!J?e3lHgSUGZ9udU+{ZzaEI&YR~F2}wMf5Y?(NJ>==AN=hNkOscH<-rg0GE+@AJ
zD3gl)t~JR|aS5Rx&@XEeuV3O4f_X_`RKfJ1H+=QH(x@DkqX^eRN1!{Zgwh|OmyNRY
zP*d_+_>BA#B`!vMan|oqOcDX1x<_gz{sF<QSaPH{6Z-7!hTVw2Nwgas?mm7e5CB#9
zPpcD8eLE3UCzg#^T<CNB6>85leQ8u{?;2ip@F#145dJpmE}aA6ucTL#og|hHIYt;F
zGq;@lZ^Z~f;W+qX3D#C$jL#0MU{t2}kTVG};`ELCapJ*OWBLq26*O!FB-x$4*@$vg
z2b{_(d&>rh%HFaU`aVO;&MH9AGw00Mo1|3MZxoA36#FibvSyJz8>mU>oNt)8W>$Is
zP)Wby!P&xo)Yi4d5q}j52CIfSSA-67Ozi08%UO13LcL{#{p8Qc?@~jRcH`tGz!8oA
z0rn~VHX2lXgB-yyxUonHY7?Olz3;d_Ipa)|12B9kLpA>p+w9*#xqddg|88;<c{czz
zeqna-64pyf;%r7iE6YXdJ0p?|;bM4AUdm=|lxyACQ$XD7LQZ@P@@Q;wo4lVQZ+k&o
zhLp=*u^51Hi^<kqEJMXAXp^WBGPo;E<BdeFl1;rf92~?(?ecfeTRkC(p50@-Cg|*e
z`Lg8`%g;4;Iwpu0f9ffA$$!BkO!2~H;h=dgT>GK2r!<s39Q?uM?S{q=DWsD2I{RwJ
zUT4rMga=cxyk}mKw_4`HQ>x(D>-%)h^2s(JC7I&nW&+IWHCPKJ;9t~_H$-*c&8kjM
ztOyd&w7EY_Upt;})0KK%+n_+r<+B3NHlo9cpZJzzkTb{@AGw6=Ku3ev4R!o;gp#Hl
ziF$QY^|d4pox$oVeItX?=j}4Q^0H?KnG!LVP@8SXv`oC*j@lp)MVMm<+1BhZAz@PQ
zbEqViquY?PzWTAxZF)wNnu+jS8MCwow#w#-X?WV1%An3`Y-RkzICgCQiH#@3gNH;8
zWa17hGCcF=GpE)*WGk%B_s~X9@S&uoMqX33RQFdF;fP4GmAHJl(O0=XClp34qwx7?
zj9ppx0Dbmr_pmd@6Xz@ZX9lu5HN4`N-=UjM*^I0u%n313Dwy7uygV**9)8vGS{-T1
zR->eHLKcBA)Elx|7jr>a#^*8$R$ma9c{2Dck0&LWcR|A5kUrYGI$5zQ`<V)kWtc{U
z4Q98Sg&*b4Tk2%=y<Pe?#)R+Y`TU^fAdxF+`^{~Pm0#`?6Wv0j9ZL;CEAqCl$(gcC
z9+A=k%@H&dJ7Zrwk%TQ+-`*O0Vyk6sdTQdmC-O^cxLR|tsCv*lXZuFZ`)Qfzi;wsP
z0~<RVnDPXNDGs%#z{wxpdbRhU-3#*5vD71-RGnUm@?U4}>$0xVpoYU53QOD5<9hE|
zTl&`wFoW47BUc+LS;@6|y?Sdt)}9)XldJA2Xq!vQBqYS(kpPcQev=@pa*~_ISmc_}
zCA@8dN#fM{w7%_f_&X=i?25ZkwqHKnk=4`7x3<#m%vEH(A{u9se~>rx?y?U^CGL-B
zGprq5p{l*p2AZ70KfJ$-TSkY>tA<6Y^EBx7<Xt_M&*j=R;yRc_lS)l>uV}?MPidb(
z#n?5M>*Vz*(;6L&m*X{&!#$RoJq`yu>`c^8t)gzVOLT?GFub)(pENONVvAnwrHh2W
zy>mWA_@!okEPRgb6W~Rs2y&8FC!Z-S{pvs}jKBJ_DTDX;Sg$y@1a9Lzw}_>R&BxH5
zafTwQRDNPPJI}0XB4&8&N|G5Tt2blvC+B>yF=>n~<_bEJSkd>UKa#?~(D@o|e(~%U
z4_CHiiIrf7uSp=wtSy;Nu?Kf1^T|oNJ2m4E{2J2rF7tHKka@j(%4;audiBN4I5|6I
zNwQLom<whPN>wkv4sS~`b-r9B7p8r>`mp&Io-F4VM%*y4H6QRD;E?D=^41P<u>fDK
zWh_3Yf8e|kTQASsul?_w3#t`66PD{ZkNbUfXKgO4;hh}5WVbP~aY{4dc1f4-<r4xT
zCjS*C;4l&L8!FJeZodspgu6%rjQ^($!B>@S04GGQM_3pTQ)2bTu++F>^t--NGU$k_
zP3*mU0v3xfpZKPqM}_QuQi?|sJ5>$1J@wXcU#W<i1$N)5TtIsVZXcw*-{20H;QcJH
zPM$GMqbqd4Rkl{2Y)Xk~zK->PVARUMORI|e!(`$(7jP=tUpMuTPZ@l~Y&Qm$=7bWO
z1y`dE(*b>Z3H6cU*F~rAObft55<|5VI!KRpwWz+~N#;w*B*{GM%KSclWpp8TD^M8`
z$YA9BO|LxfI|vd2|5!2j2p-SYyMIW4tp5@GDk6{oj*O9Pu&BeqwZ)Xva=$)u<yzOb
zT>BJF4hS~?iamDnb5(bI-?_P*#F{0MKeYq+rxoJ=QY%D(W(g`>G(zMB5VXK<x}e~P
zoXD5xt}TTux#5Bw#S=c=u^ShB<M^gCh~<px3+I-7)zmQ4d%U$y{F@eZSgY1j+D%Mt
zc3fM>#v==x{%lrb_DQw8h`q}DYClarlpC(#b~?COFewZ4>iQH?q(>dvR}(%>&582N
zlpfvmEjd|*C-<KXtM{YIxIlaE*ukjBq{C$lpNOz4d|xc7?G4!r%kC{^%*%CGRi)SE
z-|OyPyVpMSC?Gjim{J22UB2ne@!*bar8`}Cx5-)Q!r3{`1K)4bqStrb$iR2xXtg`t
z+pZUCrw)GsRC*yW*$@;wWyiXoTm{s#pbOf{bZG{CFYZwTT_$yPzYu@^EezRk0+#vU
zqRKa(u#yjRO|)<Gdt2pwnF_b41w4anEyrH-pP-(KSUhYgh^kuH-*eyPNQ)DB!UGDp
z+uCJ>1>ZYi710{~1q!ZYC@$cXLCK5oZ_^rY1$pM*qiq)&Y<fSo%yDR&Su_njIdC+N
zrY$H<Z|Ostd1uGglwpk%d<c2sNs3lf#Q;O=nUc0Nb*Ugy5{L8GIsE+ukCAnHd~Lys
zq|T^gUJQgjXsw77GdGW*IKk$&r%#5t5F)CZ1$`JFPqz*sUw_z!Jk&{@!>eyqhp(R`
z*^`TYJgAqAoX=u{uhfKLbr)Nlm=_VRSEa?gE$C*xHW4*V@o9z$!|aWfCLiN<x)j*n
zKJfKqN)y%96L|~NP%q#mLSdbCh6)$zu>55s4I91l_iEawHV}J7SvBt;dlI=N9@MMo
z0m~JVUSfGeetZ1bx0@pConhA(P9?E8eavL`TqZxI(SeE3J&22C=@6Dlz@=2+MRHqv
zmZ!-?&7+>=`6hFDm11wG61kO+WL(hgFhi!e2e1UbTYnp#*U`*twAQJut!lq{>O6ZA
z>ynMehmA6+vH0M5r<q}Lcl_n0xylaw(U$l&`OL!{XWP9mIav7Czn>tZxf4O#TD+;a
zbfBV&PxN46bKgV3fV&SL+WN7s7!uVP+gd$$^1|Lu={6r2=j>)x0GxqGzLa6JF<M-<
zU+L<Pjci(ut&Ipdrv%`F8(`k0R4B0xO(2rgN_iP?@oN1_#0`6Ula<)i`9Afz!HkDy
zZByQRgLC6#23E#8rh7^~`h^Bv++hzFTdQe#YhJD)k8WDo+ce(AQ0qU9)zn?Nc=^~$
ziSVb-rO*UpyP3)-hmNcf_)!xEnni4$lq^60u`ZhH8TTwm?o>$EOe`-G39xjOy|ndG
z(cK(*_uykyLw~<wMt88^H9tg4FysJTfgX{O5SMx_>TKkd<#JYSz2(X7uZVw$+%Fz<
z?0i-LyNI=?`jy$%qweO)IezZ^s--Mx577$`F{UOjKPe~sX~>23bLK2#;lrp<UX&Y*
z(usd~_*<HFMKE93U8*qk12^t`q@g&r<Slja{YTVcJW5nxNw4DFNdF14f}n@*4wr-_
z-@SjyPJzV)BGRPl(O^xp8O(8sL0Er-(V$ZMWJCjj$IX6TzR))*o`-l|AUXXWDGEn9
zG_*Xm=zgfvb2+E7W43Gda3&O0<Kd}(&(pJ?iY@7!_-%>qBt1C+^AcP2E}KhF?5LE#
ze&ue#^xKw{DHfx@Ju%J;le6zM^5v3b@Jt|ev8AHa=!z-dDSH2h4O@2KE0A&g_VhZR
z!Gx^*nCND`cbwQ(_ZsiRtDR=NGm5#rr!H+Zpc?8({PtRVv=@M`4kscX_q_3pINmn$
z!Jgr@1z*-TsrFontqaK`)}x}<G)fgiYos<ALPynAr)vTS!xN^<RMG<|hvw7F%ihhZ
zt={{MmJu;CiTXv$$fy_A1qEh{EyOltCOYT}{1i8EMVQD!i`KAi_XJ)qGwn;O8C9qz
zFY0MawUHE(tZ1_4AF{dMX%zq6&nohQp>0jX$1$ykue9B;MmLd~I=0_?5bCA!IC|gP
z!Wm2}Kly^o2fBQo{x+iRHUe>@9@S@SQ3J!AU|T+er|QQ~9mXaS)1Ld{?S3Rqv7m~P
z)Ca2LfdctXaF#S+9>eqy7N{1_R6Uz9oFjQc(gwEV0WG8~!{YB}@|Q0w=_*L(5BWFQ
zVC5lE{wJMhx>Z*XSVkdMwxMa-aSZ{}Q;)c#m)3;a4pn)N&&U9EWXix9)+JbN^AGZT
zGSESqWj=n4)j&>21tiSZ#$v4C%Fy@lM(7SQT3>PWoEK#x_oS+$r^>ndd3Uxd#jGlb
z&m$Zaycuq{RnET>(})_Bu&97xj<6BaI{ZxOr;V32Eqo6=#dTCW7oyNOr5>`H^R6~G
zxq+1u^g4?9fmh1Z%v!wafR1yVUL_w0ljI&7GvkKfgj$iTehBdmQ)r!+>NmoUvcz%O
zE^6qIp99+(e4@)*Z2u_>j_2Zjh&q;alES1OwbwV)M^AZP9tm2jwkOF?T9`a0<9h87
ziK%lPiM6w0Lf)e*)Aq@2KZAm3A8|5L)l#SazRXo&(8>;khXdBI;$*4#Cb*KD<R)^!
zlYB#lY^{-?HrR5*jbg*GY)7j{N&PdZ87Ed7uP1+boX8USIhIB8KvDz2)_WR}aC3jL
z|H*#adzh#BD>d+jnHEka^IA;@Z>e#1S~enSMjy$2u}RlgAjsF1VLTY+U)nmaCi5>%
zUw;b}8E(R@Bn;PT@Xz<`6x4R%6;;z8lL_LB+ebm>UnVi{QtF09-n#w%qTZgOBLx6b
za-Uc@3aoI!RJ(jaC_L>9<!^`r;b$tQ=xX#4vO9e^c(v<M6=rMtl$n{;1oU!7!*NQb
zCK3$p0iQt)tE=FVa+UkUpZgWkihX8<KDq<h!qWuauK<1Usjk8Gmtl^ur%^>Dewz29
z(z+0Ondb=Chb9M(A(!a(BJC`LvdOQN+fbed=)pM6L8G5k`Z9$^$(HwQ+rmZdjW5rm
z=KXPEv097exp!Wz_Dn2Og-RHn&x^XIhKy3Rxps?h#3m@60&&!n4ZEazc8OLGG`1@D
zaO*5g-Bor3NPo(Y3RxQ^L1pm1sqd83vBWijJ|g!jmPH=QR#ZOl8m)fwL5j6W?Qvi_
z(bm-zwgpc^Ji1zj&?d~kSF=o77Ae-Rm{dD~-5O`O&4e$F98Z6j+<4wN%@DW_DF~##
zqMZwO%A&d4>!v6jboy1SKAD96DHnTKeY7uUf6l3?V-6Qp@mKU_w1g=;uPLTU%r<_q
zq%Xb`kLz&Mr#-2biBh)!S@efsi@R#pOi~={oQ(K_q;Tmr^CrJU4}s4|0#WSp=3X&s
zBB9~Vwuc*Q<!&U2*jZ~kIA?j13y(VRE7s?j8HP0iDg@*!J}pj)SG&8u+zAurmYhf*
zkhoFAEFD)QbmeYl-m7fWLsE<B`>+o@TXg#@_l!V}=J481>NkfQ3<hN0FnrEsYOw|U
zE=RwV$x1>&IIZYHS0twQ_P(nFLdf|Db+wW&L7X3_Ij=aJ0v>=}TN1N!uZb9KYm+k`
z#ro2kKb}LbAk%JXT=vhas4hAmD`iIgil16%Wv(NwG|7hPQp`|h1=YwRHBNDC`q5Cn
z_X%#IP`YQ`!X#~=RfK3+eL{xb;b(FKK@-8Rs`R8mXs!FYa+jPZKY<#M6s;Upn&8^1
zk99C3S)(RcDf9hWlCT1iQ0Ha3)o<^T3f?5{!R@Ps5!$~@5;1yH5#?k1-N-vV@p`Q(
zw0zbDg8ARbCM|D%mr8>@@c84a6~L&SONl%CZR$Setk|RzCaPu{`egd@kd%b{MBSjt
z274@U;1vc_H4+4ONQ4(*x&8O48v*cS<j?l0S&iOjG95!V_yQIx`YiTRF{ALL2Hb{1
zl2GxVIxZy80ESc+(s=Ad(qu#L-V*wklSqWH0FyyH?z$jGeA+1z0?fW^m#QlX`ESy@
z-p3HNQWGL_wI0Hq*i->UQc$BCf@6+%W^Ddb{{DB%-G6@le^mbdYNG)v;PIPo+mKiW
z7D)zLgvEd^>6I|d9>nMq_~sZw8<84nha;^39u-J*)Jues0l+)Hlr5gbOGPy6dI6{<
z{2MurxNKP%hP6U&st!^hCP9_gcL>y_1Ac$6`?@42-l+jd#t@^{f_5IZbFAX+*vkq1
z_P5MS))9GCS#*tC9HC6;P`Qg80%&Q}HD3*3x{)X<tY`;39}7$5d+R)wE77hjR=ZiB
zEuEUmO*DFnV&CY29+1b#FOlJ&>Y*9P@d8p<c8gc=RZzjNT|_L^f41*XVXNm(lTWf(
zkh*;#{o|xx=X)M+J#Tql1v~BgtE*g27r;$6IW(OeD`?+z4am|M86T))%4#_8o5?n<
zcvqQ2u4?eOu=dD9X`4B#hn6N5tYJRAx5OVr-XS#?l|60v%)wtBKCI#dsG89lcquTH
z-k_HK`>?#%%2SwT|C%Oh+!@BdHLqMg(k2r2e6HtfHUBFo+ixf;lUsbRGo}yQ84hpW
zIKdSlK~a6xt59uEfdq|#0@*ELjgbth&Hmi=C57nD3Auc2IkVc=*_4x_61QvG!_PbV
zYr_|lN*TeC#<2}C6W}@k75+XX3N+P93>vg;?HLvhf_jb*<1ibPnbZ@Gt&w@9ejUBe
z{p2DqwJwaw44Y+3ehToeJmsdFlj>x%8J=#EA9i~_iB>A{o%g()qqd{{JjI%pu?O#C
zvI3OIiWcl&-&ewEkS)0_xg)-(XZcNjd`z5c%_rUi)-nr5^|}W({YT*L**f_zY)Q<h
zrk@wQXg>Q)U(mus!idFaXoNY^K1~46i4_m8a<KD~eD5>ebHj`()>m7*<`h?fetp(?
z1JP^wYOE1!iHLtW_BoNp{<7w=$t_k78V623d??~*GO7B={+Wlz^Vz%>DVjT}4+M3y
z%rd$f$Mkv>g1KZqXqz?{*qX&sUAYr+6ltpQ5zDw46n4)OYdiuwF+FJ9_QC78lIHx?
zfO}<cef{sh7Lz=`pA_0Fq!9^ZXa8a)DF|`bTT+fGJbCpX&E@_;Z?ENWX2`U%ve!A2
zbd=TLD^YIjwI#mS{O%v*W%dO2a_FR<Xwv@Bz{!5^i4yG%1{cG+(a{bKH<vS;HRU&T
zd!AS=9cxuSaPh*#OO6nhbM^kG>Suhro`wO4;P<Kb=M~vu=$CBnmn0WB^YC-$>haHa
zk329xUgjt}5!t}e$kBL~U%JX0B4HU_yh26q!2idk^ruO#Vf9V82><NPHuO{q`xP-8
zp@+o;<B7q#TM6T6F8i0?3UbXKP(7kU5JQ&R&?S5=V8x(95ks6<q`><Ux<Bkde>2Cl
zxEC<{-SK3w74lh6JuLd4yZ&|0`DcXxnN5G)o&Wb&4sGWuwe94w{ZR(#j>jW>9FI<E
zpUBJ9D$na^$maRFS7zGEUU)4-{*MRJpU&vUduRjyu*$0oTg}@LcchkQK4*4d+2@^|
z1atW}Hblgqx7ZAcO(5uD4F2v2KgMtl_<c#W<1>^m=kw0C=2w&;^M{Jh+|upr`BaT9
ziZ9v_dE6Ukc1<&{pW`k=Ao}!%<o~dNB;=rSZX!;q3gX#F)ND(jI%pexVE#db`-fXT
zORC1gVNl{6D(<pf*^E+c7f<6V(RMokSI+&^qmWgvko%ow7ImjOS71b~OpjDICdCm6
zg8;t$AotU3;h{CwXTb1+9+Dr=coGm*iC~tT6pC><T(e97JMunt_b%ze-!dq#2g+cj
zR)B2)5x+01Dc9<u{n!^=?*sSVK7h3JFc!GoG)A4YekFP@aN1nnhK`#9lEq%UjeX(P
zWZI@7U_VxYOyLGCD<kz+Md%y|0^7<an{gfb_<}=ZO`}Fzc->s06DK%}x$$q^JKKPx
zQ{YZg&dV7LGtpQ&95p88*B>ekE=oQD+&q;-elTSv{$QrHPnzUx{s)W0Gx$^5`<*1>
zb*561wa?6j6uf@FC6Qa$&Ex3WPp3cZt~>C7^#xWU8Q}hc_ulXboVcJUQ{XY(_3^w%
z_VrI~*_n)<-tO4T^JOrENeN>8`5TbyJom2<lnl0w+pAiXBjeIyXzuiWequv^bneqA
zPzN`fR(UHzHuSFX&EMryY%CPwpQt!@B}9ZQjsI80t+|wWBZdUmB95~rP%d0RC~FS~
z{Y?(=0oT(I@F|aCb8faRU5|5`%4Q}zWotMIPnts$6S1hjyipeNo_DJ;!mw*^wagrz
z=5z~szEnramqLI@(t2K#9K8FYrFS4{P8}b~DJEPy%vLHBkTN&M-$n0Xd?rrK<QI4R
z3q&jlIfm(pDr_khs<D1I-P$e2(YP+X)N^vf=o37>Ji<*`T}NTI<+%NzyZ7$~sZ{*H
z8!UZcL)v0YDO>QAV4&y-CDdaTBk<W1q;RT|PQFdHBJLe8?*N80AhoE79r!|Ns_+(-
z0i;h@9P@9C<?p@*JMLlkA;=G+Ih%SuTia7|lnXyK<N_$B!JV;2uRf^>7`B0Vgi~Cd
zp@QTm8nD;-i=djdm`0V27-eUBSTv(5p^h0n@3qMftM?Sgt#3o6Qky&I)sNXr3Hp;)
zz{JX<Y6&m(I+V=MeTk%SZ%mxJu~2}Il%+Cy1#$eux<v>mass|icvPv!;7j=GDb>QK
z0)FrT@?o;4YhUfbb!R-F=j_pkSy{6|%W{iObQ}2k$7huN5BgPR`>$GbdI%Swm~N64
zFyaB=x-*P*=3inF#bhfnvjBrc@nH#x^KVF#;!k(j<mA2R%Wh3a_Jg~qXuUZV2~7$S
zi5-|Lf)24w!ch*!zuvVcptuP6JhXhZ?-AkvqBnhC1w}a~5pNjPk<_fjZt3{GZ8Xp5
zv-F1f@_Ll20r`wCMy+6Nf0L<JtlEMf3`0Jl)wX)On`Kx^1@G9Q{8`1Zvf1Fl#rVFH
zC#;Sc`xcCj@p-zCwmYIbrq+AdrS=V3zqEMVkF2#^o6+(_)2W*2De9$h2cBnPocEbF
zxOe7mUGeL(7jljnUw{oyV8EQdIK9^y=^WXZ2Stz&@x$1OKh%B=5U4XCk0`6&(X_$(
z?<^F+S}Dz*FP?InFMz%Ku60{}y5+|KONXyA5-?&4x^8Jh44_O!9}^>CY5l_ejLIiT
zgqsUHCHH&}^Fn)3R6_JN#M<I|^3j{;pUfxHfi*kYvEnZn0^2UK{5xGJ0h5850s$ky
z>vm=w540Af#**TrolbrW5yiPgF)&L4>)2_6rHY$ui_(>v+(&8teEFu^Y!@sM{*~}Q
zm9T+3bGe{|ZZFrP2H<31OAMgXzq;9Z@2U);GgLrjxWr{~7wtZyOxDAH!=rpv2U6@b
z-v>jjK@`b{EL=d-D#a!6SN)s}%DGv!b}|g)TdXh?PgH?Ow{s@l+P57A;E3>RF@_;G
z3<-8}SrgZxEMiB5IYkTMDE<W&f@R-hQ}<~GY}%8Gx+TMU=wrEvEr5SDr-{+70)Z&i
z6fGI{nLdcY5tEX|1HbD6n)X(K%I}{45C2Z-Rie<Wf)ltR#N=uQe6a=_U~zaG>Yc#9
zdaz3VI%-+L7Pa*le26Js#4r-gHUN51=c8~GZA9|{|EB157km5pSfQARvi{*E%&?;Y
z=oC5fuolk(qKPx`nZyj80w4kK1wq4e5Ht`Z0L}m7d;Xh$^Z!Gk?qTjolK`Tl@KIGx
z722nX#HsEjHv`%yurq?Xpn0}a?D4vq(g(0$V4RvJs^YJNw;|f@*t9?SSmufn*v=zY
zFCQ{hpmZ_9gauYwc=_!SZ=$f?9AZGAKJf2unFRNs8^<9TFIR@@_dl6?!~}F|=g=@w
zlRI?;nsy{o_=CLGl`=b;1IDtbjTM2TTHgOSaBfO7x;<mp6LneUT4!b2S<WH2F=Y|H
zrx;IKexU5tM|_lqr#~S0VE*8ZO4cI#{b38l@Sq2@J59Ln6YH@6DrdzE5_gb_vwIAQ
z*9x|{;{(44_H5Rk^REhYPU1Hb2nJ5KUb<4{n+vTJ2~VV(uqz3dLoE7ag>gR_Fa-2;
zTx#G9_TW8q^G_I+U`w7EN#f(&NwUg{R{F(&`EHI`_PMC6|8!X(*N87yiR?t1fh&y!
zmC4^Ia*c?Xy^fNuc)D$9Yz<5_OIZ&_&tF$=WNG}UeqOA6m89uNMHeWb`4#%9U#v-D
zWnJN^|4Z8<_9vdng&IaTmc_52He0E#44%EZzJWnRo=g1^@I>#A99J*D!f4Y+0{hbH
z^!HX&yBp(981#2uR7A|z*uB1ZLi6H@Q);0KV=PDeKmls7vZ^F}9G12-OcM+5^M{c*
zGRo1Tb$%-M>7`A{JB4v@cIbst#4w`V<!;390mhlT`FB3>Ga>aWw<4p0AKVM38I^@L
zNMTJdLj0&=f1x`7x#0=|)Z^=3$O0PR`2PDY_Wgul4-(Qylh(RP<vALekTAqXWR>OI
z8oV|u8ksP-yq0+Xmsa}h%ESUQ%)p9m<=12)@N2(#E*e0N$H=D@mt!`_ayUz`xkT(l
zDWDVL4Pb7M*GeKK5;LerPx6~#SKROpZBH~y7k8?iDsyOz>UBRER+c8xM#_0RGtT*9
zWCCFD9ppIIQ~pedR@V1!pk(`F=rL&%sSV)YzFm*9N(T4&qKF<X+uYbBuw=X4wo*kl
zNH7Lozvk1<B>Gh^W4K=SnZ)tjA%rZ5_8e=N3>^YdiB;^sHFJa{c8ST?3QZ5~A&I6x
zNAn{tk^kdzBrM5@WX+*RWGY<;RChy*CY0|7$#(j(%8ls#qzlyN4pORgo;nUrS#qGG
zVg0v{RufQ?0`e!&MwFn{3$NXk|98ApqYI@b>T^?S`C<1OO$x|n<M^`#W-rd9e&KXY
zP=>by5z@)?Ch39Hng`EhX4$V^*H4bfnnpz96EL=caqe`)`gZKnsEJ5;-8yoEtcWv@
z#HDy=$bJ*;G04F_)=Q-i!LPaPOs4O1i0bgKnyj+xj+xui$*Tu3Za#2OW^9;gf_j+7
z7PT{HkQtjUE=$M0JJkMskIS2XA<Fy5_W$>2`TzFk|H$^g{x58TU+a9A-toWsh~8;A
zXY^f-(HyuE{8NqL`a6~oK=h7YlZx0DC|4sM|7Ro(hJbqeDWxT`L%dqkpAu<Z&(%H@
z)st=V%ZaaojO*<aR~D3I#duE)&xpacI{}Ko7QNd9_WSk*D)qz`0>}Y1=GObL#7{9!
zQVWt~Td{7Kal%20`-ES1k;hXKG!|U=MP~F}!n4aVTi&Un1)y}0rJ$`9&T7Igm`MYB
zDH!%z)zEP<W`(us=Fi*)(y$o1sY=qchANTz)y5-=)j6Rr*`GiTVYlEGUE&<lhJW?^
zgzI3~dWz#BEWqEg1|%D-kSPl@0_+@#cS7P_YDp6E)N8M44bd1%sGco>J?P3QqPBHn
z*P}b8)mMj!q_@`0C#ELhb*r)WfGG&)v`g7ANWl{S+Dh-2`?Z=@7ZdT98t913*)(*N
z5nA7306-r}Q?s!y31#9nEW~=Ea*D-vIu4nK46%w!h)MW@O>*mk!Sef}tU6W!)<vdh
zFhc!gHWr@>@E}85xU}9wJ`+aR*8WzQ?E5ZIa$FL!V{EfY{*qwjw{IRqG8W$q1{zn$
zI|!e4#d@Pzd$9)Z=0ON$KoCzbDG{S+d&dVYA1NXGo_n9|C3PwtGp`pjbp%J_YN7}8
zv4Q&&Tjdi=<?yerOn1-Q@!ygS-;KUvYNK*Zoy%)M6!wRlJyw-^@O1gCP*lQZ6EVAy
zx#0&X#3KFV<9^q@ls2%566PN*fI)kcAKW2esPebe;{l_4ZWJV4J_tYw{#CvP1JiwU
zE87q^B(>bg-kTHU+xE0=0&;o6OZ$^bGx^iL1t@hG=}s%xJNSNeF8C@Mg?o@%U;j9h
z(Yx9&Rx3{F!);gkr#wXTAlurVOe-42vWnl}zJ%y9hipUBah`0oitdgu8RJ$u*`(q!
z;rZfU5}3a~CV2_7=LcvJS6{VZkI=1{T3A3kw46}gV>lXl5aFHxj&ar9A^7c4zEbbW
zUc|K~1ULv$O+>YGP``f=o<e%0Z3O0yuIK&o)lT4uvnC04OBJwFSXo*?CV3z3!fUu%
zgMTJL_f9x~af^>^ntX)-(`AuuggBZ3Mh?R*1WJvNR)5}Edn|LgTYHreZ+ZVRaoC91
zl8Vt~uirTGe}Uf;{^o+=Add%72RQ21c8`0NBzL+oBuS<+us}z_CMG-X#|njpT2^1N
zSgdJrWwN_hE<z^W<$NxX4@AfW%Nw%Q#{d3kR8mwu&(A<%3vZnfBW4zro)nC%nEBfh
z{;uIAyG5=dIP~dOzN2WnU45iNX@)AHbrx7#)Q)h;WoX@aqt>F;L(Q9CNU0V+2b%iu
z9s__BAPZm{1wz=m-U>y1XUyL)+;^agDF;?;?df=EWQiGVi~QMX6O88`V`Cvr3MoSw
z<?}6xJ?Z5~%ERoUSe>}m*!N=_cY@Jfs8k<6f*8C8bXJ6r{V#MeU~x+RuSn|TpQANy
zM8MV^tg-*3-v2i#?mwyb?wTMxeowuRBO+AERl-2(9TE7J_kJC^!=|*2D41WjEbZFU
z8BE*qa{CE3lAU(4g=1R$`-MoRmxd9?QfpRYW<B~Ogq2}80!F5XrDnpQ1PPt3J>A=o
z1}uDL%=fHlkxb3V%?1l$>XmQzH*EU$eH8_`C?QXhPL8(lzajz+Md3fN9dNzu>EG;J
zq5xN13F&@A-`L?w6_Qmqbi^%_vgc1u3z2@(p<Pwhla@CUl07Y42#NmzD3B#ETjv>>
zayb_UP@ve=3l8z2<&c#wPnh1>aXu|4Bpd-md_SrZF}p1z{tWE)IJ=$Of#F#08!Hw1
zy3*J3(zEBB>x+FR<PnSt-wesmajIC`+1C4jofp9zBKn)x60C#)$X*b_AYIxVvDaZb
z<d2tO&7^Nsq*S`mwI>EL@~<Uni-ZTa`g`~eh`gk;e|+8H*}i+sMfyiqX|7;KefIU-
zIS^tNGUO@beQ*m=G&h(uyXV$_dwd3}h0NWQ5qSYY1T3?yY`SbF0S|~Bgzl2Bq&=xr
zf<zQoVE`df$ok1gBpq<Vfi9s65)8lCm^VTBz}`3VkQljvI1cb7e{O<=Ai_v$z79!n
zBIB{w+VW1@Bt%73*HrW+8uZIHoJGrq(Ev?-)+0d|YKPf_F5?z-vB%qzhHpe&q8NB?
z5C)(DD|wN>&oXzFqyG}U4Zw9%Mkz>5ivi$$8`^hxHkJzqw#su0yP;S;bZ*+!>+9o;
zahdfvwVV94(qz%}V6WF62>YTrx(H5}1CWMU7j#ET9Pilrm%u#X{jNI6mHueJF=hj|
zLNXGDH4dFpz6{2-izLU<s|@WVSC}6hPC@%QPX!S1hmj9@Y2pZ9y|3h?;+cJ-jZZOd
zJ6%sq#c|^dy`Uf?6%@77j#ye)Bpj^8uZ7G+KLtch$p3XxL9*<Bt3DQ^XxYjBRL*%{
z%WnW=8KaSvuO?$@<s3A|vkD}~SB3Qv{*w@M?VA^$5DN~@@EQOnJTUWx6)^&oiF_(d
zI0$YVfV^Gq;=Xq$gk_zhgFWJAr~Lys!+w)g|MH<MP#D6yVQlr*^wwHIbp%AL+Yo2Q
zcQdzWqR^0e0~wLVGe2quD$ef_=*hv*oliDCpDeW%jbIn9MeSuI%VNaGg0)AOHM>BC
z(l2|tcS%=GiAL!iehAKF^U!n+NqXshIDR7FIFHTl@URm&Sa4+TU<kSS<(uDmw2**r
z({NkT26cSvZhJdGn*CwU16G^rz=Ms~pr*LYbC-OcAGZqsO!%-rOv`QTWnE@H6cd=&
z7!MGtP_@CEViv}ykyAg_$F4Mr*E#(`k1Y{4)!M$A2i}0_C)D&Sm7saa$9e$H?JUpz
zQ#7~R*T*W!@M$@{qCOkRs>-k;_Spmo5O&b-vft5f-D`^}ux|f30T`z){PmyO@cm<w
zvxC2S{Aqh9{Qe)Y1pj{_<aGdoBHyvH<a{}}ydQy?M#Mo5bNRA8FS9@kr!OLGB>z)y
z1Cet9D=jhKT&W-Aw7cEpg;abn9X9PTXYR>+Kn=keI;whJa_68nZTB<?vEBWD0DAv|
AKL7v#

diff --git a/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/image--003.jpg b/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/image--003.jpg
deleted file mode 100644
index 8b4af612a79ba6c2bfdc55aab176ae5a990a247f..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 412866
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%0AyN
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

diff --git a/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/image--004.jpg b/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/image--004.jpg
deleted file mode 100644
index 44065ed5564274ec0ad77db51c496ec49d83ce73..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 66456
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

diff --git a/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/image--005.jpg b/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/image--005.jpg
deleted file mode 100644
index 4df316f9b67926e9af845e7edcecc4abea3f4edd..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 31764
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
Z<+_ZT;$rW6W9<K&+Vo#hqp1JP{|n<H45a`7

diff --git a/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/image--006.jpg b/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/image--006.jpg
deleted file mode 100644
index b566ff72cbd4fa26beb583d3b2b214f48ae42daf..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 112328
zcmd?R1zc54w=ljB=g=*o<UvURk#0C3(kKmz(%nddAP5SGG|~u22uMo`NJw{sbb}xr
zNBVpled>MheeS*g`~Twi{_gn9*=uI6nH96v%$nK5gZhe^1Beu4<YfQ|1OOtye*kJ8
zaF%wrGy{Np_W)J^0I&cUgc3jpArJ)+hfw_i%RpEF=+AmI00^`MV87wq2cMS-?Cocp
zUr)3&wBIq%8PcG?!)Pa$sHjaqP{qRD+1|;*-hqyXgA)+EBYzKe*&~>K!i+ybqG6hl
z@o?ZHY|R%te&guQGt>fMzPyx_zKWW%jJ%TcPeBNi4ILb8(1-xQ*3Q{cP4*7mgNHhF
zm`flxFyIQ<53QlGlY^v+iqd7DzdwKW|Hlt<^e6AY(5=h9{;2-10mLSzPR5|{Dj>R%
ziIcG{2$ul>?1iy|qcZ?t2!i$WZq5#u@M91rbp#m%VTViD{1^P<5;pn;$N$99P?G|2
z^1&g&Gc<HG2LOU9u%6D<*c|MK;427o+L>6|0RSNu2#XtA7@B~v90;@9+S*^jARfSC
z^p}3j{{kBt8vW6yp`rO7@Gn`wmLTD~mQD^fh8{l)|2uzdZCpTo{Y*^YFP?>?oErEf
z1@-pT+FtPz#slFEJEQx`APkNn<j4|~=ogHJW8osF3Bn*g8nv;L6sSvp9E3Sd4DTv}
zFf|Cv*xB5_9Pi6|BQr}Gc@PFI1kK&jSzZH#FWUy0I!UX8FxWp@vZKA)Z?w>o%^am9
ze`{N4=m<i;@S9z%H81Ng`~PZTD*t=`2c8xh+F(7%GZe?wQtQ$q2tb(J$y)uAACLzq
zgQtbmW&KYaM;EnA{u#h}VN*NVJ0J}51JyHgl)04s65r9*350&~1`V>Xl)r2X@(E3J
zw$Qj7<I8^XjSYYDe+`7IOzk9p(+O11)ak(`Z$ITSF}*7d!l3NXep5Tm-{ghPIXK_B
zq;=VL&%x%WZ-DqP98(+F%laE2Ozq^V{##p^xU-|iWj)9z?7oAu%B2oLK4C^yh6<N<
z5Ap+Z2b2IQ;4VN1xPaLRum`LF%ifL34Y2g<jSOH2I0EK?DRAqzn%`S!|9oQy{;C6>
zz$Rb^;yC@$?#|D*rhqG0fBr}9ueP@Uv!8EWf3~m&RzM22fFfW6mR&&D6m0W5H7#HX
ztg-x~{5y4HkXIWpU%vadb&{Y|N+8usESKN=r6c?u6GIx~E`}V248~0uB}^P90#gEi
zCBV!L6NCx<&h4N0=qu<0=nLp0=yT}f`j&o<zhnH~A8-$t1L^$Il_{vlzsL+@0(<3y
z-GPaL{eykO$YGSgEf_CINfL$tY4d@#Qol)aDgE!7|EpAg$N>DQ_22NYIkC~OuVPDJ
zv;1>Q0#*XPKRCS9=`Vf!(%LUxjsDQ<?;QMF`hUK$1WZ6a6@TOP4@_tfv=rI~ZG?6}
zYoV0@9kd==1?`4@zJ!0HFY|L0&HtdL_H&G_!I8221Lt>n4Z)gAnwNIq#F@vr#(DOu
z7iUv<XV7i|DSHPGM@w@HXF5r6<~OC2w=?Eor{m`2<^+Jtb>tEU0QSj$t`89M&Oht?
z!FfmQ4GM*-{j*L<2ms0|003w0&pKvs9>)jk+Fu#FIJ*Ao4|e%L2XFvF(4!~-T7Vv4
z0p;Na_yG|>0+0q20A)Y}cnIi$R%Zd)vm@XJcmdCW0N^#a(#8OZKq`;{<NyW0N1zg@
z1sZ`?pbO{+Mu17sdX|Cjzz%=}P9YEoCIlZs0-=DwA&d|<2scC!A`X#;C_&U94<QB+
zbBG<p1>yzqhrEVFK@uVFAi0nd$R|i6qysVl8Hdb6)*yS36Er9q9vUec4H^^LZ8SkN
zNi;<?4K!UebF?RDo@g)7!qDQ;($VtKD$p9yy3j_@=Fq;Q9YO&pE|eU49eN8Y2$g~=
zLv^5LP)F!9XfQMunhq_5R)ga_1f7F!K#yS<FcKIY>=tOjaxhJpG3*KK87u^r2+M(0
zz?xx0uzA=H>;fGhof@4DT^L;+{Q<f;x*K``dMx^T^m6nT(3_Ugkr)^l<QU8t0-!fO
z#IVA6iV=eG7NZEG0b>AT5#taO6O#gy4O0wL8PgEc88ZMg0W%-79&-?L8S@AW7YmNX
zjU|JngJp;1hZT$U0jmyc5Nj3d6q^W}5nC8r8QTQg13Mf$6T2F_4|^H=6o(jx8Al99
z1IG&IIZixIAx;a<6wW>_F76FnAzW2lOI%;vc-&&#cHDW~W4tSPtaws*kMUga!tk>3
z8t}&P_VMxYneZj>b?}|>!|-$QoA77wj|fNzI0)nkObC1kk_ajY1_`zZu?ZOoB?<Ki
zJqcq8O9}f3H;Ax_n24l^42hl*B@ulh8Y4O+CL!h`RwlM34k7+P+(G>93g#82E7Dg?
zuDrOCai!_XA_<g)o<xeon8cqXlca@YnG}PRnN*(Ciu5&U0ckJk4%rnlUNS8*cd{h1
z&t!AtP;w@6d2$=_aPp7jqvR)7X|76MHNE=kYT?zvt3R$$U6Z(GdM)@`(Y29lClquP
z(iGMdkrb5_)08kuR!UV$H_8;s7Rn7OQYsNDW2#`Pk5m)XXw<CKYSd4uGpM_%4{2y=
zWN92|5@?!eHfYIdC1|Z^-_X|4uE9y*;&4m&8+bi@osNu7lFo)Mp01g0=Q{Oux$7?1
z-(By$etLuXhUN{w8$~y!>2c@<>CNch(0`%dVSqE-WAI|gW0+vXW)x(!V2opIWBkFy
z%%sf}$W+Pnjrkh0JhLZr9`h6nJ_~~72}?T5@J)=Hf;X*izP;JcipI*vYQdVs+Q){*
z#?NNS_Lgmc9i3f>-Htt-ee4$AEy-K1xAJbybC7c=arkjma%|mZxUF+L@^;(p3r;>x
z8_rD5Nv<ng3S53%)m(ertlY-jN!-Ic_&hQ^K0H-CyS!|?ro1V<U-?M*?(qfkec?Oj
z7vOi~FXUenU=T16NER3qBo$N<3=wP>LKnIt<RerobS%s->@56Icw6L_h_%QEk#C~R
zqNbvmqKjfT#0<sWiOq@Ai5rNgiO(UfBMcGghy@9H2@{F;604FoC9Nd$CAaQy-f_HB
ze&>gju#~q{!(HfI*}K7ad!?^PYf2|d&&b@6F_+1c*^%XweJa}^hc2fm7b!O;Pa|(E
zpDVwkAfVu_(5#53sIHi(xS+(U<fv4A5AB}9z36*W_Zjco-LF&zl;xG9m8VshRi3ES
zsA8z9s3xhdsBx)zskNz-sOzhLP)BOq(FoU=)MU|g(fp!CsP$MYSL=uNUF|6Cxd*o&
zct7ZRNcqt6VU-T1j+V}Qox?}ck76DzKjwQJ@OV_0S=U{+LyuC=M(?vep}wJhsR6oy
zw!sI3Gec#=bi+d<d81^b9b+luIOFdo5+-j<)=b4rqfA%L#LS}1zL|@eN1Lx%AS_}n
zHY}wq6D@bG<g8MyepoA8XIrCev~7xPv1|=&KiOTev$kutr?q#tA8=rE2ymEtBK#!g
z$&RC<<9jEFlde;hGbtFbce}8-ymXm&6?aW?J#y1>D|IJ!w{!3IVD)(AvFa(~ne`O*
z)cENauj^jVz2?0oz27~9JTrRs#fRSKh0n6DtZ&Y9oaffhd;B>4qWlj0wf(DK(7f<{
zvG`K<WnKV5fMdW|ph#e95G=?tsP`4mtAtk<!6w0-uQ^}GzCH^v4(SZ#3XKm%g_(u*
zhVzG~L|{bNMT|xwB6FgMqdcP)qwhsmyrFv&{N^A=Kc*v=H#Rj6C(b2qE?z0VDuE#(
zBH=92B5@??PEt`ab@Hp^A8$?G4yH(?6sFRozD_+!vrPN?PWD|zI#YUV21bT!#!9AE
zW?PnER_=Ss_pjfdXWM1Z<*4N}=L+QJexUvko`;s_lDC%sIKRK(Zb4Pyt-^Oj<VCNG
zfnt~9^%8@U(T|EBzmy7=7M3xVC6|+w2UkEUJSui7Eh^`#9##!}Quy?xTBN$XhNC9C
z_Ihp7XR^=XbvSh|>QMEb^@j}(4I7Q-jf-FOzf3kgXc}%-ZSHMRY-w+mX>DqgY^!e<
zYp?AP?)cOx*jd@d-&N7g*InMj*Hhlh-&@fq&{x$j)L%UyI#4%=7;GH6JJdQXKioBP
ze`H`(bM))j<FUD~CSSje+l=o{xK5l-`c9!w1y2)A$IejCq|e@*Et=z>`#gVlzI#D^
zVRF%U@%xg~(%JHh75tUhRrqS|H|}q>Ycgy7>yOr#zdL+C-3Ztu-b~(N*(%$X*zVqW
zu(Q1DxQp5g*{9ggKHxq0a;S1RgS17S{s=yzILbK|JZ?MDK3P3=JHtGSKfifieW7?U
zg|bDV91I-|f5rk(@E6St+=1_9gK@$`03hiH<A+DT_IW=sAiwseAPo5}UsnGU{A(|G
z`2vg~fI{$b8Lmq;06;OAnIyoz!SZFOt|0-S@$meS!J5nDWX8k&6M*13f}zO~3bjuI
z0GQPPaPEjgoxVk(&NIQi!Z-jlJo&Z1yu`*J0)RB$OK6bX-S_hO*Mw>Sh_TR4&>5hR
z8vq(H1WF7+H3M*vcXTi?0n_iu5Hu(Z9Rm{!8wVFeC?^8YAW$e842q6^c_;w!2HyiP
zV)QH5xg;@2R1Gn2JR#+N9{CQ7{!U3FncBb(1CNoTA2ts8)oT=#j7-cdH(7c4_yq)o
zgr)9E%gD;fE2wK|YH5QZnX!qfnYo3fm6NlJtDC!rr~iwW0f9lUf}^6}#KgwMCnTn4
zWM;k3&dL4ov9zqbqO$5!^_QmRme#iRj?TfM;gQj?uj3Q*3yVw3E34nu)_3>z4-Sz(
zj*d?*<$?gvUt;|s*+0oe49bNDgF#`KmvTYS+`tSahM`~Q!nh)-ifQ<S<OcV1EYdrX
z?@Ai6>3P(4$c!8ZaL5^W=NWe|Mf)k)e@!sI|CVHb2==F3lVJFa_A^1z(4gp0C=?w7
z9ZVQlV6=sSfrW$hGvWM}@O~zO%S8A`LV=w?z&>Cw7$*215iT|^(f{X!ng)+^)KL=v
z9uxu^6O<T007sL}K6?~ZD8Sd}8(ImQ{a;HgKzi{1gj{KA=#kTD`0-ViscyII^j%E!
zw_#{GeeBJUseW{YvGPIPxksCKluI7gxyr3Kca_b@GQzzB2p!VqcsOKi><7yVZ9A>p
z^k+>B?comX1?8D`so#lM8qpsU$w-e3|0pf*>9UX91<#wV0T5qs`+u46R4|gOGqrZb
zQX;Q3QQeez`-bY3MhJBYJ3Z_QPFqOsM9WFC0!tcNaEZ00i?{H^_?;gl;;xxix?vdi
zfu%XT(fY`Ywc6>9^9)DC@*8Fw9B*2^B0o+oE<XY-9iZ!DaqX}v=lI>hkA*ArTj@~0
z-ZqGad8`qzWvza};OTZQoeke^u|XVA==-ApC1mjhm&Ufs)2^>CbJ_4e@Gtva|41j%
zAR;?sAUM;K9F}j*?R$IHDsCdI(T&6SwfJKzG-=umyKze3b+XAEUWzi`o&UX-0!8)z
z54X&+jj~U63j%72WLY08hS<CBY_&;i;%&*u++nkAzvb(sjVMnWs?$XisC@GTSz(Oy
z|6XcG&S*n`@xZapP)!<uk8@hi^4HT(b_$)|$UT)jn61IRQbEYfE@;o5i;+9CUU~Hi
zuH1;N%}C{~TIt%fqt*=`E;Atn&y^<)A`(#UV1OmP5(ShD-9KLq!kvWASL)VV7zs7y
z3cZxOV5V3ilci|DU{F;Q&4pnN%G0B3swnc1_yW{X%94+K#z%F`g%^dA%FFPQ+Kg8|
zP2Di?d6CC2iI*Fp<oMk&Q`tI8rh<Gci>iyE>qev>!<)12YsQYDB~jc&l+9`QPYbNp
z-6=b#)j9`utFJ*cZKy*x<UKe&sKzT+mm3y7vZVXs{2#~&)WH8#qnmtvud@6V$6*2`
zL!^`}p0ti7go5fhqFRkB&_EvcbF57Z@_&>Tlz-fg+@Asf3WjKKDwAjM1sIaG>U!7|
z7Ur0;UCvuv$#;>g8#OvI-!BTjgrHG0(rH(ZGDl$)m%>d-1ZmZbIUw!aRX}IMe(c;8
z*O%0I!9e9xA8`6*`WypJzaI#}>G!&-3^@Jbq(Q!FDzNE|Nmr+!f37n5Smw2v=&1P!
z6Vu37Pl=YG#rD&2u}~Ub@Z{^eF*g(ow4{qGT?pz7m>!ab_)|-*7&M7I*bIsEn;TA@
zsHpbode^wzj#yr?5j{SX{Bh&kHCy!IgNWef*oWpZt8XXd8H~ES<;{#7<(Z@8*Dav-
zr%oIC9R7qzpL71{x+N4a`Iuv7@rPA{dcgE(@&5ti`>R1CP=o)|4DoN4xqfudp^t;N
zZyO0nu=D3k>Ui95e-34^LwNYE8U;8C-^@!j8$75##)4N&6L`hzD&bDqC*a!sxZ8$#
zZdA<5y=`CUf_=A=J@dn+ru2gWZJ{se=$aG^5kLpSAwxe#HZn9ep*5h;Y}-lr{qB^9
zoB&old;zZ~0_UTN|10*7eQbRqWl?f13Gq?g%}Y_r4AH~GF3;K&>xSKu<VvX@>@yf$
zVfkThcTD}_@gkJLWJf3shb-GPQ%|qi&i8?>YDL-J+ekDFxv6LSklq%&C1-VQfi)d%
z{$)OqqV12ImElz;S`&i;%7;Ou27ZND^c={GebqPjp0X)))@Z=1g9z@VhoGybkV!y`
z)9{tc*Cw>PvTx`=c1v;p7%U5uCb^QIoth}!0W%~HxGz02J#w(=@|0&v>1b+?%T@3i
z1#`47m*zJxhPaF){?BGY)X@JRi!J)PR;hhD!#EBT<WXt}O2-uBXrMO7ghsW!gw1IM
zP8@8qEe}QBE)?k#eJD-ucjMJ7E%m;h8%utiK}`&3f@LoQ7(R`fSzpUi87PX?vs4MA
z<Yko9lkM(K3)y6sB%>M4tHbzM{G5IB5tZNBpd6%qp8>(+49l5F@-^@sHTl>jS|qv!
zF1qAqM&P0wB`+GKtgfarp{swtqC(|!bKl!s$~fca(Y`{0P+o{$!T19`EADukbjyd@
zPQ*V{A&ut7z8`qHxBxf4TqOQ&<yFn9Q>BcH2Rg!)=ZE5yT#YcBE9Nn_0br2uBd!Ej
zO^ZsywhJa@BJteUHN3Xr$>-NXG!OdG`{-qdJZhp(WtM!pSnhu%JrVt^4>QO&hEeC2
zr+R<Tw-Q00`V_`~{3HjP^l3?ri3J+RlW1RV577~v|Es$SC~Ej$(KZJMd2NlGDMNH*
z{Efx4yv4UUW+s>t&A(<PS<$gOq(wh(fE~Om=CLR$J-dBMbf!FlUeFh8pYM#tIJ+ua
zJ3TE`>7XAadS@~S^VN}h^gdeocH->~`<<pc8gV*Lr(NwC7+&+%DPiad$h`*SuSPf&
z(EAb)$YE4{FkX`_ILFTjj7HpIDH?t&g|s^o!|<vn+(ZGDH5n+N+`9L$$QK3RMNt@4
z3?@z|$PvVm#NLs`6R6>kRgI9%;Un(OtqZXyWO(MSsxRjrJ@+ihDyi(=9TOM)m@1t4
z@SV_h5{pAY`)ul?fXaDqeaVQ|U;Ske%lYPxuG@{&$&MJx3hUW=+~WzI_;yais?s(R
zs?wyu-)HNIwMTQ0CXWYuM@q{odl-DF;T&B10(YP^xm9Ew_<)%-X=!JKL?}ZPr=}*X
zluHnRbTAx{RU)ZqZm*2!_f{((J4rm#f;WjQyCNCYom{lIDsKq6xCAg)47>x~RPCcc
z{H2>}$wDOclsiA9h1lUq@V%0_x?Rqecm9ga#*aG4Q0=ZNG~|WaeV*sh9mZW(9IZ0{
zCOH1;V{}};R$qz&*21QLFkg(Dx*`#^CY{NJTQStt)lDRm7X9TRYPk=ox^MI5$g<J<
zrWG+SYpTcyV9-$l(Wk6q%E#p$XP+?7YNP^F#lxO0>EgU?u1+b5)Z8k6we&ony=|QR
zKIWVFE?-ByLV&wibh!%l_MI&B#$`<Ze?Ox}{?**?$M*RCoGA)uoh7|z&Di(V`4)3$
zv}%=Fo$I)wO)!~Ica)6{7rF{s8?%+DMoxNiR`DYFbR=_w&-h{sg1Ve4uq^46Ub3Wf
z%1Z67sVe_eK9}q#(GCJh!z!3mtPo4lDP*T_&b+DbrK>fjzjM%hwMDa&Uf1bl$8#(y
zuby^ouDokQHin-x$fn#8O_Wz(@+!jd-K{#s5K2Rf#Eme6P0e0;hNV(2#)SA-GsgHR
z`J#t|WhI=jFt(K^@oO5c-#j&Pa+0YNMYvaO9X$(UjnyOd<$a7Bj2p>TY1xL1D`jp}
z4Ou%$Ga$tuj2RMd6<r&9%(0G~C0B?n-Pad63O+!a8q?&x+s8eY1?O|m4x+ige(=`w
z$ZKjW#JVzLWu+!9grV>Hm|<l_WY#PGuz8=fe8DAo6?uxOg8tx|1*$YDCq1Dj3kjlP
z?&hp!<;JI9+aCLPIGsuDi4h3W54{s870MzRwa8hBWebXOr!fhW#>>wnGo`2V6Qm0Z
z$Slm@{P#|t@?5n9gkQX8GgZ@c;}K!E$V)bT+xa0R0>WStAsoS`ek$ChwEEbb$F<^l
zwEKqFn8*ty!krki_Ukd+*x66>X7rkG$%9c@B|9-b7?nXL#P=bsNcJTcV~MMxn{0~5
zwgY@@@A{G_>v})8wvTJR4W#baOVMa;!gJ&(+$zep&KplzFmGLrd|lGe&>@-(39h$J
zpH@bjnc{w^BktNG#9H9*Um|gvi4fDMV(RQG^+<T-nx_w?X8nXId~arxtbRM5dms!O
z(<54xdxIB3t;3LeMc3-%t(P@9F8dJf_Dqv&3veC`iitKGlaQ+znHQt}_m7>iW@c2|
zCdR`j2n&0v9>f$2QW$m~zmzBYoA}iEKbR-~qdD|{%R2~a^k2%?p|Wy=_J^A~T~dST
z``a!Qixqxiok`0HemAy^NKJz%7$8#%^^W2s?j$ltnsZ%n42wPQcea)CVqG#NpS$;{
zYYVULXu?V~G}U@4nfLvXVmng;b%MjS`i{hLk`=^FaW0W|w*}~2aQ8k2MQPf$`8D_|
zvz@48yoX@AxO=>{?uss%4tN>IwMnTvXh*^KJ&|TZ1Ypqasz{s*$8>Q<&TtXko-LwP
z5l$HuPmMj9Vd*Nx!`a!UagV)1qZ+{GKYVe${*8wG$ymTqYHI;M3P?qST3X7ln_tV>
zFgvP$tmW3^Io6wUW90d*eXYKrGZ_=J<Gg0RX=}zhtIaH>UNvr)Y2|INk;Uqjbb>8w
zeVvignw6p(qlYSPPP!4VLK6C{PXa(+#$9+lr@3eSX{=oNbC0|7D;Ms`2!8p(^(WlX
zV(N3Luc7zc=0!dU$EJ)uK>_uVA*n~#G~u&Mb+3y0bm=u~`wta$^%^Vstmz^>=%`(^
zCL~##0w|WQupMCZZq2Hc`dtj1wR0FhG`1oBL~W<;@5fE}M3+fA@vqx#*6Em+D;YNf
zI+<c(+_>N_MAYQ2f;btXr9_xcI;p#CgFb5~$B1eE0q`ulu6D!x{LK_%Ih|I5ZQ|R0
z2ioim{Nsb<RKDFfU@j;k!qmY1%MLbGaF}%X=8K_vxA`4p+fgBv{lv8}?hp(^HN;B-
zkLzz+x$fN<=IiQ!v+mhWb$3U~1XZcV8s!8FYEnbKgncRWX%4@S0&>b0&yNZMFZ|hd
zeAZG%;jJuC@wWRZr%y8&R9eEhA3nIj<TSPS2#ENAOGGdtSU`x79da)V{~0zv3;@IC
zOkI7L32z{bnpg8b37dfu7Z<UOO()06B`@$A3<dxgp#MBg2B2hm|HT8?%;|f^s#nvn
zD^;sYXON@x6_&2>AMzI(vzz#$D4?qsF^4Zf`6yQ)xaaiQTNHpm94-31gxd}ItgfN}
zYWtlu{96m53#HGd-=l!Oz6-(GdD+Rb+2dmr&_;E}0+n_9%(45h{!jdj%?bOnGZe5G
zdO-@wsF{g#&!4Tdtl!^90bv41s>n@&i)TK&ttjv&&)^Kp44c4T@V#s9fhL`L_N4xc
zFR$Cv!R^0oIxxL0v+db?>YDU-EFUKQg_QW8+)Gf3eEv4Q{c!egSk9_dt<|#si->=r
z0a)6TCVl=c@*lBG_P2B&tqD9Gb^Gu2Tp4^hKz}1G&CEefi`n^~$_xKf;VKxhyE1=2
zK>x9{TNy59=k=Fk5`H-*&wWg$7$(C{Gr>;RRh%@8tHPvCE2hJ(im7-ZVx--P+!j#O
z*uU0-a3FxR8L};d2MkyRsTT6pyfSwse(53?-w;{4_W&(qQ4s0@xG;Y+87(=}+)w=y
zDIU7Bdgo)6DZ8O%z@XgZ6MChLWJj`A@BPu5){!S5PRz*4_$;PLxQ6)k3GqX<s$Ery
zXP$ex<spQhA6!iw!(7Q9;XV$R9j?`xRPNI=%s)!5+fMmpE2Sfd;PXJ{=9|0qJd#Nu
zkO?R++M3?ij{Yt@>gF{({Yb0#nbkgxzQ*a)m=c}oO``9@t!`c;ODCg6KkBS%@~wQH
zChpnVYqV}B)?A13cYFIhY_LzP4cl8Te9xgwlc)Hg-ue{|w9T`rFei_KpA2c<c&>e_
z+<+|Mk=uJ9&sbBMyo%}hQi$0q<3m_{E6_l;`_}u>4z0zbFJq(Y>!ymWW=f%rI=nb?
z>kw9lr*kKoSjdx~^L2s9E!KrCdN=x81&I}-Rc{2|z$qqUwAkC|msRcy(OWP8W?Co!
zsYL14Q`C;!3wzf7;aR`8z}A=M0{@OK0;(=n$?O(yvdmoT`F5R0fd+X`7!0O(xaMS@
zzcr>?w0ztV88JumE_M9G6`Y=~C+KcrK6)UoEj6V`kCxL!H?P?%sf9HRp_<nJev39P
zTZi?!ZHKKj)s^nF<mi35CH&^AW)s-B&s*e|EKckN9DOXN!jDa{C(%-6<MQT0$U+SK
zV`B5Bt+mw~Mzz*swZcRD8*uUrmh6obJN(;cdMXhdm}HR>ly23ZmpASV#{`T}IW`iF
z6VVyaWNdR%+Z*-DYVjrfhr88(jI>lNGR0WXt_tR#1|BN}e`3>83XM%8a85qV{CBo$
zhj7BPo1-q?7zi?}lb3OU&X!*@1t?#<M~KDcyd--#OIy{Z=gue9q6Z0YO4QI9NewD1
zaGZGfLd3@0EP)~>{_3lNhuSzEhYO#Xkum1wyJoM`CeNzv5;Aod(+R7H{9~cB0Lg|J
z+o}S<QdB02K5yMewr)A!N9KhXEEBt`R-V)uLHAlED5y*JMuI6%N&C`f+q0NueQf7?
zY~{IBTI)Kt!PfVQceSqEP1}gL8q=s5{Q;AXEwXoNF<AxEPgP&NG1r~y@sTc~S<JW*
zNu+P#8DH*)OEikye?^au-agg6p1H+9T>-SC=e;?4h4HG$i+iUpeB;1c?5b)_b#-Y~
z*cTqWE9{RmJUj&H2tIXm^ceu61i`1yXF@38h47-(&SCh=GF@ZkC@i>U?XVr)qg;lh
zguCJ<?YpeErzUC-SL?Co`k+VLeG5flqKKR?)rGIJEZv40Bp*_!D%pgDIEuE&&<PX(
zUNzF5@w@D_OuP5rB*Oh{Xl{A6&kYr1B!u=Zi-`Ak&Y0u}t}rk661ewx_Psje;(xc3
z+N?7RLhs#uwEOLD;n!HEvy4Z1z?7*wsKaD<BI_~tcp-alpPC?`F4@I{_I77d@4kvx
zT9ZxZU)2u9>!WTUo6l(VXoH39ChiKKLfd8t`azU4k@~SSRpT@r$@xjrNTz+-wKzLP
z=_@y<gc^<mc_I5(gU@aj9<e>H+W8SwaMAPB-cS2_OiX}gOdyQ-0y8;ym2E>;KySyq
zB|JEVVYq06a{JC;t%&fW;}4<>6*UO2nyM>aJ!L5g6kBZmJ7fX=yFP759g}MGl+cWC
z$e}5*&j}VwRl)4G^4YFkTt*P5%8-L~K-@LGu43%$2A@65J#4jw7T$j*;*r%{DQr`1
zvSaTZdfIOKAj^qKJ%fnAhZS7uDUR+8HG7&ruT`9zyat{l%`?2>U7LUDn!c`5AKU!=
zhgWw1w4X$RR(*b(P;o)1=z1`6w0&Hs%lY0^ol1msNE=1tG`;z<-r4@+b8mCgc@zNC
z^SZn17Ld<7>9HZoHD6Oj@9591rvoE&m^~QkX6O0FCIVvlW|bdV+ArF&$qbcGTWi%s
zU5nF<Wvr;I2xM)R<&Dg1?-gE}bA~4Sg2V0olKF+`RqI`WFRmwrNyhesuWd{!>ONLR
zG6xKvKbLk_D1AA#%<tPqA;=fGQ#4=acVbqVar9+Sh|k+<>$~)jl7BphEnSp6<74og
ztVHr~anx5_BmJ}4zVy%m;S1O5m*?p;#?3k*ewZ%D3#BDgCX*=|Wj+4u<h6<a=4&SV
zL=^Mmrzn7RebIZQV*&*f>9-wgOWMsGK=Q8{#oc&^-@>sD{EK}fhaQl8k-cE)fnGEs
z>rZZ4E2y`a94VoI7OFI#ui|4UK>C)Yf_qVFTyyVXNt|OFX5vbbZm~zfY3$q>kLMKS
z6N(P2D*~d4b1paGDb|(4R0R&g3Ez9HNp4aT<kIi=coY`UgC`X4)<Z{YCpE>a-@|Ba
z^W|m*_?D`_S5PG$iW!`*@9DZ!S*<@$SS@tiP%hw)sZLaw>Sp`4J$`y&Jd6B(dAPYs
zc_M;*h63V$oL8fOO&#DwIRD>2Tj$Frk0Yy<_sHukZtbKo(85^Iq^HM$Vl~2u28~(W
zSe^yyX~fukc^ojnn>+HT>yF;j$i~nKeiv>6?rR%ChQUCaHDG1~ULWB=1Fw%vX@l2C
zj0(HJ>m&8+Q!EYFldquHOj@V%>bh508awNjOmfT$vIt=>N1@lcBRI5uCGVQ{vijJ0
zzh3S)yy!y#?<Xs#Qcta4PEI}BRA+UVtR6)NY`Y3NBgG11D8D|ceq+xb%^oa+6{Wt<
zX&Bnc-zwKGVSVMlxNZ3Bc}%9*O-n)rAVWZ*&FOUH%-YB<rf)_>M&Ml|DI`YPV+^^K
zhXTY<!0reb)gvlh^pCf}V87@{1v7m>&*i-41GsbWIdk#(623XDeF2*JVjj3R_*SO<
z*2iwWet#AP(CF`EoVsbEfD{yPw2lH^0-m?XR`n;Vi_U(48x8F<mW$~TpVj&c;re+A
z+SmUf&96Q?sqTbr&nO1V5U=`YCe{<F?@WxTmuN(E*wwo*hqm|5G+%M*qYzrQKO_tg
zr%h6--7#7he*ez&DSG$E*?g6T-8+icVj0+<xlYC!H(Y}z9w+?+Z}7jc1>I)T4+f<!
ztACZZD?U2=u%@mqGGwRQ@WE!R23NZ}tSlZAD>DaL4`|1IyWrfZ3>4*A?8ANFUATUm
zs36moyH@obu05Lwg>S@WyQuAS%283A&z~Ap{fqK^#Uo30Q{rrQQq^`CB9-j7`2>qp
zzZ6B$%Y7lbzd2djZ%aQDs@>|T`{PRwNyDx*XZ?_UA%}^p=AMFrxJo9Mk+);o)3Kh}
zzi|H-rNZ^rQ@D@Zc5#}Ns&}`MVM#@n6$2CUPR7*gEpDXxPu?;(voQ%r$RQ%G&EV{&
zzNjTzAiOg5u*I7rA$Lu{(>pu9grYh6#l)a*=R3!25qUaefBjo1;BUv*n{g+pwc7l-
zmnu_M{$vkd%yK5uvHTO7d#nRy0<jJLBDJF+Q_WNOH7}MyFZu-^G|MJ!{^|uuy1JO_
zmUzfPkI3w({CDalwoAze)Y`3oBNgpyy?49t)@tq78(z$|?^}59rF}zAc&(Uf;<MA^
zsax}F_b0=xj`RM0eAnOsv^;}nWKRpH)=TcOt|yAkq!PW<42oT}8=OpV$gu375O4i>
zL31>*3a&rFwr5g!xNcYSnx5FL;__YzEqsAojPRCdrw`t_{TJi^i`}OYzUTXTfmdEI
zJsY?>8oQ!tY;Vo0g0<k(FIqF6fcbGL?0BWR=q3DWSs&!cO=Hj{iQ@K3n0}=tqvk`p
z`aM0G?N0%u0eZd%qUL1a!2PW&4%Xv)J;^?jRog|sD2tw=(U-3+ks{Kv7hko+J56||
zM<CaM<ja^3r*hZZZoId%-L|7kBaR#GX6#`?oLvzUK%*dpvs<agjU`@dyqx-XvOFE-
zsAbNuN_6?*YiGX_+tJ*|xACOqbl6}Zevsb?XcMwIXB&QY-OGH)OL8%sz&-9utkZ*W
z3$^q778Xsn>R5aJ`8q8Fsd-uER0+YN5O8JvV>bCmUr0G>THIuAn_&#tZi@Z*^&3(J
z%l6$H)?)S^_I%BUzU*6`Bn@zdJ*)kqzhhN8z4rUxkNbc{k?^1HA^Q({1rBuBdh7p&
zGcoeuzo&Vx90lmrhwl}<))FLJPLwIlRm_p5jyAo&5t?^Cw5gY6-LHbtu%;*{tk#eD
zFLpZ#y4{DJdX!NHKiL7L98lEZPGMvF5_rL~iFr|btNuW3^hI0n4r7hTXsc$IgLV98
zJA7wtS^vi^-yJNQDcY^@N2_S$tH+#j1a#(H_(excc+4RmXv<e7a=+`n`XHdQZ>w>>
zzV;k%U-xodzXz`Chqk{%>(8SF)ukVnmevm2(+wRQF;rJqM;ZmQys3?nTeV7O1;3rp
z0Yc2rbuW_U*%Tj8o@!0HEOTia3NyVW0j{yfS@f)m&n6UXHbzD)KNkKN8YDP<Tc&!%
zYn<MFbF%<>Jk+}&n1P?{=wU|3MVw}CkZo0g@BQRde68QIqPk@!IpvPP_?PuD)4`h*
zcpr2+iJrG>b;eH86UMZ^tbz-zr`!$|&AAmNCS$GJ$ehA(N^M$FJMmyc&RBbiEAm?X
z72D7~%)B$a`nnO0S}E_`#~p4?x5ov#c*?>i@1~i?M>zn{319K7xJSV=+Hne@b^RL;
zi#V{N=HpWyI>m%U2f)mvg_>Vz;r+W81ylzl&`DMQd-*zOik>Ry6xG^7IX-!a)xm0^
zKR{nmnYtoGDK>nc+h-{ioa&3-upQ>N=u1T!SZb{zgOQa!JYC%-JlS3Co1gX|=ke_*
zAR!tBFra`_7v78ROrP#H6cFWeUS0Q@OGAcZ1PmGs=j)?)eO5eDC-~}<_Qda^fB<v)
z3p2zS*lu%p_Q(u;O2ID_e30uW^XWN>tcc>B*^Z<7eZo!3*`8xKBMNBZLjl9TbsT*`
zk&goUTR<|YAemw=%Ai(DA0tDbOCpF(%4rlpzl=CC>pO|B-%|%C8+GN4DcQ4b{o|Y9
z1+cvJFEJF#3WyTU`b!dUWT^hiS$K@{#vF)(_=%E>m`_$d$NN>VUXMyC`;w4xN`ilu
z`Wgjrp#Tfb3;XtC{R;|E_Ws6SY(!l2n)r18Dpb^E-wZYk|9pExNnr2U?X#xuhnI5e
zfO0z{4mf?5vQdC-CRlPo0lDDCT}H&Ii?@urSgvTT+C_7d5Ay;F=oYVkbX-rr+;?Pd
zi~=N4z*!8atTLY_5%|e9#GW<^s2CeY=aFCT-+TO5BKlyrZs2h?3b@qggz}L&NZ|M8
z<%fiE!FHYcU#skw&h(E1$G-arEP2&~mjHHV4`@+9hyKN+JXqTE`344lQT68)b!lHM
zMXM1d4!_2uX!KHY{|kz5pyWOv=RT*l@SQ%{3y{b$8>n6DwN1Zh`*Qd{QfNh(M}b50
ztIN0xin%{qdka)fysZe|_y-|Ci38k!69PPBn$Z8L1S!l5h0D^3lVR56rYw?!>KJkL
z!tn6q(nh#`YK9O6EER#u&H5+hiWI9?Q2vt?ffp2G7w-wr-dq}C{Z6mX;cp{TlwEPE
z?l*A$I^aSXG_rW_XO;WUWV;bNz50ioAOUdn>@EpB0mt&UVo?s-1?kS)TohpR%huug
z1!uF7d)sF`f#*uU4A0VMKB@0_tIAtfiMi1>k&0ycCB*qV?aR>)KQbEvec|d)UvN9)
zd58kufj0NkxxCd%khw7LOB%mST^SjwhXNw^vd?(HL3<be8=lAoMKY-0-@UMa7@12h
zKK#3X-2UZKaf!@lFXmCebDwWapA*N@iYNvUOU#64xS+A{ZH#_K_ktX({IO*Hr}r4w
z&#>pedFd|NVtyIp;j7j8d{~~*o<<J-mED~NT5iaKuaE-U+NSJ$Q4?-Gq18!%p9`+X
zrtQ{pC68W{h+TPrVg%!J+l()@PdKMOCUa3!QyvF=wppZaF+J48GZ8Ww*>pY_akeiN
zbUf<}W2GH@QCRW)<Rz)9p8OQ4sx<KbI(x6pOQ8VLXD`7pfP5C*6W>v9F+I`%_r&mb
zK4YPk7q4~dxfW`%?Z6#zwBr=z@^+HHE)BR^#?{&3t6?}&`nwcjs)<>D`neg7b}6`F
zO8<O>s=%Y-!?QzAj`tLm1|)j6c_wx+qiO>w(V+(j&)R4`Q9jR#;#tqya9umf>iJJe
zBKprOE#DvYood>qS5=iidIE{(VYhX9YHPDa%Bdx;QJ5xZy2>aIrG1!dH4#=KJY}Vg
zFOnYAPfIS?$RJA@!g^zAQyQY3254uT!9lwUwm%I7FSiVK)~1xx{imDj|35bqBM!1I
zPftUp*^-A5BdPmqy3~Jw614RCMXju7&x^+CAw`Arrf14=>+T+XUym;WxPmjdw3;NW
zc<{aLZ_dZBum-g}VxkObQhejar9&Ci^vDb>sCSAR<29*Xd-5m%Cp0Z{K_uRcM2U-X
zl2gMB=Wzy?SG8d{U$H?>H);M=ZUv)+<<VTfc*7epf!$`u&eJhzhGLeY84|}K+Z^E>
zWun!0;?snJY4vWt<k3E>7OmDIFh+D`bQKVCM0YX;1a_NmWSHvj-J_Myc*CKJy{1?^
zGLJ7R^<COOzHdBbc$=dP#=DD8ew8cv2Jbd&*<G3B8!aN3ToTf19xm?E%EV3*g=)mZ
zDY}n|HBxlZZU&tW`-vagNVkX?rQ!IA4*Q9Ylm`v_ktDi8_x!<CG$I+XbNd`NR;qJA
zwkZ5h4&51E#*e9>BRLrBi}=s3br#rSJ{lI~EBNXjDF1{8nIP)M$-`ps@owXAj3{wr
z|L8qZ$okkUxeHaEtqheIuENm!;km>K`MI#UYH0_YPWp%DQM~M#g?CKQBw9S~k!qU>
za5fv6WxvW<87yC#blohH!V@QtxwbbL9K5G><`>LT$m8(Wqlo`UFm$UA7k-q<i#XY>
z0ApKg?e~01^WfS;8UPx;9{3&p<d)S&Ph%0r)6&m2Ces2KpPsJFjmbKL9$b{<e-Ar3
zAZ?0ruAE79>`9IQMiq_RVS$l3eMns-8ucPwbf4$G*prBo38xmf>I|16ff41I!YV~Y
zit^$8d%q&w>ao1<nA_Ts-vgs{iLSqm1EYuIYv2djDxZtD?0FsEN5#SQti46xya@#y
zteNU5>qL+pxNV$+LCE$g7&}aq?}vKRoFaU>pI%J+APWF*8fj7$$bUD>d8!T4zJbWt
z#q?Ui*ZYnS3d8;Y(+G)+CXf}#q86O<KK|oXvcoBGxxX#0pF6keW4wAo-Sz0H#x2`T
zU6DsF3-7FTP8Pp>>gFrII|>GuX648nov{hu6`>5wav6id$O2aKvNW$YVT1SA*wU<}
z)>O)K(}Y4u@MR1NRw~3}h%3e4JaFR-feywS6f{8&-d_{Tbqre}_RHWutOncMbPSJg
z;$Iz%w>{5uZroJjR9l8~`PrV|44A3x#)vmSW_41x5{~yUkAHV=T)$Z-agYVh0ax2I
z+Qnnamk1R^Q>}z#ov7LmNmHb4;w|fx%Q;jZx9?egp&Z%s&b^B{7^d<m_IftfOUq-7
zWI811%BIH}^H&S3un4n6A0-bh<0j~7ic0Hz`8ssb6E@6nmHRF;A4@>FbiHS!0W!VO
ziA7Q^pLXO!u|_(MVYg{M8B1jW7pB!4DTz<vt>+{ccN|baL;V4XUXOLZcF4EXJ(9o+
zbQF-5h_u%8t7jJf`jzIUCFr`qzu1je=$0~W>QSaM=uVYC-N{UpvUlebcz&V?PF6*1
zKIi1DOFepcKg>P9c2tXMvw2NXu5pCxEZZmfYrN={QnAB#(1~^_TvV|uZ?sbKC@?bV
z#nrGYUpWEyiZ3tsilLfyht3VL9)-ov4n3GEo*5q&X^j%j6fus5_Z^KX;f+t7F~!dG
zsf_X^{ooq6<gciVW6%5Ctg`NU_r>GT-Zq@H2m#_xF^)~)RXg2#l8hJr-0R55n~~jg
zujZwxUL`{Jb5ujOYSLkwSGe-u3TO>GdrU0etFoXOZk==dC?m%tM7pd?1$E?PoyNLR
zP31CFZn;?7zobj3^~yg}+&;!OzE`TniMJ->N#i8FF>8xShg_Z-0e@ZCd20O%7*X5R
zpK8^HEo%Gid9c@-8q8XUhS<B{1lbceHtt9GMiaU5Y~!+3;&Y;X{xPQ=_*HrVw}*0>
zPf?<xx0O@NBIa)9aer!ptDk`IRuIW^dLj$xq{YAUdGWt`JM<=@f{xUnFH6thryi+u
zFw_)}8Tb=^16klZov^K1)A!Rn$4TN4*8b{{eO7z?Ec<y1!XNbbgo=hW)$&Rjwmj?G
zRxk6Fv%Ed#oT&32ISr=smyhs89^`~Z_9+;4JGPEZq+2Unt%oLnRS9hhT5zr|Dt)V0
z1!8%*{DFfR{3*i^I2;3pCerzzjf_$$TZK$KRa>U%RT@9lkm;MK9<tn2O;WacoaP9Y
z(yb9z-+NNaWo*uK(R)QF;0hsN{#Eliho<-LM5=;eIeody`>u(2o6kA8$*JS7Hsx%U
zvs`5Q`qiJcY)Uv$7meRz9>3?p1XkQjEr+fMrGBK;|A@0D-nJ<_E|&X1D9l;sRP8)M
zTN<fvCEm5E(Ae!1Fs%NvxX^#YFA1r3^MOzZm#zO`%B|Cdik6atY+U0tg{BoQ>8k7?
zF=?CEMo-o2I=xv4jIT-FC(`OK7k{(;krHi%Ga!>_w5p7cuACQ>E8==~khOu%sYa?P
zGL7RI+~ObSfm-u_THud`elYzJkpFAl#f5J6;eqRHnexfr<-}lAsN^~76F_*T=6U<v
z1KgXY;Z%a*@y*NdIQ(*PwNEN=uC#3|)H<#nVgwi2Y3n$DsnIj(r{_uYr?{aC8@Yz~
zW%t;Vv~wqXlL>Xcm1BI@RsOQ6)!TBWZ780Fk?`b$CDY9G788*yeZh2X0YzkSUY+0+
zelxT`#d@f7r?@C6TPAauo+&zdoM~fn@6pziMK*=EH-|$!67NlZj-BOcs5PD2zUr<e
zn7PaU>S<<HharjXWC!3_)vmVA6B4petEg#Ljx1`u<v6Gx$hoGbxAuPPp2GO(nDVCp
zuY%gEY>dr*({G7BCGst8*?#845N8}w);Z+q{uoPmRg{nNL#DB{yiV_$82iMK?Fsd`
zD~HQBnf$rAS=s8b0b1*PftezvQ3BI5>k&TxA9)>z#tC_Tn2)$YXYcpVt{jWn!#bF~
zLa#U3n$BX!-Q#3=?HbyR2W)f=;_7ErQ$(%3dUZiZBpK6d-wUlN!B2BmA7#qix31I4
zU*)#lk9?SjIo&YbXy8@h(gc6Qwq`#*y8iU$VONsb_zmx*Vmd!27?C4RgdCk876WlG
za1wW_HKuax(k|LTcvjo=B2~OleCe|yO@j#SM~G@yy27s5Xv~e-$@DmTc4Brb4EZSf
zeHPWwZUGtW21l!V)viUIA1!}m$4<FUcD98uT_xrcoDYxd5DJx0k7L(9(VUZydL)uV
z@c;v#I%tYJ#X<6$<e3Fp7Fqpyo^_5_^%AW~;Dw&y7v)rKxT9WH*c?sxLm+2)fYCkW
zyF#S>=73^lELJQZl%a$8_zg?z3RMPdPKX!s>c0~N{bvEt8hSoqmXE;5x%gX=iMpDX
zZ$D>u9g4e&pTZIS`};=TtUM;(Z2bgDo2ou$D4<kdx7X{i55ccnqFNqjqy5ae8wKFY
zICmp663}}g`Q9Jsjr$a~d*e1$-m*=ka^ogrmuv<HeSNC!HKAXA*SU19hq~!gBMqX0
zl|K7a+jHXKK~7lw^ppGZPJY53Yak|EVLR!b{noJTJ;ZeS;-^L`=$a}O$(ru&Q1}lk
z`fTchEQb|Akf)z~)d)X1$mxB%Dc#oX5YV17+ywGkE$mh<<GgJpwIXO=0?wPI$ilg`
zi{ZYFZ7Xd!SF?A}i8_AdLE#iwH(N}o@VM#IWu2OLXie~DZ|df~i(V997G{{N{IxF&
zZpd8jT0cHB9C)9;oVwvjssV4kA+oS-19LFE7_N|FAh=z8s*1dAwehUM`{uL8O~rTu
zsf}mD^X8kn4nzAB$-JPUK5lSC7$dWB!8yLJLG0$UrcL>70y&+h>KCovYz5@ZgK-;r
z!=D<Kr4tUaU(>JYs+7=|3qAw|?Zw=mO!sNO4?ntk;b%Qw;EA*Q_MalH<-i##Xx1&d
zHAM;dzq#N%;Bs0;qLu0_d*lt?K+(cocYQl#Kd-0WgQ)gY<k%MqX0tqG1MgY+&Q5~o
zV>Ywket#_ERQdGX`P=jD@7p{q1r}RgP0d#p&$ll=Tgcime#fhS%be)rwhKqP{iuf~
zq*s@k60MPdUrFmnBPP@Fj_nZJ;k#Mq`So$Tgd5x2&oJ4f?W>!GOK;C1-sRl6+jc|N
zaHDM0@_e@K0;n$quU;0_wx(AzR=zk4Ha}t137Z-4S)Nfv0X8l0iM(T(k7H9y-wJod
zyZwWf;X8yE<y@V#0pQ#ULCmY47yRr6G)Y9Q!?3o_{PXsNz`2pfU91P-Nzp8y{zU5Z
zna>>VsYu_+X|GlA+Thl_XGhI?>bYlebx2eAEvohGGfU9{FyLQA0f7EE3Ya+~xD&il
zH{y7Xb{jmg8dI__Q^;a8H4&4fhxbPH_|zPMG43zXBhsrI?d`-5xKfX<1ml4J+ap7`
zHkr>v$%UFv>8w+9dbQsK7!b#*_{<ugS(Ww~2}@m_1J6!$5arr?fyk#@2C9#8*>C^2
zuH3=8es@Fsf#I1Jt1^E$_|9p|u}s^jxN8QB@C*aKll$UXMRDqv+dEn3Met?9jn%0I
zmcs8{;h&Qc$GB%V7pCD`Yr6vdZHlLQh)($U_NPWwJ^%A0w)1HY9u$BUmSIbIShw=_
z%DJvpeR;;$INvxYzw{c}{&N2x>;-Kjfk&DYUIGgkrxnHF83o$Nd=cDr?ky)?tryi8
zl~58<gs+27fyVWMUgpY(RKvuq1le@LT=69h^@%OQ;~x<|4OZ~7<~CeX-*eVjgBsj*
z`>K<hnk$I)`M%NoR{Q5G6F0<mWsxtQVh*P|7Lb)tM~8nlhn&RZUi2e^2d91J6fejS
z6RI29!;Di6>D3Tk=6n^x7Q%yE=s3Lg23!Jhl!z$H_$vO6V^u)fIdkpv1fmQ4!~geJ
z2ita~PQZ`vw>Je*083p4$Et|5ZFy@-y^8??{Ijrj>@Q8&XFTVYD8N#-*jxGscTR!s
zKnDt7@AoEuqr;X0IU^6>WI+<<)UDhjtLE*Q2LA#gQk^M@@_ZTGD?>2CHwBSwr{cQ3
zj=|rxCVDV?;HxwucCq4nx6gMKPw$Hbp1<W-y)NyN@9gF9>R3}-*j{r20l6Ucv1}{$
zF<1Q5tNO^6Bl)u&c;Opz@uns9zSB#@F}U$9$p9O_JWu6V5hEMO`keWh3XTM4(3kS(
zsaA*(_^H|KyyB^rnExedqu{lR7AujWMJf>C&gdu#_%aawA@ZE%VmRF3qA$)VCB34q
zkJclK2+>zAcgsfkq+<~-aVhd84_%-9rJV=9u3;8@p+2`-u&llb|4szjZ}`!`c`iY2
zAkz7SCp5hVbBMR^*t{5g(T4)aH1(A#;Vz&C>cB4_tk%5QpjYT~iB@Mvb`R)6A5IqS
z$oS0JUhv-f9Dlki^DJz3QTg<Ks@d(0;~%mJX%}3A=rgVH6FJL!g~_w)o66_N);MIQ
z2%-T|x;jl=PB!FY-k?n02G`<a8QfHU<blASU6e&;iT9lxho6dj4;(57DE|tez*B>t
z0n{gDtQikl@}YUh<{Q=FoKcN;Lx9y}NCVAF>w7t^(vEs3p?MaaKg<gp<9bFbIEoe;
z3-ypl`V`BEUhB&p*ZRHD>ghXs?6lVY!-Wg0i4#mV3x`spwX2#4&ziUQw{9mT?uTk^
zad;Hw5YzX$fPqP;i&Vn*fy1P)0bADHx6K~DXa9`u+(>*Qi&RxhLVIAg^v79S{pJ`r
zuaEWe9R@Z$Vz$TC*ORhS6#Gsumm76QmICKdA;yBlX7u-mS|8FrC1eTP-ET*Bj+GDh
zOH>HIL0FY3ZQ^J$g(sgy#TZ>>Se9e!5RoEk;-vyV4vdv3=VViq^$uPHo>|A8%Fra#
z4=+zsUe!^|#P`nbKu+?u9uq&fR!Pm;nZ3o;zNL};(yX!7M6C;!D@riXL4~2ECdCGg
zkfin_lv01B-(oI2rE{PBZr{!lkqj2y5*b~DWIJ7iBb$MEWZqtIg<E!XRZL|<_%$Vt
z>kNwl;`$6Ld=SNxGZD^{<eHF+k@8`2T}MK0a9y~~InUge7yjwCTAKqwTfVP`<F}|<
zWtS|uO60e!$u5{8<?|?$ptDX=V<-FpKL_f>JYMecDZT>m*p2(W0DXWA1qB5r%!GQR
z>tVrs40Bko`%<Vs+jWD^rU*$Gk>s}g3eiSuvHF&ws_yY{**)1%bA^~CQSbEIQ8p)4
zQ{;MCuWT+uGkNB~0)|(GWmWhGSXoJC^XyhaOmeTcATk1+)7O|G9T}j?;=N_OdohC7
zUxvQ+>7w=qzalKG&5l<fru0w0gR4c>d6shNMV;}<i_;8no-Td=6}<8TKlAe0)x@2!
zTpLC6*-QhSG}R2Qn(FMNp*2tGAV{8laX}f<W;W|eSFg?MW2wFYu3YhT8RFmC(#z}G
zNZ@f6;8zDq_o0X%`lI2StlsgXXx;;%($3iLrOuR66Ud(M_8^Wr;YTE@m(<}%ud}fG
z!5aZFSt(gQn21G%39Tqhn9r>2nZ?CW_IM!DtCu@?J@tMu+?f!Z9YVF9ir^6`+!Xsk
zi{Oz(z7_8V{b|W*SgYY<F*Dkl)5XbfUe+VTbd~byQMvvE@2iuSQaHii>PzUs>+nG+
zV0%IJJe2SZseF3!roJrKjW9<;Xo4-xmIia$c2=HfSbzMA`Acvf^#JD%i@`0pYL1br
zF50&jhqm=QjCnWbN9;a6`(I4GcRbba|39vmO8cZpMouC^sF1RrEjv#3b_!)>WF>N*
zsaFwkjEoc~dy~B#S%)au*?aGCIL>(Xy}aJH&+qp8M|7^|xUTDQJs$VR{V~pcVfm(L
z7wTIrl9;Nu;nVoDuNbq=-~B1N0&7D@PIT~r`J)iQ=<PW1Nu)jf#n%7Fbz4MwBqX|r
z=qM)rWqO}0Y4R=PsEtd=A(GD3ZXbhCl5Rx71*4lOo-fJRp52c26!_8&YTq_DBNVR0
zn%9%NZz9-?js7J?6k+bgBk=i^`Qv{KGyXDJ%k0>tsVaE(b@{p~v=g>%KE_?Fu#9n!
zLf2d5Fv3TNQ(<euN|#aN5GXf2cad1B9Vbkzv?y@LZ^P=3fYtBMq7L~4g>KwUk$Idx
zs16P1naV;mw)!NvP}4Hhl~>t4i7^l`k6r4^gRM|2dNxX&w2w&f$tn4_MS0uy{3)oF
zzHjGF!k&q;XOU$n`zsLFBEq)4V5iEC!ym18P^I>{!*C^L@z71<Ns<~Tt(fz_Pq=TR
zhtdacqlX#7G<Tlt^~q%XO1EY*kW7m@cUH#0+amO~osYYmWb=t|sPeun2JKn>0{ox7
z;O}?1W!~Wfcz&b>Ak-w;2kq+Q!UWVxx6K`9ioI{eIlO?ZVX@TwL(e?py?46jew#61
zG0Y-7Eu^sx7}zH?!_2tTj99?VEp^k}6?I#+KE-#BF4Z#z$mk`kwyL`}V}Ou-AzYqF
zyYiRGGvdFW)esHMh;`n+g)D0{oFIJy_d&08Fk;|Jizs(L#(*;rE2-)-qs?cjXm#vT
z{k#R95s4p9L4GJkikIzTZgAP8ryZB95$%8q+IMV`R_B$@?a68R9hwY)#~qA;E!0v8
zvW)Jxp%sglxe{7S-h<rv8}JyGdN}V%@tkPWmJ+lFrv76WX?98Kx9V-y{xU80&9aNu
zp-(GP*&a*0JtV8syD`Ucz%Al0)62h1<oVGx{E#<+HVY1_5d(+c<YH*0S%Hd=$p(&V
zaZkp414@Tx2`eb?AH2ZYwfZlbqXHhr6$jx3hw_FOg=oybdoOj7OQFhp%t!^-Zfdat
zrS<liUuv?(jzH4&>eb5mFPtN+$-2%V7oE%fw!%})k2Z`p3ZvEbA;l4o_j^XWFosZB
zPjWB*N;vyH>=yM&0@uM3932>0Uty$J*30JsBKMB2#}(C~mX8}CF&vt38L?Jo{iP$U
zXqt^d->r|nG{P@Qgk5&7nTVT^BnK1gQs-_aTgur5?}S6Nabi>El>+oaiYgK~I%%%f
zx$I9b{THs~rVIOP0OFreM(UJA*xXM1{PH#G-p!x~lfQ*Cx^%j&XwmAUdeXn+#M>B)
z|2k7x04V*$h)iXU0_JBm{L<|0rK!i_)mbNU{ShW5Re7a!RMl66&{=Y7R4oWGQP~YM
zQ0zz(8m@;c)KWbD;C?BeTo-GmbqLdy<d9Rs)@L_3HrWe2G%o#Rn*QKFCsGu<{e|ew
z39W`9Y_7R=&umFPyMh22Uy|JV%f$7sBZRw3InwR>Tmvp=CS;=4GOvvcYVLq^JSp_J
zL4>4Tz=4vR0fet$zjaQZrG;LlL)7j+;XUQy?C3Q#Qf#N<oXYxR5}~p++HqD6B3{cN
z;*Vs?2ruxVSA}z&3+zZ=ooUPd<Wz;okSol1n(ZiEpW}q_*#b5NdB3e-VpHLi8KLIQ
z9I&@f%*BT{-&<oToKSBeL8~+fu|Tg|>2scm5Y4G;q~8LW0N3Cg6TCiYpBr#dKqQ51
z%9>EuTDkBOkrs(YcnC>^1>wyDt@D{J0~et+W<=Uf+H>_793UN=<uY`DfAKu9ML@?|
zR^dY4EP#B0rDB=eR(8@J@@F5?-7vHV(FuNvAC%mJ9o*0(;SxYr^3$1Io>lNuK!$*n
z@jsrj!P#0$-40t}8MXIiEx@Aqoi<`U?4xoR{05UVsbb&Hp7~9nfIz270;#P-PugH&
zMKL-6oF#^RK}Gczys^#=*Al5c;UzmcoxKt?3IN#83cB&bB|!+n{FkYqbJzc7KBHQK
zUc^eIAJfGehCC+q^E*?{B9Vda3`4|soO#%vqLUM!Sp71Ys-Pej(WW6U>PFZ)F#DUZ
zmI?j20*O6@!OWlk=wW*qk+F@^zP9KaiAMI@e|!(x0$kX>ujq3#dagxXUM%gzrV7B?
zEW7&6<2~(SY*q+W`h_Ez=~~lyc=7Y^nMQYOxbCVw)HAH{mkFmSLFX^XqgF=KEunD}
zO-4H5*#vs+47+hIIeGpv{7#9d&6`~-EL~{0g47En|24@3OMd<e=nY}4PH!J#A~9C0
z@7Y_-{+G!V2xpC7;_|E6uBuyqnKphy^n+iy6l=Jj1)ScJA`E^G;dSoTPbbIxWtts_
z&S+ys&b*4UIFC;j-PPOeGh|rvZ?K>5<4137q8Zyo#K8`@{Ri$Du+v%zmdpwpf0?pN
z8E3xw%p0yM;VFl*Mh8nAk%B4QL1-OlVf(q&db8`81odRXqpatWClcWb6*>#LGs#hn
zbVp^LA$ohZ10-TZ`!k@gnZaj5wC-)7zqTW-dI?h}EFSBE1ZCeLgr6<~EsGkCeZoxs
zW$MjRdde~s>s%-Qmr31D0M6JXAWSS<Nzu(_BafYBe`$3Rdi|X3>4_SIgsgwe^>|dA
zh3Oo0k=rr>@aq8#Z3;bq_wLLEQ(+Xf=p$SUQ+r(5DuNK>e5xP979<m>`u*)kpA=R8
zb#BHq^MXHJgazhT=BAZ39j`zHvyaX?6HkG2rSv%G9nd>)E8SJ3ZjKt{yS^utVGlY*
z<F+qXbzGUUnwLb)>rDmrYGtc1z{n;00b4_sRTWOEhECi*;%p#J61A35ftK_=b{7?m
zB#`Jw%)qFk*Ruuz$nrR;(uQi#vbG7(+9jA%QX7r(PQE+$mx<w>Yb|b|ZSJ6pUu`@J
zwtJl+Qb!3NJErgj28_O5ef|1uI7>&PDgJITwz{2u7(-6p^<fbRv}({s6Kz?3Gc)W)
z2e*Y*K_=5=65T<C25I0|{U~pt-Wc8b`JHVPg@vM1<b#S*V$Plqxw@@O_>tM-<Mfwl
z0mSV!9i-y9u@fKQS`4Kd^=y1hQB9BVu%6nb<}UgC+WuGZ8hP|X-9I{>$C38ZQ1Y~*
z904Vi^^|cK-J1~nFm%>Uf_@ARw$(~%TSx6W%_95ZrX-H5`L$1+v#hASA3Yy@YmZj}
zCvl)ovUeIkkw(=Ul9t09UA&`kX&|2zKFfS_*EFoXPdZ1uh&Ylb;o|;hz$?XWU+tsi
z#kV|@Tb$B(i2#<JtlwYD6JL<KbQBb4jm^-p<w3)bUhHPIuSg?AX}9OGz{`uR(3d<K
zmxAQp+|7F1?eVDnr&%>Z?3>Bu&{=2tzMJLM#n(JntZC%7X&Adet=(5+U*Gdm>HEH{
zHx<O#`S(_S=B$3lqddfJukd7+vWF?LXZ#nl#U^5zpC+uW);nJ34iXIU+1LpW9o*R^
z?KpS)#oT*&%zet~=gR{La|8YX#Xg#+H9oX@yf`1sw0}~;XnFrz?I^1dCPAXwg>To_
zNDdCE@(&skSlJHf>w|WcwM_2+RAqO1UmDtSr7TQ&M6@TV6BV)nK=J%0?&w}FSs-jU
zPa-D=j_fK<N91)s$vx~5pmOpgG|WDkX4U1Y%(5+(^d&nY6_>Wl<+4Uam;1`XwH764
z-5%Z5+d^YZX`~E$iC#{Xo^}1UmfxmwocE4Cg1wxUIWFF|VrzCIgzJ2`Gxa6oz)c}r
z%d=vnHy%a_KEses;P%g}6-wgAd_vgNlVAQj^;|^jPT|9eAMM`tf~P5MP*ZAYkB1y*
zl#lK83L8rOKcFUq=k=kn*H=_n0&mjZ`CoU>(S)b7CH^uor!_ieo2o|)W@`vM<uo=u
zmVI;oNw4!;xm`44GT+8v%G>d&RhRRT__Jo>7c8Ic>@m<En9>ez>i0fPb#NHI`8D!t
zxxk&X*4EZ1QR>{50vvtO{#+xU_y2;YXLv5x5+<I-6_77KfAohOdL-?6qWvoOuwBX8
z=-^lJrt|mm)2BXN5ORHccBtO{;TINZj%{+gK`9`yUg?E-1uh8d7+G&5-{CY?GtjxY
zpY?a3IQ5N+%+yFkQ~~tX==L?=Wx40m=5z~TQ@VH|M=S}k;M;w|yP~*Mt#)(Y-UIUm
zo@<^Sw#zPEJAb)R=CGA^%QdCoA54Jl4n6&9s>5a4=3wC^+JFm|a{Rvd!*h;6Wz=dq
z#cAX9FeI3wYqBkT0~Ur^GRk(1gSIIgiErs7auUr5RZ;7U0+|j){ZEr=T@A#wgPA%;
z1JG~<IHM4iY#@R>*3BY5VMsFUulJPt?lSH5mnF{&bSC`5^`jX;zx3;Sek-vkbwQ^C
z)Y0P_^ttUtbunE148I4KED~&raM2HOXOW_M_985anQ@Y^s7bSC{c@<ICajp}^~@$S
z8|cchN%_rZ(aA#n0BmujhcCgkA46vf{1(gT=hpcNn`ok9o*w0~5#uWDfT`qCXJ1D&
z`mxm(iPCG-BQ31B97A8wkJgVs%u!=?3Bj1=L5|RtP8RfQ!lLT*S(jXBj1`!h$2qy_
z49AOTW$b!Jv}TnvasTA}8-|0-BO2y>R5wxi5#Tj3>zRU`MpS+cvOWMGS*mlJtPRgO
zsVGDw)?K5pQ}hjGA~tkq?#cU$ALs*?%?hg6^{m6NJz>%Pi!U1-jA6X@@+RG&=1UR&
zaHt^OsC2>4wgzD$_5+HFjtX7KKTtvjR4jGj=BqRYnIUYowvJr;%e2!9s~0l-Y*~IS
zDOQrUQdZt3TVvp_6_a6<QgW_n!>M`9W1;?-Pl{%!218%P_bGmx>MT9$^hOutLYF(u
zhtvACk`1?u4D*no7T3@^`Dz}{&~3&^lx9vl0(%kzFQZJ5->6_I;%XpuNGi4(AJ&$@
z(fV`7$=466RQYq7R{Z8K)8Uej&<C8mKS|aI;LRXlxQjl`_;4xzWdZ{}68eD;=vlrw
zS$zp^Rie+Qkp>?8H>_h>khd=EH*j+r89y*f&2YKdIOR<;eiHjD2FEv#-t2&7alMw*
zYW`$d>zlNXT`6_&yYf7WQ3Ze!;4xj82H*30w*)1M96j@K!kw1LwA4H+>{%YM&aaH#
z0N1}q1m`mTGKq0)rY+A7DdyZ?I1!8j{;ZOJXE{VMF%hC~VSk0vb-`QACL$ghth!}2
zIn0?zy?<w{`z4J1G^SDW*#BO8qU0UuC4smj#k%DZN14-Q_X`zEQE*&fNbn(;3vsVs
zx48p~m4bGAE<e_qpeCRAO7WCXf3&vb`_>J;R^pD{odcvkT`Y$M@s^m?ClAE6cp1fU
zu1$FB+0@(30~7pzpQ+Hrf|>UQX<B7I=jhQc8R0|^r+=>Jrxi#1Wjcxl#5{NmSk|M4
zw-GAhfyHJFMZcB8zf;+<zrI$BENcTEGc6%Lgcv757dw6u;D0c;D={^hM$X6JLT&VM
zD~cUqt<YV!6Kn`H{@50H#o5?jguW@Xq3^$nTwqUPUdkZt^B8a=d{TV4#4H9Iz;)Mc
zMq*ZDaRZfA)95zd4t#U)16C&j5$OF0?=23R+fD^BL4i9Z^EQ6+uOD6NI^j3?*d8#d
zk5dS{wva3|F5ZQr7h!+lbFb0_t>T!`^=gbaNTUN7Vwg$*n;!>mrx-ihM2ypDy0VSQ
z4|G2dy^e8*wjF$sQwlfsCgTp*-A*G+m?#$2_e&CxhAk84Z3&um2ki6*J!t}!WMh=E
zzoL6%d<0?ifDrxd9%-_ds=A|9QrditM2)aGoXE;ZL!n1Ns;j2&QJV~tlh+4irm^Q@
zp5lq$<;)iN%+D(`OF(xKc5x}^6#!V$=pwHdt~ySDRbRy;#d0)diCr>G+X1LB@BCJI
zpVi;ryFv|D5A=#(;idq7<3j%TFx))g?Hh&OLq%|j)3tuI&|Rc9`yWA}ozH)n4(>VD
zt;HEz8dfPB96>w0V9)+xBieSO=v&Si*+JGNSaP^51DvQ}#|Em4h4=}0MEY{#X^;n!
zBr%Jy`DW>y6Y`*gRm&z6mJWSHXMccF3|)ZgZUNZvGd0j~<G5-_N=BaPCt(i5?)Kp_
zH!{10?#rqyacD6Yj=Q^Ef@ipYfQBC-?AY^;v8@@4{wpnn%%1dB@(k@)60*-IY{8Rd
z)$CUqV+D$|Rf1E|y8*Hc)4xnPI(?zSFJc$nvaBR7p|^h}_$*G-y3pTmAw}Qa(n^QB
z)#$g8$n!MGttuhp9}r_8hM6@wFAKYE{uJ6kibWRIP~`BNU`wtbdXvtl-7C>M&FmH$
zSE?8}m|bdzyJ+EU4>{q3`{>i~ddfB9vX(!%LK#Y*oXAIT?lWPo_xJt39tW!hjbozo
z#cedUgB2Cip~J^-Ixnd<*a^a;U}+8h*{zRYg5IY&Kk7Yz4$_%AVdee{%`gHR;!n|2
zN?9>u7(1N(3EEyyqIKY=1iQifQnUd-wWGQI%kag@bjZLY=fb^FuSlxpH-So*n?CS&
zJf(-Dy5+k&{VdoMX)SY>Hh0*%KrE{4*>Yehn~4r%9-K?>YYuU*y-*|8kO4Gl64v@S
zBn(aAhJ#OBJ7Mh@u$4-y!7`}OxVq!h<{vNMokg&k#`aGKi?BO`aIjXsNhwAYL1ZZ1
z8_hT0Thz)7T?G-g8%U&aQC7H@Fg^p_nazkA<!pd<)`?9qxO()cA9kJ}4n8vO^YODv
zC}ZmGf9s<ED<<sAM_`A62MYR|qA5%547&4r+6#mik&|ePFi6G-e0Uw&08NMf&!Iio
z{V&=>j{(fNNrgW4XiM);mN9#et|}qmz~S9lko`~&&&ciOUuyDq-MvEOalkFATja`O
zw4oZ{w@$6&KQCY@+YPWX)ZMGp{`R7lWyN{#gX|`!b^{CSV=F&MB3L9d;o{FF|JhJH
z<@j}9jt4<2s$lh*(c^l=!eZ@SjtB(U{N60>fZWzs5j)dpJiFzk1j|EV82Yh21N>QT
z9VyiGM6aUPzAEdk&NslL*m0#$dyi0MmEn&l3TIa3=vlk=v6-^ssC~U{65Z1GOV89J
z#v<TAn9}WxZ1fDS)4HHB%`1b0yahigPs+*F#TMCFz;HXSXY}b5ofFqXQ>W}){jwb|
z17napyUtJTIvyA8CJbsNUcr*aVwq`cLwr<H;0JpxI;SNw<2y(czK$aSPm?v&_c7bM
zK{e)883qGAY5XWDdevN+2;!*KswKbUqt)RtA-e51vnV5}{H``gO(d;<tJC$2Gi?#-
z%nkBDZ;V2IpkDOjWsRMb_6fKy*pL6lU29nZ;;-zK;v~;d+&{T5N*0HZ{XiQF4J4f7
z!qgMym3~aKJ{40PtHA{!Y{Y&r*GilQ!uD>R_^KHmlRj-Rf~r8To7}e4eeB}Ta6r}S
z`V-Lf5|}o{)$YT%i@b;+vm1>ruw;ADFCFDxeC|o`d_va+@@T+e)Xh&TgeM6M`|0D;
z<MNdfbg(x$CTB)%UpkdTf%vt=+D~O3!*{Ea860e*%Y&0U*3KjlQ_;D5bh)LRWevNQ
zb~X+2X!T_m5wAR>1nO1s6^j%+Qq8x1CWEfY3V`4qa~OW{&s@mp+M&NpDK<ZxIS_MW
z;&Ke~v8VFXpcFKIp<2N}5RB~d4-jvsS2Tf=2~oZ$kN+|m1#$Gsma-4<p4qsl7!MRA
zm$&Esp8~xrgq(k^)<N3GP$^{nFHYKkBNAC2QUM-1IV+~TNwMQFptQ)x6L+hc2@j$v
z32$MOTxVu<%pGWqnc5Te+Hg@oXdRk-ApLL7&OIRjPr2Aa-A<)6CeT)r<}w&c#>XF>
zuYC?F1p#_J`@K}FUyCXrRrKOHFD$&;LvV6J-^%-c7YBcNBPYPm=msFrp6^kL(8w{O
zzOLC?nE!)6+st(P+XC2zaC9vk%#$5&mB>0Tx???yl%v*DOZ(yJ&nOz%$WoQ%UMNmP
zMBC--%Pa}T)}?8y8L6FpjIOQVx7_{-bhf}&8A*^va9V~@gdW#Vt}5d>dl8%chJI=4
z(J%Y<lV!n)&$)TnAG@fYC-3KNs)8B~Wq5hJ2L`NYpA>De6l0%Pt}k?4+}dA04BR3S
zKYn@ChwMjf<vwpfIP%xuecsk6SQ~0OTv}$HGU2xDSFUw%8nj4wz3<!&laNz=Rs>c|
zysXm;cG7!8G_HKG{nRmZd{t{h6e6%zk|7?PBNQ$FGV9pKFqF#OVJ*e4Qzs9d2Wd{`
z8asrIJnt(QJ+GWWWpBZRiHDM#eH<@xFfOWh{fz#Nx+x?TnHYGl<mRU@D^?MjiGd0K
zD^N46czKZ`lkPSBt}-+0cH+GTi6<2vH$>v<nCqduA5|;D>>`)M?KrePM-<56Um;ww
zmrr>Swev?`xct-qi6ds5e<lp)B;Pi6>gzJkxm>rcm+=BMkNi$zH_4eo^|GmiBex%y
zT)OZeJ+SOQU-uQ$Ii~FLWpa#L<ug(uYCSJLlac)8(^A))e_v=Pi5J3rO}FTpSDnZQ
z=S5LT28W~Qa83y3I|tof@|t_35LyX6soNaXy~rP}Ctx|Fz4gfC8zvLK>&!<Db$A=7
z0W5?<-#Uq$)iG>}s=Pdjumnc4DQL}&*x#tv#HXA1rBuMx?n!Ixtzttq$(^`s`u|p7
zcb6c}%oh)SMyYY<EC73Op-3!OuMR{w7oXdg53p+sYPoHwYX@)&iQKkO8#w#!>`~7o
zf~-W7m8S2#ka$yH0sG7RPK))TQ_|CMR0~sa8TNp~r-hi?KG5sa54@XdIl=>+#)cBB
z2nmP`)cLhR<Lcr#r^|)=TjB~-B(siv;5m7FipQXoDqeQTItWuOFW!4$#6W&}=lTVK
z*+^dOc}wX7L4|X*Kasj(W<g76IUMMzTT&Fq$7*9$w#mV7_(cvpe&~AWy!A<MF4MRR
z$S=>=Q_8tz$d%gH*ADT&KD5{I@%0JeAiGP8g`4O}<?6boHySCU(;lUp*3ic0u}2^x
z`r&DGxY5c#$_m#1WSMz+cHZFHZbIZ*t(zvYN>sn!;I+1yvG{t1JK`CbjZ!J|DjWSO
zBJJJ#{9BxpqxkWvmbg65fqH(H{U=pe*mi08>1W@k4U`T?!u$q(>UXXQU})3Criy17
zbEQ@GVJTI_&5>SdEN$UfCNC57BRo$;SvQA)o9STja`rci0YMo}rps9oepNj3FXWFe
zROW9?xv8&~Eqy>Q&2y}<L2GA#@;Ff3$s2}<z)kTUmetqMU!|EB9T{y5N%f`6CWdAB
zyog=&dX^ge3~h^<MWkO3v^eittMn$xCjZ>IXSGOJPpmJHo$3?BBSv>%G*YepQc1`w
z5uM|9W@Dta`wk44-_qm7_2M%jrztWZq2R$%(EVb7oSDgoIrpghqz2uPsLat2C`I4a
z7@q!!-Dw4-Vfx8@vLueN0ytPqj`?X9NLGrq*na2>c<dY%y1??tAX-iIbJWZ*ZcBsW
zjQ;hRCu+&{Ti(PJto|}9U!J519v}~s_P?2%>gsFo>~w$a2JnV7{><hM-<x%SCEnU9
zM=RtcKx!z8j;B(_HR?h~OK0!iAgSwL(^9IE7G|ls`=5J}`cJP#fQLS)E?V8mfrYSu
zj}(o0QT61;p;q#9U<+|`Q|Kxe#gul6f!iOofga*&0^@*g)GrT~onz3L3iU|NfwtDZ
z>z?<^uL;6KFd|ZhKKaL_(MBM@>~h(d=!s<S*rAx#lk)6zQ@UtGulRI$&!pXr8<PS%
zyonVqEt`3|u~m6zUNTCEUfkPn6q2Dh9115*y<1TeBAGw->w`@>xf1!Uv+cIqW61a_
zPJD}>#R@wmj|kH|B{J{klTXv(Zs^|#O3zJ2#RX#BVY<Ui@W__aPSW62hQT>}Vlrhn
z2TTJ^TgZ|j#l0Z@i*KsI4X>(Ib#Avg96v#-A%xVNSNOb{ZaRq%z<AOZ>tteOVl9U8
z3%{3qf?hsdXGH|*3)w_Yc{L$5Bb@ZaU?X=UZx4Q9eaX9(ZoGb%SKLTXXd*2TPp_7K
z@nl`Cas+SxW1Dr!`voOwq7dW}I6f$CXg?Dloh|ya)TaaV+$(;x#Q$gO?mB;CTF#~}
zJZ?!TMBvz}o#)lu)pOg~3LkxVK?&MXjz)Ns+D%ydMmGd)^nP0SR*ry~`55s2P{0Gn
z`>p>(-Y&x)OEJQUg5cLop5lL9_Y|^Fk9kQ6a9!g%mW~vo*YaN)|9831|L^j9=u`40
zvRG+#;%V^jNPgb+|GU<Tmz0JNR1`&TP<k#=GA0th1T-xS|GSovg?hwG$`NWLut}Ik
zNhfeLVNR*^8bHBbC7_F)O0gxi%7=G`$Sto-Y#NQbPvm)dN3L|%;&_#AX{<uw#qoqc
zJ00tT4b1uU1?}}k3v?Z3605i><t)W0L}lI0-!g;I(!>dX0`$Ehd__8~7HpNxe=mmX
z4_f%P<f}|TlTi}_IO%7Q?a{mmtKGgI+|~2X0~IPcdiefO$01u`pK|&_C-U2-%6~Ht
z54tMG=C)A3$f4saIMD;4>x@-UX4QRNhU$F@dW`*EQ$yZZ34kW-{?Gs9vwQj#wFT1y
zSn@La!eST^-L+&nsopK}1I4z{cTiItqdX0;@r4Ls(kP3|4=)5tl!Yj|B@*;?P~p>J
zp%ez#gAPhNwxVOQ*GZ;{v;vNhwNEd0J0$3X!0}y}yqMER97l6iH_=X+PA$O|qF1ed
z`wtb8CRE6IF%jL=0~}Tyw7Xi6E6`juc1lYuE8?S+J#V1&z)S=u@Bv(j%7V$}R%)1W
zP&xE!CTU91aH!ri12yCVjX@0iPZrBmtt1eTIWmY0clk)7vaRUCARKcpnR)S4_eRZk
zXUW4g{Xig&?lLn(B)3Q6y@4S^GwkPxB}*8Mn7+kRogmU@!W$h1kLD{^2R_)m`G$QF
z=91Zq*u-9Tww4F1BgGJ8b=VJ!cddQUJ(0w*HU!A0r*oC)3oDOO-@7nW(UDs6GJJ?U
zT&qIq4Xv>mf85R}K-2Ya9DOefu-YqNeG7GG9xZj;^0EY0RfP^H$>2+COG${yEb`Cj
zq=7(T7368BLO%>qGLyHtGHB7)P?S?(&=E}8my<gk)*oDJ!F%7yRLBl<2jcI`$`JW6
zZ}Qo9ciOobtk#Q;S)S%jH04m5v!vpkSAo-IO*lND!Mcz}mwG`#NCnKes^lkXy%`!~
zzY?Wg>q)Axd{^JU`{_>8IBw}UxFa7@gg-ZB#kfsRf@snXoT*K2gf@LOiHq1Vq4`)f
zf1ywQmv=<JfY*2}LFsWWx<9({3*`F0N=J%|x95}P49@V*;4f_8-f}P&DvJz-gZ3ix
zQMtsOc1m{(4=FpGP!ILy#fi@`b}v8#imq0aio`Ub0UT^amwc9})}0T8z^?n5)qk0!
zp>cx)*{mLc*Y{Y4xSFA3V%gRV5TdC(dQ$B7xljgRsNb4s-mX+SOwG{^mGf;iBJw@R
z*0q^=4K?fHEXymR!%J1a(leXmU7?<O%8>@uBt*^&oNT1nEJPGF`5O9>*qU$FR%IOn
zG6QZ94@e)a49Pl4Ka>`*bxYBUABdtRdR+@ueFPpAjEeL3)W5dbE71nFL%|xDx~LfF
z{$D2Dd(n#L@GH0ck$>!y><3JElpHzf#}%ljg}L?>MeMw>Sz|vRp>a+UkRn$Z4(Au5
z!r|6fbVB2WcFX0cE)ru~cmX3R(>w7Ux3~;Ey@sB*#P=^uzY@29qh~~~kNE7vZ<!N!
zTC(sj96nq=rb5d=*z9@Q3Oq!0k%CQV?II9)yPD2`nOPx(2~K&UCJ$_+IH1#Nm2|?A
zoT6-yUG(HFVM)8(B4F>t-2My0>M1*3te}ss9Wzv1dq*o#fiTFAuh&cc8RnIFd#+YN
z%8ySf_jHxq+HNwS6osc-%3!uP=pbI$mXn)Z&2L2p7o;7|KHuKINd_K&W7qU1NAnzz
z?jp%Ob^=m=)KvtJ-vA4k6=zo*Iq$g353hT043NLV-N5_W2P5JkhC?RjPS2OX8!eyL
zj)Qc>P}g@@+ElM<b+3OW0*-#8ULwtOWfs|WUYAx^d>Ff=s3DrrVGXUF*5?{ota5_J
z1aprr8~M&aJKq7}(#gHJIvGjofT%qh-4as|u9(5TeF&3X%dt1BW<cBz<{mA_t`4=a
z(2{`vl;&6z!FaksXoLB*5X)VV`G3=)g@wN7;2L4R;mM^ryXdt9DaP>-3%h;PVl#8m
z`g<??P`iY+3`h2i6U*EP?mbwK?s~znfrq2IhJE+fCK&zai0z$erWjP70Tf^o6w=m$
zdPL{Oba!U~7NGUUZ{$LWzPxO;g#_g!`wc}ja@q+#67|P;=c>wp>56Fr{Q$q%pYfcC
z^|Lu^0}^XF<#bKegR!_JPY^4#S1(*~bqYsUJD?_%3>=;kD4RiR-*X2a6Kowx^kbb*
zOO`@WlyiztAe$MNRMLyuLgqP<25<fEw6Lf2Mvo>{-L!CM?8&EXGRqOm_QKLFw%tF~
zu`3V7BQyLqnhlZtbtzm1d7w$|ORxftzPanfp3*4+=Xq_lXW6K7et0wu$<p|Qk7#Q}
z+IpZ6z!lfNl`b0mc5N0~<1?^WZGh^4b_LOIc8<6_)vE%p;96DWW3!9s*);#JP#UH4
zeQpI){TkS(?i^>JdKaHy>0WyIS&h9$f0<6%3We>6u(~o#fP!R#CbgGBeV3QX$~naq
z53d}vnZr=JYC0*uSjNG1$-F;zuAFU3ntcO3AS-KpR$4rT|DKf;#o%~{=qu$de_1|S
z#t`ZIdg&~$Z{bD&VW(BMknb;(A?Qu8FUPguCz3e|g{Er;&)>XGp<V$nIoCD&8Sc{B
zyU&x{Yz4jQc;Ql&%T`bG<7q~(uhawAV9ooL%8!~W6o(1aA<^NsQ=1qACbK(U-0zQ8
zquP?kY%*Wp8q)Nwxt!~-??Ht?*eDY#wp?7P=HPsBDk=F1ECIc5&W$}=epe~K-4w;S
z(Eck{boiy|SUW5B(@Yor_`xq|w7kqgH4Z1mCA&)>tdF6G<CDoVRaF$p#<5U$xfN)B
z0E-A##~1_|mQVls81ZK&JvV@IxAD!*4rk>N;#?=N!6CgKBlxU8%7Qid@gvu792dC%
zD!#0RIkx!XP>A85Ul|WyJ7gr4lmw^58XO9ERVaD2mg$6=(5nMVhFi;qdYwWJae^BT
z!k^SRUMmL&h9BOa!NSQjIq-Sol;Z0(Y^@LJBi5_`{<CB3#qab-8e}dQa_&<-cXDcW
zRroBVJy;dxqT*n4`1M)63m2~FD`~&VWU6IyVajViv!3_C=;Q!-m!)?Bi->$%$;)##
z^_^~rD9sKrLsF}#WjDK@e+gMIO8;(hi6P0MOQg2?W3vE4F9GJodke_D!zO3Wtp16P
zZ@RxjT^y7LZ}mAVFDhK0dA7(SKH6-6?JuDz6R^%pAguk2s(HEhjNObGHm0km#BaCQ
zN+$Rv$LX_E>*rz~^;r10z+!bo2p&hR+s!9p;V~&9UGs*QOyg{-zb~*~!2GXET|VaB
zhT)W$hHj~Z$RF}vj0J3SwE~DQaA*L}17F`q8|V!sZjYem$ZI@`2iL!>PN({Nqi8O&
zsGqOciwK92^Rg^lYE0ChhoCSQTQ3oZW#m@AK5vI&8xd?%T_w-wV5i3XzfAIXftpS%
zH8}lJpQ1Rr$pMV?J|};qEAJz!4n~Jm7$VC4f0=>+w^x_BzQgzj&p`hB``gEg_Vqhn
zvBXviT3@CS^@fC4wo*)o;q?l?8o`&m&?e`jt&%dp{fN#~V%{Lq<$syX_Ztw&oe$tG
z3u+HI-RCBVyR-tJn!(K{^&x|=HG{PJL48DbRHcFN29#=_dj?89`_ObH2swkTW8LxC
z0jJ%EfXHBhc-Muj+t3-t2rwk;v3P_nI#7?^=lRO_3AmY_uLXXSxH!c-khek59H84!
zOxY{`j5y@Ic=D;AyWahnQi#UAIw<r@{1v?~XAElVS8(TF-k`C?rbbL)ON{T`a&??m
zn`~jec8C3wt^m{IB@L046Q1}uG31arn37sg`1LJSPST8eZ?XUPI1SATjb+IO9TPKB
zTzLIa<;Bq3^_RbXczt^|g}2Fn6Iz^-*2!~TTvbr35%*&99d<$IRFnQPai<N^b=Nef
z;`L;QZc!^VPSU6J*_%Kcz)la6L0R`?mouKFrIdA0i}a;rUe)h?`!KJe$n}OyqYCV+
zc%FjLfzhGi_Ys_fQhciX=kr$nu<sR`oxHt2P%HAl_9yim3sNG1+sj7Yp%+VG2YxNP
zX{=$u%r&u<x0$4B$r2+WPR_G8tmUnF3?u)%<XlroiYhxb@`f&{#f09OQ-)1e+#wc<
z?kzV#yp<g@VZySrbe8{WwhfoV_>+#0)TG~CMnO8<9#-dyh@0!SC*e_-m-(ek`@WGv
zj7wvUx8h80aBUo|^clR@G@o!W($z)gP4Q&Qn6v&cKAJzawSR_O@gC;~H)Z$t4-Nh*
zHSn%9ZTmE^{!Q6zk7VIwVSg8==_Jh;i7?tAAaJ>9v}0ba<|-5`x`Q)~U%7{cu9>Fs
zf;d~9cwv@7xt1UQA3IU#EDbCt08|I7-cdyd^}w@RMW)7_S&n_$qbG>|{IUKE2C10-
zB<!vi+HcQVzdhV(11Uq3x@qsWer;yqJUpQj^KU4HTdpEJ{;O;U>V+^;K<qx#?V5J~
zGF1W++^>|<TQ}!z?><aX2NMvFvnF_?(gFTi?7l7s>M*$b<X^ZFD6BxIXYm;;lB-C2
zDK?eNkDq$)0%YX~xL3}ur|m{hAOkjGwj`nM@z|pepT9T_ZtVpioz%HB)}kNqsPr&w
zGl;6(Pu%&P)cg+GwGx^k_7ZNyNl1p=O-GYm+i*FAS%Z&@cUKAt>AL1Baa``fB*r?z
z*3^9tw;(}3lp+@ldRwy7?<me$fm6-49gP+BKMs;rW4j$KmT^lD2$YlH9aF@sUw)nF
z<lllA-imjg`L=1i?KZ+~eWM?Dl`W0=b_I4KYA>2+Q)?1{mBQ;`6Tn3K&{@?(Q7fJ2
z^(PbdXasPZn+{4Fg|k$K(6DnqWJ3Rw*MYv;w~`BS&Ha3QvGvC?aZcHsZ8x`)YY^NZ
z-knUlx=@y_`}{dR^n^mAfz0#dEp(h0(wnv^+40QZ+LLwA7}5<ak{aZ(amiKWw1LU~
z&XWeCwr20$9xUo1o>B?)^idzpt1Q>_Ww`9Op7zOzHJeQnO;Vl5+uOE!><Mj6<EUvB
zoi4lj#BRZfR*KFy#lC%J*`G46*;`(3QWlA{$1h)d!PkH8VeD@ZguFCr>%DH~zny(w
zvNASkc|-LXS5($a7QM|Nt^eE`h0-UDciK^FWw}-ig<aNX<gBYE7(w~===Ibz-Q5`1
z`d!T@F{q0E^qSv3vB6TI^`C@E>cKExs=A681NekfNBxF+VrKj)Kdt2r)_BT>@!ob-
z4=OD&y?94x#?pQA&wRKB^G<BGh!IhR{d>#yCrk@^QGZ}ici{_8s(Y5cq^Yutxf3pT
z5A7p;M<YmY)lBYgw$)4oKIc}b+2vP1+$cT5?Yn;n5*u-q7PYcRUX3>XF?cHBFg;Fz
zOy1Z2dUPSBH=K6=RM6a0-yH6mOEO181af^xp7m7dDt2)(b{a9I1hs4Be1ArPf6#^P
zOq3CqRU_1u_e&(r;VY6j?kk)6ku&w}VMz`FxpS;lF);fLEaYbPrSx|~(^AjfbWxs5
z?UN=M-N+M-2TRX0(uLN0BCCrOu<Uh%yM=^uQg4anw>#IC->Ch9+nSPiN%zIG+v!DV
zD}JPwi;q&iJbZRh{ozMcSfR0O7xKh5gOs27<JONF`=qu-y8b7T;Y;o0>~foOmb0mu
zdyhzC|2^U`%i{zrhpmifuDik{FB3>#;YfzF+9wT{ZRl<BM%yw?353bCqmvA3{b3(q
z>0lF`2H%zA5)Qh_G2M^;P)hF#(R5gm9Z={vS1H%@fVq`GIRtgqcyw?ef<UDAvcIt!
z#<n*&Wv;=a=Ru|;d6U=w(`#o_t_ui{E9k{KwwGLs8)X4@Y2z&T-9bsp`UuOwXM}-Y
zOZ&@YB}8YSY1>d;l}~)|6b!z`vdh9*(zuM#M)*F;@Y6dG8y3MvNU?L6*cN*-mbGt3
zc9Z^30n+bzP#_FNXOZ4KHAFpBB)60<s|+5tO6hjyx-<n2VGZ2$#c3Q`JZ6LR&m`Do
zo337lcb2+`yq}+U7P>LAhi;E}t8jv27QBT;s_)Ed%D)Qq^^~FXczXF$E58zyq*g?e
z%pJ!N(HD3+lYa9=33k`&62KmYH%bAs&^kP-Fa22BS4%O1-`7e?sy^-<r`M~x>>!{;
zpmBXdeE1DIS3y&CdPoXpkCjN~<*P!!*th3y#TzKP-*4<o2A#wfwHb*X^7k?HgMJgj
zl?`d@Y<<0tKO;tIyL7vLGK<vx(ykMgrVB)d_ZMt)eZX%Vn&I92B3|phgL(~iU1|5o
z<@dAFA4<h`j1AYBsh$3Wq#MxMRb!iG<gDoi&_TKytUC{-j8Spiyq+vS0bX!CaAo+O
zEI?pHP;lA2iSp`(tB&(|km%p&+Ue7GW|bpG>Z<?2or1{=%$X-$zWAPngRNWM{BBST
zfSWQIy)B{eC=1;_Qo!(PHwpF{1?c0tNm;2$-h)Mars4VM2}N0uj}0N!rkdK7=b^oz
z=7|8ag##l=bW_aaIcVAN-lHU4!0_VfqF>B)ZiCXl=ye?^$JpFxCs3k+3vbQSM2cCh
zH|2+G!=szSkmW!$<&=T*cIY#_I6GZa@Gp~O*k!dX*Gp61gxv1W?>xQH)eYBnesvVp
zg<OBJQ_C_R@%RoFq1Pla2R-J!i90=4wjIjCZ7UXC#1cq_sI}~V`prDn2&Y#*vb~)n
z=A_PP)Fg-{XEf!zCmp{4B*#nJQ%IA?YQ8jTbaA<blyETN^qnu#g|m!-6}ZH2d?NTS
z)0kzJhI{F`%UuNJpC)1Ayf$1;U(fM{0hpTQg1OoR43u+An!v1>CG-zmmxR=o;7YU<
zKM;G1G>?Y<FqVK{UxaiGCStcdN(1(MGZVn9+t+8jwgmtL`te2nrqzI*F0wCHGx(nC
zh*|o~2p@=jvkPtiTiq*7y^&7x{|#rAM<5I?-Nd1^p)%(tNratW(EK*70-pp3Gwt+a
zZqM+0B#jQz-fg%t>_=92Fmbr|$muR>$KL$)^kjOI_b~41==g(@1QdP80GMlOo0`wL
zr4PY1htnM1ce3tsU4GkU<ftbx419QgL~3+d7+Z!03`($SJ}AR`YxjKN4M@1&O8e?|
za<`y`eqZrbS1%`iz2&aiki>{T`gLrsbBxD*xc1Vy*2IB_t`;T*ei2zMy9UBUkj}Tp
z1FHutTsx6F>bEDPg-eRo?(r|JR^@Q#JGnnY6V9_{-@7M}>!Ao>3o#`FEd$tg!2fH6
zZJ+QMnv0!jFPvOY=UUm<X|>ynrV4y<jNXtU7Xt-gP=M2OeQn#}Kw&X9MRwb_GER9t
zp65qVz`;AxZfg4W=8?Zl0qAiPRy7ZlY9ToxA@N7Uhiih5z^S!ACOl$^O9!pyb;T20
zZXG{@r?9etuj}*OVnznOA(3%SI<}VRjo&ztNvhuQQ=Z`v3F_AGvqfi+7$wlS-pI(G
zjcm77382&Tl0}cRD&y!K_;$L8Qfb%V>X5i^;R85D1xe{z2VT3n>jGCc)~Cgp!U2fD
zxJI`-qUKlNR%^(tXH*EoJmuBCOYK!(EPY=;*f6>VA;tIQZ(&A@F|}`Wx`frv^s~WP
zKv+P`isO^4dl<Bu`LNFsKT-lxV*tv4O58Vha)|e}ZT^VAKbYVd2jW$8-Sq~aDZg+b
z_CX5<5<6ne^o67$enKRtN_U6z1+$;4%ePd1a6_xWv9be={#wN**9E_^cU2Z3LUemw
z0pL)Hjc$Uy>iF^I6ZaeK?!i?lLZrlixasO{8o~tCm3O(FL}Vb~8Cl?^(XS2zk+Pz8
zPMvUf2R#+iqXDlqt}Q?4{T>F0uQ&Vp`?J>d1e*N;-EaZ4r!?Bw4HNp3bgS=28uwu;
zFbXE|(YY^7A3M{YI7Bq{w)|nCk?rOFSkl^vZ_sO*+k9;vLC@V~jWU2XmcB2Z3VAo9
z5~bZlGrupO_7Xte8f)q>(*?lMS~w@DXywzcqv&v#0vOm}<+@>noK1KIuV+tnJK~LE
z_QsF~#vakitlMc@<y<E$v4tkQN=2g)VDy!N29;LFXS)jjm`=9wfw;Hugzr=LFyg68
zl`PzmCIi^9!ZPPJ&_ubW=}g@-N^BoT>;(BK0|OQz)m&E(Q}Y$bulLLEEi<mCZ)a_m
z^a3`#Ci4@`1SXMUiDrEX!S=J<)<OIOi9WQOP@iczUF2hni_O06&x+yq`>BNW)Z#|G
z9W38x?jrT+@SxKo#Xz9<jLw%!kvIVN^GuZ6qR%`&>{uAdhrCWPjYNA6f1YnN;kwMS
z(k_b}vzxpFeTOdrg?1y;b4lEQ)nZ?7FXmTKQuPNEg&ebIN|L2SiDN`8<@6QgBe9?B
zHQ4wz;Oa6<A7=|oEv+v)g#yQ6vHLX{uewgw1}vWe^hf#tu$f@cKj4$jAYV1_+edL=
zmYT<gO`{dA<G;g{Ol(oJT;3QPY%=@F<JOg@<9jTnMMiV!XyX%TOj<r&+{5v?$cHK9
zfXKm~b8@G_y|8P!k57%`$YIis0*`3}&*w3bM`L<q8$Mj&K<hwti4L^rxdljKEwj#x
zWU4@1JFP`CI|^(^334!6WQnIC(IItF1i4EWt{vhnNMme1fNh(quRy1u92Px=&r~2$
zo*U=rKM(c$k3>Rz<_B`WojH)-echrz)l<3ccF?m{sr!oKHx&XSUjO)WcH&n$V-V;l
za8+>e+0Uz*|I08A!Jc<D|246wUUWrao8Ve%kP+PQR!#TI%k_hxUigupXfx+A^$*tr
zhkQFBKBE$9Oktc;cHYQ{^{;;ZA6J^c*E5HGZ?u!Nt>`;Aqo7DxyUtXyd39DIs^PNM
z3+?HRgZvMSYB1+#%p0A>e9|UF4#p1o&Ib6ZqI(O)i*^di930-?3cK<wbT0~iK2#5o
zU1PwP<@)#DKD38_7Z3-PODm3|w?<u!h^s`T+M+0S<CjOpw<?Vn5potc?|>Kh&cc6w
zqTqb&+4YKZqqji@PLA#B@{d<yF*xj`&Wg_U<G<q4*RzrhHVC_3MH|u3>g~u6YfRk7
zyrw_D$dtix$6w;z7*UnTInA9~8hTA!>mXUqLO%W=+5FG0>&^6+bEC;l(0(K}z^1$i
z%=}5zfc3Aw4;S_xtaGUOMuMs)=aU});aj*6s43Dh7j?UIFNv!!r=MG^TZMjq%wf+{
zP1eqZN8h+Mc`+S-C-3^Rs)xJ!1oG=lRf(Up=$@CnyXPfm)RQ7=N3tr>;wn-rjjk2_
z=Dg7dpfSr_l}8?QLveV_Be2vI?wxno1woJG?jrJECgaqwEoQo%T(BB<Vv`b23qN}2
zr=i!ybF704ZVZvo9x2@R2O`Mzd!yZfT4Sf1Bw5tY+$DYHY!7Sy4Zk(gRG;B*Fxsom
z$s5=bTv3^TbCd)sWax#KFz7CT+=e9|I_Q?7B7s86NV}e0={5tTr%W^^T*E00O$Xmw
z@Ky*d3TzM)_?CjucsHF%!yCJIN_!5ta`h(eoGIW7=D0EUl{cv@$Ij%jg&>wT2ETQa
z{jwo-KSz9N@&ihH*_@4UHHqt|YhhjCGS)}tCz6Aj#qKv86-zG&;b5<E+{VEP@#fos
z!H({uF06O{jCzRSo4yQ0ey6>WK8i{IcDdy(wJ*~Bc^Teo<u{z0`IqT2F@|0M9NX0M
z(3O_-z6Oa-=}e7$!6^&$C&c0XH<7uHqCYI{f(x^TI@M*g3_?@f_UC5AiUU#5nH1Eq
z9d$T<<AWmzb80V1eUyvk-;J#;TfaDDW2y8;pF_K*>gf*`ls&u5P*g{kRP0kTC0>Xt
zO1ST)&YAKTNzqQXzf*hf<8ddLLq*Ev>t+*M-Hzn7pBL&Zu<kj-A5fkvZ8Asr)RKj>
z4inrqL!`RJ%BmB3Qp<0iZD+%0MUBUn9VAxAW5ow#yF)sWTgSeQG3;b*i;ae2SA?cR
z?ER{~Gy0Q}_HvH_tqwKb@HKjWYV5%kdsF)pWy3#h)iRY09mL!wgl`YzX<U|(dscNs
zNA+kpcHru?7A`f0cNke9{L1G#`U<xVD72!l@kY@HN1sn>)mAlzdJL$h-!)_2s5X)j
zCm{;!l<sfKo{T9kx-Ex@2wP1AC0J<NqmB4t-CP}OGDs@Qbr6}=4lxTjDB_zIT21)$
zUJx%E*O=+!@YrBbI7_>D_ZPRQewwjc6i>&p{M+Wr&(CZt9P6gbA(M~bm(qI-hfjgj
znf`(|7m5va!>6B3yOA@Tl#IE4Je?TlAg5L};KR#52W17EE&Zr68Jk<f7bSiKiL^(#
zddi-b6n*TM<uaOvk#z1Y|2}b8$o#cpvB7N*nYIgytD0TTE|~mYjpuxv#>_{4L{Y4F
zg9uIKFBJP(6)jIHmZt<){mNF7-tPy>n8n53H}6O1sEgm4=4OB8n0u%VD=q2R>ANCQ
z&f!{45BXqkcr_k<0W{|rLJ)<~U^m>;<gqVZrprPM9jDa905@|~tQ5eGcJ=?6jo+F+
z#YLsfEUQoGKfScxgR)}P|CJRxy_S2+sm$cVk!Ohhy}4$t_1=kmu1Z5@R*Pnk1ahIC
z&==*^7p^q6Y}=%44kEGeD8|C3c}rpj22Dq28@PCr2Y!CHi$O*F1}AMNyXSW<90J_W
zQO+zy{&<Rm47YLg3J7Po7;sj0b08K1=-GMfwaMJss>I;Pj%Pc$9P1wdc(^ZBruVX|
z0hitbIu6;5=FzKE;UnG)CJD5Hd}?64%8(tu`+P5B<pO%`AV8Imx^jGm`M|+PuVoi^
zOBZ&0r{<VyR6nZO#M36CMORFwFUmUN*HuBt(N3pT15b(AxDb|0K7f`YQpPg#U{}Sh
z910VZb4GM{$u6Ude{K%<Zx=FX9mo24-uP(x<mwNQT)L|_pE(eJ*wS~HL{6-$(g@Br
zPX8W=X@=h#I6l{$vjmW`0;-D_Ulv#)e#l{H^7&l6`Otr!59$p{G!JyOk8))+V<z6v
zMLw&s1tVXrhC$#hZ+mb*a)!>+RWr!UXauRwL~6IWr%)tkN8=OR#y$$GL1RhWAM{Uu
za@r>z#^@EC=zTGvmxL@ap6@NJxE5<~F#DQ6ut|<sWRkl$1p1Fi^MCnp&5!a%pO@Q{
z)_IL_;IO}lNNei%zIJeTkPv;nG*CR^Dm5Qq)ZUPh@3^fcT&AXZu=_W~jjKC*OD`jF
zE!*wY<Vp!Vrkr9B{Y?mA!OuA)Z)BUU?7};9V1#szCFIr$9(<K?Y3AtJJ95$Uq@M4f
zILOvP?%OqM{5n5~7v`vRO*uVCn^M_I=f3~Brk+ArOZzz^__)Y5Z3M7~08SsS+F~V;
zfJ<R$szH+A!g;V3zf<hM|A)pir><+9jV{s#?VSJu$jN>#);S_UTLpuS9i^W64io$U
z^3hW<@d{zxM+LRcqE|Dx>v}2ps1fMD!d<()!rj*pZ3%vBEne<D`s^76FdcD*`lMql
z(+FF+(QYt0-(Cb~I{`Rn)o)k{da)8!;h~yuIyB<8tB<+%<YqXg%`)RQStw>feIaS3
zf=E9R%V8)K6N=A}{)rbWvol1f{M4R57e4s*b09RS8%JhUc(}r7ty}=k8g=KKqq^G?
zSKqOJI_u7(flrEkcAhc+dCf{A^l{W@Jxrwl9LCN(vIy{#*y+v2dseT=QJA)_<JB39
z0>nH@=eGt&j6SydJpC-F%XQ*lJT0Ru-FFm&ssZ;3Kz)~H3Lch35Y&3wSJu>T|4y|*
zr$m;#E36nV;UF;s+V#&v-#~CNG0{t^W)R=0F2$@tvtuz00F@BQd(KJeg;f`#A7(w9
z!(VGFdd>U8ZA;n9#CY53JLTZmf}ZY3!DL<n24LUq5I`9X6Qz;JfNuj4uL^J%vQu&j
z;g=x6x%J!X1%P?1A+=FD!fuuttGHBv93{-__`XAri2<|!;HfoFRw*K<J}1ow*`OCj
zto~OT-d(rD&(L!%r5{i-+IWK5wI2;ld;df$LWZ#+JnVVgC(^*&iXt{ekEV+}k_hl0
z@+0*eFfqTgq8Lt~O{5_GL}p%RL{5jn;<S{>-GJGNK<lOD)Rg^Y@^PL>)*Br(jGJ<9
zWg`sA0LuXqo&YJI+Gdun-&K5_HiDf{&FE99gkD%eYu7}G+cT-eCPF}JoHvb9MWoGy
zfWFzbAXvDYh^c!3rSSb8L|&*+nvdIn0M9UC_c16Dx2rcPhc;%pb*8Pf-`mcqRNMtQ
zAbZKt#6R}3OK6p3O)XDQqpbQ?-8qGHeJ$|vkLiH-iFLB2h@!~Ae3a_7zf3<d<m{d5
zb|X-v&C_*eg1>bMeGj{+-u5zIs*Ow5myxuF?u;?Lbxs|S>qj)Lz02DRNQ~QQF*z6K
ztBHpI#TL6S-S2b#Bw})&j-vF~IZ3@ia=ufoVUx%r8qahGsT(Z*`Oe9OMqGMoP?DnF
z6RD^+mw$m4#xlHPZ&<>+wkq^P`WsInKN14~^TqCaAS9lK^m9GuxWIdPl0<)rrp@Ud
z|KQl`3GK8XADy=8p@DWzS2vlrE=1Ocu}^nJQ=X8<pt^LmG&A^kEqaaBaO5U;@;I(M
zHRVe%QZUbr90*LNHzj_EaJc3>&y4%$bKyBX^!NYA-CIXR!L@y(APNd1A|X8zinJ0E
z0s|r~-7PI3AT2o{B9cQ$$Eb8mcSuS}cXzkI05fx+jnDh8@Aj<Y^ZkGRV69oK*|Y1~
zS6{!&=8FOMNaLswKf1gPdcoQ6-Gn#=PRSza$C`pGZyK9m*Fe3VUkYaVIe10tu<enu
zNsppw6{IXsQgipL92*^OoC^R7CVkg#RngGCSDNgDb3SbGH0Gi|638`>6~0<g&$ucL
zGLJ?qz9lpqcAmixG7~r=ixLpWw#dt&6@Inf>3;{Z{a&XCu_NNa|9n;ha~s#d9GRVx
zP3gZXK7lH7D~x(zM*dtJ(9(2(JB@`%!~O_4+|p``B96xRl;w9-Kb7FO5d`%wL)Yqm
zI<hZAbd``YcEyJ+ApCN^nP0QAbySA08IdGaW|hM=U1@&qr%K(cDSDFw`H-v!-Ebn2
zf;=Zt%|G24w1h}y&MWlx?TAPSJnBZ?X6-UGY}8IVh$e%RCPn~a3Q`&gu<CHi&R*3-
zImouUnU{+6uXXmJ%Snf_=a}U|5&~7>*xj(xES!BZgV2K0!ni|H#}666*aiA72>Xt>
zj_yH&$BA-BT!WGd76BoEau7z##)5vR%y-PEd|qA5R8kEqh9WDon1>E>_@GoVhQNEn
z3B1<;<`a%;kj#QOyABI@dXIl;gju8%F!LN(*|LbT&(p@{>bQX&b*IOWlU`VJP6NWa
z@eoK|3utq=I@=j7{N$sE2J|*?=&11a%buq40U=#n$iMw04N<m+!B*0fSL;a3!r%ap
zMDB`2?Rt2|e5p?yF~~gt*OGPrJ>icUao`sMG&-tlwU4M}0Be7ciTR1MTLVE7z`{gu
zSLk<)uN>EYL`#F4Qsyf!0S5G2>V4>vDmu#iqL%0~MI}s7bwLP7uTJozR$pCM_TF)V
zEbH5e8pFgs+l&~b^^jgrG{)UW8fD#V?ZmwQ9M(4)?IWSJD>T$LM*J+6ze3*oG9nwN
zM!ppLDjpIUu4IxvUs8d~^`df&SY$N_Z>m5=p1<qP+h%xt=XFcgw8DM4m%iFh)SuOC
ze}36QCJH6i7iUnqHJ%>&LDP^@+wnT%7cvfaJm!QbE<P3^UHH!ojp1c*)0!v>E%gS*
zk`W)h9}6Y5(8C!u+gj|2#b9prC1k|yH`p&?J$}{?yKp>FA>2i*lya`zZ_tuxa(?-!
z%b|tk-U**D{F`GM$LqbRJ-r^$_pmTI-p;8#X#o^C!iii!pa_h&@3{ywipgl!FL0oj
z6EM8TWeK2ELlDe<oMW3`uE#RE`D1#jCt-@ok<>WS|DE764M;v^@c;6`=zEx4O%KuF
zjXu=%0V~opk{46DoBGxjCAvMZmBj(zj<}4j{+|#hhG3XJpok%QCpILs7t2DUvk5@=
z(JA406z(njSpAIYe+FHev~SDlw?2L1RL~ojV$W@9lU^9g{pgKW>L&yEL~8&qc(Y+i
zhxYq9jm7!Wv(XS$>7xS4k+NR-Fx~0NAF!4BY(~tv|MGvV<mHMbg{uBwz4C1}N%vRr
zGrXdvxge~n_CFzAlpxK31x+yztoT>H6G$<dGl6f{KlV^;Je>r3jg}`h&^BU2kf1zE
z!<L~9&V!BQM-IRq%RQ{*NQt`1)aCOYvY`_#eS1L<x=%AQJjjlRs!(eEmP4&nEZ))z
zo3}(gtYM6#u(!~6=o=w4-gM<6<)A0<gD-sFWXnpWxb4-T1H^Jn_ok<CERNmV^$8H(
zxP|^@u8FAWyHQkbn*7x4$cRj9MrB+t>z0$=Y6;SQ?VR$Z=m6E6gk5!qXpG#FN_ACN
z3+0va=T9CV`JD~QW=}qQgg+LVF+mp{Eofgd(>39oXJyN78uN9pwPJtmCL2qg!s>oV
zO}U)Xm(&kwa;5^p>I&Wz6vl}5Z|RLSRnUiR&tp${EFIbmYJ(CTXT_8lzVJV$yZv(1
z>s!b5?h5OmBt*o#TJg>4iRgL+BuqPe8K+orbB$_+)T_6qaKf5c>TP&*5bNr8>}e&I
zyTr@9+v|t6J$s4yHIvRiS(kOw9f|4_HN6Q`3}hFIA46swv@qSy(uBc<H3i8w-Kg15
z9V5Ep@!_m4yz2eY(w;Y_&6YNFhBo75YI)8zlO1J&6}84^T=sF?J}xVRw<X3+z^a@r
zLf%RKR+a<vEN+e74_j64tAcHgN{nYy%C@+LLNPAW8wH%&AXsW`6VjWaMP?&aW-hkt
zlvwIXST`X}M&vLj!8*fOeQ)i!Fqpve?bzxIgzids47+W^Nbqo9p3!*b#D^79ffM?q
zyN=Jb>}J`n#Yn8Y#VzG5Uru>@rocU<B1?h$#;WEugY$KYoB8qC8BvlnU4-1~M<kC$
z*_bA#1<$6AbCe}&nWENKTc{jgG_9~c82Yj9q&79tnJU2N%2bK|@=#xBm+S^;*i07t
z=tf?#PQ@EEtNX7clcb|w`st=vVo0yu+ica<c^Wk?vkUsk<RM$msAmLDTG`18+NcdY
zHnoptdvrE(Kea1RX}D!>*;_h7sp4HuT;xJh(o5>gAa5>lD<zFFn=D2EhxuNxobeB*
zsaURKFSSv0pl0T*TyXkMp{sm4yVS1DtL9Y&?frs(;is;=uB2GJG~4h{Y%RZ}KuR=_
z$CqKoXS#3S^$;b_7oo6iMtVpFJLm}Q1UOa&Qb4`AL1p97Oyi!PUeF?eLK^xJ7*3!F
z!Yc2EFfbzYK3iAmwuf+DH9)x^Yc+;da6YL)0Lj8Z0mCY^Rw{#G8(o~k3asA-TTSU!
zP2GbyRbJps79Y4uJ?}n;1$ebgpQ;bw$hroehGLz(d4=isgN}CI`v=PfR7^4wG@k7?
zMnDI@vblQ5Wnlob8_j$gn>Nh51d>-(i$=hAe4h3S{2IRHJq3&iZ3}|--K;|p5j1$R
zaqb6xo{e+C)jr4;vO5c^JT~MsaW`DffZr9r!{C<X<~RyFCom8cwhUbYE7h}cF4b-u
zJ;|QojQd5VD02nY-CWKL5P0BcuVH)97~aNl$09AfeQTRx#TV&ql`pv~QTXXb{3STZ
zM5m2C2yj4mG&bkCJFzrJz~+I}3d+@u?9s;+AH_aP6mFTl4++X`w5;;URT}63I&>y*
z^}YaTpz>lT?|1miBsP@*n#$8~i75~o0pd)w&$*r+id?{yUoCJ>c?o@&g&dM4eDOiP
zM5xZlA99eLR;~5Av<UqRfTwr{9r*)`V~$PX=z;xS(R|~QmYJ$W504&<SmM|e!{=hy
z|BLt%YR@K-fCai`c3F@k)Q+B%Kw4xp)4Mvq)U8Av0lN<*CU;+}UI(%md>ni9rhe+c
z2vg3hh`oc%0cWQFQOi=*q*CID-ExB-EHSh@i)*f8<`<x$u$LUO&<{MvY8WzeF8yD@
zkc-tgdMyJ5SlO$_HVfEYQ?%6<S77}71lLlu&X#b&pa6_Dx)-QuAlVpOuE!N_s_=5Z
zC&gCT$9Zkg>*+&u4{O%u+>-Y8pc~K_8x*uGMI+%oYFZ>R192^yyEiK1y3hH{lol@H
zk4hGjFu1@zr-g=Q&4V-SI)NVcLz)X@Lt-ent!jcR?m8`@8!_cP+d?0=tPd}ZWi1(q
zJS{e=Dd+j58?ap>WwLf|tVpw+SdF1AlIMazHS@K*d)feD3v7Bzb92OJc?z}zDz#tm
zU2pncO98z8kPZ2GS80Y)G3d%P*Zj!C>Pp&YMW}0_a0yX4j%aj3w85I=$8?Q>*qK0)
zf|wL1o@nK0-l)0Jg@v_5&XnJwJ~+_|mqN=SqJuRI7V9173XmRj6DF5*hMOs2ZHcsy
zI2M=VMD^7Rn_iOrSb;ch_>3_cc0Tg3WB`sT=>RWaG^>Z>#TOc`&Kjlf08)c>D$DBo
zIgVEE2l#};84!GrHqIR`LScl%PPiEkcZzhJ&S7$IUuor89zYjlCLLkj;HG`~ROJZ*
zHdZ0Oiwxe4bkBM*X6`jbqaR-A64jWYzzYMt;v|qv&`a#GXSTaf1C5Y3a#xO+<7fDt
zV7Ny}bq-GtAvOq-(A1s8G9ek(q###Jd|IdvKG3ACa+L1?IEAC$XZBn~%3A9zUGxwi
z@E?$QuB`^10PO$@hF15FFQ6H_!_Nb3s7oxSBD<(3JPz<|P?8+7VUX3!<CB8oBwCXF
zyeciR((vd$;V*(0uhu%K;RB}mkC`A%w=oPEx7GrJh*ng(Xx1z5)zH#gfSqyu%6)x`
z-RN$o?h)T6Td{q}F?N`pU`I6j4%!~?#2{I%aWTjQQzvs}IrZ+Y>O)~^@;uioC}Tb#
z!_l+E7^v-&ZgZLz!}}N+78(Des}3bt*w?d5gSSGpq^4vcsQ0E3<lR3xLgLP~2B&IF
zdu^{zPE6G)AQSz{&ZfS$+pt^J#90xce^~)7t>!bJh8E2E*IDD<WyKRG>CWdUtlWb7
zTTd`zpl0<#=mI$ha)?#RlRJlfzNU0K(J^5TE0>||sdRL}J(Hn1<3QPj_Y2JJ;2F26
z?~MlnKPmpn6(#LLY#0;7TID`d*5ykm4OW;*zkD?ORv0FW^E{Q8Cjlp^^G?ga6KINJ
zO^=HX&)zzAz>ulR(i_!Zhxm^$SC#*K!U>zP&LG8?dN(7>=%@!#!I1gf3p;H=fI38{
z#plpXknwhP$PZC^53&oa;+&dSc`2$b_7hBCCScIJ1V97Ket%?(QR8yI?L&6Y6~uEP
zt-){$|M<;TZWuoBEO~Pw)#|EA_RhMXvycV-Z#Cu^b~H8FqdG`y=-j@LVmu4&ji>?G
zC<w6`Er{E)bo9DFm;BId#CBgqYyr1u+H_!27#wKatI;nYl91m{ByIFqR6BmdA{F>W
zcF-NVSFBU}6}Sdeq4VlVab--frj1RSVqUZT!dNMj6ksL1)wm(d=bUiC`yTC{jRGZt
zX+&v5v71|&YvP!Huz*V{@wMW^pGgX%#xxaTm$@tE-RLaJ7B&bdKrKv{fuPO1xfT@!
zq;Z{2GNEDs881Qj<I;;#ShsrIzB06cSJqBZ#}aP?zGX1@u|swlx=)5Fe>mxp0vt39
z%A0r$0#$1jkTxJe{Y(n)4;y5}9e8ZkRT0g-V?34w7i&MkuD2%*!sr0D=T~){!vxLY
z^cO%iSqD-18C^gQHHMaFPx>Uyb)i0D$_>hP*g-K8SI?lMxFe2x8919?5yON&o(z=(
zy^52DQJ&f7R3R4-In&lqQ3R%j<XKf;nJlx+u($powfh_bI1V?v)&T@P8wQ5<fSu6h
zqC3aEL85PwWPhO=c~p1?R4794+oswj&3$wJ?7vdo0o)7j988MQ{>S(FRqtyr8P!Px
z3QeB@CIS`a9>`~@`I%y-2AEHnx_i1|2~pFKd{357hvZ3oTzb&|;8bR!xMm*0@K;f1
zjUSXnGm|;(oermg#P`GZ`nr0^ucztIq=B|BwceQ(Mzcosdd%1{Lc_FG-pqNtZR}f;
zYf<`fD|>DCGelRizB*#TtEdCIq!~K}o2`OhE>z9xHn4aCP><!soyhO$1wD@WxHb-Q
zbT!gW+)2F#BoS!<_BLdN;aBoyh^$DFurdu)=>rQ<7sAb(;CdYX7`*jplyzG}VMQ@D
zTi)Bk*E1yp5#Rj;uBAEN2n)w!^!KIU4l9r19Crv(LfvR=hgU#P0rnxt<S67cpB_qV
zAKm4z8&IBk9&9M{;fSvWyEA$P`_oIz!P|C%tL)?@ORPT2Dj3dJ@)Kz>%t036GUMDO
z)t5k5G|RVbq@)LqOaH+lxlXNgX(fuwyW*6#;NQuju@m?A#WyP*2}vLfRhXn8LYF}o
zv{X2uYm+>`V3=|z{z?6F{jb!u?mH849(OuyzA)iQUHzaIPAQ95oSSP7sK`+c6h36M
zihP+UbE?!+x%8Ug7oLRA*uv+x^fyzUqdOwdGJG#-Es^q&Cg28J<JJACG6*!kqJ7fX
zLu)FR<{6!`ilGOtb#|MefcM%PDe*S-J2q*hKI#GG78e(dj7sXaq@VMJP!CmVzMqr_
z-eB^ON?^nhP|jmLp*ZM%a-=e&V@(XKIDR&F3t+`vn^9xN@rcoaGY9-9<jB`sq93l0
zXoc+Ok=MlRrU=dG%I&`ZdAY?>AX%6(GQvTzb5~lBIf(?l(TM`UpNleLi>k1BT!8Ds
z+bh2^VjDZE2BZsla30_`;)nky)+yi1to&hSuOQ>YC03b@D|=3~U%g!5e`dzBljaq;
zck;n&OeQT5Xaujf5*urENZSdVHsfh)M?*`W2*NsnBn)(UWLoKoFlh>&BO?15y4g2l
z8NN$)!r5yfULA+CWkfSJdSt`F+)do(Y!QhBVM77j`mKQ8`tOvU@7}xSv;4Z~oMU-x
zT`^et<czLB(j)tkU=iOdw;9TPq@BCsR?yqRcS8y#<rF`cG-7w+j~5Hv^C~kHB%(<U
zIUko*Qtw|gHr%`{119Z^mDLMfOga(6)l0OVktumJQN*bo*(S)I(6<Mo(+}|QSvqOr
zmraV2irL>ieW>=i_mw1#m~m{5?8Crl^*OEaItR6`ah55kOe&4K?#4HAJ+<KkJjG@+
z`YG+@PV|%cV!2mjnPCaxO7*r>rmNC6ck~*rzfPPhe>E1mM)pJJ8L{|GuXF6+bAP9b
z$2u=YIkdO8&93_1EwJZRs1)oge*>9{J!x{cjh3)EjT1QR!!0SLPoL<wwt;+d6t$i=
zoYYL_J|9!Cv-q^?Bc7*lRcFCEn(Dcx=qs`Ovo@m@ci|C*W=^r}$?eoD!*Z*Ul55rD
z>5EnMmMT}1QD4i7>}L6dO{zS{c&d;2)IXmGr`O)@<nC?0IVf$>x)$M6w&iKLsmP`)
zpd%%3QA;heR(?wVyzZk{RHRx^IhLSz$7tdX^M2?sp%b@5aChu#P;|k_A%D+V9$}8r
z=bzSzGf!RS2P@-S1bdlp+ZU(V7tF3*)lA%U>^<ykb9%HZv7>vk`}v(_smX)d@}vG3
znlUm5+MTlWw0ZnrpAwlB(zT#DdiU;s(kz=~?dd8W;nQwno$@XGz~Oo>9yC9*m)P_%
zfTGt{TmSmhDt!Py>D^b%qrM9f{>V|Y$-1ae2CA*Bs>*~%U3d$?t6)-*G+0^!AZ{FW
zY7oBTCj~Oj(zP_9ntdnSMduZ52IZx((<^#>oLR;bE~4tcn}0%nV<~xRBzxVQ=z{Gb
z4vI(z9;0*cpuhj`5tAS4zgz>mSOW%=;ZNw76=T{$w~uMB+S2Dhj^_}F%MRsVei{>s
zJN+)Em)UXg33OH^06p!_pr>u_Pb^{O(*KN{;j{|%Ms3~2B5D6w?2lrcEN-j-8MWma
z=dI-utv1v)ZWL}%Cm@W!iEQ0}2?9{vg4FBfM|SvYjpWXalP7^0!={*t0<M!3U@OLz
zfuu>3Z&9<@o$tg!e38tSoQy^qhy>qZ-r!YULKI%4BS?i}WrU$8{D9sJ8cZbJ_OOS5
z3b+)#qWG45>pS8-HtvU=P0@#9&=YH^$|?uM6Qw4gaZTjit}T*PTEXy!2zLXklplEd
z4+9^kpJ>f}7e*vr3I@CrpX`o=<&F_p`&YdUynXs}0FWX)-GjbD1b$#^a9AOl@WDX?
z3V?+`w&c-?1Ia5uo+lPHEGO^btczvg!4_Y_=1o$@L*yGoL0sju4cZfT(TbL0O-R5q
zXbg=ZuJLslhwWqmg)R28fqMqsKUgWMQHL6UC%?8PZwT{Qhxl8b4?aj^gG59k;Rjzl
zZu*?9tS9-D4Vk*!`-$ur0|lT_tLTO$cx!<orwiBO8yIQ&GOp#x>&DgrL?4PJ^E>HE
z4AB~ftc274X#jMe>2vSni+*5Y_}#}hd0Zh5(N+d(Q3hWZq}mp;%=QY`CpLR-pDBYp
zj_~xgI?y+w5~D~gc{?9N*@^v->OsVqho)#~b7hiZJ=C!iZ)6nYfNDY=CxK;p1+t*k
zBbC7v{=00nkV)76pc!%6s}?6QI)^b>LeXfxo}?=v?&-%8iKpV-y(`3#NO94hg+8>(
zs1r?#kH(zwb(Y!Uolm)<aIG>Ifo;RN3!Udh$2+A^&#oT;q)<Pid26B_d7kDeDd|Nv
zoE>6BEj7G3UB?pYz;m2;VkW3R!5>=$#>x4F1*cN7*Puh}QP-*3Ww`)ts8OCL*3!21
zZ(TJy?a$~6mRV=4DpiTZ##;|OS2L>)sL_iC@?E#{ZuG5U01Wh4>2BYqKjtc{yTqrI
z8ETAy(lTpaE?sQkA%G7F8JblV4Fu0bk-vL(?HIZs`!%XK*>)M~I1;!3NK0L6Oc`?>
zSUjMjBGdlM-W#Hk#LqU!jv0WJbR##Wsqouo-XMbyxP}R}&XG^Bjz)|CNa2E(%?YSx
z0e~AByY%QBRH<Y<G4FZJuS!PD6@b)yuV$nJRm%1oN<wuf@~0dBvb9D9P<}~2;ifYj
zX&*E0+hbVM?|L*|#&Gfou7->(=iyHYm13llA{<ExSJP06(xCWrc&>aJQ7`Pjo`zzR
z>BBoHMoB)-D#09cTF?YQ9?4=#7S)ij;~dGtB<Ax8GiVTGFw-W)XVCOA`4e0-htg46
zLLj|`$kS)`^*r#_k;n|>TjzwnOS3aS(v5(|J?uZ~TyFE3{h$Q+jMz`#8_poL3ZcE>
z!2{_=v1<4~Gt7tHX5;z+IRYBk9EZZAEO(w`EueO!;M#MYTwm`;War?#s(+7nRA~G)
z)Y%0k0SkDpY>758MO~=;@ZCDfK-5G)T8G|EEUg6N0NUg0_-NZVmms~Sno)>IKI?)B
z(cmVGY**~i;9#y=<<sNP8$<RPwH>~{gsyz0is-O|j+FR(%Gc=Sc@s3$1=)X+wi88s
zND7g1LbK8OhigP1k@kr?uWy_Ubg?Bp@D@XNFs_HgGPFFyY>@hh3(%TGT@$n7bCg5Z
zW34f)bYO<28R)k29nV}dWZrYY03yIQrb<R^G2!epWMKNEF*+Y0`#>p|yN3Bp)TK?-
zo-$|hT8v{wt$Ib(Co`WZNnnl=by>wZ_IA#zaYe>F0=>tB0STM{i$v+<gUAyEU=oG#
zV>i=QDYE4&1n>ArpjdIMG&UgzpkQ6x?2gfM(bL21o1I+eRYyqtH}zK+Ob9^@a=A9B
zNu4Rj!(hFt+2;1wGk~(-K~z-G!E1HqKH#Fp3W}W^`X}HQD>;i6P>-QQO`s|3FBS)$
z$Og`G6Quz((AgI_=$F8i)6|C?9Wb-6e?1os3wv%{VOMd8!3M!pAp(j$+K3fnCvXkc
z*^9!c*u68vLBWyjjSYL~JXM;F(XO5%443Tds}DV&@I6|WE{l!|+au||ii502(D0#O
zA6{$z7^R>VODK(ey$VT4bI>0TpPi_w^T$kroOoD?HX!mt*j(2#Q;3>cT(BA4SvG10
zv6V8mmFNYpa-#Js9(o*`(zv&x`L+ziyn~W3c>3Q{`!F7e(KPPK)F>RJa!#>eS~@?K
z%#tYrNp4LZCnu5#QM9>X9_l?j^NUPKKLWNi(bqrX$*uOpM1dpRtrrPO12brJl_}Yk
zF1|Ome_O0IJSiFZ?oP2`fA3Nby!fgSGRPS>1p%j_>N4aBs1UB!wwC@vG!0k}sv)r=
zzUP4Lw5fhOdof1NxEl*O9Ybok9!fv#IOqd<yxy$SQZ7aw!<*`rnzqmSa5yh{BT?fb
z9%?WLs+ud^aB{&fdczLL%En5Vi&o2TjL<4R0oB+6R3{I%zo5S`90LaQ4Age81Zuv7
zjliH7hN35FY`>NcAPdS#As?Vyc<Zo?8}7HZ{ak|ZX5RZqfP={+C^RIhy#ogVFDRYx
z%^U#W1P&LuuPUeMN*Ak%1fmP*S`Uw}J|=M&CiBPIz^a3V=}6(^2dVmO)YM=;Ik^+W
ze7cp!<MK*+46!A<T2^l!;1djOFXGjlo5efK)?t9S*{>)i1hVLD``Duza?wwQJHMo-
z*mrEGls*^wg!0Wsbvrt&J|`Ljha}q>CVsbZfvR$IEEmRgkOe2w4zI+wj>@f^0jU1#
zurS#bS&)Hb0^A3&nHY1&G$|20;9pMl#V~2K_WxSg^ob(YKl6vWFG2S~oRKPY^44ei
z-{E4-BihK3!nl_R=c;q?6Jt368Q&<>9{>Ja$g_Ru-wa!tLwiKpW{E)Te}hrWN4nt@
zJbBVPDhP-Nv8D14mgS^>TOFuzD|BJsmF=6<qf2Vj3-2;KEC#}JaK)hO#b*ARytYE}
zNr8jKa%@=e@*OM=>WCM%P0MfI;NYrMWW~vT&`v#)lI1j!<YLmN{4B=(0`c%>8Y1OC
z=3X^<g$oGp0}GRtmtS)*eV;8o@|)S4H(gE3w;dwH*R94mUwdaiJOj-UKr*iFGviZJ
zIOeKme#S~_*5T~)MDID&sk%nx%csIBQgRgn)Bbo^q@9+zajMoeW?u=WTzyM+RiDK;
zGx@H!{ExMlK2NjEm1j^S!vK8-ZO==w{*_FieaX1T@^I9c_XI&yUwqhieX1e%;n|(8
z4~OUWXD{;*&sh98JG)sxgk7U?#}e;jKU!Ip8Vx$6fLtudepb%~{txX_uDQ@lhmc`q
zV`95`b?Mw?TrVx=GMM<8PQ1+`!NgAH<0UTm(2L@w|8y-|l3VBs3kg$_ZloCDAfE)r
z8OM%_7RZ17U)xO2q425JVCb9rnVjI=na2sAL9wRT*?0Vn-)X2wN5MRvJ~~lLH6*eA
z%<|~;CzaY_yu^(!T<(+_!7Hx9PAf&3hJ5e6x2euDD)Nj28LNtH5>I4BFSHC_7Iitz
z&#rb)KNR3dEXLVg-e-%Gb)y+gR(&F-dz5@@)-?BnOo!KKnHG5qb#<ZRL#gT7kxz%}
z^L%EDR@H+cwe%=b>ZE6)>iOnUcG7Z14sT+YqJc7wr$ALA=ew3+F}-=aJxh3u-zi`C
zeQqk-Q|CCW<TbJ(D(@b1mDeGsTJ5T?_#Mu%st%EA>;qC$qDPvcR&3ajWmE&Y54$yu
z%j-T04VlbQPIo76Og{XguydqI)>_0!Cb?M1iN-E5AHnCMAy!FIU9^wzY78@%w`Ek-
zOZ(EfGaJXsBEm0}L}0~9K}lE3_C)Uu=~3|f&ffdC-#7Fs&J$le9wYm-5vQ0XQKMJ3
z6kK{z)l?`dD3N-LMWTnukd01F)8*YRi_p+vXaKxR#3tEySJ20rP)+$zxjoR9kKAI-
zxF%+ioTb*qX|NX`)n-GdAj2Ezru$C*TL-Pp+o4w?UoG+zeH}_f32%Tt7#+dEKkvg5
zD{hEYwXyJi5E?-US~L~hFbNuR5FVkB7HpGe&zBldO*Gd|pXZYE?_+&qZK)}8?b*v-
z)gxxrVJ9}1EzS3#Y5qC~t+2py1L}86w$Hx?OMcv=RN`ZgbC9dDD_3A3Jni6JEtTk%
zjN(!^HN^dCB9Q+p_JD}8FvA%+nSMd4a?JNN`{VH1kY){hB}SIaPQ-{NoK0&xdui8S
zeQj_-P@qk#%s|;O)_8R8;#hEuiT0LFeAIBW;!vc9+!d!pMPlRP<-~iC$u~#8F@mb5
zv?rJ1m@!y3EzV+6X(Vd_Grv1K*Sgg!^DA~>u0Y%CZ^9(}uMMx?`PuZ4y77<_a3<IU
zJG373a|a^yRaI37Hxw8O6RKxNz)L5MYP?`Q5>%3q06hzpTIbBDMt*jvLz(w0Pp>&m
zjnj0v!)-I`@mgca*L13&R^q2nUyx1dsfj(b<2elqwxH)DM~b?shatruDk}%j-4S!@
z53&qQRSgS)VI*k<v$UFD0nB}QxEnVKf+|xQR$Vm+_|a2bFh^8}je3j*7(in{*67i>
zyz?HU-bj?l*3A;tLwwH2GO0E*huL+t(8*y;K6_5w2Udw3o567s{pnYrtOH!bB<-PT
zV-pkaVOW3`S0o`1S5CJS6k8P=?=5^DEQ>u(S^m@*1yZ@62NBSe0VfkEEGm#K^WBEH
zl3-x?cB_!XZisFpZG8}>c}G97Dmt;_8}xLDXiILviqbRCf#N(TJ2_`#8FL-hUY<DE
zAC5zG3Dl|@tyF0jB?AS~_gAV^FFGTgP;!@*a*3rNRVw6nuMzWYdI^N!KUm~^<iiqv
z4}9`r?PY7MtwGtQzC8cQNjtW3xw}IFzN~?5Hv!$}QO%Cu$A(;1{jddu<mEu$Mjznj
zb7pOk8im^k=*~c;RE~}R!D<~=uziza20wzJ6xco&m)Jc=9CgA-Ua<B!GKYH8jM7oi
zkOPwzk)a)CR3ZgH;mRNQ$&3;_+;C0<YUmb6mvfC85_rjTqu4vrA48C!`dv3m&ogu5
zD(rM07NFEq=(xGb9|??Nv&*s`-E_=&67mF!x~}P7)*y0E>0%ppz}sR90+oFfftPZt
zKq{qm*(ycBoZ^C;ANXKznCcv1J~k!*{WDb8=vIR+nhLRE1g~Yq5WR?F$T|_`>ee~_
z1ziF{@jCj;#b^mp8ix)W0RJQd1$OGl#S!W~DgPrr{cSBt@r5buNp%!<7OWX+1Ij*j
zfk(g5CAZ?V$vo5)gVi42?UO<Uy;uq0bY%lTNQ7g%KsJY3L|<?oi0*ucsPkE6joeKS
zLYir~)sJW)$Bwdkx~AdV9*OAgFTg4owlyu_m&L)57Uaxvop<7)f3ZS#Ocd#ihE)M}
zo`sEIXDFm;c*Ck7OD1qdo-P}4Gyx+gGqcXdI|o6Jy^JhZQ6p|HWHQ&>M^#FDv9kq$
z6KxIK0qWmc4Qx&p!wa*Siah!Wy@FVhS1y(<%z$`sL+9@eKLEa9XMk{PMJxTnj?Tm<
zfb~I=EbQ#{Ts-DoUfd7CI48lPcxNUb#9*3G;A!`zFStNUhxe=F1E*h<m>5bu`ctM)
zXcFikf^}O7nxM3^Pe+t+2JSTbs309fsh}ea%RSP=U|r*P1>0nwkH8Qpee#+$yF%@@
zqWS_&C|6<UF6n?&|9;#!?*}##sm6v3%=*-_8N<#gO``=YECNU&w7ICw$q9lg#@n>6
zg6rGYRh{SLkoRfY*H<1~Rj+knOE}>`7xc}Bfp!?dHVV`(6u|kB8DC>?;k^KU!H-z2
z5bl7Ir92mr@^c&ix?zWwg`5DDt3abi4zU^U!wvd}3=HVev?DIbPRdzI<PKNcx+<Y3
zC7tURO7xU8+!Z)D)I)OSvSvXB(KTS(<pGeaz?xRkOQRtj)24qYb}o?ROeo{$Qr*-t
zC5?On%MiA)Lb<l=V~w;9-ZQKN7K0zAoPYc^;{_7sirA8$A&}|AjF&?_reSj+Z(SaD
z%f8oeA}wncMCd^-wO?jjf1su~Fv59tZuN9~*1BB)r$?f%0CPkOfH~3b{pxpEgTVq3
z1T|2Sj>*4-{~cj`GI6KOV8!_IQEl8TCOUhyb^uo1pGT5<1G3MBsW%88eF7L)I;<(+
z3DqZI<oT73%P$NBz~=kVWo=eTyug{>_*jMS{o8-A^kIO>;d9=#(2vMM9fAtP5q>!B
z6?ooi+44{llDPwQRpUu<m0Gj_<2p+YeR|jW7G##~QcFM1UG{j-HVwIq(BtR7G{0!&
zpJ#a%fFb(9q4ugkfo%B8FOWes@_zUp^sonkBr|7&EQBJEAfOWl?W%#*-hlc-Mzh4J
zW!+xGRzkoR<kv_rnfyk`+lB50yB)Ls5J1;d#yaAwfQBVduSy8UH@tdZI8h5gG_nZ7
zUcxA$s%)u}b_dY;7L@fM7y3~I$Y`{7ms5Q*da7wu?|*qdn=T{vT6@xnqvL#f61rGW
zb%<#H)WT(>18jhLPL(6--duOY)@SB**1Bk`sGB0CYa7}hZopC1ofsIEhq!Aa@NNvN
zl?U{&pPYNHy;kMg(8-dkaEch>T0;}s;^ee*)8B*Du!MPLXUzuugLRAb(??rM=y<lz
z&Tu!9Po{>ZvBhg{pP{*I@cgW%?cR9>Yge~x%LA^T;u1;ZANWuBHqlc*`bK&o6LDKW
z8#J*;5*PT3Ogj7jg9RZ)O!99G&K={18_xh*H*GWwBDt)9Gh$XXjNPvUg_|MPWAz|@
zEM`rTHw`0YZQQ3)e8Fx}HB2;H2H(%k;0#(FJ1l72vAWUz3=?C_M+x`BIG@Gq#LKQ0
z>9LRaJ*0j83`17Ocf+9zgeUet&sDk@b+{o_*C1?<pC8<+xPZ++h}&_v6^ysaX1XJT
zBBsI+s&G$so@Ph_Z)Bodl}7?%5?|;M1h8$xco&ihfLjh2c-2X4!QcYkWieinhLKWW
z(PZ=?AiojE&yGh7Lg7BY;=$<4yJ2+0@!lu~F3v2zl$zt}_m|m?hMynnWj$T6{~9g*
zu)40PKF_%dXTMF#)UQV0U;gA{#D4JHb3WG1`##&?RWvDxDytd%c+ZC7#znEdjZ|Lw
z#NQ9BXS0z)A&wG^RQlc1zQJ)H7eaV)DPa%G=oO#%JeU=D%_|{97i%aRL9<~Hr;Rg3
zQhn0fBpL-;%@tMyf5eZ9o=^cz$UbQ<92XN1h`I)APd5<VMz32y;*i6Q6ONIm%%EE9
zK!aam)jPE1_4?bJ|6nPnoe$c_Kv!C!!$b!KB<a&9!KTQ?1ave=g%MtXgj*fqW|-Fo
zz(%dc&#^Il#xAt{Y1$<i9MJNyqZ&E~@#7PEmG5(Af3cEXLzd2KO{Mf!4g(uRob=Mx
z5+lnMd0*kpnLq*FD9hXgIi&3#M6=^4V>f1x?8PJxj2N;uTQIpfsyRT-qO3phqqXdH
zPSvGt7W3fAyrX~scFV&_rR|hQPOCtS`oZ@zQ-s>wb>cARkOc+4{)8t&2As32{PhEt
zI$t$7`$Y#F?)XK=(0esuF_pPDhy5fGpnL^En&ALVuesowypF1;Rj6aT1S5S5+b!{{
zj@Ly9Uj>z+&2~m^RMtQbPl`*=^56DsA--_moB7UO!eeH*?8HOU&3c^dgAZ+v-ccn2
zNkpKQw`k_o-3rx@g~Z(5)jF;}LhC~FzOc63dnYb%FZ}a}Q^t>{_W-4+2R>y>$n=To
zM&iGd5EV#VI?S_FjCVGNya>+Xi&-<tI^Z3misrT>>@#Kawz*}>>R;=&q!+Dg=v2eY
zxTQlfQE>~|v5+`<M|S4wkab70fu8)$44I`$CAoYF`n3YLRW9}gsR3j^lk<WM3gpA2
z7pn-+;=ZB&1p1jgHFIRE=b4T^T-ygOC-~0Y76kBc!p=vGbUxO<55LQ6HkNsR`R>DF
zrG_qLtUC<$Veq^!-8WO^S?*!`#?bZ_=GahFS>24?ep4#-Wr^t!SL{rWX6N-ITCub(
z;=9F`NoMD&%ja5N%t>{<Kp+t9XSpB3`ar%$gEUh0ZTtzO*b=cCTl)`|s0!c?pwJw$
z@PeNk4yp+*3$XD;OK+dtoUcl6Ixa-pF=LJ(xxt?d^oi#ChE<NU1B)$FOlLzq$G%ce
z;Hkiy`YT_fDI2e)ZK-V2eNT1sm%3gguk*mpuMc%4?x)LU32crxm6d**a@A{~*F&Xl
zYLp)=19twaCHo-;M|w2Elia;e^poXe{cUTkUrM8KJE0y#V4ifYmwkerX<LR-mA5>8
zmx@1%KljPQ@M0>7FK*Bow{dkFrmWF*!7jZO2D>x3P|)<5*V~SMo5?+}TS_{^!!6En
z&gGN0j`f3g04p$Sl?820f9y7W^cpV5EyC8HNUK&B1hUt7x<{lB{6UEe*a6YYK4=<3
zcTaYhWbYAb48?-5NqFmy>ysxvYC_j`Dqv{ER!im21zL5b@`<CHVXR6dbUh*=0#t6@
z2J6GxzobwBTvL{I!AqArOB*+AOTJ6`Qp<~zGbs~DO2ApR)cp#lFuIR^7m3G>ex++m
zb(ih+kdZIpSp%3>2mm$9xmVVKK|&TJ+FE^@rIUP>C~~51m<edCZ5algc&2s4yMwwB
zwSa&Y8uGpkwc{$H%|k&BhEbVauL&RJ2Fz!;?(vjt{;kJO%;;kbU$5SVD)~wiO48Z&
zoO8E?3-eT8JF&}E=#`oSKhDGw2Ec(C?Pttc0!9r#D?)0R@9#5;TCTIq?T5q9HqP;v
zYIa?0#zBM2?p9T6MxCmEuw;zpF+?YL^`=4g7e7H?c1*oD7=8V@(Gf7g!eJ-sux8@B
zDAe!W#5j2?B23e^G@c?JP;x2h{DXDB;}~QlrJtrW#&`ow_%FjCYFXnjy`1SYL7k3S
z3n088qv^AOxrmFM#`cB+kQT|nbq4gr4(J6dbm4jk#s_xLhv|wN27LhwhIhS^pL2{t
zQSOcHzOhRf9mK`@*eG=WJrFKXC=wjAxipHN7}nQ^5d@Z_%CV4lz;SL$-zR@Dyz4E$
z^|S0Lt95N460OfWFt<N8u7NQ$pk*B3asQfFG(-NIw{@1&a#Rue1PY40lZxx%Krb9I
z(*O4fK>j_k+A+Slx1;3`+t&beVeqq%*$YQA>kFd4PhxWo>wLN|Vz7O}12w0C2LcWj
z<?X`d;056!$42M={oDWEl<Ildqx0py$lfyANZ6jAvdCwsi!!W9(i`^IBZuaQiB|J0
zeJK8v3Y0uVbDEG1-4~)oSaU=7AKU)dc_W7BnL`o|;!c$Do{}7aj6N!-B1xqlkQC<~
z^VfMGYQEmqmK_X}E24`Xmk5_w!*KzJz&i?}gnTD=|9vxm{6<5D5;$(lj`U4*3f>|N
znP|#cvV?1PsUw&g0k`JAi0+Rgmj*;}cQn)M<q3!(csK(Z2#`icyP;HBP+L1t<TD1a
zSp>=nz>uc>`x<i4irB{qkh_Eo`YXW*B#B1$wmCcv`_eCe0r~eA|6fFrg>^m*k9g0s
zgbRGc-c%A+wR<virvpVrjsJ&E;s2gB<CxVH41xE)x6Fs14JjsIZ!raexRsIdU#UoX
z806(79ITxfRGuaSZ3UF<Y7||-PA7_r|8+Zm%#yaLOjPg!xp%=jGyn{xQVbc%tCPzX
zrrVdd75&Fa|1qy>V7#}rblaMQZ!&7`bPlLtpI$}YdJiH^Mri8`=zlv2Y;Ozcc2lWP
z*xfT!&XP>XMF%h!@h_PF+nCGK3sa1N*FFGX3F%a?=MSEM4@ICZ<uAvVw)qC|1~2Cd
zEw(`zaF57+o6VX*99?N>`Ww~40il=kESpEGDb;dgG?)=NsU<}#M!Nrvgse^=V-LJO
zSqyv1L3ORFMgnEk4saVP|2jqX&^AOr;Sf6M;y<#83gepOlNjr~gt*iFzYmg5fz1j4
zkbKfTp{=^x7)un}meIcn=1(#OaNRG#OOHZL0Au|<v<RtovlMY=e7gv6$-f*~`aWrU
zajEEY2F)!RQ_K~XEegziob@~m*>T6;U*DHo+eJk$&Um^j8B;*?y$6O;cs3dvHY|uD
z0SiR@b%EKKzCc$lFp}&wyR?8Yl0&f~R!)E!2)HF9AP)ZeYEQhLemmdpi%PuS=v%ai
zKzqQuU?7GL6o=#EzP~OLX4z6pRM>NNx7+R?tSrcA+S~i~HB&ZQd;fiX5QBt+ZXJWi
zi*KMp9veWgXfHI97#aV4c}knNcU!hfw!OTZyOnl<u3tCo{qEWY2tvcDF7W<N;6@Ys
zzsJGDC;Q=5ftSh8B+3+=fiqHIYk|nI3E1B_x|;TNyfF(e!%;VmQ@~vJGJw_-a>4y#
zIS)KV36#ywf1wey)K#>j0X$^1-FzLeOK+lsoYAMBHb@}9p#lHfgEUg{#Z)sct)w0c
z=>dbvj|%`iDPCBl3+cg@fLLhL0`l%}D+bt2nOp@wkjF)Qt`y|+KEQ@f4%7zGTi~g=
z0&d^(4?gqnUr~5@526=&pzW`93Xy^=DQWY)2JV&!ZyH#bciLZB6*RlaNH_9e*i=oi
zr20I<dOl8>5m(|2|9tJg+=sF+rjoPcha{I#{y6H|b6Yz-49Lw~`r6R^_qQ!k<!xsG
z57$#lshK9aSOzZHNm+XU*0PUnWd3)Okq0CLP%96Kz>zeqtI)mh$Dj)!;~-77PYLA!
z#BAT+W<(5|&IFETj3bN7NHLVqgSPBjzO4t$7@_i$vA@0qOa|TF`5D2M>b93W`rQ)J
z4|Pr8)oT&9oj=9GA4hZk$rIqILUiIx7r%e~w%Zs9Xv}CkM{9Q**e_#~M*qH}Kedfe
z&u{0$wTz1k#;!#8h&W(w15fM-26z{MJLJD911fM=XhC=J!6CXDx{?gAUah+fX0uSW
zUx1v}Jzx4`d4HUbk#e9bv{1hIP<Ghv`}azfUz9+tv@(G85d(V%vR_pAH%XX*M$oOG
zJq+NHjpdvj^2)F)&<x1rDeP$J907*G{=zgbhb<hhjh{g-bhj|x6y7(|g~|{eHeB<%
z4b^|F?B5e_BTtEnL_2=8XlQQPI{c1mAM&GWdy&OO1&x21DeXd3q~rL^RaAyw&O`j(
zd2x1Vp@&opXa-Jpy!O}ohFNx0dHaA}y$ifRdCMm{l$IMGfmHvwo3H|J`@cRKA})iL
zt;20E-*bZ`7`UzmJ(M-yfGrQ=kq>>|_TSZ`?DKcKTt(pcS=Ueek^LAB3~829fX_Nm
zdO)K(BmKX>1L+eF%**qmZLcD8PbYH{U13=lv)<~071zgio2Z*qGqhiNb%}Re-C?38
zvAR9odg{TGpvuR=#7#;fh1EHUjo$Q2uJIMSTJpKw=kp)u?&Wjy_K%V_SC#$`ni}`s
zftI$@#9*>rh@m$ep7H>LjVNTzlgx(H<eddy2rV^3tP`?Q_q^a?y({xkxZH21qo-44
zmk$-d7XD?Gus4XbZ1oi%B$QM~qm4WI;Rm@T8`q~3sG$Mgfc0J%hW<8tAQ;vNBo)r+
zrKJExX+X0%7tgo0y@V#^a8BbfSH9RnEoTS;WsXhH?Z4B5^>zFwNofJ60;r#G)SJr`
zIU`krw&RX*q)f}3tQ9SA7Yff#Ks#e#a``4+^kHs4wLe1wn}-PSU}@AnSJ3$ude8!x
zu-bXDXVBuD={#fRG)dH@y`NZbkr?*=gPx9A=(ovnLrSIl+H{mkF8BPWwPxn_eJ26W
z`MrP|=mIvdCH`jt&fW@c%v)T=2dbP1@3v_rQ$gVDEtb+H7cGKlbPC?Tg+-yg!C96!
zbv<?^&1xsvx3rbNU3U43*qL^?>l2z=pS33c`0--f`2kD%sLB0yZQIu@Ei9Y)1je6E
z@$Q|b@2l)W3q(7b4V{S2jOoGtKw6VcU`MwN^Rmruf-r$Cdl;i4wxjG6-9Yp@4i?_G
z#RPEFgheP6YzZh)AsNTl14j|2^QW;uqs)6Jj#L*MA=(!>FYw;^<9k3=qBi>9L%XYS
ze1F<V#~c3cowa2)YANq=hbKw~)Vl>=l>YHOaJWwZ+%Yg_As9}0PT|6F+&J<rJ2-oF
zL}X?>XVTYuz`AX3SOVmSJBIQ3&n*o6IrFAXmACncD7nqk78DD};mHn9@$!@gABt)l
z|2TA5GmZ^lb`azO$UoTtR{$BUgTI@Ssk8e6-2*(0>is%D)3G>sSM~=*4gYN{TB%30
zeA(+3FI(}TBqRhDM)-A;HUp9b9EztMf9we<W(!*b%Lk-t08u+4DsYEjrBJK=P6uH|
zS%qa7erb*Jg@IJot+92YzYZn3F%bwB+qaOZ4>_|!T*8eQW>6`NotA=Rq@u<@iR+Jj
zZu)?oCGA5-z2Lq-6C8y?ffWM^|A!G1hi)GsNHXt>KTq?|`x%})@`3D2Y_S#ZvyPh<
ze1q<@mQ+L%)muOx+3Z37*xbK~T@=h2Pk!H3lwA9@^lS;5RXGu6BgVF?^w$wasz+>F
zHfKtKjs1ZP(?lJ>@hrz&s&w{p4p3oX!~B0G08!)P@^R!x!%6s=`8^aKa;WXN(j1h7
zNP2@O_b+1plSt(^397uEejt;rpQOyhZGO!#c=jWdAPPFq&@c?9yEP2!{{P?|psVDV
zV=O<=EDQnk;7!;(Ln`M>4CUP6l?GsrzrQv0zf`IMrlzg@pLZ0Twh5VqjMc%zRF@F3
z7J#>a&@Q7p)6!39V(|GM=C-^s5a9oz%$&J>e?Wx5fpSTwIl_$>bH13yWv^Hc+7DiH
zsE;f@t^Z&h0d<f8{~YkDx3J$%6Tk`~`~HAQ{qHy!n8kA+baR1BLS~@<^q<>f$SMP2
zYe4y70CChd@QU!KS{jc4AB|)J6KxGv4m9`*kNsc1wWc&_5Ae^Bo<eV-&7wvpNtQdD
z7nPEJH;Z>3zX+|38K>>;v*Wf|gyEx1k;k5SNnv;@BgdUesM??+JGI?!0C+QsWQci_
zXVMp{4Gbr}w{93O0N%oc01srppzbN~l)}#LC}B9ueIQ$@3}ba{mf6U{j*F)n(LG0B
zh-L8$nOyYQ-&b{EDJpq|KUPHgE!9&mbi8*VqS#7L(z}Xh;(cajLdK|nYH`owR+jH8
z9LE34mim6>?M*7R*1R^n2geYD5KzHj(95Ah<Lase;%XJ)+;yC#Y>lNVJcjy^7Pnc3
zz!qf#BuYnTGct&9pv?7xA;1;?$KZl5OIgay4F+GqIi%(+EnxLfR1h<0Fd&U$v%dwz
z00Q$I82=%KMbZau0d<n>-;glvlHq0l1oF{E!35~+^$tjwg3F>2(Rfm^XU^nQiik#`
zS7)Sf0IbHW^9;w8ney|kr~j9o<ixd$k_JjE-R>>Wk<O5N6KCs0QE57KMRkfuVz$E8
zzQDd9t*#`2lVer+ppzO;TCG3t<~yS7&qN}?H(|RlcbVGpBMNo^+8|f#@1cNswk!)p
z)@<$w>n(VqH4X4Pv`edoKldfr(6-tO*>2VFnY7RzvcbHu+>8F)X4;=C9m}v!^Tv8B
z9VSeWu^~iLlkwi-ZY4_uW&9%xf}e}to?4+}!;QpKqBn=7(GLG$4dfVcC}T^SB14pu
zWcD#xxl_4i6`G}re&1PjdD*eQ<5AKavaJG`2p2dT=1$R$=N{B@%BT0_!^Hy-l}a^=
zOFq*%b6wj#NW?n-8GM$ecd%Q!_+ZF6%O;HW!O%jZyKVPW*I|YFd)tmjG|LWAVr#)0
zKGbgmRly4mw#Qd;;XqeTP@Vp)agBY0F_HfESYRUDA#^!95$lxoVbR^O23DnXuV>}^
zU3!cg1We>(ZcI<sckMJ1`EK6oe}pZF*Z4viuS`W*e@0J7Y>Ype>2@Z+a44CSBCc!`
z&4@()#+5VY7H_ONhnT=#Bi>L;dY-CKPi5Q~vOep$nv90x^vMa4uanbdU*{E9EMMm0
zpW$D>>2z9}j6Z<T94x3iaB{zCWR7n!$50eYy&KngCccwehW$m-T(tg6$IF`h#ITwP
z!RDV9;>4nTDUAh2!HctR$v1Ck${4t@<z30}7N;TJ6C+X4Ay35k!<=8gc44y#iRpYS
z&HXggrR$x7$?V&s77tjETJu<(JlT+#CFjqOJ6I0o@!#nClphZzVr{?5<xfma%F-j~
zeYVS{=M*Z-9vsxCl<<-4e#&ud+LalrQ{w6789L@$S?lVNV&vKR)h_kq*DO;pvwX6`
zu^g;e_c05d3-vXl8Caw$lE44RQnGER6r*y_3%1Fv&n7J*P4Osx@)K`Dh5U_1w^2{i
z`|>v_FGLz<rW_C{?}+NeHoa|N3zgqL3ae%6A-fmF6PJ{0=Tb!WPn6GI9}q_LQFHHV
zXhHco`d;8;t!{g%EEK4!;3nkh8vK|cr(B8*#}>Y3;(?<FaB`spDC`6Og%6QSgmkm^
z1WK@zuo5e)YoRS&Rj=SZLG+Zwk*DyR-fsk<xHgmZ0Aq)ji=???@+5KvT_P|Nd3T38
zl_QUy`(``#Q{S~rNh~)~6+^B}FZI-m#pexVQ4=IGQL+WLcHgGbYbrIY?z*~0aEmqV
z)*Xq_4M=KL)s~lCA9G@2kh-2R&bek6%rl(YoF|dD!OtIMHG29@-i?S0U#5Uz>7whF
z^pY4Aua@v>&F6#X9v<~sCr-Kvl=6u3v)Y4*gpRmy<d&A@7_Yo`Mpex)$3pPk!*sV8
zGF5TZP1z=U(_SoV6&*L-)gaTW{QNZm^>zG^%~V+x@)sblBnlhFdeM7Rg>pGk^*(jT
zohyD@sqvq0yvnbK>JPYBzWr7IZ1!OBVv$nyS)+3L;x~>u&xNF-+p|b3yTPY<#B{4}
zl3|mI9|K)=0-rtpzUcc@h%L3ae&oRcZkD;@$%n2P<45d@3P0GZVS-M+H!iAZf-4=0
z)-~fovJ9-B^v^tbOwbcT-}iz=aBV}3YFPa)zvieiU+;3~RhF<m#%n6keo=4m_>{MV
z#2O49&53c*m>VBy^)gcac(Kb!H;kPjNeXzy|Ns8*{u#K?>N!p8In4)1=Cg2~Szjni
z<7+O0Eg@Lj(>YQlk|aW-?n5J+ZHQ$>Wmq-q-94H&N)3b(`${K)`=>2cizQ<yF0%v4
zS~Tm=E*_7mx|SoE!_NYoqz<Q!Y`^;2Fa-O3;m&*8b9csD-hxK)GHH=Z-E6cUByDRe
zLgyXXntAsoAPZ6{KK4iME&x>wI+4m%qqTd6GX~YgI)^s<uzx!U542w-<hUO`x#siz
zA$Ehb8Pp}-MQyh3?n#-BQVW6n;Rkt<r&`5TwOE#?*a^3!Ggo!b@teC^<jUj;IVahk
zzA7zws4Pvjdq12^42LPoyH`5Ts>Zc8b9()}t;S%&P-;Md)Sq>|<tnil6|+XAH~Z#E
zcqRD`5rUe&>qmea3toTthq^mPAq_+aZr`6mXpt=vR=?054z_gBhchB=%?7*<&-t%v
zvJcpw`C_^By=BK-Z3udG&L4nsD6$e_`=DZ0D#`jhY=pte)I##4^L%t0an*|oG(p~O
zAZM?%%G@Y%KdB^mc=t`;YS~wfH(%UvT|2r%X-s^D!>K)IxK7?9-39l<vixCXwtU*D
zY_eY?rlo1CU36k82C${t9~p_(;g1f~Q7$x6_zWU$FCXxI-Bh;Px4I*3%is5Uu>2eL
z@<&wR5AM5f?%6R@ey1%$J?s@ZR)Dm+i9Q@HbU{<89$1s;Gew=*WzgLYqYN^Asp$II
zG*z}pY*3gu{nae*Se=Uv?+$E{sUm!V_EYoMfhWwdS3X>Y*T)L~YQyq6+BaROeCJ|B
z?j;eZIrycac;I*{oBg$=%KenwE^H^#n>Vd{t`s^%fX+@o-*`a^w&<wPpHK$Sz~#4@
zL!9N*o+j^iKRifgBNdTqbA9PaXS1nv1IZ|}@A{=^Q`c;$o9pAAE@u8kS65Wkcj6rl
zdha0S*<7Ub!dRdeWFc?vhOT?%q-z>q&rrsMEI&FMb8u@!<=YwsW0vYGoRtemV1wX@
zFw6XgFl63<S+Z)-thk|aWPX^q@V+E=a>G3-2kt0so(QMehP@+^t+g4h`DEQY9a-z5
zkH>zY$?wk4A;<>Z9YWW-WvL#-n1WcXsQ1=%U7rV5|B=W#7y<qLdOqKBS|nL(zPp5}
zhOG}5CD^R*(KUE6dqKD2Fk!l9?Y^vY=(ufuh+UX@#o=796n0EB-kW>-;<Vz6bxQ_F
zM)L(H<HcSRo3SAm=U~jwhZNLz<wLv4A~nO*e`v@Ysz<1OVW>qL-%OPJ_0reyhO~&F
znqkpm5oCQbumwus^>m=1fX}n4teeEijp2SPxuosnjjMOqNXWks(?>g^e3y^GJy|XF
z@=JI=EOHTdu+9D$%l1@(>;GZzy~CRBn*PB63Q83Oqz457r7BIN1Pfh2P<j=l8&Hs5
zLXqAC1OyaNx>8hnFQJG?ZyKaG=?Mq~2yqX17xj65&wKxN-*<Pfz4i}s<r~g-&YU@)
znKLt|nW?j;GPKNJM>@VN)7rwNPf*%rVbxCsnZ12*mz$}KDrx`4?0#`avuBz4{GJRx
zY1+keh`ZT@a>+%%GbfbqblR=*s1MRonddi*PEoGAN70(w6O&m<Mk}XGCIlCBOflm0
z5ODs;iV{0&iax1ZiDR*Aq)6rqtxnJUFUYdB=P#C3vBkOP8$Y{Zaq<H`lf8?i@~iaH
zY)JaRW^{0JYMSTdb8T+}qohq}sRAj(qmLsm&)@L#KML_4Be+EOtu0JS++u3<^fy&y
zJ@eA|-pmtkG$$E^t|~e_c`O_O_4rDsMSBMFDg#0ZA@r4T#VCX#Ci$=g&iN9ZNVy|U
zQB&6QktQ5vito41WMF_-_7F<x#(QH>q(jR{nR!HlVu}1qO$5?Oq~2}j+4Ln=--aT&
zxJe)1U9rk^{+0n3{rxtSh1^}jbK=1=+Ba8@<Q`%DLV3Z6Dg<{f$1P1E{Ca(??nIbk
zCI$7)okz2ddWvmDv;@s=OL%2*U)U0e8u6j}$bOteCP)}Cc<G`(60Y(pF0-DFn|oA!
z&G%z)(0So<>5HD<HoXmy^h~X#8B66CmCKoUZ=he%9c#599ck25gG?XMxHB0}A=&Ja
z6FL#AT{SpF8?T!ed7Z4(1(F^SRmqJ`r((srPOMRy*wyhx?S7C<fx~Vk^V-?Sdb(Zn
z)y-6xJu*Q)?F(Ue4Wle&<&ekfyizIL$kH=3ZvN`{IiybN4GhKaE3N9$6*w7AMK!uu
zo}j6`_WDcdz{{(dyl)zh2Qokn(>&Tsu%7AqShKw*HH(Tj1Dpv;QmxEL<&mhqSLtwe
zy6L542xi4cEc`ZFEzfGw%}bItxitTQVl-1%ugbHGHk!$6f}Hf17NSb~7kBA{y)lJd
z%%hjbrX(ZJDBaaNtw6<|Xzg;uv4Q;VMij5D$)mDUVlHUorR3)yw`dg3X0EH{56yAJ
zf2zKEvhD1Xw5z-?hH(^jg=3#=7jlh0*?K&*<g6;ctH;W`Msig7u?L!j%lFcgH}5bc
zt<3u{Lq7rdLnE1!Rt{%^LcRLL-=Dz5Y&%7(UkMcnH$YH%-L2{s;Tal3-t0?QojTU~
zY3O01>HUnrvu>A`o(<a-xv{kw)RqoT)l~ME8Ytqjs>_`9n1tJvh|XynZunpRmWLCc
z7?ngOp7IDu^}eQ2H!?puddXc+XEnFs<||1E$+Vv=n+bZO2}NHt1!J(SDt&3(;ZR`2
z$ty&o06iUkUQE`!)u4!op~$DuNfzA_9LzPy{WewyuD`0%?$wmZ7wb$G$Y63~W^Y(Q
z_Q$RB8nSHOm|IG<!%`%#Y&<+f5>M_hYZ36de2lnHd$NaZa0`m;rnT`ALO)Na&b;`P
zdqXI_Q2w)#1nEa&<<!lMmHTfOWG<q!wnuze7R`o8mhL!-<lSK-CW$8}xVp;MHC7a`
zB+E8A0sXuokF{~X<Mh%E*&Lm-PzO#WGqgSSaATgBqUuQKsWpiQ5nfpP(uq{)fGI|y
zxro_qO@;j7bEiG=<)T*T^3WWk(Cv3Dmt)r7wt2Cg-^z2xq_v*Dhr3nKn1On>>P<Yi
zI%eN&`d-&r153YIn4{V+vd`8f4O1zP8ba}{L~-i&*#8*P<78PtdJhLygd8gh6s53`
zNWHWrThVTlxx)c*-3j6Ju&lceOn%9CNN|<b^TeP{1Go;dukgiI<sEgwPEBJMOB#BV
zqxub8hUmAUdH{3kj_mf_cEQAK!vfUxz^h8<y~l;<I0L(6k9f{i9XF4%9%H<H`O^6h
z?nl^;i4aVTpWGyKpmP&!N{)OMNvoflXZoS{nUs%N-F?rCaad|Kj7iW#D4APILm$?o
zm6uU1-PDG|P%300h(>(OYxga8+>%jzebYYah-`n2Sh)_|Dr=k{$NZd(_XXccNtrp_
zXXaA-iwn-(<hpj-Ra%=fv6;!z4V91NZxi3Y5d2;OdIRbKnG~p>sr(F9A|D60@TCt+
zf~-taGI3>*8(6fdU#zkfu2&s)X`WE=@r9#F8WrSU2uJTj7>bPIkn}Weg@OzsvHNAb
z*DO!+&bnJ{&qP+2gIQ2dh81}~APq{@SL)`Rg{aamiLpC@ih7)jr$~kBlG?Y^sfe-O
zlTfNfDETJ8!mSd6rAI2C?%040P%{dQj<4z0DmQ38v&_s(Ul_9X=n6MSJ6um`-kR6&
zcT4x<FAHUI7soFO75KVq3`bBk)lywU+b5;Fxgf|tcL<}tFougnWM7$|cR6<RQa6i_
zbJ_#+($z||cai^0EaKf~xHT8$5lj`07V;?3{dPPPWJ7VH;vKeVQi3voB)D$)==#Mg
zXD-Ck@HZ%OXlay8vy=~q_4i1@(z`LPEjBVK@H35cPu>Ov9#dj<6)sdDSLcjUnyYfa
zYSTx0<}97G(~m%9KR<o9I@ZGV6Vgthq_83L<TC+vM?3SIXwj_k(6|;Coo#*i(iw$I
z<rc@KtR3m)EF7}sFX6rt1(Z}(yu}7!n6`TCQ^#8S6kCN8RUCDqb920;(GG#m^}+PR
z`Yq4I6PfZIRh^yBzy8=KDK@u3^^tUoJ;Get$vDM)(i^6Zp?^JPZ7g32OnMSSUc|9e
zwkrfz7+D?FCk?}Ky!{zb)9U@s-U@1cg-OXO3}-c{x;xI(1jZOtkg%jaA($<;)!8jt
z9v1C-xxyFnnx@)OkE8mw;Xb5oQXdaPM+HoFAGJx&PO^QScg@r4bnTs##F(e{mWgXD
zanG!X-Z0QDGnM<7sOmJSPox)FWxrEkIB|kiTZ~djSE!x0oqawPH!#KlR)|h{v+>j5
zmCXImop~%GcWv%ue7gk)Tg^=p_5TlrOC%Sjs!eDN7r-ivV=ddC3Wpi?2ORA?1aaRc
zOszHwB`1sBz|!6_{2<0MW9}OFm*DnCR!0YL7}HJ2y7cQIo^-0GAPsrsJLHwgcSw8@
zzAGAg1-6(7Rv3e^zqknO4ha-TkK=v8fe{yAAd#PeryWNkc8Nf44CG;Pj=s{D!vK-*
zeR~om*xM7Mrr<UQMC+Sn`{kliuuo74y=xU$SytXTfBH@vL#wp<q`p(vk%G3I^&%NG
zuEA}*1s+uolE1xNzS7*wU_IEz=D~CbCgZ2?`L7G)$#`vw1k~P}%Eyev1!~0JmsnUZ
zfuZn2X@vF#rUS(FQuN{s>#M6Go$_Rw3=>cp1LqL(ZT>LGuFg+{ekNK7mSeTmG4w|T
z&ySIq(A;=qvqma~=~`oqzmMTPpC`vDc_L>x#z+T6k_9o^qo~L2gBc;5^<Up?6TyET
zKu^e=`C3nbld0nzewl2bT~%5_II1=Nu{!Ba#AK3u&qr~mhObo0V7cj=5s(BO29t5E
z(SLu<^G^5B*z#MDJ>`Q0Q>QSKgPb>$%unC5z<&*OqGZlug(vG0lDi|F>H6UoW+BQ-
zyw&FuPivlaHKV1uPete}P4>TPs1>q~yRSxTa$mf8movy)Ql~6v6?HX>40-uDb=aFD
z7K)eHsmIEEdZc*>*FM3);-000`I>2kpT6I&1OMHV{gzG+ZZ&qZa9*LGR|>eb$J|{^
zvm;|UTFAVbz}R(RsOB}E7OdIXrvPAKug5voCaw_mMVEl~V}h`!Jr*@^`i#1!0Xca`
z*xI(^De4<S?+wQGx11xarZ-Kt<>B*)3%$HIT(+O?p~Zhq_g!E9Onp7#{IR!{Zw#12
zG@AT9k|FB|tfng%M#KUB{J~u2hvv6f1847iTaU|b#Z=kulF^??WE|;P91gK&A`1kp
zLo&JJi>VJAVf6v?120t}?&Bdo^rLQ`3Kc_K7|U<vpJTQl!nIACl-}OF4!^dbDlN2_
z1TCLgu{84?@^z+g12o82%I?=f(Z8`Ygc)uv3Ld8vRfS#0z?ab`i!tr|CG=Z5uJ4ps
zI7#m5BLxUo8M}C2q8*}flGCFCs#ZwV`&(~s^jxScseFgHprtz{nLFhugq$NQStoeU
z4gs^a;5Y`r0RTz+QLt>}38E>k{yXFa_~SeU6h`MA5ZWP<*hIm^2GCl35YW!YCU^-2
z+&M6*u*(c48Ll9(vz~$gw@_=gCj`?b{{>B*OfOBeO!c&p)#O;*tFvt(H82*(as8wB
z&6H%%yT%_IcXx%G-G0nW61IAP52DukNu_bHp$q)Qk^$}F0k(r1@f~svfmaj+m@2XW
z5X$%`65KKYppp4UG>xM*%98a=gRZ-?vn#%8ct>-Qh~WME`Q)_!=6e1oc>n)t{sV3L
z-@w9wJYU_kqt_8n6gyG3u)O8|+FxuZz;RukQXvcCX7xX-_FpjdtyD*`gu5LIL$ehX
zgU+<>@a22_-1XIN8JFCpQXaY-%klpR>4wZzAxPcY<T2TPc2h<KnX#>FACFlE8Q2hA
zUtxYNcQG?eYarrcR1%A64@v58dam)CavOJm@j>BWjB*2e2!7Uc=&#BhKkP;|B@m9G
zQmGv*xs)BnOtx2h`O4*2Z<D*O(FR^ECd>-{;CP%>ws8C(>&>ia8so@9Ip%A!_cK&k
z!NpY-6^k#Eh?@DAf|dB&1Ylj;uQuv;-i<8Q!f;yYEn91JSmh<PH!P*i!U`^Li?%bV
z*E5DiKj|$dBnRf}lxgzy+;|Z)Fe4;FFoXEDRsXk`!T$-<`u{9V^2C@HW)&{F6ZG6Y
zluAWReF$qrP;y;yj&<Gx&%3CP{;V=nd#W|>N^75dQ{=7)<ZyAAB&c(k?1X@s^Z%y7
z<^O~PCOp=fQfjG`({87<RQFL-LQRR*gp6Nw7i9rg^;fLvm|$qUu#z_!z)BO7T~Xe$
z1LuVbB({GUkbp1yv%6AdLWI*tLz}}REr%OD(g!Tjo9)GQ>gRQn85=olXkOYgY9j@1
zPfQGyL1}BKU%72-V(;9^;~V4ZU5Q;??NJb1eGz9lbdheoUB-;{MY!oaEdhvde`V}<
zCHUtG{56#eOgBvI3)!);Cl#!a_lyK7W<K3Xq~wTzhZ?=n^W|n>RU%6Mdf>?Yv!S@q
zW3BZvYjh}|)LAECfxJAVXiJURIYxa+@47n|kAk~;f{28;-&_(QnE&rpJNNl0AAT(N
z<V=EgDo1tP-nCnN{Csfs<n{GwD?an`a)rl!qh%|soe-z`|3cm6CLF?zk7I++uH*!*
z&ft6cNyDp|E4Yel%Evz>@vl;ILbl-5>gLA52R`;c@{GVB0kcU9NTnazRHs@>{y4Pl
z!5L1sV03v`7e4yr5{)_w#fcq7iSaN9m<s(*s^E~*QgqzVEeGjC*FWpIAf;peAotUk
zk!4Sv^73PP;j7&rIW;RZsU*(SGXG<Xd*~50Y<35Vd$1+S<Ozn0XG%KCG!VP~&;nZk
zwkHFKufT^tbQ0q~dtHA9C9!2ebPMh?#V^4uL<lx=aOYGN@Im8$`i6f$7)Pdq!>kZf
z2v)l^3K3OZL$^evbrHhSES`zeyTWueEK0_rtM%Sps{++rF9kGLJQz%{x4d5+!)fJ@
zD7o9+Jrkca5g}nE@XGv3$T-2%lL27y$wv@eD%--ofynNMzYhELaaV9TJ3VE2sFUW4
zatz~B&O4vZxk}SHy2~{A%6I~GJqLEZ^o;!EQ2z1*@7MZw$ub|TiRRU@n#s}o6!nL3
z2XM&$eyDA0_Gpcq<R{X=D1;OSCM0Gyo*n$Se4M(4Cc&j?HVQHUQIdkF)9Ezg&!X3&
zYlL&KZB61C8oiskxDlH{J)&&Iy+XPt{>M)HvPV#ZT=6f|e|e}2-#eGFob4;~@W1A~
zps(&C_LL@iHE$}(c(Fsh&pEGzQQyEdrgKI(+##NQLpMWFp25$r1I}1vymv00>iKVy
zYaf=O9kWh0L}iZgetEp|eh&h5_dkqb7NPHwCw#b@%+O*v+&N&?O-8J*R0p0mI|KOQ
z4nKTxVETT3EP5gE$i=1DSiQQ#k4YYtzfvl%M(6nPK@UV}nV0PUx@4;0>eD$*ox)cG
znkil@IXk!`oU%{~b~aAZEwi&3B~A+PBM*|ej(xcDQ1h9U3-24WV5Aoeb5gltu;#Kr
zpQL0^Nh<G%WH{s0b840hImej#QD+HAKq}>x29hVgp&s}IzbL^slh3Nq|BQSSx&0@-
zTeoDPf_7=74kFS5-kJ_{tBNi&-o8{djUK@=b@6Y1({|%T%+-^p{7S{Yts}lUY7hSt
z7mOlp<s`a8W7xc>WF&l~S9Ecq!;|>AyTCL1&&^j)yTvdF*97v{TTAQLKDHHWoj@Hw
z(e;X@t-^s+jR?LJ0aBW$|MU2D7;dL~%cCTwOJlF=WgU4*Pw-SwljK$u_Mg3b7^<V8
zC%ky8dPG7uZEEyt*+&k7<H{evvcl6QyZ{(-#ornRLFcdm=8P%0JVuArD-GC}FFQyO
z8~;|O7syTJCWut4zeCP}#6p|hTTFLzJ+YT~|CvEAi`;@o;uk~MWsCUwKaO$)F~rZr
zM8C`v?Q&C}cJ;^IDa;Atdol2BUsHF?8YIc9M^19uY$xeY(O!%AHkxJ&0f7FMx;2o{
z*<3`==y%8ykVu*?{aVM22@0HAk__J`w5;$Sn)8$(ljG!6wV&lQRL)f-7h)jH$>r3!
zHh++$NW*IC2k%pi@2H#LB|+TGe+?hBhRZ1e2iq4}ZUkqs-3Lwt<8M`zAev$aU|;RO
zLq2$bgam5K;gW~OKO%Q`%p|1LNM;=G>0Xarob#2c|5d*KD!b1$lM4#Z!1xZb5hvX4
zePycIy*|c0hK9HA(F<2zdr0o>ZO6R)0GP~nU^2lm;9q4p#nzZ?x$zYsd5~Gi<_r7Y
zzneWbf3kcM_xe%Kd|QOnjq$O)Qw!7uOVtsEFz{<=?_67$mn`^|djYJuLpBdfpvUrs
z!2zAXl6);IqS{a5cvrWdjAPDO)KGX}^C0W#T$C0CbL+>+c)y7}mJ^;jZ^t=30^?gA
zwLEgYP;=w<gzrRNt5dh=MqS+ArLVg>!TdOSDfm<<PQn2iv;WM&H0ac$`G+@#wt7|G
zzPmzr<?#bqHbFF^#pg_q7Xdm=rDv1zMXy7RRqm(8AWlOYMSFct&h_?6w_VD?1=My}
zDagN>)g(?06;Dx+U9A{^6Z^U6R24qznY;jZf6I^`t5PA6=uh?G14MK=IT{H&Zo>Tt
zzVb3owG^$|XSA@jl|{qe+uZZ&l7-nVyVOTC?%n$HH7aPIkyfTh$Y!5&Lk=a(DHUsH
zdsB5~TKlfC$Dh3Kt3FF|bIc?q!fzxDGPgNBEy(QCb9v3T0B4emMIg7TC<3QjaxN-J
zs&H;_ug*FncvvWAb(~Bgx2<H(O%>6)rQF0`o9ZTU%ea+jn9^8xssG_8!FjTILj(TV
zlDF<HS6?gpZ52a=ebq&mnCg*5CxPZbo$G1!ZS~WFR+z88EiWJ7W8#0O9H)FYbo%+(
zNOXSA+>I#Gm`;~8bVdz;=&{pi>WVtCjYW;cZJo&TqO+sxYQ;&}F&XDSF8hkndSwu?
z+$0giR5zCuFY50n_)SHhEUbO85H#`G`ifju_|q}PtZF9)&AY8GQkhQ}Z!@-MkTkC`
zeEN(#iGA^UQ2-?#mcR0_(~;T_Y)DJj<1h60d$f-|-<GaTSZ(AwksVmzR<4J+p+8oT
ztuUqgB3$QfafNO{(Ie^|MZ@KbFV^we7Ze{ww@H~aBZ5wOI4mzXql1y*?o*+9{L2qF
z9L;D9a+9QTtU@^m`2APETrn>{@~np>2gicZE}wo4R+YMKO>HSj!Mt-z6G9!*M#)qq
zg`}H2QbL=9xv^Sy<=Bh|X+b^$Y*k?14IfvljrQ@&#&S1RsXuz?JYtoBYOy<Ic3t@t
zP!yYxcIkG}r0KQeP`0lQ=`xkMUtKnWl}6O8>E^<&^Ym7xG6wZgp?#gke3{Yo(+*(q
zcyPzU<UYt}DVZ1P?y1+hZ6gsx3h0rm;mCyK)vWwas1|biyxiLA6l+t}P!`K$cc!fw
zM=Q`0OU8j)$&hjI3e;vhpQ@zy-#&R|>|F&T+J%C4hnLu#*6~mDo%Q?7dtxfJ*!8rv
zHh&>mY4<Kk9bg-53c1^S$a?VX*4^Mhfz?})1(mJi&vnrem0gWvz8qM|ywBZ}x*2aU
zP#ouDh3b1?fryyf$5^Wwdyg4JgVR`*5v3QH9_`#;d+QU!^ft#p&qnOQCmYPpO@-&L
zE6Ogau<6DP48t-yqiL~z^|f2-eZsQL&=d3H6Z==Zy^4UvM|tOr)pWNBJD^J!cXtrG
z7wii5R3Toq7?-`4gzu1&9AqAj&dSO=FA}OtMz`6V&_m0`-`vh}OHB5wnA0L}26lD|
zoN1YSs!_M}j%ax>PKzriN4C>k_{+%4PLCL0*6F}e{fpv}uLpd=ArOnk$9hXmpw{)&
z_FNT4DpyOZO8iCdo)B^MbWPL@45!GjXP~-is}6M&R>Vf83kHi;TKRvrFR(`%ynDTq
z5S#!0;^MT81wlpE<rD7dR7BVp1#b0|wQK%9OenX2W_?_$NZo+ICi93%ar-NG7wz6+
zgU{!5r~JhonaMWJ1fv}7&M!^nw5SKwlgON1+8#<SN_^3APfFUUC{rHW;$t3Ivl5t~
zUVLNugKlg`<XFI0hY&VMPu-c%x-EH~PItUBzmUBq+dFqe+$GLe9{VMT!Bo-0!s5=r
z!xmmx@MHDKPIDxi_|O{8+^V2u=8Hh4>CLwjk#7r1Za(UAs!n)+g!*tYzD)}olY>+0
z%a4W98@oAZysI?QG@;3=`{Zzj6s>A+X34|3)0@F?CBC6sJzL6rnpM0}hISBVlrJ+P
z%{F9^=ibOmlYoMu%!EiB<=h<tWLU<rmsi1p|0bJ4+g)dWhLvT9yJc?iq$>oY{CzfJ
zRMmCYBFJZk6{g3D7ogM+InhJ)d<!|uDRxOO1LNfy%Hl0_Exr^yO?u)$bi~iM$rmPF
zBRH*2fh94-dSaaCtJ$~)MafDqeu-+eWg(4)O7;9wJ(+U%X4VI<R(2783EQ=shJ|=3
zrF&iVR%u10g_Jl12elq88<3J}kh5^Dt=SQU<gTx9Shk{i{aTN6vu#XAlUdiF@Zxxd
z6>R2N$yr2;&@8iG4w|`4PfnBp`Jl*t;v$vu#&ge!X}17Xd}9@+JmjQ8#k+9znqs|z
zFr#ZMW?W;P_l%e<ptTp?5w|xmrjw_I><)){$zc!;KHvb8aDj(Lr;PhVc~g?|Ys%d-
zLK-xttjNP=bpzw<OfRro9dS1aspG|NPh=-z5Xc91Ix<``v?YCo-@-dp?hXsF>NS(c
zUDDD!qUP27<uW0qoNMZ3tX<v`lwOJu&+55CrO+c1dG)hk$@XnKh5e>R=o(Q*kQRqs
z#yO&xXH09~OafA=-}Fi;WiE9)P3ht8M6Y;u$_*9@H02~R#nH6pz7?c?r1g2gsS|P^
zO73hD%7kcse!l%Q#$rBblbJVu@GR!M!Aj6Nd(n}hIeIgH_2*0%9x)n{e~X^b#}-d3
z1QqyP#AdYWw?rgoZ8n!x8K+$~_^dyo|D{IhNX$J4k@5uB;%AS+Qnx-FBYN&Tq;c3K
z2Y*u4NvA*mM4N-T=h@=sTper51^YOqH{PS`ET&dmZ%W4fJ-}g)9kmKgY}`XNu&nXX
zl%+_nE^D9W{$gTBe_dn6gsU>nkppZ2gua)?{p;vs$ER~z;J2{>w;$V}N(<p*4}}bO
zwnz~^b-MhstIcj41UeFJFtdGNUzCxPEm1KTW({n3#^UgnrrlNH+=Z{bqVZoIU%eA1
zuM?Unuhq6&Nqa%#Swz6XxJ^2keJa`O-AeOl*i(i6zx9#q^4yCpxPVRF@D^(|!n^q6
zNCMI7cDH()D25wZhPHe@{UYB6da`abcN|d=zDKWHGk*S*)=tX#>f3P*jBN$pnfAhs
zMN&O7tXLCd-Pr*t^&Erc%DVNp8}D7*HNcc^=zEDHTMX%x)l)2cIB2e5Q9OtPHLKN2
z_J)(Nb8tL;t%(U3#N_#%>uu7hXt5a+h!7#{V#l<2lS+zS%{B8J*7IvB^*iuQGU{{B
z&L~R+X*nvt-BBk9fdtHt3Gctytf%$j?h%C&@ue~h*Qid}nUESWKhd-36UcNi2nbl0
zkbSDDfFbhzLS=+;^(*bBw&N|ZP8A>W5^FtL9y|7NMCIOx{5H3!DMpv~uBKHn4J;3I
zkrNKcIV@ZpNfu&n)nCYES1FKc=8(LT_EFsOKEcNJMg>ID+<}&$!0CleJt>ZPio(hS
z>sMG1r~j%Gk!#rYa4Yz%*NC&w<FjTBM^O!BJtw80d|0EY6_2**Wb9>rg=QUN=%AFO
zz{@ijb~d-lpv6ngZ)W&HBBHKw9G!ngZdNUs=0AiQf3%4paqDiWnh)hG)qNQv`lW|2
zq4oHYx9!wH$G$^63SX(z;U?~yvscSug&i`nNF~flTexVgx?#U*LZ8y=tl!XFpJu^~
zl-Y@putf%jCJBizovjcVw|@L-Y;Z#wvA_#7(ooKG$|NLl7xvtSNyVAmRVTJ2(moak
z7C1hMc4dCbv|Z%CTOOT`sVmI@w+ftbIM!}X(V2-qOD+0Er|D|k)mZtD#^P6_#Gy}u
zh=>Z?aOYq|?Gur=8gwid=hX)`88=NtvyMM-aFrT!i#^V9`;)oP&539CTl^%x;#ems
z44Sqt8ZP<>4&s!_jc+_yBp&IAbflc%p9m?&_<vMqOsBddZVZlTpdBzxL~i@=rcmVC
zxjNN!`K)KEnJaF5*0Evt915-Irkj9{B$qcC>F=VZy6ncu7f*_Q)Re6r8&Z<leYbtp
zoh@~yN5ngGcm47c$Ah`w_u%r=ogMEf6E-)4wmN=vbfBmcaZJt_XBp<$9p_N{44NHV
zqvK5{OPofAs`t{OFQ0ApQ3y=094aN5JRNmPjvP_fm0`WfAv)kj)Wl>I^xXNCTd~@y
z<gvGsMn;NU&ID;Md06f!5aD=;-MMkx^`~H8MG$BvFeMqOiD>e~IN<|8ddznSOpe;t
zCE?r9Ci?^=``;mP;1sj>Xsf>-s5iuaye;;}+Zx{?$JbiAcPYy8L<R`Vt6i%-Xd~j=
z5$HBv9h0%g(U|tf_jIbH`blYQ<#))H;y-JO#;W@WAbNlcHX&LMX84P;5$~jcmo9td
zI|Kn@IVRYzkC2@d{K@g~v~SEXEQJHu0t&KVkG7}g_ldhf?I6lLsQ&LN|4sEE-2Puy
z&-@Roe|~Uv(GO7_G=Lw3m4CM2ACPz<g}}gBgzY37U=K$OCiWjNh;DKRZg$j~%f1^Z
znm+O6MpBH<r7y>iL~H~^M4R7kjhh&hOuTLwm6UuH#y2=rrRj5>Iu~+2w<(thLhy;8
zA)R6z7_W}8i<O9I8U8*m?n#h~plu5feeHcsYf$|QxT0oNg;{;=jrraVF(K6xnr6SX
zQy&EL3;816UD*m5gI(krIpc7|{#rl~<NHfXCNMYQE$>n^UE%X=H>b8bp5Pn(oHPn|
z?F(eOkRLY~S>@8r3Y%AvgpTgrA_O|q-7PR`FJjEu=w=@Kaf6=H_ZIKcuDM^W(YblO
zuf_GA`e+1v#0gx;CUd;V6>9@8TBxIV<3PIv8$s266?YX^Y-qS!A!FI$b)Q}KYFpGR
z0;xD%8Y~I2JXNS3ll^vXG10Zm<a0YkuM&Sjfx-U6`>iL;yQMxDzP(5AI0LQ@*330l
zxgw(}6(&`g)>oHQ%VOnARVwMV%L2Q!$Hb21n?=7Q;cIwM;R}Imn*4|HkGwuaoDm&}
z?Z$y44SVy9(oo(@AEmq>q#ZYj-kk+wgmyJmNe{`qNfWCha$+sg3>%)OvSmW$*0t1J
zWuJ3;lB1?yu+YB10-^0z^FDFGXt+W3GQN8YED(B>VGz-hkL_sevnzk)kuh$YH5ES6
z?kh(R`&8tVGGT>`yw)fP8e&qCsM|ZPnWpvG=^UkiRnnXp6E!1>JR%+Oa3ZeD^C((7
zto}s(qy=AGq{<$r^_bes9_;g@?-1+Ja{HCNDB)^`X?x(oKb2C&Fijzw*_biGzEWCK
zM)rMRU#FOd^T+M;0asH|ixWtZ6X&9YMr4*9<(cF6mfef4U^g)8%_amjO6C|+=JKI$
z{Em$Ga(c#Y7SRn*i@Y@&Ik|1l?D7R<mGY?kZIA9Jd5O{oQU&qXXcS$`vPo3(%p4(m
z8lis=(>b4Uog7w!`b^5T0nxlK?lriig5H)*Ytiu$8k$MbudRAxbU}0DgByD($94y;
z4HM7al{rmU`UZ_h1lB|yGVDt-QfTppNMWtC<~|d*u<sD9zS*j}@&~ij-kztD=;|)f
zPcnDNUe4i;wQa4!i(<f?mIYYKk(S|Il3@5lX6E)YZ+PNL-l<>oS=G^5FE>49Vbsh6
z$>o-&!O@`KU_Ggj^aG{mL{wD1I>4`WGI!i7+sMZl$j_a*!P5~)$=HOc_lrXHHzv!a
zMQ>7tU{oXqHhGVU>~Qea$%c)N$(^ruwLjaXWOgBfKo-g*9wNi1x+h~-PiK#3w>7_w
zw&)zKOJh01GxeO$f!tuNwaK1!cvk9_FUbc3C-DKM`3UD3?8XEI>DapB!&)8rL3?}n
z6a1=@*}7EOoyF=XnNn&j|0D;xLmzu<>-E}lq>Ei%PU6S#71CiR#xET11`zW5mDkz~
zQ|(??p~b>or=`i-E~?%a#7SE@S=jr<wOg;2Ib5Vj38&&SCnqrskcCQt>r^q?#TcgX
z$!IX~48=y4UV1Jl+R-k^5!<i)&M7|HI?&ZnwU4Lce!Vb7P49FO8@9X|Bob;&ChYX2
zZc(O8k{QWJI$-6sDOQ}lk3aijRFj|IK=CRj`tgdRyxlwW`0@_PBh4Kt2@Fy5mI+Gd
zqOswdM0MBXDU({xs4c$bwt+aK;LtkSPfNyUqg$)ks`K2enxU2|D&d{dliwjKev}&a
zXHw6ZIc7dDcq7y$96<_MtvhL#dT|iXV$BrX%q#x}!<q1*y!Y}W2Z`fXTXg*DnbDUR
zr^7Ja!NvUZE9w}_4ISjz!WI)<S+dF6*@!n%#UUFwei(oBREuX&fR#XKrh$!<?WxQ8
zj|rI;F)=w$Vhse$ZyRp-mC6!9NGH7P&`1@GWxdrjzwqrk^l)hYX*=spR*4K6>1x(i
z#*BE*DBW$ZMm;qu_Atn_&uQfZlTuid-6-_9XYMDvGE|Iu&DI6k*aprvbUv;S5iUAS
zmW#VJEJK64hJF43Lv;IH1v>Rbp;$cJ+D!579pQK3FTbu_eEfp$V(zQUG)hI;HFRjC
zGCH-^eVSF}Rvkt#wCII_jVQm|v<=Ou+9dgf=9o5G&pNZ*np7oGy7DG<a(ygGGlJ5*
zvgWcw*x7-zm5*zDJj60T_U*uD0|``EQ{vx_ix4cOG7QZRd5LB&ZnN_Z4?R|!^dL?U
zHIKfRjEz$qsN?LwkW5Dh)euakcpH^IS7u<_T3?s+G>}hd;rJK>cejABev$**7QJIK
z^&2y6wDqO)T!LB|Ca%uV^U?$!4S`q@JtHuz55%3!a8ohCh=+XpT*z68F&c1nRpC8%
zJ(lN@>~*@^fvB2QKBw_gh})?kDFzuvoIX}~Lc@8hwO2|wzhT3iP)S_2tAQ;{_j$&f
zhC<Kgaq2=osViVtlp9ft@!6pjLEJ5?9K&wMT#<7tg@xq8R|ua@QxvbZao(vkscTE#
z4bVheM!&+&%VYhV_@;06^4k}jj@0uCirTPTU%dU6!*nEwsPIY=qsiw)q=xlPtl3Bl
z)3?joNe>gNRNqvFv}AX)jCqL2BKJBA9=~)DI?7Gt+9^w4Y7)L1-6RP0Qs}R-^FF(k
zAX0+idi1VLZ4hde+Ri+@!Yoy~4DC<eh6X0!&-dY>)-L!<b+O<;bsB@vqO7>wif2j2
z7orH84LWYZ0_EIvT8e@xFw9d5$V-9`7X<mF#HCwbc;?FVWSQxH)Ly1NYA*6VqJf9t
zCZ>yb!J(vw*s7U10(%u_g?B&LnUwAGL7I0a4QgoBqyy4y{b0_rbPEw%La=i|3V|-F
zx9+CKIfie$cp#!qB9r?cLO+AsDJ^5#Pvd7!@iKesm(}o7;m)R&o<brbHYhr#y|1;z
zEVSX%ceTRwKR=c{uB!s8Pf6ZOUYa05j^0wkj71h*lX;zuyI!L*s)llRNsl=bcJ@Sx
z3iHe8vkVsD#53ZuAV6x0Mc>xn_7&}vuzCZffEO-*d#!8a(>-G}l2y$2V(@vHe83&b
z90~p^Unz&l`Y<V_SJ;5*$g-^54k;OyK@{0hr<Rgy>S0ECU&Uj`^><u#iihjYdWr2n
z^-`LmqFIbt^yn&r({9smypo7DunQK4Jh^v6Y=xrVhJ$6Ut`h@YuAhWayOlS~aDV|e
z*q|RwEuPv@&0nC`QKE>%#aus4!M+~Ra1p|JJ4XA)9Y03m(Y58?i3L1^o5Ey#P{Avk
zg$aXj&sylMAYGsFqb<44O2;oSn4DkE&*sl$OKMD~BEVKpjnjga@u$4R(E?2f+R+6j
zL=d8MbsoJFSQ@_I)4O#kqW``52-C7vOh%)X^AUKF%YLdr-5FaGs+sU9i|3nlSviZR
z63Y4(HQMM_2K|*%^j2xk+*CF<Eh_i_pf1t=Rmuv@t&E9CWf^8}zFZhTHBN4jVh8v6
zpm?S(LHy=fgGWLsHk#TumxE5csFba2@t_Kj;&z`@JzX-Y(##YbTF4on<youPWO>$?
znbx3%+%|xPM{S;S&R6F8exaA%BzB|`ajdkRTUD|}Kg`$;W?5EI^VoXVoUiXi*pP%p
z^M<<y;VB0GRAED^<^E~-Nrkwn;U+<{?gwlsFG|6#ihk*WmM7ua<F6&#Si~>1u&dZT
zE1ar0`|dd1wsbU7nzUm|I}f8ZUs*Ne%r7&pq7~nRw6h^9$zs=%v)H%`U$?hxCyO8m
z>%>qsu93OLP00jft}Yrp6@}A$*igM2*mK3x%0tH5K0YQXhIw8!;;EU^`zc=;*nkf^
zb_)7wV{$&KU%$c#p_PX0aB{D3FD85aKGw92Wli(SRv~7%1<D{JgWYb(X<^C<{3aNz
zjk@vRTBdTs`lzw(<I)awk*Fv=j+@lx9Csu**{%!(Z}Fm`TU^g4BUM_AIR`|H2p7o;
z*gn{Oy213o|IWpHWp?IWhHaJFp^I9KN}RjU2ykgmBy$U!RLYb<@RYYh<8IvxJGz8S
zl<3F%{J0Zwv!Rb-ltNF?ygozcY)tS~mZaH-b*M&b!sPQvOF2sB?M2%+IMviHg8?#@
zIKHYHjT_48q;<9lUuYr1el6Z4XRsO5(6)LgmQelVV(KZdF}DNGb!oD9PDO8ZbyJaP
zHYdR>Y8LQ+^Nv!x#0*riWIsWM^^=!G71qSYJuf@jxsbx^ZK`;MN_?ft3#RuNF*8bE
zuf}JEj<a>P<Cw&T=aS9F7viR<g1nSoy9qXnyX0ATI%n3_3Bsp2TZ>zq$uY%ku{5$T
z23YQbF&E^UExYNlX)UR&812BRJ>;uJ84`>@)?|M!t?t+s@0m#2zVi@&)!3un>EwkT
zaYoy%Jl9Pqon2cmY$5ictj;isIz~71Nt3{7bWz}tWk6@boM(6v`LMW-4n>_^=<Fpy
z&Irdg$U_JO!jQ(IVU9H_faQFy|Mv1SWDO4t+(w}wlaWss%Ar;LQQ0w{@jI7oQ>lFK
zTd31?%pl2mN8xLq{kFK5OtR{fhr_Y+6C}Pq>^NmG8>Z?l04wvN?Gt^~{Pj(DMR0^6
zFNg54yKHwo_3q=IMez_JOV>WXZcgU*uVd;!r)Zb;<IK_T#_qne`-)Ow-f*YMS~onp
zGu&-4IwyEusiFPDhR1wMQHTk(3<Y)yLA5X}Ly3Kku9{<xR8i5p-unUWTWQ@VH>E33
zfLvyEipn4#*YUcFb;!qdEvXH7!KUF>jl&+cA2Rkt3&xH&k2uXYI+MSj6~hHX3Jr$x
zyri%y!0icSvaEK8Kk%Mn1zRPHN)7hr^oktjZlls4=}wd8iYYLie-#CpNrs?R)I+!H
z>FZ7}#Nwm}vI3g$Z0O42QjU}4s;>E05ydMO-!90%Q$y~J2%AXTc;vL~i*G$d!&azX
zdtDn8bWRfZ7I@ihJy9*8YjKl5RWjtmsRSJzzP`jGY$tdK>vH$wd`NPT>H+2YK5w(i
zLSMO6Ew19%d)~P7O+9<Mvf{dtcIFHFH*)>z&j>4%qbg_z1uWZem2Xdp_B(4UnwG6H
zu~TGDY}@NK#fh@a)DaQWBw!tg#7N6`2qVlon$=4JLAz*7kM2gkR^>fmLsL-DxjB?a
zX6XJ-O)IS<Qob|XSMB&(T7ii4(Gpd*Zbi?I=Sulgx{;kD`H3gt4CB1#bFHM`YosY}
zM6-B7dT~0_)^(g%&*sbJ{y6omI~ET-GnGj9-+fk_jhf;O$qwCuR*YPu(u5EVmr#&@
z)#p!*KD*zQyA_jfxwtu`k`%JI{_gxa^Knv=bV6ULwrSckg27BRPg`ZWL3lTv52C|i
z4NMC?ED+Vd>zx9ww*z;OxtC{fDSkQj{t}1G6M}W)m^`=sEp`76q{n~;Hegc4_!z(F
zu{xD~j+J7XP-m#pOB$IY;Tulf=qzh}tiH+`YTKxmjeU^+(PhdM&spSUKKr9z0+zeT
zt%O)B&pn$>nVXM_sXJPjd#?nD%x%O7BOjR4P505m8JEy1aW}ABVJp<k?`)EmucRJY
zk+IVyxeXc4sxn0v+*}LOuJ7G6uyb23)E;~(WQ<Y}e0KWz*)TP68u8OQjqE}bzEo*G
zQn;%XefOm9Osxguc`>46ZztU!UqroRCH>%*EVNZ@DWc>Ct6|P`wru3cdYDElCC(iR
zCeWb4jsmr>Y`~!@3WF(Pw=ylMc&<L6wjN=#TuYPaBEDcmT)ZcN)zLFKxzM+S8Y~N(
zs$3Nm_*NmH!7n%4EqD>X_Hl1QrfKdXGM;yR_*M~)E5MlT)Bv=(Dl4^q^3rVBh_>$t
zS(15$oKnJFYbIh!T13YM|BI3{MBR8{Y(R4=6#EDj9a##a2J056WRQd-wrp&s9L3dR
zV_wO=x7}T0ip}BH4bw;Bq6_bB^4fJM3i8bvguD0NjgmVZ-y5Xm$8th}Jq+E=f)k2s
zyEWe8I<;bpR2+Okzg-2-FPlPHyDU2sE3)Y}ha;CCRGjSRs=cOGUfd_LXT+-(a>d4i
z<_fv_O9iGtEyj5Wgoh9YRj+T-Sz4M!d>t(8SP`A86G=e?Ih-2q0I7m-uong_v{E(J
z1qrEpwWJgdR1VqL%Tx0zI(x4@`PUL9+tQ}jAtWp-MecRj;1@Pymw?M?$cQK{^)v{7
zFO(Ghq3k@=$tqxjoZQJ!uvtCGhZP(3uw!X2ynt7?m(%9qzPfti`<hZKhWk-kPcoty
z8I@yDZ)(KRF(vg(pK-Dn!LUvBlS@p_`9m(PD{!+g9xL|xc84Q+<|U3w>6D1c*3w+J
z;Yrs}2b{%J$Nm{<!Dgnem8)Zu><P>&lEI`w3i5;^SGrkA^jon!Qm(I|)Ht=YW{;0!
zCn}2*Sc$u};_s%q4cOy*9v|yBeO$Dv!}v*sEkl~CbPwjHV1TBZN9GJ}8W;)Q9LydP
zU^;F}qr$f?(n+@F7n4re=zsBKykT6F#~LLLR@;-6vXUx1ELyEsFgCJ0+-WhBexG>u
zg#OjWC**>iQR*aNkRAD9V{EMr8rERK5FNcXk0H+T%r+pi(H725@vOx87dOyKbvac&
zdr#@6>Pzl99GH!<@`qWIIS`Gz6>DO+QVOsx-pbAc`dsU4rd3hW=ws7YXf9T==||RH
zp3u4KL*aH4C($Fr;9a=A$BT^n{KcTX4pt)hS(z(BaZJ09j9l!*-G^=ZONCO*nTEJ4
z#n{*lHBm|a%kT>v<aJkqY_zq_s>L111C9tWbhCaXnlqtV96y0Wps#7~zZh;srN$LJ
zb(U6cY9a}-N$9azSLP^77|l3yvxA<~Rr1{z>L?E=6uZ=>zZHPqn>w;ksE6gy>K)qC
zF`+miSWviX7N(neC4kpJK5JukWAq(_B(HWqO-k|san_5^Zo#_!UcCA0XItii;ZjN#
z95+U?<jjw!@?=Q}vN*na_E?CLw+bWZyXqWgnF_^d7fh;ns@$>W|JGW5f<b}kxD?GJ
zXBOV<K4R&k5DyZ+(otqTv`b_j)>Avqu-~dQq!DcLNth(`n^Sbj>3Xn%dv)#Z2`V}(
zO^~n+#YcaKI6!wHg?5dpj6FD_Nw|397;{Kt_JYQ-JKAQQ5wUttH!aO{(=_eW)@T-8
zPC+-?I>Dl*L|TG*C{rD^ftM1v3>0jEvl>hXCw*ZBpLa6YGhM&(=&A(X`78bi+9z&;
zl}7rMGW7hslh?SI(X;y>v8~f%r84~rK)H}oJ|j2-pRqa}e3<_9>paYB2aM>n2bfvs
zw@Uzf>;{&dp&`+9Ga(|lY3Ta!Cq%K~Y*A!#|E>A~pO)&CI-QO=bBBa#kCk~?pi}ZY
z5U4eoV5#u_yyC=leNqxvUXS9TGhTb0wkCHybZ~q*;0`obygWE>o(GK7U>)5zN^t(w
z_<o>!>QOEfVsVyo4P@)s@k4o^*^<BwN9XFlvVzmn>i0-tlNRFpL|{h|*oJk-*rKG5
z8Wp{1AMA=nJVw~vUXE5fpf~=F>IXR}`dtd%59|qJ2KPr738Bu3_2LU}t{$FIyJGu1
zW&!MOde{9IJp~*e5~RjKhCUMP8P-Xh=)Vv6)8TPN1n-b+m8!kp6vXNU|3xqp)Rh!f
zg}{Tg9?QHPE`6rIQeQ-%ixG=Zz&PT7am(+J0T?&~?mJ|QZdR8z1z6snNt<BxG7d?D
zT~%)~@bve=NoG_(7<sZH@&xhviDW$z7qF+FbJwFD#|K;-8R%iVek~g}p$X5}H+*p*
za42d}l4A%lX+^aI#CafJD7rWphegad;G1d^Z8Co?2o}u#UD86|4Fh+U+*epmsT-N~
zs<RZ^u`4g^a{5L$FQW0M5TRQIYVW_n9ooWQFT~lj_J7zY!;M)k!%auUqSf`m+<sts
z{RZIlKmhCdf60<+Pcz42->X~ymjbX!YrzBFOaO0j)|n#;yOr0faj^HW((^7R!yh-h
zvHE0(js8PG{$N{U@DJI)e`E6(agwbpwT|7LRIo~#><VHYbm)P^X%S65CWlg}2PmVU
z{Y#ubI57g8yiEI(RlrHkpPYon5k_x1{s5Tm?dAHSq@{6m$t}DWY+VpQPyxqJd)QIo
z2Z(tL&qV#ytv?uP1dPbR{$eEUr?-t^a)Q4SUxuPfG5|p+?tmbe`XN(>?O;IX0k+-n
z!m7VZWlIpN4@z}M9|{5pAutPy!-6Hx2U2t*jy>Rg19pI$9}P7JC32viP+S-S8wQ)S
z0gj{$YzH&}LpS~8DQ*2AigkPve`P=K);oNi)jLE}e>mO?v3?GmQ+Pl;=hPwbTR_2e
zBH@{h8T&>raNUQxI*|7nVIusw{%4xBY3NcQebAbN>M+TNowR+ZO+RD<Oc<Fq^ss@z
zCWHVe=fgIp0bta>L#T~~mHZTTtA7T;76PmP=0|g3I5{Y~^v>VZy-NV_e`5y)o3sT8
z_@jvc1cSkUHix(6ZJ07_5GDOndrLspW$=;nTOjX0*eQYj%?>~4ERUa&umVGu0&Dw6
z^I(&9SN^JsZmL?23k4fo{F!_yAU_oFCj$raEFk$?o}m+c8u%iOKdh7T^Tf>!>2f^%
zPaFWSS;OYr0HV|IXKIwgej{IoXc{gD><Au6dlU#~1#GDW4iqRYZp<wQUEE~*VOD>1
z)!=4PNZD>{lGyVt2i~rc4F~?neCF)Ng(dy^Utc}zC*P~ETdVMsGH#7y^|!#5X)tYb
z&{fQ!<7(@1JBS&8jMk-Qm)^4IO^@h9tNcT0R>ps!30mTb*a7oE2Xc-a4l(`LrXznQ
z`4z~j$N@;#<PfV>=-mS-<^BvMU}ngS$MIhE2Vk9cCa<T>w^EJMCAszK{Q>q4t<Ntn
z)KfL9GL3E{vtEhkIsvv9f!*g1cR1uK7=W>eI<p~T-#FukC5@L9T$=L?1|@#*eNY0l
zy5+Fd*ADa{_|WqHT0Z)h@&^M(={?x&L7zZDpFqnZOAxOIJP+;q5B&sIKd{v9u%Rb_
zQdYqx;lN6EC*rTeaP~El#1TxtbvjsH+k^tZ0=*t`*z08lh{H}lsDMdl=)ipa(i5u)
z^iM@VN4z%qv&oUeL8b?z$FFV3`K3rN5VP&@ftXJph<Vb}8knSCu(7R<HPEg<ga*|Q
zXbct|Km!P=b*X9VV3hm~<->UTzl$7n_0JMO=Q9ae|K8b4zi{yo@v{irRDpH>MW`;n
zk^EJtT)*p4^)KY0Ka0!w<iDuVaOqk|S=C&eOyU-T8>rFRpK4_A>zi}|@)W<T;3(qf
z?v4IMZbf7x^1mC9s{g<lqo4fI-|2(-#Q#tM#mj#K4gNoD1{8k=@I(KHj)RV*HfH`e
zE%;JDc@HcL_yJI0kjs90zeW<y{4YHRj60dxp_&5x9F8e(f9UlA-03E<w5I=J1c4>^
zTg|{=_tX2l%{;%u6{zS>rsV*xKUsyzZ~u<^-=^yTeE(Z^20-s8o9h-t!L0gwCk$?`
zg=p`N{VPC>0g5TKfU;j*!>d8@7fhJo8SvlVUarU5zBbuCg;)os0Rx8YR|SZ#z+Gtv
z!&)ovv>~Yw&u_|+W`RIz0i)3aR${~fGZmrv9fG_)g81uMr?upFDae5Bf<bv@V7G+p
zcL+D=ZH5dyQ}zfxa2)pxhBK=Z{T(V>Iyh0)@_n-Uol6L83lu#lHvUZjxE;U>Pt#$_
zgw=kx3gAYep9m)6nO=_L1G|4vzw|HEVK`B_`hBvrKdA#8eiK0aLA~X7{RZRp<SPKY
zuZDlh<uPWyZ3)5brn!fNei}F1bBNztD`6DdapX&L{a`q6e>tkMDA}cN<$%%;xB7?q
z1(yr`Lg*Y~GH(J%1&j}eQYni13h?%abA31@c!P8fg*wUKybhodJs_exl)O&cL*Og-
z{ye11fVtnGoPa;u9*wnigZ<6-^hYKm;DijKpdWt(DTi)=Ow;f0SR;OV2WJ*$vbgz2
z$n;}uUl3&T@(gYrqpd@?ZHa#Z9=y-qij3vBfLz?_j>@x@HjQD?_h97ci$3s11P@{<
zaXHwg%g;mhGVoM04!xW3e|1Gify+4f0roSO(s6kDCx}CL=`h~0Q8@I54!rdu))AEw
z07D(?AEDF_=MNzGz`I5N@NNZv@uZ_QfcyWm$MJ37VCslRS(-rVP@Q6;L+2cQ>kvi1
z>9+z0tUfRu2d6v(kI-#U5)S(}F7FGf!!wnyfpPl4fXJK#n@SKnhbCvbT8<z3SH$^4
ze4pwktw2x*&cg-;4}!6WCWps$!}drqC>LOrKd}DfHNHVKbpbCK1f|@E5dq)V`oqJ%
z5nFUK%>PP!7@*bi!0-Nx`n|uXuao{n{q>;_UI@CW^B3};{wD8fV*_pnIE)NK52Iy(
zJhF?h!vQ_*Fx=xfbPWJVKk3BuP5c_5_SrFg)Gx~rdr|&j!v$A48u{u}AxV~{_e;Sw
zpZK&x=j4#|VbF>AKG-#wi07gK=h!2@QR`KR7Q7bR^{NNAJ08(?LG5djUH7_MemWC%
z{+?NipVl2}5FX@#n7HrF3E&vz<%xwsf^9NeZQ&(PTOilU;@~QNN@b5v#4IV5-2No;
zwDaIM;;a#+lAa@%Xj5#>q;15&H<5TTlnq-60h=%=mI7RANHm;_LMcM?=8=cDLBK*e
z&6Bf|IU>7r;JM^X^xb4Zf;#)Zrn_>y%*<>^H$Nv9=7YLn=F3=?qNyQE-5b%r6{ZU4
zp>8mF(-N@Ko#i^p&L}UeKB80>4(WUu2Zs^I`Z5M6X=*4pD9FJGBSBe^lZXSgLKI4R
zBW``oG6ketZ9sdX!GHHlo{B&^OHx#2!uW`UY|bm6`#}_PG0X?N2Z3`Pg&n*rPWXc~
zGZ5<{55ZHB115=0`))ruYzg?dh308UC)PB*{gf6?3o2!x-7kTs6T>q{G=V6=mkhvL
z1QR40e0bABJ~G)KRgr@z$SKJ|goz`w)8ruHaAuo<n}ntserjMvLHd!G&p~An)HyJy
z-X!A5;{o;c2B^RE{euS~o`$TKzN9=^ji6|vP1cAk1$ZNo(3cUkJHeMDt1+inmK<f%
zV3rUD;d%LlyoXS8T4d#A0wC~QjuxV!5};D{+!roD0b@8I`aD8Ij>%U;PJluZ^5j-o
z--JdwMXQZVe{ROjlY|M0j9DXcps=u7LsmA?f$d!ewhn?aw0!QTB1<u%0+`MkxuL_X
z64C$Wob@T8(UNL8N$`?vA?U)R{DjP9iEw^NIOL#1^&yrN3?jQcMBj%BUKRa~!l6Nh
zKOgK-``S=a83A=oKBgO%S&f+-rMe+yeegUN(EpS(x-H^_*^Qtdb&mnS42;-_0iaHc
zq}U#ySI##a&UHa^C9^Th^mIe!$Sre`6l+2jAaV7wWQBr5sAhv~QXe5XscNYVg*c(_
zX_U>e&AhTc)1D*DHe$&spt~X0<WvGwL7!@<9l)CC{yDLJOqepnvS0oJ=!FA-0^o+A
z!OvUC$|N6!iDNTg`WGqyG=e&1$-&2A&mY@Lz7X~&SRo32@+cpaYBoT09C2prIUd5x
z=ap}e%3h2k%=`i3k`x=P$P-^ninB^`^n{lWx?ht}id5*_p7n?<^~x_W(mnPS-~xP{
z6XGFwasa_hq6^74NPSRZJw!r0sB?RuF%V0XSU=kO0E3w*+Z$#F3L;M-69%!o0Q3YX
z)!~PFL&gv2fR>Aex%?o|0JIalH*p9_VqcmtL*UI5@Z<n6A9Q4|{86ANv4E2BAwhdk
zQEvK?5&5J1w2-H?B^4s3J%m7f@<5SjS4t{qAs;|<N(fj54yy+z89UQLMoZv18gjlD
z!p_~dMp+Y_dywpc(l-_1mt=T(fZIfy98(&=kIMylUt!`z_~kHBNGkyS4>%rR_vs<}
zP&Omh1W&4gB17y!VKp#h-Q<nPLfL$~bqcH!cmPNkm5@%KyKnRD=ILsiPb~udDrLUR
zDgo-PK(kh|8gfkgR?>-k)f=*aphQ+mN~%?X+D9D9lH~ia>TRm>4scyL@XX|_Rtk)6
zTjGD@NF}X{24A2vrYtJyfu#Z_FyQtX7Jw@;VDoNDK3)+qrxO6?ig4z@F5a_@gA-L!
zQg8|1f@ik!kUd@jKN^xALR#btX^IWNIWGYvD4zmyXmY;6i~zo-{rAu59xLltJVYn}
z`oT*FlpwMS1zf$iR<dK3WKXPQp2-FX@?{6e9%%OHgJ=G2f9ZiOON0Y^7H*Tlkaq!~
zI0`5wvo*k#YAF|}4PfMNi%L}S;RfkJ4iDI6V87HGGt<402gZ?yEC$FY!#e%08{k0o
zhwXd{6!`~;|FEd=mkkPKaW;8EHs^quQwH#e3X6^V0j>yA?Z2>0-T<%+=jxXw2LSN_
z1_2o2r=naJl;i;T56r`x185%DaU~@`S@I0V9DqYvYVZN{3Mkk?J5zqr3BDtqstlrB
z6lcNiWf61QKi*gTSv!C-AN23B|AVkEkB4#%-=~sxb+Sch)uO0uS*PV7Ns6KfNo8wD
z80(lENm-I4m1WuxVk*p7XDXr+V_#-sEZL3S7-s2rzf+y>Ip_QRe13nVS>A1)_qp%q
zy07bco_Emmu^<O)ApZ$E;PH2gkg`Xhd%s?4fK)!hc^0fXIPEh$<hM2Toj>zEGyNna
zJ45KVXRkkmz=Y2mA^SqVRDw)RccvTMU5V@wb@B<MUb>5O`b!b<VpAQoq@ZsmtV42V
z&#zd((0r6(XmL(WN2k7fVkH|@&rCP(Y>?XXZJ9OF;SXxA`}q-)eBfYLw+k0kL(KeR
zr^V(>XeeO~I3{uyp?wL9@lnVnLOzD%UAxdZohhCNw_y)-d(j`Ycnf&M*C47B^~o|=
z#MKo)!BgRi&Ml+9BQ$R)Z45d_+61|-vDjsg>nmdkMG+H2Rp^6okD#~Gk1TQ7v-1jM
z<H(;K6#CQQjhpkK140Ldt|34Sb;OWwp^!bzqAcJu=>0bWAUp4Imiq*W8;J?{K74Uv
zh@jIReTSe1Bo)`4-+&})pzNWiV;&#U1E7&;ibR5G{$BaKMCaG5*9;pI)9I#4NLNpb
zpUDsafyH(3;rleE_$%n_juIL)00%3jt08gIwhKD9GV+OJgW*c!P-7(3nZsDRW6w@g
zIOGC7$UJ~K1mpg8xlaQXE^Kl1lc4h7om+ITydc+yd=qrwkf;~$GWP61GV6bOo*;VS
z7DrvUzWM$0#W0i$hIRO3s0!T=>9z*fV<45pA;XF){4s`+9Y72+azH*!gyudbvlkGF
z02>IBx&WrUc=zlb0z{<6&n$u5o({<$c1KVP1UFDOW^lHLg6P?6eDs|rTDi`|Kxfa|
z1qsrr@C~GENaOXdp+gd*mZ>4*!w#2_-?>*7GG)MZLEkrgq6nEBVW$o#?lnO2VkC5C
zj<ewGad0dMXc#e!0WUm61|VYuWo)MHfac0O10aZ*&QvRQmZ&&y-Y~wyd6h#V^h6y9
ziGBVz1?luKz=eNiS7s_50Skavkk}H$Nh|bgA@{uoDD-ZCLy+YY7GIYQF@Y=&A&4aL
z6ARF(6+196HV9o(R{fQ;;SwO}=UEWzh%iCDj*^M1oCZYuT?w@yUmeBf$Bpw3y>wKc
z|EezzU3(+MEs_M^9(fbtE@B#Ld}Ij%C}3Q#U35k*UKtX{f?bdgl_6PLF4&!R_fC^C
z+<yoFxML<EhO}MK#~xOjLYKV@*_Ljx#yIb!!(HgJJF$=ouZN;#T`$1Fq&99s`Zo-m
zz8jEeY86j}?tgS1&c$jtIuGB|j~JNdnWIx3zJ)@Tg<g+|K#tx1EFCV<asip9(a6DO
z6u@1_JVroEbl!CWF*;wL;p#3TbT|(-$3uqtxt-}x^ipi_-_1geEs$aQa8&*IQ*>-b
zv4M~Ql9e&_Xf<K^m0L{&@etK8z8z2n0`WBf{4CU{M?(gcRulOIfC2F1r~uVm?*p{+
z4Ec)(nrdO+I^z)Y^N@?ZkYsEI*9_<f8a56tYI!Vl5CrHh`0l56zVV^j{Z&1Jp#vEr
zka6PJ<+ug$*DooG7y~aY$mYlaAa^_e2Fg%)>;bg0<mVOqf+yxDqv`;;Bj<-y`V(xQ
z1mLpbXTYff{xw7T)EZ_gf_gBui~Ph9EMD*tFw{AjIDpuZ@S|KXf*~Wvh?wA<0SG#6
zJw*ExOok`Kq10Y^;D1b@wIT4~78E<bdvXrGMh=rF@@eoY1gXa3MXG3JKybE5VX+%3
znI33Oh?p1fBZMxC>_(vXItUaz{JXv`&%8&R_bfpgMjXszEaYw2843zzfK3VOpm`xr
z=UKe|XP&mr8#*T=<SqhGS+JGM&#eUL`gg$m{K>c<^{tHwJPorl$lsfr^Jmn52$>>1
zKKDz@@Co+Gi9f!L@MZk0=@oYB4JBF_{yD2)OyB$climKJ!uMzFt*32`x)nmFBj?nL
zJ(l908pO2o$acQlJxWfHI$+ZIrOtM#^7)Ef@!++Q)f7{Duye~gL+X6J)MzL?b&X(V
zAHCYO%;}D|8S`!M6z>HcyZ`3i0ZKw4K~?Iwc}Aeu7UJ=0e{N0DA4hfCX7j1~?C4ZK
zyUH_b*@m{wQVJNow_++6o}koT<hoy|qz^`9rv|A_5DU+%>#3MdWycszJ+<#vs!Ni8
z!Xg+<7+vS8x@9}d+=-kVn4hJU6j1yy*mwz>KHrXObGjihp0+LJ1wjhFJtmKQR6uLK
zO!de`Q&{J6{cXAr1p9Q6Rw!KQ&OOuje956Pqb$=>IijtJpZB*UiW)_=mo6qYL`!?2
zmMDwUU=}IP*hSc6Z17$;YzrjGiW0QP`Nv5`?sON`@TsR-WoTVds`b2Y+2hJ^^|9yx
z!;EM4IOl3jn(kas#>RGHZDvr8khIVpQFphGB`YVknak_uHt8Nj;a!8M>X^*_*<D#*
z6a#vmWS*hb7e`@?+d6pOT#=aoH{W7XFW>3zptk<=oS`)?0jKP+jU1w4?>VM<<%130
zi)J#^+80_j&4|=b59rd<YSvyO80>DkB_}*)|EF_`LR^>2gkiDgWIHgn4jfG^!}*JG
zZGp5H_W<WY@_2oV(Hr)q97a2cB&}#)mi@lr5vCWZs=&v-{V%U1W{;c~Eho+4`F)Az
z+X0lpwd<8LOt83xA4-fm&BWO!PjU}BvQ8>u_$<wuz4(G^UYErnYE_9tjuBcTA$@Mp
zm-0pbib-+RCy$aI>G#8S^yhY5?K)kpEa&VV6=on%q?`AEwZY7TpLwXK|GnPvfIAPz
zPU|{#>scLUn{`H-YIyAMpyY9>@izLWzr=Ii^<)f2ghgl4{<0>y<<+;9rj#z5FOm4(
z@n95hBfrwW%huPdq2Y8faguqlrlli%KRW$-+mL5{Auo;C*PO2txu`)g(I?NJmUzl>
zcfsW108aC9+RVmk55J!HB00105|M6-<YxU4M^@@Nr`b2#fOo_uaME7-g@1TF7Upi*
zV4u&~MMzSf4!*wji|VQ<CHl>9f8Wk%NikW!NY28eF-+7Y`?t$W+Y<MAE$!ID37#da
zUucWFHKJx~@~%THKl}v0>8%1yR#`Va)ORcdwXtl)p31J2nO@xwN8K`ut+(~JI1wwI
znk-_HODMak_-R5|hgS3SMCM?CN3v@GDtQ^g*GF~Eh~~R-cZ@Ge*)x$%j?J(cdlQ4B
z1qY$O9<SrISZZBT@aDOB^(fr-NoB_d|KYLg?3|rB^KkB0QjD*TKb7ohyR9tQ>0C2k
z*X40eQL*wUcTDxZ*5pXL)u@oRaP2Z5rDpG~dJ^5V(L65pka$LBg!Y(YL~V)YOFy^n
z6*5>@v4WB>?fx-=*1QrHXWq@vH*u6D1@_1df2AL6vN~#t2KDq%P`7DSjjY3*SMiu<
zed$zZ(mj)j#~)v4p-O)U)f+3xc6s4G7<aY%c1=^%itug0)pU=0W4g(ERvq9g%6Hty
zUO0g!M`$uGxAVIKw{A(mFxm3zj!%Xj$4B=)za;v|!=ZPMT4+dBi$A_}(f2!Tl>rUo
z{eS72b@zFX&){ia{n|O7dMdnP$W^=syQev^U8o!L?os=TCKQrcsr<3l(ZiM0ud5E@
zmdejT9#MYOwO@B(SE<;^2{Z2IX2#&dn2~+$a}=`J?EPL$l6*-&E%})D12BWsm69;l
zqif2POC=#iM0=FcDB&uyX3gh0y2DX9y}?g3PwmoP)A8oW4B=Uce->L~_??FK?u1(u
z62W^+^Aql^iCc{JCFnF1-^P?AA41A&H^OpDi|FsK_-<2svP}&wkCi@S*tk5tui0YB
zaEs7ui}a7doC=u|I`UqNkO|N5>sUH*w{Znof`e-1zQUy+<CIkMLp-C&Gm~0!Sp#Ar
zj>~g!bP~TQ=Uh#M_qTb1<~O>iX3g{3?h>;ev{-qOe?uMt?%U-W-WHBybzMApc;}t#
zcS?ul`@0gN;lWx2ceVD{Z6i}QH8+@3tE8^aY3avTySVZ3QrzV*2~>SrvodClU&L_t
zoz$+Z9hwI{zR!7H*gMPYjwN4EZAmdbRhUtumNC-cK0D|!^+(>bew3-cQ{15aQvD5X
zm`H5upq=;1Bu)H+=`G$a!b4)NeQ53uf~}iEt0ap)R>^(a5z5x&b<=~#^l;Ym3KiN0
zc<z>cL-wmn+<5p`Iql6qgxb>1U6L@O3bzKErl$w_R0llE)MRdT((G{2{hIRV<4sYC
zPg6Tybi^34u(}=mm+cOlXm&2%!*dE7W5R-U(YxFZAA?1wP?HVRa1LF6l*b6X6HjIP
zeh8S2RJNub$mg8;9F;SD{7FjA7wsJcNA|&PW}rEnlx}Bx&OMNz^L1{udmDO#UBuof
zOt#o6cKC;8N%Dqqk6V5G>bDe*qB7>Q24njpTvNsJ^>3EXhM(hDPL(%Bdb(&nujkp4
zG2CO%4Odm`sp}e*r!1RLxpDE1%IY>=Y-&wipOGS_2j!W_`9N?%t<rVMF>+ImPoEnO
zq<j`6(wZ?rB8_pKiCM??uxSWd%<SUfIKE|)ty8ii8E&~jRito5i$}(T4e~c%OpNAd
zoC#V#t{?Bpw*@Vkg-_a(?i=s@s`TLIMXb#oVUbDqPoXi)mfS!O+{U84riJzfxWSY)
z-C`?-gQZJ2i;K}Lm&)-mqY>Fm$aXp{MlZNKCprq#qb*G8xx*IR;2<TgL4ay#qkPk-
zy!>A(QbGIc9VgaINtsP?;~IEZ`f=aryt)?srhZVKxMn$@C**li9rkTOgx#2@bn=o}
zuRC622D-M!Rc#e5RunXfaQA4`g~F7|`!0OhW_8nJ&MZkjx@#aY7I%YUd0u<P4B<T6
zYuuzfpz`)~-h^^uu3_=i?B{+%Xli!1)<WL6sKOU=Xx)8VuKhUama-I2$DHGv;??pw
ze|xgNeer;3sb9={s^oCWX7=Z2rkUsbi}?+)Z=_ORg|bftEbGg-leORU!<RZrKj|A<
zW_8r_>g;xk%9L)x*>Oe6rEVPCu;)#iugZKuNuw5BI+l!X9q{^`qd!^E{h^ns+)(vE
z*L|Jnx^?SA@7yf1J#0aFJ+XX9<K9R?q^yl=lKX-5zm^POl~M`|QYJ4K6rd;d_gxh|
zcqcSsCc~@Ep49DWT4^Jv85(4q>UX)%WyW+H=j=s#*c5GL!3wdRvRa?GrNe`3yA>9R
zg&(e<jNj&iz*40`s{SFQ$0d};RDv269TY;Mk;69gcS$Ss^HFY*3Ws)ASP#{=Cri8D
zsrFZ`naPTskg_D^kLQH3mfrj!)Q-)nW=w|8zGz*%VC~rBiU}1EZzTN=p5z)hunr;v
z`wrD8r%@f8pA{uYIlt}|JQa9$Hh{`nZp%xkF6QX8Uzr@WwVFMj)UV^W-bpV*O=s+8
zk=RY2Xps^$FW2oQ55EU@`5P$78Fvfj#?35Jo~P+F+uL}?MM>VKgL6)fJXspyqNQh_
z{@tHit|w~J5G?N}X8tz3s<082uRHs#5*M$%^Q!SeA=W~@;Rkhm3HF$M!_BN0E_mmB
zRAv7mO1ahZ{dx!Gl-f#+(`iE~Vr*N-0M!+EdSDUj{+im*Ml0iq;|d~n?7ktiMYkBs
z_9L;H$Y@hF`#u&X%<Jyd=v)}+B$v6PyI1@PX|_m{g};z`P~$tdSUJV%GtKwrOtOuI
zt;`2Tb;*@3&1ci*yfY!SPTAfKK|3eD%NVhyi|ptMbA$aKaFI^!VldJ*OcOGLG;{pi
z$`$0iZ5_*I8ML@+7Cz6U*LX3Lcxi3#RiSr_uIhL-mxy-tM{$i%<-?{f{S05!qY`G6
zJKcQ%6~1sGE$>Xx+hSv-Ei;r9Jlv*`RW~GZW-;8DT`&m0Vm}x;Gw=Z1=1K5q)#>Bq
zGuK29xIKYYK2&7ch7HV)4GqCnqO&Cf_62flT4x;WW<|q&0(D}fT;?x7<wbT8IifUo
z-PFPXO{2-Z`*5#5b<Te7v`h$_28oFlq&0CT8N}W{a32m!aZR|?X|3HF!MsPob6dXm
zKkbp9QLX$kYvWQkL$ZCqS+)OkF2f$C7*+fH5DG22`DmPKII%t;Sbb@51FNBr@R`_Y
zB*o3!c`co7BsZ6(zme_b`HC(2?hm$w*;M|@!yGHBzOya=RGHI!<+43brYi!c%>CYW
zdyT8S>-SaRr5A_Ps7OiRDruwXsa)ytRf&!&35%cdvietM`ubbBR()O+wYD`Tphh)w
z&Zp(E3Cug#T_H1A7aV@u6(`2Ec|J5gU>zS5ht+4s&b`sVy!4t<ikCJQQ!Gs6X^$N%
z4wU^q*&idDu%TzenonE2)u(Z{)Uk%RP`f{xE+zOh5$G)aCTWJZ`1oS&fC#2KPPCOh
z+<iH`M~-Zl&~27Cb|sE9g6ZB^(d+fVew5IymEEjWX&p)Fpj59b*@qKL=njg>X5%c!
zXL`=KX#mVk_Kfc!G%g;xap#8bEA+Es4>|S&duev&Y`K?0%GejG*_@M1Wvj|8R_QL?
zb~-7^;z9qe`eNcoED&C2=uFdhSzE3XfRx1})aYu2vd5Ae6Agq8|1RhafPwJH7cwv~
zCeeUa-3-M23!u>cO-mUAOYu`<K$xIkw3Mp!i=T1<q8SL-)D;!L=^a}J42YjN8sV1~
z79yoDFjCITqkzgb2gwO3^990_fCUJd`pKfLF9RCw82A@fT>x<cUfGfx#U6$O2ZAOy
zqFGP0Zei+(X>_I`!*$`qNFcuwffNw=iV#WvD6tKs#g~0YO6(^A=AE@tn=725_=kFU
zlU^ReNOYb6UH~E8fT_NauoxVRF2D=?D&mn+UvLEoqrCIn1>l(ln;<_o703i2KcLKC
z05&k-o`L5Fp$t*sfW3k*LQDiiKSEx0BD_Bum;#h@Y6Vaf=VX3W>UCyxq==6aaK-|j
z>*uD=7vKdt8yxee8poBf%^Lw$(1ioP=geZ@aG~7a1!PL61*?I`u>jfw5l&t!{Ad{T
z*~?Gd*2N7wLAR#e`yrI}nT^|cYMG#7AD;|(3{xFvRF=D~b_+0>v$Et6i4x@b`?`A^
z>HrKx#@wQ;oYAUzp2b$6lJ)F4$9>u>>OMR<87AaSSfga~#?Rg+h0ct%83nvk>sxuq
ztGRHvYw+`wnbA;7ucP(p%kj_W&ecuCM9(Nl4(;tYLUFpu&_8z8YH~I+e2$o*rIZrj
zEkSGNnv4@}rP>-*=u7e&8!LRNticUa`)T?|VozgUo_yE8ZphTH&i<sS(&6_FE?ctE
zuV~zm3tKUq6pG_S1fNk^%kE%RF-<&*FOeQ*M2|l-8(V}MSGJ;el-Q%s&`s$~YxA-X
z3d@L9FqVZY`dm`Eor3S7M)-DU)#vdv0?l&O(-ZrR`;_K79F<hQtifEN-w{)f?Ig&N
z!ZwyR5U#*FO?jn8RU8A-qwiyrCi{ZNmG+crj4r9!<Ch}~JXBa{+S8Hx+H||)=Vlvc
zvM9G@6qBEIIP;g(;@((us-{vo7T-oE@z;WKH&*N``%8PO)=H_{Y@NbtwqqH2Jx8Gp
zTm!)^9EPfIA}eDN-q)E<k{<G6o^uEOjkfVdy5wW)4i34Q``793)7r)})jQ2r*bKO&
zUMUR^=1}zR@ajDjiYn^D<^rag3y&?sqt#-pJ64};tuZI}gW2HIcwhF@*1?oL<Nd7C
zip0J-FYH^BASiOkXYQ^FG1@Xs^*XJ4a^fJ&^QPOcqPy5%h^WHd?Z7?C{Th2Qc-ew$
zMqU+ugdISapQ~DEti~i3Q$DqIZ*!Ax@tQdNVSZ#d%a8PdLVNt0`p6Txaei>)?rvfp
z5M7w$l#z2;<#rMH&!zbr+P5WR9?k8`N_zj@XXzdM2;d6;W>A4PhrGzSH;C?NPw=>_
z`zOPq)th>oCKb*N^yo2NUWUIMv2u>caU}C<ABK;~EtTFvYG=(7_K&CEQV!ZdpbfL!
z$ZobAqlIJ7Hx5aAdmJqTy(sIB<WhBX6WP9DYjYg8hT1I_tvJEBb-6j3)cO=lJ||nA
zVz*`u8Jl_hXn$;lr|sgH30V_;dD1u~%G;h<Yy#$>%P1E&52deOTku11y9=0{@}BiR
z>V12xtFLi3+E%m0`dk?-{pUY~VDT7mwaPql$hejnxRqEOG%J&(Q|POMk`6i$ZdaeJ
ztMg=#(K>H{e?(-|Xetb^yNJ?xi6bu^X2^+nbttu{B?k;?O(!dHc1UTN>7~~ky7OxB
z-oJ1PuAfc!vCO~3Ud&PbG{&wc#s){6efCa)slskZH%!`H)j*~6Pl;z9wRt3K>dRj|
zLFI0|z?M}YVoBi5dO)^gsQ7YrCylZO&%FvT<-U~PKbcNOF7!%~?eyk-M%S^G?53tD
z#lnln)<2tzJ=*Mm)~1p$-zJiLq;vW|^7RWRG-KSkzD{T!UY(ji+}&-PxbckH*V6|-
zo#S<=vRhPmkr_Cu0@oi`k#Wx2)b+iS=?hLMH)H=H^S)uXAUt<Z<BRy1OU?R<Y^5`e
zjB-u=RW%tJnpM1~D&sE?PTp8LyI4Co-#O@-R}V);p8DKBj_#k>%`w!i9-rIXx5fc;
z$IlLDJ&w&oze44{q*Z$p$K2_Uv95uPaU<i-m_K3`vs0?d@s~OFtz2rm$K<SkY#uJq
z%~3YDzF1GH+b6X|=1zRK+-8oIabr*t9sA@x>GM`f^Cl0iAkC8vax48ohIh_(?Q+oc
z-;Mip%ksXrQ3gA_dsUp~&Hi!xjXe7iH`!7Ouv^A%F*;RuO%&!EzZKi~9<K54yijUo
zGa(uNjJs`IJ>ixbju~k)#?(!x$um6SuPx~n-nJ#?c*@KqnO0j2OA69;Y?eRreSeAa
z*)~&SF5K&y(6%kU)O@eTs_r@SHl0#imK(Nu^KI8zrbjt5$YElM8<D7O80Nr>Np&H6
z#Ci1bo_i#n#`k-#y4IOuJRI^aCv&VDe?#~1)gnq%&{kenX4G7Qg2w|fSblQy&k!kB
zk@c%QQ(m-$pRZptY^}ReXDhm-eTHHC`ONM1+_pSM)O<Xle18e{Wg9lHtQbvs_y#+$
zVq5<ie)uS>vecjP7uVFYle+dS`vFZw+XSV$v_LuN6HWEArJQVi;a89=OqQA|-mA+B
zqNJG+6dOFgPTL;-$p0g;Vm13FwM^e2DzKyqMf}on`N9%PsZt?^RQ;|$^{RDtb^Z*O
zWC{54(rp$q(i2;7LhS3+<43BkK(c815amcp>y9^^-9WedE65wywLpFeN6c)_Zwfa^
zN}ko=D+DrV1t1>h4VjyhG))cG<p;`#bb2U|Za{`sd4<bY%Qk@oO-TIipJII3tYeXr
zG^YLix(YFg+KwR8+PwBvQwHPPz~1;e@x&x|j@&$J!%gqNZ~5dI^|~{vf7=s+JX}Y!
z>IaMag^#(+*()yV|Gf8Bhp>h{I5W1=&!cRjjTc{{$NFm8=P?!BvH@3|ho(pQT$$-E
z4x~n;teMzSmBDWLfTGc!^?xnk1ikhzlr{RiOvE-*{Hj((K%CvWypzQHuf1tU+voGi
zop1iof5|rOF*T}0tygQeo(sy?$9$ShcbZ=x5qv%?iAmiY(LKW7&9*sOs=ujTcN+_h
zW4rSin@4)8P({vPo%Y@<-9Ox1;&rsiXXPIg>MQqoD0b^I(V4BEcKV$+IuvMmd8H#S
zSyZE=`6w-$F#DM2Zb`Bs22jHIiZ*8k=EK8vZBu^;xx37V$KRi-CQ^6Mj=xdtd7$*o
zQT|4AHQ^(3tx+9;tM|mual}$PJic!m-R{_&S*gEY6}H=Kkq=>&64Myw9KWka6Dd+2
z1-H5{6P+^8at-Qb-&yjPws<Qr*E&!}a(Nj~C%J7UgZh7(CHgMxbBwweU@3K*3l83;
z3SqkHT`_O4c>Wp&F_=@$=*Q-qjvHmlVtV9`2TYvPr)e}*E?+cvZy5JTx#ThF)97f>
z<@toa)Tj%M9B;m!dV@-wg+q@O<~d4Nf_%WVtCJ+;_$hRT4hFmmHu%_~|L$6JjPjT_
z!+Vd`3jI0xrpalKEy`P>y220JXwTkOC#*eA(r%~HE*<L}`Ey8U;QFcvC7A+s#e3Fv
zV~zC^wBkTor6!4nC~MErnAQ)ykcu)`91BD`(?R4dME`mvf_yseqQN<Negn;!&a^;_
zgH$Su1^?PVBr`>Zt5B%R3-}s@uNRA?!OT#Bcyd6l3$<XfUVwJIUgl^bqOr;BMCY}W
z8^IL@I~`jF7KguOT!9YzWC^Pd#2@2Oa4{fo8L;G%*Ul9?ZNdBnFTg_w+T<p{;Hii}
z6bTqO0c6?(s{v74AQIXdK%}58ihwv5oe%mgiFRF}Q#u1^-2}TN!1;tC0aYVb;RU<%
z3P6?DS@&eg)g7%M)XAC(8G+Cw5T9Z|mx@ESjsg8Q1I#oFbY=Fqnx-LW7mlq+I|pB(
zrD1>Ny$9BuH*dUOpe8J#46?4_%6}cD4xlqqR-|Tt7e}B;$AKb?U}>;xz_o)~*!b`x
zVqvq*Ly#}{?h>TIW`HQ`;I1i910P4R3&)v${GIB82O#kxeh!eELDF3ZxEZjsbNcyp
z21lf5$w<=xRA;6xXM$<VIUUVH+6zQx0kX%yb&)`_1;p+Q?HsXZCps-k2D1?6GtO*9
zp#|zLnw4#9fNR*&(=fN}nI*+K{6kFGgMOd!%-x&J<Xvuq{jxH4s)Pz;w649!w>dIP
z+bWG+X2WiI>h?!Rd-eC7Od5u!dFq6p(0ofgTkOLLKdOEBp$D@gX8O$R-gT<^>!`8`
z9CGRKwaN<InvykvyaW#))>+44`A-Tjch5$=9%vi3yR4X??p9Hqn#;_|n$g)#eUL&r
z%6Tr;Ep}^~A>~??)k?>v_~-U<M>xdHoioc8FJLKH56E_zrX_98pU@!j;$MDFvf(|X
zHsEJsKUt05#jW>|XlKt|+1R41Nf<hTeLO$Q#9uM}%ATw<SGMZq6ri@xH^LKIaf=7Z
zYNg>e<5u(>eAU+<LNxP_eHXT%JcSnug^WeD=<eOudt--UJpS@DW;m77DSI@^V~6RC
z?fksFsl#}&P0_@Yanml&?yj*(eU$g*5%wUzg>CgGWAWj)ZM0!|%nPp~#t6srTk!bj
zyk38vcFWrVsmIaOkEMU?K5WFV@C$CZ#jho;YrkUFVV4}!!?fSyr&*rs=k!rBWuvHy
zM_&ML{gsq(PDi}=a7#w8)#Yb+BVPjHg46N)yM2mrPp#gktSOp!P`E1EW81wg?M25H
z({DH_?6_2e>B+VpCxqmboK|mqFy)Vtw9(~6KPCEy5Q9hFzNu2)U!$F()Lvrz?C^Mt
z$;9p^lFCb7%!nCP-b7e)5oPv=P^5g@D?<3J_7S#i&epy-UhaB@%Tt|GG=@%&f>VvQ
zBSHS5o(olB$HB&%Eyh8!xaiV@4$odZ-96(mtxG+__FAE>S5exPY{7B;LUl^vA0$q4
zE0-i4;Us!pyt=<q&&}}&TYr`&5pyelB|In6itKLxX$s@-?l|yvvDSH=6_<;}R<I+D
z6OT5z>&kU{<Qgf&vTmdD+E~30w^eQLNA2mEV1npWZsa*meRndZh(UX#U~(gsIjptQ
zmq;Whw2>1Iv%KrQ@~5YWtRX*a?^~O1C3`84v!XOK`Zwz-HC+i7H`;b{B*^NOE2E8u
zW+WDwZLXQ*7OrsYwfaU+T$sLYny_8TZmg$Dsf{e*r#Q4RF%ZX8*)uUYR(PUx@)}l&
zB%!r!Nrh!Gsk0_v*>2<fK$Rx>z;3FLtsiE&-l3Wv&SBF=UFxQu^O3mwr|rKhpK-XO
zRpA-?(MN3jUe&RSZzuE%dGQ%!Pc+LBbsX1hw9&rkaPa;irNZ&AuLp2q-k<Xc4|FIx
zpN4QvHShU-W}YqMg#GOIX+x{Ie>UD5#QATF3ytqzZ8QL~-Hr=8j|W#hZYCGGIn4$n
z*4*DLABbsqbG)+ac(G@XLuX(E%cLwN7!2tT6y2$J@Jw7-04#2Q(^@~gr+PEz@YyLS
zB<nS;vB`1#Gh|dij?p36X@Wuhnr!lRKYOzx)F6?9o(fOnT>IS6%OT^VgT}@W(##^}
zcfGx4M!SY%(vJ3~Y|6Iw3Ti&8Im4!WqNzPyT4^%Ox9>YYq%YOrp?kS#>w~PmGJP-9
z-73<RgZ!>5Nh$Ee$(5OBa`4!#k3aX_nwWBQza~5wH*6h{nlv@MkN#(2JhAg4=0HH)
zo%rZoD$5^!a|l0a*Dl^fP#WZ^QWLEQ-28mY=ljD{aCzR#@o&G0b+^W}5{xY6q+1%~
z7qK7pyz~aHOO{PK#WBQR>h(Y2zd9Y?SA2+}Yh0+IA*Mt<{z!e&MFM`hRLD3#{;8jg
z@EbKszK5Jwf1cN>!V1;4nCYBd!SWJYrT1r5W#_+TaLG=FGOwN`#nlBnt#O=itfZa(
z__5|u#@tHZ+^@W^D)?QiDgLYW#?_aS%28`{9lOTD-xzi8KFqYPC@j7(cXC@Bzj{A)
z?^C0W8$J~bFS~`EVq%2bTw8~yuRj$|`TY>OrieSuAIo+NI@4lbZl~F(5>jsTrIm~?
zjFP`9cJkY)<`4DB&hHIevKmJ1TO1m)_cvTCX7VpFR&r0WU+7c2m<vzQ^l{3lO^kMW
zpZ9!<sV`++@FurCrsz(#2fxWPZH!|;y??uJ?t_-a?4>=$Mpb3&XY}Jk#t+eSlz4|L
z%oWE*RFu~D@bw=Yp%7-xx|&N4b^E)gxs1wsM@OXq3*Xoimaco)RjGXvr0~zd=Z8(r
zn@Vw8unOb--3lM=*ZKXWBO8tT{Px(~B=12R@zVPAFKf>9Cam`!v$L5ns`O%W%CEVe
zX>)!!X%R}=`;4M<D(OBI6^5Z*g;lm3JFA;!C{?K27>A;s5#Nj6I^l-X_7x>-(YlKA
ziCH^iBP{FAV#lWEmX)5pwp}xDnE&S%bF_p$K#$VHQK5*<?)*tGa4HQO|MU+n(Eth!
z-sPQGqys*mbb!R*{shEu44D~teIvM{o6`jD83e*$(-QN{0U{&{JS=CHXhdi<wyLc;
z`tBfNvIDcF<bnkVlV}DupchgbV84gJGm1#ATZQ<F5cnkW1x9TPrdlHQrQD}IfTB)u
z3>0Y#U>bxX?G5bp%g_Ygq&)&}Um`XWi+J-!55i=CSK$9kJ^w!t3N93o6j-CsPoF3O
zW;;U%zA_$MQUIjz9$*_ZxE_l9hu}FSVS9i$K{BS~M!4?BrsO7lF!n_XF9s{t8^rz;
zDj*OO&^qvuG_;t&yKPHu(g2?_z`vIW(gVKFAg?ae9F8Ys0HDScTyH|*VElpK{(pn1
zhw2(|f?uc%z}_wZO#cFIn-K(tmKGP52ZNk3SSn$g|BHvD3+zw=Yif@;G9v(SJ}>%d
zfGS3gYYX@bt~3z*^elwc^h4;zpDz8MW+&ET!6pr_0s8>qxgETBs?vz*>bIE)rZ?oB
zKb7bVK4l;?%^lUyYG;1ZnaLztq_CvOcKP`2*0y=?Vgz6j(*V$tl}dx(0~dhc#_jg5
z81Px0Q7Z=LE|c8&E)oqN2__D}Ie{+~XQo}>w48YyUZ&EvuaQJtXr|I?!atg(<$gn~
zr^Nhx5m=Q{fW4T6=BID<C2e9qZn=BpZTZ#VBn5)plpQQSLFqo7Pr3V;u)KCol6&zx
zC|Elu>&cDvlrSeNvE%8L;=H5jmM7V^kuo_Mus$^5rR%l1mOmW5(5GvJPJXzqElexM
zs&-Rjyd#f{yqb}VJ&fPwzbCo)_U_M7arXjS@XRzO>zQA`wWIqYTo$>0)=AH(J<F~t
zr(po+E!9izPso5dMfS=Xd@+^Lc%|9n+JQ4Ur?Sr~9kI+&>&`!tpg4QEBDXskS1yUc
z$dpp?BH@p|=ak!~xUAr2{&nrZa1!RFn%J7*V98RMn_*ron-H$e8ji$3SGb{Gma0d-
zCR*jvDmxpO*5G=pK61KKx591tJrjBfEca||Kg`|p`f@w)=FrRZ%+Th-b|Y9#COd6#
z-tehsAI&A$qb<%=C87Vdi`I#ypM|*PJ^7d8xh~5%=3z?=wo0cue0h~Jl0_unY~luH
z`FXsvTOL{Fn{up*_q?C*AiLQi_mM>SA<$krbzq-UR%M3IV>CYVqk~h;Uv&lgXp|Ut
zCkK8^xG-y1$T^l(JMw460l77&yieNdKbr8ZoHtFvXauBudP;qu`|x;s`Getg+qTTA
z_lM!2lJC8l*8QyeRmqL4YW<5dnxGR&vlEWCgx}8NP?gMK*^sJe%Js_GvqyRLMrO@#
zysHg4hU6IYh8L6W8*5tLU4ay`V#$D+D+KjM>xMR?H~Mw6I?EZi$gocFBK_?Jl=cjp
z(aGM)XR^LeqRA&hj-PUjop0HQ^Y_VU{~Q>=zf$k$b$&&s(0-v+e<czVNwoXhKcJSq
z?lm{VSiKkB96_6qx-~<P7&3R0;ZbQhy%qhfx09iq4>2-Wn0kr%Lg`dDA<%W}Ha8i0
zg_eBWa@Sh7$Kc?)L?*WPe$KadpV`h(x@i%AK}#Y|?Vj1j2Nn<9)8&&e85pP`>%PFQ
z>uZ|Ty%~SFJvMyw(wXK%jd#lQw|6nU)!}saV^43$=0$Onu_-g5p_Xv7Bv?-&C)z}R
z&IQfCsGT3_*fm^?S2b%0V&r~&vzV$iOZh6kw`#@YaUIVy`ypW+$}`;Id{;}ea501x
zV#jn1yS7V4;B$VcwgPdOnu5t)FzX6TsZW;d*-p1WtF1u<p!XTC5sT_pEJ!to(Nq{Y
z#78VLg(=)6t@9M*>;n?4I$}D_r9fPG)yj?buAm)(k5n+br2zyOAxOF_O(91|3NMw<
zdkB|vOvZA-%6}Blrn1;fa9qQ58f4Vqfc*16;|$on8w_D+5*Sv)A!Yw#tmv!<sb}rq
zrS=n-yT6nE6CnHzX?Uc{J}`PP6mow$P}T>|A&yr|u$h9z6h^mnIujWcZXV2o1A(O*
zF@nQKf+AlMegN`|VLriO5-nPg?2*Y2KeHM-{rvB;8cAv}2MEz#mRtpKr~r)luYVWT
zl2FPEvU)0P|3YaP87F=o`3jigCqq`jc%lK0*K2>jDm)Or-~nQwjs%~qw7N14E(#e4
z;=qw938ry@AN0(U*E?JVq7EXCAu`!<#3bE-j6TRlpkCEMb0cCJT+Ye!0+kLXY`rsr
z<PBScAsmWo#0P$62@7#hBNI@d=C0TYV_>nV<N{EPfGMEC0G5C@g(}!1Uvj}}$lFcI
zG+WpQ=4YKM#%9o6LL|X`no38AgH80KQZxh)K%Fm;;fhTc6iPB&ZPVa;zz{Yrn21D=
zd^l(%*kzHbdk}h@_*3joTVM$mYzDOpgv3_3Gk<X`h#&%DA{HUEgg)5k7ovVNPxB7q
z>c4YQcQb9=%z3|F8sKDjuCklEwienTfu9Q$4e_M`7D$t(i-aDyx!08>UMRsGmw2*F
z(C?cO6-DTk)dchm%ZLUH=Y)uDUKlpB&f3Mk;`+{b=pG=MVQNKe$&F#Ib@r|<)<T&-
zw<i8;YxvkQ4s8vRDfE9hj1}$G2-4dmF!d5#*BaU(O7ueHqBMVPbMDtUkMa?KvpgO)
z%QA3TR;v?_;h3Ydbg&uAYDHjvqx$)5fGDEZR=`w;bS0QkQ;5J21hPOR!DI-5ekmd_
zbR#|I<3d497a-IARyCLk5YLk((8C2h)QLs1rn06;>;bO>B;6?_w*Dvd;P!%+YlfJ?
z1v4O^oscPLfWnYC+76R1>qxXT2pn*s|Bk$$UhtK&*q3mehw9)8H+=>%`WwW(T7<y0
zpMeK9^<VO_<bsuCkYzK7Kt~}{Eszt{%Lzh|20-tG6vQyi^$L(o%OQlHd*qu!*91M+
zBVUji&`*>h1``A<7Rb2*8cWuB)dd7Gq4Un4(7%90*%c6ymF^<(08y~8aH+jDB7ed3
z$;06Fwt!v_;V-~>ztW2tpfpK1-*dF!)z8a80uOQn^zRn|^$^JC1bh}4v|YjwQ~FQ1
zguKAOPx%>_0Ns#?!$j=aF7XNBiJ<GCS<lKg0q{$u1EM)_%jGH{p-yrm92t<71_Q7V
z;93_9=M>$A4!z;7NGj6i>5zIC)H9)-K(~cPS<W_RW<Yl&)=DWc5qb(~Ke&+ql9=Mf
z$bP>+4MAo`Ac5-gMA-oO51jT)abZcC?X#bka4r%FJxC&T2W}xpKUHjsL?VQ@3Gu#4
zDqvR&_%IRqP(bAY8>Y78mP)EJ<P^l%4y}X`g~DDxT4v}V9UaAi@jI17%NtAJ?O;#y
z4`rfRgyydC=MajdF0+;2{IYC`wahz}1&o`WJr`7`x8jQ7QDPZ>S?@dK3ehTu>VnwM
zDx3f&^tlU@doq;r?rBdo$NXjSQR>d_jb1kszS8{p(ias=o{iSK>4X!L(6M`CD?L-n
zTNZUOl?u!*K1lSyO=>?^KI(e1oir~W+r3<6$q<MotWc@e7x?O_Y)up8_7|IiCq9X8
zknHq*pPlSw^0r=IrNf2h9?eVjkV+snFc-_wvkxnD?A>zyUVGq$f|Z(O+N9Ra6RX2{
z%ah2x{E6d_+Gh&}?O^3VRL`ayF%EwI@HxNR9Gz69)O9{n*1ip6+B=lpG_o-ii{5Ni
zV@k8~gR0{()sLpaz7P%=_kuw>+tl|xdDD2SRWm%GL191dyGN2E$}{FA;ljAM%%$|}
z>Vd`4W}J;V`c!hyXSe8L#q;_Hlls%;3z^2Lwtkz9Yx8$+EwSLGi;TrRB$uh7hQ5(H
zzRze4X<Pj{F=cTtqD}_{X}#F{SKsuSmfAn&l5|7O#?5Z~oF)b?S5dPao22;5j80A!
zkL{`06VT`zymCVBPO4<AkIUOpG=1&YsD9T`-J6@AQmtpqq+DByaAhh>&(J=<)uEE+
zLSX@*0`t;?dS<R!-OGy;$8PG&6&GTs3|OVv*Y#)KiCz~P*nU$vD;JZC#<sMKx0*i{
z@yV_?oBSc9D%Kryozk_Y>ERi=KSoqmA=qm&%}@F3o@&ONRmxD2eCo3=8yh<(ZHrcZ
zY2Smpfj?<Sm?&&7L3`imHKg*^%K6(peaUdWw$$Ur)Ozpz3u`e8>xu7<zQ{QEnPGb5
z<MzyZ#y)$AEgtDy^@+6XE6O8kV;YhJ9o{Cjv0&PNR#?1!+vCAaMB7P?tNRvTUFE+`
zPN`kjEX@Xo{*3Lh7w1Kul5Q7kJ@#-;Tr6cXX_Se&qurM!b?g3?=kjDz{_-h_Wk-!k
z^C}-xmg>g`q628&b?Aa~mwXpCx(}_=4s6NxQ|d}9b?L6&!%jR-chF46Gd9+=CMpau
zd^;+C2xXS0OfHG*j&9C*?o&;!4v$S{am+|&C+$?n<I1foxx1Ecbt!r8)90U+Z^*oB
zOiJ>Mah>Xq&ajM1+LbL!c^oLWx9o$&9}kLB0yV=uX3zn)ng*n)i*r{Kn{c6?y`QG_
zhU?T6glz}4#crdzw!N9mInPmu<J7i(>-U`}Zuq{YWjwq8fvv*3$1|)Xj2SrY_ZIb3
zB`z<!=)En~$xqa(QCU~48>@|BEJ9sq-Sgai@KMacxVRzLtP4AjCVIB1mCPPIeqa1v
zU>+mEqH3BU%+9hpvZdiwNmF5aFMgkTd#(<7YK5a{_Tf~&&E>R_N%|lrIOuMV-_+)F
z?u%kd-gz%B_5Bzyn);lpJ|3NeSGiBZdraw{)|wm@Cv=E5PG`e&KwH^9L2^%B0%C5X
z-Z(%$nbWV_N=@X{wx0qkv~RzDlbM|P=QdZGwPyZILv8%c@NaPgq&HLUgr}|n5_NBz
z&QB`ZWfj`I);kqj8!>o+eW}Og)kkgs<~-_S|KVX$8h3_8I65I&*yYUK?cn6}3Iwk9
z!48jm!PQ#{^Mk_f&*k*I8t&v%JXOMjY`ayvcZ-(Ww-uFnlQ>)A9M_C+#`5*M;~L1?
z4G*+4BZ7zw8~qfU7o6!OT@Dxmwur#K98~3&Zfn<`9sMe>FR1I<;;Z|hn~7$7(<;lT
zQUe;%*vvuxpUb02iEC#zcw24DkmzupuX)}{xm8c?{=}ufWX)CXEcm);+x(NV=d18B
z0Ylylu}A39RJL0;ie&7Wi=}|`dSr`ON@q`658JUmhp2thWw7c}PPSVgaqiiUu4fHn
zbV7UM_->Ul>zcPQiisZmI~}(LD61x6`{Zxt$-cAOc{0wilIIiiLntDr_#Lt35BfQ2
zAI8WN4KC&K+R@(Pl!ttB6TR9oU^6)K#ym#GcQjWVRrNH*Qn_JfVp6h{>h+Q#&s}B}
zmUFE#t5*$YnZ2GfE4<0r*O_&7)heU)5k1}ti~VBCIiRF6^&4{6@xHr6^($b*XH5gF
zZYJ<|i$zuPLMhWPo2a*DePyh|xOz_qvwPdb@+YqQ22UttUAifqGP8!DZhqp<sBJ)C
z#{EHqkH#YjLsY3|H93oeMH<$5@_&|Pj#`e0o!;WTsYp(<ixf2zxF*Ae=9_p07g=*V
zFn*v$>_ngyVK9~u5v*`l&TkHXeo8m30@YmOdo>YPq}@*|REX%<&@37=hB4`lv{(5e
zdy2_e=H9=)zavw+C@vv4Iu2~XIsuIDI~=+sYR1rF8)UEz?but2mr-T0gDHiTN15<^
z&Ymip!&v<UqHt3Q+bqaiECrfwKr=<NC3v%Pt}EFxTk+al*qd9+R;^myi?|tRT&;!@
zoiz5)7ZVQ&cnpl|AO4R>oE5Q7t0@!rtirUodz;hO-bs>Z%88$+R9))(@;odmh1Ah5
z#ntN7SE$Py#)oz6YH|wqX~MVarhhB*cy#r2fvD)_I|f&V$s+jE<4&Pl#(NVI0|TKt
zSJ<OGrhGD&=O`k5BEYeO`1H0T+oPxa;C0knSkR9Y5n2&Y%Eylr-V-J7U5S|G7*$JK
z;FWvN2K*I}Qf{f=?Eb75=LW-^+V_Z<QZ9w#*<CanHbYtQZFd?8{Mk19Z3lQldM6)x
zJJ?uzl-bL;Ngh7gkT<6B4fx;WKW2YTmAXVSm=FsI+VZ%}Ka=9oKRT1hiwaoQ#ox(}
zJQG)$@S-Yrgm3>qBZE#BZ?Dm!mU^3iY)oXiBCc#XibC1fFWws^zK)?$5?)^%>QzQP
zDjuz{$+3BM$;hC+G08h8?hM<rM{dDa#?ZWP?1C8&ZN;HO(@11ZE9Q6Wc!;sfj3(UE
z#U828()4TTw<_aT-`;=1=#cjI*_l_is%2!K(r=6vK_;v@cimFf4<X0N+}C&Y14Hj5
zQso~`LxRY2dXaqzG>?F6vNI*q=yV`uINjpLxKx=I*R0Fd?Mxs_!<k&oLUo9=7a1Dk
zq7S^Y?^ZZEF&ud|`?B*k+qcU5_Ujo2%FLo}PJST^O%zx}<J*b@JRdRCyH`jjz4_i^
zCu8BWbBEqqOHORqC5a_!MZvFLTG0T4pH+fVrTDm8JfO-~P=g#emqnu8&9(+%okR=y
zmPNcv$Uh6E)q-BYmhJg&fQz>yCB*rr<h(Fvxi4(Bct-%}We3g?5Uh(3Q~;Twcmk+t
z3bO~VI@6f~RJ?%(l|2H55gykRCTE_I+DHR5`x@q9uKv4tUb1J0MpN|fVjlo1oe4ay
zpo&JUp8u4rp~x1LCc73%LtT@JeFic(qIe5R=O@d69r$Na0mxoSc=1XoW$+7-+EW8c
zAB0bZy89jARHQoI0QlCB;VO{7<;aZ%NCo^)`eBubtbr*a8XrU?YY|{aVc`QA!IBvW
z?TWZNVSx^)$curPIQL8P2DH5&DbiOeGh7#Zmxh-dYzF3ploC`6mKw`6mH`?^t`y*P
zp*>p1BmcP61Y8dg8^DYKGXQ_NNNIxb$Z!|F3*%&L$xZw1E1)nIzD8!ao}h%80cWJr
z1+ADa0zkb!jO&clGU*}!;LXFHC?6yyA?5K=Nhs(L{12t@c56Wq&<Krm;N0(82e?sT
zA!|XA0QXuzQ@n!n3Lyp1|3>w&m(EXx`cE6AzD5>eS%VgktiZ;|)8HzVSN;O}zb8%~
zn9dMlnuLOqUe5%VD_90t5$7)8VUnj{)~lez5&Kcg%K8oS(}{UwhVFQn+?k0cv}_!I
z-q~AVeeT<tZ@ZhaM&eaNuY1OZzW+4f);Jmz*oD4kM)Z4LW>1r%d{m)djP!MwtaxfD
zF3i4Ml7*CWSuzFArfIX27+grIc74QK0E_t(3U_jRTJmoydAvPyc5E_xHk{sfo>X%J
zD6A>`@%U_oa*9g#mJ~gHbqyEy+`oOVXdFM+sb>~jI{Xz%qUS?u*;Q4kkB4&^^WO-s
zYGx_;Z$2p!6M<}uQkHC%J!x>ZSa(2k&W2n1QU7Y{P3itnFl%N<#;kX-)IMF4(50uq
z+1_zw>LTZ`S#cG*YVu3E^yl?!T3W4=m`E|I)j9a(Ty?NA1M?nyK)uHX)fwVAv>)zp
zEx8KVWk+oKY~rjx-WgOF--Yhq95bl-Qo-9fW?{R6_Ofg#7p8E56rGaKy3}G)l=qO^
zBl;1`Y=<ZJEZZ3Ugt>b|RaUso#S;lpd1F!ra^;WBVl%w@&iRkf$piLrt}j32?4O^>
z@hT4>CcirOf`&=vB}FEsCp9>2SoKQuDR)>Fp%`|aaXz?JKIMv6_6|Fq@h+8Z4LLm}
zM4gK<`}fPe7tJv`Y?qk99{W&~%yIK#J8DN2v~Qzd<V!5kKk+nppwg_lq!_K~kuPzz
zHnHykKReiRiRJy%v4f8jKFS>$D`)X{<`X%)8+B%bhBzd{&2lG%LzvdqPUVCZ1KN*=
zwYS~Wr}|J)=-7$L`vU{uH?q1b!QG+JY^MCIWp`daDKI$omF=HnUd6RsUtZ#Fu2eG$
z-Qc65R70E!D(yJ373C-Xx=ikyW15&mPVlAymdsXG=#v4|g}-LMd}Fw}pqj`NWl!~t
zN3~lXNU&ZgF^~JnnESestQz{ZcVCW=)5hXH+S5}MYNu7+&Y@ZvF1$WohZAi*s-336
ztk6#4Sk@%;B<l{`^$YwcW5vqP&KcV<#}th(t)k55SGn&W@~f0{qY7A?-WzE>Rqmu=
z3gPR~lDI;~a0=?)PzUw+I1|q@h>m&mRz;PmFnq*uO52^&rrS@*N1qEiI36}L*P^bn
ze2x~&8DkAv;i_I=&B${&AcwM^ga`(9ySj6Sb2htpxRhc4$o?#TI`&&D_i$5o$yt?%
z93$G60(xI%yeVhXUc%S43+4RQ^YimPdd5~d+l-cM>tc-1XDiysEn7P5_M^7EJk@I~
z-$u2bEJbWVy&*4V?QHU&jeR>=UhM-!*H7-M<!nf!3t5R@GyWjA%l@rDo(A&*c(adU
zR7NHr>5n!PV>}xj33^IiCKEMD^IIwK0P7bxH#!8K7)^#zHMJhr{>wT??75R3<=I>^
zhV%?C>eAy@MZ>t{>^Yf=l7#OV{`QIY&FI}~$?{Z=is{=a-2z=IO5VZJBl*5&$D+x=
zo+mkf^>lB$ng1xkVgd!TOY(d+CQo7C9to<^h`Fb>toW2LIJt-Ijsu5g)acT-g*fHg
zg7s}oy`4N7pdM4svlNpu>CPGmZgkg}i*-NM{&uqr_x=7#I}sNb5QkN}u*T}Bm3~em
zacK~B=zGUAtzO(JdoJJfoxTGGm6Qc>gQ?lY*4UmqJKZumOnW|kul3=r(nDPs#$PI%
zE1V>M<;<h!NLWL?VWo0;CH}YZzEGHv^41^Kig)GpKPs-~91G!(){)%zHUfY|=Y_c)
z>2gVXZ0j+VPuV2rq7Gomiqhwk>-WJ}cbh}kLuL^1&6KAGcXaB~lzv~w-iC~s9AbaB
z%1!mco9W&76)=;=_3&6Vt8Jse%U-*ac>=LSXZyogcqo70dkd`24A!?b_10s(t@=CN
z?8hHy-o9+6E-U-w%ZhH5T|r$a`IM#r20SoEO>Q=L%{YT~iPLkDapj(e%6f%+r*_is
zzh>10beG_f+hy|39IH#h#dy9t)nY*$*NkEY?T~-!nBl^pVYKn_{RaKgs^3SIrgr9H
z`$VI>`?Igk642^ZRZbo(=i?fcCFBmRxtML+9-HSSy7|>b#650*q#d0qRh#j;9-S2k
z4QzQsoW(i$Hk+9?A}(x!obnvdi?3@%Oz*endz=^Wpv!<$&k9@#3g^q8L@A8w$V-oW
zn^u=%5#ehY)}{!O0n{>j3dZ~|`H1Xtz0eA+_=SY<xbPCbrR5>JEJQwDX)WMGZ5H2+
zvCe%9p9)_i0)Ou40Dx)qAh4JjUjR@17x^F}B=Bk&4y=wQpg-lF!2&U%2gO$)Y#?H6
zTYeW25;DdSXahW~0J;dYWDqrwr62$n{G3XHfE?KH^>(o60ilVA*|3tzVi7<UfLB}u
z>M+9Qk1W~`ig=KW#<BwlO3{CB`2NT;w%Ylo=)b_qX89iBo{2E<E-MyMrsci{#t+zO
z=T_GmhAVX51%M|sIH!{Z+qN0Lw<Oj<%cAqpSvFWeV!$xh5wis>snBUaBl$27#{qal
z&PfvO)z6Qu0Ix}n|AH+D-J1pI=D=zo83AGej|jL7n{kLQ0p#rofE$ZxC-MP=34Z(`
zKt{+(Rx^KM9iiX21mMIfAoBro!LJ1(S{4+4SWqt9`4?{cH$V~S4hZLeb>|84{Q@;%
zX>s&VBo_!UC2qlev7<tf3zC0X7Fmdi5!PA(Z(qoud59sX$G@=2Pwm?z3a00Ppp9t9
za4TW+R76yVMOS7co4}NfaFOZ2MG~xdTY-x_ZH5jm77J5YxGe)N*_}2;y)C~Nx5C<b
zu=$TGO+Ka|%k^kYE>pw%pVjZdN$M367B-eF?6hC=rf>pHU}e*JgTB>^J+JGZc_@5c
zJXpT3gnQXh#w=bbmmqe-%gX)JJfs|mTXs5MocbO&4-dm_f=BhPfBx^cISR}|+_s({
zLPCT5YWr$7?!A5!A{W?0HTdBn8y3zypul|$$+qV{4&Lwm=X*5eI~Ug}%DTq)DB~|>
zrP18sbg#M6?7a<~g+GK8!CA=e-NxO43ssmF0xwAxg|B7AqVvrv`S3P3VJcW*+$>)M
zl#G^-l<`#l3S8~qyD5yP=`W9&yZ-yCIcQj*6uC^)ul@3lLO2j2DP707umI;1QNF1y
zEFb#?_22hI#$+&Rd?7~<rwO@p5$8a*B8^Sqi&r9T0_(Z{Zj{RRG5>h~_vvtLRdW<E
z_O>=CFqD|~(zp+g*s9P7Vt+Tvf8PJ6QQT?ES}N?v(}E$n{_EHM=L5RO97=&L%uAvq
z!fe*Run7V=Zz7$$10Ra|yY-CW@u_Z|l{_KTr0duZp*!Y$dIIwEME>3{o_IGq2-@mj
zo56~p|9WrnYqy0QtzWIO84;$~J$&&Nq#1rU`oG_%@<=Mk4Hx@+FIhC~)Q@b1|3};X
z_dUnm{xj6~@5DxWxr}h`+7SeBxb+a&7WRvA1H!P9tQC%XEe`3IaF}1`PUjKfiwSs0
zvcj)B&|2(LjLqtyvMo^m*e&KiZ<!=6K87pAuld=R%LIK{;s3g8NLT**F8=4PE&c-j
z8aO#j$Nxv)MOxqEAFY4#SA+bHfEhmRQ2wMCcL(Kv-7@O`x@CX2{X7R5K<1YJYPNs2
z{r@z_^Zz#Da5W+yPOAJo88o6Gx_(|EoDBD~fBdg2>_Ae@oGf3Q@t<4v@An+nf8Vm<
zWWm{t{(ZLpzGXF1{&mNiIXhC_zT?>z_<!Fp{9?-Aw>^fL{;wOB-wGqQ)n|wp{z_b}
zD3V1e>|V$Q|9VR|`**asyl%iOn^XP&G@;9XQphVJzymU5+Az&=C;oNRoVqV~p?9FV
zOu6eIrHK7bDa6!&UE-S^!^W?zKEsn$()dVJ3oa5#b?$WMB3$S*O?_d7wo(0Qdo{9?
z!_+Yw_x7*Ysp+irq;^gniOLt=S2bO4RBr=@dzqT?zGBDjXi0``L!wW9GcSA*wsL#$
zxJ8qhE4@{T78Pe@l+=`WN$)Sf5d!eiu*S?GZA8LLfL;LJm|s!%f)B)nt<aj6Y!HAV
z1Y=Be{FPMA^G{%{M2%&DQefm=mWZ5=XdZWIVW9<D@x3LotD4A{L}VO=Vg8D^$QJ;m
zGN4UILqY$g7>EWUvdOAm#N6NHhOAo!A}}(1kBDD+qHNh_{JJR_(GcNv>u*>9WW^P=
zL|4$SK`&kZ5ird!I3PG6M#ePnFJw{zGSVCT{R;RXVuC}K&UQNU2#op21;OM51ZCL^
zq}2)m;8-3Hmpp<@XCT%hQy7qA98tCct|Fa&9I(JSf*@l8!z2sVyf43x1B=;#j}IYh
z@ZgUFDg!yb1+2*hI;-I5h&xZ>6NY1sD4L*-%6%gKMp6O*0RZW-Q22s`pK>p(lLuA;
z+78gt7wI5e1{}i_v|I2N2wVlfsGMJO6%Z7%;JXfD7-Yc|<Bfm^(vTInR)ay~r#LI{
z_M>5G!zFOmRD@mvItXSUXn>ypW*q!9O9<u_7>67c1qBoc5W(!<pNoOPj(@`9Tmb^1
zbOA6*2>1{zW0tT0tP8-O+<NzGUd504d6@}On*BKcG$2;jcEbGOi9v2=PMLkqLC#C|
zI`<$4&T&&cQWSrE$?iOGUNe$lFy8fahOmp@+$hG)htRO%DmCL=mjqGQarfJER^SF+
zx_u^>V^P$8``r(5@;H^x@*Ps_ll-FB{H8`!KY_1J=`!YJy~I&HxIVZKF>f@}=eUFV
z6>j$`{$E|!9uIZe_J>`&t=6O7B^xhOyZaQ{D3$g}X7u(@k(@&7&{Q5dr){MbW6%>V
z*~!MLEK`UyjS)qqj8>;5iBb*~ZA&Uj4%1+a_j~_-<IuD3`$v7oZ+`c6U-xxi=j*!f
zc{(Z{e|&g^<2c61lE~0+y5F>^mg$4MCp(idUs`bjWkcRucu(r=^Mjg0uVC`TGAF5N
zX#Y^X)U;n=&tSF;C&&jW+zhASX~eq5s~ck!W=NM<{SD8R$gGi;PJ#?2Q!U-}F)t{P
z*^fJ`^*OycBc79}EbrcaxO;Qk^Zx8g3;MYr8yGTMS`y>~qdL%q+bBfmmH^#9?^+~L
zOX5%~?cuIg?1j@Lgr+@<3#$A4N0>uUW-%AuO!<lz^m2UWJnq4I;OfPjx@d=<kSSn}
zv2OU!cr)dZprwURW5T)-V4d?pij~)JtCK9WxBqFjb$*n?TUPBZ`zIlSrhJyoqMDJ`
zJz?Cgu15wdcGvEde8&3k)-D6Rvv1$U?tatLrWt4u`i4~<5+yeNXTs~-oi>l>ZhdF7
zxNDWz_I|}&`4_TM=XZZ(CP+7w*JYfFD03OgR8{=Z{AF_ZP2KtW-)9|veo*#fZ`{J^
zS9!guGR<q8-jp9UjWI;LVm<bPcLlm{m&Ut2Hrlc8;NBTQKmXUyK}TQ7^v!JV+&mVj
znDO8oKOvea+qY2B6}3t#F)=mzsI7RzoX{hS=YRD)jmh`u=S-4J``vs#YmO{0v{_Qw
zccrdQh>&&kcsIXu#B%uGioY%H;YU4Sl?&OG><?tS9$s~d&{YVfb)}nMKQ6y@<a5dH
zMZYXQ(BV7u-OF9yB_+FuxRw2@dU_6PiQ?fThfHBQxX{<#bdf_!FlT=D)wvP#GM~=T
z3Wvpl9)sXlp_(<R|7`k^pRysczc!p_z%mUKXef+cX3g%^;%td)y*1+WsCYD=d(L^y
zwfc+v8k4p#dGqu0>cSnr2b%gdmb6z1$?mgz;c2VWI~|>*&>mRcquKsg)Ap@e{(;NO
zL!=8dLT~rAKk19$ZC{%cnq~9#u4`FVH@>?i&Vn3mTDQ*Yj#EjIKF4W7g5DDw&RK9x
zVE0<VR56)Yteun%NxBzJiLljc)2X~SMc|yd2c*pB{duDY@9HoonLJ}svJZD}=bt_H
z^@0Riz9f?(+oKfOC2N{$Ke+IJqp_yxilpv2{lC@6{|^$h)HiUGn9s);Vyo$sc<?9L
z<9%UEQoA`t!g8jnnI$yBI{KqxoC)UCLpk+u?IuO`n8Vpfp5P9F5FE(qZ>6+DuA=FF
zWG%HIXKqrfToFe9zsZFA$%whHLS42y<L78-l9S)NU+7-;hor>Tr(KZn@n|&fg;(S2
z3^nfN>9R!woRmMdv41pm+Xz1b*$HWGQ&8@;0%E3xkpbq8YLnLfu9{{1p?r}i@rfLf
zwm|KovpT@RgHb^Ior^^zkDwljbFpqxU3CnM&nR-OCB6b<V>4<pg~7Q^{;FA3t8C8~
zITaDW$#Iwu$zp~JaTUsn?mEX9buSHG7PKV??m{{8AY~L#6W7*tMXpyU^RAwurl&?+
z3q;ffB%$F6bMLR3r;PuT<B$SDas%!HZ1y2^mi3@d3`X`nTORvps(B{1d?FDrmssx1
z()=c)@VjOeI769?@EL~PrlkaT=+Bx-+TL%FZuar-=z0ygMOTcxg%9PKAlfDch!0R0
zAx-kQn&VIix|PUTLz7kG)>)-kpRUz}w*{)0>7yMAE)K5LnA>7lSpWzz7ZHh@qumL4
zh?%HAq0-}zP9?fRg&n}Hq&B1^f=epVtwpzZ-ZD=_`GV@PC-t0GT!?A18s`n^Tnuge
z(PVy=s&r*j)?ZorKn+FhRycaNuHrI}4?Vf3S^~F7lHoDH?J)EZ;2#4XiUnzy`gK;U
zHn}B(Zp4~B#VvCDa_rvlju)C)Z3%s+%hduN9q(_2g~uDwWg02HW{+ggr9UU!ek-ZU
z`i9v83nW?eFmp6BsEhxTV#dYBXZ4rA-SPbxW7?aRB}^u}MSd#b_9mat>sAYPobMlS
z{_56O2VT3hos4?m^O0~}h2+o3Z~igg{)@8aoSg3Z#z(q~g8u!&aP%mfSXzF`e1IQp
z#Ihb|#~5*s`j413{$^=}R=)h^`_9}<<4z=<RMvF=uHcP^ap^(g5Y*#Nsq&kD;g>Aj
zOlRjzOHSpEtZ3{x_c#w=GP!_rteo_|9#>~?_h8*VA4$1*QwH$^87HN_!b@TOFZQIg
zHJARLedk_Gbnl$rT`P2VkVyyAllWIT$sQRpiR)XoeC}{#C#znwsc=x^iN~3B{o-Ht
zee(HA)3;mt%py2Cvh+&UXR=6c@54%6zVu}f%e~b!>Zs^@X~cs+OdoF$jdpU<64w9v
zr}|JEdi<_Cm8RdVzu(6?;O$pwFi-a737MTcR6z0WP>s?2f3bbDc<i3^=zyVA<9XK{
zBNqPpEY7&<6<d>K^urSC`pZ7Zk^Hv&j6W~nTAOcHe-Aq#Jz{9vw3H$L#1)yXC09SH
z2)$u+M4I32zEhgeU@-r!`@S%~dVu6p`6rR1;^2xsEpIMg43T%=Dx0b3^!<DI&ozCL
zZ+?HNwl}>;<tg*um)>2k-Nu_CD^biGwJ|LjJ<Tridi>^b&<uX34el9YrWZ#1>3;2(
zd&|z%m=)SSmz=u3TQK9YU*ucO8@dSxmrauklUG+ix~Rc7{_4Q4)BCbDpE4ihG>uf(
zUEKW8enY~u`N`+r=>KrQJV_@dw;4`Y@s8~`kN$VGpUElQ7wPas{*8Ffh#B0UF^0DX
znifkBI=k68@7d$)P_mG@-J=YpP{%}`pRGg58uy(@Vybht{{%h??H_KerF9QyyF)*&
zQqAeE0oUx_iQEk%U+RlL-ANaynghivuDH9~UscfDz%M!JMe>$bT8ca8z&e4QR3M^e
zT4G9gvw?dwP)Z$92D=a#JB=3O-HJP@;Lg{Ur$yHkZZmC$aD~zOXJX40F1GEFobJc7
zIdM<)omX(h=>O>y?`#T6k%c~;-|G-J@a9vy`Ntk?4)@gizSFiZ>`~j3!NRuC^V}V}
ze_Q%Y=hE8VSL^;!TApUx5Ud?aQpldO)67Z47K-FCBcCW*Ar+P}XyxyzHjk*-sn3gH
z6Fi}Q87@tRQ1T=oQ*j}n+|6}&T(#0x-%G>RgAip=3i%2#7>tcg0qT1juh6F8y`gAT
zeNu%^TVrB(0v{mhi&U+yxh`!XyyK~EVW@gHL@G)X5)g|i^^701*vCP=>r(k}GGQJD
zD{*p%{SYF~v91)s(zs@xE7#CbErl-6j8FGP0@zL&E1rnu_yU6)1l92rGU81%qE@;!
z1(-LA=+7i$Oq4%;<_XIG-d~h|l8UD<$VH{&(_*F?7qq`CyG*ljtcx}fq$M6^k2LJ!
z!e}biE23h!&k-?&P^>mBoNBd4w=Htf<$+vsfB5I<Up>u@PmVu=wgZgcL|H+rRp8rA
z#9UEvs0FFlGeo7y@n;a$HCw%Qquweha_%|)wHsa|M1aY~0>ejKvD$JqhWm6o*sJ{D
z<LXa|sYJX>SKm_?I-t?@8R>F3IUPac$>}n5M+aQx;^e^z^h6U(g`hnN6UXikU+Q2-
z5yd|eWb>34^=L287#4#l{vmmpuYKI*$ZG;d#b-ZM^oTE8pWqhmx#8L4zW6yq<u}`$
z>_q7mY_@S~&a!|7KWYD6e_MCdV_fDd=+#v050z)(l+d$*Hkq$x3~yio(xg2|H!{V!
zrC{1K(I?jo={!niop%`$JgLi&JWXXG0d*Gwa=1()k3OuJy{4Txs@^ta83~>6>V<y%
zAraF#N1pV0^>Cv@CoiIZkK8Pw(qR~$Z(sO3T({rAt1^@$+&sZSiYAmN8|8jU#31M8
zMqUc{7RRGNUiXF-ir<KGmVMHS--;TtAdp|MpQcu*@+Ky(I0Ux8H=M@&le0_n%zcI5
zJHc}NGMG^mj$=(go-a2OOr82+gC3DP7PY2*ua>cojy{Kv*IUg~;dQwqulA}<!A4%~
z)BIjN#eSYVlTc=GAiip?%L9IalfwGl+|lj%{p`y_62)x0cGFSZOgo95LUjsZfFB$=
zr$J-(t%^UH-;zc7)wYqDB-Bi;m}w0`FO;SXG#?-6Y0P!-VC55%Peo4v^blhGP6iS5
z3VN9odY5VRi15<r%^9wxXwH+H<yZ2CXR-Uj3E&21vwQnDV~nFdgyd|Hd~Qc)Mv>Ft
zib?EPC|kz6$!4}zF^4Q7Xo{yrf5^LwkoItyKptJeCpNpDUJ;un`8T|(1yRU}ofroU
zic2c_6B9qIS9s5>o~6$3Grc&SruQ9YFRlPmRW7Jb!CuSr<;OAyz9x(Zcb_TFDb;l_
z5!{Da`C{Y{cN<0Tn~K>!?GB^U$8nSV2N2Gh?!44mn(<Z*9uwSF^gsV><m;$uz|Bv&
z=;cZnY<hjKy704EhkcnYG_%r#<IBx%R*Hvb@sxz)RV|GAWC{$fUPtHQ8YQo?N{CQI
zJ;RQa^e#~B7sxZojtr1N;Eaihxq8JJ9i8v*kU(zMHf17bj3M{Tj*l7S&hEHpyZ1f*
zVeQ5adCGKf%W$1y!xP@ym!SlRWO$Z@#`a<TW^V)U_ldxf`ATAW0}FXHadQ;2zi;P^
zPUno%ATBF4Lxbr=XfRGUp3Ju{Rxr6C)EK|f=@WG0nH<V998T7p6up(aDwC*B^`n;2
zys{T+VNW}TD5nv2aZ#N7k7)!l-!@F6#LNIcCmO$5rZ=&;;bA>gFu68_bv}L&$Xhbf
z++Qa*dso>uxjW3}$o5b&%RdOi3cI|C&P4MKQ6$RE0sDV?rFXevzgYgOa&t_hK7I34
z`Df#RdG(H#_Y^`MySGO20lVv4B5-vI%gqT-9pba5_pb7J%3a>=c~;P7H{ZUkzrJ<k
zX1{oK>$>98pL=|_=b&?RTw26=zj>}o+ZHUkUAU3x09O&riv{wj@CJg29s63xI9Q8>
zcO*YgHPB^fcu-*<-f9RIMw0aHs$F^Ll#3Vj<TjDUI(Psuzlft^)69u45vehkM1~Do
zgTlzax)M};>5JbSQz!N9Er3X@h_-U1o(6-Ix7z~CP(4Q^NT!2JP#k02J(15<vnT!p
zqCcD^f*LCpg#ZuLLU<F(LNC3vE3lU_#+1GEKoseyM%h=T)k3ct3H*>k)>84L@~;n2
z(<SGaumB4x%mrIa7&+zZ6fgz~#yCRVL&dMeLm;P~H;o5_G4%Oq9PARK5Am5BtU2*<
zV6;8@y82#Pp;Zyb<AQ2(YEZ?-0g{rU_v+Of+KG8aIXgKntx|+8wk<+W4Lvw9g;zI>
zm%J}%my(7$zbz+Q*AfbatDjc_DcAUxj*rE~n1sAQPFp#5Yx{+mR9R`4HgqrZql1=;
zYHU931HetNBd!w2JrV#XA(bw9E8PL4^f`cozC={u@jW$)exu-j8e_<b<%$+ZNwPyJ
z&Nd(30@`5n&QjTXFU_&Wk&oaIP_BVmK%IfF59-aD=^WA3kyCPMWbsdwtN6^om~C?A
z=R9m+VMJK`N=J)SDa}U)n@QRL4PdD^1MMsB|JE_N^Ik{+5TA4&GTZcHx~W13I}V5P
z37o{(NBQ6!DzSl@0bHBlWjj%h$kj2zwiCW<UT=c@1L_C0NLV=QS5w@25xA%R)?u02
zW>VO_^l{uFuW=9gRI`=WNupw}d-wI*gXOZSL(`9yQ*{j!=e`%_u5BiVw;cCnnl8=q
zrh>?Osz0uGvE42n3d>NNV;B(@@q@6HTTtQ6a5OsRU~+EdCHquPk=Dvf0S>kj0{A$}
zI3|32aoI(Eds3`b{>kMvB27F=iWPL=K%Hyf(cHcl!?CNk=4=%zyqD$$Y;Jd?<oFF<
z%B;+xgzMxI`@SyKEKs0uD6AnXHHK7TDjGw#=Js`Mfk$rMSbT(PIx$yAbukpMpaLlJ
z1m}wo5fs2#rJ80ZT=|S5Qc%h3q1stMsB%)z0sW7gD0@+`Y?BG)f~OQt#IIA?RY>iz
zi0Zt3ud<`83E>rJ6IvAk2(=#~BH$kwL%$fKP-q_?>m{TUK8PmnngJq|4^dO6R14wT
ziz@EJfh|X+hy)PC13vGEMM1t$s6~`v1J;M0C~FaQFD;)4P-=;IQ(3Fl9(U^N7$Ztf
z!AD?WC@=&NwUiu!jp&a_u?{4_Ac-g))%^4|>26ZA!@9r!5iy1+F1@C9L97eerf6@I
zD(gx_R@4>{w8{;sWsy{xHv$xhtR2x#kUOCTT3i@V5fFO|qTWi?y{WAL)}>Xb?M$|;
z0L9{2q(6o@_9Rn932!p-@E62-ZbboyE?ymh>Vg9B@x>3D(K@Q3=Y)!9h{bpmp*P+^
zlX}9^@B%rUd<JAPwh|J7hJvi{wunWc2GJ6sq-{HI?7_$m|1ri7fu<&6J4Mm`g`6`k
zd%x^|v7>tbl64)8rx&bRwoRPAesO1^L2C7fDeh2p!i|m^S_h*VB6bHRs%S@D+R8sx
zzTVRRLShzt0*~y>%3Pn^zL(9f)>&5y!RM~kTVL5Pg2vCnmr1cMq{!%Icp4;tuPfRZ
zc34$|FvzBCEDl1wWgyQP=MmM-Hx9VWM8;`em0Li9XzrtZHP`1|b*aa)i4`fa4@^mu
zU$T$O&puK}RCrP2vDFQSs-Jk1mp1%HihLO9Utk0T?c>fEoJ;LqfczjP*q-QaDC|Il
zyJavpe=A87W?-F0UcMa2yYOSt-)Cu8U#He?c%iz&dr@9styb_fVMjfAOJ#k2U}(DA
zsr;SBLt*<DyS+#d%`t{504YLZ-D`4<63^{*F;Y>INsR)z(Ehmkjg=I+7-V8H2g8-v
zk498j2|-=;8SX~*<Zm_12qNZM8mbnoCu&p6(X6zJYy@m`)TNb|&ReVO5))o65ZOLk
zEAIH?u&;yl;=VMgb3}x2spA6WOLi&N94HZylid;Z3edz&)5A7bjq;7Y1))nJS|!$C
zH<VawwKA|5HXzo?+iD>&vuEnpEK-_CC+kW&2;P?HuH>vl!@qnmQUSHWQrBT!{_^1?
z#Pcq=cP&^eSld!dWty#bJbpd%3o^3@?o}f!zRp3PYAU0aOOPyAbFgNtLa1AC3f*h4
za|;b$tyWz~WJ+tJ7vX?#^{hmb4_V%(>4`^n=hyE<fw(8lQY$6_<SaOCYl4LU@TTmT
jIZZ}UmyRVel86ww{FI8GwQ6$=#)F)#1^&l1$D02a)irwt

diff --git a/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/image--007.jpg b/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/image--007.jpg
deleted file mode 100644
index ab29cd98189afa489760759f093e5c99cb83c484..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 177667
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%0DDwfnu?0_%@9L*>mInA0aD&#5kGtGi`<bru
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
Kx30ne8TlUxvH70>

diff --git a/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/index.md b/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/index.md
index 20fffd1077d..1049c9d1fe6 100644
--- a/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/index.md
+++ b/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/index.md
@@ -1,99 +1,126 @@
-# Mirage Quick Start Guide 
-
-> [!WARNING] 
-> This guide was written for mirror so some information might be out-of-date for mirage
-
-This guide currently shows you:
-- [Basic scene setup](#part-1)
-- [Player movement](#part-4)
-- [Names and colours](#part-8)
-- [Scene script with canvas buttons](#part-11)
-- [Weapon switching](#part-12)
+# Mirage Quick Start Guide V0.1
+
+This guide covers the following topics:
+- [Installation](#installation)
+- [Network Manager GameObject](#creating-a-network-manager)
+- [Player Movement](#player-movement)
+- [Initiate Server By Scripting](#initiate-server-by-scripting)
+- [Network Manager Hud](#understanding-network-hud)
+- [Server And Host Or Host Only](#server-and-host-or-host-only)
+- [Names And Colours](#names-and-colours)
+- [Scene Script With Canvas Buttons](#scene-script-with-canvas-buttons)
+- [Weapon Switching](#weapon-switching)
 
 It is best to first make a mini practice game before converting your single player game, or creating your ideal brand new multiplayer.
 
 The Pre-made Mirage examples are great for using as reference, it is recommend to use them regarding connection setup, with ports and firewalls. This can be a huge topic that changes from person to person, and is not covered in this guide, here we will use localHost (multiple games on same PC).
+To achieve this, let's first create a new blank project on Unity Hub, after the editor opened up, we can move forward.
 
+# Installation
 
-## Part 1
+Before everything, to install Mirage we need to add a new package manager into our project. To do this, we can go into `Edit menu` then `Project Settings`.
+This will open a new Editor Window with multiple tabs. The one we are looking for is `Package Manager`, so click there.
+Once you click there, you should add a new Package Manager, so complete the fields as we show next and click apply
 
-Blank Project, import UniTask and Mirage using Unity package manager.
+```
+Name: OpenUPM
+Url: https://package.openupm.com
+Scopes:
+- com.cysharp.unitask
+- com.openupm
+- com.miragenet
+```
 
+![](/doc/images/Scoped%20Registry.png)
 
-## Part 2
+Once everything is ready, the next step is to close the Project Settings window, and jump into the `Package Manager`. So for this we click on `Window menu` then `Package Manager`. 
+At this window, we will click on a small button that says (probably, at today date on Unity Editor 2021.13f) `Packages: In Project`, here we have to select `My registries`.
+Once, you've done that, we should be able to see Mirage and a few transport and also plugins in that list.
+After select, you can choose the version on the list below the name, otherwise you can just click install on the bottom right part of the window and after a loading bar, that's it. You already have Mirage API on your code, congrats!
 
-- Create new scene, save it, and add it to build settings
-- Create a new GameObject, name it NetworkManager in the scene, and add these 3 components
-    - NetworkManager
-    - KcpTransport
-    - NetworkManagerHUD
-- On the NetworkManager component, drag your Offline and Online scene into the slots, we have only one scene
-for now, so put your scene in both
-    - The scene must be in the build settings before dragging it to the field
+![Install Mirage](/doc/images/Install%20Mirage.png)
 
-![](./image--000.jpg)
+NOTE: Mirage already includes a UDP transport, so for this guide is not necessary download anything else than Mirage.
 
-![](./image--001.jpg)
+## Creating A Network Manager
 
+Here we will be following a couple of steps, so it is easier to follow me.
 
+- Right click on your Scenes folder, then click on Create new scene, save it as `Main Scene`, and add it to build settings
+- Mirage already have a menu for creating a base network manager, so right click on your Scene hierarchy then go to `Create => Network => NetworkManager`
+- Now you will see a pre configured GameObject called `NetworkManager`
 
-## Part 3
+![Network Manager](./network-manager.jpg)
 
-Setup the scene
+Important stuff about this objects
+```
+    CharacterSpawner is the one will be in charge of spawning your player later, so this is very important object
+    Since we are not changing scenes between server open or close, we could disable the NetworkSceneManager, but we can leave it as it is.
+    UdpSocketFactory is the one that does the connection, so you can change the IP and port if necessary there.
+```
+
+Now let's setup a few things on the scene, to make it look more like a game
 - Add a simple Plane floor with: 
     - positions (0, -1, 0)
     - scale (2, 2, 2)
-- (optional) add a material to this, I added one called dirt that is used one of mirrors examples
-- Next we add a GameObject, name does not matter
-- Add `NetworkStartPosition` component to this GameObject
-- Duplicate the GameObject a few times, and scatter around your scene floor so that you have multiple spawn points. I did 4, one near each corner
-
-![](./image--002.jpg)
+- Next we add a GameObject, name with name `StartPosition1` 
+    - set position (1, 1, 1)
+- We go back to our `NetworkManager GO`, over `Character Spawner` component we will change the `Player Spawn Method` from Random to Round Robin.
+    - As a second step, we will add into the `Start Positions` list the one we created on the previous step.
+- (Optional) you can create more positions if you want, and you can add them into the list, is not necessary but maybe looks nice.
 
+## Player Movement
 
-## Part 4
+So after we configure the basics, we need to create our player prefab in order to be able to spawn ourself in the network.
+As before, we will follow a couple of easy steps.
 
-Creating the player
-- Create a capsule using the menus as shown in the image
-- Attached a NetworkTransform component, this will auto add a Network Identity
+- Create a capsule in the scene hierarchy and name it Player
+- Attached a `NetworkIdentity` and `NetworkTransform` component into the capsule.
 - Tick Client Authority on the NetworkTransform
 
-![](./image--003.jpg)
+This is how our Player GO components should look right now
 
-- Rename that object Player
-- Add an empty PlayerScript
-- Drag into Project to create a prefab
-- Then delete Player from scene
-
-![](./image--004.jpg)
+![Player Components](./player-components.jpg)
 
-- Drag your player prefab into Network manager,
-- Set spawn method to Round Robin.
+NOTE: Is not needed to set anything else here, `Server Object Manager` and `Client Object Manager` will be set dynamically by Mirage later.
 
-![](./image--005.jpg)
+Next steps:
+- Add a new Script, call it `PlayerScript`
+- Then drag this GO with the mouse into the assets folder (You should probably create a Prefabs folder later as a good practice) and release the mouse there. That will create a Prefab for us. (You can notice this was successful because your GO icon in the scene hierarchy will be blue now)
+- Then delete Player from scene
 
+At this stage, our player is done, so right now we need to tell Mirage who is our player in order to spawn it.
+So this is very easy, just go to your `NetworkManager` GO and open (if it is not) Character Spawner, then drag the player prefab we created before in the `Player Prefab` field.
 
+![](./spawn-player.jpg)
 
-## Part 5
+The last step we will need to do, is simple go to our script we created before (you can go into the assets folder and it will be there) and double click it and it will open your IDE. So what we will need to do is simple tell how we are moving the user, and also to set the camera as child of the player.
 
-Add the following to your PlayerScript.
+We can do that simply like this:
 ```cs
 using Mirage;
 using UnityEngine;
 
-namespace QuickStart
+namespace GettingStarted
 {
     public class PlayerScript : NetworkBehaviour
     {
-        public override void OnStartLocalPlayer()
+        private void Awake() {
+            // This one is for clients only
+            NetIdentity.OnStartLocalPlayer.AddListener(OnStartLocalPlayer);
+            // This one is for server and clients only (hosts)
+            NetIdentity.OnStartServer.AddListener(OnStartLocalPlayer);
+        }
+
+        private void OnStartLocalPlayer()
         {
             Camera.main.transform.SetParent(transform);
             Camera.main.transform.localPosition = new Vector3(0, 0, 0);
         }
 
-        void Update()
+        private void Update()
         {
-            if (!isLocalPlayer) { return; }
+            if (!NetIdentity.IsLocalPlayer) { return; }
 
             float moveX = Input.GetAxis("Horizontal") * Time.deltaTime * 110.0f;
             float moveZ = Input.GetAxis("Vertical") * Time.deltaTime * 4f;
@@ -105,24 +132,64 @@ namespace QuickStart
 }
 ```
 
+Press play in Unity editor and... what happen? Why is our player don't spawning? 
+Well, the question is very simple. You need to start the server somehow, and that's what comming next, but before...
+
+### Types of servers
+
+On Mirage has two types of server:
+- You can create a server only game, which runs as an Authoritative kind, and takes decision for every player and you must join always as a client ([For more info you can click here](https://www.gabrielgambetta.com/client-server-game-architecture.html)).
+- You can create a host server. Which will work as client + server and will take decisions for every other clients in the network
 
-## Part 6
+Which one is the best? That depends on your game, we can't know certainly in this guide.
 
-Press play in Unity editor, and then Host (server + client) button in the game window. You should be able to move around with a first person view capsule.
+### Why are you telling me this now?
 
-![](./image--006.jpg)
+Because in this guide we will be working on Server + Client type, so we want you to know that there are other ways to connect into the Server besides this guide.
 
+### Continuing with the guide
 
+Now, we need to connect into our server, so for this we have two roads, write down a script and make the server start or just using the HUD
+
+## Initiate Server By Scripting
+
+This one is pretty simple, we just need to go to our `NetworkManager` GO then
+
+- Create a new script, we can call it `StartServer`
+- Then server starts should look like this:
+
+```cs
+using Mirage;
+using UnityEngine;
+
+namespace GettingStarted
+{
+    public class StartServer : MonoBehaviour
+    {
+        [SerializeField] private NetworkManager networkManager;
+
+        private void Start() 
+        {
+            if (!networkManager) { return; }
+            
+            networkManager.Server.StartServer(networkManager.Client);
+        }
+    }
+}
+```
 
-## Part 7
+After we save the file, we go back into our `NetworkManager` GO, and assign the NetworkManager field into the script.
 
-Build and run your scene, open it, host on one, and press the Client button on the other. Congrats you made a mini multiplayer game!
+![](./start-server-script.jpg)
 
-![](./image--007.jpg)
+## Understanding Network Hud
 
+TODO
 
+> [!WARNING] 
+> From here: This guide was written for mirror so some information might be out-of-date for mirage
 
-## Part 8
+## Names And Colours
 
 Player name above heads
 - Inside your player Prefab, create an empty GameObject
@@ -134,10 +201,6 @@ Player name above heads
 
 ![](./image--008.jpg)
 
-
-
-## Part 9
-
 Update your PlayerScript.cs with this:
 ```cs
 using Mirage;
@@ -158,20 +221,19 @@ namespace QuickStart
         [SyncVar(hook = nameof(OnColorChanged))]
         public Color playerColor = Color.white;
 
-        void OnNameChanged(string _Old, string _New)
+        [Command]
+        public void CmdSetupPlayer(string _name, Color _col)
         {
-            playerNameText.text = playerName;
+            // player info sent to server, then server updates sync vars which handles it on all clients
+            playerName = _name;
+            playerColor = _col;
         }
 
-        void OnColorChanged(Color _Old, Color _New)
-        {
-            playerNameText.color = _New;
-            playerMaterialClone = new Material(GetComponent<Renderer>().material);
-            playerMaterialClone.color = _New;
-            GetComponent<Renderer>().material = playerMaterialClone;
+        private void Awake() {
+            NetIdentity.OnStartLocalPlayer.AddListener(OnStartLocalPlayer);
         }
 
-        public override void OnStartLocalPlayer()
+        private void OnStartLocalPlayer()
         {
             Camera.main.transform.SetParent(transform);
             Camera.main.transform.localPosition = new Vector3(0, 0, 0);
@@ -184,17 +246,22 @@ namespace QuickStart
             CmdSetupPlayer(name, color);
         }
 
-        [Command]
-        public void CmdSetupPlayer(string _name, Color _col)
+        private void OnNameChanged(string _Old, string _New)
         {
-            // player info sent to server, then server updates sync vars which handles it on all clients
-            playerName = _name;
-            playerColor = _col;
+            playerNameText.text = playerName;
         }
 
-        void Update()
+        private void OnColorChanged(Color _Old, Color _New)
         {
-            if (!isLocalPlayer)
+            playerNameText.color = _New;
+            playerMaterialClone = new Material(GetComponent<Renderer>().material);
+            playerMaterialClone.color = _New;
+            GetComponent<Renderer>().material = playerMaterialClone;
+        }
+
+        private void Update()
+        {
+            if (!NetIdentity.isLocalPlayer)
             {
                 // make non-local players run this
                 floatingInfo.transform.LookAt(Camera.main.transform);
@@ -211,10 +278,6 @@ namespace QuickStart
 }
 ```
 
-
-
-## Part 10
-
 Add the `PlayerNameText` and `FloatingInfo` objects into the script on the player prefab, as shown below.
 
 ![](./image--009.jpg)
@@ -323,7 +386,7 @@ Experiment and adjust, have fun!
 ![](./image--016.jpg)
 
 
-## Part 12
+## Weapon Switching
 
 Weapon switching! The code bits.
 
@@ -401,10 +464,6 @@ void Update()
 }
 ```
 
-
-
-## Part 13
-
 Weapon models
 
 Add the basic cube weapons first, change these later.
diff --git a/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/network-manager.jpg b/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/network-manager.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..8b03a95031db80ed8c2c3757225d3b6423977eaf
GIT binary patch
literal 72148
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
L`QOMtFAn?(!uSo7

literal 0
HcmV?d00001

diff --git a/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/player-components.jpg b/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/player-components.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..9ad7bc06f12e686c318e16203bfcfcea6134ef75
GIT binary patch
literal 78028
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
DGl=tB

literal 0
HcmV?d00001

diff --git a/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/spawn-player.jpg b/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/spawn-player.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..03db54192dabad481c4a7739e78233506438498b
GIT binary patch
literal 132479
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%0D%F$5ok~Q_$s!
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

literal 0
HcmV?d00001

diff --git a/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/start-server-script.jpg b/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/start-server-script.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..5478947e7731e815eb191fdee4e27034d86c56c1
GIT binary patch
literal 144964
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%0D5L))PBnkn&cpF{wBw`f-
zU_<AGl6<U?Gs!?eN%nvB4a`bN63qqJUmxQfOhfYC2UBwS@1SG}5;NJV+(Ry9o)SEh
zg$72g99P!iD$Nlka(23?73*LMQ3!Ou992Zdy{qhp7g4Rk?L;h8RnS#_7#U^ctNa{n
zXSPVC>t4701Zy%&D3EwUIlk$q2=v~o#c<XYuv-`zv*|T5B-{j1K1DT>zihj?@-S^Q
zT*kDfTJEIPq>ezUxn5w0*PPaApgUs?sBZ554iehOhaMz~%pAxrCju`+$4bA0x|E4P
z<A>ex9iS+r){dEs@K=KF|Fp^JuZ>ZM_=>9ve(a_Kfd7A1EB&8+_5)$+=#K~rFX@T^
z>>pag*)($ma|7Q#fM)f{_2KyadUDCgfXFjZd)!e}y*6%rbMy>w_nqeP!10;Jk->NM
ztk<Gc1cYB{y}Cz_*Wi^S(xk(N>dEn{H*m#`ew^w<+1gWr#-m%B6(|K^=1H-#iRD)!
z!B^lO39^o#a2B#wv(?3#85X$V*vNVf*Q}LVo03Ayarnc5QN7BMLXY9vilA!|!o-@Q
zc{u*_8=rV$aU<m!E7Lk%kxT>X_MD75|Dtc=7H12_&MtZELA%ox3i*dJbJ0QC{?Dg?
zgi^+NZr){&c;vQEL+c=?n{vzIGtdb`?;D>^&-X>3psH4g+ZFwroHZUJ{ZG{T5gy~w
z?ZMou25K@-c9Ejzx}v4kk~-dJ2;J1wk0_bvHf&O6#MzhJ%5}ClbubekYCq^v@bnq`
z*5@JM?TZ;`KpWe!Vwh=3+-~-{p?FdKO(_(aTl*zv!(=M65V7V!`yGVxck$a91IrJ8
zLR|83!+ec4K5d&fZq?=_J;tVGXU-$jVPnEhuZvM0{-%6pcyk12pYwd}1Uhi0WyI~v
zwq(y;*IPrEtELez5u1scf)_MrMTA|ShFpGVnGvbXI)X6AGl>CB&6>%*q?7WtxC!+$
zz9Rg_!&g~v966!u!l}(Edx1LMylTm|+K#!V#=&F;H!$i~-oJ%b(FPkP<3qPR7aMA~
zs|=R_emg;9Lin7#M>I>9wW>jlIgbduq(Oztg>RnU<Em}!Jt5p^U<H&-CBHLwOxv3$
z+I}zitAM2Ikt7qZ&gEqNuRUI93WTm3Zf72~o%5i;Lgn=*r@b-l&ARA$->f|A!n+B9
z`rX%zgbln|tQ>gXu^`!j>XHT?{5i+e<Y!=_=p}(2v%0{GLr4ev$uN&^x^&|FHM<I>
zId$Hr(oafc8KjiwD@re<4s4e$0xRrf*}8axc(!0S+w`)`P92F8EUyo}3eVY8L<U$S
zy+|#3lJCP|^GrPH^pN!C6eR7Q0Hb+pI>P;&QrDWuH-yxwOD3)-3B78B;Q2M?aVX4&
zvwUz>`OJ74)6(ilX^YFv0q8D@!}e|*cV%0Z{e^2R5J`cYL^T;!Lz5J>gEh#vFWcVM
zGH2~+3)UUcvpzm6wdNV}{m>imNQ*v5rIO$SZ|_&dVac@46zLnrCBw?yka)%t-_WY)
zTSiQZiIePlTX%(NGV^A}miJhKW$PZinugadwd}y0d>!)5EvUthy&}Jj@5ch!vD4?7
z9>lS$uJKlwb6I7-%bm8-AN1Yu9l17MQA01~B-n}0D8}S2b(NdeA#@0#w%KsQb~KPq
z{8Z~zfPC#ZGALHDSV4S}_sP{{dBAM`>h6p7vyMjMJMD9v8Pvrh>><(YLhV))o0UDq
z14~{!<!?kPT+saAL3*zuMB=_2|6yB^SoS8r-nZ3rRqaICa<aDc5y#f}P*~XQPQ#X)
znyp8uKFSxrMBDcg1fd<!aZ5}aIszp?@W!}^=&8tN01YQcgX>Q^Gjh!t#fWH`ooQEz
z6PQ&MHwyIk0k8AI%ScTn$YoEIpCFJ?ZZcQWcF1d@Mdbz`Etf2GQ{ygQi5Fr!4nlw^
z*?5vL_!w}s$j#UKv-t+W8r~O;k_u~5t==rlV(q6^lSiG3vuCF{x*tRkLZ6vDzQ}bq
z8|z!JoHbGWM(F|YvO?)E1s9p`B)}eEBB|?d;yOKHb}p}$H)yX=L}*35m5;nzP%2E{
z^&s(1JI?677fA*mJsMP8u~{}i7n?ghu{<gV`IJm{t2#|ELFoN@S+b>5FFCmGV!OKk
zBk07#`FRNTXy(_4ZPQOOt>NCy)50M$dJ*d7ZlZf<$1kVbR(kJFT)oM)mO`F<%C`}E
zs(}^0glR~cb7i)19H~k_OGv@g6|)f@-gv`~a`CjQ9x^#i=OQ3?zWkBV<M>?bI*apu
zh&<Nx!KT3wPw5h2U(!dH=7YJlvguK;@o%F_FZTHwXWh2WS9>3ii$?K3(OFiWl5qGO
zn<@<s=Mly0yiT@oNl!!i@YZFska)@x)Qt>QuY^4ac+<KE(sc&j8ELYt0eDeC64fe_
z(BtPr*$#tH5@7^C>781h*di_QGUvTPLbvAdq@}JsUsZ(9T^CGM;H1^9tPM*cj_Z$O
z*_ZrT0D@+3G`(mx{$377mvCKXyOv;GaPVqw8d|ENw8ILX$h~@2wspg@UC=<qjFTd2
zsc(-YLh{#MbBNzkf)Mwi?#gyRB)q@qJ7@^#;-m0_5beu}obws1L>0W(vzK2+YA<c0
z3a8X;?e3<Y4J_Z#Y+@vn1X16n<fns8v$l^sYyiB28BBV~ELO19!oDPDnd8!Sj<@a2
zs#@Bla)9UMhKC7wTFGSadR^6fFyunG2nui~J9H`G67!}lPnE<90XA%0&rG{w_msW1
zUEmZ`vs^#VMLBu;qwz`N>F2KrFyQymiGPv$)~`YnoKS?ddDbXw{UuDA)b$aWf}vDR
z(b>LLrOvDRN&_w*RQWYHUwFzlb~a`;Da^!>_$<CY_>yY>?6oT9o$L*$A$(I2RO$7)
z3ng-rVOHvO<HFJ-o8j5sh*ZkJ1}TDKTl(=)>0&y9tq#yIV%xuJR~K?g<I3={P<T|8
zMo6+xQK~?U`;qR?8XQL@cO}1BBeZdX0Yvb;W4$Em%Y9@s21m-7yL4rQGaI^!7)z?^
z|ES9(Hd!@Ox6;X-HM^j{MKmQ6Q>I&1;K<$Wh6O~`Z|nh#tCgAA3q;Pw06B}O(Lo!<
zl;)9)Qk{z2-eLmMVqYLQbJCG1+Ez2xb97v^t!rZWt-5$-5?=!5Y=Vzmcg0lPdZ%p%
zn5kX{A2c@_D}7+vI!!aU87(qT8;)yR`n2j$RXULU-1ubYi90?IEGoMN{Pth*w}13^
z*ZQq!bw3wvBwZ3O_gFWK1fE{u2n|VT*MiN#%)V8K`Cc1Uiyj?2tzeYmKGs^f%$BNk
z-Lj=nBiXOy?Tu(Y<3SH34cug@&9s4isNu{ETtm+qVmMfVy3k}_XKkm79kPqCl=9p*
z_B{C@j+;gIe4uXe9C~S?VH<4N0(jvSJACsHf;Gq5feHktVGCf`!Ey<HkXHH#IH`HC
z95y$elpM>(p`HeQ?gL*<?i2sgZr!DMc{4h^kzy2uxKHTFA$T`JP9iZ}K#j74`skL6
zZHt$ju-)r1=Q8W7(kLy7#Rzz2j8uamRT?%<@Yxx%u=^IVtFSp5TGnPX?OKtmi^skM
zJ<*|G!m}<i+(ZcV($kQlw2t8vvkF|BhgFc@KK8c~ciRmk{9GT*h1m^w5Cm~n_SWvg
z9wJl=gGSbBj^6oUT;ZR?sn{?2Kc$HB6Pe2kujnxt@9LVlR##u2bTg33gGMmHi7nX3
zm|-D76GWFi`i}5mp7OD>AmS(?6GeD#Qdy3#{i1*jEk=#sEF)A7%S@efEV{){+>x}L
z(B`UMjOTsw<a32LfKWw}f*UqXEA~~m$n77S(I~}#&hWuZsZX>i*zGT;8Ynf~tST)p
zkMV`sKW^tyOgX`Axah!iUKtHEwq+#jfAZ6%2O_Scld*Bd%Hr@?o%-ZyczKw^qYv)t
zd$bAVcj>73I%k9Qk<DL5kt@_dnTH~nBn35s!{!A;>iOm*Sl|WiJL#wJg5mz$@PyCv
zy5;-Us6BXYukrfnJJECYTFKK?xlc|fM9Y6<bBpysVlpTZ8hCIJk$MhHWeww@$N4qH
zV<Z@QJz=ME4(6vjypf`&QjEtx8q9qbTJQq%TN;H33H^54aEqN6e<%9L$T8>XEd8n?
zkM6;40Z9VC6j^_CuE+4oFxJCY%u=l`xp{l4T>D6$?#aY>YDNZ4JH9}TQvhTQtFpM0
z4L!kjZlPbsl{%KqIc1uqY*bvj$?0_6lYJ>eYc1?E73&byBR!&EKFy93CYLQ0NymS|
z$)bh>-A1X~S+f8c2&s)nYIwr5j8(74@AZt9w_<K~La`i+d-LVUn`6gD3_rXw|DD}*
z)~f;gU9<lQ+)kJ$x778DeuP;HlM`!n<|nqb$4pP{C&Fs8gDALoLNkxW@_hAIBtSiL
zn~IlH?Nelnb0=1|on%9A)xyk2Jq!YP<xkWH-1jS(QaTFs$01A!WVnt-9%;OIN}iK4
zdmp$pn$P-W!nBzu*0|VXYiXgn_HDA<RftqQOXL07G|P-ASu|(E1(kVrgjUu#Y;9KF
zT-0Ujl9X=Tr1Gmp)am*LlaNkK@FO;;RF`$c`S#yE%VO-IRSWd}A3lE?;t5!MtUAFQ
z*mtD#aC8M2M;X`}BV1>0#8Ozac)?Ra?CT0G4OMgLL4K0G<GkABzPXWd*Cr%*23NEh
z8%+{qA)UrOAe;oe>;hFkTb_zn%U&$0=J6~nalKqAtRtm-Z)4<-cknbf^(8d^)<l48
z<6&_QOAA|pjy)vNI%wcdB}cx2pOc_b!}wVvG_t1s5?ACb-p1;=Nd`Bin~ZJSa`i9r
zT^%>SKih<NZBIXr9GinnM~cxcwYU?!wSul|DH-R4i+VC{L(8>!UL>RMS;q5DhTCXe
zQBVr?6}ejOhXlYZAZK^p?xllCe#JH5i-NIA)`E|-M@>dGTm(2P-X<)1Xdfxj`SLNW
zrK>C1$i0TmRSch&$3AoT?C3+6Lt0DlbTivYHTz!AeK0WS$#JJ?E?Mg1V-m#cYy6e#
zN-r57Ramy4xL~Fzt23wDx%u0hb3=*Z(cYw&83eu(pmqpAS@>~XTjenS$q!_T0hs;T
z%B-c`&R5DkK*S~dY+U<;<x@UbSGXX_2007fmjOfDkiDILtIBzyz#aqprqO2tp{YQZ
zjM195f=>|T-mKi$c;JxZoScle*5-=fkae%@VdfkvpjXx;nV4WSW!_I&I>*DyjB#sW
z(i0+_Jqny{)sH+riRD(MQr)>Pryc>n16o(1*yq?0Gi@J1GDt(h44q8DG~jE5OeK!s
z#how-zN+DR!P745D$LgrW2e~OsvglwJnmMV$a7<UhSLmK#Phi*WKQ|Oa=+ui^7i0|
z=V$9;Mz6_sD;CQ;Q7GSHmlyXbiV_ficMX?k;F3GwR5^I#>FxVNx6}<EGdanoYM1;{
ze)R`&3*_&BWPCzj`cwW`UhuQO|0$&hhv0}g+s_6$DIO^UY6w-!B^w1_+?kzUe@Ryv
zk+~hMOG2zdaFRfc*)Z5~2#A$^1kPu2Fn|-QcXaPu=(r4IcjGNkbq07c^G1GIhQRD9
z(i2Z0NivsNzr6X)PxKFs2ZFwOedre&hespx|8EMw*}#dH0g|s<uVuK!zri@ax+7{{
zxfIqMHS-P34y31GqCZv$uj}Bbij|@I<_Q~fwF^8$q4+kR;%4%v2#~Q=8J7^bsIH;a
z=wZ1I$!v<X&s-h!!uF+WZakPUI5?$><;WoJ0th;Q*Mfhe+@BA)GijluV-NsB=d}=8
zO>bWvct23~0u$JPYE9?Za%bem5)kHk6bpDcuaEqEfR{9z#`K4Oad@}@iGHKQ_slvZ
z4`^&qMm4v*v4yth-3NR2*{3JDmg7FjpWZSCkQB~c%%kk<Aa*^JAW=Y(>uR?TJ?Y`u
zG49trWx%*-QkAN^alIW5zh*U_w=hmjm927wZVG?NATas?SuW;#edsTS{SX}Q{&!G<
z2<stP4$E1vht=r^42h3))z5%?5m1OWu?IEIdT{)q;D3n2SuU~1ys1m1YWNOXh-f?f
z;J?x1uY;*<X?mxSj!JC&!-8dftx(heY8qpADTmKYLkZ02593pr$iBQ+$XPWYG|8`D
zcLhL^*S!h|AGt=-EQJ1Sf?|t?uwdd5$O70X)CW0h02D97yn+Fqg!FLWky&Sm@#<I_
zQt&0<h3$w0dY8Av|BwY8o=xRC!*V2!3ShMPRb?O1O*ZnOnBH)dXBxfgVEH?P_az~p
zr@!r5lMAbZ@%XONG7<6?5e5~ChzdOY+!KW9@XL4jW6`<JhU1N5E-jNbqFyD(>=`>a
zJ~By9ewZ*KOST<K#Weiaq&Pfrx~^}Qy}Z0x@Nie{2%5JAN?Jbt`R5I5RLR^znm|#T
zyfth8N|hZJ_W!I5#PO$A)~nMGaZGb)@js%>UQ$_E*?&UHQmoc``m>Pz)Y6sMr8Uik
z$%%e55!bsx)k~3wR*Q+mPj*v{QD?7M5*c`%{*7uq8Yhf=1|&CKmw_-Gax4QEvy2{_
zMvgc1Z2yuk=&o{oR)uAos*2ibGy3n`qT=xS%{sgs&CrLBy~Af1*gAh4LZCptSI(zf
z2R48llKse`^;>ARQmd0z*NLkPdydbTnSL?<)y-<{zoY`-)NR%WPKYZXfh_{*3LzZG
zLQl1E8TiF&4oWZIiGC$@d9dv9P2+$K{+k!F0|7+aUYQR+*}9GVyo$9YG}|EWL_&v!
zx9YYMGiJvQK)-iW)Bty;P-zVa9c|-d$N3@z0rxrF_Yqf!N-Tg&Q)5grGCeckPyH{g
zp*-Zs{N20?Iai(T7^#VWYdUp#F<c(xFP-$DC1d@<GIDF5k`!$L>I2itY<vfuuYs%)
zAw+91u8^n#fVlkS(ifnjnMWS}zkk(N{Ah4_n5~XB*RXL&DC%>}aD{eK__sUkF$3bI
z*9j!5KB=nG)QQpWAct56bK=br1US3VvpbEyym<x07YI`l>F_dtZ#D;?mOJ_$T(AEk
z6|{>aoyrIU04fC!zJo&loek;mbukL);pHWCtK&JGOj50<GktiHobsoOlh3dSV6-&N
z(<)Q=8D4VLP&&$(>K#1aqR}0v(Zf-pD`H%PbA6|-e3p%%kv|>Kt27`q*<>5d6-Q=U
z1!B7Vl0FH7F((9(9s#vp1mrIiO+Q}kMYe;f%T=<>ZGZqCY_6&XeM7Q*S(G+8SK$72
z7w(4L6D7(6nSBegeO)<&4<wNGt~_S&gl<jbi50Qe&XSYbFlI};jka3W7b3#vY-A{E
z9o+G8zx2D(6HNS117HeP89O8}Nj&!OWkUv@b+voG_qY>l)eecHA+T3B=Hln4%%1C3
zFU_C8xbaM1lv=xvG@eWsZn$ueTJJMU&Nf^x@n*a}r8}3Z^|ltvayT^&FH_fAMT7{*
z>WC>Hpy9|r({SDzfcebhMB*<UfVL<^u5d(|GL5$}m?QA_LbQg>wG8mD&kic4L_Lbv
z)7n>p4?x((13hTaSiv$<zwwEXldwT7kJp+=*LyyHY+Z;H&{hf%Km7DD(+42-8Qfn}
z8}e?sVhVsFNXJoz@#(_4+bjduV{jo3XOQsMZT~?%nK%M*h-D%mG18>-@2Ua^nnz7j
z)T%2}Z*ecy<FV5md?9T1;~LWxTmb<6&r|fFSv)+a+t-B1+kq~fALsd>^Npsh8v<Wd
z-^uR8$<$+1@7|_U`ABs-?jg^?n|GcW9LNQaSW<n~cTj)AsNhfgPQeWj987|kwbl;a
z)+<JCPUPxq{4Ra1M>*^H_x7hAhW4B;<fbQGu0(D%K{gpLv%LNdEa-3B7XRp4<ZqiG
z%;rbhnE-{_AF@zCW~Bc8?;1?+F1rVM?;z+qNF8OEFD9PeyiOC={7h_7D^c!>aS+H4
zXuCqZsvko5yaSdCcQNS%P<s~z`0O+*JEQ<FG(pmpBz2i5NzJF2C{Zx8M+VeQ%(kHk
zJz!izG4cx~40sh|`6a+WwrunZ#8>m)e|MZs(?&>SGWci?Uf}hfvvcay=O+RwIUR0P
z2_GfOFLb!C6IUiD*t5tUJ`3k3>qR2>ZxBr9lpo0?qi-Q!TEWuULtDmkK8D+J#W&tv
z<4f<-obyS1pMG7x@r$+FqI#DlCv4soXlO@ok^@yDO_4}^Dg@&PbeHzg0UPQuG2n#_
zfG7g;*9as5iI-^VX!e$Z_ulBgiz<hftWf7oOit;F1!s>GB{bh-yrR%uLlw7s=TytF
z$%|_Y{{6MeIr}E?*mkEp=O+YMYk`lQr-StCs@#E<F;sR-RB`H?#l%g~g7`o+1Ynsz
z>R98jdO?1s7;xAOy)q?yqPey=gclD9U)xN($E~xnV^kTb?TF2KFWc9~wUO^NRsEr7
zy;NYheQtt>gRnD;4pwGX2KU+Hb;@inHK0YSQbriYwYhfouBIXwv$d6ioKt8;pRc#D
z>Bik7Y>-%o*A75fB<}VM(LVODVnBNx*A6nJ9kHA5Ic5xdiUV?RSzs~A?Y!Dlz4@i@
zAR~&%-s$%ciHBSC;o$PBpav@cK{TUhG%cW6#u=E6!oJI@RL2R~%DxF`x72f3aMFh&
zY^>M^r^S2-Qf3!8ihinrP)u>G{|SO2Mip~#%$518tklF;0Bg$c7HxJ(FEU#@uZiPo
z*?Zai`vaY5QOU=<$CmxsNJHcFAw<S(xYr(l%46E>?#P-_>R9>kZPinl;fj8(rIlQY
zwAvlxn{Di7->g<S8{`20XUiAx0~Db|wyN(S_N+r12~aL3^z5rSeFrfh80T)VP<v{Z
z`Mvq_;FHyjTnnepZENNB?XjenmAvu|u*6RhV5)3Z{v*8vJbtYO$>!0^wJVGon_QWe
zt;4G)mRhuSD#^*4#CS1%7Btptd>tprk3c_c03u9372(pkhz;oBnfblR4!kY~!Xp18
z<D4S`>WCkJ?5zXg4Rvj+G)F>S+et!;+5R1z+TE+L;~iWfmzkM-ZXeSz+ukf(IfR1z
z+wJWD59}c3$VIUK`R}08U|=S4r!GW5e#a&h03rW-cg}xC<2Mh0rvL?(>?a-iuNGVJ
zbG=)8kb}pwq;j(1zt>g%Sv>F`_>63S{_l)Tg8nzfCI5Dk{UbDKe?o)vmrB|{t+f5G
zGXwtFkf0wAdCTFT%)jxa3LP2#dmV=#zjp^-cHj>zuv_vF6l_Ez5;FSbJ81i4&|V*<
p>0e9Y{)hjiT#NmkU!?zsM);4G^+o(YP!_Y^|1Jfofso(F{tc$KJs$u7

literal 0
HcmV?d00001


From 0b603fe9e15fe2d333c869c8ff9cc51a4c27a823 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Sat, 31 Jul 2021 18:30:35 +0100
Subject: [PATCH 081/166] fix: fixing error message for disconnect

---
 Assets/Mirage/Runtime/MessageHandler.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Assets/Mirage/Runtime/MessageHandler.cs b/Assets/Mirage/Runtime/MessageHandler.cs
index 636d5024472..fb3c1f503ab 100644
--- a/Assets/Mirage/Runtime/MessageHandler.cs
+++ b/Assets/Mirage/Runtime/MessageHandler.cs
@@ -131,7 +131,7 @@ public void HandleMessage(INetworkPlayer player, ArraySegment<byte> packet)
                 }
                 catch (Exception e)
                 {
-                    string disconnectMessage = disconnectOnException ? ", Closed connection: {this}" : "";
+                    string disconnectMessage = disconnectOnException ? $", Closed connection: {this}" : "";
                     logger.LogError($"{e.GetType()} in Message handler (see stack below){disconnectMessage}\n{e}");
                     if (disconnectOnException)
                     {

From 5f3524cf92fcc975928288e31bd456b608ca67f1 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Sat, 31 Jul 2021 18:31:14 +0100
Subject: [PATCH 082/166] fix: removing debug logs from resize buffer

---
 Assets/Mirage/Runtime/Serialization/NetworkWriter.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/Assets/Mirage/Runtime/Serialization/NetworkWriter.cs b/Assets/Mirage/Runtime/Serialization/NetworkWriter.cs
index e75d412f847..4737cd5759d 100644
--- a/Assets/Mirage/Runtime/Serialization/NetworkWriter.cs
+++ b/Assets/Mirage/Runtime/Serialization/NetworkWriter.cs
@@ -106,15 +106,14 @@ public NetworkWriter(int minByteCapacity, bool allowResize)
         void ResizeBuffer()
         {
             int size = managedBuffer.Length * 2;
+            Debug.LogWarning($"Resizing buffer, new size:{size}");
 
-            Debug.Log(handle.AddrOfPinnedObject());
             FreeHandle();
 
             Array.Resize(ref managedBuffer, size);
             bitCapacity = size * 8;
 
             CreateHandle();
-            Debug.Log(handle.AddrOfPinnedObject());
         }
         void CreateHandle()
         {

From 972b6d2b811e8082504d9da26b1dd36f377c05eb Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Sat, 31 Jul 2021 18:32:40 +0100
Subject: [PATCH 083/166] fix: fixing resize buffer when new size is greater
 than double

---
 .../Runtime/Serialization/NetworkWriter.cs    | 20 ++++++++++++++++---
 1 file changed, 17 insertions(+), 3 deletions(-)

diff --git a/Assets/Mirage/Runtime/Serialization/NetworkWriter.cs b/Assets/Mirage/Runtime/Serialization/NetworkWriter.cs
index 4737cd5759d..32ae04966e0 100644
--- a/Assets/Mirage/Runtime/Serialization/NetworkWriter.cs
+++ b/Assets/Mirage/Runtime/Serialization/NetworkWriter.cs
@@ -36,6 +36,11 @@ namespace Mirage.Serialization
     /// </summary>
     public unsafe class NetworkWriter
     {
+        /// <summary>
+        /// Max buffer size = 0.5MB
+        /// </summary>
+        const int MaxBufferSize = 524_288;
+
         byte[] managedBuffer;
         int bitCapacity;
         /// <summary>Allow internal buffer to resize if capcity is reached</summary>
@@ -103,9 +108,18 @@ public NetworkWriter(int minByteCapacity, bool allowResize)
         }
 
 
-        void ResizeBuffer()
+        void ResizeBuffer(int minCapacity)
         {
-            int size = managedBuffer.Length * 2;
+            int size = managedBuffer.Length;
+            while (size < minCapacity)
+            {
+                size *= 2;
+                if (size > MaxBufferSize)
+                {
+                    throw new InvalidOperationException($"Can not resize buffer to {size} because it is above max value of {MaxBufferSize}");
+                }
+            }
+
             Debug.LogWarning($"Resizing buffer, new size:{size}");
 
             FreeHandle();
@@ -165,7 +179,7 @@ void CheckCapacity(int newLength)
             {
                 if (allowResize)
                 {
-                    ResizeBuffer();
+                    ResizeBuffer(newLength);
                 }
                 else
                 {

From 3464d3b93bd632fc235dcf527fbe69a975c5f38e Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Sat, 31 Jul 2021 18:33:44 +0100
Subject: [PATCH 084/166] refactor: improving error message for spawning when
 spawn id is empty

---
 Assets/Mirage/Runtime/ClientObjectManager.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Assets/Mirage/Runtime/ClientObjectManager.cs b/Assets/Mirage/Runtime/ClientObjectManager.cs
index 466b9f8d319..d4536bd2836 100644
--- a/Assets/Mirage/Runtime/ClientObjectManager.cs
+++ b/Assets/Mirage/Runtime/ClientObjectManager.cs
@@ -355,7 +355,7 @@ internal void OnSpawn(SpawnMessage msg)
         {
             if (msg.assetId == Guid.Empty && msg.sceneId == 0)
             {
-                throw new InvalidOperationException("OnObjSpawn netId: " + msg.netId + " has invalid asset Id");
+                throw new InvalidOperationException($"OnSpawn has empty assetId and scene Id for netId: {msg.netId}");
             }
             if (logger.LogEnabled()) logger.Log($"Client spawn handler instantiating netId={msg.netId} assetID={msg.assetId} sceneId={msg.sceneId} pos={msg.position}");
 

From cd43aeb0031440faa990fe3a97942e827b46f650 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Sat, 31 Jul 2021 18:34:30 +0100
Subject: [PATCH 085/166] style: moving buffer size below option and adding
 header

---
 Assets/Mirage/Runtime/Sockets/Udp/UdpSocketFactory.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/Assets/Mirage/Runtime/Sockets/Udp/UdpSocketFactory.cs b/Assets/Mirage/Runtime/Sockets/Udp/UdpSocketFactory.cs
index aaa6ec233e7..bfdfe4e1c04 100644
--- a/Assets/Mirage/Runtime/Sockets/Udp/UdpSocketFactory.cs
+++ b/Assets/Mirage/Runtime/Sockets/Udp/UdpSocketFactory.cs
@@ -13,11 +13,13 @@ public sealed class UdpSocketFactory : SocketFactory
     {
         public string Address = "localhost";
         public ushort Port = 7777;
-        public int BufferSize = 256 * 1024;
 
         [Tooltip("Allows you to set which Socket implementation you want to use.\nAutomatic will use native (NanoSockets) on supported platforms (Windows, Mac & Linux).")]
         public SocketLib SocketLib;
 
+        [Header("NanoSocket options")]
+        public int BufferSize = 256 * 1024;
+
         bool useNanoSocket => SocketLib == SocketLib.Native || (SocketLib == SocketLib.Automatic && IsDesktop);
 
         static int initCount;

From d48091e5e6156c8d5dae028529b891a8352ae79f Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Sat, 31 Jul 2021 18:44:32 +0100
Subject: [PATCH 086/166] removing extra topics till they are added

---
 .../Guides/CommunityGuides/MirageQuickStartGuide/index.md     | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/index.md b/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/index.md
index 1049c9d1fe6..3725f3a8aab 100644
--- a/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/index.md
+++ b/doc/Articles/Guides/CommunityGuides/MirageQuickStartGuide/index.md
@@ -6,9 +6,7 @@ This guide covers the following topics:
 - [Player Movement](#player-movement)
 - [Initiate Server By Scripting](#initiate-server-by-scripting)
 - [Network Manager Hud](#understanding-network-hud)
-- [Server And Host Or Host Only](#server-and-host-or-host-only)
 - [Names And Colours](#names-and-colours)
-- [Scene Script With Canvas Buttons](#scene-script-with-canvas-buttons)
 - [Weapon Switching](#weapon-switching)
 
 It is best to first make a mini practice game before converting your single player game, or creating your ideal brand new multiplayer.
@@ -16,7 +14,7 @@ It is best to first make a mini practice game before converting your single play
 The Pre-made Mirage examples are great for using as reference, it is recommend to use them regarding connection setup, with ports and firewalls. This can be a huge topic that changes from person to person, and is not covered in this guide, here we will use localHost (multiple games on same PC).
 To achieve this, let's first create a new blank project on Unity Hub, after the editor opened up, we can move forward.
 
-# Installation
+## Installation
 
 Before everything, to install Mirage we need to add a new package manager into our project. To do this, we can go into `Edit menu` then `Project Settings`.
 This will open a new Editor Window with multiple tabs. The one we are looking for is `Package Manager`, so click there.

From 927fe9574e6a28aac15e90bf4ecc8d3172d423b4 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Sun, 1 Aug 2021 14:32:37 +0100
Subject: [PATCH 087/166] fix: fixing resize buffer so that it uses byte
 capacity

---
 Assets/Mirage/Runtime/Serialization/NetworkWriter.cs     | 9 +++++----
 .../Serialization/BitPackingReusingWriterTests.cs        | 5 ++++-
 2 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/Assets/Mirage/Runtime/Serialization/NetworkWriter.cs b/Assets/Mirage/Runtime/Serialization/NetworkWriter.cs
index 32ae04966e0..0e8680c7c24 100644
--- a/Assets/Mirage/Runtime/Serialization/NetworkWriter.cs
+++ b/Assets/Mirage/Runtime/Serialization/NetworkWriter.cs
@@ -108,19 +108,20 @@ public NetworkWriter(int minByteCapacity, bool allowResize)
         }
 
 
-        void ResizeBuffer(int minCapacity)
+        void ResizeBuffer(int minBitCapacity)
         {
+            int minByteCapacity = minBitCapacity / 8;
             int size = managedBuffer.Length;
-            while (size < minCapacity)
+            while (size < minByteCapacity)
             {
                 size *= 2;
                 if (size > MaxBufferSize)
                 {
-                    throw new InvalidOperationException($"Can not resize buffer to {size} because it is above max value of {MaxBufferSize}");
+                    throw new InvalidOperationException($"Can not resize buffer to {size} bytes because it is above max value of {MaxBufferSize}");
                 }
             }
 
-            Debug.LogWarning($"Resizing buffer, new size:{size}");
+            Debug.LogWarning($"Resizing buffer, new size:{size} bytes");
 
             FreeHandle();
 
diff --git a/Assets/Tests/Runtime/Serialization/BitPackingReusingWriterTests.cs b/Assets/Tests/Runtime/Serialization/BitPackingReusingWriterTests.cs
index 5a2c39c7299..2bb56c68e63 100644
--- a/Assets/Tests/Runtime/Serialization/BitPackingReusingWriterTests.cs
+++ b/Assets/Tests/Runtime/Serialization/BitPackingReusingWriterTests.cs
@@ -9,7 +9,7 @@ public class BitPackingResizeTest
         private NetworkReader reader;
 
         [SetUp]
-        public void OneTimeSetUp()
+        public void SetUp()
         {
             writer = new NetworkWriter(1300, true);
             reader = new NetworkReader();
@@ -18,8 +18,11 @@ public void OneTimeSetUp()
         [TearDown]
         public void TearDown()
         {
+            // we have to clear these each time so that capactity doesn't effect other tests
             writer.Reset();
+            writer = null;
             reader.Dispose();
+            reader = null;
         }
 
         [Test]

From b0cc540a72078cfae9b36326f340de5fdf027b58 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Sun, 1 Aug 2021 14:35:42 +0100
Subject: [PATCH 088/166] test: fixing expected message in test

---
 Assets/Tests/Runtime/Host/ClientObjectManagerTest.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Assets/Tests/Runtime/Host/ClientObjectManagerTest.cs b/Assets/Tests/Runtime/Host/ClientObjectManagerTest.cs
index 1c7ddcad48b..3aba5003a5e 100644
--- a/Assets/Tests/Runtime/Host/ClientObjectManagerTest.cs
+++ b/Assets/Tests/Runtime/Host/ClientObjectManagerTest.cs
@@ -22,7 +22,7 @@ public void OnSpawnAssetSceneIDFailureExceptionTest()
                 clientObjectManager.OnSpawn(msg);
             });
 
-            Assert.That(ex.Message, Is.EqualTo("OnObjSpawn netId: " + msg.netId + " has invalid asset Id"));
+            Assert.That(ex.Message, Is.EqualTo($"OnSpawn has empty assetId and scene Id for netId: {msg.netId}"));
         }
 
         [UnityTest]

From 23f5e7cd69f0c95d36d3dd832d91903942324c79 Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Sun, 1 Aug 2021 13:51:11 +0000
Subject: [PATCH 089/166] chore(release): 101.0.2 [skip ci]

## [101.0.2](https://github.com/MirageNet/Mirage/compare/v101.0.1...v101.0.2) (2021-08-01)

### Bug Fixes

* fixing error message for disconnect ([0b603fe](https://github.com/MirageNet/Mirage/commit/0b603fe9e15fe2d333c869c8ff9cc51a4c27a823))
* fixing resize buffer so that it uses byte capacity ([927fe95](https://github.com/MirageNet/Mirage/commit/927fe9574e6a28aac15e90bf4ecc8d3172d423b4))
* fixing resize buffer when new size is greater than double ([972b6d2](https://github.com/MirageNet/Mirage/commit/972b6d2b811e8082504d9da26b1dd36f377c05eb))
* removing debug logs from resize buffer ([5f3524c](https://github.com/MirageNet/Mirage/commit/5f3524cf92fcc975928288e31bd456b608ca67f1))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs           |  2 +-
 Assets/Mirage/CHANGELOG.md                             | 10 ++++++++++
 Assets/Mirage/Components/AssemblyInfo.cs               |  2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                  |  2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs      |  2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs                 |  2 +-
 .../Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs  |  2 +-
 Assets/Mirage/package.json                             |  2 +-
 8 files changed, 17 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index 7ef7020e0c7..cddfedcbc74 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.0.1")]
+[assembly: AssemblyVersion("101.0.2")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index ad78f01ab44..6d7b68822bf 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,13 @@
+## [101.0.2](https://github.com/MirageNet/Mirage/compare/v101.0.1...v101.0.2) (2021-08-01)
+
+
+### Bug Fixes
+
+* fixing error message for disconnect ([0b603fe](https://github.com/MirageNet/Mirage/commit/0b603fe9e15fe2d333c869c8ff9cc51a4c27a823))
+* fixing resize buffer so that it uses byte capacity ([927fe95](https://github.com/MirageNet/Mirage/commit/927fe9574e6a28aac15e90bf4ecc8d3172d423b4))
+* fixing resize buffer when new size is greater than double ([972b6d2](https://github.com/MirageNet/Mirage/commit/972b6d2b811e8082504d9da26b1dd36f377c05eb))
+* removing debug logs from resize buffer ([5f3524c](https://github.com/MirageNet/Mirage/commit/5f3524cf92fcc975928288e31bd456b608ca67f1))
+
 ## [101.0.1](https://github.com/MirageNet/Mirage/compare/v101.0.0...v101.0.1) (2021-07-29)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index 962daa6f2c0..6ce2ec628f2 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.0.1")]
+[assembly: AssemblyVersion("101.0.2")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index 9f0952230f9..d2727ce0522 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.0.1")]
+[assembly: AssemblyVersion("101.0.2")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index ee1f9ee9094..6cc7b2f59cd 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.0.1")]
+[assembly: AssemblyVersion("101.0.2")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index 7ef7020e0c7..cddfedcbc74 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.0.1")]
+[assembly: AssemblyVersion("101.0.2")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index 7ef7020e0c7..cddfedcbc74 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.0.1")]
+[assembly: AssemblyVersion("101.0.2")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 21df15b70c2..6e7280dce13 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "101.0.1",
+    "version": "101.0.2",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From 16b300002a28eff27bbc2d880993fd61271a4ab6 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Fri, 6 Aug 2021 20:23:53 +0100
Subject: [PATCH 090/166] feat: adding way to call SendNotify without
 allocations and example (#875)

* feat: adding way to call SendNotify without allocations

* adding some code to show how to use INotifyCallBack

* adding new methods to pipe

* removing duplicate code

* removing todo

* fixing code smells

* pipe tests

* adding test for callbacks
---
 Assets/Mirage/Runtime/PipePeerConnection.cs   |  10 +
 .../Mirage/Runtime/SocketLayer/AckSystem.cs   |  25 ++-
 .../Mirage/Runtime/SocketLayer/Connection.cs  |  36 +++-
 .../Mirage/Runtime/SocketLayer/NotifyToken.cs |  42 ++++-
 Assets/Mirage/Samples~/Notify.meta            |   8 +
 .../Notify/Mirage.Examples.Notify.asmdef      |  18 ++
 .../Notify/Mirage.Examples.Notify.asmdef.meta |   7 +
 Assets/Mirage/Samples~/Notify/NotfyExample.cs | 173 ++++++++++++++++++
 .../Samples~/Notify/NotfyExample.cs.meta      |  11 ++
 Assets/Tests/Editor/PipePeerConnectionTest.cs |  34 ++++
 .../Tests/SocketLayer/PeerTestSendReceive.cs  |  53 ++++++
 11 files changed, 400 insertions(+), 17 deletions(-)
 create mode 100644 Assets/Mirage/Samples~/Notify.meta
 create mode 100644 Assets/Mirage/Samples~/Notify/Mirage.Examples.Notify.asmdef
 create mode 100644 Assets/Mirage/Samples~/Notify/Mirage.Examples.Notify.asmdef.meta
 create mode 100644 Assets/Mirage/Samples~/Notify/NotfyExample.cs
 create mode 100644 Assets/Mirage/Samples~/Notify/NotfyExample.cs.meta

diff --git a/Assets/Mirage/Runtime/PipePeerConnection.cs b/Assets/Mirage/Runtime/PipePeerConnection.cs
index a018ad28a7d..84305f9e081 100644
--- a/Assets/Mirage/Runtime/PipePeerConnection.cs
+++ b/Assets/Mirage/Runtime/PipePeerConnection.cs
@@ -86,7 +86,17 @@ public INotifyToken SendNotify(byte[] packet, int offset, int length)
         public INotifyToken SendNotify(ArraySegment<byte> packet) => SendNotify(packet.Array, packet.Offset, packet.Count);
         public INotifyToken SendNotify(byte[] packet) => SendNotify(packet, 0, packet.Length);
 
+        public void SendNotify(byte[] packet, int offset, int length, INotifyCallBack callBacks)
+        {
+            if (State == ConnectionState.Disconnected)
+                return;
 
+            receive(packet, offset, length);
+
+            callBacks.OnDelivered();
+        }
+        public void SendNotify(ArraySegment<byte> packet, INotifyCallBack callBacks) => SendNotify(packet.Array, packet.Offset, packet.Count, callBacks);
+        public void SendNotify(byte[] packet, INotifyCallBack callBacks) => SendNotify(packet, 0, packet.Length, callBacks);
 
 
         public void SendReliable(byte[] message, int offset, int length)
diff --git a/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs b/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
index 09f4af95905..629900d521c 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AckSystem.cs
@@ -237,21 +237,28 @@ private void SendAck()
             }
         }
 
+        /// <summary>
+        /// Use <see cref="SendNotify(byte[], int, int, INotifyCallBack)"/> for non-alloc version
+        /// </summary>
         public INotifyToken SendNotify(byte[] inPacket, int inOffset, int inLength)
         {
-            // todo batch Notify?
+            var token = new NotifyToken();
+            SendNotify(inPacket, inOffset, inLength, token);
+            return token;
+        }
+
+        public void SendNotify(byte[] inPacket, int inOffset, int inLength, INotifyCallBack callBacks)
+        {
             if (inLength + NOTIFY_HEADER_SIZE > maxPacketSize)
             {
-                throw new IndexOutOfRangeException($"Message is bigger than MTU, max Notify message size is {maxPacketSize - NOTIFY_HEADER_SIZE}");
+                throw new ArgumentException($"Message is bigger than MTU, max Notify message size is {maxPacketSize - NOTIFY_HEADER_SIZE}");
             }
             if (sentAckablePackets.IsFull)
             {
                 throw new InvalidOperationException("Sent queue is full");
             }
 
-            // todo use pool to stop allocations
-            var token = new NotifyToken();
-            ushort sequence = (ushort)sentAckablePackets.Enqueue(new AckablePacket(token));
+            ushort sequence = (ushort)sentAckablePackets.Enqueue(new AckablePacket(callBacks));
 
             using (ByteBuffer buffer = bufferPool.Take())
             {
@@ -268,10 +275,10 @@ public INotifyToken SendNotify(byte[] inPacket, int inOffset, int inLength)
 
                 Send(outPacket, outOffset + inLength);
             }
-
-            return token;
         }
 
+
+
         public void SendReliable(byte[] message, int offset, int length)
         {
             if (sentAckablePackets.IsFull)
@@ -652,13 +659,13 @@ static bool NotInMask(int distance, ulong receivedMask)
 
         struct AckablePacket : IEquatable<AckablePacket>
         {
-            public NotifyToken token;
+            public INotifyCallBack token;
             public ReliablePacket reliablePacket;
 
             public bool IsNotify => token != null;
             public bool IsReliable => reliablePacket != null;
 
-            public AckablePacket(NotifyToken token)
+            public AckablePacket(INotifyCallBack token)
             {
                 this.token = token;
                 reliablePacket = null;
diff --git a/Assets/Mirage/Runtime/SocketLayer/Connection.cs b/Assets/Mirage/Runtime/SocketLayer/Connection.cs
index 0de6ec7815d..9bb03b9e742 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Connection.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Connection.cs
@@ -17,6 +17,10 @@ public interface IConnection
         INotifyToken SendNotify(byte[] packet, int offset, int length);
         INotifyToken SendNotify(ArraySegment<byte> packet);
 
+        void SendNotify(byte[] packet, INotifyCallBack callBacks);
+        void SendNotify(byte[] packet, int offset, int length, INotifyCallBack callBacks);
+        void SendNotify(ArraySegment<byte> packet, INotifyCallBack callBacks);
+
         /// <summary>
         /// single message, batched by AckSystem
         /// </summary>
@@ -175,20 +179,50 @@ public void SendUnreliable(ArraySegment<byte> packet)
             SendUnreliable(packet.Array, packet.Offset, packet.Count);
         }
 
-
+        /// <summary>
+        /// Use <see cref="INotifyCallBack"/> version for non-alloc
+        /// </summary>
         public INotifyToken SendNotify(byte[] packet, int offset, int length)
         {
             ThrowIfNotConnected();
             return ackSystem.SendNotify(packet, offset, length);
         }
+        /// <summary>
+        /// Use <see cref="INotifyCallBack"/> version for non-alloc
+        /// </summary>
         public INotifyToken SendNotify(byte[] packet)
         {
             return SendNotify(packet, 0, packet.Length);
         }
+        /// <summary>
+        /// Use <see cref="INotifyCallBack"/> version for non-alloc
+        /// </summary>
         public INotifyToken SendNotify(ArraySegment<byte> packet)
         {
             return SendNotify(packet.Array, packet.Offset, packet.Count);
+        }
 
+        /// <summary>
+        /// Use <see cref="INotifyCallBack"/> version for non-alloc
+        /// </summary>
+        public void SendNotify(byte[] packet, int offset, int length, INotifyCallBack callBacks)
+        {
+            ThrowIfNotConnected();
+            ackSystem.SendNotify(packet, offset, length, callBacks);
+        }
+        /// <summary>
+        /// Use <see cref="INotifyCallBack"/> version for non-alloc
+        /// </summary>
+        public void SendNotify(byte[] packet, INotifyCallBack callBacks)
+        {
+            SendNotify(packet, 0, packet.Length, callBacks);
+        }
+        /// <summary>
+        /// Use <see cref="INotifyCallBack"/> version for non-alloc
+        /// </summary>
+        public void SendNotify(ArraySegment<byte> packet, INotifyCallBack callBacks)
+        {
+            SendNotify(packet.Array, packet.Offset, packet.Count, callBacks);
         }
 
 
diff --git a/Assets/Mirage/Runtime/SocketLayer/NotifyToken.cs b/Assets/Mirage/Runtime/SocketLayer/NotifyToken.cs
index 555d87b36fb..7501804b351 100644
--- a/Assets/Mirage/Runtime/SocketLayer/NotifyToken.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/NotifyToken.cs
@@ -3,8 +3,7 @@
 namespace Mirage.SocketLayer
 {
     /// <summary>
-    /// <summary>
-    /// Object returned from <see cref="NotifySystem.Send(byte[])"/> with events for when packet is Lost or Delivered
+    /// Object returned from <see cref="AckSystem.SendNotify"/> with events for when packet is Lost or Delivered
     /// </summary>
     public interface INotifyToken
     {
@@ -14,24 +13,53 @@ public interface INotifyToken
 
 
     /// <summary>
-    /// Object returned from <see cref="NotifySystem.Send(byte[])"/> with events for when packet is Lost or Delivered
+    /// Object returned from <see cref="AckSystem.SendNotify"/> with events for when packet is Lost or Delivered
     /// </summary>
-    public class NotifyToken : INotifyToken
+    public class NotifyToken : INotifyToken, INotifyCallBack
     {
         public event Action Delivered;
         public event Action Lost;
 
         bool notified;
 
-        internal void Notify(bool delivered)
+
+        public void OnDelivered()
         {
             if (notified) throw new InvalidOperationException("this token as already been notified");
             notified = true;
 
+            Delivered?.Invoke();
+        }
+
+        public void OnLost()
+        {
+            if (notified) throw new InvalidOperationException("this token as already been notified");
+            notified = true;
+
+            Lost?.Invoke();
+        }
+    }
+
+    public static class INotifyCallBackExtensions
+    {
+        public static void Notify(this INotifyCallBack callBack, bool delivered)
+        {
             if (delivered)
-                Delivered?.Invoke();
+                callBack.OnDelivered();
             else
-                Lost?.Invoke();
+                callBack.OnLost();
         }
     }
+
+    /// <summary>
+    /// Can be passed into <see cref="AckSystem.SendNotify(byte[], int, int, INotifyCallBack)"/> and methods will be invoked when notify is delivered or lost
+    /// <para>
+    /// See the Notify Example on how to use this interface
+    /// </para>
+    /// </summary>
+    public interface INotifyCallBack
+    {
+        void OnDelivered();
+        void OnLost();
+    }
 }
diff --git a/Assets/Mirage/Samples~/Notify.meta b/Assets/Mirage/Samples~/Notify.meta
new file mode 100644
index 00000000000..31ad15dc89d
--- /dev/null
+++ b/Assets/Mirage/Samples~/Notify.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: e79dd7e8e93f18340b2980e1e19e379b
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Samples~/Notify/Mirage.Examples.Notify.asmdef b/Assets/Mirage/Samples~/Notify/Mirage.Examples.Notify.asmdef
new file mode 100644
index 00000000000..a65ed4b98db
--- /dev/null
+++ b/Assets/Mirage/Samples~/Notify/Mirage.Examples.Notify.asmdef
@@ -0,0 +1,18 @@
+{
+    "name": "Mirage.Examples.Notify",
+    "references": [
+        "GUID:30817c1a0e6d646d99c048fc403f5979",
+        "GUID:f51ebe6a0ceec4240a699833d6309b23",
+        "GUID:96f081f4a0d214ee39e3aa34e9d43109",
+        "GUID:c0b2064c294eb174c9f3f7da398eb677"
+    ],
+    "includePlatforms": [],
+    "excludePlatforms": [],
+    "allowUnsafeCode": false,
+    "overrideReferences": false,
+    "precompiledReferences": [],
+    "autoReferenced": true,
+    "defineConstraints": [],
+    "versionDefines": [],
+    "noEngineReferences": false
+}
\ No newline at end of file
diff --git a/Assets/Mirage/Samples~/Notify/Mirage.Examples.Notify.asmdef.meta b/Assets/Mirage/Samples~/Notify/Mirage.Examples.Notify.asmdef.meta
new file mode 100644
index 00000000000..f54fc5aecaa
--- /dev/null
+++ b/Assets/Mirage/Samples~/Notify/Mirage.Examples.Notify.asmdef.meta
@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: 0bb55243d20dbfa4092a9881a92fc1ae
+AssemblyDefinitionImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Samples~/Notify/NotfyExample.cs b/Assets/Mirage/Samples~/Notify/NotfyExample.cs
new file mode 100644
index 00000000000..98965c22077
--- /dev/null
+++ b/Assets/Mirage/Samples~/Notify/NotfyExample.cs
@@ -0,0 +1,173 @@
+using System.Collections.Generic;
+using Mirage.Serialization;
+using Mirage.SocketLayer;
+
+namespace Mirage.Examples.Notify
+{
+    /// <summary>
+    /// This is an example of how to use Notify to send changes over unreliable
+    /// <para>
+    /// When using unreliable message they might not reach the other side,
+    /// You can use Notify so be told if the message is delivered or lost.<br/>
+    /// If you have some values or collection that changes every update you
+    /// might just want to send the changed values from that, using notify you
+    /// can tell which was the last update the other side received.
+    /// </para>
+    /// </summary>
+    public class SendChangesNotify
+    {
+        readonly INetworkPlayer player;
+        public List<float> someValues = new List<float>();
+        public int lastReceivedCount;
+
+        // pool for MyNotifyCallbacks so they can be re-used and not allocate
+        Stack<MyNotifyCallbacks> callbackPool = new Stack<MyNotifyCallbacks>();
+        MyNotifyCallbacks GetCallbacks()
+        {
+            if (callbackPool.Count > 0)
+            {
+                return callbackPool.Pop();
+            }
+            else
+            {
+                return new MyNotifyCallbacks(this);
+            }
+        }
+
+
+        public SendChangesNotify(INetworkPlayer player)
+        {
+            this.player = player;
+        }
+
+
+        public void Update(float newValue)
+        {
+            // some changes value or collection,
+            someValues.Add(newValue);
+
+            // create message and add new undelivered values
+            var message = new Changes
+            {
+                // Send Count so other side knows what values to expecct
+                valueCount = someValues.Count,
+                newValues = new List<float>(),
+            };
+
+            // add values from last know received
+            for (int i = lastReceivedCount; i < someValues.Count; i++)
+            {
+                message.newValues.Add(someValues[i]);
+            }
+
+            // get callback from pool and set count
+            MyNotifyCallbacks callbacks = GetCallbacks();
+            callbacks.valueCount = someValues.Count;
+
+            // send message and callbacks
+            SendNotify(message, callbacks);
+        }
+
+
+        /// <summary>
+        /// This function Packs a message and sends it to the player's connection, This function may be added to NetworkPlayer in the future
+        /// </summary>
+        /// <param name="message"></param>
+        /// <param name="callBacks"></param>
+        public void SendNotify(Changes message, INotifyCallBack callBacks)
+        {
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                MessagePacker.Pack(message, writer);
+
+                var segment = writer.ToArraySegment();
+                player.Connection.SendNotify(segment, callBacks);
+            }
+        }
+
+        // A message with changes
+        [NetworkMessage]
+        public struct Changes
+        {
+            // Note: using a list here will allocate, to avoid allocations use an array segment and write length + values
+
+            public int valueCount;
+            public List<float> newValues;
+        }
+
+        // A class that implements INotifyCallBack so the notify system can call methods when message is marked as lost or delieved
+        // This should not be a struct as it will cause the value to be boxed when pasted into SendNotify.
+        // A pool can be used to hold these so they can be re-used multiple times and avoid allocations
+        public class MyNotifyCallbacks : INotifyCallBack
+        {
+            readonly SendChangesNotify owner;
+            public int valueCount;
+
+            public MyNotifyCallbacks(SendChangesNotify owner)
+            {
+                this.owner = owner;
+            }
+
+            public void OnDelivered()
+            {
+                // if delivered is newer, then update it
+                if (owner.lastReceivedCount < valueCount)
+                {
+                    owner.lastReceivedCount = valueCount;
+                }
+
+                // return to pool so it can be re-used
+                owner.callbackPool.Push(this);
+            }
+
+            public void OnLost()
+            {
+                // nothing if lost
+
+                // return to pool so it can be re-used
+                owner.callbackPool.Push(this);
+            }
+        }
+    }
+
+    /// <summary>
+    /// This class does not show anything special for Notify but shows how you might receives an unreliable message
+    /// <para>
+    /// The new received values might have data that has already been received, so in this case you need to only take the new values from Changes and add them
+    /// </para>
+    /// <para>
+    /// If the server is receiving this message you will need to find the "someValues" and "lastReceivedCount" that belongs the the player first
+    /// </para>
+    /// </summary>
+    public class RecieveChangesNotify
+    {
+        public RecieveChangesNotify(IMessageReceiver receiver)
+        {
+            // Register Handler so that message can be received
+            receiver.RegisterHandler<SendChangesNotify.Changes>(HandleChange);
+        }
+
+        // if on client you can just have single pair of these values,
+        // but on server you will need a dictionary or another way to find the ones that belong to the player that sent the message
+        public List<float> someValues = new List<float>();
+        public int lastReceivedCount;
+
+        private void HandleChange(INetworkPlayer player, SendChangesNotify.Changes message)
+        {
+            // if server find values belonging to player
+
+            // work out how many new values there are
+            List<float> newValues = message.newValues;
+            int newCount = message.valueCount;
+
+            int numberOfNewValues = newCount - lastReceivedCount;
+            int offset = newValues.Count - numberOfNewValues;
+
+            // add new values to list
+            for (int i = offset; i < newValues.Count; i++)
+            {
+                someValues.Add(newValues[i]);
+            }
+        }
+    }
+}
diff --git a/Assets/Mirage/Samples~/Notify/NotfyExample.cs.meta b/Assets/Mirage/Samples~/Notify/NotfyExample.cs.meta
new file mode 100644
index 00000000000..a18adba1f37
--- /dev/null
+++ b/Assets/Mirage/Samples~/Notify/NotfyExample.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 4173e74014d2e0143a179a21e12d4eeb
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Editor/PipePeerConnectionTest.cs b/Assets/Tests/Editor/PipePeerConnectionTest.cs
index 90dc082117b..54557439f44 100644
--- a/Assets/Tests/Editor/PipePeerConnectionTest.cs
+++ b/Assets/Tests/Editor/PipePeerConnectionTest.cs
@@ -31,6 +31,10 @@ public INotifyToken SendNotify(byte[] data)
             {
                 return connection.SendNotify(data);
             }
+            public void SendNotify(byte[] data, INotifyCallBack callbacks)
+            {
+                connection.SendNotify(data, callbacks);
+            }
             public void ExpectData(byte[] expected)
             {
                 handler.Received(1).ReceiveMessage(connection, Arg.Is<ArraySegment<byte>>(x => x.SequenceEqual(expected)));
@@ -114,6 +118,24 @@ public void ReceivesNotifySentDataMultiple()
             conn2.ExpectData(new byte[] { 5, 6, 7, 8 });
         }
 
+        [Test]
+        public void ReceivesNotifyCallbacksSentData()
+        {
+            conn1.SendNotify(new byte[] { 1, 2, 3, 4 }, Substitute.For<INotifyCallBack>());
+
+            conn2.ExpectData(new byte[] { 1, 2, 3, 4 });
+        }
+
+        [Test]
+        public void ReceivesNotifyCallbacksSentDataMultiple()
+        {
+            conn1.SendNotify(new byte[] { 1, 2, 3, 4 }, Substitute.For<INotifyCallBack>());
+            conn1.SendNotify(new byte[] { 5, 6, 7, 8 }, Substitute.For<INotifyCallBack>());
+
+            conn2.ExpectData(new byte[] { 1, 2, 3, 4 });
+            conn2.ExpectData(new byte[] { 5, 6, 7, 8 });
+        }
+
         [Test]
         public void DisconnectShouldBeCalledOnBothConnections()
         {
@@ -196,6 +218,7 @@ public void NotifyTokenRemoveDeliveredHandlerDoesNothing()
             token.Delivered -= () => invoked1++;
             Assert.That(invoked1, Is.EqualTo(0), "Does nothing");
         }
+
         [Test]
         public void NotifyTokenAddLostHandlerDoesNothing()
         {
@@ -206,6 +229,7 @@ public void NotifyTokenAddLostHandlerDoesNothing()
             token.Lost += () => invoked1++;
             Assert.That(invoked1, Is.EqualTo(0), "Does nothing");
         }
+
         [Test]
         public void NotifyTokenRemoveLostHandlerDoesNothing()
         {
@@ -216,5 +240,15 @@ public void NotifyTokenRemoveLostHandlerDoesNothing()
             token.Lost -= () => invoked1++;
             Assert.That(invoked1, Is.EqualTo(0), "Does nothing");
         }
+
+        [Test]
+        public void NotifyCallbackShouldBeInvokedImmediately()
+        {
+            INotifyCallBack callbacks = Substitute.For<INotifyCallBack>();
+            conn1.SendNotify(new byte[] { 1, 2, 3, 4 }, callbacks);
+
+            callbacks.Received(1).OnDelivered();
+            callbacks.DidNotReceive().OnLost();
+        }
     }
 }
diff --git a/Assets/Tests/SocketLayer/PeerTestSendReceive.cs b/Assets/Tests/SocketLayer/PeerTestSendReceive.cs
index 5b1bb55333e..f5685997ade 100644
--- a/Assets/Tests/SocketLayer/PeerTestSendReceive.cs
+++ b/Assets/Tests/SocketLayer/PeerTestSendReceive.cs
@@ -207,6 +207,59 @@ public IEnumerator ClientNotifySendMarkedAsReceived()
             }
         }
 
+        [UnityTest]
+        public IEnumerator ServerNotifySendCallbacksMarkedAsReceived()
+        {
+            byte[] message = Enumerable.Range(10, 20).Select(x => (byte)x).ToArray();
+
+            var callBacks = new INotifyCallBack[ClientCount];
+            // send 1 message to each client
+            for (int i = 0; i < ClientCount; i++)
+            {
+                callBacks[i] = Substitute.For<INotifyCallBack>();
+                serverConnections[i].SendNotify(message, callBacks[i]);
+            }
+
+            float end = UnityEngine.Time.time + NotifyWaitTime;
+            while (end > UnityEngine.Time.time)
+            {
+                UpdateAll();
+                yield return null;
+            }
+
+            for (int i = 0; i < ClientCount; i++)
+            {
+                callBacks[i].Received(1).OnDelivered();
+                callBacks[i].DidNotReceive().OnLost();
+            }
+        }
+
+        [UnityTest]
+        public IEnumerator ClientNotifySendCallbacksMarkedAsReceived()
+        {
+            byte[] message = Enumerable.Range(10, 20).Select(x => (byte)x).ToArray();
+
+            var callBacks = new INotifyCallBack[ClientCount];
+            // send 1 message from each client
+            for (int i = 0; i < ClientCount; i++)
+            {
+                callBacks[i] = Substitute.For<INotifyCallBack>();
+                clientConnections[i].SendNotify(message, callBacks[i]);
+            }
+
+            float end = UnityEngine.Time.time + NotifyWaitTime;
+            while (end > UnityEngine.Time.time)
+            {
+                UpdateAll();
+                yield return null;
+            }
+
+            for (int i = 0; i < ClientCount; i++)
+            {
+                callBacks[i].Received(1).OnDelivered();
+                callBacks[i].DidNotReceive().OnLost();
+            }
+        }
 
         [Test]
         public void ServerReliableSend()

From e7ac06f972e089f53adc4a90ab90ade1fb309f05 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Fri, 6 Aug 2021 20:24:05 +0100
Subject: [PATCH 091/166] feat(peer): adding scripts to display metrics from
 peer (#872)

---
 Assets/Mirage/Components/DisplayMetrics.meta  |   8 +
 .../DisplayMetricsAverageGui.cs               | 100 +++++++++++++
 .../DisplayMetricsAverageGui.cs.meta          |  11 ++
 .../DisplayMetrics/RequestServerMetrics.cs    | 137 ++++++++++++++++++
 .../RequestServerMetrics.cs.meta              |  11 ++
 .../DisplayMetrics/SetDisplayMetrics.cs       |  30 ++++
 .../DisplayMetrics/SetDisplayMetrics.cs.meta  |  11 ++
 Assets/Mirage/Runtime/SocketLayer/Metrics.cs  |  10 +-
 8 files changed, 316 insertions(+), 2 deletions(-)
 create mode 100644 Assets/Mirage/Components/DisplayMetrics.meta
 create mode 100644 Assets/Mirage/Components/DisplayMetrics/DisplayMetricsAverageGui.cs
 create mode 100644 Assets/Mirage/Components/DisplayMetrics/DisplayMetricsAverageGui.cs.meta
 create mode 100644 Assets/Mirage/Components/DisplayMetrics/RequestServerMetrics.cs
 create mode 100644 Assets/Mirage/Components/DisplayMetrics/RequestServerMetrics.cs.meta
 create mode 100644 Assets/Mirage/Components/DisplayMetrics/SetDisplayMetrics.cs
 create mode 100644 Assets/Mirage/Components/DisplayMetrics/SetDisplayMetrics.cs.meta

diff --git a/Assets/Mirage/Components/DisplayMetrics.meta b/Assets/Mirage/Components/DisplayMetrics.meta
new file mode 100644
index 00000000000..b79b67a52b6
--- /dev/null
+++ b/Assets/Mirage/Components/DisplayMetrics.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: a8bfb26cf49a79c4abcf04dee6bed2a4
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Components/DisplayMetrics/DisplayMetricsAverageGui.cs b/Assets/Mirage/Components/DisplayMetrics/DisplayMetricsAverageGui.cs
new file mode 100644
index 00000000000..dc0d42a62b8
--- /dev/null
+++ b/Assets/Mirage/Components/DisplayMetrics/DisplayMetricsAverageGui.cs
@@ -0,0 +1,100 @@
+using Mirage.SocketLayer;
+using UnityEngine;
+
+namespace JamesFrowen.NetworkingBenchmark
+{
+    public class DisplayMetricsAverageGui : MonoBehaviour
+    {
+        public Metrics Metrics { get; set; }
+
+        public Rect offset = new Rect(10, 10, 400, 800);
+        public Color background;
+        GUIStyle style;
+
+
+
+        private void Start()
+        {
+            style = new GUIStyle();
+            var tex = new Texture2D(1, 1);
+            tex.SetPixel(0, 0, background);
+            tex.Apply();
+            style.normal.background = tex;
+        }
+
+        private void OnGUI()
+        {
+            if (Metrics == null) { return; }
+
+            using (new GUILayout.AreaScope(offset, GUIContent.none, style))
+            {
+                DrawAverage();
+            }
+        }
+        void DrawAverage()
+        {
+            double connectionCount = 0;
+
+            double sendCount = 0;
+            double sendBytes = 0;
+
+            double sendUnconnectedCount = 0;
+            double sendUnconnectedBytes = 0;
+
+            double resendCount = 0;
+            double resendBytes = 0;
+
+            double receiveCount = 0;
+            double receiveBytes = 0;
+
+            double receiveUnconnectedBytes = 0;
+            double receiveUnconnectedCount = 0;
+
+            Metrics.Frame[] array = Metrics.buffer;
+            int count = 0;
+            for (int i = 0; i < array.Length; i++)
+            {
+                if (!array[i].init)
+                {
+                    continue;
+                }
+
+                count++;
+                connectionCount += array[i].connectionCount;
+
+                sendCount += array[i].sendCount;
+                sendBytes += array[i].sendBytes;
+
+                sendUnconnectedCount += array[i].sendUnconnectedCount;
+                sendUnconnectedBytes += array[i].sendUnconnectedBytes;
+
+                resendCount += array[i].resendCount;
+                resendBytes += array[i].resendBytes;
+
+                receiveCount += array[i].receiveCount;
+                receiveBytes += array[i].receiveBytes;
+
+                receiveUnconnectedBytes += array[i].receiveUnconnectedBytes;
+                receiveUnconnectedCount += array[i].receiveUnconnectedCount;
+            }
+
+            GUILayout.Label($"connectionCount: {connectionCount / count:0.0}");
+            GUILayout.Space(8);
+            GUILayout.Label($"sendCount: {sendCount / count:0.0}");
+            GUILayout.Label($"sendBytes: {sendBytes / count:0.00}");
+            GUILayout.Space(8);
+            GUILayout.Label($"sendUnconnectedCount: {sendUnconnectedCount / count:0.0}");
+            GUILayout.Label($"sendUnconnectedBytes: {sendUnconnectedBytes / count:0.00}");
+            GUILayout.Space(8);
+            GUILayout.Label($"resendCount: {resendCount / count:0.0}");
+            GUILayout.Label($"resendBytes: {resendBytes / count:0.00}");
+            GUILayout.Space(8);
+            GUILayout.Label($"receiveCount: {receiveCount / count:0.0}");
+            GUILayout.Label($"receiveBytes: {receiveBytes / count:0.00}");
+            GUILayout.Space(8);
+            GUILayout.Label($"receiveUnconnectedCount: {receiveUnconnectedCount / count:0.0}");
+            GUILayout.Label($"receiveUnconnectedBytes: {receiveUnconnectedBytes / count:0.00}");
+
+        }
+    }
+}
diff --git a/Assets/Mirage/Components/DisplayMetrics/DisplayMetricsAverageGui.cs.meta b/Assets/Mirage/Components/DisplayMetrics/DisplayMetricsAverageGui.cs.meta
new file mode 100644
index 00000000000..99a9f22b753
--- /dev/null
+++ b/Assets/Mirage/Components/DisplayMetrics/DisplayMetricsAverageGui.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: fc574a7aad794bb4f92d506123548695
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Components/DisplayMetrics/RequestServerMetrics.cs b/Assets/Mirage/Components/DisplayMetrics/RequestServerMetrics.cs
new file mode 100644
index 00000000000..d14b2c060b3
--- /dev/null
+++ b/Assets/Mirage/Components/DisplayMetrics/RequestServerMetrics.cs
@@ -0,0 +1,137 @@
+using System;
+using System.Collections;
+using System.Collections.Generic;
+using Mirage;
+using Mirage.SocketLayer;
+using UnityEngine;
+
+namespace JamesFrowen.NetworkingBenchmark
+{
+    public class RequestServerMetrics : MonoBehaviour
+    {
+        public NetworkServer server;
+        public NetworkClient client;
+        public DisplayMetricsAverageGui displayMetrics;
+        public bool RequestMetrics = false;
+
+        /// <summary>
+        /// Connections that are requesting metrics
+        /// </summary>
+        HashSet<INetworkPlayer> connections;
+        private Metrics metrics;
+        uint lastSendTick;
+
+        private void Start()
+        {
+            if (RequestMetrics)
+            {
+                client.Connected.AddListener((x) => sendRequest());
+            }
+
+            server.Started.AddListener(ServerStarted);
+            StartCoroutine(Runner());
+        }
+
+        private void ServerStarted()
+        {
+            connections = new HashSet<INetworkPlayer>();
+
+            server.MessageHandler.RegisterHandler<RequestMetricsMessage>(OnRequestMetricsMessage);
+            server.Disconnected.AddListener(x => connections.Remove(x));
+        }
+
+        private void OnRequestMetricsMessage(INetworkPlayer arg1, RequestMetricsMessage arg2)
+        {
+            connections.Add(arg1);
+            if (metrics == null)
+            {
+                metrics = server.Metrics;
+                lastSendTick = metrics.tick;
+            }
+        }
+
+        private void sendRequest()
+        {
+            client.MessageHandler.RegisterHandler<SendMetricsMessage>(OnSendMetricsMessage);
+            client.Player.Send(new RequestMetricsMessage());
+            metrics = new Metrics();
+            displayMetrics.Metrics = metrics;
+        }
+
+        private void OnSendMetricsMessage(INetworkPlayer _, SendMetricsMessage msg)
+        {
+            for (uint i = 0; i < msg.newFrames.Length; i++)
+            {
+                ulong seq = metrics.Sequencer.MoveInBounds(i + msg.start);
+                metrics.buffer[seq] = msg.newFrames[i];
+            }
+        }
+
+        [NetworkMessage]
+        struct RequestMetricsMessage
+        {
+
+        }
+
+        [NetworkMessage]
+        struct SendMetricsMessage
+        {
+            public uint start;
+            public Metrics.Frame[] newFrames;
+        }
+
+        public IEnumerator Runner()
+        {
+            while (true)
+            {
+                try
+                {
+                    if (server.Active && connections.Count > 0) ServerUpdate();
+                    if (RequestMetrics && client.Active) ClientUpdate();
+                }
+                catch (Exception e)
+                {
+                    Debug.LogException(e);
+                }
+
+                yield return new WaitForSeconds(0.1f);
+            }
+        }
+        private void ServerUpdate()
+        {
+            var msg = new SendMetricsMessage
+            {
+                start = lastSendTick,
+                newFrames = getFrames(lastSendTick, metrics.tick)
+            };
+
+            foreach (INetworkPlayer player in connections)
+            {
+                player.Send(msg);
+            }
+        }
+
+        private Metrics.Frame[] getFrames(uint start, uint end)
+        {
+            long count = metrics.Sequencer.Distance(end, start);
+            // limit to 100 frames
+            if (count > 100) count = 100;
+
+            var frames = new Metrics.Frame[count];
+            for (uint i = 0; i < count; i++)
+            {
+                ulong seq = metrics.Sequencer.MoveInBounds(i + start);
+                frames[i] = metrics.buffer[seq];
+            }
+
+            lastSendTick = (uint)metrics.Sequencer.MoveInBounds(start + (uint)count);
+
+            return frames;
+        }
+
+        private void ClientUpdate()
+        {
+
+        }
+    }
+}
diff --git a/Assets/Mirage/Components/DisplayMetrics/RequestServerMetrics.cs.meta b/Assets/Mirage/Components/DisplayMetrics/RequestServerMetrics.cs.meta
new file mode 100644
index 00000000000..0e2876a486e
--- /dev/null
+++ b/Assets/Mirage/Components/DisplayMetrics/RequestServerMetrics.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 0a72d47940bf27744a731a75b77323b4
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Components/DisplayMetrics/SetDisplayMetrics.cs b/Assets/Mirage/Components/DisplayMetrics/SetDisplayMetrics.cs
new file mode 100644
index 00000000000..184539d6b24
--- /dev/null
+++ b/Assets/Mirage/Components/DisplayMetrics/SetDisplayMetrics.cs
@@ -0,0 +1,30 @@
+using Mirage;
+using UnityEngine;
+
+namespace JamesFrowen.NetworkingBenchmark
+{
+    public class SetDisplayMetrics : MonoBehaviour
+    {
+        public NetworkServer server;
+        public NetworkClient client;
+        public DisplayMetricsAverageGui displayMetrics;
+
+        private void Start()
+        {
+            if (server != null)
+                server.Started.AddListener(ServerStarted);
+            if (client != null)
+                client.Connected.AddListener(ClientConnected);
+        }
+
+        private void ServerStarted()
+        {
+            displayMetrics.Metrics = server.Metrics;
+        }
+
+        private void ClientConnected(INetworkPlayer arg0)
+        {
+            displayMetrics.Metrics = client.Metrics;
+        }
+    }
+}
diff --git a/Assets/Mirage/Components/DisplayMetrics/SetDisplayMetrics.cs.meta b/Assets/Mirage/Components/DisplayMetrics/SetDisplayMetrics.cs.meta
new file mode 100644
index 00000000000..e1c99f42078
--- /dev/null
+++ b/Assets/Mirage/Components/DisplayMetrics/SetDisplayMetrics.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 7c354427f6a5b2d4e85a2d7b3336615c
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Runtime/SocketLayer/Metrics.cs b/Assets/Mirage/Runtime/SocketLayer/Metrics.cs
index d42657c4ded..f519ebb6543 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Metrics.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Metrics.cs
@@ -20,7 +20,7 @@ public Metrics(int bitSize = 10)
         public void OnTick(int connectionCount)
         {
             tick = (uint)Sequencer.NextAfter(tick);
-            buffer[tick].Clear();
+            buffer[tick].Init();
             buffer[tick].connectionCount = connectionCount;
         }
 
@@ -63,6 +63,7 @@ public void OnReceiveUnconnected(int length)
 
         public class Frame
         {
+            public bool init;
             public int connectionCount;
 
             public int sendCount;
@@ -83,8 +84,13 @@ public class Frame
             //public int receiveMessagesCount;
             //public int receiveMessagesBytes;
 
-            internal void Clear()
+            /// <summary>
+            /// Clears frame ready to be used
+            /// </summary>
+            internal void Init()
             {
+                init = true;
+
                 sendCount = 0;
                 sendBytes = 0;
 

From f97a58280048bb608af0a726696cae1c38f53db2 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Fri, 6 Aug 2021 20:26:41 +0100
Subject: [PATCH 092/166] docs(weaver): adding doc comment WillProcess

---
 Assets/Mirage/Weaver/MirageILPostProcessor.cs | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/Assets/Mirage/Weaver/MirageILPostProcessor.cs b/Assets/Mirage/Weaver/MirageILPostProcessor.cs
index 2a2b529498b..6d09a92d1ae 100644
--- a/Assets/Mirage/Weaver/MirageILPostProcessor.cs
+++ b/Assets/Mirage/Weaver/MirageILPostProcessor.cs
@@ -38,7 +38,12 @@ public override ILPostProcessResult Process(ICompiledAssembly compiledAssembly)
             return new ILPostProcessResult(new InMemoryAssembly(pe.ToArray(), pdb.ToArray()), logger.Diagnostics);
         }
 
+        /// <summary>
+        /// Process when assembly that references Mirage
+        /// </summary>
+        /// <param name="compiledAssembly"></param>
+        /// <returns></returns>
         public override bool WillProcess(ICompiledAssembly compiledAssembly) =>
             compiledAssembly.References.Any(filePath => Path.GetFileNameWithoutExtension(filePath) == RuntimeAssemblyName);
     }
-}
\ No newline at end of file
+}

From a2254e0725133a4958e1ac53abb22629e407a565 Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Fri, 6 Aug 2021 19:40:22 +0000
Subject: [PATCH 093/166] chore(release): 101.1.0 [skip ci]

# [101.1.0](https://github.com/MirageNet/Mirage/compare/v101.0.2...v101.1.0) (2021-08-06)

### Features

* **peer:** adding scripts to display metrics from peer ([#872](https://github.com/MirageNet/Mirage/issues/872)) ([e7ac06f](https://github.com/MirageNet/Mirage/commit/e7ac06f972e089f53adc4a90ab90ade1fb309f05))
* adding way to call SendNotify without allocations and example ([#875](https://github.com/MirageNet/Mirage/issues/875)) ([16b3000](https://github.com/MirageNet/Mirage/commit/16b300002a28eff27bbc2d880993fd61271a4ab6))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs              | 2 +-
 Assets/Mirage/CHANGELOG.md                                | 8 ++++++++
 Assets/Mirage/Components/AssemblyInfo.cs                  | 2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                     | 2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs         | 2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs                    | 2 +-
 .../Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs     | 2 +-
 Assets/Mirage/package.json                                | 2 +-
 8 files changed, 15 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index cddfedcbc74..2dab9fd6f38 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.0.2")]
+[assembly: AssemblyVersion("101.1.0")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index 6d7b68822bf..0a04afe5e42 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,11 @@
+# [101.1.0](https://github.com/MirageNet/Mirage/compare/v101.0.2...v101.1.0) (2021-08-06)
+
+
+### Features
+
+* **peer:** adding scripts to display metrics from peer ([#872](https://github.com/MirageNet/Mirage/issues/872)) ([e7ac06f](https://github.com/MirageNet/Mirage/commit/e7ac06f972e089f53adc4a90ab90ade1fb309f05))
+* adding way to call SendNotify without allocations and example ([#875](https://github.com/MirageNet/Mirage/issues/875)) ([16b3000](https://github.com/MirageNet/Mirage/commit/16b300002a28eff27bbc2d880993fd61271a4ab6))
+
 ## [101.0.2](https://github.com/MirageNet/Mirage/compare/v101.0.1...v101.0.2) (2021-08-01)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index 6ce2ec628f2..92ba0c280b5 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.0.2")]
+[assembly: AssemblyVersion("101.1.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index d2727ce0522..0d7283b6a1f 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.0.2")]
+[assembly: AssemblyVersion("101.1.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index 6cc7b2f59cd..9db803f8ba8 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.0.2")]
+[assembly: AssemblyVersion("101.1.0")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index cddfedcbc74..2dab9fd6f38 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.0.2")]
+[assembly: AssemblyVersion("101.1.0")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index cddfedcbc74..2dab9fd6f38 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.0.2")]
+[assembly: AssemblyVersion("101.1.0")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 6e7280dce13..ab73ed9d042 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "101.0.2",
+    "version": "101.1.0",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From 641b2b005ea7fae6afaba98393344e067f530abf Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Tue, 10 Aug 2021 14:30:54 +0100
Subject: [PATCH 094/166] fix(NetworkReader): checking offset when moving bit
 position

Makes sure bit reader cant move position to before offset of given buffer.
---
 Assets/Mirage/Runtime/Serialization/NetworkReader.cs | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/Assets/Mirage/Runtime/Serialization/NetworkReader.cs b/Assets/Mirage/Runtime/Serialization/NetworkReader.cs
index 188865b2662..955388e932e 100644
--- a/Assets/Mirage/Runtime/Serialization/NetworkReader.cs
+++ b/Assets/Mirage/Runtime/Serialization/NetworkReader.cs
@@ -41,8 +41,11 @@ public unsafe class NetworkReader : IDisposable
         ulong* longPtr;
         bool needsDisposing;
 
-
+        /// <summary>Current read position</summary>
         int bitPosition;
+        /// <summary>Offset of given buffer</summary>
+        int bitOffset;
+        /// <summary>Length of given buffer</summary>
         int bitLength;
 
         /// <summary>
@@ -129,6 +132,7 @@ public void Reset(byte[] array, int position, int length)
             needsDisposing = true;
 
             bitPosition = position * 8;
+            bitOffset = position * 8;
             bitLength = bitPosition + (length * 8);
             managedBuffer = array;
             handle = GCHandle.Alloc(managedBuffer, GCHandleType.Pinned);
@@ -331,8 +335,13 @@ public ulong ReadAtPosition(int bits, int bitPosition)
         /// <para>WARNING: When reading from earlier position make sure to move position back to end of buffer after reading</para>
         /// </summary>
         /// <param name="newPosition"></param>
+        /// <exception cref="ArgumentOutOfRangeException">throws when <paramref name="newPosition"/> is less than <see cref="bitOffset"/></exception>
         public void MoveBitPosition(int newPosition)
         {
+            if (newPosition < bitOffset)
+            {
+                throw new ArgumentOutOfRangeException(nameof(newPosition), newPosition, $"New position can not be less than buffer offset, Buffer offset: {bitOffset}");
+            }
             CheckNewLength(newPosition);
             bitPosition = newPosition;
         }

From e91f6d34189159cb8d632949d7fceb7071c950f2 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Tue, 10 Aug 2021 14:31:39 +0100
Subject: [PATCH 095/166] feat: adding destroy function that takes network
 identity

---
 Assets/Mirage/Runtime/NetworkIdentity.cs     |  2 +-
 Assets/Mirage/Runtime/ServerObjectManager.cs | 50 +++++++++++++-------
 2 files changed, 34 insertions(+), 18 deletions(-)

diff --git a/Assets/Mirage/Runtime/NetworkIdentity.cs b/Assets/Mirage/Runtime/NetworkIdentity.cs
index d6e7d3111a1..9ee7f2e4d9c 100644
--- a/Assets/Mirage/Runtime/NetworkIdentity.cs
+++ b/Assets/Mirage/Runtime/NetworkIdentity.cs
@@ -670,7 +670,7 @@ void OnDestroy()
             // if it is still true, then we need to unspawn it
             if (IsServer)
             {
-                ServerObjectManager.Destroy(gameObject);
+                ServerObjectManager.Destroy(this);
             }
         }
 
diff --git a/Assets/Mirage/Runtime/ServerObjectManager.cs b/Assets/Mirage/Runtime/ServerObjectManager.cs
index 8cfe95658ae..7405c2697b2 100644
--- a/Assets/Mirage/Runtime/ServerObjectManager.cs
+++ b/Assets/Mirage/Runtime/ServerObjectManager.cs
@@ -546,6 +546,39 @@ static void ThrowIfPrefab(GameObject obj)
 #endif
         }
 
+        /// <summary>
+        /// Destroys this object and corresponding objects on all clients.
+        /// <param name="gameObject">Game object to destroy.</param>
+        /// <param name="destroyServerObject">Sets if server object will also be destroyed</param>
+        /// </summary>
+        public void Destroy(GameObject gameObject, bool destroyServerObject = true)
+        {
+            if (gameObject == null)
+            {
+                logger.Log("NetworkServer DestroyObject is null");
+                return;
+            }
+
+            NetworkIdentity identity = gameObject.GetNetworkIdentity();
+            DestroyObject(identity, destroyServerObject);
+        }
+
+        /// <summary>
+        /// Destroys this object and corresponding objects on all clients.
+        /// <param name="identity">Game object to destroy.</param>
+        /// <param name="destroyServerObject">Sets if server object will also be destroyed</param>
+        /// </summary>
+        public void Destroy(NetworkIdentity identity, bool destroyServerObject = true)
+        {
+            if (identity == null)
+            {
+                logger.Log("NetworkServer DestroyObject is null");
+                return;
+            }
+
+            DestroyObject(identity, destroyServerObject);
+        }
+
         void DestroyObject(NetworkIdentity identity, bool destroyServerObject)
         {
             if (logger.LogEnabled()) logger.Log("DestroyObject instance:" + identity.NetId);
@@ -571,23 +604,6 @@ void DestroyObject(NetworkIdentity identity, bool destroyServerObject)
             }
         }
 
-        /// <summary>
-        /// Destroys this object and corresponding objects on all clients.
-        /// <param name="obj">Game object to destroy.</param>
-        /// <param name="persistServerObject">In some cases it is useful to remove an object but not delete it on the server.</param>
-        /// </summary>
-        public void Destroy(GameObject obj, bool destroyServerObject = true)
-        {
-            if (obj == null)
-            {
-                logger.Log("NetworkServer DestroyObject is null");
-                return;
-            }
-
-            NetworkIdentity identity = obj.GetNetworkIdentity();
-            DestroyObject(identity, destroyServerObject);
-        }
-
         internal bool ValidateSceneObject(NetworkIdentity identity)
         {
             if (identity.gameObject.hideFlags == HideFlags.NotEditable ||

From 259e8d0dc736bf262fd6bde552618bb37daba31e Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Tue, 10 Aug 2021 14:32:11 +0100
Subject: [PATCH 096/166] fix: only invoking unspawn even if item was removed
 from dictionary

---
 Assets/Mirage/Runtime/NetworkWorld.cs | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/Assets/Mirage/Runtime/NetworkWorld.cs b/Assets/Mirage/Runtime/NetworkWorld.cs
index 94ae7c8fe9b..98390554416 100644
--- a/Assets/Mirage/Runtime/NetworkWorld.cs
+++ b/Assets/Mirage/Runtime/NetworkWorld.cs
@@ -45,17 +45,20 @@ internal void AddIdentity(uint netId, NetworkIdentity identity)
         internal void RemoveIdentity(NetworkIdentity identity)
         {
             uint netId = identity.NetId;
-            SpawnedObjects.Remove(netId);
-            onUnspawn?.Invoke(identity);
+            bool removed = SpawnedObjects.Remove(netId);
+            // only invoke event if values was successfully removed
+            if (removed)
+                onUnspawn?.Invoke(identity);
         }
         internal void RemoveIdentity(uint netId)
         {
             if (netId == 0) throw new ArgumentException("id can not be zero", nameof(netId));
 
-
             SpawnedObjects.TryGetValue(netId, out NetworkIdentity identity);
-            SpawnedObjects.Remove(netId);
-            onUnspawn?.Invoke(identity);
+            bool removed = SpawnedObjects.Remove(netId);
+            // only invoke event if values was successfully removed
+            if (removed)
+                onUnspawn?.Invoke(identity);
         }
 
 

From 719d58d512e2118da7af053e5ccbfe512a86f26f Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Tue, 10 Aug 2021 13:46:01 +0000
Subject: [PATCH 097/166] chore(release): 101.2.0 [skip ci]

# [101.2.0](https://github.com/MirageNet/Mirage/compare/v101.1.0...v101.2.0) (2021-08-10)

### Bug Fixes

* only invoking unspawn even if item was removed from dictionary ([259e8d0](https://github.com/MirageNet/Mirage/commit/259e8d0dc736bf262fd6bde552618bb37daba31e))
* **NetworkReader:** checking offset when moving bit position ([641b2b0](https://github.com/MirageNet/Mirage/commit/641b2b005ea7fae6afaba98393344e067f530abf))

### Features

* adding destroy function that takes network identity ([e91f6d3](https://github.com/MirageNet/Mirage/commit/e91f6d34189159cb8d632949d7fceb7071c950f2))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs        |  2 +-
 Assets/Mirage/CHANGELOG.md                          | 13 +++++++++++++
 Assets/Mirage/Components/AssemblyInfo.cs            |  2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs               |  2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs   |  2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs              |  2 +-
 .../RigidbodyPhysics/Scripts/AssemblyInfo.cs        |  2 +-
 Assets/Mirage/package.json                          |  2 +-
 8 files changed, 20 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index 2dab9fd6f38..2b1c921d169 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.1.0")]
+[assembly: AssemblyVersion("101.2.0")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index 0a04afe5e42..07ee33aed09 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,16 @@
+# [101.2.0](https://github.com/MirageNet/Mirage/compare/v101.1.0...v101.2.0) (2021-08-10)
+
+
+### Bug Fixes
+
+* only invoking unspawn even if item was removed from dictionary ([259e8d0](https://github.com/MirageNet/Mirage/commit/259e8d0dc736bf262fd6bde552618bb37daba31e))
+* **NetworkReader:** checking offset when moving bit position ([641b2b0](https://github.com/MirageNet/Mirage/commit/641b2b005ea7fae6afaba98393344e067f530abf))
+
+
+### Features
+
+* adding destroy function that takes network identity ([e91f6d3](https://github.com/MirageNet/Mirage/commit/e91f6d34189159cb8d632949d7fceb7071c950f2))
+
 # [101.1.0](https://github.com/MirageNet/Mirage/compare/v101.0.2...v101.1.0) (2021-08-06)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index 92ba0c280b5..339b12cd608 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.1.0")]
+[assembly: AssemblyVersion("101.2.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index 0d7283b6a1f..3e04ace8ba9 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.1.0")]
+[assembly: AssemblyVersion("101.2.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index 9db803f8ba8..8360628f363 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.1.0")]
+[assembly: AssemblyVersion("101.2.0")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index 2dab9fd6f38..2b1c921d169 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.1.0")]
+[assembly: AssemblyVersion("101.2.0")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index 2dab9fd6f38..2b1c921d169 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.1.0")]
+[assembly: AssemblyVersion("101.2.0")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index ab73ed9d042..2bc27546c67 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "101.1.0",
+    "version": "101.2.0",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From 8256328905deb00d9ec3985be69b773a23cdaf6c Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Thu, 12 Aug 2021 14:31:58 +0100
Subject: [PATCH 098/166] test: adding test to check disconnect is called
 before player is destroyed

---
 .../ClientServer/NetworkServerTests.cs        | 24 +++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/Assets/Tests/Runtime/ClientServer/NetworkServerTests.cs b/Assets/Tests/Runtime/ClientServer/NetworkServerTests.cs
index 1e5b338ff08..43ceb4b365d 100644
--- a/Assets/Tests/Runtime/ClientServer/NetworkServerTests.cs
+++ b/Assets/Tests/Runtime/ClientServer/NetworkServerTests.cs
@@ -170,5 +170,29 @@ public void VariableTest()
 
             func1.Received(1).Invoke();
         });
+
+        [UnityTest]
+        public IEnumerator DisconnectCalledBeforePlayerIsDestroyed()
+        {
+            INetworkPlayer serverPlayer = base.serverPlayer;
+            int disconnectCalled = 0;
+            server.Disconnected.AddListener(player =>
+            {
+                disconnectCalled++;
+                Assert.That(player, Is.EqualTo(serverPlayer));
+                // use unity null check
+                Assert.That(player.Identity != null);
+            });
+
+
+            client.Disconnect();
+            // wait a tick for messages to be processed
+            yield return null;
+
+            Assert.That(disconnectCalled, Is.EqualTo(1));
+            // use unity null check
+            Assert.That(serverPlayer.Identity == null);
+
+        }
     }
 }

From 410bcd6475e851dfd0a63944051f6522662f8e85 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Mon, 16 Aug 2021 14:05:16 +0100
Subject: [PATCH 099/166] feat: adding helper classes for packing float, vector
 and quaternion (#847)

* feat: quaternion packer

* new packers

* updating extensions

* deleting old compresion class

* adding vec2 packer

* bit helper and tests

* float packer constructor tests

* float packer tests

* fix: casting values to ulong so they arn't cut off if bit count is large

* quaternion packing tests

* reducing repeat count to 1000

* allowing extra precision

* tests for vector packers

* fixing code smell

* tests for pack extensions

* moving var int to its own file

* removing new function

* test for unpack

* fixing unpack test

* really fixing test

* removing un-used function
---
 .../Serialization/CompressedExtensions.cs     |  32 +++
 ...n.cs.meta => CompressedExtensions.cs.meta} |   2 +-
 .../Runtime/Serialization/Compression.cs      | 174 --------------
 .../Mirage/Runtime/Serialization/Packers.meta |   8 +
 .../Serialization/Packers/BitHelper.cs        |  42 ++++
 .../Serialization/Packers/BitHelper.cs.meta}  |   2 +-
 .../Serialization/Packers/FloatPacker.cs      | 197 ++++++++++++++++
 .../Serialization/Packers/FloatPacker.cs.meta |  11 +
 .../Serialization/Packers/QuaternionPacker.cs | 220 ++++++++++++++++++
 .../Packers/QuaternionPacker.cs.meta          |  11 +
 .../Serialization/Packers/Vector2Packer.cs    |  54 +++++
 .../Packers/Vector2Packer.cs.meta             |  11 +
 .../Serialization/Packers/Vector3Packer.cs    |  58 +++++
 .../Packers/Vector3Packer.cs.meta             |  11 +
 .../Runtime/Serialization/CompressionTests.cs |  55 -----
 .../Tests/Runtime/Serialization/Packers.meta  |   8 +
 .../Serialization/Packers/BitHelperTest.cs    |  21 ++
 .../Packers/BitHelperTest.cs.meta             |  11 +
 .../Packers/CompressionExtensionTests.cs      |  28 +++
 .../Packers/CompressionExtensionTests.cs.meta |  11 +
 .../Packers/FloatPackerCreateTest.cs          |  69 ++++++
 .../Packers/FloatPackerCreateTest.cs.meta     |  11 +
 .../Serialization/Packers/FloatPackerTests.cs | 129 ++++++++++
 .../Packers/FloatPackerTests.cs.meta          |  11 +
 .../Serialization/Packers/PackerTestBase.cs   |  28 +++
 .../Packers/PackerTestBase.cs.meta            |  11 +
 .../Packers/QuaternionPackerTests.cs          | 210 +++++++++++++++++
 .../Packers/QuaternionPackerTests.cs.meta     |  11 +
 .../Packers/Vector2PackerTests.cs             |  91 ++++++++
 .../Packers/Vector2PackerTests.cs.meta        |  11 +
 .../Packers/Vector3PackerTests.cs             |  96 ++++++++
 .../Packers/Vector3PackerTests.cs.meta        |  11 +
 32 files changed, 1425 insertions(+), 231 deletions(-)
 create mode 100644 Assets/Mirage/Runtime/Serialization/CompressedExtensions.cs
 rename Assets/Mirage/Runtime/Serialization/{Compression.cs.meta => CompressedExtensions.cs.meta} (83%)
 delete mode 100644 Assets/Mirage/Runtime/Serialization/Compression.cs
 create mode 100644 Assets/Mirage/Runtime/Serialization/Packers.meta
 create mode 100644 Assets/Mirage/Runtime/Serialization/Packers/BitHelper.cs
 rename Assets/{Tests/Runtime/Serialization/CompressionTests.cs.meta => Mirage/Runtime/Serialization/Packers/BitHelper.cs.meta} (83%)
 create mode 100644 Assets/Mirage/Runtime/Serialization/Packers/FloatPacker.cs
 create mode 100644 Assets/Mirage/Runtime/Serialization/Packers/FloatPacker.cs.meta
 create mode 100644 Assets/Mirage/Runtime/Serialization/Packers/QuaternionPacker.cs
 create mode 100644 Assets/Mirage/Runtime/Serialization/Packers/QuaternionPacker.cs.meta
 create mode 100644 Assets/Mirage/Runtime/Serialization/Packers/Vector2Packer.cs
 create mode 100644 Assets/Mirage/Runtime/Serialization/Packers/Vector2Packer.cs.meta
 create mode 100644 Assets/Mirage/Runtime/Serialization/Packers/Vector3Packer.cs
 create mode 100644 Assets/Mirage/Runtime/Serialization/Packers/Vector3Packer.cs.meta
 delete mode 100644 Assets/Tests/Runtime/Serialization/CompressionTests.cs
 create mode 100644 Assets/Tests/Runtime/Serialization/Packers.meta
 create mode 100644 Assets/Tests/Runtime/Serialization/Packers/BitHelperTest.cs
 create mode 100644 Assets/Tests/Runtime/Serialization/Packers/BitHelperTest.cs.meta
 create mode 100644 Assets/Tests/Runtime/Serialization/Packers/CompressionExtensionTests.cs
 create mode 100644 Assets/Tests/Runtime/Serialization/Packers/CompressionExtensionTests.cs.meta
 create mode 100644 Assets/Tests/Runtime/Serialization/Packers/FloatPackerCreateTest.cs
 create mode 100644 Assets/Tests/Runtime/Serialization/Packers/FloatPackerCreateTest.cs.meta
 create mode 100644 Assets/Tests/Runtime/Serialization/Packers/FloatPackerTests.cs
 create mode 100644 Assets/Tests/Runtime/Serialization/Packers/FloatPackerTests.cs.meta
 create mode 100644 Assets/Tests/Runtime/Serialization/Packers/PackerTestBase.cs
 create mode 100644 Assets/Tests/Runtime/Serialization/Packers/PackerTestBase.cs.meta
 create mode 100644 Assets/Tests/Runtime/Serialization/Packers/QuaternionPackerTests.cs
 create mode 100644 Assets/Tests/Runtime/Serialization/Packers/QuaternionPackerTests.cs.meta
 create mode 100644 Assets/Tests/Runtime/Serialization/Packers/Vector2PackerTests.cs
 create mode 100644 Assets/Tests/Runtime/Serialization/Packers/Vector2PackerTests.cs.meta
 create mode 100644 Assets/Tests/Runtime/Serialization/Packers/Vector3PackerTests.cs
 create mode 100644 Assets/Tests/Runtime/Serialization/Packers/Vector3PackerTests.cs.meta

diff --git a/Assets/Mirage/Runtime/Serialization/CompressedExtensions.cs b/Assets/Mirage/Runtime/Serialization/CompressedExtensions.cs
new file mode 100644
index 00000000000..aac452c12dc
--- /dev/null
+++ b/Assets/Mirage/Runtime/Serialization/CompressedExtensions.cs
@@ -0,0 +1,32 @@
+using System.Runtime.CompilerServices;
+using UnityEngine;
+
+namespace Mirage.Serialization
+{
+    public static class CompressedExtensions
+    {
+        /// <summary>
+        /// Packs Quaternion using <see cref="QuaternionPacker.Default9"/>
+        /// </summary>
+        /// <param name="writer"></param>
+        /// <param name="rotation"></param>
+        [WeaverIgnore]
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public static void PackRotation(this NetworkWriter writer, Quaternion rotation)
+        {
+            QuaternionPacker.Default9.Pack(writer, rotation);
+        }
+
+        /// <summary>
+        /// Unpacks Quaternion using <see cref="QuaternionPacker.Default9"/>
+        /// </summary>
+        /// <param name="reader"></param>
+        /// <returns></returns>
+        [WeaverIgnore]
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public static Quaternion UnpackRotation(this NetworkReader reader)
+        {
+            return QuaternionPacker.Default9.Unpack(reader);
+        }
+    }
+}
diff --git a/Assets/Mirage/Runtime/Serialization/Compression.cs.meta b/Assets/Mirage/Runtime/Serialization/CompressedExtensions.cs.meta
similarity index 83%
rename from Assets/Mirage/Runtime/Serialization/Compression.cs.meta
rename to Assets/Mirage/Runtime/Serialization/CompressedExtensions.cs.meta
index 717f7e90a10..fb1b742a8f2 100644
--- a/Assets/Mirage/Runtime/Serialization/Compression.cs.meta
+++ b/Assets/Mirage/Runtime/Serialization/CompressedExtensions.cs.meta
@@ -1,5 +1,5 @@
 fileFormatVersion: 2
-guid: 9aa04482b3d27456e97b974b18752f32
+guid: e54b019846572bd479a7f5d3b8e9e5d9
 MonoImporter:
   externalObjects: {}
   serializedVersion: 2
diff --git a/Assets/Mirage/Runtime/Serialization/Compression.cs b/Assets/Mirage/Runtime/Serialization/Compression.cs
deleted file mode 100644
index 95d2ea9c391..00000000000
--- a/Assets/Mirage/Runtime/Serialization/Compression.cs
+++ /dev/null
@@ -1,174 +0,0 @@
-using System;
-using UnityEngine;
-
-namespace Mirage.Serialization
-{
-    enum ComponentType : uint
-    {
-        X = 0,
-        Y = 1,
-        Z = 2,
-        W = 3
-    }
-
-    /// <summary>
-    ///     Credit to this man for converting gaffer games c code to c#
-    ///     https://gist.github.com/fversnel/0497ad7ab3b81e0dc1dd
-    /// </summary>
-    public static class Compression
-    {
-        // note: 1.0f / sqrt(2)
-        private const float Maximum = +1.0f / 1.414214f;
-
-        private const int BitsPerAxis = 10;
-        private const int LargestComponentShift = BitsPerAxis * 3;
-        private const int AShift = BitsPerAxis * 2;
-        private const int BShift = BitsPerAxis * 1;
-        private const int IntScale = (1 << (BitsPerAxis - 1)) - 1;
-        private const int IntMask = (1 << BitsPerAxis) - 1;
-
-        internal static uint Compress(Quaternion quaternion)
-        {
-            float absX = Mathf.Abs(quaternion.x);
-            float absY = Mathf.Abs(quaternion.y);
-            float absZ = Mathf.Abs(quaternion.z);
-            float absW = Mathf.Abs(quaternion.w);
-
-            ComponentType largestComponent = ComponentType.X;
-            float largestAbs = absX;
-            float largest = quaternion.x;
-
-            if (absY > largestAbs)
-            {
-                largestAbs = absY;
-                largestComponent = ComponentType.Y;
-                largest = quaternion.y;
-            }
-            if (absZ > largestAbs)
-            {
-                largestAbs = absZ;
-                largestComponent = ComponentType.Z;
-                largest = quaternion.z;
-            }
-            if (absW > largestAbs)
-            {
-                largestComponent = ComponentType.W;
-                largest = quaternion.w;
-            }
-
-            float a = 0;
-            float b = 0;
-            float c = 0;
-            switch (largestComponent)
-            {
-                case ComponentType.X:
-                    a = quaternion.y;
-                    b = quaternion.z;
-                    c = quaternion.w;
-                    break;
-                case ComponentType.Y:
-                    a = quaternion.x;
-                    b = quaternion.z;
-                    c = quaternion.w;
-                    break;
-                case ComponentType.Z:
-                    a = quaternion.x;
-                    b = quaternion.y;
-                    c = quaternion.w;
-                    break;
-                case ComponentType.W:
-                    a = quaternion.x;
-                    b = quaternion.y;
-                    c = quaternion.z;
-                    break;
-            }
-
-            if (largest < 0)
-            {
-                a = -a;
-                b = -b;
-                c = -c;
-            }
-
-            uint integerA = ScaleToUint(a);
-            uint integerB = ScaleToUint(b);
-            uint integerC = ScaleToUint(c);
-
-            return (((uint)largestComponent) << LargestComponentShift) | (integerA << AShift) | (integerB << BShift) | integerC;
-        }
-
-        private static uint ScaleToUint(float v)
-        {
-            float normalized = v / Maximum;
-            return (uint)Mathf.RoundToInt(normalized * IntScale) & IntMask;
-        }
-
-        private static float ScaleToFloat(uint v)
-        {
-            float unscaled = v * Maximum / IntScale;
-
-            if (unscaled > Maximum)
-                unscaled -= Maximum * 2;
-            return unscaled;
-        }
-
-        internal static Quaternion Decompress(uint compressed)
-        {
-            var largestComponentType = (ComponentType)(compressed >> LargestComponentShift);
-            uint integerA = (compressed >> AShift) & IntMask;
-            uint integerB = (compressed >> BShift) & IntMask;
-            uint integerC = compressed & IntMask;
-
-            float a = ScaleToFloat(integerA);
-            float b = ScaleToFloat(integerB);
-            float c = ScaleToFloat(integerC);
-
-            Quaternion rotation;
-            switch (largestComponentType)
-            {
-                case ComponentType.X:
-                    // (?) y z w
-                    rotation.y = a;
-                    rotation.z = b;
-                    rotation.w = c;
-                    rotation.x = Mathf.Sqrt(1 - rotation.y * rotation.y
-                                               - rotation.z * rotation.z
-                                               - rotation.w * rotation.w);
-                    break;
-                case ComponentType.Y:
-                    // x (?) z w
-                    rotation.x = a;
-                    rotation.z = b;
-                    rotation.w = c;
-                    rotation.y = Mathf.Sqrt(1 - rotation.x * rotation.x
-                                               - rotation.z * rotation.z
-                                               - rotation.w * rotation.w);
-                    break;
-                case ComponentType.Z:
-                    // x y (?) w
-                    rotation.x = a;
-                    rotation.y = b;
-                    rotation.w = c;
-                    rotation.z = Mathf.Sqrt(1 - rotation.x * rotation.x
-                                               - rotation.y * rotation.y
-                                               - rotation.w * rotation.w);
-                    break;
-                case ComponentType.W:
-                    // x y z (?)
-                    rotation.x = a;
-                    rotation.y = b;
-                    rotation.z = c;
-                    rotation.w = Mathf.Sqrt(1 - rotation.x * rotation.x
-                                               - rotation.y * rotation.y
-                                               - rotation.z * rotation.z);
-                    break;
-                default:
-                    // Should never happen!
-                    throw new ArgumentOutOfRangeException("Unknown rotation component type: " +
-                                                          largestComponentType);
-            }
-
-            return rotation;
-        }
-    }
-}
\ No newline at end of file
diff --git a/Assets/Mirage/Runtime/Serialization/Packers.meta b/Assets/Mirage/Runtime/Serialization/Packers.meta
new file mode 100644
index 00000000000..53137666e62
--- /dev/null
+++ b/Assets/Mirage/Runtime/Serialization/Packers.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: e03145f2f2f871240898ac758b603d7c
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Runtime/Serialization/Packers/BitHelper.cs b/Assets/Mirage/Runtime/Serialization/Packers/BitHelper.cs
new file mode 100644
index 00000000000..a689ec0f1d3
--- /dev/null
+++ b/Assets/Mirage/Runtime/Serialization/Packers/BitHelper.cs
@@ -0,0 +1,42 @@
+/*
+MIT License
+
+Copyright (c) 2021 James Frowen
+
+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.
+*/
+
+using UnityEngine;
+
+namespace Mirage.Serialization
+{
+    public static class BitHelper
+    {
+        /// <summary>
+        /// Gets the number of bits need for <paramref name="precision"/> in range negative to positive <paramref name="max"/>
+        /// </summary>
+        /// <param name="max"></param>
+        /// <param name="precision">lowest precision required, bit count will round up so real precision might be higher</param>
+        /// <returns></returns>
+        public static int BitCount(float max, float precision)
+        {
+            return Mathf.CeilToInt(Mathf.Log(2 * max / precision, 2));
+        }
+    }
+}
diff --git a/Assets/Tests/Runtime/Serialization/CompressionTests.cs.meta b/Assets/Mirage/Runtime/Serialization/Packers/BitHelper.cs.meta
similarity index 83%
rename from Assets/Tests/Runtime/Serialization/CompressionTests.cs.meta
rename to Assets/Mirage/Runtime/Serialization/Packers/BitHelper.cs.meta
index 15a5afdfda4..0657489b2f1 100644
--- a/Assets/Tests/Runtime/Serialization/CompressionTests.cs.meta
+++ b/Assets/Mirage/Runtime/Serialization/Packers/BitHelper.cs.meta
@@ -1,5 +1,5 @@
 fileFormatVersion: 2
-guid: 4220775e22e344aa2a78bac42cbcbadf
+guid: 1ba9a01829f61d6428bb3e276ac9272a
 MonoImporter:
   externalObjects: {}
   serializedVersion: 2
diff --git a/Assets/Mirage/Runtime/Serialization/Packers/FloatPacker.cs b/Assets/Mirage/Runtime/Serialization/Packers/FloatPacker.cs
new file mode 100644
index 00000000000..800f7d5c5e5
--- /dev/null
+++ b/Assets/Mirage/Runtime/Serialization/Packers/FloatPacker.cs
@@ -0,0 +1,197 @@
+/*
+MIT License
+
+Copyright (c) 2021 James Frowen
+
+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.
+*/
+
+using System;
+using System.Runtime.CompilerServices;
+using UnityEngine;
+
+namespace Mirage.Serialization
+{
+
+    /// <summary>
+    /// Helps compresses a float into a reduced number of bits
+    /// </summary>
+    public sealed class FloatPacker
+    {
+        readonly int bitCount;
+        readonly float multiplier_pack;
+        readonly float multiplier_unpack;
+        readonly uint mask;
+        readonly int toNegative;
+
+        /// <summary>max positive value, any uint value over this will be negative</summary>
+        readonly uint midPoint;
+        readonly float positiveMax;
+        readonly float negativeMax;
+
+        /// <param name="max"></param>
+        /// <param name="lowestPrecision">lowest precision, actual precision will be caculated from number of bits used</param>
+        public FloatPacker(float max, float lowestPrecision) : this(max, BitHelper.BitCount(max, lowestPrecision)) { }
+
+        /// <summary>
+        /// Create a new instance using bit count
+        /// </summary>
+        /// <param name="max"></param>
+        /// <param name="lowestPrecision">lowest precision, actual precision will be caculated from number of bits used</param>
+        public static FloatPacker FromBitCount(float max, int bitCount)
+        {
+            return new FloatPacker(max, bitCount);
+        }
+        /// <summary>
+        /// 
+        /// </summary>
+        /// <param name="max"></param>
+        /// <param name="lowestPrecision">lowest precision, actual precision will be caculated from number of bits used</param>
+        private FloatPacker(float max, int bitCount)
+        {
+            this.bitCount = bitCount;
+            // not sure what max bit count should be,
+            // but 30 seems reasonable since an unpacked float is already 32
+            if (max == 0) throw new ArgumentException("Max can not be 0", nameof(max));
+            if (bitCount < 1) throw new ArgumentException("Bit count is too low, bit count should be between 1 and 30", nameof(bitCount));
+            if (bitCount > 30) throw new ArgumentException("Bit count is too high, bit count should be between 1 and 30", nameof(bitCount));
+
+            midPoint = (1u << (bitCount - 1)) - 1u;
+            multiplier_pack = midPoint / max;
+            multiplier_unpack = 1 / multiplier_pack;
+            mask = (1u << bitCount) - 1u;
+            toNegative = (int)(mask + 1u);
+
+            positiveMax = max;
+            negativeMax = -max;
+        }
+
+
+        /// <summary>
+        /// Packs a float value into a uint
+        /// <para>Clamps the value within min/max range</para>
+        /// </summary>
+        /// <param name="value"></param>
+        /// <returns></returns>
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public uint Pack(float value)
+        {
+            if (value >= positiveMax) value = positiveMax;
+            if (value <= negativeMax) value = negativeMax;
+            return PackNoClamp(value);
+        }
+
+        /// <summary>
+        /// Packs and Writes a float value
+        /// <para>Clamps the value within min/max range</para>
+        /// </summary>
+        /// <param name="value"></param>
+        /// <returns></returns>
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public void Pack(NetworkWriter writer, float value)
+        {
+            if (value >= positiveMax) value = positiveMax;
+            if (value <= negativeMax) value = negativeMax;
+            PackNoClamp(writer, value);
+        }
+
+        /// <summary>
+        /// Packs a float value into a uint without clamping it in range
+        /// <para>
+        /// WARNING: only use this method if value is always in range. Out of range values may not be unpacked correctly
+        /// </para>
+        /// </summary>
+        /// <param name="value"></param>
+        /// <returns></returns>
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public uint PackNoClamp(float value)
+        {
+            return (uint)Mathf.RoundToInt(value * multiplier_pack) & mask;
+        }
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public void PackNoClamp(NetworkWriter writer, float value)
+        {
+            // dont need to mask value here because the Write function will mask it
+            writer.Write((uint)Mathf.RoundToInt(value * multiplier_pack), bitCount);
+        }
+
+
+        /// <summary>
+        /// Unpacks uint value to float
+        /// </summary>
+        /// <param name="value"></param>
+        /// <returns></returns>
+        /// <remarks>
+        /// Positive and Negative values need to be unpacked differnely so that they both keep same precision
+        /// <para>
+        ///     <b>Example 10 bits (max uint = 1023):</b>
+        ///     <br />
+        ///     p = precision
+        ///     <para>
+        ///         Positive values have uint range <c>0 to 511</c>
+        ///         <br />
+        ///         Unpacked: <c>0 to max</c>
+        ///     </para>
+        ///     <para>
+        ///         Negative values have uint range <c>512 to 1023</c>
+        ///         <br />
+        ///         Unpacked using same as positive: <c>max+p to max*2+p</c>
+        ///         <br />
+        ///         but we want range <c>-max to -p</c>
+        ///         <br />
+        ///         so we need to subtrack <c>-1024</c> so range is <c>-512 to -1</c>
+        ///         <br />
+        ///         then scale to unpack to <c>-max to -p</c>
+        ///     </para>
+        /// </para>
+        /// </remarks>
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public float Unpack(uint value)
+        {
+            if (value <= midPoint) // positive
+            {
+                // 0 -> 511
+                // 0 -> (max)
+                return value * multiplier_unpack;
+            }
+            else // negative
+            {
+                // max = 1024
+                // 512 -> 1023
+                // -max -> 0
+
+                // doing `value - max*2` cause:
+                // -512 -> -1
+                return ((int)value - toNegative) * multiplier_unpack;
+            }
+        }
+
+        /// <summary>
+        /// Reads and unpacks float value
+        /// </summary>
+        /// <param name="reader"></param>
+        /// <returns></returns>
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public float Unpack(NetworkReader reader)
+        {
+            return Unpack((uint)reader.Read(bitCount));
+        }
+    }
+}
diff --git a/Assets/Mirage/Runtime/Serialization/Packers/FloatPacker.cs.meta b/Assets/Mirage/Runtime/Serialization/Packers/FloatPacker.cs.meta
new file mode 100644
index 00000000000..96ed6882033
--- /dev/null
+++ b/Assets/Mirage/Runtime/Serialization/Packers/FloatPacker.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: f44847fc059d5464eba7bd04088ddfa1
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Runtime/Serialization/Packers/QuaternionPacker.cs b/Assets/Mirage/Runtime/Serialization/Packers/QuaternionPacker.cs
new file mode 100644
index 00000000000..e021535a9a6
--- /dev/null
+++ b/Assets/Mirage/Runtime/Serialization/Packers/QuaternionPacker.cs
@@ -0,0 +1,220 @@
+/*
+MIT License
+
+Copyright (c) 2021 James Frowen
+
+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.
+*/
+
+using System;
+using System.Runtime.CompilerServices;
+using UnityEngine;
+
+namespace Mirage.Serialization
+{
+    public sealed class QuaternionPacker
+    {
+        /// <summary>Default packer using 9 bits per element, 29 bits total</summary>
+        public static readonly QuaternionPacker Default9 = new QuaternionPacker(9);
+        /// <summary>Default packer using 10 bits per element, 32 bits total</summary>
+        public static readonly QuaternionPacker Default10 = new QuaternionPacker(10);
+
+        /// <summary>
+        /// 1 / sqrt(2)
+        /// </summary>
+        const float MaxValue = 1f / 1.414214f;
+
+        /// <summary>
+        /// bit count per element writen
+        /// </summary>
+        readonly int bitCountPerElement;
+
+        /// <summary>
+        /// total bit count for Quaternion
+        /// <para>
+        /// count = 3 * perElement + 2;
+        /// </para>
+        /// </summary>
+        readonly int totalBitCount;
+        readonly uint readMask;
+
+        readonly FloatPacker floatPacker;
+
+        /// <param name="quaternionBitLength">10 per "smallest 3" is good enough for most people</param>
+        public QuaternionPacker(int quaternionBitLength = 10)
+        {
+            // (this.BitLength - 1) because pack sign by itself
+            bitCountPerElement = quaternionBitLength;
+            totalBitCount = 2 + (quaternionBitLength * 3);
+            floatPacker = FloatPacker.FromBitCount(MaxValue, quaternionBitLength);
+            readMask = (uint)BitMask.Mask(bitCountPerElement);
+        }
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public void Pack(NetworkWriter writer, Quaternion _value)
+        {
+            QuickNormalize(ref _value);
+
+            FindLargestIndex(ref _value, out uint index);
+
+            GetSmallerDimensions(index, ref _value, out float a, out float b, out float c);
+
+            // largest needs to be positive to be calculated by reader 
+            // if largest is negative flip sign of others because Q = -Q
+            if (_value[(int)index] < 0)
+            {
+                a = -a;
+                b = -b;
+                c = -c;
+            }
+
+            // todo, should we be rounding down for abc? because if they are rounded up their sum may be greater than largest
+
+            writer.Write(
+                 (ulong)index << bitCountPerElement * 3 |
+                 (ulong)floatPacker.PackNoClamp(a) << bitCountPerElement * 2 |
+                 (ulong)floatPacker.PackNoClamp(b) << bitCountPerElement |
+                 floatPacker.PackNoClamp(c),
+                 totalBitCount);
+        }
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        internal static void QuickNormalize(ref Quaternion quaternion)
+        {
+            float dot =
+                (quaternion.x * quaternion.x) +
+                (quaternion.y * quaternion.y) +
+                (quaternion.z * quaternion.z) +
+                (quaternion.w * quaternion.w);
+
+            const float allowedEpsilon = 1E-5f;
+            const float minAllowed = 1 - allowedEpsilon;
+            const float maxAllowed = 1 + allowedEpsilon;
+            // only normalize if dot product is outside allowed range
+            if (minAllowed > dot || maxAllowed < dot)
+            {
+                float dotSqrt = (float)Math.Sqrt(dot);
+                // rotation is 0
+                if (dotSqrt < allowedEpsilon)
+                {
+                    // identity
+                    quaternion.x = 0;
+                    quaternion.y = 0;
+                    quaternion.z = 0;
+                    quaternion.w = 1;
+                }
+                else
+                {
+                    float iDotSqrt = 1 / dotSqrt;
+                    quaternion.x *= iDotSqrt;
+                    quaternion.y *= iDotSqrt;
+                    quaternion.z *= iDotSqrt;
+                    quaternion.w *= iDotSqrt;
+                }
+            }
+        }
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        internal static void FindLargestIndex(ref Quaternion quaternion, out uint index)
+        {
+            float x2 = quaternion.x * quaternion.x;
+            float y2 = quaternion.y * quaternion.y;
+            float z2 = quaternion.z * quaternion.z;
+            float w2 = quaternion.w * quaternion.w;
+
+            index = 0;
+            float current = x2;
+            // check vs sq to avoid doing mathf.abs
+            if (y2 > current)
+            {
+                index = 1;
+                current = y2;
+            }
+            if (z2 > current)
+            {
+                index = 2;
+                current = z2;
+            }
+            if (w2 > current)
+            {
+                index = 3;
+            }
+        }
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        static void GetSmallerDimensions(uint largestIndex, ref Quaternion quaternion, out float a, out float b, out float c)
+        {
+            switch (largestIndex)
+            {
+                case 0:
+                    a = quaternion.y;
+                    b = quaternion.z;
+                    c = quaternion.w;
+                    return;
+                case 1:
+                    a = quaternion.x;
+                    b = quaternion.z;
+                    c = quaternion.w;
+                    return;
+                case 2:
+                    a = quaternion.x;
+                    b = quaternion.y;
+                    c = quaternion.w;
+                    return;
+                case 3:
+                    a = quaternion.x;
+                    b = quaternion.y;
+                    c = quaternion.z;
+                    return;
+                default:
+                    throw new IndexOutOfRangeException("Invalid Quaternion index!");
+            }
+        }
+
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public Quaternion Unpack(NetworkReader reader)
+        {
+            ulong combine = reader.Read(totalBitCount);
+
+            uint index = (uint)(combine >> bitCountPerElement * 3);
+
+            float a = floatPacker.Unpack((uint)(combine >> bitCountPerElement * 2) & readMask);
+            float b = floatPacker.Unpack((uint)(combine >> bitCountPerElement * 1) & readMask);
+            float c = floatPacker.Unpack((uint)combine & readMask);
+
+            float l2 = 1 - ((a * a) + (b * b) + (c * c));
+            float largest = (float)Math.Sqrt(l2);
+            // this Quaternion should already be normallized because of the way that largest is calculated
+            switch (index)
+            {
+                case 0:
+                    return new Quaternion(largest, a, b, c);
+                case 1:
+                    return new Quaternion(a, largest, b, c);
+                case 2:
+                    return new Quaternion(a, b, largest, c);
+                case 3:
+                    return new Quaternion(a, b, c, largest);
+                default:
+                    throw new IndexOutOfRangeException("Invalid Quaternion index!");
+            }
+        }
+    }
+}
diff --git a/Assets/Mirage/Runtime/Serialization/Packers/QuaternionPacker.cs.meta b/Assets/Mirage/Runtime/Serialization/Packers/QuaternionPacker.cs.meta
new file mode 100644
index 00000000000..04f64998a0f
--- /dev/null
+++ b/Assets/Mirage/Runtime/Serialization/Packers/QuaternionPacker.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 62c06dfd1d38c294badc710697aff611
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Runtime/Serialization/Packers/Vector2Packer.cs b/Assets/Mirage/Runtime/Serialization/Packers/Vector2Packer.cs
new file mode 100644
index 00000000000..f2b3019daad
--- /dev/null
+++ b/Assets/Mirage/Runtime/Serialization/Packers/Vector2Packer.cs
@@ -0,0 +1,54 @@
+/*
+MIT License
+
+Copyright (c) 2021 James Frowen
+
+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.
+*/
+
+using UnityEngine;
+
+namespace Mirage.Serialization
+{
+    public sealed class Vector2Packer
+    {
+        readonly FloatPacker xPacker;
+        readonly FloatPacker yPacker;
+
+        public Vector2Packer(Vector2 max, Vector2 precision)
+        {
+            xPacker = new FloatPacker(max.x, precision.x);
+            yPacker = new FloatPacker(max.y, precision.y);
+        }
+
+        public void Pack(NetworkWriter writer, Vector2 value)
+        {
+            xPacker.Pack(writer, value.x);
+            yPacker.Pack(writer, value.y);
+        }
+
+        public Vector2 Unpack(NetworkReader reader)
+        {
+            Vector2 value = default;
+            value.x = xPacker.Unpack(reader);
+            value.y = yPacker.Unpack(reader);
+            return value;
+        }
+    }
+}
diff --git a/Assets/Mirage/Runtime/Serialization/Packers/Vector2Packer.cs.meta b/Assets/Mirage/Runtime/Serialization/Packers/Vector2Packer.cs.meta
new file mode 100644
index 00000000000..bb5a5845a5c
--- /dev/null
+++ b/Assets/Mirage/Runtime/Serialization/Packers/Vector2Packer.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: a26a59a805a1d6e47a9e41a9aa5e8108
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Runtime/Serialization/Packers/Vector3Packer.cs b/Assets/Mirage/Runtime/Serialization/Packers/Vector3Packer.cs
new file mode 100644
index 00000000000..eea88ab2517
--- /dev/null
+++ b/Assets/Mirage/Runtime/Serialization/Packers/Vector3Packer.cs
@@ -0,0 +1,58 @@
+/*
+MIT License
+
+Copyright (c) 2021 James Frowen
+
+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.
+*/
+
+using UnityEngine;
+
+namespace Mirage.Serialization
+{
+    public sealed class Vector3Packer
+    {
+        readonly FloatPacker xPacker;
+        readonly FloatPacker yPacker;
+        readonly FloatPacker zPacker;
+
+        public Vector3Packer(Vector3 max, Vector3 precision)
+        {
+            xPacker = new FloatPacker(max.x, precision.x);
+            yPacker = new FloatPacker(max.y, precision.y);
+            zPacker = new FloatPacker(max.z, precision.z);
+        }
+
+        public void Pack(NetworkWriter writer, Vector3 value)
+        {
+            xPacker.Pack(writer, value.x);
+            yPacker.Pack(writer, value.y);
+            zPacker.Pack(writer, value.z);
+        }
+
+        public Vector3 Unpack(NetworkReader reader)
+        {
+            Vector3 value = default;
+            value.x = xPacker.Unpack(reader);
+            value.y = yPacker.Unpack(reader);
+            value.z = zPacker.Unpack(reader);
+            return value;
+        }
+    }
+}
diff --git a/Assets/Mirage/Runtime/Serialization/Packers/Vector3Packer.cs.meta b/Assets/Mirage/Runtime/Serialization/Packers/Vector3Packer.cs.meta
new file mode 100644
index 00000000000..eb1da2cad21
--- /dev/null
+++ b/Assets/Mirage/Runtime/Serialization/Packers/Vector3Packer.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: d2f6b7a4b33422e47b03898a06a14c7d
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Runtime/Serialization/CompressionTests.cs b/Assets/Tests/Runtime/Serialization/CompressionTests.cs
deleted file mode 100644
index c188518977c..00000000000
--- a/Assets/Tests/Runtime/Serialization/CompressionTests.cs
+++ /dev/null
@@ -1,55 +0,0 @@
-using Mirage.Serialization;
-using NUnit.Framework;
-using UnityEngine;
-using RangeAttribute = NUnit.Framework.RangeAttribute;
-
-namespace Mirage.Tests.Runtime.Serialization
-{
-    public class CompressionTests
-    {
-        [Test]
-        [Repeat(100)]
-        public void QuaternionCompression()
-        {
-            Quaternion expected = Random.rotation;
-
-            uint compressed = Compression.Compress(expected);
-
-            Quaternion decompressed = Compression.Decompress(compressed);
-
-            // decompressed should be almost the same,  dot product of 2 normalized quaternion is 1 if they are the same
-            Assert.That(Mathf.Abs(Quaternion.Dot(expected, decompressed)), Is.EqualTo(1).Within(0.001));
-        }
-
-        [Test]
-        public void Compress90Degrees()
-        {
-            uint compressed = Compression.Compress(Quaternion.Euler(0, 90, 0));
-
-            Quaternion decompressed = Compression.Decompress(compressed);
-
-            Vector3 euler = decompressed.eulerAngles;
-            Assert.That(euler.x, Is.Zero);
-            Assert.That(euler.y, Is.EqualTo(90).Within(0.1));
-            Assert.That(euler.z, Is.Zero);
-        }
-
-        [Test]
-        public void CompressCornerCases(
-            [Range(0, 360, 45)] int x,
-            [Range(0, 360, 45)] int y,
-            [Range(0, 360, 45)] int z
-            )
-        {
-            var expected = Quaternion.Euler(x, y, z);
-
-            uint compressed = Compression.Compress(Quaternion.Euler(x, y, z));
-
-            Quaternion decompressed = Compression.Decompress(compressed);
-
-            // decompressed should be almost the same,  dot product of 2 normalized quaternion is 1 if they are the same
-            Assert.That(Mathf.Abs(Quaternion.Dot(expected, decompressed)), Is.EqualTo(1).Within(0.001));
-
-        }
-    }
-}
diff --git a/Assets/Tests/Runtime/Serialization/Packers.meta b/Assets/Tests/Runtime/Serialization/Packers.meta
new file mode 100644
index 00000000000..027b848d9db
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/Packers.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 6839ae703405d644f94ac92969a87ab1
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Runtime/Serialization/Packers/BitHelperTest.cs b/Assets/Tests/Runtime/Serialization/Packers/BitHelperTest.cs
new file mode 100644
index 00000000000..6b7e1280ea3
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/Packers/BitHelperTest.cs
@@ -0,0 +1,21 @@
+using Mirage.Serialization;
+using NUnit.Framework;
+
+namespace Mirage.Tests.Runtime.Serialization.Packers
+{
+    public class BitHelperTest
+    {
+        [Test]
+        [TestCase(2, 0.05f, ExpectedResult = 7)]
+        [TestCase(100, 0.1f, ExpectedResult = 11)]
+        [TestCase(.707f, 0.002f, ExpectedResult = 10)]
+        [TestCase(1000, 0.1f, ExpectedResult = 15)]
+        [TestCase(2000, 0.01f, ExpectedResult = 19)]
+        // 1023 is 10 bits, but max is -+ so 11 bits
+        [TestCase(1023, 1, ExpectedResult = 11)]
+        public int ReturnCorrectBitCount(float max, float precision)
+        {
+            return BitHelper.BitCount(max, precision);
+        }
+    }
+}
diff --git a/Assets/Tests/Runtime/Serialization/Packers/BitHelperTest.cs.meta b/Assets/Tests/Runtime/Serialization/Packers/BitHelperTest.cs.meta
new file mode 100644
index 00000000000..db2d5f6f55b
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/Packers/BitHelperTest.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 782d32bee66d34649b2d40b6a111d20d
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Runtime/Serialization/Packers/CompressionExtensionTests.cs b/Assets/Tests/Runtime/Serialization/Packers/CompressionExtensionTests.cs
new file mode 100644
index 00000000000..b0e58175c4b
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/Packers/CompressionExtensionTests.cs
@@ -0,0 +1,28 @@
+using Mirage.Serialization;
+using NUnit.Framework;
+using UnityEngine;
+
+namespace Mirage.Tests.Runtime.Serialization.Packers
+{
+    public class CompressionExtensionTests : PackerTestBase
+    {
+        [Test]
+        public void PackRotationUsesDefault9()
+        {
+            writer.PackRotation(Quaternion.identity);
+            Assert.That(writer.BitPosition, Is.EqualTo(29));
+        }
+
+        [Test]
+        public void UnpackRotationUsesDefault9()
+        {
+            writer.Write(0, 27);
+            writer.Write(3, 2);
+            NetworkReader reader = GetReader();
+            Assert.That(reader.BitPosition, Is.EqualTo(0), "Check it starts at 0");
+            Quaternion value = reader.UnpackRotation();
+            Assert.That(reader.BitPosition, Is.EqualTo(29));
+            Assert.That(value, Is.EqualTo(Quaternion.identity));
+        }
+    }
+}
diff --git a/Assets/Tests/Runtime/Serialization/Packers/CompressionExtensionTests.cs.meta b/Assets/Tests/Runtime/Serialization/Packers/CompressionExtensionTests.cs.meta
new file mode 100644
index 00000000000..81b98c53b0f
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/Packers/CompressionExtensionTests.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 72473f4ac361ade47836c4bc55f91536
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Runtime/Serialization/Packers/FloatPackerCreateTest.cs b/Assets/Tests/Runtime/Serialization/Packers/FloatPackerCreateTest.cs
new file mode 100644
index 00000000000..d9440b4fdc2
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/Packers/FloatPackerCreateTest.cs
@@ -0,0 +1,69 @@
+using System;
+using Mirage.Serialization;
+using NUnit.Framework;
+using UnityEngine;
+using Range = NUnit.Framework.RangeAttribute;
+
+namespace Mirage.Tests.Runtime.Serialization.Packers
+{
+    public class FloatPackerCreateTest : PackerTestBase
+    {
+        [Test]
+        [TestCase(1, ExpectedResult = 8)]
+        [TestCase(0.1f, ExpectedResult = 11)]
+        [TestCase(0.01f, ExpectedResult = 15)]
+        public int CreateUsingPrecsion(float precision)
+        {
+            var packer = new FloatPacker(100, precision);
+
+            packer.Pack(writer, 1f);
+            return writer.BitPosition;
+        }
+
+        [Test]
+        public void PackFromBitCountPacksToCorrectCount([Range(1, 30)] int bitCount)
+        {
+            var packer = FloatPacker.FromBitCount(100, bitCount);
+
+            packer.Pack(writer, 1f);
+
+            Assert.That(writer.BitPosition, Is.EqualTo(bitCount));
+        }
+
+        [Test]
+        public void ThrowsIfBitCountIsLessThan1([Range(-10, 0)] int bitCount)
+        {
+            ArgumentException exception = Assert.Throws<ArgumentException>(() =>
+            {
+                FloatPacker.FromBitCount(10, bitCount);
+            });
+
+            var expected = new ArgumentException("Bit count is too low, bit count should be between 1 and 30", "bitCount");
+            Assert.That(exception, Has.Message.EqualTo(expected.Message));
+        }
+
+        [Test]
+        public void ThrowsIfBitCountIsGreaterThan30([Range(31, 40)] int bitCount)
+        {
+            ArgumentException exception = Assert.Throws<ArgumentException>(() =>
+            {
+                FloatPacker.FromBitCount(10, bitCount);
+            });
+
+            var expected = new ArgumentException("Bit count is too high, bit count should be between 1 and 30", "bitCount");
+            Assert.That(exception, Has.Message.EqualTo(expected.Message));
+        }
+
+        [Test]
+        public void ThrowsIfMaxIsZero()
+        {
+            ArgumentException exception = Assert.Throws<ArgumentException>(() =>
+            {
+                FloatPacker.FromBitCount(0, 1);
+            });
+
+            var expected = new ArgumentException("Max can not be 0", "max");
+            Assert.That(exception, Has.Message.EqualTo(expected.Message));
+        }
+    }
+}
diff --git a/Assets/Tests/Runtime/Serialization/Packers/FloatPackerCreateTest.cs.meta b/Assets/Tests/Runtime/Serialization/Packers/FloatPackerCreateTest.cs.meta
new file mode 100644
index 00000000000..675692953ae
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/Packers/FloatPackerCreateTest.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: a14c571ce3156ac4f9fbc8629c2fabc0
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Runtime/Serialization/Packers/FloatPackerTests.cs b/Assets/Tests/Runtime/Serialization/Packers/FloatPackerTests.cs
new file mode 100644
index 00000000000..ef813cfdf70
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/Packers/FloatPackerTests.cs
@@ -0,0 +1,129 @@
+using Mirage.Serialization;
+using NUnit.Framework;
+using Random = UnityEngine.Random;
+
+namespace Mirage.Tests.Runtime.Serialization.Packers
+{
+    [TestFixture(100, 0.1f)]
+    [TestFixture(500, 0.02f)]
+    [TestFixture(2000, 0.05f)]
+    [TestFixture(1.5f, 0.01f)]
+    [TestFixture(100_000, 30)]
+    public class FloatPackerTests : PackerTestBase
+    {
+        readonly FloatPacker packer;
+        readonly float max;
+        readonly float precsion;
+
+        public FloatPackerTests(float max, float precsion)
+        {
+            this.max = max;
+            this.precsion = precsion;
+            packer = new FloatPacker(max, precsion);
+        }
+
+
+        float GetRandomFloat()
+        {
+            return Random.Range(-max, max);
+        }
+
+
+        [Test]
+        // takes about 1 seconds per 1000 values (including all fixtures)
+        [Repeat(1000)]
+        public void UnpackedValueIsWithinPrecision()
+        {
+            float start = GetRandomFloat();
+            uint packed = packer.Pack(start);
+            float unpacked = packer.Unpack(packed);
+
+            Assert.That(unpacked, Is.EqualTo(start).Within(precsion));
+        }
+
+        [Test]
+        public void ValueOverMaxWillBeUnpackedAsMax()
+        {
+            float start = max * 1.2f;
+            uint packed = packer.Pack(start);
+            float unpacked = packer.Unpack(packed);
+
+            Assert.That(unpacked, Is.EqualTo(max).Within(precsion));
+        }
+
+        [Test]
+        public void ValueUnderNegativeMaxWillBeUnpackedAsNegativeMax()
+        {
+            float start = max * -1.2f;
+            uint packed = packer.Pack(start);
+            float unpacked = packer.Unpack(packed);
+
+            Assert.That(unpacked, Is.EqualTo(-max).Within(precsion));
+        }
+
+        [Test]
+        public void ZeroUnpackToExactlyZero()
+        {
+            const float zero = 0;
+            uint packed = packer.Pack(zero);
+            float unpacked = packer.Unpack(packed);
+
+            Assert.That(unpacked, Is.EqualTo(zero));
+        }
+
+
+        [Test]
+        [Repeat(100)]
+        public void UnpackedValueIsWithinPrecisionUsingWriter()
+        {
+            float start = GetRandomFloat();
+            packer.Pack(writer, start);
+            float unpacked = packer.Unpack(GetReader());
+
+            Assert.That(unpacked, Is.EqualTo(start).Within(precsion));
+        }
+
+        [Test]
+        public void ValueOverMaxWillBeUnpackedUsingWriterAsMax()
+        {
+            float start = max * 1.2f;
+            packer.Pack(writer, start);
+            float unpacked = packer.Unpack(GetReader());
+
+            Assert.That(unpacked, Is.EqualTo(max).Within(precsion));
+        }
+
+        [Test]
+        public void ValueUnderNegativeMaxWillBeUnpackedUsingWriterAsNegativeMax()
+        {
+            float start = max * -1.2f;
+            packer.Pack(writer, start);
+            float unpacked = packer.Unpack(GetReader());
+
+            Assert.That(unpacked, Is.EqualTo(-max).Within(precsion));
+        }
+
+
+        [Test]
+        [Repeat(100)]
+        public void UnpackedValueIsWithinPrecisionNoClamp()
+        {
+            float start = GetRandomFloat();
+            uint packed = packer.PackNoClamp(start);
+            float unpacked = packer.Unpack(packed);
+
+            Assert.That(unpacked, Is.EqualTo(start).Within(precsion));
+        }
+
+        [Test]
+        [Repeat(100)]
+        public void UnpackedValueIsWithinPrecisionNoClampUsingWriter()
+        {
+            float start = GetRandomFloat();
+            packer.PackNoClamp(writer, start);
+            float unpacked = packer.Unpack(GetReader());
+
+            Assert.That(unpacked, Is.EqualTo(start).Within(precsion));
+        }
+    }
+}
diff --git a/Assets/Tests/Runtime/Serialization/Packers/FloatPackerTests.cs.meta b/Assets/Tests/Runtime/Serialization/Packers/FloatPackerTests.cs.meta
new file mode 100644
index 00000000000..eeb524b414a
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/Packers/FloatPackerTests.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: e683c337f85dc4d418e6c71c6f8ac5c4
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Runtime/Serialization/Packers/PackerTestBase.cs b/Assets/Tests/Runtime/Serialization/Packers/PackerTestBase.cs
new file mode 100644
index 00000000000..d35414a6850
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/Packers/PackerTestBase.cs
@@ -0,0 +1,28 @@
+using Mirage.Serialization;
+using NUnit.Framework;
+
+namespace Mirage.Tests.Runtime.Serialization.Packers
+{
+    public class PackerTestBase
+    {
+        public readonly NetworkWriter writer = new NetworkWriter(1300);
+        readonly NetworkReader reader = new NetworkReader();
+
+        [TearDown]
+        public virtual void TearDown()
+        {
+            writer.Reset();
+            reader.Dispose();
+        }
+
+        /// <summary>
+        /// Gets Reader using the current data inside writer
+        /// </summary>
+        /// <returns></returns>
+        public NetworkReader GetReader()
+        {
+            reader.Reset(writer.ToArraySegment());
+            return reader;
+        }
+    }
+}
diff --git a/Assets/Tests/Runtime/Serialization/Packers/PackerTestBase.cs.meta b/Assets/Tests/Runtime/Serialization/Packers/PackerTestBase.cs.meta
new file mode 100644
index 00000000000..61fcb70e117
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/Packers/PackerTestBase.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 0d9edfce25a6a2d4bbd86782e43eae21
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Runtime/Serialization/Packers/QuaternionPackerTests.cs b/Assets/Tests/Runtime/Serialization/Packers/QuaternionPackerTests.cs
new file mode 100644
index 00000000000..c69f6401e3b
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/Packers/QuaternionPackerTests.cs
@@ -0,0 +1,210 @@
+using System.Collections;
+using System.Collections.Generic;
+using Mirage.Serialization;
+using NUnit.Framework;
+using NUnit.Framework.Constraints;
+using UnityEngine;
+using Random = UnityEngine.Random;
+using Range = NUnit.Framework.RangeAttribute;
+
+namespace Mirage.Tests.Runtime.Serialization.Packers
+{
+    public class QuaternionPackerTests : PackerTestBase
+    {
+        static Quaternion GetRandomQuaternion()
+        {
+            return Random.rotationUniform.normalized;
+        }
+        static Quaternion GetRandomQuaternionNotNormalized()
+        {
+            return new Quaternion(
+                Random.Range(-1, 1),
+                Random.Range(-1, 1),
+                Random.Range(-1, 1),
+                Random.Range(-1, 1)
+                );
+        }
+
+
+        [Test]
+        public void IdentityIsUnpackedAsIdentity()
+        {
+            var packer = new QuaternionPacker(10);
+            packer.Pack(writer, Quaternion.identity);
+            Quaternion unpack = packer.Unpack(GetReader());
+
+            Assert.That(unpack, Is.EqualTo(Quaternion.identity));
+        }
+
+
+        static IEnumerable ReturnsCorrectIndexCases()
+        {
+            var values = new List<float>() { 0.1f, 0.2f, 0.3f, 0.4f };
+            // abcd are index
+            // testing all permutation, index can only be used once
+            for (int a = 0; a < 4; a++)
+            {
+                for (int b = 0; b < 4; b++)
+                {
+                    if (b == a) { continue; }
+
+                    for (int c = 0; c < 4; c++)
+                    {
+                        if (c == a || c == b) { continue; }
+
+                        for (int d = 0; d < 4; d++)
+                        {
+                            if (d == a || d == b || d == c) { continue; }
+
+                            uint largest = 0;
+                            // index 3 is the largest, 
+                            if (a == 3) { largest = 0; }
+                            if (b == 3) { largest = 1; }
+                            if (c == 3) { largest = 2; }
+                            if (d == 3) { largest = 3; }
+                            yield return new TestCaseData(new Quaternion(values[a], values[b], values[c], values[d]).normalized)
+                                .Returns(largest);
+                        }
+                    }
+                }
+            }
+        }
+
+        [Test]
+        [TestCaseSource(nameof(ReturnsCorrectIndexCases))]
+        public uint ReturnsCorrectIndex(Quaternion q)
+        {
+            QuaternionPacker.FindLargestIndex(ref q, out uint index);
+            return index;
+        }
+
+
+        static IEnumerable CompressesAndDecompressesCases()
+        {
+            for (int i = 8; i < 12; i++)
+            {
+                yield return new TestCaseData(i, Quaternion.identity);
+                yield return new TestCaseData(i, Quaternion.Euler(25, 30, 0));
+                yield return new TestCaseData(i, Quaternion.Euler(-50, 30, 90));
+                yield return new TestCaseData(i, Quaternion.Euler(90, 90, 180));
+                yield return new TestCaseData(i, Quaternion.Euler(-20, 0, 45));
+                yield return new TestCaseData(i, Quaternion.Euler(80, 30, -45));
+            }
+        }
+
+        [Test]
+        [TestCaseSource(nameof(CompressesAndDecompressesCases))]
+#if !UNITY_EDITOR
+        [Ignore("Quaternion.Euler Requires unity engine to run")]
+#endif
+        public void PackAndUnpack(int bits, Quaternion inValue)
+        {
+            RunPackAndUnpack(bits, inValue);
+        }
+
+
+        [Test]
+        [Repeat(1000)]
+#if !UNITY_EDITOR
+        [Ignore("Quaternion.Euler Requires unity engine to run")]
+#endif
+        public void PackAndUnpackRepeat([Range(8, 12)] int bits)
+        {
+            Quaternion inValue = GetRandomQuaternion();
+
+            RunPackAndUnpack(bits, inValue);
+        }
+
+        [Test]
+        [Repeat(1000)]
+#if !UNITY_EDITOR
+        [Ignore("Quaternion.Euler Requires unity engine to run")]
+#endif
+        public void PackAndUnpackRepeatNotNormalized([Range(8, 12)] int bits)
+        {
+            Quaternion inValueNotNormalized = GetRandomQuaternionNotNormalized();
+
+            RunPackAndUnpack(bits, inValueNotNormalized);
+        }
+
+        private void RunPackAndUnpack(int bits, Quaternion inValueNotNormalized)
+        {
+            Quaternion inValue = inValueNotNormalized.normalized;
+
+            // precision for 1 element
+            float max = (1 / Mathf.Sqrt(2));
+            float precision = 2 * max / ((1 << bits) - 1);
+            // allow extra precision because largest is caculated using the other 3 values so may be out side of precision
+            precision *= 2;
+
+            var packer = new QuaternionPacker(bits);
+
+            packer.Pack(writer, inValueNotNormalized);
+
+            Quaternion outValue = packer.Unpack(GetReader());
+            //Debug.Log($"Packed: ({inValue.x:0.000},{inValue.y:0.000},{inValue.z:0.000},{inValue.w:0.000}) " +
+            //          $"UnPacked: ({outValue.x:0.000},{outValue.y:0.000},{outValue.z:0.000},{outValue.w:0.000})");
+
+            Assert.That(outValue.x, Is.Not.NaN, "x was NaN");
+            Assert.That(outValue.y, Is.Not.NaN, "y was NaN");
+            Assert.That(outValue.z, Is.Not.NaN, "z was NaN");
+            Assert.That(outValue.w, Is.Not.NaN, "w was NaN");
+
+            float assertSign = getAssertSign(inValue, outValue);
+
+            Assert.That(outValue.x, IsUnSignedEqualWithIn(inValue.x), $"x off by {Mathf.Abs(assertSign * inValue.x - outValue.x)}");
+            Assert.That(outValue.y, IsUnSignedEqualWithIn(inValue.y), $"y off by {Mathf.Abs(assertSign * inValue.y - outValue.y)}");
+            Assert.That(outValue.z, IsUnSignedEqualWithIn(inValue.z), $"z off by {Mathf.Abs(assertSign * inValue.z - outValue.z)}");
+            Assert.That(outValue.w, IsUnSignedEqualWithIn(inValue.w), $"w off by {Mathf.Abs(assertSign * inValue.w - outValue.w)}");
+
+            Vector3 inVec = inValue * Vector3.forward;
+            Vector3 outVec = outValue * Vector3.forward;
+
+            // allow for extra precision when rotating vector
+            Assert.AreEqual(inVec.x, outVec.x, precision * 2, $"vx off by {Mathf.Abs(inVec.x - outVec.x)}");
+            Assert.AreEqual(inVec.y, outVec.y, precision * 2, $"vy off by {Mathf.Abs(inVec.y - outVec.y)}");
+            Assert.AreEqual(inVec.z, outVec.z, precision * 2, $"vz off by {Mathf.Abs(inVec.z - outVec.z)}");
+
+
+            EqualConstraint IsUnSignedEqualWithIn(float v)
+            {
+                return Is.EqualTo(v).Within(precision).Or.EqualTo(assertSign * v).Within(precision);
+            }
+        }
+
+
+        [Test]
+        [Repeat(1000)]
+        public void FastNormalize()
+        {
+            Quaternion q1 = GetRandomQuaternionNotNormalized();
+            // create copy here so it can be used in ref without chanigng q1
+            Quaternion q2 = q1;
+            QuaternionPacker.QuickNormalize(ref q2);
+
+            Assert.That(q2, Is.EqualTo(q1.normalized));
+        }
+
+        /// <summary>
+        /// sign used to validate values (in/out are different, then flip values
+        /// </summary>
+        /// <param name="inValue"></param>
+        /// <param name="outValue"></param>
+        /// <returns></returns>
+        static float getAssertSign(Quaternion inValue, Quaternion outValue)
+        {
+            // keep same index for in/out because largest *might* have chagned if all elements are equal
+            QuaternionPacker.FindLargestIndex(ref inValue, out uint index);
+
+            float inLargest = inValue[(int)index];
+            float outLargest = outValue[(int)index];
+            // flip sign of A if largest is is negative
+            // Q == (-Q)
+            float inSign = Mathf.Sign(inLargest);
+            float outSign = Mathf.Sign(outLargest);
+
+            float assertSign = inSign == outSign ? 1 : -1;
+            return assertSign;
+        }
+    }
+}
diff --git a/Assets/Tests/Runtime/Serialization/Packers/QuaternionPackerTests.cs.meta b/Assets/Tests/Runtime/Serialization/Packers/QuaternionPackerTests.cs.meta
new file mode 100644
index 00000000000..08b7d0f7cf0
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/Packers/QuaternionPackerTests.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 3a126e0a10498944d9b63c0c021fbd41
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Runtime/Serialization/Packers/Vector2PackerTests.cs b/Assets/Tests/Runtime/Serialization/Packers/Vector2PackerTests.cs
new file mode 100644
index 00000000000..3991926e7f1
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/Packers/Vector2PackerTests.cs
@@ -0,0 +1,91 @@
+using System;
+using System.Collections;
+using System.Collections.Generic;
+using Mirage.Serialization;
+using NUnit.Framework;
+using UnityEngine;
+using Random = UnityEngine.Random;
+
+namespace Mirage.Tests.Runtime.Serialization.Packers
+{
+    public class Vector2PackerTests : PackerTestBase
+    {
+        static IEnumerable WriteCorrectNumberOfBitsCases()
+        {
+            yield return new TestCaseData(Vector2.one * 100, Vector2.one * 0.1f).Returns(11 * 2);
+            yield return new TestCaseData(Vector2.one * 200, Vector2.one * 0.1f).Returns(12 * 2);
+            yield return new TestCaseData(Vector2.one * 200, Vector2.one * 0.05f).Returns(13 * 2);
+            yield return new TestCaseData(new Vector2(100, 50), Vector2.one * 0.1f).Returns(11 + 10);
+            yield return new TestCaseData(new Vector2(100, 50), new Vector2(0.1f, 0.2f)).Returns(11 + 9);
+        }
+
+        [Test]
+        [TestCaseSource(nameof(WriteCorrectNumberOfBitsCases))]
+        public int WriteCorrectNumberOfBits(Vector2 max, Vector2 precision)
+        {
+            var packer = new Vector2Packer(max, precision);
+            packer.Pack(writer, Vector2.zero);
+            return writer.BitPosition;
+        }
+
+        static IEnumerable ThrowsIfAnyMaxIsZeroCases()
+        {
+            yield return new TestCaseData(new Vector2(100, 0), Vector2.one * 0.1f);
+            yield return new TestCaseData(new Vector2(0, 100), Vector2.one * 0.1f);
+        }
+
+        [Test]
+        [TestCaseSource(nameof(ThrowsIfAnyMaxIsZeroCases))]
+        public void ThrowsIfAnyMaxIsZero(Vector2 max, Vector2 precision)
+        {
+            ArgumentException exception = Assert.Throws<ArgumentException>(() =>
+            {
+                _ = new Vector2Packer(max, precision);
+            });
+
+            var expected = new ArgumentException("Max can not be 0", "max");
+            Assert.That(exception, Has.Message.EqualTo(expected.Message));
+        }
+
+
+        static IEnumerable<TestCaseData> UnpacksToSaveValueCases()
+        {
+            yield return new TestCaseData(Vector2.one * 100, Vector2.one * 0.1f);
+            yield return new TestCaseData(Vector2.one * 200, Vector2.one * 0.1f);
+            yield return new TestCaseData(Vector2.one * 200, Vector2.one * 0.05f);
+            yield return new TestCaseData(new Vector2(100, 50), Vector2.one * 0.1f);
+            yield return new TestCaseData(new Vector2(100, 50), new Vector2(0.1f, 0.2f));
+        }
+
+        [Test]
+        [TestCaseSource(nameof(UnpacksToSaveValueCases))]
+        [Repeat(100)]
+        public void UnpacksToSaveValue(Vector2 max, Vector2 precision)
+        {
+            var packer = new Vector2Packer(max, precision);
+            var expected = new Vector2(
+                Random.Range(-max.x, -max.x),
+                Random.Range(-max.y, -max.y)
+                );
+
+            packer.Pack(writer, expected);
+            Vector2 unpacked = packer.Unpack(GetReader());
+
+            Assert.That(unpacked.x, Is.EqualTo(expected.x).Within(precision.x));
+            Assert.That(unpacked.y, Is.EqualTo(expected.y).Within(precision.y));
+        }
+
+        [Test]
+        [TestCaseSource(nameof(UnpacksToSaveValueCases))]
+        public void ZeroUnpacksAsZero(Vector2 max, Vector2 precision)
+        {
+            var packer = new Vector2Packer(max, precision);
+            Vector2 zero = Vector2.zero;
+
+            packer.Pack(writer, zero);
+            Vector2 unpacked = packer.Unpack(GetReader());
+
+            Assert.That(unpacked, Is.EqualTo(zero));
+        }
+    }
+}
diff --git a/Assets/Tests/Runtime/Serialization/Packers/Vector2PackerTests.cs.meta b/Assets/Tests/Runtime/Serialization/Packers/Vector2PackerTests.cs.meta
new file mode 100644
index 00000000000..9fcdf3eecb6
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/Packers/Vector2PackerTests.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 95e840159b32e0347b99ff97e90d3e2b
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Runtime/Serialization/Packers/Vector3PackerTests.cs b/Assets/Tests/Runtime/Serialization/Packers/Vector3PackerTests.cs
new file mode 100644
index 00000000000..6b0cefad626
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/Packers/Vector3PackerTests.cs
@@ -0,0 +1,96 @@
+using System;
+using System.Collections;
+using System.Collections.Generic;
+using Mirage.Serialization;
+using NUnit.Framework;
+using UnityEngine;
+using Random = UnityEngine.Random;
+
+namespace Mirage.Tests.Runtime.Serialization.Packers
+{
+    public class Vector3PackerTests : PackerTestBase
+    {
+        static IEnumerable WriteCorrectNumberOfBitsCases()
+        {
+            yield return new TestCaseData(Vector3.one * 100, Vector3.one * 0.1f).Returns(11 * 3);
+            yield return new TestCaseData(Vector3.one * 200, Vector3.one * 0.1f).Returns(12 * 3);
+            yield return new TestCaseData(Vector3.one * 200, Vector3.one * 0.05f).Returns(13 * 3);
+            yield return new TestCaseData(new Vector3(100, 50, 100), Vector3.one * 0.1f).Returns(11 + 10 + 11);
+            yield return new TestCaseData(new Vector3(100, 50, 100), new Vector3(0.1f, 0.2f, 0.1f)).Returns(11 + 9 + 11);
+            yield return new TestCaseData(new Vector3(100, 50, 200), Vector3.one * 0.1f).Returns(11 + 10 + 12);
+            yield return new TestCaseData(new Vector3(100, 50, 200), new Vector3(0.1f, 0.2f, 0.05f)).Returns(11 + 9 + 13);
+        }
+
+        [Test]
+        [TestCaseSource(nameof(WriteCorrectNumberOfBitsCases))]
+        public int WriteCorrectNumberOfBits(Vector3 max, Vector3 precision)
+        {
+            var packer = new Vector3Packer(max, precision);
+            packer.Pack(writer, Vector3.zero);
+            return writer.BitPosition;
+        }
+
+        static IEnumerable ThrowsIfAnyMaxIsZeroCases()
+        {
+            yield return new TestCaseData(new Vector3(100, 0, 100), Vector3.one * 0.1f);
+            yield return new TestCaseData(new Vector3(0, 100, 100), Vector3.one * 0.1f);
+            yield return new TestCaseData(new Vector3(100, 100, 0), Vector3.one * 0.1f);
+        }
+
+        [Test]
+        [TestCaseSource(nameof(ThrowsIfAnyMaxIsZeroCases))]
+        public void ThrowsIfAnyMaxIsZero(Vector3 max, Vector3 precision)
+        {
+            ArgumentException exception = Assert.Throws<ArgumentException>(() =>
+            {
+                _ = new Vector3Packer(max, precision);
+            });
+
+            var expected = new ArgumentException("Max can not be 0", "max");
+            Assert.That(exception, Has.Message.EqualTo(expected.Message));
+        }
+
+
+        static IEnumerable<TestCaseData> UnpacksToSaveValueCases()
+        {
+            yield return new TestCaseData(Vector3.one * 100, Vector3.one * 0.1f);
+            yield return new TestCaseData(Vector3.one * 200, Vector3.one * 0.1f);
+            yield return new TestCaseData(Vector3.one * 200, Vector3.one * 0.05f);
+            yield return new TestCaseData(new Vector3(100, 50, 100), Vector3.one * 0.1f);
+            yield return new TestCaseData(new Vector3(100, 50, 100), new Vector3(0.1f, 0.2f, 0.1f));
+        }
+
+        [Test]
+        [TestCaseSource(nameof(UnpacksToSaveValueCases))]
+        [Repeat(100)]
+        public void UnpacksToSaveValue(Vector3 max, Vector3 precision)
+        {
+            var packer = new Vector3Packer(max, precision);
+            var expected = new Vector3(
+                Random.Range(-max.x, -max.x),
+                Random.Range(-max.y, -max.y),
+                Random.Range(-max.z, -max.z)
+                );
+
+            packer.Pack(writer, expected);
+            Vector3 unpacked = packer.Unpack(GetReader());
+
+            Assert.That(unpacked.x, Is.EqualTo(expected.x).Within(precision.x));
+            Assert.That(unpacked.y, Is.EqualTo(expected.y).Within(precision.y));
+            Assert.That(unpacked.z, Is.EqualTo(expected.z).Within(precision.z));
+        }
+
+        [Test]
+        [TestCaseSource(nameof(UnpacksToSaveValueCases))]
+        public void ZeroUnpacksAsZero(Vector3 max, Vector3 precision)
+        {
+            var packer = new Vector3Packer(max, precision);
+            Vector3 zero = Vector3.zero;
+
+            packer.Pack(writer, zero);
+            Vector3 unpacked = packer.Unpack(GetReader());
+
+            Assert.That(unpacked, Is.EqualTo(zero));
+        }
+    }
+}
diff --git a/Assets/Tests/Runtime/Serialization/Packers/Vector3PackerTests.cs.meta b/Assets/Tests/Runtime/Serialization/Packers/Vector3PackerTests.cs.meta
new file mode 100644
index 00000000000..cadf4d6570a
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/Packers/Vector3PackerTests.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: cbc014213f9098643b1058db26baa5ee
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

From c19929f19b110406b85ac11b6c49a365f5d7da39 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Mon, 16 Aug 2021 14:06:14 +0100
Subject: [PATCH 100/166] fix(SocketLayer): moving endpoint copy outside of
 connection

---
 Assets/Mirage/Runtime/SocketLayer/Connection.cs | 4 +---
 Assets/Mirage/Runtime/SocketLayer/Peer.cs       | 6 +++++-
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/Assets/Mirage/Runtime/SocketLayer/Connection.cs b/Assets/Mirage/Runtime/SocketLayer/Connection.cs
index 9bb03b9e742..1b2226cbfcb 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Connection.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Connection.cs
@@ -113,9 +113,7 @@ internal Connection(Peer peer, IEndPoint endPoint, IDataHandler dataHandler, Con
             this.peer = peer;
             this.logger = logger ?? Debug.unityLogger;
 
-            // create copy of endpoint for this connection
-            // this is so that we can re-use the endpoint (reduces alloc) for receive and not worry about changing internal data needed for each connection
-            EndPoint = endPoint?.CreateCopy() ?? throw new ArgumentNullException(nameof(endPoint));
+            EndPoint = endPoint ?? throw new ArgumentNullException(nameof(endPoint));
             this.dataHandler = dataHandler ?? throw new ArgumentNullException(nameof(dataHandler));
             State = ConnectionState.Created;
 
diff --git a/Assets/Mirage/Runtime/SocketLayer/Peer.cs b/Assets/Mirage/Runtime/SocketLayer/Peer.cs
index 11aab6df3fe..f8daf296f6a 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Peer.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Peer.cs
@@ -403,8 +403,12 @@ private void AcceptNewConnection(IEndPoint endPoint)
             HandleConnectionRequest(connection);
         }
 
-        private Connection CreateNewConnection(IEndPoint endPoint)
+        private Connection CreateNewConnection(IEndPoint _newEndPoint)
         {
+            // create copy of endpoint for this connection
+            // this is so that we can re-use the endpoint (reduces alloc) for receive and not worry about changing internal data needed for each connection
+            IEndPoint endPoint = _newEndPoint?.CreateCopy();
+
             var connection = new Connection(this, endPoint, dataHandler, config, time, bufferPool, logger, metrics);
             connection.SetReceiveTime();
             connections.Add(endPoint, connection);

From 9789c0b5851c8377e13f799f4a437197e801ecac Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Mon, 16 Aug 2021 14:17:13 +0100
Subject: [PATCH 101/166] fix: preparing client objects on connect (#876)

this allows scene objects in first scene to be spawned
---
 Assets/Mirage/Runtime/ClientObjectManager.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/Assets/Mirage/Runtime/ClientObjectManager.cs b/Assets/Mirage/Runtime/ClientObjectManager.cs
index d4536bd2836..b9bbc0a0fd6 100644
--- a/Assets/Mirage/Runtime/ClientObjectManager.cs
+++ b/Assets/Mirage/Runtime/ClientObjectManager.cs
@@ -66,6 +66,10 @@ void OnClientConnected(INetworkPlayer player)
             syncVarReceiver = new SyncVarReceiver(Client, Client.World);
             RegisterSpawnPrefabs();
 
+            // prepare objects right away so objects in first scene can be spawned
+            // if user changes scenes without NetworkSceneManager then they will need to manually call it again
+            PrepareToSpawnSceneObjects();
+
             if (Client.IsLocalClient)
             {
                 RegisterHostHandlers();

From c361300a6f6cc5536939df738f8c7ea19319771a Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Mon, 16 Aug 2021 13:33:48 +0000
Subject: [PATCH 102/166] chore(release): 101.3.0 [skip ci]

# [101.3.0](https://github.com/MirageNet/Mirage/compare/v101.2.0...v101.3.0) (2021-08-16)

### Bug Fixes

* preparing client objects on connect ([#876](https://github.com/MirageNet/Mirage/issues/876)) ([9789c0b](https://github.com/MirageNet/Mirage/commit/9789c0b5851c8377e13f799f4a437197e801ecac))
* **SocketLayer:** moving endpoint copy outside of connection ([c19929f](https://github.com/MirageNet/Mirage/commit/c19929f19b110406b85ac11b6c49a365f5d7da39))

### Features

* adding helper classes for packing float, vector and quaternion ([#847](https://github.com/MirageNet/Mirage/issues/847)) ([410bcd6](https://github.com/MirageNet/Mirage/commit/410bcd6475e851dfd0a63944051f6522662f8e85))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs        |  2 +-
 Assets/Mirage/CHANGELOG.md                          | 13 +++++++++++++
 Assets/Mirage/Components/AssemblyInfo.cs            |  2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs               |  2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs   |  2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs              |  2 +-
 .../RigidbodyPhysics/Scripts/AssemblyInfo.cs        |  2 +-
 Assets/Mirage/package.json                          |  2 +-
 8 files changed, 20 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index 2b1c921d169..0c2aa0cd453 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.2.0")]
+[assembly: AssemblyVersion("101.3.0")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index 07ee33aed09..d98fb145925 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,16 @@
+# [101.3.0](https://github.com/MirageNet/Mirage/compare/v101.2.0...v101.3.0) (2021-08-16)
+
+
+### Bug Fixes
+
+* preparing client objects on connect ([#876](https://github.com/MirageNet/Mirage/issues/876)) ([9789c0b](https://github.com/MirageNet/Mirage/commit/9789c0b5851c8377e13f799f4a437197e801ecac))
+* **SocketLayer:** moving endpoint copy outside of connection ([c19929f](https://github.com/MirageNet/Mirage/commit/c19929f19b110406b85ac11b6c49a365f5d7da39))
+
+
+### Features
+
+* adding helper classes for packing float, vector and quaternion ([#847](https://github.com/MirageNet/Mirage/issues/847)) ([410bcd6](https://github.com/MirageNet/Mirage/commit/410bcd6475e851dfd0a63944051f6522662f8e85))
+
 # [101.2.0](https://github.com/MirageNet/Mirage/compare/v101.1.0...v101.2.0) (2021-08-10)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index 339b12cd608..c904953d0a4 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.2.0")]
+[assembly: AssemblyVersion("101.3.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index 3e04ace8ba9..cf442311f6d 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.2.0")]
+[assembly: AssemblyVersion("101.3.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index 8360628f363..865c1e9a612 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.2.0")]
+[assembly: AssemblyVersion("101.3.0")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index 2b1c921d169..0c2aa0cd453 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.2.0")]
+[assembly: AssemblyVersion("101.3.0")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index 2b1c921d169..0c2aa0cd453 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.2.0")]
+[assembly: AssemblyVersion("101.3.0")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 2bc27546c67..710331e16e8 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "101.2.0",
+    "version": "101.3.0",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From 3c24f67dc6140c9c711b26837ea5b9c8220c1cc1 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Tue, 17 Aug 2021 16:01:07 +0100
Subject: [PATCH 103/166] feat: adding helper classes for packing uint values
 (#878)

* var in packets

* tests for var int packer

* tests for block packer

* adding bit count method for ulong

* adding extra comment to bit count

* fixing code smells
---
 .../Serialization/Packers/BitHelper.cs        |  17 ++
 .../Packers/VariableBlockPacker.cs            |  66 ++++++++
 .../Packers/VariableBlockPacker.cs.meta       |  11 ++
 .../Packers/VariableIntPacker.cs              | 160 ++++++++++++++++++
 .../Packers/VariableIntPacker.cs.meta         |  11 ++
 .../Packers/UintBlockPackerTests.cs           |  94 ++++++++++
 .../Packers/UintBlockPackerTests.cs.meta      |  11 ++
 .../Packers/UintPackerCreateTest.cs           | 139 +++++++++++++++
 .../Packers/UintPackerCreateTest.cs.meta      |  11 ++
 .../Serialization/Packers/UintPackerTests.cs  |  83 +++++++++
 .../Packers/UintPackerTests.cs.meta           |  11 ++
 11 files changed, 614 insertions(+)
 create mode 100644 Assets/Mirage/Runtime/Serialization/Packers/VariableBlockPacker.cs
 create mode 100644 Assets/Mirage/Runtime/Serialization/Packers/VariableBlockPacker.cs.meta
 create mode 100644 Assets/Mirage/Runtime/Serialization/Packers/VariableIntPacker.cs
 create mode 100644 Assets/Mirage/Runtime/Serialization/Packers/VariableIntPacker.cs.meta
 create mode 100644 Assets/Tests/Runtime/Serialization/Packers/UintBlockPackerTests.cs
 create mode 100644 Assets/Tests/Runtime/Serialization/Packers/UintBlockPackerTests.cs.meta
 create mode 100644 Assets/Tests/Runtime/Serialization/Packers/UintPackerCreateTest.cs
 create mode 100644 Assets/Tests/Runtime/Serialization/Packers/UintPackerCreateTest.cs.meta
 create mode 100644 Assets/Tests/Runtime/Serialization/Packers/UintPackerTests.cs
 create mode 100644 Assets/Tests/Runtime/Serialization/Packers/UintPackerTests.cs.meta

diff --git a/Assets/Mirage/Runtime/Serialization/Packers/BitHelper.cs b/Assets/Mirage/Runtime/Serialization/Packers/BitHelper.cs
index a689ec0f1d3..92e5e8a708c 100644
--- a/Assets/Mirage/Runtime/Serialization/Packers/BitHelper.cs
+++ b/Assets/Mirage/Runtime/Serialization/Packers/BitHelper.cs
@@ -30,6 +30,9 @@ public static class BitHelper
     {
         /// <summary>
         /// Gets the number of bits need for <paramref name="precision"/> in range negative to positive <paramref name="max"/>
+        /// <para>
+        /// WARNING: these methods are not fast, dont use in hotpath
+        /// </para>
         /// </summary>
         /// <param name="max"></param>
         /// <param name="precision">lowest precision required, bit count will round up so real precision might be higher</param>
@@ -38,5 +41,19 @@ public static int BitCount(float max, float precision)
         {
             return Mathf.CeilToInt(Mathf.Log(2 * max / precision, 2));
         }
+
+        /// <summary>
+        /// Gets the number of bits need for <paramref name="max"/>
+        /// <para>
+        /// WARNING: these methods are not fast, dont use in hotpath
+        /// </para>
+        /// </summary>
+        /// <param name="max"></param>
+        /// <param name="precision">lowest precision required, bit count will round up so real precision might be higher</param>
+        /// <returns></returns>
+        public static int BitCount(ulong max)
+        {
+            return Mathf.CeilToInt(Mathf.Log(max, 2));
+        }
     }
 }
diff --git a/Assets/Mirage/Runtime/Serialization/Packers/VariableBlockPacker.cs b/Assets/Mirage/Runtime/Serialization/Packers/VariableBlockPacker.cs
new file mode 100644
index 00000000000..557a1ed2937
--- /dev/null
+++ b/Assets/Mirage/Runtime/Serialization/Packers/VariableBlockPacker.cs
@@ -0,0 +1,66 @@
+/*
+MIT License
+
+Copyright (c) 2021 James Frowen
+
+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.
+*/
+
+using System;
+using System.Runtime.CompilerServices;
+
+namespace Mirage.Serialization
+{
+    public static class VariableBlockPacker
+    {
+        // todo needs doc comments
+        // todo neeeds tests
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public static void Pack(NetworkWriter writer, ulong value, int blockSize)
+        {
+            // always writes atleast 1 block
+            int count = 1;
+            ulong checkValue = value >> blockSize;
+            while (checkValue != 0)
+            {
+                count++;
+                checkValue >>= blockSize;
+            }
+            // count = 1, write = b0, (1<<(1-1) -1 => 1<<0 -1) => 1 -1 => 0)
+            // count = 2, write = b01
+            // count = 3, write = b011, (1<<(3-1) -1 => 1<<2 -1) => 100 - 1 => 011)
+            writer.Write((1ul << (count - 1)) - 1, count);
+            writer.Write(value, Math.Min(64, blockSize * count));
+        }
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public static ulong Unpack(NetworkReader reader, int blockSize)
+        {
+            int blocks = 1;
+            // read bits till we see a zero
+            while (reader.ReadBoolean())
+            {
+                blocks++;
+            }
+
+            return reader.Read(Math.Min(64, blocks * blockSize));
+        }
+    }
+}
diff --git a/Assets/Mirage/Runtime/Serialization/Packers/VariableBlockPacker.cs.meta b/Assets/Mirage/Runtime/Serialization/Packers/VariableBlockPacker.cs.meta
new file mode 100644
index 00000000000..560e7fa3698
--- /dev/null
+++ b/Assets/Mirage/Runtime/Serialization/Packers/VariableBlockPacker.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 124da2a56c14a924bb6bda5663c0c6f2
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Runtime/Serialization/Packers/VariableIntPacker.cs b/Assets/Mirage/Runtime/Serialization/Packers/VariableIntPacker.cs
new file mode 100644
index 00000000000..89595211d42
--- /dev/null
+++ b/Assets/Mirage/Runtime/Serialization/Packers/VariableIntPacker.cs
@@ -0,0 +1,160 @@
+/*
+MIT License
+
+Copyright (c) 2021 James Frowen
+
+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.
+*/
+
+using System;
+using System.Runtime.CompilerServices;
+
+namespace Mirage.Serialization
+{
+    public sealed class VariableIntPacker
+    {
+        // todo needs doc comments
+        // todo need attribute to validate large bits based on pack type (eg if packing ushort, make sure largebits is 16 or less)
+
+        readonly int smallBitCount;
+        readonly int mediumBitsCount;
+        readonly int largeBitsCount;
+
+        readonly ulong smallValue;
+        readonly ulong mediumValue;
+        readonly ulong largeValue;
+
+        readonly bool throwIfOverLarge;
+
+        public VariableIntPacker(ulong smallValue, ulong mediumValue)
+            : this(smallValue, mediumValue, ulong.MaxValue, false) { }
+        public VariableIntPacker(ulong smallValue, ulong mediumValue, ulong largeValue, bool throwIfOverLarge = true)
+            : this(BitHelper.BitCount(smallValue), BitHelper.BitCount(mediumValue), BitHelper.BitCount(largeValue), throwIfOverLarge) { }
+
+        public static VariableIntPacker FromBitCount(int smallBits, int mediumBits)
+            => FromBitCount(smallBits, mediumBits, 64, false);
+        public static VariableIntPacker FromBitCount(int smallBits, int mediumBits, int largeBits, bool throwIfOverLarge = true)
+            => new VariableIntPacker(smallBits, mediumBits, largeBits, throwIfOverLarge);
+
+        private VariableIntPacker(int smallBits, int mediumBits, int largeBits, bool throwIfOverLarge)
+        {
+            this.throwIfOverLarge = throwIfOverLarge;
+            if (smallBits == 0) throw new ArgumentException("Small value can not be zero", nameof(smallBits));
+            if (smallBits >= mediumBits) throw new ArgumentException("Medium value must be greater than small value", nameof(mediumBits));
+            if (mediumBits >= largeBits) throw new ArgumentException("Large value must be greater than medium value", nameof(largeBits));
+            if (largeBits > 64) throw new ArgumentException("Large bits must be 64 or less", nameof(largeBits));
+            // force medium to also be 62 or less so we can use 1 write call (2 bits to say its medium + 62 value bits
+            if (mediumBits > 62) throw new ArgumentException("Medium bits must be 62 or less", nameof(mediumBits));
+
+            smallBitCount = smallBits;
+            mediumBitsCount = mediumBits;
+            largeBitsCount = largeBits;
+
+            // mask is also max value for n bits
+            smallValue = BitMask.Mask(smallBits);
+            mediumValue = BitMask.Mask(mediumBits);
+            largeValue = BitMask.Mask(largeBits);
+        }
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public void PackUlong(NetworkWriter writer, ulong value)
+        {
+            pack(writer, value, 64);
+        }
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public void PackUint(NetworkWriter writer, uint value)
+        {
+            pack(writer, value, 32);
+        }
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public void PackUshort(NetworkWriter writer, ushort value)
+        {
+            pack(writer, value, 16);
+        }
+        void pack(NetworkWriter writer, ulong value, int maxBits)
+        {
+            if (value <= smallValue)
+            {
+                // start with b0 to say small, then value
+                writer.Write(value << 1, smallBitCount + 1);
+            }
+            else if (value <= mediumValue)
+            {
+                // start with b01 to say medium, then value
+                writer.Write(value << 2 | 0b01, mediumBitsCount + 2);
+            }
+            else if (value <= largeValue)
+            {
+                // start with b11 to say large, then value
+                // use 2 write calls here because bitCount could be 64
+                writer.Write(0b11, 2);
+                writer.Write(value, Math.Min(maxBits, largeBitsCount));
+            }
+            else
+            {
+                if (throwIfOverLarge)
+                {
+                    throw new ArgumentOutOfRangeException(nameof(value), value, $"Value is over max of {largeValue}");
+                }
+                else
+                {
+                    // if no throw write MaxValue
+                    // we dont want to write value here because it will be masked and lose some high bits
+                    // need 2 write calls here because max is 64+2 bits
+                    writer.Write(0b11, 2);
+                    writer.Write(ulong.MaxValue, Math.Min(maxBits, largeBitsCount));
+                }
+            }
+        }
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public ulong UnpackUlong(NetworkReader reader)
+        {
+            return unpack(reader, 64);
+        }
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public uint UnpackUint(NetworkReader reader)
+        {
+            return (uint)unpack(reader, 32);
+        }
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public ushort UnpackUshort(NetworkReader reader)
+        {
+            return (ushort)unpack(reader, 16);
+        }
+        ulong unpack(NetworkReader reader, int maxBits)
+        {
+            if (!reader.ReadBoolean())
+            {
+                return reader.Read(smallBitCount);
+            }
+            else
+            {
+                if (!reader.ReadBoolean())
+                {
+                    return reader.Read(mediumBitsCount);
+                }
+                else
+                {
+                    return reader.Read(Math.Min(largeBitsCount, maxBits));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Mirage/Runtime/Serialization/Packers/VariableIntPacker.cs.meta b/Assets/Mirage/Runtime/Serialization/Packers/VariableIntPacker.cs.meta
new file mode 100644
index 00000000000..3e3ae2735bd
--- /dev/null
+++ b/Assets/Mirage/Runtime/Serialization/Packers/VariableIntPacker.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 93822b4a356267942b8457394696ba08
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Runtime/Serialization/Packers/UintBlockPackerTests.cs b/Assets/Tests/Runtime/Serialization/Packers/UintBlockPackerTests.cs
new file mode 100644
index 00000000000..4395cdda8f8
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/Packers/UintBlockPackerTests.cs
@@ -0,0 +1,94 @@
+using System;
+using Mirage.Serialization;
+using NUnit.Framework;
+using Random = System.Random;
+
+namespace Mirage.Tests.Runtime.Serialization.Packers
+{
+    [TestFixture(4)]
+    [TestFixture(7)]
+    [TestFixture(8)]
+    [TestFixture(12)]
+    [TestFixture(16)]
+    public class UintBlockPackerTests : PackerTestBase
+    {
+        readonly Random random = new Random();
+        readonly int blockSize;
+
+        public UintBlockPackerTests(int blockSize)
+        {
+            this.blockSize = blockSize;
+        }
+
+
+        ulong GetRandonUlongBias()
+        {
+            return (ulong)(Math.Abs(random.NextDouble() - random.NextDouble()) * ulong.MaxValue);
+        }
+
+        uint GetRandonUintBias()
+        {
+            return (uint)(Math.Abs(random.NextDouble() - random.NextDouble()) * uint.MaxValue);
+        }
+
+        ushort GetRandonUshortBias()
+        {
+            return (ushort)(Math.Abs(random.NextDouble() - random.NextDouble()) * ushort.MaxValue);
+        }
+
+        [Test]
+        [Repeat(1000)]
+        public void UnpacksCorrectUlongValue()
+        {
+            ulong start = GetRandonUlongBias();
+            VariableBlockPacker.Pack(writer, start, blockSize);
+            ulong unpacked = VariableBlockPacker.Unpack(GetReader(), blockSize);
+
+            Assert.That(unpacked, Is.EqualTo(start));
+        }
+
+        [Test]
+        [Repeat(1000)]
+        public void UnpacksCorrectUintValue()
+        {
+            uint start = GetRandonUintBias();
+            VariableBlockPacker.Pack(writer, start, blockSize);
+            ulong unpacked = VariableBlockPacker.Unpack(GetReader(), blockSize);
+
+            Assert.That(unpacked, Is.EqualTo(start));
+        }
+
+        [Test]
+        [Repeat(1000)]
+        public void UnpacksCorrectUshortValue()
+        {
+            ushort start = GetRandonUshortBias();
+            VariableBlockPacker.Pack(writer, start, blockSize);
+            ulong unpacked = VariableBlockPacker.Unpack(GetReader(), blockSize);
+
+            Assert.That(unpacked, Is.EqualTo(start));
+        }
+
+        [Test]
+        public void WritesNplus1BitsPerBlock()
+        {
+            uint zero = 0u;
+            VariableBlockPacker.Pack(writer, zero, blockSize);
+            Assert.That(writer.BitPosition, Is.EqualTo(blockSize + 1));
+
+            ulong unpacked = VariableBlockPacker.Unpack(GetReader(), blockSize);
+            Assert.That(unpacked, Is.EqualTo(zero));
+        }
+
+        [Test]
+        public void WritesNplus1BitsPerBlock_bigger()
+        {
+            uint aboveBlockSize = (1u << blockSize) + 1u;
+            VariableBlockPacker.Pack(writer, aboveBlockSize, blockSize);
+            Assert.That(writer.BitPosition, Is.EqualTo(2 * (blockSize + 1)));
+
+            ulong unpacked = VariableBlockPacker.Unpack(GetReader(), blockSize);
+            Assert.That(unpacked, Is.EqualTo(aboveBlockSize));
+        }
+    }
+}
diff --git a/Assets/Tests/Runtime/Serialization/Packers/UintBlockPackerTests.cs.meta b/Assets/Tests/Runtime/Serialization/Packers/UintBlockPackerTests.cs.meta
new file mode 100644
index 00000000000..684e86c9c72
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/Packers/UintBlockPackerTests.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 043048420116fc54582eaf333e5bf6d8
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Runtime/Serialization/Packers/UintPackerCreateTest.cs b/Assets/Tests/Runtime/Serialization/Packers/UintPackerCreateTest.cs
new file mode 100644
index 00000000000..482688b23c8
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/Packers/UintPackerCreateTest.cs
@@ -0,0 +1,139 @@
+using System;
+using Mirage.Serialization;
+using NUnit.Framework;
+
+namespace Mirage.Tests.Runtime.Serialization.Packers
+{
+    public class UintPackerCreateTest : PackerTestBase
+    {
+        [Test]
+        [TestCase(0ul, 50ul, 1000ul, ExpectedResult = 6 + 1)]
+        [TestCase(60ul, 50ul, 1000ul, ExpectedResult = 6 + 1, Description = "50 rounds up to 64, so v=60 is still small")]
+        [TestCase(100ul, 50ul, 1000ul, ExpectedResult = 10 + 2)]
+        [TestCase(100ul, 500ul, 100000ul, ExpectedResult = 9 + 1)]
+        [TestCase(501ul, 500ul, 100000ul, ExpectedResult = 9 + 1)]
+        [TestCase(5_000ul, 500ul, 100000ul, ExpectedResult = 17 + 2)]
+        [TestCase(5_000_000ul, 500ul, 100000ul, ExpectedResult = 64 + 2)]
+        public int CreatesUsing2Values(ulong inValue, ulong smallValue, ulong mediumValue)
+        {
+            var packer = new VariableIntPacker(smallValue, mediumValue);
+            packer.PackUlong(writer, inValue);
+            return writer.BitPosition;
+        }
+
+
+        [Test]
+        [TestCase(0ul, 50ul, 1000ul, 50_000ul, ExpectedResult = 6 + 1)]
+        [TestCase(60ul, 50ul, 1000ul, 50_000ul, ExpectedResult = 6 + 1, Description = "50 rounds up to 64, so v=60 is still small")]
+        [TestCase(100ul, 50ul, 1000ul, 50_000ul, ExpectedResult = 10 + 2)]
+        [TestCase(5000ul, 50ul, 1000ul, 50_000ul, ExpectedResult = 16 + 2)]
+        [TestCase(100ul, 500ul, 100_000ul, 50_000_000ul, ExpectedResult = 9 + 1)]
+        [TestCase(501ul, 500ul, 100_000ul, 50_000_000ul, ExpectedResult = 9 + 1)]
+        [TestCase(5_000ul, 500ul, 100_000ul, 50_000_000ul, ExpectedResult = 17 + 2)]
+        [TestCase(5_000_000ul, 500ul, 100_000ul, 50_000_000ul, ExpectedResult = 26 + 2)]
+        public int CreatesUsing3Values(ulong inValue, ulong smallValue, ulong mediumValue, ulong largeValue)
+        {
+            var packer = new VariableIntPacker(smallValue, mediumValue, largeValue);
+            packer.PackUlong(writer, inValue);
+            return writer.BitPosition;
+        }
+
+
+        [Test]
+        public void ThrowsIfSmallBitIsZero()
+        {
+            ArgumentException exception = Assert.Throws<ArgumentException>(() =>
+            {
+                _ = VariableIntPacker.FromBitCount(0, 10);
+            });
+            var expected = new ArgumentException("Small value can not be zero", "smallBits");
+            Assert.That(exception, Has.Message.EqualTo(expected.Message));
+        }
+        [Test]
+        public void ThrowsIfMediumLessThanSmall()
+        {
+            ArgumentException exception = Assert.Throws<ArgumentException>(() =>
+            {
+                _ = VariableIntPacker.FromBitCount(6, 5);
+            });
+            var expected = new ArgumentException("Medium value must be greater than small value", "mediumBits");
+            Assert.That(exception, Has.Message.EqualTo(expected.Message));
+        }
+        [Test]
+        public void ThrowsIfLargeLessThanMedium()
+        {
+            ArgumentException exception = Assert.Throws<ArgumentException>(() =>
+            {
+                _ = VariableIntPacker.FromBitCount(4, 10, 8);
+            });
+            var expected = new ArgumentException("Large value must be greater than medium value", "largeBits");
+            Assert.That(exception, Has.Message.EqualTo(expected.Message));
+        }
+        [Test]
+        public void ThrowsIfLargeIsOver64()
+        {
+            ArgumentException exception = Assert.Throws<ArgumentException>(() =>
+            {
+                _ = VariableIntPacker.FromBitCount(5, 10, 65);
+            });
+            var expected = new ArgumentException("Large bits must be 64 or less", "largeBits");
+            Assert.That(exception, Has.Message.EqualTo(expected.Message));
+        }
+        [Test]
+        public void ThrowsIfMediumIsOver62()
+        {
+            ArgumentException exception = Assert.Throws<ArgumentException>(() =>
+            {
+                _ = VariableIntPacker.FromBitCount(5, 63);
+            });
+            var expected = new ArgumentException("Medium bits must be 62 or less", "mediumBits");
+            Assert.That(exception, Has.Message.EqualTo(expected.Message));
+        }
+
+        [Test]
+        public void ThrowsWhenValueIsOverLargeValue()
+        {
+            var packer = VariableIntPacker.FromBitCount(1, 2, 3, true);
+            ArgumentOutOfRangeException exception1 = Assert.Throws<ArgumentOutOfRangeException>(() =>
+            {
+                packer.PackUlong(writer, 20);
+            });
+            ArgumentOutOfRangeException exception2 = Assert.Throws<ArgumentOutOfRangeException>(() =>
+            {
+                packer.PackUint(writer, 20);
+            });
+            ArgumentOutOfRangeException exception3 = Assert.Throws<ArgumentOutOfRangeException>(() =>
+            {
+                packer.PackUlong(writer, 20);
+            });
+            var expected = new ArgumentOutOfRangeException("value", 20, $"Value is over max of {7}");
+            Assert.That(exception1, Has.Message.EqualTo(expected.Message));
+            Assert.That(exception2, Has.Message.EqualTo(expected.Message));
+            Assert.That(exception3, Has.Message.EqualTo(expected.Message));
+        }
+
+        [Test]
+        [TestCase(20ul, 3)]
+        [TestCase(260ul, 8)]
+        [TestCase(50_000ul, 10)]
+        public void WritesMaxIfOverLargeValue(ulong inValue, int largeBits)
+        {
+            ulong max = BitMask.Mask(largeBits);
+            var packer = VariableIntPacker.FromBitCount(1, 2, largeBits, false);
+            Assert.DoesNotThrow(() =>
+            {
+                packer.PackUlong(writer, inValue);
+                packer.PackUint(writer, (uint)inValue);
+                packer.PackUlong(writer, (ushort)inValue);
+            });
+            NetworkReader reader = GetReader();
+            ulong unpack1 = packer.UnpackUlong(reader);
+            uint unpack2 = packer.UnpackUint(reader);
+            ushort unpack3 = packer.UnpackUshort(reader);
+
+            Assert.That(unpack1, Is.EqualTo(max));
+            Assert.That(unpack2, Is.EqualTo(max));
+            Assert.That(unpack3, Is.EqualTo(max));
+        }
+    }
+}
diff --git a/Assets/Tests/Runtime/Serialization/Packers/UintPackerCreateTest.cs.meta b/Assets/Tests/Runtime/Serialization/Packers/UintPackerCreateTest.cs.meta
new file mode 100644
index 00000000000..52abcb236b9
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/Packers/UintPackerCreateTest.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: ba07df19a3e3850409d63c96e0b3cab0
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Runtime/Serialization/Packers/UintPackerTests.cs b/Assets/Tests/Runtime/Serialization/Packers/UintPackerTests.cs
new file mode 100644
index 00000000000..e8a3741968b
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/Packers/UintPackerTests.cs
@@ -0,0 +1,83 @@
+using System;
+using Mirage.Serialization;
+using NUnit.Framework;
+using Random = System.Random;
+
+namespace Mirage.Tests.Runtime.Serialization.Packers
+{
+    [TestFixture(50ul, 1_000ul, null)]
+    [TestFixture(250ul, 10_000ul, null)]
+    [TestFixture(500ul, 100_000ul, null)]
+    [TestFixture(50ul, 1_000ul, 10_000_000ul)]
+    [TestFixture(250ul, 10_000ul, 10_000_000ul)]
+    [TestFixture(500ul, 100_000ul, 10_000_000ul)]
+    public class UintPackerTests : PackerTestBase
+    {
+        readonly Random random = new Random();
+        readonly VariableIntPacker packer;
+        readonly ulong max;
+
+        public UintPackerTests(ulong smallValue, ulong mediumValue, ulong? largeValue)
+        {
+            if (largeValue.HasValue)
+            {
+                packer = new VariableIntPacker(smallValue, mediumValue, largeValue.Value, false);
+                max = largeValue.Value;
+            }
+            else
+            {
+                packer = new VariableIntPacker(smallValue, mediumValue);
+                max = ulong.MaxValue;
+            }
+        }
+
+
+        ulong GetRandonUlongBias()
+        {
+            return (ulong)(Math.Abs(random.NextDouble() - random.NextDouble()) * max);
+        }
+
+        uint GetRandonUintBias()
+        {
+            return (uint)(Math.Abs(random.NextDouble() - random.NextDouble()) * Math.Min(max, uint.MaxValue));
+        }
+
+        ushort GetRandonUshortBias()
+        {
+            return (ushort)(Math.Abs(random.NextDouble() - random.NextDouble()) * Math.Min(max, ushort.MaxValue));
+        }
+
+        [Test]
+        [Repeat(1000)]
+        public void UnpacksCorrectUlongValue()
+        {
+            ulong start = GetRandonUlongBias();
+            packer.PackUlong(writer, start);
+            ulong unpacked = packer.UnpackUlong(GetReader());
+
+            Assert.That(unpacked, Is.EqualTo(start));
+        }
+
+        [Test]
+        [Repeat(1000)]
+        public void UnpacksCorrectUintValue()
+        {
+            uint start = GetRandonUintBias();
+            packer.PackUint(writer, start);
+            uint unpacked = packer.UnpackUint(GetReader());
+
+            Assert.That(unpacked, Is.EqualTo(start));
+        }
+
+        [Test]
+        [Repeat(1000)]
+        public void UnpacksCorrectUshortValue()
+        {
+            ushort start = GetRandonUshortBias();
+            packer.PackUshort(writer, start);
+            ushort unpacked = packer.UnpackUshort(GetReader());
+
+            Assert.That(unpacked, Is.EqualTo(start));
+        }
+    }
+}
diff --git a/Assets/Tests/Runtime/Serialization/Packers/UintPackerTests.cs.meta b/Assets/Tests/Runtime/Serialization/Packers/UintPackerTests.cs.meta
new file mode 100644
index 00000000000..b4cddd945d9
--- /dev/null
+++ b/Assets/Tests/Runtime/Serialization/Packers/UintPackerTests.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 5bb3717be6b5a6143b7ac20ce5ddc740
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

From 2ca4f5be75d122578d8a48455368d97f7e4f5f5d Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Tue, 17 Aug 2021 16:01:14 +0100
Subject: [PATCH 104/166] refactor: moving zig zag encoding to its own class
 (#879)

* moving zig zag encoding to its own class

* fixing error in ulong encode
---
 .../Runtime/Serialization/PackedExtensions.cs | 12 ++++---
 .../Runtime/Serialization/Packers/ZigZag.cs   | 31 +++++++++++++++++++
 .../Serialization/Packers/ZigZag.cs.meta      | 11 +++++++
 3 files changed, 50 insertions(+), 4 deletions(-)
 create mode 100644 Assets/Mirage/Runtime/Serialization/Packers/ZigZag.cs
 create mode 100644 Assets/Mirage/Runtime/Serialization/Packers/ZigZag.cs.meta

diff --git a/Assets/Mirage/Runtime/Serialization/PackedExtensions.cs b/Assets/Mirage/Runtime/Serialization/PackedExtensions.cs
index a8c56f9ccfe..9e6f54ced03 100644
--- a/Assets/Mirage/Runtime/Serialization/PackedExtensions.cs
+++ b/Assets/Mirage/Runtime/Serialization/PackedExtensions.cs
@@ -1,4 +1,5 @@
 using System;
+using System.Runtime.CompilerServices;
 
 namespace Mirage.Serialization
 {
@@ -8,21 +9,24 @@ namespace Mirage.Serialization
     /// </remarks>
     public static class PackedExtensions
     {
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
         public static void WritePackedInt32(this NetworkWriter writer, int i)
         {
-            uint zigzagged = (uint)((i >> 31) ^ (i << 1));
+            uint zigzagged = ZigZag.Encode(i);
             writer.WritePackedUInt32(zigzagged);
         }
 
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
         public static void WritePackedUInt32(this NetworkWriter writer, uint value)
         {
             // we can use uint64 here because it will be same bits once packed
             writer.WritePackedUInt64(value);
         }
 
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
         public static void WritePackedInt64(this NetworkWriter writer, long i)
         {
-            ulong zigzagged = (ulong)((i >> 63) ^ (i << 1));
+            ulong zigzagged = ZigZag.Encode(i);
             writer.WritePackedUInt64(zigzagged);
         }
 
@@ -76,7 +80,7 @@ public static void WritePackedUInt64(this NetworkWriter writer, ulong value)
         public static int ReadPackedInt32(this NetworkReader reader)
         {
             uint data = reader.ReadPackedUInt32();
-            return (int)((data >> 1) ^ -(data & 1));
+            return ZigZag.Decode(data);
         }
 
         /// <exception cref="OverflowException">throws if values overflows uint</exception>
@@ -85,7 +89,7 @@ public static int ReadPackedInt32(this NetworkReader reader)
         public static long ReadPackedInt64(this NetworkReader reader)
         {
             ulong data = reader.ReadPackedUInt64();
-            return ((long)(data >> 1)) ^ -((long)data & 1);
+            return ZigZag.Decode(data);
         }
 
         public static ulong ReadPackedUInt64(this NetworkReader reader)
diff --git a/Assets/Mirage/Runtime/Serialization/Packers/ZigZag.cs b/Assets/Mirage/Runtime/Serialization/Packers/ZigZag.cs
new file mode 100644
index 00000000000..606209ee36b
--- /dev/null
+++ b/Assets/Mirage/Runtime/Serialization/Packers/ZigZag.cs
@@ -0,0 +1,31 @@
+using System.Runtime.CompilerServices;
+
+namespace Mirage.Serialization
+{
+    /// <summary>
+    /// See <see href="https://gist.github.com/mfuerstenau/ba870a29e16536fdbaba">zigzag encoding</see><br/>
+    /// </summary>
+    public static class ZigZag
+    {
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public static uint Encode(int v)
+        {
+            return (uint)((v >> 31) ^ (v << 1));
+        }
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public static ulong Encode(long v)
+        {
+            return (ulong)((v >> 63) ^ (v << 1));
+        }
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public static int Decode(uint v)
+        {
+            return (int)((v >> 1) ^ -(v & 1));
+        }
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public static long Decode(ulong v)
+        {
+            return ((long)(v >> 1)) ^ -((long)v & 1);
+        }
+    }
+}
diff --git a/Assets/Mirage/Runtime/Serialization/Packers/ZigZag.cs.meta b/Assets/Mirage/Runtime/Serialization/Packers/ZigZag.cs.meta
new file mode 100644
index 00000000000..13b71e3e993
--- /dev/null
+++ b/Assets/Mirage/Runtime/Serialization/Packers/ZigZag.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: fced96ad9167cb14a875d6dace9f55bc
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

From 5ccb42e2c9fdc94bc0e2edec7f669a075f89b604 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Tue, 17 Aug 2021 16:04:54 +0100
Subject: [PATCH 105/166] fix: fixing pong example

---
 .../Mirage/Samples~/Pong/Scripts/PaddleSpawner.cs | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/Assets/Mirage/Samples~/Pong/Scripts/PaddleSpawner.cs b/Assets/Mirage/Samples~/Pong/Scripts/PaddleSpawner.cs
index 100dbeb5c65..b3057f681cb 100644
--- a/Assets/Mirage/Samples~/Pong/Scripts/PaddleSpawner.cs
+++ b/Assets/Mirage/Samples~/Pong/Scripts/PaddleSpawner.cs
@@ -10,6 +10,16 @@ public class PaddleSpawner : CharacterSpawner
 
         GameObject ball;
 
+        public override void Awake()
+        {
+            base.Awake();
+
+            if (Server != null)
+            {
+                Server.Disconnected.AddListener(OnServerAddPlayer);
+            }
+        }
+
         public override void OnServerAddPlayer(INetworkPlayer player)
         {
             // add player at correct spawn position
@@ -25,10 +35,9 @@ public override void OnServerAddPlayer(INetworkPlayer player)
             }
         }
 
-
-        public void OnServerDisconnect(INetworkPlayer player)
+        public void OnServerDisconnect(INetworkPlayer _)
         {
-            // destroy ball
+            // after 1 player disconnects then destroy the balll
             if (ball != null)
                 ServerObjectManager.Destroy(ball);
         }

From 57f725083deb3bbef3f584a9d0ca0fb7d6d84a7f Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Tue, 17 Aug 2021 16:06:10 +0100
Subject: [PATCH 106/166] style: moving weaver ignore attribute to serialize
 folder

---
 Assets/Mirage/Runtime/CustomAttributes.cs             |  6 ------
 .../Mirage/Runtime/Serialization/WeaverAttributes.cs  | 10 ++++++++++
 .../Runtime/Serialization/WeaverAttributes.cs.meta    | 11 +++++++++++
 3 files changed, 21 insertions(+), 6 deletions(-)
 create mode 100644 Assets/Mirage/Runtime/Serialization/WeaverAttributes.cs
 create mode 100644 Assets/Mirage/Runtime/Serialization/WeaverAttributes.cs.meta

diff --git a/Assets/Mirage/Runtime/CustomAttributes.cs b/Assets/Mirage/Runtime/CustomAttributes.cs
index bee5eecc05e..7dd34553f72 100644
--- a/Assets/Mirage/Runtime/CustomAttributes.cs
+++ b/Assets/Mirage/Runtime/CustomAttributes.cs
@@ -124,10 +124,4 @@ public sealed class ShowInInspectorAttribute : Attribute { }
     /// </summary>
     [AttributeUsage(AttributeTargets.Field)]
     public sealed class FoldoutEventAttribute : PropertyAttribute { }
-
-    /// <summary>
-    /// Tells Weaver to ignore an Extension method
-    /// </summary>
-    [AttributeUsage(AttributeTargets.Method)]
-    public sealed class WeaverIgnoreAttribute : PropertyAttribute { }
 }
diff --git a/Assets/Mirage/Runtime/Serialization/WeaverAttributes.cs b/Assets/Mirage/Runtime/Serialization/WeaverAttributes.cs
new file mode 100644
index 00000000000..48b208476e5
--- /dev/null
+++ b/Assets/Mirage/Runtime/Serialization/WeaverAttributes.cs
@@ -0,0 +1,10 @@
+using System;
+
+namespace Mirage.Serialization
+{
+    /// <summary>
+    /// Tells Weaver to ignore an Extension method
+    /// </summary>
+    [AttributeUsage(AttributeTargets.Method)]
+    public sealed class WeaverIgnoreAttribute : Attribute { }
+}
\ No newline at end of file
diff --git a/Assets/Mirage/Runtime/Serialization/WeaverAttributes.cs.meta b/Assets/Mirage/Runtime/Serialization/WeaverAttributes.cs.meta
new file mode 100644
index 00000000000..1bddeb1607a
--- /dev/null
+++ b/Assets/Mirage/Runtime/Serialization/WeaverAttributes.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 19b36a836fcbdaa40a44b360d1de570a
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

From 9ee9c41273aa878b466a333009c7cd0182f42dd1 Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Tue, 17 Aug 2021 15:21:58 +0000
Subject: [PATCH 107/166] chore(release): 101.4.0 [skip ci]

# [101.4.0](https://github.com/MirageNet/Mirage/compare/v101.3.0...v101.4.0) (2021-08-17)

### Bug Fixes

* fixing pong example ([5ccb42e](https://github.com/MirageNet/Mirage/commit/5ccb42e2c9fdc94bc0e2edec7f669a075f89b604))

### Features

* adding helper classes for packing uint values ([#878](https://github.com/MirageNet/Mirage/issues/878)) ([3c24f67](https://github.com/MirageNet/Mirage/commit/3c24f67dc6140c9c711b26837ea5b9c8220c1cc1))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs         |  2 +-
 Assets/Mirage/CHANGELOG.md                           | 12 ++++++++++++
 Assets/Mirage/Components/AssemblyInfo.cs             |  2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                |  2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs    |  2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs               |  2 +-
 .../RigidbodyPhysics/Scripts/AssemblyInfo.cs         |  2 +-
 Assets/Mirage/package.json                           |  2 +-
 8 files changed, 19 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index 0c2aa0cd453..c16a5a36256 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.3.0")]
+[assembly: AssemblyVersion("101.4.0")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index d98fb145925..c2bf45d29b8 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,15 @@
+# [101.4.0](https://github.com/MirageNet/Mirage/compare/v101.3.0...v101.4.0) (2021-08-17)
+
+
+### Bug Fixes
+
+* fixing pong example ([5ccb42e](https://github.com/MirageNet/Mirage/commit/5ccb42e2c9fdc94bc0e2edec7f669a075f89b604))
+
+
+### Features
+
+* adding helper classes for packing uint values ([#878](https://github.com/MirageNet/Mirage/issues/878)) ([3c24f67](https://github.com/MirageNet/Mirage/commit/3c24f67dc6140c9c711b26837ea5b9c8220c1cc1))
+
 # [101.3.0](https://github.com/MirageNet/Mirage/compare/v101.2.0...v101.3.0) (2021-08-16)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index c904953d0a4..4bda5fe08cf 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.3.0")]
+[assembly: AssemblyVersion("101.4.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index cf442311f6d..aa7c84737b1 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.3.0")]
+[assembly: AssemblyVersion("101.4.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index 865c1e9a612..d0ce2a7a313 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.3.0")]
+[assembly: AssemblyVersion("101.4.0")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index 0c2aa0cd453..c16a5a36256 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.3.0")]
+[assembly: AssemblyVersion("101.4.0")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index 0c2aa0cd453..c16a5a36256 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.3.0")]
+[assembly: AssemblyVersion("101.4.0")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 710331e16e8..ac26d90ee44 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "101.3.0",
+    "version": "101.4.0",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From fd25ea76219903d6be14fd0d068c8a2151638a87 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Wed, 18 Aug 2021 00:21:50 +0100
Subject: [PATCH 108/166] refactor(weaver): adding extra log methods

---
 Assets/Mirage/Weaver/IWeaverLogger.cs |  7 +++++--
 Assets/Mirage/Weaver/Logger.cs        | 23 ++++++++++++++++++-----
 2 files changed, 23 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Weaver/IWeaverLogger.cs b/Assets/Mirage/Weaver/IWeaverLogger.cs
index 062f601d79c..eaf0ba12c8f 100644
--- a/Assets/Mirage/Weaver/IWeaverLogger.cs
+++ b/Assets/Mirage/Weaver/IWeaverLogger.cs
@@ -1,4 +1,4 @@
-using Mono.Cecil;
+using Mono.Cecil;
 using Mono.Cecil.Cil;
 
 namespace Mirage.Weaver
@@ -9,7 +9,10 @@ public interface IWeaverLogger
         void Error(string message, MemberReference mr);
         void Error(string message, MemberReference mr, SequencePoint sequencePoint);
         void Error(string message, MethodDefinition md);
+
         void Warning(string message);
         void Warning(string message, MemberReference mr);
+        void Warning(string message, MemberReference mr, SequencePoint sequencePoint);
+        void Warning(string message, MethodDefinition md);
     }
-}
\ No newline at end of file
+}
diff --git a/Assets/Mirage/Weaver/Logger.cs b/Assets/Mirage/Weaver/Logger.cs
index 1c0273ad193..cb1f19dde13 100644
--- a/Assets/Mirage/Weaver/Logger.cs
+++ b/Assets/Mirage/Weaver/Logger.cs
@@ -12,6 +12,7 @@ public class Logger : IWeaverLogger
     {
         public List<DiagnosticMessage> Diagnostics = new List<DiagnosticMessage>();
 
+
         public void Error(string message)
         {
             AddMessage(message, null, DiagnosticType.Error);
@@ -22,14 +23,20 @@ public void Error(string message, MemberReference mr)
             Error($"{message} (at {mr})");
         }
 
+        public void Error(string message, MemberReference mr, SequencePoint sequencePoint)
+        {
+            AddMessage($"{message} (at {mr})", sequencePoint, DiagnosticType.Error);
+        }
+
         public void Error(string message, MethodDefinition md)
         {
-            AddMessage($"{message} (at {md})", md.DebugInformation.SequencePoints.FirstOrDefault(), DiagnosticType.Error);
+            Error(message, md, md.DebugInformation.SequencePoints.FirstOrDefault());
         }
 
-        public void Error(string message, MemberReference mr, SequencePoint sequencePoint)
+
+        public void Warning(string message)
         {
-            AddMessage($"{message} (at {mr})", sequencePoint, DiagnosticType.Error);
+            AddMessage($"{message}", null, DiagnosticType.Warning);
         }
 
         public void Warning(string message, MemberReference mr)
@@ -37,11 +44,17 @@ public void Warning(string message, MemberReference mr)
             Warning($"{message} (at {mr})");
         }
 
-        public void Warning(string message)
+        public void Warning(string message, MemberReference mr, SequencePoint sequencePoint)
         {
-            AddMessage($"{message}", null, DiagnosticType.Warning);
+            AddMessage($"{message} (at {mr})", sequencePoint, DiagnosticType.Warning);
         }
 
+        public void Warning(string message, MethodDefinition md)
+        {
+            Warning(message, md, md.DebugInformation.SequencePoints.FirstOrDefault());
+        }
+
+
         private void AddMessage(string message, SequencePoint sequencePoint, DiagnosticType diagnosticType)
         {
             Diagnostics.Add(new DiagnosticMessage

From 74ebb718af4a47315ec3fb42c71e16a4533dee97 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Wed, 18 Aug 2021 00:22:42 +0100
Subject: [PATCH 109/166] refactor(weaver): adding sequence point to weaver
 exception

---
 Assets/Mirage/Weaver/IWeaverLogger.cs    |  8 ++++++++
 Assets/Mirage/Weaver/WeaverExceptions.cs | 18 ++++++++----------
 2 files changed, 16 insertions(+), 10 deletions(-)

diff --git a/Assets/Mirage/Weaver/IWeaverLogger.cs b/Assets/Mirage/Weaver/IWeaverLogger.cs
index eaf0ba12c8f..e5ec8136bcf 100644
--- a/Assets/Mirage/Weaver/IWeaverLogger.cs
+++ b/Assets/Mirage/Weaver/IWeaverLogger.cs
@@ -15,4 +15,12 @@ public interface IWeaverLogger
         void Warning(string message, MemberReference mr, SequencePoint sequencePoint);
         void Warning(string message, MethodDefinition md);
     }
+
+    public static class WeaverLoggerExtensions
+    {
+        public static void Error(this IWeaverLogger logger, WeaverException exception)
+        {
+            logger.Error(exception.Message, exception.MemberReference, exception.SequencePoint);
+        }
+    }
 }
diff --git a/Assets/Mirage/Weaver/WeaverExceptions.cs b/Assets/Mirage/Weaver/WeaverExceptions.cs
index 6af7ef18934..2ee0437ae5d 100644
--- a/Assets/Mirage/Weaver/WeaverExceptions.cs
+++ b/Assets/Mirage/Weaver/WeaverExceptions.cs
@@ -1,25 +1,23 @@
 using System;
 using Mono.Cecil;
+using Mono.Cecil.Cil;
 
 namespace Mirage.Weaver
 {
-    [Serializable]
     public abstract class WeaverException : Exception
     {
-        public MemberReference MemberReference { get; }
+        public readonly SequencePoint SequencePoint;
+        public readonly MemberReference MemberReference;
 
-        protected WeaverException(string message, MemberReference member) : base(message)
+        protected WeaverException(string message, MemberReference memberReference, SequencePoint sequencePoint) : base(message)
         {
-            MemberReference = member;
+            SequencePoint = sequencePoint;
+            MemberReference = memberReference;
         }
-
-        protected WeaverException(System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext) : base(serializationInfo, streamingContext) { }
     }
 
-    [Serializable]
-    public class GenerateWriterException : WeaverException
+    public class SerializeFunctionException : WeaverException
     {
-        public GenerateWriterException(string message, MemberReference member) : base(message, member) { }
-        protected GenerateWriterException(System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext) : base(serializationInfo, streamingContext) { }
+        public SerializeFunctionException(string message, MemberReference memberReference, SequencePoint sequencePoint) : base(message, memberReference, sequencePoint) { }
     }
 }

From 10f8adbb27552c923268a437eb55f93012b056f2 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Wed, 18 Aug 2021 00:27:17 +0100
Subject: [PATCH 110/166] refactor(weaver): create base class for Writers and
 Readers

---
 .../Processors/ReaderWriterProcessor.cs       | 12 ++--
 .../Mirage/Weaver/Processors/RpcProcessor.cs  |  4 +-
 .../Weaver/Processors/SyncObjectProcessor.cs  |  4 +-
 .../Weaver/Processors/SyncVarProcessor.cs     |  8 +--
 Assets/Mirage/Weaver/Readers.cs               | 56 +++------------
 Assets/Mirage/Weaver/SerializeFunctionBase.cs | 68 ++++++++++++++++++
 .../Weaver/SerializeFunctionBase.cs.meta      | 11 +++
 Assets/Mirage/Weaver/Writers.cs               | 70 ++++---------------
 8 files changed, 116 insertions(+), 117 deletions(-)
 create mode 100644 Assets/Mirage/Weaver/SerializeFunctionBase.cs
 create mode 100644 Assets/Mirage/Weaver/SerializeFunctionBase.cs.meta

diff --git a/Assets/Mirage/Weaver/Processors/ReaderWriterProcessor.cs b/Assets/Mirage/Weaver/Processors/ReaderWriterProcessor.cs
index 06c8939db0a..888903b03eb 100644
--- a/Assets/Mirage/Weaver/Processors/ReaderWriterProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/ReaderWriterProcessor.cs
@@ -67,8 +67,8 @@ private void LoadBuiltinMessages()
             foreach (Type type in types)
             {
                 TypeReference typeReference = module.ImportReference(type);
-                writers.GetWriteFunc(typeReference, null);
-                readers.GetReadFunc(typeReference, null);
+                writers.GetFunction(typeReference, null);
+                readers.GetFunction(typeReference, null);
                 messages.Add(typeReference);
             }
         }
@@ -99,8 +99,8 @@ private void ProcessClass(TypeDefinition klass)
 
             if (klass.HasCustomAttribute<NetworkMessageAttribute>())
             {
-                readers.GetReadFunc(klass, null);
-                writers.GetWriteFunc(klass, null);
+                readers.GetFunction(klass, null);
+                writers.GetFunction(klass, null);
                 messages.Add(klass);
             }
 
@@ -182,8 +182,8 @@ private void GenerateReadersWriters(TypeReference parameterType, SequencePoint s
                         return;
                 }
 
-                writers.GetWriteFunc(parameterType, sequencePoint);
-                readers.GetReadFunc(parameterType, sequencePoint);
+                writers.GetFunction(parameterType, sequencePoint);
+                readers.GetFunction(parameterType, sequencePoint);
             }
         }
 
diff --git a/Assets/Mirage/Weaver/Processors/RpcProcessor.cs b/Assets/Mirage/Weaver/Processors/RpcProcessor.cs
index 4c2c6c38069..03e387ad597 100644
--- a/Assets/Mirage/Weaver/Processors/RpcProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/RpcProcessor.cs
@@ -69,7 +69,7 @@ public bool WriteArguments(ILProcessor worker, MethodDefinition method, Variable
                     continue;
                 }
 
-                MethodReference writeFunc = writers.GetWriteFunc(param.ParameterType, method.DebugInformation.SequencePoints.FirstOrDefault());
+                MethodReference writeFunc = writers.GetFunction(param.ParameterType, method.DebugInformation.SequencePoints.FirstOrDefault());
                 if (writeFunc == null)
                 {
                     logger.Error($"{method.Name} has invalid parameter {param}", method, method.DebugInformation.SequencePoints.FirstOrDefault());
@@ -116,7 +116,7 @@ public bool ReadArguments(MethodDefinition method, ILProcessor worker, bool skip
                 }
 
                 SequencePoint sequencePoint = method.DebugInformation.SequencePoints.ElementAtOrDefault(0);
-                MethodReference readFunc = readers.GetReadFunc(param.ParameterType, sequencePoint);
+                MethodReference readFunc = readers.GetFunction(param.ParameterType, sequencePoint);
 
                 if (readFunc == null)
                 {
diff --git a/Assets/Mirage/Weaver/Processors/SyncObjectProcessor.cs b/Assets/Mirage/Weaver/Processors/SyncObjectProcessor.cs
index 116e8dfc3c9..ef18fae0fef 100644
--- a/Assets/Mirage/Weaver/Processors/SyncObjectProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncObjectProcessor.cs
@@ -72,8 +72,8 @@ void GenerateReadersAndWriters(TypeReference tr)
                 {
                     if (!argument.IsGenericParameter)
                     {
-                        readers.GetReadFunc(argument, null);
-                        writers.GetWriteFunc(argument, null);
+                        readers.GetFunction(argument, null);
+                        writers.GetFunction(argument, null);
                     }
                 }
             }
diff --git a/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs b/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
index f0ca19d43c2..fb386a0f5a6 100644
--- a/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
@@ -504,7 +504,7 @@ void GenerateSerialization(TypeDefinition netBehaviourSubclass)
             // base
             worker.Append(worker.Create(OpCodes.Ldarg_0));
             worker.Append(worker.Create(OpCodes.Call, (NetworkBehaviour nb) => nb.SyncVarDirtyBits));
-            MethodReference writeUint64Func = writers.GetWriteFunc<ulong>(null);
+            MethodReference writeUint64Func = writers.GetFunction<ulong>(null);
             worker.Append(worker.Create(OpCodes.Call, writeUint64Func));
 
             // generate a writer call for any dirty variable in this class
@@ -549,7 +549,7 @@ private void WriteVariable(ILProcessor worker, ParameterDefinition writerParamet
             // this
             worker.Append(worker.Create(OpCodes.Ldarg_0));
             worker.Append(worker.Create(OpCodes.Ldfld, syncVar.MakeHostGenericIfNeeded()));
-            MethodReference writeFunc = writers.GetWriteFunc(syncVar.FieldType, null);
+            MethodReference writeFunc = writers.GetFunction(syncVar.FieldType, null);
             if (writeFunc != null)
             {
                 worker.Append(worker.Create(OpCodes.Call, writeFunc));
@@ -614,7 +614,7 @@ void GenerateDeSerialization(TypeDefinition netBehaviourSubclass)
 
             // get dirty bits
             serWorker.Append(serWorker.Create(OpCodes.Ldarg, readerParam));
-            serWorker.Append(serWorker.Create(OpCodes.Call, readers.GetReadFunc<ulong>(null)));
+            serWorker.Append(serWorker.Create(OpCodes.Call, readers.GetFunction<ulong>(null)));
             serWorker.Append(serWorker.Create(OpCodes.Stloc, dirtyBitsLocal));
 
             // conditionally read each syncvar
@@ -662,7 +662,7 @@ void DeserializeField(FieldDefinition syncVar, ILProcessor serWorker, MethodDefi
                     OnSetA(oldValue, Networka);
                 }
              */
-            MethodReference readFunc = readers.GetReadFunc(syncVar.FieldType, null);
+            MethodReference readFunc = readers.GetFunction(syncVar.FieldType, null);
             if (readFunc == null)
             {
                 logger.Error($"{syncVar.Name} has unsupported type. Use a supported Mirage type instead", syncVar);
diff --git a/Assets/Mirage/Weaver/Readers.cs b/Assets/Mirage/Weaver/Readers.cs
index 67eeca5b9fd..538e9bc5d17 100644
--- a/Assets/Mirage/Weaver/Readers.cs
+++ b/Assets/Mirage/Weaver/Readers.cs
@@ -9,43 +9,14 @@
 
 namespace Mirage.Weaver
 {
-    public class Readers
+    public class Readers : SerializeFunctionBase
     {
-        readonly Dictionary<TypeReference, MethodReference> readFuncs = new Dictionary<TypeReference, MethodReference>(new TypeReferenceComparer());
+        public Readers(ModuleDefinition module, IWeaverLogger logger) : base(module, logger) { }
 
-        private readonly ModuleDefinition module;
-        private readonly IWeaverLogger logger;
+        protected override string FunctionTypeLog => "Read";
 
-        public int Count => readFuncs.Count;
-
-        public Readers(ModuleDefinition module, IWeaverLogger logger)
+        protected override MethodReference GenerateFunction(TypeReference typeReference, SequencePoint sequencePoint)
         {
-            this.module = module;
-            this.logger = logger;
-        }
-
-        internal void Register(TypeReference dataType, MethodReference methodReference)
-        {
-            if (readFuncs.ContainsKey(dataType))
-            {
-                logger.Warning($"Registering a Read method for {dataType.FullName} when one already exists\n  old:{readFuncs[dataType].FullName}\n  new:{methodReference.FullName}", methodReference);
-            }
-
-            TypeReference imported = module.ImportReference(dataType);
-            readFuncs[imported] = methodReference;
-        }
-
-        public MethodReference GetReadFunc<T>(SequencePoint sequencePoint) =>
-            GetReadFunc(module.ImportReference<T>(), sequencePoint);
-
-        public MethodReference GetReadFunc(TypeReference typeReference, SequencePoint sequencePoint)
-        {
-            if (readFuncs.TryGetValue(typeReference, out MethodReference foundFunc))
-            {
-                return foundFunc;
-            }
-
-            typeReference = module.ImportReference(typeReference);
             if (typeReference.IsMultidimensionalArray())
             {
                 logger.Error($"{typeReference.Name} is an unsupported type. Multidimensional arrays are not supported", typeReference, sequencePoint);
@@ -143,11 +114,6 @@ private MethodReference GetNetworkBehaviourReader(TypeReference typeReference)
             return readerFunc;
         }
 
-        void RegisterReadFunc(TypeReference typeReference, MethodDefinition newReaderFunc)
-        {
-            readFuncs[typeReference] = newReaderFunc;
-        }
-
         MethodDefinition GenerateEnumReadFunc(TypeReference variable, SequencePoint sequencePoint)
         {
             MethodDefinition readerFunc = GenerateReaderFunction(variable);
@@ -157,7 +123,7 @@ MethodDefinition GenerateEnumReadFunc(TypeReference variable, SequencePoint sequ
             worker.Append(worker.Create(OpCodes.Ldarg_0));
 
             TypeReference underlyingType = variable.Resolve().GetEnumUnderlyingType();
-            MethodReference underlyingFunc = GetReadFunc(underlyingType, sequencePoint);
+            MethodReference underlyingFunc = GetFunction(underlyingType, sequencePoint);
 
             worker.Append(worker.Create(OpCodes.Call, underlyingFunc));
             worker.Append(worker.Create(OpCodes.Ret));
@@ -176,7 +142,7 @@ MethodDefinition GenerateArraySegmentReadFunc(TypeReference variable, SequencePo
             // $array = reader.Read<[T]>()
             ArrayType arrayType = elementType.MakeArrayType();
             worker.Append(worker.Create(OpCodes.Ldarg_0));
-            worker.Append(worker.Create(OpCodes.Call, GetReadFunc(arrayType, sequencePoint)));
+            worker.Append(worker.Create(OpCodes.Call, GetFunction(arrayType, sequencePoint)));
 
             // return new ArraySegment<T>($array);
             MethodReference arraySegmentConstructor = module.ImportReference(() => new ArraySegment<object>());
@@ -198,7 +164,7 @@ private MethodDefinition GenerateReaderFunction(TypeReference variable)
 
             _ = readerFunc.AddParam<NetworkReader>("reader");
             readerFunc.Body.InitLocals = true;
-            RegisterReadFunc(variable, readerFunc);
+            Register(variable, readerFunc);
 
             return readerFunc;
         }
@@ -207,7 +173,7 @@ MethodDefinition GenerateReadCollection(TypeReference variable, TypeReference el
         {
             MethodDefinition readerFunc = GenerateReaderFunction(variable);
             // generate readers for the element
-            GetReadFunc(elementType, sequencePoint);
+            GetFunction(elementType, sequencePoint);
 
             MethodReference listReader = module.ImportReference(readerFunction);
 
@@ -255,7 +221,7 @@ private void GenerateNullCheck(ILProcessor worker, SequencePoint sequencePoint)
             //   return null;
             // }
             worker.Append(worker.Create(OpCodes.Ldarg_0));
-            worker.Append(worker.Create(OpCodes.Call, GetReadFunc<bool>(sequencePoint)));
+            worker.Append(worker.Create(OpCodes.Call, GetFunction<bool>(sequencePoint)));
 
             Instruction labelEmptyArray = worker.Create(OpCodes.Nop);
             worker.Append(worker.Create(OpCodes.Brtrue, labelEmptyArray));
@@ -309,7 +275,7 @@ void ReadAllFields(TypeReference variable, ILProcessor worker, SequencePoint seq
                 OpCode opcode = variable.IsValueType ? OpCodes.Ldloca : OpCodes.Ldloc;
                 worker.Append(worker.Create(opcode, 0));
 
-                MethodReference readFunc = GetReadFunc(field.FieldType, sequencePoint);
+                MethodReference readFunc = GetFunction(field.FieldType, sequencePoint);
                 if (readFunc != null)
                 {
                     worker.Append(worker.Create(OpCodes.Ldarg_0));
@@ -340,7 +306,7 @@ internal void InitializeReaders(ILProcessor worker)
             TypeReference funcRef = module.ImportReference(typeof(Func<,>));
             MethodReference funcConstructorRef = module.ImportReference(typeof(Func<,>).GetConstructors()[0]);
 
-            foreach (MethodReference readFunc in readFuncs.Values)
+            foreach (MethodReference readFunc in funcs.Values)
             {
                 TypeReference dataType = readFunc.ReturnType;
 
diff --git a/Assets/Mirage/Weaver/SerializeFunctionBase.cs b/Assets/Mirage/Weaver/SerializeFunctionBase.cs
new file mode 100644
index 00000000000..8b59ccfd44e
--- /dev/null
+++ b/Assets/Mirage/Weaver/SerializeFunctionBase.cs
@@ -0,0 +1,68 @@
+using System.Collections.Generic;
+using Mono.Cecil;
+using Mono.Cecil.Cil;
+
+namespace Mirage.Weaver
+{
+    public abstract class SerializeFunctionBase
+    {
+        protected readonly Dictionary<TypeReference, MethodReference> funcs = new Dictionary<TypeReference, MethodReference>(new TypeReferenceComparer());
+        protected readonly IWeaverLogger logger;
+        protected readonly ModuleDefinition module;
+
+        public int Count => funcs.Count;
+
+        /// <summary>
+        /// Type used for logging, eg write or read
+        /// </summary>
+        protected abstract string FunctionTypeLog { get; }
+
+        protected SerializeFunctionBase(ModuleDefinition module, IWeaverLogger logger)
+        {
+            this.logger = logger;
+            this.module = module;
+        }
+
+
+        public void Register(TypeReference dataType, MethodReference methodReference)
+        {
+            if (funcs.ContainsKey(dataType))
+            {
+                logger.Warning(
+                    $"Registering a {FunctionTypeLog} method for {dataType.FullName} when one already exists\n" +
+                    $"  old:{funcs[dataType].FullName}\n" +
+                    $"  new:{methodReference.FullName}",
+                    methodReference.Resolve());
+            }
+
+            // we need to import type when we Initialize Writers so import here in case it is used anywhere else
+            TypeReference imported = module.ImportReference(dataType);
+            funcs[imported] = methodReference;
+        }
+
+        public MethodReference GetFunction<T>(SequencePoint sequencePoint) =>
+            GetFunction(module.ImportReference<T>(), sequencePoint);
+
+        public MethodReference GetFunction(TypeReference typeReference, SequencePoint sequencePoint)
+        {
+            if (funcs.TryGetValue(typeReference, out MethodReference foundFunc))
+            {
+                return foundFunc;
+            }
+            else
+            {
+                try
+                {
+                    return GenerateFunction(module.ImportReference(typeReference), sequencePoint);
+                }
+                catch (SerializeFunctionException e)
+                {
+                    logger.Error(e);
+                    return null;
+                }
+            }
+        }
+
+        protected abstract MethodReference GenerateFunction(TypeReference typeReference, SequencePoint sequencePoint);
+    }
+}
diff --git a/Assets/Mirage/Weaver/SerializeFunctionBase.cs.meta b/Assets/Mirage/Weaver/SerializeFunctionBase.cs.meta
new file mode 100644
index 00000000000..9d9429f19ff
--- /dev/null
+++ b/Assets/Mirage/Weaver/SerializeFunctionBase.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 1cf99dc9b071da849aa6c6dccbde2e30
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Weaver/Writers.cs b/Assets/Mirage/Weaver/Writers.cs
index c276cd77838..88b9dccf5ae 100644
--- a/Assets/Mirage/Weaver/Writers.cs
+++ b/Assets/Mirage/Weaver/Writers.cs
@@ -8,61 +8,15 @@
 
 namespace Mirage.Weaver
 {
-    public class Writers
-    {
-        readonly Dictionary<TypeReference, MethodReference> writeFuncs = new Dictionary<TypeReference, MethodReference>(new TypeReferenceComparer());
-
-        public int Count => writeFuncs.Count;
-
-        private readonly IWeaverLogger logger;
-        private readonly ModuleDefinition module;
-
-        public Writers(ModuleDefinition module, IWeaverLogger logger)
-        {
-            this.logger = logger;
-            this.module = module;
-        }
-
-        public void Register(TypeReference dataType, MethodReference methodReference)
-        {
-            if (writeFuncs.ContainsKey(dataType))
-            {
-                logger.Warning($"Registering a Write method for {dataType.FullName} when one already exists\n  old:{writeFuncs[dataType].FullName}\n  new:{methodReference.FullName}", methodReference);
-            }
-
-            // we need to import type when we Initialize Writers so import here in case it is used anywhere else
-            TypeReference imported = module.ImportReference(dataType);
-            writeFuncs[imported] = methodReference;
-        }
-
-        void RegisterWriteFunc(TypeReference typeReference, MethodDefinition newWriterFunc)
-        {
-            // todo can we remove this method? it was same as Register above
-            // see for static version https://github.com/vis2k/Mirror/blob/master/Assets/Mirror/Editor/Weaver/Writers.cs#L33-L38 
-            writeFuncs[typeReference] = newWriterFunc;
-        }
 
-        public MethodReference GetWriteFunc<T>(SequencePoint sequencePoint) =>
-            GetWriteFunc(module.ImportReference<T>(), sequencePoint);
+    public class Writers : SerializeFunctionBase
+    {
+        public Writers(ModuleDefinition module, IWeaverLogger logger) : base(module, logger) { }
 
-        /// <summary>
-        /// Finds existing writer for type, if non exists trys to create one
-        /// <para>This method is recursive</para>
-        /// </summary>
-        /// <param name="typeReference"></param>
-        /// <param name="recursionCount"></param>
-        /// <returns>Returns <see cref="MethodReference"/> or null</returns>
-        public MethodReference GetWriteFunc(TypeReference typeReference, SequencePoint sequencePoint)
-        {
-            if (writeFuncs.TryGetValue(typeReference, out MethodReference foundFunc))
-            {
-                return foundFunc;
-            }
-            return GenerateWriter(module.ImportReference(typeReference), sequencePoint);
-        }
+        protected override string FunctionTypeLog => "Write";
 
         /// <exception cref="GenerateWriterException">Throws when writer could not be generated for type</exception>
-        MethodReference GenerateWriter(TypeReference typeReference, SequencePoint sequencePoint)
+        protected override MethodReference GenerateFunction(TypeReference typeReference, SequencePoint sequencePoint)
         {
             if (typeReference.IsByReference)
             {
@@ -171,7 +125,7 @@ private MethodDefinition GenerateEnumWriteFunc(TypeReference typeReference, Sequ
 
             ILProcessor worker = writerFunc.Body.GetILProcessor();
 
-            MethodReference underlyingWriter = GetWriteFunc(typeReference.Resolve().GetEnumUnderlyingType(), sequencePoint);
+            MethodReference underlyingWriter = GetFunction(typeReference.Resolve().GetEnumUnderlyingType(), sequencePoint);
 
             worker.Append(worker.Create(OpCodes.Ldarg_0));
             worker.Append(worker.Create(OpCodes.Ldarg_1));
@@ -194,7 +148,7 @@ private MethodDefinition GenerateWriterFunc(TypeReference typeReference)
             _ = writerFunc.AddParam(typeReference, "value");
             writerFunc.Body.InitLocals = true;
 
-            RegisterWriteFunc(typeReference, writerFunc);
+            Register(typeReference, writerFunc);
             return writerFunc;
         }
 
@@ -228,14 +182,14 @@ private void WriteNullCheck(ILProcessor worker, SequencePoint sequencePoint)
             worker.Append(worker.Create(OpCodes.Brtrue, labelNotNull));
             worker.Append(worker.Create(OpCodes.Ldarg_0));
             worker.Append(worker.Create(OpCodes.Ldc_I4_0));
-            worker.Append(worker.Create(OpCodes.Call, GetWriteFunc<bool>(sequencePoint)));
+            worker.Append(worker.Create(OpCodes.Call, GetFunction<bool>(sequencePoint)));
             worker.Append(worker.Create(OpCodes.Ret));
             worker.Append(labelNotNull);
 
             // write.WriteBoolean(true);
             worker.Append(worker.Create(OpCodes.Ldarg_0));
             worker.Append(worker.Create(OpCodes.Ldc_I4_1));
-            worker.Append(worker.Create(OpCodes.Call, GetWriteFunc<bool>(sequencePoint)));
+            worker.Append(worker.Create(OpCodes.Call, GetFunction<bool>(sequencePoint)));
         }
 
         /// <summary>
@@ -249,7 +203,7 @@ bool WriteAllFields(TypeReference variable, ILProcessor worker, SequencePoint se
             uint fields = 0;
             foreach (FieldDefinition field in variable.FindAllPublicFields())
             {
-                MethodReference writeFunc = GetWriteFunc(field.FieldType, sequencePoint);
+                MethodReference writeFunc = GetFunction(field.FieldType, sequencePoint);
                 // need this null check till later PR when GetWriteFunc throws exception instead
                 if (writeFunc == null) { return false; }
 
@@ -270,7 +224,7 @@ MethodDefinition GenerateCollectionWriter(TypeReference variable, TypeReference
 
             MethodDefinition writerFunc = GenerateWriterFunc(variable);
 
-            MethodReference elementWriteFunc = GetWriteFunc(elementType, sequencePoint);
+            MethodReference elementWriteFunc = GetFunction(elementType, sequencePoint);
 
             // need this null check till later PR when GetWriteFunc throws exception instead
             if (elementWriteFunc == null)
@@ -312,7 +266,7 @@ internal void InitializeWriters(ILProcessor worker)
             TypeReference actionRef = module.ImportReference(typeof(Action<,>));
             MethodReference actionConstructorRef = module.ImportReference(typeof(Action<,>).GetConstructors()[0]);
 
-            foreach (MethodReference writerMethod in writeFuncs.Values)
+            foreach (MethodReference writerMethod in funcs.Values)
             {
 
                 TypeReference dataType = writerMethod.Parameters[1].ParameterType;

From abee944ed9c674a8018406ce832f7f832158a050 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Wed, 18 Aug 2021 01:34:20 +0100
Subject: [PATCH 111/166] refactor(weaver): merging a lot of code into base
 class and using throws instead of null checks

---
 Assets/Mirage/Weaver/IWeaverLogger.cs         |   5 +
 .../Processors/ReaderWriterProcessor.cs       |  12 +-
 .../Mirage/Weaver/Processors/RpcProcessor.cs  |   4 +-
 .../Weaver/Processors/SyncObjectProcessor.cs  |   4 +-
 .../Weaver/Processors/SyncVarProcessor.cs     |   8 +-
 Assets/Mirage/Weaver/Readers.cs               | 143 +++------------
 Assets/Mirage/Weaver/SerializeFunctionBase.cs | 165 ++++++++++++++++--
 Assets/Mirage/Weaver/WeaverExceptions.cs      |   2 +-
 Assets/Mirage/Weaver/Writers.cs               | 146 +++-------------
 9 files changed, 222 insertions(+), 267 deletions(-)

diff --git a/Assets/Mirage/Weaver/IWeaverLogger.cs b/Assets/Mirage/Weaver/IWeaverLogger.cs
index e5ec8136bcf..ab1122c03c5 100644
--- a/Assets/Mirage/Weaver/IWeaverLogger.cs
+++ b/Assets/Mirage/Weaver/IWeaverLogger.cs
@@ -22,5 +22,10 @@ public static void Error(this IWeaverLogger logger, WeaverException exception)
         {
             logger.Error(exception.Message, exception.MemberReference, exception.SequencePoint);
         }
+
+        public static void Error(this IWeaverLogger logger, WeaverException exception, SequencePoint sequencePoint)
+        {
+            logger.Error(exception.Message, exception.MemberReference, sequencePoint);
+        }
     }
 }
diff --git a/Assets/Mirage/Weaver/Processors/ReaderWriterProcessor.cs b/Assets/Mirage/Weaver/Processors/ReaderWriterProcessor.cs
index 888903b03eb..500de63a235 100644
--- a/Assets/Mirage/Weaver/Processors/ReaderWriterProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/ReaderWriterProcessor.cs
@@ -67,8 +67,8 @@ private void LoadBuiltinMessages()
             foreach (Type type in types)
             {
                 TypeReference typeReference = module.ImportReference(type);
-                writers.GetFunction(typeReference, null);
-                readers.GetFunction(typeReference, null);
+                writers.TryGetFunction(typeReference, null);
+                readers.TryGetFunction(typeReference, null);
                 messages.Add(typeReference);
             }
         }
@@ -99,8 +99,8 @@ private void ProcessClass(TypeDefinition klass)
 
             if (klass.HasCustomAttribute<NetworkMessageAttribute>())
             {
-                readers.GetFunction(klass, null);
-                writers.GetFunction(klass, null);
+                readers.TryGetFunction(klass, null);
+                writers.TryGetFunction(klass, null);
                 messages.Add(klass);
             }
 
@@ -182,8 +182,8 @@ private void GenerateReadersWriters(TypeReference parameterType, SequencePoint s
                         return;
                 }
 
-                writers.GetFunction(parameterType, sequencePoint);
-                readers.GetFunction(parameterType, sequencePoint);
+                writers.TryGetFunction(parameterType, sequencePoint);
+                readers.TryGetFunction(parameterType, sequencePoint);
             }
         }
 
diff --git a/Assets/Mirage/Weaver/Processors/RpcProcessor.cs b/Assets/Mirage/Weaver/Processors/RpcProcessor.cs
index 03e387ad597..dd40097f9bb 100644
--- a/Assets/Mirage/Weaver/Processors/RpcProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/RpcProcessor.cs
@@ -69,7 +69,7 @@ public bool WriteArguments(ILProcessor worker, MethodDefinition method, Variable
                     continue;
                 }
 
-                MethodReference writeFunc = writers.GetFunction(param.ParameterType, method.DebugInformation.SequencePoints.FirstOrDefault());
+                MethodReference writeFunc = writers.TryGetFunction(param.ParameterType, method.DebugInformation.SequencePoints.FirstOrDefault());
                 if (writeFunc == null)
                 {
                     logger.Error($"{method.Name} has invalid parameter {param}", method, method.DebugInformation.SequencePoints.FirstOrDefault());
@@ -116,7 +116,7 @@ public bool ReadArguments(MethodDefinition method, ILProcessor worker, bool skip
                 }
 
                 SequencePoint sequencePoint = method.DebugInformation.SequencePoints.ElementAtOrDefault(0);
-                MethodReference readFunc = readers.GetFunction(param.ParameterType, sequencePoint);
+                MethodReference readFunc = readers.TryGetFunction(param.ParameterType, sequencePoint);
 
                 if (readFunc == null)
                 {
diff --git a/Assets/Mirage/Weaver/Processors/SyncObjectProcessor.cs b/Assets/Mirage/Weaver/Processors/SyncObjectProcessor.cs
index ef18fae0fef..0015c0d84e4 100644
--- a/Assets/Mirage/Weaver/Processors/SyncObjectProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncObjectProcessor.cs
@@ -72,8 +72,8 @@ void GenerateReadersAndWriters(TypeReference tr)
                 {
                     if (!argument.IsGenericParameter)
                     {
-                        readers.GetFunction(argument, null);
-                        writers.GetFunction(argument, null);
+                        readers.TryGetFunction(argument, null);
+                        writers.TryGetFunction(argument, null);
                     }
                 }
             }
diff --git a/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs b/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
index fb386a0f5a6..65d305cbbc9 100644
--- a/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
@@ -504,7 +504,7 @@ void GenerateSerialization(TypeDefinition netBehaviourSubclass)
             // base
             worker.Append(worker.Create(OpCodes.Ldarg_0));
             worker.Append(worker.Create(OpCodes.Call, (NetworkBehaviour nb) => nb.SyncVarDirtyBits));
-            MethodReference writeUint64Func = writers.GetFunction<ulong>(null);
+            MethodReference writeUint64Func = writers.TryGetFunction<ulong>(null);
             worker.Append(worker.Create(OpCodes.Call, writeUint64Func));
 
             // generate a writer call for any dirty variable in this class
@@ -549,7 +549,7 @@ private void WriteVariable(ILProcessor worker, ParameterDefinition writerParamet
             // this
             worker.Append(worker.Create(OpCodes.Ldarg_0));
             worker.Append(worker.Create(OpCodes.Ldfld, syncVar.MakeHostGenericIfNeeded()));
-            MethodReference writeFunc = writers.GetFunction(syncVar.FieldType, null);
+            MethodReference writeFunc = writers.TryGetFunction(syncVar.FieldType, null);
             if (writeFunc != null)
             {
                 worker.Append(worker.Create(OpCodes.Call, writeFunc));
@@ -614,7 +614,7 @@ void GenerateDeSerialization(TypeDefinition netBehaviourSubclass)
 
             // get dirty bits
             serWorker.Append(serWorker.Create(OpCodes.Ldarg, readerParam));
-            serWorker.Append(serWorker.Create(OpCodes.Call, readers.GetFunction<ulong>(null)));
+            serWorker.Append(serWorker.Create(OpCodes.Call, readers.TryGetFunction<ulong>(null)));
             serWorker.Append(serWorker.Create(OpCodes.Stloc, dirtyBitsLocal));
 
             // conditionally read each syncvar
@@ -662,7 +662,7 @@ void DeserializeField(FieldDefinition syncVar, ILProcessor serWorker, MethodDefi
                     OnSetA(oldValue, Networka);
                 }
              */
-            MethodReference readFunc = readers.GetFunction(syncVar.FieldType, null);
+            MethodReference readFunc = readers.TryGetFunction(syncVar.FieldType, null);
             if (readFunc == null)
             {
                 logger.Error($"{syncVar.Name} has unsupported type. Use a supported Mirage type instead", syncVar);
diff --git a/Assets/Mirage/Weaver/Readers.cs b/Assets/Mirage/Weaver/Readers.cs
index 538e9bc5d17..bc468526d20 100644
--- a/Assets/Mirage/Weaver/Readers.cs
+++ b/Assets/Mirage/Weaver/Readers.cs
@@ -1,5 +1,4 @@
 using System;
-using System.Collections.Generic;
 using System.Linq.Expressions;
 using Mirage.Serialization;
 using Mono.Cecil;
@@ -13,96 +12,13 @@ public class Readers : SerializeFunctionBase
     {
         public Readers(ModuleDefinition module, IWeaverLogger logger) : base(module, logger) { }
 
-        protected override string FunctionTypeLog => "Read";
+        protected override string FunctionTypeLog => "read function";
 
-        protected override MethodReference GenerateFunction(TypeReference typeReference, SequencePoint sequencePoint)
-        {
-            if (typeReference.IsMultidimensionalArray())
-            {
-                logger.Error($"{typeReference.Name} is an unsupported type. Multidimensional arrays are not supported", typeReference, sequencePoint);
-                return null;
-            }
-
-            if (typeReference.IsArray)
-            {
-                return GenerateReadCollection(typeReference, typeReference.GetElementType(), () => CollectionExtensions.ReadArray<object>(default), sequencePoint);
-            }
-
-            TypeDefinition variableDefinition = typeReference.Resolve();
-
-            if (variableDefinition == null)
-            {
-                logger.Error($"{typeReference.Name} is not a supported type", typeReference, sequencePoint);
-                return null;
-            }
-
-            if (typeReference.Is(typeof(Nullable<>)))
-            {
-                var genericInstance = (GenericInstanceType)typeReference;
-                TypeReference elementType = genericInstance.GenericArguments[0];
+        protected override Expression<Action> ArrayExpression => () => CollectionExtensions.ReadArray<byte>(default);
+        protected override Expression<Action> ListExpression => () => CollectionExtensions.ReadList<byte>(default);
+        protected override Expression<Action> NullableExpression => () => SystemTypesExtensions.ReadNullable<byte>(default);
 
-                return GenerateReadCollection(typeReference, elementType, () => SystemTypesExtensions.ReadNullable<byte>(default), sequencePoint);
-            }
-            if (variableDefinition.Is(typeof(ArraySegment<>)))
-            {
-                return GenerateArraySegmentReadFunc(typeReference, sequencePoint);
-            }
-            if (variableDefinition.Is(typeof(List<>)))
-            {
-                var genericInstance = (GenericInstanceType)typeReference;
-                TypeReference elementType = genericInstance.GenericArguments[0];
-
-                return GenerateReadCollection(typeReference, elementType, () => CollectionExtensions.ReadList<object>(default), sequencePoint);
-            }
-            if (variableDefinition.IsEnum)
-            {
-                return GenerateEnumReadFunc(typeReference, sequencePoint);
-            }
-            if (variableDefinition.IsDerivedFrom<NetworkBehaviour>())
-            {
-                return GetNetworkBehaviourReader(typeReference);
-            }
-            if (variableDefinition.IsDerivedFrom<Component>())
-            {
-                logger.Error($"Cannot generate reader for component type {typeReference.Name}. Use a supported type or provide a custom reader", typeReference, sequencePoint);
-                return null;
-            }
-            if (typeReference.Is<UnityEngine.Object>())
-            {
-                logger.Error($"Cannot generate reader for {typeReference.Name}. Use a supported type or provide a custom reader", typeReference, sequencePoint);
-                return null;
-            }
-            if (typeReference.Is<ScriptableObject>())
-            {
-                logger.Error($"Cannot generate reader for {typeReference.Name}. Use a supported type or provide a custom reader", typeReference, sequencePoint);
-                return null;
-            }
-            if (typeReference.IsByReference)
-            {
-                // error??
-                logger.Error($"Cannot pass type {typeReference.Name} by reference", typeReference, sequencePoint);
-                return null;
-            }
-            if (variableDefinition.HasGenericParameters)
-            {
-                logger.Error($"Cannot generate reader for generic variable {typeReference.Name}. Use a supported type or provide a custom reader", typeReference, sequencePoint);
-                return null;
-            }
-            if (variableDefinition.IsInterface)
-            {
-                logger.Error($"Cannot generate reader for interface {typeReference.Name}. Use a supported type or provide a custom reader", typeReference, sequencePoint);
-                return null;
-            }
-            if (variableDefinition.IsAbstract)
-            {
-                logger.Error($"Cannot generate reader for abstract class {typeReference.Name}. Use a supported type or provide a custom reader", typeReference, sequencePoint);
-                return null;
-            }
-
-            return GenerateClassOrStructReadFunction(typeReference, sequencePoint);
-        }
-
-        private MethodReference GetNetworkBehaviourReader(TypeReference typeReference)
+        protected override MethodReference GetNetworkBehaviourFunction(TypeReference typeReference)
         {
             MethodDefinition readerFunc = GenerateReaderFunction(typeReference);
             ILProcessor worker = readerFunc.Body.GetILProcessor();
@@ -114,7 +30,7 @@ private MethodReference GetNetworkBehaviourReader(TypeReference typeReference)
             return readerFunc;
         }
 
-        MethodDefinition GenerateEnumReadFunc(TypeReference variable, SequencePoint sequencePoint)
+        protected override MethodReference GenerateEnumFunction(TypeReference variable)
         {
             MethodDefinition readerFunc = GenerateReaderFunction(variable);
 
@@ -123,17 +39,16 @@ MethodDefinition GenerateEnumReadFunc(TypeReference variable, SequencePoint sequ
             worker.Append(worker.Create(OpCodes.Ldarg_0));
 
             TypeReference underlyingType = variable.Resolve().GetEnumUnderlyingType();
-            MethodReference underlyingFunc = GetFunction(underlyingType, sequencePoint);
+            MethodReference underlyingFunc = TryGetFunction(underlyingType, null);
 
             worker.Append(worker.Create(OpCodes.Call, underlyingFunc));
             worker.Append(worker.Create(OpCodes.Ret));
             return readerFunc;
         }
 
-        MethodDefinition GenerateArraySegmentReadFunc(TypeReference variable, SequencePoint sequencePoint)
+        protected override MethodReference GenerateSegmentFunction(TypeReference variable, TypeReference elementType)
         {
             var genericInstance = (GenericInstanceType)variable;
-            TypeReference elementType = genericInstance.GenericArguments[0];
 
             MethodDefinition readerFunc = GenerateReaderFunction(variable);
 
@@ -142,7 +57,7 @@ MethodDefinition GenerateArraySegmentReadFunc(TypeReference variable, SequencePo
             // $array = reader.Read<[T]>()
             ArrayType arrayType = elementType.MakeArrayType();
             worker.Append(worker.Create(OpCodes.Ldarg_0));
-            worker.Append(worker.Create(OpCodes.Call, GetFunction(arrayType, sequencePoint)));
+            worker.Append(worker.Create(OpCodes.Call, GetFunction_Thorws(arrayType)));
 
             // return new ArraySegment<T>($array);
             MethodReference arraySegmentConstructor = module.ImportReference(() => new ArraySegment<object>());
@@ -169,11 +84,12 @@ private MethodDefinition GenerateReaderFunction(TypeReference variable)
             return readerFunc;
         }
 
-        MethodDefinition GenerateReadCollection(TypeReference variable, TypeReference elementType, Expression<Action> readerFunction, SequencePoint sequencePoint)
+        protected override MethodReference GenerateCollectionFunction(TypeReference variable, TypeReference elementType, Expression<Action> readerFunction)
         {
-            MethodDefinition readerFunc = GenerateReaderFunction(variable);
             // generate readers for the element
-            GetFunction(elementType, sequencePoint);
+            _ = GetFunction_Thorws(elementType);
+
+            MethodDefinition readerFunc = GenerateReaderFunction(variable);
 
             MethodReference listReader = module.ImportReference(readerFunction);
 
@@ -192,7 +108,7 @@ MethodDefinition GenerateReadCollection(TypeReference variable, TypeReference el
             return readerFunc;
         }
 
-        MethodDefinition GenerateClassOrStructReadFunction(TypeReference type, SequencePoint sequencePoint)
+        protected override MethodReference GenerateClassOrStructFunction(TypeReference type)
         {
             MethodDefinition readerFunc = GenerateReaderFunction(type);
 
@@ -205,23 +121,23 @@ MethodDefinition GenerateClassOrStructReadFunction(TypeReference type, SequenceP
             TypeDefinition td = type.Resolve();
 
             if (!td.IsValueType)
-                GenerateNullCheck(worker, sequencePoint);
+                GenerateNullCheck(worker);
 
-            CreateNew(variable, worker, td, sequencePoint);
-            ReadAllFields(type, worker, sequencePoint);
+            CreateNew(variable, worker, td);
+            ReadAllFields(type, worker);
 
             worker.Append(worker.Create(OpCodes.Ldloc, variable));
             worker.Append(worker.Create(OpCodes.Ret));
             return readerFunc;
         }
 
-        private void GenerateNullCheck(ILProcessor worker, SequencePoint sequencePoint)
+        private void GenerateNullCheck(ILProcessor worker)
         {
             // if (!reader.ReadBoolean()) {
             //   return null;
             // }
             worker.Append(worker.Create(OpCodes.Ldarg_0));
-            worker.Append(worker.Create(OpCodes.Call, GetFunction<bool>(sequencePoint)));
+            worker.Append(worker.Create(OpCodes.Call, TryGetFunction<bool>(null)));
 
             Instruction labelEmptyArray = worker.Create(OpCodes.Nop);
             worker.Append(worker.Create(OpCodes.Brtrue, labelEmptyArray));
@@ -232,7 +148,7 @@ private void GenerateNullCheck(ILProcessor worker, SequencePoint sequencePoint)
         }
 
         // Initialize the local variable with a new instance
-        void CreateNew(VariableDefinition variable, ILProcessor worker, TypeDefinition td, SequencePoint sequencePoint)
+        void CreateNew(VariableDefinition variable, ILProcessor worker, TypeDefinition td)
         {
             TypeReference type = variable.VariableType;
             if (type.IsValueType)
@@ -255,8 +171,7 @@ void CreateNew(VariableDefinition variable, ILProcessor worker, TypeDefinition t
                 MethodDefinition ctor = Resolvers.ResolveDefaultPublicCtor(type);
                 if (ctor == null)
                 {
-                    logger.Error($"{type.Name} can't be deserialized because it has no default constructor", type, sequencePoint);
-                    return;
+                    throw new SerializeFunctionException($"{type.Name} can't be deserialized because it has no default constructor", type);
                 }
 
                 MethodReference ctorRef = worker.Body.Method.Module.ImportReference(ctor);
@@ -266,7 +181,7 @@ void CreateNew(VariableDefinition variable, ILProcessor worker, TypeDefinition t
             }
         }
 
-        void ReadAllFields(TypeReference variable, ILProcessor worker, SequencePoint sequencePoint)
+        void ReadAllFields(TypeReference variable, ILProcessor worker)
         {
             uint fields = 0;
             foreach (FieldDefinition field in variable.FindAllPublicFields())
@@ -275,16 +190,10 @@ void ReadAllFields(TypeReference variable, ILProcessor worker, SequencePoint seq
                 OpCode opcode = variable.IsValueType ? OpCodes.Ldloca : OpCodes.Ldloc;
                 worker.Append(worker.Create(opcode, 0));
 
-                MethodReference readFunc = GetFunction(field.FieldType, sequencePoint);
-                if (readFunc != null)
-                {
-                    worker.Append(worker.Create(OpCodes.Ldarg_0));
-                    worker.Append(worker.Create(OpCodes.Call, readFunc));
-                }
-                else
-                {
-                    logger.Error($"{field.Name} has an unsupported type", field, sequencePoint);
-                }
+                MethodReference readFunc = GetFunction_Thorws(field.FieldType);
+                worker.Append(worker.Create(OpCodes.Ldarg_0));
+                worker.Append(worker.Create(OpCodes.Call, readFunc));
+
                 FieldReference fieldRef = module.ImportReference(field);
 
                 worker.Append(worker.Create(OpCodes.Stfld, fieldRef));
diff --git a/Assets/Mirage/Weaver/SerializeFunctionBase.cs b/Assets/Mirage/Weaver/SerializeFunctionBase.cs
index 8b59ccfd44e..bfef432da1d 100644
--- a/Assets/Mirage/Weaver/SerializeFunctionBase.cs
+++ b/Assets/Mirage/Weaver/SerializeFunctionBase.cs
@@ -1,4 +1,6 @@
+using System;
 using System.Collections.Generic;
+using System.Linq.Expressions;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
 
@@ -7,7 +9,7 @@ namespace Mirage.Weaver
     public abstract class SerializeFunctionBase
     {
         protected readonly Dictionary<TypeReference, MethodReference> funcs = new Dictionary<TypeReference, MethodReference>(new TypeReferenceComparer());
-        protected readonly IWeaverLogger logger;
+        private readonly IWeaverLogger logger;
         protected readonly ModuleDefinition module;
 
         public int Count => funcs.Count;
@@ -29,7 +31,7 @@ public void Register(TypeReference dataType, MethodReference methodReference)
             if (funcs.ContainsKey(dataType))
             {
                 logger.Warning(
-                    $"Registering a {FunctionTypeLog} method for {dataType.FullName} when one already exists\n" +
+                    $"Registering a {FunctionTypeLog} for {dataType.FullName} when one already exists\n" +
                     $"  old:{funcs[dataType].FullName}\n" +
                     $"  new:{methodReference.FullName}",
                     methodReference.Resolve());
@@ -40,10 +42,44 @@ public void Register(TypeReference dataType, MethodReference methodReference)
             funcs[imported] = methodReference;
         }
 
-        public MethodReference GetFunction<T>(SequencePoint sequencePoint) =>
-            GetFunction(module.ImportReference<T>(), sequencePoint);
+        /// <summary>
+        /// Trys to get writer for type, returns null if not found
+        /// </summary>
+        /// <typeparam name="T"></typeparam>
+        /// <param name="sequencePoint"></param>
+        /// <returns>found methohd or null</returns>
+        public MethodReference TryGetFunction<T>(SequencePoint sequencePoint) =>
+            TryGetFunction(module.ImportReference<T>(), sequencePoint);
 
-        public MethodReference GetFunction(TypeReference typeReference, SequencePoint sequencePoint)
+        /// <summary>
+        /// Trys to get writer for type, returns null if not found
+        /// </summary>
+        /// <param name="typeReference"></param>
+        /// <param name="sequencePoint"></param>
+        /// <returns>found methohd or null</returns>
+        public MethodReference TryGetFunction(TypeReference typeReference, SequencePoint sequencePoint)
+        {
+            try
+            {
+                return GetFunction_Thorws(typeReference);
+            }
+            catch (SerializeFunctionException e)
+            {
+                // todo remove Sequencepoint from SerializeFunctionException, and use from parameter instead
+                logger.Error(e, sequencePoint);
+                return null;
+            }
+        }
+
+        /// <summary>
+        /// checks if function exists for type, if it does not exist it trys to generate it
+        /// </summary>
+        /// <param name="typeReference"></param>
+        /// <param name="sequencePoint"></param>
+        /// <returns></returns>
+        /// <exception cref="SerializeFunctionException">Throws if unable to find or create function</exception>
+        // todo rename this to GetFunction once other classes are able to catch Exceptio
+        public MethodReference GetFunction_Thorws(TypeReference typeReference)
         {
             if (funcs.TryGetValue(typeReference, out MethodReference foundFunc))
             {
@@ -51,18 +87,121 @@ public MethodReference GetFunction(TypeReference typeReference, SequencePoint se
             }
             else
             {
-                try
-                {
-                    return GenerateFunction(module.ImportReference(typeReference), sequencePoint);
-                }
-                catch (SerializeFunctionException e)
+                return GenerateFunction(module.ImportReference(typeReference));
+            }
+        }
+
+        private MethodReference GenerateFunction(TypeReference typeReference)
+        {
+            if (typeReference.IsByReference)
+            {
+                throw new SerializeFunctionException($"Cannot pass {typeReference.Name} by reference", typeReference);
+            }
+
+            // Arrays are special, if we resolve them, we get the element type,
+            // eg int[] resolves to int
+            // therefore process this before checks below
+            if (typeReference.IsArray)
+            {
+                if (typeReference.IsMultidimensionalArray())
                 {
-                    logger.Error(e);
-                    return null;
+                    throw new SerializeFunctionException($"{typeReference.Name} is an unsupported type. Multidimensional arrays are not supported", typeReference);
                 }
+                TypeReference elementType = typeReference.GetElementType();
+                return GenerateCollectionFunction(typeReference, elementType, ArrayExpression);
+            }
+
+            // check for collections
+            if (typeReference.Is(typeof(Nullable<>)))
+            {
+                var genericInstance = (GenericInstanceType)typeReference;
+                TypeReference elementType = genericInstance.GenericArguments[0];
+
+                return GenerateCollectionFunction(typeReference, elementType, NullableExpression);
+            }
+            if (typeReference.Is(typeof(ArraySegment<>)))
+            {
+                var genericInstance = (GenericInstanceType)typeReference;
+                TypeReference elementType = genericInstance.GenericArguments[0];
+
+                return GenerateSegmentFunction(typeReference, elementType);
+            }
+            if (typeReference.Is(typeof(List<>)))
+            {
+                var genericInstance = (GenericInstanceType)typeReference;
+                TypeReference elementType = genericInstance.GenericArguments[0];
+
+                return GenerateCollectionFunction(typeReference, elementType, ListExpression);
             }
+
+
+            // check for invalid types
+            TypeDefinition typeDefinition = typeReference.Resolve();
+            if (typeDefinition == null)
+            {
+                ThrowCantGenerate(typeReference);
+            }
+
+            if (typeDefinition.IsEnum)
+            {
+                // serialize enum as their base type
+                return GenerateEnumFunction(typeReference);
+            }
+
+            if (typeDefinition.IsDerivedFrom<NetworkBehaviour>())
+            {
+                return GetNetworkBehaviourFunction(typeReference);
+            }
+
+            // unity base types are invalid
+            if (typeDefinition.IsDerivedFrom<UnityEngine.Component>())
+            {
+                ThrowCantGenerate(typeReference, "component type");
+            }
+            if (typeReference.Is<UnityEngine.Object>())
+            {
+                ThrowCantGenerate(typeReference);
+            }
+            if (typeReference.Is<UnityEngine.ScriptableObject>())
+            {
+                ThrowCantGenerate(typeReference);
+            }
+
+
+            if (typeDefinition.HasGenericParameters)
+            {
+                ThrowCantGenerate(typeReference, "generic type");
+            }
+            if (typeDefinition.IsInterface)
+            {
+                ThrowCantGenerate(typeReference, "interface");
+            }
+            if (typeDefinition.IsAbstract)
+            {
+                ThrowCantGenerate(typeReference, "cabstract class");
+            }
+
+            // generate writer for class/struct
+            return GenerateClassOrStructFunction(typeReference);
+        }
+
+        void ThrowCantGenerate(TypeReference typeReference, string typeDescription = null)
+        {
+            string reasonStr = string.IsNullOrEmpty(typeDescription) ? string.Empty : $"{typeDescription} ";
+            throw new SerializeFunctionException($"Cannot generate {FunctionTypeLog} for {reasonStr}{typeReference.Name}. Use a supported type or provide a custom {FunctionTypeLog}", typeReference);
         }
 
-        protected abstract MethodReference GenerateFunction(TypeReference typeReference, SequencePoint sequencePoint);
+        protected abstract MethodReference GetNetworkBehaviourFunction(TypeReference typeReference);
+
+
+        protected abstract MethodReference GenerateEnumFunction(TypeReference typeReference);
+        protected abstract MethodReference GenerateCollectionFunction(TypeReference variable, TypeReference elementType, Expression<Action> writerFunction);
+        protected abstract MethodReference GenerateSegmentFunction(TypeReference variable, TypeReference elementType);
+
+        protected abstract Expression<Action> ArrayExpression { get; }
+        protected abstract Expression<Action> ListExpression { get; }
+        protected abstract Expression<Action> NullableExpression { get; }
+
+        protected abstract MethodReference GenerateClassOrStructFunction(TypeReference typeReference);
     }
 }
diff --git a/Assets/Mirage/Weaver/WeaverExceptions.cs b/Assets/Mirage/Weaver/WeaverExceptions.cs
index 2ee0437ae5d..b90830a06ac 100644
--- a/Assets/Mirage/Weaver/WeaverExceptions.cs
+++ b/Assets/Mirage/Weaver/WeaverExceptions.cs
@@ -18,6 +18,6 @@ protected WeaverException(string message, MemberReference memberReference, Seque
 
     public class SerializeFunctionException : WeaverException
     {
-        public SerializeFunctionException(string message, MemberReference memberReference, SequencePoint sequencePoint) : base(message, memberReference, sequencePoint) { }
+        public SerializeFunctionException(string message, MemberReference memberReference) : base(message, memberReference, null) { }
     }
 }
diff --git a/Assets/Mirage/Weaver/Writers.cs b/Assets/Mirage/Weaver/Writers.cs
index 88b9dccf5ae..e284c4a75bc 100644
--- a/Assets/Mirage/Weaver/Writers.cs
+++ b/Assets/Mirage/Weaver/Writers.cs
@@ -1,5 +1,4 @@
 using System;
-using System.Collections.Generic;
 using System.Linq.Expressions;
 using Mirage.Serialization;
 using Mono.Cecil;
@@ -13,119 +12,25 @@ public class Writers : SerializeFunctionBase
     {
         public Writers(ModuleDefinition module, IWeaverLogger logger) : base(module, logger) { }
 
-        protected override string FunctionTypeLog => "Write";
+        protected override string FunctionTypeLog => "write function";
+        protected override Expression<Action> ArrayExpression => () => CollectionExtensions.WriteArray<byte>(default, default);
+        protected override Expression<Action> ListExpression => () => CollectionExtensions.WriteList<byte>(default, default);
+        protected override Expression<Action> NullableExpression => () => SystemTypesExtensions.WriteNullable<byte>(default, default);
 
-        /// <exception cref="GenerateWriterException">Throws when writer could not be generated for type</exception>
-        protected override MethodReference GenerateFunction(TypeReference typeReference, SequencePoint sequencePoint)
-        {
-            if (typeReference.IsByReference)
-            {
-                logger.Error($"Cannot pass {typeReference.Name} by reference", typeReference, sequencePoint);
-                return null;
-            }
-
-            // Arrays are special, if we resolve them, we get the element type,
-            // eg int[] resolves to int
-            // therefore process this before checks below
-            if (typeReference.IsArray)
-            {
-                if (typeReference.IsMultidimensionalArray())
-                {
-                    logger.Error($"{typeReference.Name} is an unsupported type. Multidimensional arrays are not supported", typeReference, sequencePoint);
-                }
-                TypeReference elementType = typeReference.GetElementType();
-                return GenerateCollectionWriter(typeReference, elementType, () => CollectionExtensions.WriteArray<byte>(default, default), sequencePoint);
-            }
-
-            if (typeReference.Resolve()?.IsEnum ?? false)
-            {
-                // serialize enum as their base type
-                return GenerateEnumWriteFunc(typeReference, sequencePoint);
-            }
-
-            // check for collections
-            if (typeReference.Is(typeof(Nullable<>)))
-            {
-                var genericInstance = (GenericInstanceType)typeReference;
-                TypeReference elementType = genericInstance.GenericArguments[0];
-
-                return GenerateCollectionWriter(typeReference, elementType, () => SystemTypesExtensions.WriteNullable<byte>(default, default), sequencePoint);
-            }
-            if (typeReference.Is(typeof(ArraySegment<>)))
-            {
-                var genericInstance = (GenericInstanceType)typeReference;
-                TypeReference elementType = genericInstance.GenericArguments[0];
-
-                return GenerateCollectionWriter(typeReference, elementType, () => CollectionExtensions.WriteArraySegment<byte>(default, default), sequencePoint);
-            }
-            if (typeReference.Is(typeof(List<>)))
-            {
-                var genericInstance = (GenericInstanceType)typeReference;
-                TypeReference elementType = genericInstance.GenericArguments[0];
-
-                return GenerateCollectionWriter(typeReference, elementType, () => CollectionExtensions.WriteList<byte>(default, default), sequencePoint);
-            }
-
-            // check for invalid types
-            TypeDefinition typeDefinition = typeReference.Resolve();
-            if (typeDefinition == null)
-            {
-                logger.Error($"{typeReference.Name} is not a supported type. Use a supported type or provide a custom writer", typeReference, sequencePoint);
-                return null;
-            }
-            if (typeDefinition.IsDerivedFrom<NetworkBehaviour>())
-            {
-                return GetNetworkBehaviourWriter(typeReference);
-            }
-            if (typeDefinition.IsDerivedFrom<UnityEngine.Component>())
-            {
-                logger.Error($"Cannot generate writer for component type {typeReference.Name}. Use a supported type or provide a custom writer", typeReference, sequencePoint);
-                return null;
-            }
-            if (typeReference.Is<UnityEngine.Object>())
-            {
-                logger.Error($"Cannot generate writer for {typeReference.Name}. Use a supported type or provide a custom writer", typeReference, sequencePoint);
-                return null;
-            }
-            if (typeReference.Is<UnityEngine.ScriptableObject>())
-            {
-                logger.Error($"Cannot generate writer for {typeReference.Name}. Use a supported type or provide a custom writer", typeReference, sequencePoint);
-                return null;
-            }
-            if (typeDefinition.HasGenericParameters)
-            {
-                logger.Error($"Cannot generate writer for generic type {typeReference.Name}. Use a supported type or provide a custom writer", typeReference, sequencePoint);
-                return null;
-            }
-            if (typeDefinition.IsInterface)
-            {
-                logger.Error($"Cannot generate writer for interface {typeReference.Name}. Use a supported type or provide a custom writer", typeReference, sequencePoint);
-                return null;
-            }
-            if (typeDefinition.IsAbstract)
-            {
-                logger.Error($"Cannot generate writer for abstract class {typeReference.Name}. Use a supported type or provide a custom writer", typeReference, sequencePoint);
-                return null;
-            }
-
-            // generate writer for class/struct
-            return GenerateClassOrStructWriterFunction(typeReference, sequencePoint);
-        }
-
-        private MethodReference GetNetworkBehaviourWriter(TypeReference typeReference)
+        protected override MethodReference GetNetworkBehaviourFunction(TypeReference typeReference)
         {
             MethodReference writeFunc = module.ImportReference<NetworkWriter>((nw) => nw.WriteNetworkBehaviour(default));
             Register(typeReference, writeFunc);
             return writeFunc;
         }
 
-        private MethodDefinition GenerateEnumWriteFunc(TypeReference typeReference, SequencePoint sequencePoint)
+        protected override MethodReference GenerateEnumFunction(TypeReference typeReference)
         {
             MethodDefinition writerFunc = GenerateWriterFunc(typeReference);
 
             ILProcessor worker = writerFunc.Body.GetILProcessor();
 
-            MethodReference underlyingWriter = GetFunction(typeReference.Resolve().GetEnumUnderlyingType(), sequencePoint);
+            MethodReference underlyingWriter = TryGetFunction(typeReference.Resolve().GetEnumUnderlyingType(), null);
 
             worker.Append(worker.Create(OpCodes.Ldarg_0));
             worker.Append(worker.Create(OpCodes.Ldarg_1));
@@ -152,23 +57,23 @@ private MethodDefinition GenerateWriterFunc(TypeReference typeReference)
             return writerFunc;
         }
 
-        MethodDefinition GenerateClassOrStructWriterFunction(TypeReference typeReference, SequencePoint sequencePoint)
+        protected override MethodReference GenerateClassOrStructFunction(TypeReference typeReference)
         {
             MethodDefinition writerFunc = GenerateWriterFunc(typeReference);
 
             ILProcessor worker = writerFunc.Body.GetILProcessor();
 
             if (!typeReference.Resolve().IsValueType)
-                WriteNullCheck(worker, sequencePoint);
+                WriteNullCheck(worker);
 
-            if (!WriteAllFields(typeReference, worker, sequencePoint))
+            if (!WriteAllFields(typeReference, worker))
                 return writerFunc;
 
             worker.Append(worker.Create(OpCodes.Ret));
             return writerFunc;
         }
 
-        private void WriteNullCheck(ILProcessor worker, SequencePoint sequencePoint)
+        private void WriteNullCheck(ILProcessor worker)
         {
             // if (value == null)
             // {
@@ -182,14 +87,14 @@ private void WriteNullCheck(ILProcessor worker, SequencePoint sequencePoint)
             worker.Append(worker.Create(OpCodes.Brtrue, labelNotNull));
             worker.Append(worker.Create(OpCodes.Ldarg_0));
             worker.Append(worker.Create(OpCodes.Ldc_I4_0));
-            worker.Append(worker.Create(OpCodes.Call, GetFunction<bool>(sequencePoint)));
+            worker.Append(worker.Create(OpCodes.Call, TryGetFunction<bool>(null)));
             worker.Append(worker.Create(OpCodes.Ret));
             worker.Append(labelNotNull);
 
             // write.WriteBoolean(true);
             worker.Append(worker.Create(OpCodes.Ldarg_0));
             worker.Append(worker.Create(OpCodes.Ldc_I4_1));
-            worker.Append(worker.Create(OpCodes.Call, GetFunction<bool>(sequencePoint)));
+            worker.Append(worker.Create(OpCodes.Call, TryGetFunction<bool>(null)));
         }
 
         /// <summary>
@@ -198,14 +103,12 @@ private void WriteNullCheck(ILProcessor worker, SequencePoint sequencePoint)
         /// <param name="variable"></param>
         /// <param name="worker"></param>
         /// <returns>false if fail</returns>
-        bool WriteAllFields(TypeReference variable, ILProcessor worker, SequencePoint sequencePoint)
+        bool WriteAllFields(TypeReference variable, ILProcessor worker)
         {
             uint fields = 0;
             foreach (FieldDefinition field in variable.FindAllPublicFields())
             {
-                MethodReference writeFunc = GetFunction(field.FieldType, sequencePoint);
-                // need this null check till later PR when GetWriteFunc throws exception instead
-                if (writeFunc == null) { return false; }
+                MethodReference writeFunc = GetFunction_Thorws(field.FieldType);
 
                 FieldReference fieldRef = module.ImportReference(field);
 
@@ -219,20 +122,19 @@ bool WriteAllFields(TypeReference variable, ILProcessor worker, SequencePoint se
             return true;
         }
 
-        MethodDefinition GenerateCollectionWriter(TypeReference variable, TypeReference elementType, Expression<Action> writerFunction, SequencePoint sequencePoint)
+        protected override MethodReference GenerateSegmentFunction(TypeReference variable, TypeReference elementType)
+        {
+            Expression<Action> segmentExpression = () => CollectionExtensions.WriteArraySegment<byte>(default, default);
+            return GenerateCollectionFunction(variable, elementType, segmentExpression);
+        }
+        protected override MethodReference GenerateCollectionFunction(TypeReference variable, TypeReference elementType, Expression<Action> writerFunction)
         {
+            // make sure element has a writer
+            // collection writers use the generic writer, so this will make sure one exists
+            _ = GetFunction_Thorws(elementType);
 
             MethodDefinition writerFunc = GenerateWriterFunc(variable);
 
-            MethodReference elementWriteFunc = GetFunction(elementType, sequencePoint);
-
-            // need this null check till later PR when GetWriteFunc throws exception instead
-            if (elementWriteFunc == null)
-            {
-                logger.Error($"Cannot generate writer for {variable}. Use a supported type or provide a custom writer", variable, sequencePoint);
-                return writerFunc;
-            }
-
             MethodReference collectionWriter = module.ImportReference(writerFunction).GetElementMethod();
 
             var methodRef = new GenericInstanceMethod(collectionWriter);

From 40127cd73eadb558626842428055259e9e446b86 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Wed, 18 Aug 2021 14:10:06 +0100
Subject: [PATCH 112/166] test: fixing test expected error messages

---
 Assets/Mirage/Weaver/SerializeFunctionBase.cs |  2 +-
 .../Weaver/GeneratedReaderWriterTests.cs      | 47 +++++++------------
 Assets/Tests/Weaver/NetworkBehaviourTests.cs  | 28 +++++------
 Assets/Tests/Weaver/SyncDictionaryTests.cs    |  8 ++--
 Assets/Tests/Weaver/SyncListTests.cs          | 22 ++++-----
 Assets/Tests/Weaver/SyncVarTests.cs           |  6 +--
 6 files changed, 48 insertions(+), 65 deletions(-)

diff --git a/Assets/Mirage/Weaver/SerializeFunctionBase.cs b/Assets/Mirage/Weaver/SerializeFunctionBase.cs
index bfef432da1d..28bd3010f48 100644
--- a/Assets/Mirage/Weaver/SerializeFunctionBase.cs
+++ b/Assets/Mirage/Weaver/SerializeFunctionBase.cs
@@ -178,7 +178,7 @@ private MethodReference GenerateFunction(TypeReference typeReference)
             }
             if (typeDefinition.IsAbstract)
             {
-                ThrowCantGenerate(typeReference, "cabstract class");
+                ThrowCantGenerate(typeReference, "abstract class");
             }
 
             // generate writer for class/struct
diff --git a/Assets/Tests/Weaver/GeneratedReaderWriterTests.cs b/Assets/Tests/Weaver/GeneratedReaderWriterTests.cs
index 9d8c45d90ad..644311da365 100644
--- a/Assets/Tests/Weaver/GeneratedReaderWriterTests.cs
+++ b/Assets/Tests/Weaver/GeneratedReaderWriterTests.cs
@@ -87,36 +87,36 @@ public void GivesErrorWhenUsingUnityAsset()
         [Test]
         public void GivesErrorWhenUsingObject()
         {
-            HasError("Cannot generate writer for Object. Use a supported type or provide a custom writer",
+            HasError("Cannot generate write function for Object. Use a supported type or provide a custom write function",
                 "UnityEngine.Object");
-            HasError("Cannot generate reader for Object. Use a supported type or provide a custom reader",
+            HasError("Cannot generate read function for Object. Use a supported type or provide a custom read function",
                 "UnityEngine.Object");
         }
 
         [Test]
         public void GivesErrorWhenUsingScriptableObject()
         {
-            HasError("Cannot generate writer for ScriptableObject. Use a supported type or provide a custom writer",
+            HasError("Cannot generate write function for ScriptableObject. Use a supported type or provide a custom write function",
                 "UnityEngine.ScriptableObject");
-            HasError("Cannot generate reader for ScriptableObject. Use a supported type or provide a custom reader",
+            HasError("Cannot generate read function for ScriptableObject. Use a supported type or provide a custom read function",
                 "UnityEngine.ScriptableObject");
         }
 
         [Test]
         public void GivesErrorWhenUsingMonoBehaviour()
         {
-            HasError("Cannot generate writer for component type MonoBehaviour. Use a supported type or provide a custom writer",
+            HasError("Cannot generate write function for component type MonoBehaviour. Use a supported type or provide a custom write function",
                 "UnityEngine.MonoBehaviour");
-            HasError("Cannot generate reader for component type MonoBehaviour. Use a supported type or provide a custom reader",
+            HasError("Cannot generate read function for component type MonoBehaviour. Use a supported type or provide a custom read function",
                 "UnityEngine.MonoBehaviour");
         }
 
         [Test]
         public void GivesErrorWhenUsingTypeInheritedFromMonoBehaviour()
         {
-            HasError("Cannot generate writer for component type MyBehaviour. Use a supported type or provide a custom writer",
+            HasError("Cannot generate write function for component type MyBehaviour. Use a supported type or provide a custom write function",
                 "GeneratedReaderWriter.GivesErrorWhenUsingTypeInheritedFromMonoBehaviour.MyBehaviour");
-            HasError("Cannot generate reader for component type MyBehaviour. Use a supported type or provide a custom reader",
+            HasError("Cannot generate read function for component type MyBehaviour. Use a supported type or provide a custom read function",
                 "GeneratedReaderWriter.GivesErrorWhenUsingTypeInheritedFromMonoBehaviour.MyBehaviour");
         }
 
@@ -130,9 +130,9 @@ public void ExcludesNonSerializedFields()
         [Test]
         public void GivesErrorWhenUsingInterface()
         {
-            HasError("Cannot generate writer for interface IData. Use a supported type or provide a custom writer",
+            HasError("Cannot generate write function for interface IData. Use a supported type or provide a custom write function",
                 "GeneratedReaderWriter.GivesErrorWhenUsingInterface.IData");
-            HasError("Cannot generate reader for interface IData. Use a supported type or provide a custom reader",
+            HasError("Cannot generate read function for interface IData. Use a supported type or provide a custom read function",
                 "GeneratedReaderWriter.GivesErrorWhenUsingInterface.IData");
         }
 
@@ -145,10 +145,8 @@ public void CanUseCustomReadWriteForInterfaces()
         [Test]
         public void GivesErrorWhenUsingAbstractClass()
         {
-            HasError("Cannot generate writer for abstract class DataBase. Use a supported type or provide a custom writer",
-                "GeneratedReaderWriter.GivesErrorWhenUsingAbstractClass.DataBase");
-            HasError("Cannot generate reader for abstract class DataBase. Use a supported type or provide a custom reader",
-                "GeneratedReaderWriter.GivesErrorWhenUsingAbstractClass.DataBase");
+            HasError("Cannot generate write function for abstract class DataBase. Use a supported type or provide a custom write function", "GeneratedReaderWriter.GivesErrorWhenUsingAbstractClass.DataBase");
+            HasError("Cannot generate read function for abstract class DataBase. Use a supported type or provide a custom read function", "GeneratedReaderWriter.GivesErrorWhenUsingAbstractClass.DataBase");
         }
 
         [Test]
@@ -191,21 +189,15 @@ public void GivesErrorForMultidimensionalArray()
         [Test]
         public void GivesErrorForInvalidArrayType()
         {
-            HasError("Cannot generate writer for UnityEngine.MonoBehaviour[]. Use a supported type or provide a custom writer",
-                "UnityEngine.MonoBehaviour[]");
-            HasError("Cannot generate writer for component type MonoBehaviour. Use a supported type or provide a custom writer", "UnityEngine.MonoBehaviour");
-            HasError("Cannot generate writer for UnityEngine.MonoBehaviour[]. Use a supported type or provide a custom writer", "UnityEngine.MonoBehaviour[]");
-            HasError("Cannot generate reader for component type MonoBehaviour. Use a supported type or provide a custom reader", "UnityEngine.MonoBehaviour");
-
+            HasError("Cannot generate write function for component type MonoBehaviour. Use a supported type or provide a custom write function", "UnityEngine.MonoBehaviour");
+            HasError("Cannot generate read function for component type MonoBehaviour. Use a supported type or provide a custom read function", "UnityEngine.MonoBehaviour");
         }
 
         [Test]
         public void GivesErrorForInvalidArraySegmentType()
         {
-            HasError("Cannot generate writer for System.ArraySegment`1<UnityEngine.MonoBehaviour>. Use a supported type or provide a custom writer",
-                "System.ArraySegment`1<UnityEngine.MonoBehaviour>");
-            HasError("Cannot generate writer for component type MonoBehaviour. Use a supported type or provide a custom writer", "UnityEngine.MonoBehaviour");
-            HasError("Cannot generate reader for component type MonoBehaviour. Use a supported type or provide a custom reader", "UnityEngine.MonoBehaviour");
+            HasError("Cannot generate write function for component type MonoBehaviour. Use a supported type or provide a custom write function", "UnityEngine.MonoBehaviour");
+            HasError("Cannot generate read function for component type MonoBehaviour. Use a supported type or provide a custom read function", "UnityEngine.MonoBehaviour");
         }
 
         [Test]
@@ -223,11 +215,8 @@ public void CreatesForStructList()
         [Test]
         public void GivesErrorForInvalidListType()
         {
-            HasError("Cannot generate writer for System.Collections.Generic.List`1<UnityEngine.MonoBehaviour>. Use a supported type or provide a custom writer",
-                "System.Collections.Generic.List`1<UnityEngine.MonoBehaviour>");
-            HasError("Cannot generate writer for component type MonoBehaviour. Use a supported type or provide a custom writer", "UnityEngine.MonoBehaviour");
-            HasError("Cannot generate writer for System.Collections.Generic.List`1<UnityEngine.MonoBehaviour>. Use a supported type or provide a custom writer", "System.Collections.Generic.List`1<UnityEngine.MonoBehaviour>");
-            HasError("Cannot generate reader for component type MonoBehaviour. Use a supported type or provide a custom reader", "UnityEngine.MonoBehaviour");
+            HasError("Cannot generate write function for component type MonoBehaviour. Use a supported type or provide a custom write function", "UnityEngine.MonoBehaviour");
+            HasError("Cannot generate read function for component type MonoBehaviour. Use a supported type or provide a custom read function", "UnityEngine.MonoBehaviour");
         }
 
         [Test]
diff --git a/Assets/Tests/Weaver/NetworkBehaviourTests.cs b/Assets/Tests/Weaver/NetworkBehaviourTests.cs
index 66f9ea5950d..65e3b306301 100644
--- a/Assets/Tests/Weaver/NetworkBehaviourTests.cs
+++ b/Assets/Tests/Weaver/NetworkBehaviourTests.cs
@@ -112,18 +112,18 @@ public void NetworkBehaviourClientRpcParamRef()
         [Test]
         public void NetworkBehaviourClientRpcParamAbstract()
         {
-            HasError("Cannot generate writer for abstract class AbstractClass. Use a supported type or provide a custom writer", "NetworkBehaviourTests.NetworkBehaviourClientRpcParamAbstract.NetworkBehaviourClientRpcParamAbstract/AbstractClass");
+            HasError("Cannot generate write function for abstract class AbstractClass. Use a supported type or provide a custom write function", "NetworkBehaviourTests.NetworkBehaviourClientRpcParamAbstract.NetworkBehaviourClientRpcParamAbstract/AbstractClass");
             HasError("RpcCantHaveParamAbstract has invalid parameter monkeys", "System.Void NetworkBehaviourTests.NetworkBehaviourClientRpcParamAbstract.NetworkBehaviourClientRpcParamAbstract::RpcCantHaveParamAbstract(NetworkBehaviourTests.NetworkBehaviourClientRpcParamAbstract.NetworkBehaviourClientRpcParamAbstract/AbstractClass)");
-            HasError("Cannot generate reader for abstract class AbstractClass. Use a supported type or provide a custom reader", "NetworkBehaviourTests.NetworkBehaviourClientRpcParamAbstract.NetworkBehaviourClientRpcParamAbstract/AbstractClass");
+            HasError("Cannot generate read function for abstract class AbstractClass. Use a supported type or provide a custom read function", "NetworkBehaviourTests.NetworkBehaviourClientRpcParamAbstract.NetworkBehaviourClientRpcParamAbstract/AbstractClass");
             HasError("RpcCantHaveParamAbstract has invalid parameter monkeys.  Unsupported type NetworkBehaviourTests.NetworkBehaviourClientRpcParamAbstract.NetworkBehaviourClientRpcParamAbstract/AbstractClass,  use a supported Mirage type instead", "System.Void NetworkBehaviourTests.NetworkBehaviourClientRpcParamAbstract.NetworkBehaviourClientRpcParamAbstract::RpcCantHaveParamAbstract(NetworkBehaviourTests.NetworkBehaviourClientRpcParamAbstract.NetworkBehaviourClientRpcParamAbstract/AbstractClass)");
         }
 
         [Test]
         public void NetworkBehaviourClientRpcParamComponent()
         {
-            HasError("Cannot generate writer for component type ComponentClass. Use a supported type or provide a custom writer", "NetworkBehaviourTests.NetworkBehaviourClientRpcParamComponent.NetworkBehaviourClientRpcParamComponent/ComponentClass");
+            HasError("Cannot generate write function for component type ComponentClass. Use a supported type or provide a custom write function", "NetworkBehaviourTests.NetworkBehaviourClientRpcParamComponent.NetworkBehaviourClientRpcParamComponent/ComponentClass");
             HasError("RpcCantHaveParamComponent has invalid parameter monkeyComp", "System.Void NetworkBehaviourTests.NetworkBehaviourClientRpcParamComponent.NetworkBehaviourClientRpcParamComponent::RpcCantHaveParamComponent(NetworkBehaviourTests.NetworkBehaviourClientRpcParamComponent.NetworkBehaviourClientRpcParamComponent/ComponentClass)");
-            HasError("Cannot generate reader for component type ComponentClass. Use a supported type or provide a custom reader", "NetworkBehaviourTests.NetworkBehaviourClientRpcParamComponent.NetworkBehaviourClientRpcParamComponent/ComponentClass");
+            HasError("Cannot generate read function for component type ComponentClass. Use a supported type or provide a custom read function", "NetworkBehaviourTests.NetworkBehaviourClientRpcParamComponent.NetworkBehaviourClientRpcParamComponent/ComponentClass");
             HasError("RpcCantHaveParamComponent has invalid parameter monkeyComp.  Unsupported type NetworkBehaviourTests.NetworkBehaviourClientRpcParamComponent.NetworkBehaviourClientRpcParamComponent/ComponentClass,  use a supported Mirage type instead", "System.Void NetworkBehaviourTests.NetworkBehaviourClientRpcParamComponent.NetworkBehaviourClientRpcParamComponent::RpcCantHaveParamComponent(NetworkBehaviourTests.NetworkBehaviourClientRpcParamComponent.NetworkBehaviourClientRpcParamComponent/ComponentClass)");
         }
 
@@ -163,33 +163,29 @@ public void NetworkBehaviourCmdParamOptional()
         [Test]
         public void NetworkBehaviourCmdParamRef()
         {
-            HasError("Cannot pass Int32& by reference",
-                "System.Int32&");
-            HasError("CmdCantHaveParamRef has invalid parameter monkeys",
-                "System.Void NetworkBehaviourTests.NetworkBehaviourCmdParamRef.NetworkBehaviourCmdParamRef::CmdCantHaveParamRef(System.Int32&)");
-            HasError("Cannot pass type Int32& by reference",
-                "System.Int32&");
-            HasError("CmdCantHaveParamRef has invalid parameter monkeys.  Unsupported type System.Int32&,  use a supported Mirage type instead",
-                "System.Void NetworkBehaviourTests.NetworkBehaviourCmdParamRef.NetworkBehaviourCmdParamRef::CmdCantHaveParamRef(System.Int32&)");
+            HasError("Cannot pass Int32& by reference", "System.Int32&");
+            // todo only log this error once
+            HasError("CmdCantHaveParamRef has invalid parameter monkeys", "System.Void NetworkBehaviourTests.NetworkBehaviourCmdParamRef.NetworkBehaviourCmdParamRef::CmdCantHaveParamRef(System.Int32&)");
+            HasError("CmdCantHaveParamRef has invalid parameter monkeys.  Unsupported type System.Int32&,  use a supported Mirage type instead", "System.Void NetworkBehaviourTests.NetworkBehaviourCmdParamRef.NetworkBehaviourCmdParamRef::CmdCantHaveParamRef(System.Int32&)");
         }
 
         [Test]
         public void NetworkBehaviourCmdParamAbstract()
         {
-            HasError("Cannot generate writer for abstract class AbstractClass. Use a supported type or provide a custom writer", "NetworkBehaviourTests.NetworkBehaviourCmdParamAbstract.NetworkBehaviourCmdParamAbstract/AbstractClass");
+            HasError("Cannot generate write function for abstract class AbstractClass. Use a supported type or provide a custom write function", "NetworkBehaviourTests.NetworkBehaviourCmdParamAbstract.NetworkBehaviourCmdParamAbstract/AbstractClass");
             HasError("CmdCantHaveParamAbstract has invalid parameter monkeys", "System.Void NetworkBehaviourTests.NetworkBehaviourCmdParamAbstract.NetworkBehaviourCmdParamAbstract::CmdCantHaveParamAbstract(NetworkBehaviourTests.NetworkBehaviourCmdParamAbstract.NetworkBehaviourCmdParamAbstract/AbstractClass)");
-            HasError("Cannot generate reader for abstract class AbstractClass. Use a supported type or provide a custom reader", "NetworkBehaviourTests.NetworkBehaviourCmdParamAbstract.NetworkBehaviourCmdParamAbstract/AbstractClass");
+            HasError("Cannot generate read function for abstract class AbstractClass. Use a supported type or provide a custom read function", "NetworkBehaviourTests.NetworkBehaviourCmdParamAbstract.NetworkBehaviourCmdParamAbstract/AbstractClass");
             HasError("CmdCantHaveParamAbstract has invalid parameter monkeys.  Unsupported type NetworkBehaviourTests.NetworkBehaviourCmdParamAbstract.NetworkBehaviourCmdParamAbstract/AbstractClass,  use a supported Mirage type instead", "System.Void NetworkBehaviourTests.NetworkBehaviourCmdParamAbstract.NetworkBehaviourCmdParamAbstract::CmdCantHaveParamAbstract(NetworkBehaviourTests.NetworkBehaviourCmdParamAbstract.NetworkBehaviourCmdParamAbstract/AbstractClass)");
         }
 
         [Test]
         public void NetworkBehaviourCmdParamComponent()
         {
-            HasError("Cannot generate writer for component type ComponentClass. Use a supported type or provide a custom writer",
+            HasError("Cannot generate write function for component type ComponentClass. Use a supported type or provide a custom write function",
                 "NetworkBehaviourTests.NetworkBehaviourCmdParamComponent.NetworkBehaviourCmdParamComponent/ComponentClass");
             HasError("CmdCantHaveParamComponent has invalid parameter monkeyComp",
                 "System.Void NetworkBehaviourTests.NetworkBehaviourCmdParamComponent.NetworkBehaviourCmdParamComponent::CmdCantHaveParamComponent(NetworkBehaviourTests.NetworkBehaviourCmdParamComponent.NetworkBehaviourCmdParamComponent/ComponentClass)");
-            HasError("Cannot generate reader for component type ComponentClass. Use a supported type or provide a custom reader",
+            HasError("Cannot generate read function for component type ComponentClass. Use a supported type or provide a custom read function",
                 "NetworkBehaviourTests.NetworkBehaviourCmdParamComponent.NetworkBehaviourCmdParamComponent/ComponentClass");
             HasError("CmdCantHaveParamComponent has invalid parameter monkeyComp.  Unsupported type NetworkBehaviourTests.NetworkBehaviourCmdParamComponent.NetworkBehaviourCmdParamComponent/ComponentClass,  use a supported Mirage type instead",
                 "System.Void NetworkBehaviourTests.NetworkBehaviourCmdParamComponent.NetworkBehaviourCmdParamComponent::CmdCantHaveParamComponent(NetworkBehaviourTests.NetworkBehaviourCmdParamComponent.NetworkBehaviourCmdParamComponent/ComponentClass)");
diff --git a/Assets/Tests/Weaver/SyncDictionaryTests.cs b/Assets/Tests/Weaver/SyncDictionaryTests.cs
index 2a07a4e638e..0edd4a2e179 100644
--- a/Assets/Tests/Weaver/SyncDictionaryTests.cs
+++ b/Assets/Tests/Weaver/SyncDictionaryTests.cs
@@ -44,9 +44,9 @@ public void SyncDictionaryStructItem()
         [Test]
         public void SyncDictionaryErrorForGenericStructKey()
         {
-            HasError("Cannot generate reader for generic variable MyGenericStruct`1. Use a supported type or provide a custom reader",
+            HasError("Cannot generate read function for generic type MyGenericStruct`1. Use a supported type or provide a custom read function",
                 "SyncDictionaryTests.SyncDictionaryErrorForGenericStructKey.SyncDictionaryErrorForGenericStructKey/MyGenericStruct`1<System.Single>");
-            HasError("Cannot generate writer for generic type MyGenericStruct`1. Use a supported type or provide a custom writer",
+            HasError("Cannot generate write function for generic type MyGenericStruct`1. Use a supported type or provide a custom write function",
                 "SyncDictionaryTests.SyncDictionaryErrorForGenericStructKey.SyncDictionaryErrorForGenericStructKey/MyGenericStruct`1<System.Single>");
 
         }
@@ -54,9 +54,9 @@ public void SyncDictionaryErrorForGenericStructKey()
         [Test]
         public void SyncDictionaryErrorForGenericStructItem()
         {
-            HasError("Cannot generate reader for generic variable MyGenericStruct`1. Use a supported type or provide a custom reader",
+            HasError("Cannot generate write function for generic type MyGenericStruct`1. Use a supported type or provide a custom write function",
                 "SyncDictionaryTests.SyncDictionaryErrorForGenericStructItem.SyncDictionaryErrorForGenericStructItem/MyGenericStruct`1<System.Single>");
-            HasError("Cannot generate writer for generic type MyGenericStruct`1. Use a supported type or provide a custom writer",
+            HasError("Cannot generate read function for generic type MyGenericStruct`1. Use a supported type or provide a custom read function",
                 "SyncDictionaryTests.SyncDictionaryErrorForGenericStructItem.SyncDictionaryErrorForGenericStructItem/MyGenericStruct`1<System.Single>");
         }
 
diff --git a/Assets/Tests/Weaver/SyncListTests.cs b/Assets/Tests/Weaver/SyncListTests.cs
index 8e2e2653edb..c8a36c27f55 100644
--- a/Assets/Tests/Weaver/SyncListTests.cs
+++ b/Assets/Tests/Weaver/SyncListTests.cs
@@ -55,11 +55,10 @@ public void SyncListNestedInAbstractClass()
         [Test]
         public void SyncListNestedInAbstractClassWithInvalid()
         {
-            HasError("Cannot generate reader for Object. Use a supported type or provide a custom reader",
+            HasError("Cannot generate write function for Object. Use a supported type or provide a custom write function",
                 "UnityEngine.Object");
-            HasError("target has an unsupported type",
-                "UnityEngine.Object SyncListTests.SyncListNestedInAbstractClassWithInvalid.SyncListNestedStructWithInvalid/SomeAbstractClass/MyNestedStruct::target");
-            HasError("Cannot generate writer for Object. Use a supported type or provide a custom writer",
+
+            HasError("Cannot generate read function for Object. Use a supported type or provide a custom read function",
                 "UnityEngine.Object");
         }
 
@@ -72,11 +71,10 @@ public void SyncListNestedInStruct()
         [Test]
         public void SyncListNestedInStructWithInvalid()
         {
-            HasError("Cannot generate reader for Object. Use a supported type or provide a custom reader",
+            HasError("Cannot generate write function for Object. Use a supported type or provide a custom write function",
                 "UnityEngine.Object");
-            HasError("target has an unsupported type",
-                "UnityEngine.Object SyncListTests.SyncListNestedInStructWithInvalid.SyncListNestedInStructWithInvalid/SomeData::target");
-            HasError("Cannot generate writer for Object. Use a supported type or provide a custom writer",
+
+            HasError("Cannot generate read function for Object. Use a supported type or provide a custom read function",
                 "UnityEngine.Object");
         }
 
@@ -89,18 +87,18 @@ public void SyncListStruct()
         [Test]
         public void SyncListErrorForGenericStruct()
         {
-            HasError("Cannot generate reader for generic variable MyGenericStruct`1. Use a supported type or provide a custom reader",
+            HasError("Cannot generate write function for generic type MyGenericStruct`1. Use a supported type or provide a custom write function",
                 "SyncListTests.SyncListErrorForGenericStruct.SyncListErrorForGenericStruct/MyGenericStruct`1<System.Single>");
-            HasError("Cannot generate writer for generic type MyGenericStruct`1. Use a supported type or provide a custom writer",
+            HasError("Cannot generate read function for generic type MyGenericStruct`1. Use a supported type or provide a custom read function",
                 "SyncListTests.SyncListErrorForGenericStruct.SyncListErrorForGenericStruct/MyGenericStruct`1<System.Single>");
         }
 
         [Test]
         public void SyncListErrorForInterface()
         {
-            HasError("Cannot generate reader for interface MyInterface. Use a supported type or provide a custom reader",
+            HasError("Cannot generate read function for interface MyInterface. Use a supported type or provide a custom read function",
                 "SyncListTests.SyncListErrorForInterface.MyInterface");
-            HasError("Cannot generate writer for interface MyInterface. Use a supported type or provide a custom writer",
+            HasError("Cannot generate write function for interface MyInterface. Use a supported type or provide a custom write function",
                 "SyncListTests.SyncListErrorForInterface.MyInterface");
         }
 
diff --git a/Assets/Tests/Weaver/SyncVarTests.cs b/Assets/Tests/Weaver/SyncVarTests.cs
index cff0ecfa6ea..28b82d5e2ec 100644
--- a/Assets/Tests/Weaver/SyncVarTests.cs
+++ b/Assets/Tests/Weaver/SyncVarTests.cs
@@ -39,7 +39,7 @@ public void SyncVarsGenericField()
         [Test]
         public void SyncVarsGenericParam()
         {
-            HasError("Cannot generate writer for generic type MySyncVar`1. Use a supported type or provide a custom writer",
+            HasError("Cannot generate write function for generic type MySyncVar`1. Use a supported type or provide a custom write function",
                 "SyncVarTests.SyncVarsGenericParam.SyncVarsGenericParam/MySyncVar`1<System.Int32>");
             HasError("invalidVar has unsupported type. Use a supported Mirage type instead",
                 "SyncVarTests.SyncVarsGenericParam.SyncVarsGenericParam/MySyncVar`1<System.Int32> SyncVarTests.SyncVarsGenericParam.SyncVarsGenericParam::invalidVar");
@@ -48,7 +48,7 @@ public void SyncVarsGenericParam()
         [Test]
         public void SyncVarsInterface()
         {
-            HasError("Cannot generate writer for interface IMySyncVar. Use a supported type or provide a custom writer",
+            HasError("Cannot generate write function for interface IMySyncVar. Use a supported type or provide a custom write function",
                 "SyncVarTests.SyncVarsInterface.SyncVarsInterface/IMySyncVar");
             HasError("invalidVar has unsupported type. Use a supported Mirage type instead",
                 "SyncVarTests.SyncVarsInterface.SyncVarsInterface/IMySyncVar SyncVarTests.SyncVarsInterface.SyncVarsInterface::invalidVar");
@@ -57,7 +57,7 @@ public void SyncVarsInterface()
         [Test]
         public void SyncVarsUnityComponent()
         {
-            HasError("Cannot generate writer for component type TextMesh. Use a supported type or provide a custom writer",
+            HasError("Cannot generate write function for component type TextMesh. Use a supported type or provide a custom write function",
                 "UnityEngine.TextMesh");
             HasError("invalidVar has unsupported type. Use a supported Mirage type instead",
                 "UnityEngine.TextMesh SyncVarTests.SyncVarsUnityComponent.SyncVarsUnityComponent::invalidVar");

From 54c8e0e7b414bb8f673f49654320a4b14a80bf04 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Wed, 18 Aug 2021 14:58:29 +0100
Subject: [PATCH 113/166] style(weaver): fixing code smells in new changes

---
 Assets/Mirage/Weaver/Readers.cs               | 28 +++++++++----------
 Assets/Mirage/Weaver/SerializeFunctionBase.cs | 25 ++++++++---------
 Assets/Mirage/Weaver/Writers.cs               | 10 +++----
 3 files changed, 31 insertions(+), 32 deletions(-)

diff --git a/Assets/Mirage/Weaver/Readers.cs b/Assets/Mirage/Weaver/Readers.cs
index bc468526d20..15166e8ea98 100644
--- a/Assets/Mirage/Weaver/Readers.cs
+++ b/Assets/Mirage/Weaver/Readers.cs
@@ -30,15 +30,15 @@ protected override MethodReference GetNetworkBehaviourFunction(TypeReference typ
             return readerFunc;
         }
 
-        protected override MethodReference GenerateEnumFunction(TypeReference variable)
+        protected override MethodReference GenerateEnumFunction(TypeReference typeReference)
         {
-            MethodDefinition readerFunc = GenerateReaderFunction(variable);
+            MethodDefinition readerFunc = GenerateReaderFunction(typeReference);
 
             ILProcessor worker = readerFunc.Body.GetILProcessor();
 
             worker.Append(worker.Create(OpCodes.Ldarg_0));
 
-            TypeReference underlyingType = variable.Resolve().GetEnumUnderlyingType();
+            TypeReference underlyingType = typeReference.Resolve().GetEnumUnderlyingType();
             MethodReference underlyingFunc = TryGetFunction(underlyingType, null);
 
             worker.Append(worker.Create(OpCodes.Call, underlyingFunc));
@@ -46,11 +46,11 @@ protected override MethodReference GenerateEnumFunction(TypeReference variable)
             return readerFunc;
         }
 
-        protected override MethodReference GenerateSegmentFunction(TypeReference variable, TypeReference elementType)
+        protected override MethodReference GenerateSegmentFunction(TypeReference typeReference, TypeReference elementType)
         {
-            var genericInstance = (GenericInstanceType)variable;
+            var genericInstance = (GenericInstanceType)typeReference;
 
-            MethodDefinition readerFunc = GenerateReaderFunction(variable);
+            MethodDefinition readerFunc = GenerateReaderFunction(typeReference);
 
             ILProcessor worker = readerFunc.Body.GetILProcessor();
 
@@ -84,14 +84,14 @@ private MethodDefinition GenerateReaderFunction(TypeReference variable)
             return readerFunc;
         }
 
-        protected override MethodReference GenerateCollectionFunction(TypeReference variable, TypeReference elementType, Expression<Action> readerFunction)
+        protected override MethodReference GenerateCollectionFunction(TypeReference typeReference, TypeReference elementType, Expression<Action> genericExpression)
         {
             // generate readers for the element
             _ = GetFunction_Thorws(elementType);
 
-            MethodDefinition readerFunc = GenerateReaderFunction(variable);
+            MethodDefinition readerFunc = GenerateReaderFunction(typeReference);
 
-            MethodReference listReader = module.ImportReference(readerFunction);
+            MethodReference listReader = module.ImportReference(genericExpression);
 
             var methodRef = new GenericInstanceMethod(listReader.GetElementMethod());
             methodRef.GenericArguments.Add(elementType);
@@ -108,23 +108,23 @@ protected override MethodReference GenerateCollectionFunction(TypeReference vari
             return readerFunc;
         }
 
-        protected override MethodReference GenerateClassOrStructFunction(TypeReference type)
+        protected override MethodReference GenerateClassOrStructFunction(TypeReference typeReference)
         {
-            MethodDefinition readerFunc = GenerateReaderFunction(type);
+            MethodDefinition readerFunc = GenerateReaderFunction(typeReference);
 
             // create local for return value
-            VariableDefinition variable = readerFunc.AddLocal(type);
+            VariableDefinition variable = readerFunc.AddLocal(typeReference);
 
             ILProcessor worker = readerFunc.Body.GetILProcessor();
 
 
-            TypeDefinition td = type.Resolve();
+            TypeDefinition td = typeReference.Resolve();
 
             if (!td.IsValueType)
                 GenerateNullCheck(worker);
 
             CreateNew(variable, worker, td);
-            ReadAllFields(type, worker);
+            ReadAllFields(typeReference, worker);
 
             worker.Append(worker.Create(OpCodes.Ldloc, variable));
             worker.Append(worker.Create(OpCodes.Ret));
diff --git a/Assets/Mirage/Weaver/SerializeFunctionBase.cs b/Assets/Mirage/Weaver/SerializeFunctionBase.cs
index 28bd3010f48..738b5d42552 100644
--- a/Assets/Mirage/Weaver/SerializeFunctionBase.cs
+++ b/Assets/Mirage/Weaver/SerializeFunctionBase.cs
@@ -65,7 +65,6 @@ public MethodReference TryGetFunction(TypeReference typeReference, SequencePoint
             }
             catch (SerializeFunctionException e)
             {
-                // todo remove Sequencepoint from SerializeFunctionException, and use from parameter instead
                 logger.Error(e, sequencePoint);
                 return null;
             }
@@ -78,7 +77,7 @@ public MethodReference TryGetFunction(TypeReference typeReference, SequencePoint
         /// <param name="sequencePoint"></param>
         /// <returns></returns>
         /// <exception cref="SerializeFunctionException">Throws if unable to find or create function</exception>
-        // todo rename this to GetFunction once other classes are able to catch Exceptio
+        // todo rename this to GetFunction once other classes are able to catch Exception
         public MethodReference GetFunction_Thorws(TypeReference typeReference)
         {
             if (funcs.TryGetValue(typeReference, out MethodReference foundFunc))
@@ -139,7 +138,7 @@ private MethodReference GenerateFunction(TypeReference typeReference)
             TypeDefinition typeDefinition = typeReference.Resolve();
             if (typeDefinition == null)
             {
-                ThrowCantGenerate(typeReference);
+                throw ThrowCantGenerate(typeReference);
             }
 
             if (typeDefinition.IsEnum)
@@ -156,47 +155,47 @@ private MethodReference GenerateFunction(TypeReference typeReference)
             // unity base types are invalid
             if (typeDefinition.IsDerivedFrom<UnityEngine.Component>())
             {
-                ThrowCantGenerate(typeReference, "component type");
+                throw ThrowCantGenerate(typeReference, "component type");
             }
             if (typeReference.Is<UnityEngine.Object>())
             {
-                ThrowCantGenerate(typeReference);
+                throw ThrowCantGenerate(typeReference);
             }
             if (typeReference.Is<UnityEngine.ScriptableObject>())
             {
-                ThrowCantGenerate(typeReference);
+                throw ThrowCantGenerate(typeReference);
             }
 
 
             if (typeDefinition.HasGenericParameters)
             {
-                ThrowCantGenerate(typeReference, "generic type");
+                throw ThrowCantGenerate(typeReference, "generic type");
             }
             if (typeDefinition.IsInterface)
             {
-                ThrowCantGenerate(typeReference, "interface");
+                throw ThrowCantGenerate(typeReference, "interface");
             }
             if (typeDefinition.IsAbstract)
             {
-                ThrowCantGenerate(typeReference, "abstract class");
+                throw ThrowCantGenerate(typeReference, "abstract class");
             }
 
             // generate writer for class/struct
             return GenerateClassOrStructFunction(typeReference);
         }
 
-        void ThrowCantGenerate(TypeReference typeReference, string typeDescription = null)
+        SerializeFunctionException ThrowCantGenerate(TypeReference typeReference, string typeDescription = null)
         {
             string reasonStr = string.IsNullOrEmpty(typeDescription) ? string.Empty : $"{typeDescription} ";
-            throw new SerializeFunctionException($"Cannot generate {FunctionTypeLog} for {reasonStr}{typeReference.Name}. Use a supported type or provide a custom {FunctionTypeLog}", typeReference);
+            return new SerializeFunctionException($"Cannot generate {FunctionTypeLog} for {reasonStr}{typeReference.Name}. Use a supported type or provide a custom {FunctionTypeLog}", typeReference);
         }
 
         protected abstract MethodReference GetNetworkBehaviourFunction(TypeReference typeReference);
 
 
         protected abstract MethodReference GenerateEnumFunction(TypeReference typeReference);
-        protected abstract MethodReference GenerateCollectionFunction(TypeReference variable, TypeReference elementType, Expression<Action> writerFunction);
-        protected abstract MethodReference GenerateSegmentFunction(TypeReference variable, TypeReference elementType);
+        protected abstract MethodReference GenerateCollectionFunction(TypeReference typeReference, TypeReference elementType, Expression<Action> genericExpression);
+        protected abstract MethodReference GenerateSegmentFunction(TypeReference typeReference, TypeReference elementType);
 
         protected abstract Expression<Action> ArrayExpression { get; }
         protected abstract Expression<Action> ListExpression { get; }
diff --git a/Assets/Mirage/Weaver/Writers.cs b/Assets/Mirage/Weaver/Writers.cs
index e284c4a75bc..5b0f801cbdd 100644
--- a/Assets/Mirage/Weaver/Writers.cs
+++ b/Assets/Mirage/Weaver/Writers.cs
@@ -122,20 +122,20 @@ bool WriteAllFields(TypeReference variable, ILProcessor worker)
             return true;
         }
 
-        protected override MethodReference GenerateSegmentFunction(TypeReference variable, TypeReference elementType)
+        protected override MethodReference GenerateSegmentFunction(TypeReference typeReference, TypeReference elementType)
         {
             Expression<Action> segmentExpression = () => CollectionExtensions.WriteArraySegment<byte>(default, default);
-            return GenerateCollectionFunction(variable, elementType, segmentExpression);
+            return GenerateCollectionFunction(typeReference, elementType, segmentExpression);
         }
-        protected override MethodReference GenerateCollectionFunction(TypeReference variable, TypeReference elementType, Expression<Action> writerFunction)
+        protected override MethodReference GenerateCollectionFunction(TypeReference typeReference, TypeReference elementType, Expression<Action> genericExpression)
         {
             // make sure element has a writer
             // collection writers use the generic writer, so this will make sure one exists
             _ = GetFunction_Thorws(elementType);
 
-            MethodDefinition writerFunc = GenerateWriterFunc(variable);
+            MethodDefinition writerFunc = GenerateWriterFunc(typeReference);
 
-            MethodReference collectionWriter = module.ImportReference(writerFunction).GetElementMethod();
+            MethodReference collectionWriter = module.ImportReference(genericExpression).GetElementMethod();
 
             var methodRef = new GenericInstanceMethod(collectionWriter);
             methodRef.GenericArguments.Add(elementType);

From 3c84d6e95a9df81cde4503b1c247e1aa85700f51 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Wed, 18 Aug 2021 15:05:15 +0100
Subject: [PATCH 114/166] refactor(weaver): making weaver exceptions internal

all uses of them should be caught within weaver so do not need to be public
---
 Assets/Mirage/Weaver/IWeaverLogger.cs    | 2 +-
 Assets/Mirage/Weaver/WeaverExceptions.cs | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/Assets/Mirage/Weaver/IWeaverLogger.cs b/Assets/Mirage/Weaver/IWeaverLogger.cs
index ab1122c03c5..3907238c0fd 100644
--- a/Assets/Mirage/Weaver/IWeaverLogger.cs
+++ b/Assets/Mirage/Weaver/IWeaverLogger.cs
@@ -16,7 +16,7 @@ public interface IWeaverLogger
         void Warning(string message, MethodDefinition md);
     }
 
-    public static class WeaverLoggerExtensions
+    internal static class WeaverLoggerExtensions
     {
         public static void Error(this IWeaverLogger logger, WeaverException exception)
         {
diff --git a/Assets/Mirage/Weaver/WeaverExceptions.cs b/Assets/Mirage/Weaver/WeaverExceptions.cs
index b90830a06ac..5d14a075687 100644
--- a/Assets/Mirage/Weaver/WeaverExceptions.cs
+++ b/Assets/Mirage/Weaver/WeaverExceptions.cs
@@ -4,7 +4,7 @@
 
 namespace Mirage.Weaver
 {
-    public abstract class WeaverException : Exception
+    internal abstract class WeaverException : Exception
     {
         public readonly SequencePoint SequencePoint;
         public readonly MemberReference MemberReference;
@@ -16,7 +16,7 @@ protected WeaverException(string message, MemberReference memberReference, Seque
         }
     }
 
-    public class SerializeFunctionException : WeaverException
+    internal class SerializeFunctionException : WeaverException
     {
         public SerializeFunctionException(string message, MemberReference memberReference) : base(message, memberReference, null) { }
     }

From 042f1d99de49991e068610ae833ed0129c2f4744 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Wed, 18 Aug 2021 14:14:32 +0100
Subject: [PATCH 115/166] refactor(weaver): adding SyncVarException

---
 Assets/Mirage/Weaver/WeaverExceptions.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/Assets/Mirage/Weaver/WeaverExceptions.cs b/Assets/Mirage/Weaver/WeaverExceptions.cs
index 5d14a075687..3df6fe22953 100644
--- a/Assets/Mirage/Weaver/WeaverExceptions.cs
+++ b/Assets/Mirage/Weaver/WeaverExceptions.cs
@@ -20,4 +20,9 @@ internal class SerializeFunctionException : WeaverException
     {
         public SerializeFunctionException(string message, MemberReference memberReference) : base(message, memberReference, null) { }
     }
+
+    internal class SyncVarException : WeaverException
+    {
+        public SyncVarException(string message, MemberReference memberReference) : base(message, memberReference, null) { }
+    }
 }

From 96080fe482ea6da7d1c22cb7b405bc4e1acf8ba4 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Wed, 18 Aug 2021 14:16:07 +0100
Subject: [PATCH 116/166] refactor(weaver): adding FoundSyncVar to wrap around
 field Definition

---
 .../Weaver/Processors/SyncVarProcessor.cs     | 30 ++++++++++++-------
 1 file changed, 20 insertions(+), 10 deletions(-)

diff --git a/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs b/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
index 65d305cbbc9..82473cacd70 100644
--- a/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
@@ -10,12 +10,22 @@
 
 namespace Mirage.Weaver
 {
+
     /// <summary>
     /// Processes [SyncVar] in NetworkBehaviour
     /// </summary>
     public class SyncVarProcessor
     {
-        private readonly List<FieldDefinition> syncVars = new List<FieldDefinition>();
+        private class FoundSyncVar
+        {
+            public readonly FieldDefinition fieldDefinition;
+
+            public FoundSyncVar(FieldDefinition fieldDefinition)
+            {
+                this.fieldDefinition = fieldDefinition;
+            }
+        }
+        private readonly List<FoundSyncVar> syncVars = new List<FoundSyncVar>();
 
         // store the unwrapped types for every field
         private readonly Dictionary<FieldDefinition, TypeReference> originalTypes = new Dictionary<FieldDefinition, TypeReference>();
@@ -342,7 +352,7 @@ public void ProcessSyncVars(TypeDefinition td)
                     logger.Warning($"{fd.Name} has [SyncVar] attribute. SyncLists should not be marked with SyncVar", fd);
                     continue;
                 }
-                syncVars.Add(fd);
+                syncVars.Add(new FoundSyncVar(fd));
 
                 ProcessSyncVar(fd, 1L << dirtyBitCounter);
                 dirtyBitCounter += 1;
@@ -483,9 +493,9 @@ void GenerateSerialization(TypeDefinition netBehaviourSubclass)
             worker.Append(worker.Create(OpCodes.Ldarg, initializeParameter));
             worker.Append(worker.Create(OpCodes.Brfalse, initialStateLabel));
 
-            foreach (FieldDefinition syncVar in syncVars)
+            foreach (FoundSyncVar syncVar in syncVars)
             {
-                WriteVariable(worker, writerParameter, syncVar);
+                WriteVariable(worker, writerParameter, syncVar.fieldDefinition);
             }
 
             // always return true if forceAll
@@ -511,7 +521,7 @@ void GenerateSerialization(TypeDefinition netBehaviourSubclass)
 
             // start at number of syncvars in parent
             int dirtyBit = netBehaviourSubclass.BaseType.Resolve().GetConst<int>(SyncVarCount);
-            foreach (FieldDefinition syncVar in syncVars)
+            foreach (FoundSyncVar syncVar in syncVars)
             {
                 Instruction varLabel = worker.Create(OpCodes.Nop);
 
@@ -525,7 +535,7 @@ void GenerateSerialization(TypeDefinition netBehaviourSubclass)
                 worker.Append(worker.Create(OpCodes.Brfalse, varLabel));
 
                 // Generates a call to the writer for that field
-                WriteVariable(worker, writerParameter, syncVar);
+                WriteVariable(worker, writerParameter, syncVar.fieldDefinition);
 
                 // something was dirty
                 worker.Append(worker.Create(OpCodes.Ldc_I4_1));
@@ -602,9 +612,9 @@ void GenerateDeSerialization(TypeDefinition netBehaviourSubclass)
             serWorker.Append(serWorker.Create(OpCodes.Ldarg, initializeParam));
             serWorker.Append(serWorker.Create(OpCodes.Brfalse, initialStateLabel));
 
-            foreach (FieldDefinition syncVar in syncVars)
+            foreach (FoundSyncVar syncVar in syncVars)
             {
-                DeserializeField(syncVar, serWorker, serialize);
+                DeserializeField(syncVar.fieldDefinition, serWorker, serialize);
             }
 
             serWorker.Append(serWorker.Create(OpCodes.Ret));
@@ -620,7 +630,7 @@ void GenerateDeSerialization(TypeDefinition netBehaviourSubclass)
             // conditionally read each syncvar
             // start at number of syncvars in parent
             int dirtyBit = netBehaviourSubclass.BaseType.Resolve().GetConst<int>(SyncVarCount);
-            foreach (FieldDefinition syncVar in syncVars)
+            foreach (FoundSyncVar syncVar in syncVars)
             {
                 Instruction varLabel = serWorker.Create(OpCodes.Nop);
 
@@ -630,7 +640,7 @@ void GenerateDeSerialization(TypeDefinition netBehaviourSubclass)
                 serWorker.Append(serWorker.Create(OpCodes.And));
                 serWorker.Append(serWorker.Create(OpCodes.Brfalse, varLabel));
 
-                DeserializeField(syncVar, serWorker, serialize);
+                DeserializeField(syncVar.fieldDefinition, serWorker, serialize);
 
                 serWorker.Append(varLabel);
                 dirtyBit += 1;

From 990e14947ba8af43a05c9787d255c38f9f0bfbea Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Wed, 18 Aug 2021 14:21:36 +0100
Subject: [PATCH 117/166] style(weaver): changing function define order

---
 .../Weaver/Processors/SyncVarProcessor.cs     | 286 +++++++++---------
 1 file changed, 143 insertions(+), 143 deletions(-)

diff --git a/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs b/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
index 82473cacd70..90413ef30bb 100644
--- a/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
@@ -35,6 +35,13 @@ public FoundSyncVar(FieldDefinition fieldDefinition)
         private readonly PropertySiteProcessor propertySiteProcessor;
         private readonly IWeaverLogger logger;
 
+        // ulong = 64 bytes
+        const int SyncVarLimit = 64;
+        private const string SyncVarCount = "SYNC_VAR_COUNT";
+
+        static string HookParameterMessage(string hookName, TypeReference ValueType)
+            => string.Format("void {0}({1} oldValue, {1} newValue)", hookName, ValueType);
+
         public SyncVarProcessor(ModuleDefinition module, Readers readers, Writers writers, PropertySiteProcessor propertySiteProcessor, IWeaverLogger logger)
         {
             this.module = module;
@@ -44,64 +51,91 @@ public SyncVarProcessor(ModuleDefinition module, Readers readers, Writers writer
             this.logger = logger;
         }
 
-        // ulong = 64 bytes
-        const int SyncVarLimit = 64;
-        private const string SyncVarCount = "SYNC_VAR_COUNT";
-
-        static string HookParameterMessage(string hookName, TypeReference ValueType)
-            => string.Format("void {0}({1} oldValue, {1} newValue)", hookName, ValueType);
-
-        // Get hook method if any
-        MethodDefinition GetHookMethod(FieldDefinition syncVar, TypeReference originalType)
+        public void ProcessSyncVars(TypeDefinition td)
         {
-            CustomAttribute syncVarAttr = syncVar.GetCustomAttribute<SyncVarAttribute>();
+            // 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
 
-            if (syncVarAttr == null)
-                return null;
+            int dirtyBitCounter = td.BaseType.Resolve().GetConst<int>(SyncVarCount);
 
-            string hookFunctionName = syncVarAttr.GetField<string>("hook", null);
+            var fields = new List<FieldDefinition>(td.Fields);
 
-            if (hookFunctionName == null)
-                return null;
+            // find syncvars
+            foreach (FieldDefinition fd in fields)
+            {
+                if (!fd.HasCustomAttribute<SyncVarAttribute>())
+                {
+                    continue;
+                }
 
-            return FindHookMethod(syncVar, hookFunctionName, originalType);
-        }
+                if (fd.FieldType.IsGenericParameter)
+                {
+                    logger.Error($"{fd.Name} cannot be synced since it's a generic parameter", fd);
+                    continue;
+                }
 
-        MethodDefinition FindHookMethod(FieldDefinition syncVar, string hookFunctionName, TypeReference originalType)
-        {
-            List<MethodDefinition> methods = syncVar.DeclaringType.GetMethods(hookFunctionName);
+                if ((fd.Attributes & FieldAttributes.Static) != 0)
+                {
+                    logger.Error($"{fd.Name} cannot be static", fd);
+                    continue;
+                }
 
-            var methodsWith2Param = new List<MethodDefinition>(methods.Where(m => m.Parameters.Count == 2));
+                if (fd.FieldType.IsArray)
+                {
+                    logger.Error($"{fd.Name} has invalid type. Use SyncLists instead of arrays", fd);
+                    continue;
+                }
 
-            if (methodsWith2Param.Count == 0)
-            {
-                logger.Error($"Could not find hook for '{syncVar.Name}', hook name '{hookFunctionName}'. " +
-                    $"Method signature should be {HookParameterMessage(hookFunctionName, originalType)}",
-                    syncVar);
+                if (SyncObjectProcessor.ImplementsSyncObject(fd.FieldType))
+                {
+                    logger.Warning($"{fd.Name} has [SyncVar] attribute. SyncLists should not be marked with SyncVar", fd);
+                    continue;
+                }
+                syncVars.Add(new FoundSyncVar(fd));
 
-                return null;
+                ProcessSyncVar(fd, 1L << dirtyBitCounter);
+                dirtyBitCounter += 1;
             }
 
-            foreach (MethodDefinition method in methodsWith2Param)
+            if (dirtyBitCounter >= SyncVarLimit)
             {
-                if (MatchesParameters(method, originalType))
-                {
-                    return method;
-                }
+                logger.Error($"{td.Name} has too many SyncVars. Consider refactoring your class into multiple components", td);
             }
 
-            logger.Error($"Wrong type for Parameter in hook for '{syncVar.Name}', hook name '{hookFunctionName}'. " +
-                     $"Method signature should be {HookParameterMessage(hookFunctionName, originalType)}",
-                   syncVar);
+            td.SetConst(SyncVarCount, syncVars.Count);
 
-            return null;
+            GenerateSerialization(td);
+            GenerateDeSerialization(td);
         }
 
-        static bool MatchesParameters(MethodDefinition method, TypeReference originalType)
+        void ProcessSyncVar(FieldDefinition fd, long dirtyBit)
         {
-            // matches void onValueChange(T oldValue, T newValue)
-            return method.Parameters[0].ParameterType.FullName == originalType.FullName &&
-                   method.Parameters[1].ParameterType.FullName == originalType.FullName;
+            string originalName = fd.Name;
+            Weaver.DLog(fd.DeclaringType, "Sync Var " + fd.Name + " " + fd.FieldType);
+
+            TypeReference originalType = fd.FieldType;
+            fd.FieldType = WrapType(fd);
+
+            MethodDefinition get = GenerateSyncVarGetter(fd, originalName, originalType);
+            MethodDefinition set = GenerateSyncVarSetter(fd, originalName, dirtyBit, originalType);
+
+            //NOTE: is property even needed? Could just use a setter function?
+            //create the property
+            var propertyDefinition = new PropertyDefinition("Network" + originalName, PropertyAttributes.None, originalType)
+            {
+                GetMethod = get,
+                SetMethod = set
+            };
+
+            propertyDefinition.DeclaringType = fd.DeclaringType;
+            //add the methods and property to the type.
+            fd.DeclaringType.Properties.Add(propertyDefinition);
+            propertySiteProcessor.Setters[fd] = set;
+
+            if (IsWrapped(fd.FieldType))
+            {
+                propertySiteProcessor.Getters[fd] = get;
+            }
         }
 
         MethodDefinition GenerateSyncVarGetter(FieldDefinition fd, string originalName, TypeReference originalType)
@@ -206,26 +240,6 @@ MethodDefinition GenerateSyncVarSetter(FieldDefinition fd, string originalName,
             return set;
         }
 
-        private void StoreField(FieldDefinition fd, ParameterDefinition valueParam, ILProcessor worker)
-        {
-            if (IsWrapped(fd.FieldType))
-            {
-                // there is a wrapper struct, call the setter
-                MethodReference setter = module.ImportReference(fd.FieldType.Resolve().GetMethod("set_Value"));
-
-                worker.Append(worker.Create(OpCodes.Ldarg_0));
-                worker.Append(worker.Create(OpCodes.Ldflda, fd.MakeHostGenericIfNeeded()));
-                worker.Append(worker.Create(OpCodes.Ldarg, valueParam));
-                worker.Append(worker.Create(OpCodes.Call, setter));
-            }
-            else
-            {
-                worker.Append(worker.Create(OpCodes.Ldarg_0));
-                worker.Append(worker.Create(OpCodes.Ldarg, valueParam));
-                worker.Append(worker.Create(OpCodes.Stfld, fd.MakeHostGenericIfNeeded()));
-            }
-        }
-
         private void LoadField(FieldDefinition fd, TypeReference originalType, ILProcessor worker)
         {
             worker.Append(worker.Create(OpCodes.Ldarg_0));
@@ -251,58 +265,77 @@ private void LoadField(FieldDefinition fd, TypeReference originalType, ILProcess
             }
         }
 
-        void ProcessSyncVar(FieldDefinition fd, long dirtyBit)
+        private void StoreField(FieldDefinition fd, ParameterDefinition valueParam, ILProcessor worker)
         {
-            string originalName = fd.Name;
-            Weaver.DLog(fd.DeclaringType, "Sync Var " + fd.Name + " " + fd.FieldType);
+            if (IsWrapped(fd.FieldType))
+            {
+                // there is a wrapper struct, call the setter
+                MethodReference setter = module.ImportReference(fd.FieldType.Resolve().GetMethod("set_Value"));
 
-            TypeReference originalType = fd.FieldType;
-            fd.FieldType = WrapType(fd);
+                worker.Append(worker.Create(OpCodes.Ldarg_0));
+                worker.Append(worker.Create(OpCodes.Ldflda, fd.MakeHostGenericIfNeeded()));
+                worker.Append(worker.Create(OpCodes.Ldarg, valueParam));
+                worker.Append(worker.Create(OpCodes.Call, setter));
+            }
+            else
+            {
+                worker.Append(worker.Create(OpCodes.Ldarg_0));
+                worker.Append(worker.Create(OpCodes.Ldarg, valueParam));
+                worker.Append(worker.Create(OpCodes.Stfld, fd.MakeHostGenericIfNeeded()));
+            }
+        }
 
-            MethodDefinition get = GenerateSyncVarGetter(fd, originalName, originalType);
-            MethodDefinition set = GenerateSyncVarSetter(fd, originalName, dirtyBit, originalType);
+        // Get hook method if any
+        MethodDefinition GetHookMethod(FieldDefinition syncVar, TypeReference originalType)
+        {
+            CustomAttribute syncVarAttr = syncVar.GetCustomAttribute<SyncVarAttribute>();
 
-            //NOTE: is property even needed? Could just use a setter function?
-            //create the property
-            var propertyDefinition = new PropertyDefinition("Network" + originalName, PropertyAttributes.None, originalType)
-            {
-                GetMethod = get,
-                SetMethod = set
-            };
+            if (syncVarAttr == null)
+                return null;
 
-            propertyDefinition.DeclaringType = fd.DeclaringType;
-            //add the methods and property to the type.
-            fd.DeclaringType.Properties.Add(propertyDefinition);
-            propertySiteProcessor.Setters[fd] = set;
+            string hookFunctionName = syncVarAttr.GetField<string>("hook", null);
 
-            if (IsWrapped(fd.FieldType))
-            {
-                propertySiteProcessor.Getters[fd] = get;
-            }
+            if (hookFunctionName == null)
+                return null;
+
+            return FindHookMethod(syncVar, hookFunctionName, originalType);
         }
 
-        private TypeReference WrapType(FieldDefinition syncvar)
+        MethodDefinition FindHookMethod(FieldDefinition syncVar, string hookFunctionName, TypeReference originalType)
         {
-            TypeReference typeReference = syncvar.FieldType;
+            List<MethodDefinition> methods = syncVar.DeclaringType.GetMethods(hookFunctionName);
 
-            originalTypes[syncvar] = typeReference;
-            if (typeReference.Is<NetworkIdentity>())
+            var methodsWith2Param = new List<MethodDefinition>(methods.Where(m => m.Parameters.Count == 2));
+
+            if (methodsWith2Param.Count == 0)
             {
-                // change the type of the field to a wrapper NetworkIDentitySyncvar
-                return module.ImportReference<NetworkIdentitySyncvar>();
+                logger.Error($"Could not find hook for '{syncVar.Name}', hook name '{hookFunctionName}'. " +
+                    $"Method signature should be {HookParameterMessage(hookFunctionName, originalType)}",
+                    syncVar);
+
+                return null;
             }
-            if (typeReference.Is<GameObject>())
-                return module.ImportReference<GameObjectSyncvar>();
 
-            if (typeReference.Resolve().IsDerivedFrom<NetworkBehaviour>())
-                return module.ImportReference<NetworkBehaviorSyncvar>();
+            foreach (MethodDefinition method in methodsWith2Param)
+            {
+                if (MatchesParameters(method, originalType))
+                {
+                    return method;
+                }
+            }
 
-            return typeReference;
+            logger.Error($"Wrong type for Parameter in hook for '{syncVar.Name}', hook name '{hookFunctionName}'. " +
+                     $"Method signature should be {HookParameterMessage(hookFunctionName, originalType)}",
+                   syncVar);
+
+            return null;
         }
 
-        private TypeReference UnwrapType(FieldDefinition syncvar)
+        static bool MatchesParameters(MethodDefinition method, TypeReference originalType)
         {
-            return originalTypes[syncvar];
+            // matches void onValueChange(T oldValue, T newValue)
+            return method.Parameters[0].ParameterType.FullName == originalType.FullName &&
+                   method.Parameters[1].ParameterType.FullName == originalType.FullName;
         }
 
         private static bool IsWrapped(TypeReference typeReference)
@@ -312,61 +345,28 @@ private static bool IsWrapped(TypeReference typeReference)
                 typeReference.Is<NetworkBehaviorSyncvar>();
         }
 
-        public void ProcessSyncVars(TypeDefinition td)
+        private TypeReference WrapType(FieldDefinition syncvar)
         {
-            // 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 = td.BaseType.Resolve().GetConst<int>(SyncVarCount);
-
-            var fields = new List<FieldDefinition>(td.Fields);
+            TypeReference typeReference = syncvar.FieldType;
 
-            // find syncvars
-            foreach (FieldDefinition fd in fields)
+            originalTypes[syncvar] = typeReference;
+            if (typeReference.Is<NetworkIdentity>())
             {
-                if (!fd.HasCustomAttribute<SyncVarAttribute>())
-                {
-                    continue;
-                }
-
-                if (fd.FieldType.IsGenericParameter)
-                {
-                    logger.Error($"{fd.Name} cannot be synced since it's a generic parameter", fd);
-                    continue;
-                }
-
-                if ((fd.Attributes & FieldAttributes.Static) != 0)
-                {
-                    logger.Error($"{fd.Name} cannot be static", fd);
-                    continue;
-                }
-
-                if (fd.FieldType.IsArray)
-                {
-                    logger.Error($"{fd.Name} has invalid type. Use SyncLists instead of arrays", fd);
-                    continue;
-                }
-
-                if (SyncObjectProcessor.ImplementsSyncObject(fd.FieldType))
-                {
-                    logger.Warning($"{fd.Name} has [SyncVar] attribute. SyncLists should not be marked with SyncVar", fd);
-                    continue;
-                }
-                syncVars.Add(new FoundSyncVar(fd));
-
-                ProcessSyncVar(fd, 1L << dirtyBitCounter);
-                dirtyBitCounter += 1;
+                // change the type of the field to a wrapper NetworkIDentitySyncvar
+                return module.ImportReference<NetworkIdentitySyncvar>();
             }
+            if (typeReference.Is<GameObject>())
+                return module.ImportReference<GameObjectSyncvar>();
 
-            if (dirtyBitCounter >= SyncVarLimit)
-            {
-                logger.Error($"{td.Name} has too many SyncVars. Consider refactoring your class into multiple components", td);
-            }
+            if (typeReference.Resolve().IsDerivedFrom<NetworkBehaviour>())
+                return module.ImportReference<NetworkBehaviorSyncvar>();
 
-            td.SetConst(SyncVarCount, syncVars.Count);
+            return typeReference;
+        }
 
-            GenerateSerialization(td);
-            GenerateDeSerialization(td);
+        private TypeReference UnwrapType(FieldDefinition syncvar)
+        {
+            return originalTypes[syncvar];
         }
 
         void WriteCallHookMethodUsingArgument(ILProcessor worker, MethodDefinition hookMethod, VariableDefinition oldValue)

From ec1d19f35e5970c9f172897cf7d303715c7e516f Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Wed, 18 Aug 2021 14:40:15 +0100
Subject: [PATCH 118/166] refactor(weaver): re-ordering ProcessSyncVars

find all syncvars first, then process them after
---
 .../Weaver/Processors/SyncVarProcessor.cs     | 77 +++++++++++--------
 Assets/Tests/Weaver/SyncVarTests.cs           |  2 +-
 2 files changed, 46 insertions(+), 33 deletions(-)

diff --git a/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs b/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
index 90413ef30bb..4d75d19aec9 100644
--- a/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
@@ -56,45 +56,18 @@ public void ProcessSyncVars(TypeDefinition td)
             // 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
 
+            // get numbers of syncvars in parent class, it will be added to syncvars in this class for total
             int dirtyBitCounter = td.BaseType.Resolve().GetConst<int>(SyncVarCount);
 
-            var fields = new List<FieldDefinition>(td.Fields);
-
             // find syncvars
-            foreach (FieldDefinition fd in fields)
+            foreach (FieldDefinition fd in td.Fields)
             {
-                if (!fd.HasCustomAttribute<SyncVarAttribute>())
+                if (IsValidSyncVar(fd))
                 {
-                    continue;
-                }
-
-                if (fd.FieldType.IsGenericParameter)
-                {
-                    logger.Error($"{fd.Name} cannot be synced since it's a generic parameter", fd);
-                    continue;
-                }
+                    syncVars.Add(new FoundSyncVar(fd));
 
-                if ((fd.Attributes & FieldAttributes.Static) != 0)
-                {
-                    logger.Error($"{fd.Name} cannot be static", fd);
-                    continue;
-                }
-
-                if (fd.FieldType.IsArray)
-                {
-                    logger.Error($"{fd.Name} has invalid type. Use SyncLists instead of arrays", fd);
-                    continue;
+                    dirtyBitCounter++;
                 }
-
-                if (SyncObjectProcessor.ImplementsSyncObject(fd.FieldType))
-                {
-                    logger.Warning($"{fd.Name} has [SyncVar] attribute. SyncLists should not be marked with SyncVar", fd);
-                    continue;
-                }
-                syncVars.Add(new FoundSyncVar(fd));
-
-                ProcessSyncVar(fd, 1L << dirtyBitCounter);
-                dirtyBitCounter += 1;
             }
 
             if (dirtyBitCounter >= SyncVarLimit)
@@ -104,10 +77,50 @@ public void ProcessSyncVars(TypeDefinition td)
 
             td.SetConst(SyncVarCount, syncVars.Count);
 
+            foreach (FoundSyncVar syncvar in syncVars)
+            {
+                ProcessSyncVar(syncvar.fieldDefinition, 1L << dirtyBitCounter);
+            }
+
             GenerateSerialization(td);
             GenerateDeSerialization(td);
         }
 
+        bool IsValidSyncVar(FieldDefinition field)
+        {
+            if (!field.HasCustomAttribute<SyncVarAttribute>())
+            {
+                return false;
+            }
+
+            if (field.FieldType.IsGenericParameter)
+            {
+                logger.Error($"{field.Name} cannot be synced since it's a generic parameter", field);
+                return false;
+            }
+
+            if ((field.Attributes & FieldAttributes.Static) != 0)
+            {
+                logger.Error($"{field.Name} cannot be static", field);
+                return false;
+            }
+
+            if (field.FieldType.IsArray)
+            {
+                // todo should arrays really be blocked?
+                logger.Error($"{field.Name} has invalid type. Use SyncLists instead of arrays", field);
+                return false;
+            }
+
+            if (SyncObjectProcessor.ImplementsSyncObject(field.FieldType))
+            {
+                logger.Warning($"{field.Name} has [SyncVar] attribute. ISyncObject should not be marked with SyncVar", field);
+                return false;
+            }
+
+            return true;
+        }
+
         void ProcessSyncVar(FieldDefinition fd, long dirtyBit)
         {
             string originalName = fd.Name;
diff --git a/Assets/Tests/Weaver/SyncVarTests.cs b/Assets/Tests/Weaver/SyncVarTests.cs
index 28b82d5e2ec..9fdde4a7984 100644
--- a/Assets/Tests/Weaver/SyncVarTests.cs
+++ b/Assets/Tests/Weaver/SyncVarTests.cs
@@ -73,7 +73,7 @@ public void SyncVarsCantBeArray()
         [Test]
         public void SyncVarsSyncList()
         {
-            HasWarning("syncints has [SyncVar] attribute. SyncLists should not be marked with SyncVar",
+            HasWarning("syncints has [SyncVar] attribute. ISyncObject should not be marked with SyncVar",
                 "Mirage.Collections.SyncList`1<System.Int32> SyncVarTests.SyncVarsSyncList.SyncVarsSyncList::syncints");
         }
 

From 167454a9a2ba638a77489da98320e6e5b967b3c3 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Wed, 18 Aug 2021 15:11:28 +0100
Subject: [PATCH 119/166] style(weaver): renaming log function and removing
 format option

---
 .../Weaver/Processors/NetworkBehaviourProcessor.cs     | 10 +++++-----
 Assets/Mirage/Weaver/Processors/RpcProcessor.cs        |  2 +-
 Assets/Mirage/Weaver/Processors/SyncObjectProcessor.cs |  2 +-
 Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs    |  6 +++---
 Assets/Mirage/Weaver/Weaver.cs                         |  4 ++--
 5 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/Assets/Mirage/Weaver/Processors/NetworkBehaviourProcessor.cs b/Assets/Mirage/Weaver/Processors/NetworkBehaviourProcessor.cs
index c02176b06f8..50e64d65171 100644
--- a/Assets/Mirage/Weaver/Processors/NetworkBehaviourProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/NetworkBehaviourProcessor.cs
@@ -26,7 +26,7 @@ class NetworkBehaviourProcessor
 
         public NetworkBehaviourProcessor(TypeDefinition td, Readers readers, Writers writers, PropertySiteProcessor propertySiteProcessor, IWeaverLogger logger)
         {
-            Weaver.DLog(td, "NetworkBehaviourProcessor");
+            Weaver.DebugLog(td, "NetworkBehaviourProcessor");
             netBehaviourSubclass = td;
             this.logger = logger;
             serverRpcProcessor = new ServerRpcProcessor(netBehaviourSubclass.Module, readers, writers, logger);
@@ -43,9 +43,9 @@ public bool Process()
             {
                 return false;
             }
-            Weaver.DLog(netBehaviourSubclass, "Found NetworkBehaviour " + netBehaviourSubclass.FullName);
+            Weaver.DebugLog(netBehaviourSubclass, $"Found NetworkBehaviour {netBehaviourSubclass.FullName}");
 
-            Weaver.DLog(netBehaviourSubclass, "Process Start");
+            Weaver.DebugLog(netBehaviourSubclass, "Process Start");
             MarkAsProcessed(netBehaviourSubclass);
 
             syncVarProcessor.ProcessSyncVars(netBehaviourSubclass);
@@ -54,7 +54,7 @@ public bool Process()
 
             ProcessRpcs();
 
-            Weaver.DLog(netBehaviourSubclass, "Process Done");
+            Weaver.DebugLog(netBehaviourSubclass, "Process Done");
             return true;
         }
 
@@ -80,7 +80,7 @@ public static void MarkAsProcessed(TypeDefinition td)
 
         void RegisterRpcs()
         {
-            Weaver.DLog(netBehaviourSubclass, "  GenerateConstants ");
+            Weaver.DebugLog(netBehaviourSubclass, "  GenerateConstants ");
 
             // find static constructor
             MethodDefinition cctor = netBehaviourSubclass.GetMethod(".cctor");
diff --git a/Assets/Mirage/Weaver/Processors/RpcProcessor.cs b/Assets/Mirage/Weaver/Processors/RpcProcessor.cs
index dd40097f9bb..555021beec1 100644
--- a/Assets/Mirage/Weaver/Processors/RpcProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/RpcProcessor.cs
@@ -354,7 +354,7 @@ public void FixRemoteCallToBaseMethod(TypeDefinition type, MethodDefinition meth
 
                     instruction.Operand = method.Module.ImportReference(baseMethod);
 
-                    Weaver.DLog(type, "Replacing call to '{0}' with '{1}' inside '{2}'", calledMethod.FullName, baseMethod.FullName, method.FullName);
+                    Weaver.DebugLog(type, $"Replacing call to '{calledMethod.FullName}' with '{baseMethod.FullName}' inside '{ method.FullName}'");
                 }
             }
         }
diff --git a/Assets/Mirage/Weaver/Processors/SyncObjectProcessor.cs b/Assets/Mirage/Weaver/Processors/SyncObjectProcessor.cs
index 0015c0d84e4..428ce09de49 100644
--- a/Assets/Mirage/Weaver/Processors/SyncObjectProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncObjectProcessor.cs
@@ -86,7 +86,7 @@ void GenerateReadersAndWriters(TypeReference tr)
 
         void RegisterSyncObjects(TypeDefinition netBehaviourSubclass)
         {
-            Weaver.DLog(netBehaviourSubclass, "  GenerateConstants ");
+            Weaver.DebugLog(netBehaviourSubclass, "  GenerateConstants ");
 
             // find instance constructor
             MethodDefinition ctor = netBehaviourSubclass.GetMethod(".ctor");
diff --git a/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs b/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
index 4d75d19aec9..7a0257e34cf 100644
--- a/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
@@ -124,7 +124,7 @@ bool IsValidSyncVar(FieldDefinition field)
         void ProcessSyncVar(FieldDefinition fd, long dirtyBit)
         {
             string originalName = fd.Name;
-            Weaver.DLog(fd.DeclaringType, "Sync Var " + fd.Name + " " + fd.FieldType);
+            Weaver.DebugLog(fd.DeclaringType, $"Sync Var {fd.Name} {fd.FieldType}");
 
             TypeReference originalType = fd.FieldType;
             fd.FieldType = WrapType(fd);
@@ -461,7 +461,7 @@ void WriteEndFunctionCall()
 
         void GenerateSerialization(TypeDefinition netBehaviourSubclass)
         {
-            Weaver.DLog(netBehaviourSubclass, "  GenerateSerialization");
+            Weaver.DebugLog(netBehaviourSubclass, "  GenerateSerialization");
 
             const string SerializeMethodName = nameof(NetworkBehaviour.SerializeSyncVars);
             if (netBehaviourSubclass.GetMethod(SerializeMethodName) != null)
@@ -585,7 +585,7 @@ private void WriteVariable(ILProcessor worker, ParameterDefinition writerParamet
 
         void GenerateDeSerialization(TypeDefinition netBehaviourSubclass)
         {
-            Weaver.DLog(netBehaviourSubclass, "  GenerateDeSerialization");
+            Weaver.DebugLog(netBehaviourSubclass, "  GenerateDeSerialization");
 
             const string DeserializeMethodName = nameof(NetworkBehaviour.DeserializeSyncVars);
             if (netBehaviourSubclass.GetMethod(DeserializeMethodName) != null)
diff --git a/Assets/Mirage/Weaver/Weaver.cs b/Assets/Mirage/Weaver/Weaver.cs
index b0c31b10435..d807ba7a261 100644
--- a/Assets/Mirage/Weaver/Weaver.cs
+++ b/Assets/Mirage/Weaver/Weaver.cs
@@ -17,9 +17,9 @@ public class Weaver
 
         private AssemblyDefinition CurrentAssembly { get; set; }
 
-        public static void DLog(TypeDefinition td, string fmt, params object[] args)
+        public static void DebugLog(TypeDefinition td, string message)
         {
-            Console.WriteLine("[" + td.Name + "] " + string.Format(fmt, args));
+            Console.WriteLine($"Weaver[{td.Name}]{message}");
         }
 
         public Weaver(IWeaverLogger logger)

From 2bcf22f26c1e76f0ed28a066a8c8384f8396077a Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Wed, 18 Aug 2021 16:23:39 +0100
Subject: [PATCH 120/166] feat(NetworkVisibility): adding default
 implementation for OnRebuildObservers

simplifies create a new NetworkVisibility because only `OnCheckObserver` will need to be overriden
---
 Assets/Mirage/Runtime/NetworkVisibility.cs | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/Assets/Mirage/Runtime/NetworkVisibility.cs b/Assets/Mirage/Runtime/NetworkVisibility.cs
index 3e94f92c50b..3956719dbd3 100644
--- a/Assets/Mirage/Runtime/NetworkVisibility.cs
+++ b/Assets/Mirage/Runtime/NetworkVisibility.cs
@@ -23,10 +23,22 @@ public abstract class NetworkVisibility : NetworkBehaviour
         /// <summary>
         /// Callback used by the visibility system to (re)construct the set of observers that can see this object.
         /// <para>Implementations of this callback should add network connections of players that can see this object to the observers set.</para>
+        /// <para>
+        /// NOTE: override this function if you want to optimize this loop in your visibility,
+        /// for example if you need to call GetComponent on this object you can call it once at the start of the loop
+        /// </para>
         /// </summary>
         /// <param name="observers">The new set of observers for this object.</param>
         /// <param name="initialize">True if the set of observers is being built for the first time.</param>
-        public abstract void OnRebuildObservers(HashSet<INetworkPlayer> observers, bool initialize);
-
+        public virtual void OnRebuildObservers(HashSet<INetworkPlayer> observers, bool initialize)
+        {
+            foreach (INetworkPlayer player in Server.Players)
+            {
+                if (OnCheckObserver(player))
+                {
+                    observers.Add(player);
+                }
+            }
+        }
     }
 }

From f0c8c26c186d685891a065929ac6a2a3fbdd12a4 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Wed, 18 Aug 2021 18:22:53 +0100
Subject: [PATCH 121/166] test: adding timeout to test

---
 Assets/Tests/Runtime/ClientServer/GameObjectSyncvarTest.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Assets/Tests/Runtime/ClientServer/GameObjectSyncvarTest.cs b/Assets/Tests/Runtime/ClientServer/GameObjectSyncvarTest.cs
index 4b9128a30e8..826c7f6484f 100644
--- a/Assets/Tests/Runtime/ClientServer/GameObjectSyncvarTest.cs
+++ b/Assets/Tests/Runtime/ClientServer/GameObjectSyncvarTest.cs
@@ -27,7 +27,7 @@ public void IsNullByDefault()
         {
             serverComponent.target = serverPlayerGO;
 
-            await UniTask.WaitUntil(() => clientComponent.target != null);
+            await AsyncUtil.WaitUntilWithTimeout(() => clientComponent.target != null);
 
             Assert.That(clientComponent.target, Is.SameAs(clientPlayerGO));
         });

From b4a837dde40da17ce7947b835da7e6b747d14e32 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Wed, 18 Aug 2021 18:23:19 +0100
Subject: [PATCH 122/166] fix(weaver): fixing dirty bit for syncvar

---
 .../Weaver/Processors/SyncVarProcessor.cs     | 19 ++++++++-----------
 1 file changed, 8 insertions(+), 11 deletions(-)

diff --git a/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs b/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
index 7a0257e34cf..6678ae1140d 100644
--- a/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
@@ -10,7 +10,6 @@
 
 namespace Mirage.Weaver
 {
-
     /// <summary>
     /// Processes [SyncVar] in NetworkBehaviour
     /// </summary>
@@ -37,7 +36,7 @@ public FoundSyncVar(FieldDefinition fieldDefinition)
 
         // ulong = 64 bytes
         const int SyncVarLimit = 64;
-        private const string SyncVarCount = "SYNC_VAR_COUNT";
+        private const string SyncVarCountField = "SYNC_VAR_COUNT";
 
         static string HookParameterMessage(string hookName, TypeReference ValueType)
             => string.Format("void {0}({1} oldValue, {1} newValue)", hookName, ValueType);
@@ -57,7 +56,7 @@ public void ProcessSyncVars(TypeDefinition td)
             // start assigning syncvars at the place the base class stopped, if any
 
             // get numbers of syncvars in parent class, it will be added to syncvars in this class for total
-            int dirtyBitCounter = td.BaseType.Resolve().GetConst<int>(SyncVarCount);
+            int baseSyncVarCount = td.BaseType.Resolve().GetConst<int>(SyncVarCountField);
 
             // find syncvars
             foreach (FieldDefinition fd in td.Fields)
@@ -65,21 +64,19 @@ public void ProcessSyncVars(TypeDefinition td)
                 if (IsValidSyncVar(fd))
                 {
                     syncVars.Add(new FoundSyncVar(fd));
-
-                    dirtyBitCounter++;
                 }
             }
 
-            if (dirtyBitCounter >= SyncVarLimit)
+            if ((baseSyncVarCount + syncVars.Count) >= SyncVarLimit)
             {
                 logger.Error($"{td.Name} has too many SyncVars. Consider refactoring your class into multiple components", td);
             }
 
-            td.SetConst(SyncVarCount, syncVars.Count);
+            td.SetConst(SyncVarCountField, baseSyncVarCount + syncVars.Count);
 
-            foreach (FoundSyncVar syncvar in syncVars)
+            for (int i = 0; i < syncVars.Count; i++)
             {
-                ProcessSyncVar(syncvar.fieldDefinition, 1L << dirtyBitCounter);
+                ProcessSyncVar(syncVars[i].fieldDefinition, 1L << (baseSyncVarCount + i));
             }
 
             GenerateSerialization(td);
@@ -533,7 +530,7 @@ void GenerateSerialization(TypeDefinition netBehaviourSubclass)
             // generate a writer call for any dirty variable in this class
 
             // start at number of syncvars in parent
-            int dirtyBit = netBehaviourSubclass.BaseType.Resolve().GetConst<int>(SyncVarCount);
+            int dirtyBit = netBehaviourSubclass.BaseType.Resolve().GetConst<int>(SyncVarCountField);
             foreach (FoundSyncVar syncVar in syncVars)
             {
                 Instruction varLabel = worker.Create(OpCodes.Nop);
@@ -642,7 +639,7 @@ void GenerateDeSerialization(TypeDefinition netBehaviourSubclass)
 
             // conditionally read each syncvar
             // start at number of syncvars in parent
-            int dirtyBit = netBehaviourSubclass.BaseType.Resolve().GetConst<int>(SyncVarCount);
+            int dirtyBit = netBehaviourSubclass.BaseType.Resolve().GetConst<int>(SyncVarCountField);
             foreach (FoundSyncVar syncVar in syncVars)
             {
                 Instruction varLabel = serWorker.Create(OpCodes.Nop);

From 8a6dc1dacc7edee8cc010c1ff5af33e71a50e158 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Wed, 18 Aug 2021 18:28:14 +0100
Subject: [PATCH 123/166] test: test to make sure sync var count is carried
 over to child behaviours

---
 .../Tests/Runtime/SyncVarWithBaseClassTest.cs | 59 +++++++++++++++++++
 .../Runtime/SyncVarWithBaseClassTest.cs.meta  | 11 ++++
 2 files changed, 70 insertions(+)
 create mode 100644 Assets/Tests/Runtime/SyncVarWithBaseClassTest.cs
 create mode 100644 Assets/Tests/Runtime/SyncVarWithBaseClassTest.cs.meta

diff --git a/Assets/Tests/Runtime/SyncVarWithBaseClassTest.cs b/Assets/Tests/Runtime/SyncVarWithBaseClassTest.cs
new file mode 100644
index 00000000000..275472878bc
--- /dev/null
+++ b/Assets/Tests/Runtime/SyncVarWithBaseClassTest.cs
@@ -0,0 +1,59 @@
+using NUnit.Framework;
+using UnityEngine;
+
+namespace Mirage.Tests.Runtime.SyncVarWithBaseClass
+{
+    public class A : NetworkBehaviour
+    {
+        [SyncVar] public int i0;
+        [SyncVar] public int i1;
+        [SyncVar] public int i2;
+        [SyncVar] public int i3;
+    }
+    public class B : A
+    {
+        [SyncVar] public int i4;
+        [SyncVar] public int i5;
+        [SyncVar] public int i6;
+    }
+    public class C : B
+    {
+        [SyncVar] public int i7;
+        [SyncVar] public int i8;
+        [SyncVar] public int i9;
+    }
+
+    public class SyncVarWithBaseClassTest
+    {
+        [Test]
+        public void SetsCorrectDirtyBit()
+        {
+            var go = new GameObject("SetsCorrectDirtyBit", typeof(NetworkIdentity), typeof(C));
+            C behaviour = go.GetComponent<C>();
+            Assert.That(behaviour.SyncVarDirtyBits, Is.Zero, "Should start at zero");
+
+            ulong expected = 0ul;
+
+            behaviour.i0 = 1;
+            SetDirtyBit(ref expected, 0);
+            Assert.That(behaviour.SyncVarDirtyBits, Is.EqualTo(expected));
+
+
+            behaviour.i3 = 1;
+            SetDirtyBit(ref expected, 3);
+            Assert.That(behaviour.SyncVarDirtyBits, Is.EqualTo(expected));
+
+            behaviour.i6 = 1;
+            SetDirtyBit(ref expected, 6);
+            Assert.That(behaviour.SyncVarDirtyBits, Is.EqualTo(expected));
+
+            behaviour.i8 = 1;
+            SetDirtyBit(ref expected, 8);
+            Assert.That(behaviour.SyncVarDirtyBits, Is.EqualTo(expected));
+        }
+        void SetDirtyBit(ref ulong bits, int index)
+        {
+            bits |= 1ul << index;
+        }
+    }
+}
diff --git a/Assets/Tests/Runtime/SyncVarWithBaseClassTest.cs.meta b/Assets/Tests/Runtime/SyncVarWithBaseClassTest.cs.meta
new file mode 100644
index 00000000000..f2ca49ab370
--- /dev/null
+++ b/Assets/Tests/Runtime/SyncVarWithBaseClassTest.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: a6b3c031c0b1a2a45b145f46628b3ad4
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

From fb04d1333817aa065d7ddb6c1e721d02548a5eb9 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Thu, 19 Aug 2021 13:32:22 +0100
Subject: [PATCH 124/166] refactor(weaver): moving some syncvar logic to new
 classes

---
 .../Processors/PropertySiteProcessor.cs       |   1 +
 .../Weaver/Processors/SyncVarProcessor.cs     | 267 +++++++-----------
 Assets/Mirage/Weaver/Processors/SyncVars.meta |   8 +
 .../Processors/SyncVars/FoundSyncVar.cs       |  78 +++++
 .../Processors/SyncVars/FoundSyncVar.cs.meta  |  11 +
 .../Processors/SyncVars/HookMethodFinder.cs   |  65 +++++
 .../SyncVars/HookMethodFinder.cs.meta         |  11 +
 Assets/Mirage/Weaver/WeaverExceptions.cs      |   9 +
 8 files changed, 286 insertions(+), 164 deletions(-)
 create mode 100644 Assets/Mirage/Weaver/Processors/SyncVars.meta
 create mode 100644 Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs
 create mode 100644 Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs.meta
 create mode 100644 Assets/Mirage/Weaver/Processors/SyncVars/HookMethodFinder.cs
 create mode 100644 Assets/Mirage/Weaver/Processors/SyncVars/HookMethodFinder.cs.meta

diff --git a/Assets/Mirage/Weaver/Processors/PropertySiteProcessor.cs b/Assets/Mirage/Weaver/Processors/PropertySiteProcessor.cs
index 349cc67d72f..173c70fffde 100644
--- a/Assets/Mirage/Weaver/Processors/PropertySiteProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/PropertySiteProcessor.cs
@@ -5,6 +5,7 @@
 
 namespace Mirage.Weaver
 {
+    // todo add docs for what this type does
     public class PropertySiteProcessor
     {
         // setter functions that replace [SyncVar] member variable references. dict<field, replacement>
diff --git a/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs b/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
index 6678ae1140d..3abe76b15f4 100644
--- a/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
@@ -1,9 +1,9 @@
+using System;
 using System.Collections.Generic;
-using System.Linq;
 using Mirage.Serialization;
+using Mirage.Weaver.SyncVars;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
-using UnityEngine;
 using FieldAttributes = Mono.Cecil.FieldAttributes;
 using MethodAttributes = Mono.Cecil.MethodAttributes;
 using PropertyAttributes = Mono.Cecil.PropertyAttributes;
@@ -15,19 +15,8 @@ namespace Mirage.Weaver
     /// </summary>
     public class SyncVarProcessor
     {
-        private class FoundSyncVar
-        {
-            public readonly FieldDefinition fieldDefinition;
-
-            public FoundSyncVar(FieldDefinition fieldDefinition)
-            {
-                this.fieldDefinition = fieldDefinition;
-            }
-        }
         private readonly List<FoundSyncVar> syncVars = new List<FoundSyncVar>();
 
-        // store the unwrapped types for every field
-        private readonly Dictionary<FieldDefinition, TypeReference> originalTypes = new Dictionary<FieldDefinition, TypeReference>();
         private readonly ModuleDefinition module;
         private readonly Readers readers;
         private readonly Writers writers;
@@ -38,8 +27,6 @@ public FoundSyncVar(FieldDefinition fieldDefinition)
         const int SyncVarLimit = 64;
         private const string SyncVarCountField = "SYNC_VAR_COUNT";
 
-        static string HookParameterMessage(string hookName, TypeReference ValueType)
-            => string.Format("void {0}({1} oldValue, {1} newValue)", hookName, ValueType);
 
         public SyncVarProcessor(ModuleDefinition module, Readers readers, Writers writers, PropertySiteProcessor propertySiteProcessor, IWeaverLogger logger)
         {
@@ -56,27 +43,28 @@ public void ProcessSyncVars(TypeDefinition td)
             // start assigning syncvars at the place the base class stopped, if any
 
             // get numbers of syncvars in parent class, it will be added to syncvars in this class for total
-            int baseSyncVarCount = td.BaseType.Resolve().GetConst<int>(SyncVarCountField);
+            int syncVarCount = td.BaseType.Resolve().GetConst<int>(SyncVarCountField);
 
             // find syncvars
             foreach (FieldDefinition fd in td.Fields)
             {
                 if (IsValidSyncVar(fd))
                 {
-                    syncVars.Add(new FoundSyncVar(fd));
+                    syncVars.Add(new FoundSyncVar(fd, syncVarCount));
+                    syncVarCount++;
                 }
             }
 
-            if ((baseSyncVarCount + syncVars.Count) >= SyncVarLimit)
+            if (syncVarCount >= SyncVarLimit)
             {
                 logger.Error($"{td.Name} has too many SyncVars. Consider refactoring your class into multiple components", td);
             }
 
-            td.SetConst(SyncVarCountField, baseSyncVarCount + syncVars.Count);
+            td.SetConst(SyncVarCountField, syncVarCount);
 
-            for (int i = 0; i < syncVars.Count; i++)
+            foreach (FoundSyncVar syncVar in syncVars)
             {
-                ProcessSyncVar(syncVars[i].fieldDefinition, 1L << (baseSyncVarCount + i));
+                ProcessSyncVar(syncVar);
             }
 
             GenerateSerialization(td);
@@ -118,20 +106,21 @@ bool IsValidSyncVar(FieldDefinition field)
             return true;
         }
 
-        void ProcessSyncVar(FieldDefinition fd, long dirtyBit)
+        void ProcessSyncVar(FoundSyncVar syncVar)
         {
+            FieldDefinition fd = syncVar.FieldDefinition;
+
             string originalName = fd.Name;
             Weaver.DebugLog(fd.DeclaringType, $"Sync Var {fd.Name} {fd.FieldType}");
 
-            TypeReference originalType = fd.FieldType;
-            fd.FieldType = WrapType(fd);
+            syncVar.SetWrapType(module);
 
-            MethodDefinition get = GenerateSyncVarGetter(fd, originalName, originalType);
-            MethodDefinition set = GenerateSyncVarSetter(fd, originalName, dirtyBit, originalType);
+            MethodDefinition get = GenerateSyncVarGetter(syncVar);
+            MethodDefinition set = GenerateSyncVarSetter(syncVar);
 
             //NOTE: is property even needed? Could just use a setter function?
             //create the property
-            var propertyDefinition = new PropertyDefinition("Network" + originalName, PropertyAttributes.None, originalType)
+            var propertyDefinition = new PropertyDefinition("Network" + originalName, PropertyAttributes.None, syncVar.OriginalType)
             {
                 GetMethod = get,
                 SetMethod = set
@@ -142,14 +131,28 @@ void ProcessSyncVar(FieldDefinition fd, long dirtyBit)
             fd.DeclaringType.Properties.Add(propertyDefinition);
             propertySiteProcessor.Setters[fd] = set;
 
-            if (IsWrapped(fd.FieldType))
+            if (syncVar.IsWrapped)
             {
                 propertySiteProcessor.Getters[fd] = get;
             }
+
+            try
+            {
+                syncVar.ProcessAttributes();
+            }
+            catch (WeaverException e)
+            {
+                // todo what do we do if syncvar has errors?
+                logger.Error(e);
+            }
         }
 
-        MethodDefinition GenerateSyncVarGetter(FieldDefinition fd, string originalName, TypeReference originalType)
+        MethodDefinition GenerateSyncVarGetter(FoundSyncVar syncVar)
         {
+            FieldDefinition fd = syncVar.FieldDefinition;
+            TypeReference originalType = syncVar.OriginalType;
+            string originalName = syncVar.OriginalName;
+
             //Create the get method
             MethodDefinition get = fd.DeclaringType.AddMethod(
                     "get_Network" + originalName, MethodAttributes.Public |
@@ -158,7 +161,7 @@ MethodDefinition GenerateSyncVarGetter(FieldDefinition fd, string originalName,
                     originalType);
 
             ILProcessor worker = get.Body.GetILProcessor();
-            LoadField(fd, originalType, worker);
+            WriteLoadField(worker, syncVar);
 
             worker.Append(worker.Create(OpCodes.Ret));
 
@@ -167,8 +170,11 @@ MethodDefinition GenerateSyncVarGetter(FieldDefinition fd, string originalName,
             return get;
         }
 
-        MethodDefinition GenerateSyncVarSetter(FieldDefinition fd, string originalName, long dirtyBit, TypeReference originalType)
+        MethodDefinition GenerateSyncVarSetter(FoundSyncVar syncVar)
         {
+            FieldDefinition fd = syncVar.FieldDefinition;
+            TypeReference originalType = syncVar.OriginalType;
+            string originalName = syncVar.OriginalName;
 
             //Create the set method
             MethodDefinition set = fd.DeclaringType.AddMethod("set_Network" + originalName, MethodAttributes.Public |
@@ -188,7 +194,7 @@ MethodDefinition GenerateSyncVarSetter(FieldDefinition fd, string originalName,
             worker.Append(worker.Create(OpCodes.Ldarg, valueParam));
             // reference to field to set
             // make generic version of SetSyncVar with field type
-            LoadField(fd, originalType, worker);
+            WriteLoadField(worker, syncVar);
 
             MethodReference syncVarEqual = module.ImportReference<NetworkBehaviour>(nb => nb.SyncVarEqual<object>(default, default));
             var syncVarEqualGm = new GenericInstanceMethod(syncVarEqual.GetElementMethod());
@@ -199,20 +205,18 @@ MethodDefinition GenerateSyncVarSetter(FieldDefinition fd, string originalName,
 
             // T oldValue = value;
             VariableDefinition oldValue = set.AddLocal(originalType);
-            LoadField(fd, originalType, worker);
+            WriteLoadField(worker, syncVar);
             worker.Append(worker.Create(OpCodes.Stloc, oldValue));
 
             // fieldValue = value;
-            StoreField(fd, valueParam, worker);
+            WriteStoreField(worker, valueParam, syncVar);
 
             // this.SetDirtyBit(dirtyBit)
             worker.Append(worker.Create(OpCodes.Ldarg_0));
-            worker.Append(worker.Create(OpCodes.Ldc_I8, dirtyBit));
+            worker.Append(worker.Create(OpCodes.Ldc_I8, syncVar.DirtyBit));
             worker.Append(worker.Create<NetworkBehaviour>(OpCodes.Call, nb => nb.SetDirtyBit(default)));
 
-            MethodDefinition hookMethod = GetHookMethod(fd, originalType);
-
-            if (hookMethod != null)
+            if (syncVar.HasHookMethod)
             {
                 //if (base.isLocalClient && !getSyncVarHookGuard(dirtyBit))
                 Instruction label = worker.Create(OpCodes.Nop);
@@ -220,23 +224,23 @@ MethodDefinition GenerateSyncVarSetter(FieldDefinition fd, string originalName,
                 worker.Append(worker.Create(OpCodes.Call, (NetworkBehaviour nb) => nb.IsLocalClient));
                 worker.Append(worker.Create(OpCodes.Brfalse, label));
                 worker.Append(worker.Create(OpCodes.Ldarg_0));
-                worker.Append(worker.Create(OpCodes.Ldc_I8, dirtyBit));
+                worker.Append(worker.Create(OpCodes.Ldc_I8, syncVar.DirtyBit));
                 worker.Append(worker.Create<NetworkBehaviour>(OpCodes.Call, nb => nb.GetSyncVarHookGuard(default)));
                 worker.Append(worker.Create(OpCodes.Brtrue, label));
 
                 // setSyncVarHookGuard(dirtyBit, true);
                 worker.Append(worker.Create(OpCodes.Ldarg_0));
-                worker.Append(worker.Create(OpCodes.Ldc_I8, dirtyBit));
+                worker.Append(worker.Create(OpCodes.Ldc_I8, syncVar.DirtyBit));
                 worker.Append(worker.Create(OpCodes.Ldc_I4_1));
                 worker.Append(worker.Create<NetworkBehaviour>(OpCodes.Call, nb => nb.SetSyncVarHookGuard(default, default)));
 
                 // call hook (oldValue, newValue)
                 // Generates: OnValueChanged(oldValue, value);
-                WriteCallHookMethodUsingArgument(worker, hookMethod, oldValue);
+                WriteCallHookMethodUsingArgument(worker, syncVar.HookMethod, oldValue);
 
                 // setSyncVarHookGuard(dirtyBit, false);
                 worker.Append(worker.Create(OpCodes.Ldarg_0));
-                worker.Append(worker.Create(OpCodes.Ldc_I8, dirtyBit));
+                worker.Append(worker.Create(OpCodes.Ldc_I8, syncVar.DirtyBit));
                 worker.Append(worker.Create(OpCodes.Ldc_I4_0));
                 worker.Append(worker.Create<NetworkBehaviour>(OpCodes.Call, nb => nb.SetSyncVarHookGuard(default, default)));
 
@@ -250,11 +254,20 @@ MethodDefinition GenerateSyncVarSetter(FieldDefinition fd, string originalName,
             return set;
         }
 
-        private void LoadField(FieldDefinition fd, TypeReference originalType, ILProcessor worker)
+        /// <summary>
+        /// Writes Load field to IL worker, eg `this.field`
+        /// <para>If syncvar is wrapped will use get_Value method instead</para>
+        /// </summary>
+        /// <param name="worker"></param>
+        /// <param name="syncVar"></param>
+        private void WriteLoadField(ILProcessor worker, FoundSyncVar syncVar)
         {
+            FieldDefinition fd = syncVar.FieldDefinition;
+            TypeReference originalType = syncVar.OriginalType;
+
             worker.Append(worker.Create(OpCodes.Ldarg_0));
 
-            if (IsWrapped(fd.FieldType))
+            if (syncVar.IsWrapped)
             {
                 worker.Append(worker.Create(OpCodes.Ldflda, fd.MakeHostGenericIfNeeded()));
                 MethodReference getter = module.ImportReference(fd.FieldType.Resolve().GetMethod("get_Value"));
@@ -275,9 +288,18 @@ private void LoadField(FieldDefinition fd, TypeReference originalType, ILProcess
             }
         }
 
-        private void StoreField(FieldDefinition fd, ParameterDefinition valueParam, ILProcessor worker)
+        /// <summary>
+        /// Writes Store field to IL worker, eg `this.field = `
+        /// <para>If syncvar is wrapped will use set_Value method instead</para>
+        /// </summary>
+        /// <param name="worker"></param>
+        /// <param name="valueParam"></param>
+        /// <param name="syncVar"></param>
+        private void WriteStoreField(ILProcessor worker, ParameterDefinition valueParam, FoundSyncVar syncVar)
         {
-            if (IsWrapped(fd.FieldType))
+            FieldDefinition fd = syncVar.FieldDefinition;
+
+            if (syncVar.IsWrapped)
             {
                 // there is a wrapper struct, call the setter
                 MethodReference setter = module.ImportReference(fd.FieldType.Resolve().GetMethod("set_Value"));
@@ -295,106 +317,23 @@ private void StoreField(FieldDefinition fd, ParameterDefinition valueParam, ILPr
             }
         }
 
-        // Get hook method if any
-        MethodDefinition GetHookMethod(FieldDefinition syncVar, TypeReference originalType)
-        {
-            CustomAttribute syncVarAttr = syncVar.GetCustomAttribute<SyncVarAttribute>();
-
-            if (syncVarAttr == null)
-                return null;
-
-            string hookFunctionName = syncVarAttr.GetField<string>("hook", null);
-
-            if (hookFunctionName == null)
-                return null;
-
-            return FindHookMethod(syncVar, hookFunctionName, originalType);
-        }
-
-        MethodDefinition FindHookMethod(FieldDefinition syncVar, string hookFunctionName, TypeReference originalType)
-        {
-            List<MethodDefinition> methods = syncVar.DeclaringType.GetMethods(hookFunctionName);
-
-            var methodsWith2Param = new List<MethodDefinition>(methods.Where(m => m.Parameters.Count == 2));
-
-            if (methodsWith2Param.Count == 0)
-            {
-                logger.Error($"Could not find hook for '{syncVar.Name}', hook name '{hookFunctionName}'. " +
-                    $"Method signature should be {HookParameterMessage(hookFunctionName, originalType)}",
-                    syncVar);
-
-                return null;
-            }
-
-            foreach (MethodDefinition method in methodsWith2Param)
-            {
-                if (MatchesParameters(method, originalType))
-                {
-                    return method;
-                }
-            }
-
-            logger.Error($"Wrong type for Parameter in hook for '{syncVar.Name}', hook name '{hookFunctionName}'. " +
-                     $"Method signature should be {HookParameterMessage(hookFunctionName, originalType)}",
-                   syncVar);
-
-            return null;
-        }
-
-        static bool MatchesParameters(MethodDefinition method, TypeReference originalType)
-        {
-            // matches void onValueChange(T oldValue, T newValue)
-            return method.Parameters[0].ParameterType.FullName == originalType.FullName &&
-                   method.Parameters[1].ParameterType.FullName == originalType.FullName;
-        }
-
-        private static bool IsWrapped(TypeReference typeReference)
-        {
-            return typeReference.Is<NetworkIdentitySyncvar>() ||
-                typeReference.Is<GameObjectSyncvar>() ||
-                typeReference.Is<NetworkBehaviorSyncvar>();
-        }
-
-        private TypeReference WrapType(FieldDefinition syncvar)
-        {
-            TypeReference typeReference = syncvar.FieldType;
-
-            originalTypes[syncvar] = typeReference;
-            if (typeReference.Is<NetworkIdentity>())
-            {
-                // change the type of the field to a wrapper NetworkIDentitySyncvar
-                return module.ImportReference<NetworkIdentitySyncvar>();
-            }
-            if (typeReference.Is<GameObject>())
-                return module.ImportReference<GameObjectSyncvar>();
-
-            if (typeReference.Resolve().IsDerivedFrom<NetworkBehaviour>())
-                return module.ImportReference<NetworkBehaviorSyncvar>();
-
-            return typeReference;
-        }
-
-        private TypeReference UnwrapType(FieldDefinition syncvar)
-        {
-            return originalTypes[syncvar];
-        }
 
         void WriteCallHookMethodUsingArgument(ILProcessor worker, MethodDefinition hookMethod, VariableDefinition oldValue)
         {
             WriteCallHookMethod(worker, hookMethod, oldValue, null);
         }
 
-        void WriteCallHookMethodUsingField(ILProcessor worker, MethodDefinition hookMethod, VariableDefinition oldValue, FieldDefinition newValue)
+        void WriteCallHookMethodUsingField(ILProcessor worker, MethodDefinition hookMethod, VariableDefinition oldValue, FoundSyncVar syncVarField)
         {
-            if (newValue == null)
+            if (syncVarField == null)
             {
-                logger.Error("NewValue field was null when writing SyncVar hook");
+                throw new ArgumentNullException(nameof(syncVarField));
             }
 
-            WriteCallHookMethod(worker, hookMethod, oldValue, newValue);
+            WriteCallHookMethod(worker, hookMethod, oldValue, syncVarField);
         }
 
-        void WriteCallHookMethod(ILProcessor worker, MethodDefinition hookMethod, VariableDefinition oldValue, FieldDefinition newValue)
+        void WriteCallHookMethod(ILProcessor worker, MethodDefinition hookMethod, VariableDefinition oldValue, FoundSyncVar syncVarField)
         {
             WriteStartFunctionCall();
 
@@ -416,13 +355,13 @@ void WriteOldValue()
             void WriteNewValue()
             {
                 // write arg1 or this.field
-                if (newValue == null)
+                if (syncVarField == null)
                 {
                     worker.Append(worker.Create(OpCodes.Ldarg_1));
                 }
                 else
                 {
-                    LoadField(newValue, oldValue.VariableType, worker);
+                    WriteLoadField(worker, syncVarField);
                 }
             }
 
@@ -442,7 +381,7 @@ void WriteStartFunctionCall()
             void WriteEndFunctionCall()
             {
                 // only use Callvirt when not static
-                OpCode opcode = hookMethod.IsStatic ? OpCodes.Call : OpCodes.Callvirt;
+                OpCode OpCall = hookMethod.IsStatic ? OpCodes.Call : OpCodes.Callvirt;
                 MethodReference hookMethodReference = hookMethod;
 
                 if (hookMethodReference.DeclaringType.HasGenericParameters)
@@ -452,7 +391,7 @@ void WriteEndFunctionCall()
                     hookMethodReference = hookMethod.MakeHostInstanceGeneric(genericType);
                 }
 
-                worker.Append(worker.Create(opcode, module.ImportReference(hookMethodReference)));
+                worker.Append(worker.Create(OpCall, module.ImportReference(hookMethodReference)));
             }
         }
 
@@ -505,7 +444,7 @@ void GenerateSerialization(TypeDefinition netBehaviourSubclass)
 
             foreach (FoundSyncVar syncVar in syncVars)
             {
-                WriteVariable(worker, writerParameter, syncVar.fieldDefinition);
+                WriteVariable(worker, writerParameter, syncVar.FieldDefinition);
             }
 
             // always return true if forceAll
@@ -545,7 +484,7 @@ void GenerateSerialization(TypeDefinition netBehaviourSubclass)
                 worker.Append(worker.Create(OpCodes.Brfalse, varLabel));
 
                 // Generates a call to the writer for that field
-                WriteVariable(worker, writerParameter, syncVar.fieldDefinition);
+                WriteVariable(worker, writerParameter, syncVar.FieldDefinition);
 
                 // something was dirty
                 worker.Append(worker.Create(OpCodes.Ldc_I4_1));
@@ -624,7 +563,7 @@ void GenerateDeSerialization(TypeDefinition netBehaviourSubclass)
 
             foreach (FoundSyncVar syncVar in syncVars)
             {
-                DeserializeField(syncVar.fieldDefinition, serWorker, serialize);
+                DeserializeField(serWorker, serialize, syncVar);
             }
 
             serWorker.Append(serWorker.Create(OpCodes.Ret));
@@ -650,7 +589,7 @@ void GenerateDeSerialization(TypeDefinition netBehaviourSubclass)
                 serWorker.Append(serWorker.Create(OpCodes.And));
                 serWorker.Append(serWorker.Create(OpCodes.Brfalse, varLabel));
 
-                DeserializeField(syncVar.fieldDefinition, serWorker, serialize);
+                DeserializeField(serWorker, serialize, syncVar);
 
                 serWorker.Append(varLabel);
                 dirtyBit += 1;
@@ -662,15 +601,15 @@ void GenerateDeSerialization(TypeDefinition netBehaviourSubclass)
         /// <summary>
         /// [SyncVar] int/float/struct/etc.?
         /// </summary>
-        /// <param name="syncVar"></param>
-        /// <param name="serWorker"></param>
+        /// <param name="fd"></param>
+        /// <param name="worker"></param>
         /// <param name="deserialize"></param>
         /// <param name="initialState"></param>
         /// <param name="hookResult"></param>
-        void DeserializeField(FieldDefinition syncVar, ILProcessor serWorker, MethodDefinition deserialize)
+        void DeserializeField(ILProcessor worker, MethodDefinition deserialize, FoundSyncVar syncvar)
         {
-            TypeReference originalType = UnwrapType(syncVar);
-            MethodDefinition hookMethod = GetHookMethod(syncVar, originalType);
+            FieldDefinition fd = syncvar.FieldDefinition;
+            TypeReference originalType = syncvar.OriginalType;
 
             /*
              Generates code like:
@@ -682,18 +621,18 @@ void DeserializeField(FieldDefinition syncVar, ILProcessor serWorker, MethodDefi
                     OnSetA(oldValue, Networka);
                 }
              */
-            MethodReference readFunc = readers.TryGetFunction(syncVar.FieldType, null);
+            MethodReference readFunc = readers.TryGetFunction(fd.FieldType, null);
             if (readFunc == null)
             {
-                logger.Error($"{syncVar.Name} has unsupported type. Use a supported Mirage type instead", syncVar);
+                logger.Error($"{fd.Name} has unsupported type. Use a supported Mirage type instead", fd);
                 return;
             }
 
             // T oldValue = value;
             VariableDefinition oldValue = deserialize.AddLocal(originalType);
-            LoadField(syncVar, originalType, serWorker);
+            WriteLoadField(worker, syncvar);
 
-            serWorker.Append(serWorker.Create(OpCodes.Stloc, oldValue));
+            worker.Append(worker.Create(OpCodes.Stloc, oldValue));
 
             // read value and store in syncvar BEFORE calling the hook
             // -> this makes way more sense. by definition, the hook is
@@ -705,15 +644,15 @@ void DeserializeField(FieldDefinition syncVar, ILProcessor serWorker, MethodDefi
             //    values BEFORE the hook even returned and hence BEFORE the
             //    actual value was even set.
             // put 'this.' onto stack for 'this.syncvar' below
-            serWorker.Append(serWorker.Create(OpCodes.Ldarg_0));
+            worker.Append(worker.Create(OpCodes.Ldarg_0));
             // reader. for 'reader.Read()' below
-            serWorker.Append(serWorker.Create(OpCodes.Ldarg_1));
+            worker.Append(worker.Create(OpCodes.Ldarg_1));
             // reader.Read()
-            serWorker.Append(serWorker.Create(OpCodes.Call, readFunc));
+            worker.Append(worker.Create(OpCodes.Call, readFunc));
             // syncvar
-            serWorker.Append(serWorker.Create(OpCodes.Stfld, syncVar.MakeHostGenericIfNeeded()));
+            worker.Append(worker.Create(OpCodes.Stfld, fd.MakeHostGenericIfNeeded()));
 
-            if (hookMethod != null)
+            if (syncvar.HasHookMethod)
             {
                 // call hook
                 // but only if SyncVar changed. otherwise a client would
@@ -722,27 +661,27 @@ void DeserializeField(FieldDefinition syncVar, ILProcessor serWorker, MethodDefi
                 // see also: https://github.com/vis2k/Mirror/issues/1278
 
                 // Generates: if (!SyncVarEqual);
-                Instruction syncVarEqualLabel = serWorker.Create(OpCodes.Nop);
+                Instruction syncVarEqualLabel = worker.Create(OpCodes.Nop);
 
                 // 'this.' for 'this.SyncVarEqual'
-                serWorker.Append(serWorker.Create(OpCodes.Ldarg_0));
+                worker.Append(worker.Create(OpCodes.Ldarg_0));
                 // 'oldValue'
-                serWorker.Append(serWorker.Create(OpCodes.Ldloc, oldValue));
+                worker.Append(worker.Create(OpCodes.Ldloc, oldValue));
                 // 'newValue'
-                LoadField(syncVar, originalType, serWorker);
+                WriteLoadField(worker, syncvar);
                 // call the function
                 MethodReference syncVarEqual = module.ImportReference<NetworkBehaviour>(nb => nb.SyncVarEqual<object>(default, default));
                 var syncVarEqualGm = new GenericInstanceMethod(syncVarEqual.GetElementMethod());
                 syncVarEqualGm.GenericArguments.Add(originalType);
-                serWorker.Append(serWorker.Create(OpCodes.Call, syncVarEqualGm));
-                serWorker.Append(serWorker.Create(OpCodes.Brtrue, syncVarEqualLabel));
+                worker.Append(worker.Create(OpCodes.Call, syncVarEqualGm));
+                worker.Append(worker.Create(OpCodes.Brtrue, syncVarEqualLabel));
 
                 // call the hook
                 // Generates: OnValueChanged(oldValue, this.syncVar);
-                WriteCallHookMethodUsingField(serWorker, hookMethod, oldValue, syncVar);
+                WriteCallHookMethodUsingField(worker, syncvar.HookMethod, oldValue, syncvar);
 
                 // Generates: end if (!SyncVarEqual);
-                serWorker.Append(syncVarEqualLabel);
+                worker.Append(syncVarEqualLabel);
             }
         }
     }
diff --git a/Assets/Mirage/Weaver/Processors/SyncVars.meta b/Assets/Mirage/Weaver/Processors/SyncVars.meta
new file mode 100644
index 00000000000..2c907cf95b2
--- /dev/null
+++ b/Assets/Mirage/Weaver/Processors/SyncVars.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 04f38555490187c4da62100646f17a77
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs b/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs
new file mode 100644
index 00000000000..c43b561795e
--- /dev/null
+++ b/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs
@@ -0,0 +1,78 @@
+using Mono.Cecil;
+using UnityEngine;
+
+namespace Mirage.Weaver.SyncVars
+{
+    internal class FoundSyncVar
+    {
+        public readonly FieldDefinition FieldDefinition;
+        public readonly int DirtyIndex;
+        public long DirtyBit => 1L << DirtyIndex;
+
+        public FoundSyncVar(FieldDefinition fieldDefinition, int dirtyIndex)
+        {
+            FieldDefinition = fieldDefinition;
+            DirtyIndex = dirtyIndex;
+        }
+
+        public string OriginalName { get; private set; }
+        public TypeReference OriginalType { get; private set; }
+        public bool IsWrapped { get; private set; }
+
+
+        public bool HasHookMethod { get; private set; }
+        public MethodDefinition HookMethod { get; private set; }
+
+        /// <summary>
+        /// Changing the type of the field to the wrapper type, if one exists
+        /// </summary>
+        public void SetWrapType(ModuleDefinition module)
+        {
+            OriginalName = FieldDefinition.Name;
+            OriginalType = FieldDefinition.FieldType;
+
+            if (CheckWrapType(module, OriginalType, out TypeReference wrapType))
+            {
+                IsWrapped = true;
+                FieldDefinition.FieldType = wrapType;
+            }
+        }
+
+        private static bool CheckWrapType(ModuleDefinition module, TypeReference originalType, out TypeReference wrapType)
+        {
+            TypeReference typeReference = originalType;
+
+            if (typeReference.Is<NetworkIdentity>())
+            {
+                // change the type of the field to a wrapper NetworkIdentitySyncvar
+                wrapType = module.ImportReference<NetworkIdentitySyncvar>();
+                return true;
+            }
+            if (typeReference.Is<GameObject>())
+            {
+                wrapType = module.ImportReference<GameObjectSyncvar>();
+                return true;
+            }
+
+            if (typeReference.Resolve().IsDerivedFrom<NetworkBehaviour>())
+            {
+                wrapType = module.ImportReference<NetworkBehaviorSyncvar>();
+                return true;
+            }
+
+            wrapType = null;
+            return false;
+        }
+
+
+        /// <summary>
+        /// Finds any attribute values needed for this syncvar
+        /// </summary>
+        /// <param name="module"></param>
+        public void ProcessAttributes()
+        {
+            HookMethod = HookMethodFinder.GetHookMethod(FieldDefinition, OriginalType);
+            HasHookMethod = HookMethod != null;
+        }
+    }
+}
diff --git a/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs.meta b/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs.meta
new file mode 100644
index 00000000000..1ffdc3fcede
--- /dev/null
+++ b/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 8808f99210d288346aebf69bcb930fd2
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Weaver/Processors/SyncVars/HookMethodFinder.cs b/Assets/Mirage/Weaver/Processors/SyncVars/HookMethodFinder.cs
new file mode 100644
index 00000000000..7c33d4d089f
--- /dev/null
+++ b/Assets/Mirage/Weaver/Processors/SyncVars/HookMethodFinder.cs
@@ -0,0 +1,65 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using Mono.Cecil;
+
+namespace Mirage.Weaver.SyncVars
+{
+    internal static class HookMethodFinder
+    {
+        /// <returns>Found Hook method or null</returns>
+        /// <exception cref="HookMethodException">Throws if users sets hook in attribute but method could not be found</exception>
+        public static MethodDefinition GetHookMethod(FieldDefinition syncVar, TypeReference originalType)
+        {
+            CustomAttribute syncVarAttr = syncVar.GetCustomAttribute<SyncVarAttribute>();
+
+            if (syncVarAttr == null)
+                throw new InvalidOperationException("FoundSyncVar did not have a SyncVarAttribute");
+
+            string hookFunctionName = syncVarAttr.GetField<string>("hook", null);
+
+            if (string.IsNullOrEmpty(hookFunctionName))
+                return null;
+
+            return FindHookMethod(syncVar, hookFunctionName, originalType);
+        }
+
+        static MethodDefinition FindHookMethod(FieldDefinition syncVar, string hookFunctionName, TypeReference originalType)
+        {
+            List<MethodDefinition> methods = syncVar.DeclaringType.GetMethods(hookFunctionName);
+
+            var methodsWith2Param = new List<MethodDefinition>(methods.Where(m => m.Parameters.Count == 2));
+
+            if (methodsWith2Param.Count == 0)
+            {
+                throw new HookMethodException($"Could not find hook for '{syncVar.Name}', hook name '{hookFunctionName}'. " +
+                    $"Method signature should be {HookParameterMessage(hookFunctionName, originalType)}",
+                    syncVar);
+            }
+
+            foreach (MethodDefinition method in methodsWith2Param)
+            {
+                if (MatchesParameters(method, originalType))
+                {
+                    return method;
+                }
+            }
+
+            throw new HookMethodException($"Wrong type for Parameter in hook for '{syncVar.Name}', hook name '{hookFunctionName}'. " +
+                $"Method signature should be {HookParameterMessage(hookFunctionName, originalType)}",
+                syncVar);
+        }
+
+        static string HookParameterMessage(string hookName, TypeReference ValueType)
+            => string.Format("void {0}({1} oldValue, {1} newValue)", hookName, ValueType);
+
+
+        static bool MatchesParameters(MethodDefinition method, TypeReference originalType)
+        {
+            // matches void onValueChange(T oldValue, T newValue)
+            return method.Parameters[0].ParameterType.FullName == originalType.FullName &&
+                   method.Parameters[1].ParameterType.FullName == originalType.FullName;
+        }
+
+    }
+}
diff --git a/Assets/Mirage/Weaver/Processors/SyncVars/HookMethodFinder.cs.meta b/Assets/Mirage/Weaver/Processors/SyncVars/HookMethodFinder.cs.meta
new file mode 100644
index 00000000000..c8d2a119526
--- /dev/null
+++ b/Assets/Mirage/Weaver/Processors/SyncVars/HookMethodFinder.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 369246307d5849c4085b5c6dd017f93d
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Weaver/WeaverExceptions.cs b/Assets/Mirage/Weaver/WeaverExceptions.cs
index 3df6fe22953..6533a46d427 100644
--- a/Assets/Mirage/Weaver/WeaverExceptions.cs
+++ b/Assets/Mirage/Weaver/WeaverExceptions.cs
@@ -26,3 +26,12 @@ internal class SyncVarException : WeaverException
         public SyncVarException(string message, MemberReference memberReference) : base(message, memberReference, null) { }
     }
 }
+
+
+namespace Mirage.Weaver.SyncVars
+{
+    internal class HookMethodException : WeaverException
+    {
+        public HookMethodException(string message, MemberReference memberReference) : base(message, memberReference, null) { }
+    }
+}

From 88e22622f620017e7a8d7826a7faa192737aca2e Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Thu, 19 Aug 2021 13:55:49 +0000
Subject: [PATCH 125/166] chore(release): 101.4.1 [skip ci]

## [101.4.1](https://github.com/MirageNet/Mirage/compare/v101.4.0...v101.4.1) (2021-08-19)

### Bug Fixes

* **weaver:** fixing dirty bit for syncvar ([b4a837d](https://github.com/MirageNet/Mirage/commit/b4a837dde40da17ce7947b835da7e6b747d14e32))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs               | 2 +-
 Assets/Mirage/CHANGELOG.md                                 | 7 +++++++
 Assets/Mirage/Components/AssemblyInfo.cs                   | 2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                      | 2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs          | 2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs                     | 2 +-
 .../Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs      | 2 +-
 Assets/Mirage/package.json                                 | 2 +-
 8 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index c16a5a36256..0b0bfc4bd34 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.4.0")]
+[assembly: AssemblyVersion("101.4.1")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index c2bf45d29b8..5d267cd9f17 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,10 @@
+## [101.4.1](https://github.com/MirageNet/Mirage/compare/v101.4.0...v101.4.1) (2021-08-19)
+
+
+### Bug Fixes
+
+* **weaver:** fixing dirty bit for syncvar ([b4a837d](https://github.com/MirageNet/Mirage/commit/b4a837dde40da17ce7947b835da7e6b747d14e32))
+
 # [101.4.0](https://github.com/MirageNet/Mirage/compare/v101.3.0...v101.4.0) (2021-08-17)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index 4bda5fe08cf..95803e3bbab 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.4.0")]
+[assembly: AssemblyVersion("101.4.1")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index aa7c84737b1..c6a37d8eded 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.4.0")]
+[assembly: AssemblyVersion("101.4.1")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index d0ce2a7a313..6c792255f70 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.4.0")]
+[assembly: AssemblyVersion("101.4.1")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index c16a5a36256..0b0bfc4bd34 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.4.0")]
+[assembly: AssemblyVersion("101.4.1")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index c16a5a36256..0b0bfc4bd34 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.4.0")]
+[assembly: AssemblyVersion("101.4.1")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index ac26d90ee44..59222d5d446 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "101.4.0",
+    "version": "101.4.1",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From 185503a145b8c86abec7f765ca79fd271488763c Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Fri, 20 Aug 2021 21:05:23 +0100
Subject: [PATCH 126/166] refactor(Weaver): splitting serialize and deserialize
 into functions

---
 .../Weaver/Processors/NetworkBehaviour.meta   |   8 +
 .../NetworkBehaviour/DeserializeHelper.cs     | 122 +++++++
 .../DeserializeHelper.cs.meta                 |  11 +
 .../NetworkBehaviour/FoundNetworkBehaviour.cs |  56 +++
 .../FoundNetworkBehaviour.cs.meta             |  11 +
 .../NetworkBehaviour/SerializeHelper.cs       | 166 +++++++++
 .../NetworkBehaviour/SerializeHelper.cs.meta  |  11 +
 .../Processors/NetworkBehaviourProcessor.cs   |  11 +-
 .../Weaver/Processors/SyncVarProcessor.cs     | 345 ++++++------------
 .../Processors/SyncVars/FoundSyncVar.cs       |  16 +
 Assets/Mirage/Weaver/TypeExtensions.cs        |  18 +-
 Assets/Mirage/Weaver/WeaverExceptions.cs      |   9 +-
 Assets/Tests/Weaver/SyncVarTests.cs           |  14 +-
 13 files changed, 546 insertions(+), 252 deletions(-)
 create mode 100644 Assets/Mirage/Weaver/Processors/NetworkBehaviour.meta
 create mode 100644 Assets/Mirage/Weaver/Processors/NetworkBehaviour/DeserializeHelper.cs
 create mode 100644 Assets/Mirage/Weaver/Processors/NetworkBehaviour/DeserializeHelper.cs.meta
 create mode 100644 Assets/Mirage/Weaver/Processors/NetworkBehaviour/FoundNetworkBehaviour.cs
 create mode 100644 Assets/Mirage/Weaver/Processors/NetworkBehaviour/FoundNetworkBehaviour.cs.meta
 create mode 100644 Assets/Mirage/Weaver/Processors/NetworkBehaviour/SerializeHelper.cs
 create mode 100644 Assets/Mirage/Weaver/Processors/NetworkBehaviour/SerializeHelper.cs.meta

diff --git a/Assets/Mirage/Weaver/Processors/NetworkBehaviour.meta b/Assets/Mirage/Weaver/Processors/NetworkBehaviour.meta
new file mode 100644
index 00000000000..600102843d7
--- /dev/null
+++ b/Assets/Mirage/Weaver/Processors/NetworkBehaviour.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: ae3cf709fa55c2445953a3a381a3c1fd
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Weaver/Processors/NetworkBehaviour/DeserializeHelper.cs b/Assets/Mirage/Weaver/Processors/NetworkBehaviour/DeserializeHelper.cs
new file mode 100644
index 00000000000..ff4ed7005c6
--- /dev/null
+++ b/Assets/Mirage/Weaver/Processors/NetworkBehaviour/DeserializeHelper.cs
@@ -0,0 +1,122 @@
+using System;
+using Mirage.Serialization;
+using Mirage.Weaver.SyncVars;
+using Mono.Cecil;
+using Mono.Cecil.Cil;
+using MethodAttributes = Mono.Cecil.MethodAttributes;
+
+namespace Mirage.Weaver.NetworkBehaviours
+{
+    internal class DeserializeHelper
+    {
+        public const string MethodName = nameof(NetworkBehaviour.DeserializeSyncVars);
+
+        readonly ModuleDefinition module;
+        readonly FoundNetworkBehaviour behaviour;
+
+        ILProcessor worker;
+
+        public MethodDefinition Method { get; private set; }
+        public ParameterDefinition ReaderParameter { get; private set; }
+        public ParameterDefinition InitializeParameter { get; private set; }
+        /// <summary>
+        /// IMPORTANT: this mask is only for this NB, it is not shifted based on base class
+        /// </summary>
+        public VariableDefinition DirtyBitsLocal { get; private set; }
+
+        public DeserializeHelper(ModuleDefinition module, FoundNetworkBehaviour behaviour)
+        {
+            this.module = module;
+            this.behaviour = behaviour;
+        }
+
+        /// <summary>
+        /// Adds Serialize method to current type
+        /// </summary>
+        /// <returns></returns>
+        public ILProcessor AddMethod()
+        {
+            Method = behaviour.TypeDefinition.AddMethod(MethodName,
+                    MethodAttributes.Public | MethodAttributes.Virtual | MethodAttributes.HideBySig);
+
+            ReaderParameter = Method.AddParam<NetworkReader>("reader");
+            InitializeParameter = Method.AddParam<bool>("initialState");
+
+            Method.Body.InitLocals = true;
+            worker = Method.Body.GetILProcessor();
+            return worker;
+        }
+
+        public void AddLocals()
+        {
+            DirtyBitsLocal = Method.AddLocal<ulong>();
+        }
+
+        public void WriteBaseCall()
+        {
+            MethodReference baseDeserialize = behaviour.TypeDefinition.BaseType.GetMethodInBaseType(MethodName);
+            if (baseDeserialize != null)
+            {
+                // base
+                worker.Append(worker.Create(OpCodes.Ldarg_0));
+                // reader
+                worker.Append(worker.Create(OpCodes.Ldarg, ReaderParameter));
+                // initialState
+                worker.Append(worker.Create(OpCodes.Ldarg, InitializeParameter));
+                worker.Append(worker.Create(OpCodes.Call, module.ImportReference(baseDeserialize)));
+            }
+        }
+
+        public void WriteIfInitial(Action body)
+        {
+            // Generates: if (initial)
+            Instruction initialStateLabel = worker.Create(OpCodes.Nop);
+
+            worker.Append(worker.Create(OpCodes.Ldarg, InitializeParameter));
+            worker.Append(worker.Create(OpCodes.Brfalse, initialStateLabel));
+
+            body.Invoke();
+
+            worker.Append(worker.Create(OpCodes.Ret));
+
+            // Generates: end if (initial)
+            worker.Append(initialStateLabel);
+        }
+
+        /// <summary>
+        /// Writes Reads dirty bit mask for this NB,
+        /// <para>Shifts by number of syncvars in base class, then writes number of bits in this class</para>
+        /// </summary>
+        public void ReadDirtyBitMask()
+        {
+            MethodReference readBitsMethod = module.ImportReference(ReaderParameter.ParameterType.Resolve().GetMethod(nameof(NetworkReader.Read)));
+
+            // Generates: reader.Read(n)
+            // n is syncvars in this
+
+            // get dirty bits
+            worker.Append(worker.Create(OpCodes.Ldarg, ReaderParameter));
+            worker.Append(worker.Create(OpCodes.Ldc_I4, behaviour.SyncVars.Count));
+            worker.Append(worker.Create(OpCodes.Call, readBitsMethod));
+            worker.Append(worker.Create(OpCodes.Stloc, DirtyBitsLocal));
+        }
+
+        internal void WriteIfSyncVarDirty(FoundSyncVar syncVar, Action body)
+        {
+            Instruction endIf = worker.Create(OpCodes.Nop);
+
+            // we dont shift read bits, so we have to shift dirty bit here
+            long syncVarIndex = syncVar.DirtyBit >> behaviour.SyncVarInBase;
+
+            // check if dirty bit is set
+            worker.Append(worker.Create(OpCodes.Ldloc, DirtyBitsLocal));
+            worker.Append(worker.Create(OpCodes.Ldc_I8, syncVarIndex));
+            worker.Append(worker.Create(OpCodes.And));
+            worker.Append(worker.Create(OpCodes.Brfalse, endIf));
+
+            body.Invoke();
+
+            worker.Append(endIf);
+        }
+    }
+}
diff --git a/Assets/Mirage/Weaver/Processors/NetworkBehaviour/DeserializeHelper.cs.meta b/Assets/Mirage/Weaver/Processors/NetworkBehaviour/DeserializeHelper.cs.meta
new file mode 100644
index 00000000000..bfc0a98329f
--- /dev/null
+++ b/Assets/Mirage/Weaver/Processors/NetworkBehaviour/DeserializeHelper.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 1325b6dd2d001bf4191e9e186f0366c1
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Weaver/Processors/NetworkBehaviour/FoundNetworkBehaviour.cs b/Assets/Mirage/Weaver/Processors/NetworkBehaviour/FoundNetworkBehaviour.cs
new file mode 100644
index 00000000000..b828b5741dd
--- /dev/null
+++ b/Assets/Mirage/Weaver/Processors/NetworkBehaviour/FoundNetworkBehaviour.cs
@@ -0,0 +1,56 @@
+using System.Collections.Generic;
+using Mirage.Weaver.SyncVars;
+using Mono.Cecil;
+
+namespace Mirage.Weaver.NetworkBehaviours
+{
+    internal class FoundNetworkBehaviour
+    {
+        // ulong = 64 bytes
+        const int SyncVarLimit = 64;
+        const string SyncVarCountField = "SYNC_VAR_COUNT";
+
+        public readonly TypeDefinition TypeDefinition;
+
+        public FoundNetworkBehaviour(TypeDefinition td)
+        {
+            TypeDefinition = td;
+        }
+
+        public int SyncVarInBase { get; private set; }
+        public List<FoundSyncVar> SyncVars { get; private set; } = new List<FoundSyncVar>();
+
+        public void GetSyncVarCountFromBase()
+        {
+            SyncVarInBase = TypeDefinition.BaseType.Resolve().GetConst<int>(SyncVarCountField);
+        }
+
+        public FoundSyncVar AddSyncVar(FieldDefinition fd)
+        {
+            int dirtyIndex = SyncVarInBase + SyncVars.Count;
+            var syncVar = new FoundSyncVar(fd, dirtyIndex);
+            SyncVars.Add(syncVar);
+            return syncVar;
+        }
+
+        public void SetSyncVarCount()
+        {
+            int totalSyncVars = SyncVarInBase + SyncVars.Count;
+
+            if (totalSyncVars >= SyncVarLimit)
+            {
+                throw new NetworkBehaviourException($"{TypeDefinition.Name} has too many SyncVars. Consider refactoring your class into multiple components", TypeDefinition);
+            }
+            TypeDefinition.SetConst(SyncVarCountField, totalSyncVars);
+        }
+
+        public bool HasManualSerializeOverride()
+        {
+            return TypeDefinition.GetMethod(SerializeHelper.MethodName) != null;
+        }
+        public bool HasManualDeserializeOverride()
+        {
+            return TypeDefinition.GetMethod(DeserializeHelper.MethodName) != null;
+        }
+    }
+}
diff --git a/Assets/Mirage/Weaver/Processors/NetworkBehaviour/FoundNetworkBehaviour.cs.meta b/Assets/Mirage/Weaver/Processors/NetworkBehaviour/FoundNetworkBehaviour.cs.meta
new file mode 100644
index 00000000000..19ad898d748
--- /dev/null
+++ b/Assets/Mirage/Weaver/Processors/NetworkBehaviour/FoundNetworkBehaviour.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 7e450365ac1e4684294241f6f6cb493b
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Weaver/Processors/NetworkBehaviour/SerializeHelper.cs b/Assets/Mirage/Weaver/Processors/NetworkBehaviour/SerializeHelper.cs
new file mode 100644
index 00000000000..3a6644ec4fd
--- /dev/null
+++ b/Assets/Mirage/Weaver/Processors/NetworkBehaviour/SerializeHelper.cs
@@ -0,0 +1,166 @@
+using System;
+using Mirage.Serialization;
+using Mirage.Weaver.SyncVars;
+using Mono.Cecil;
+using Mono.Cecil.Cil;
+using MethodAttributes = Mono.Cecil.MethodAttributes;
+
+namespace Mirage.Weaver.NetworkBehaviours
+{
+    internal class SerializeHelper
+    {
+        public const string MethodName = nameof(NetworkBehaviour.SerializeSyncVars);
+
+        readonly ModuleDefinition module;
+        readonly FoundNetworkBehaviour behaviour;
+
+        ILProcessor worker;
+
+        public MethodDefinition Method { get; private set; }
+        public ParameterDefinition WriterParameter { get; private set; }
+        public ParameterDefinition InitializeParameter { get; private set; }
+        public VariableDefinition DirtyLocal { get; private set; }
+        public VariableDefinition DirtyBitsLocal { get; private set; }
+
+        public SerializeHelper(ModuleDefinition module, FoundNetworkBehaviour behaviour)
+        {
+            this.module = module;
+            this.behaviour = behaviour;
+        }
+
+        /// <summary>
+        /// Adds Serialize method to current type
+        /// </summary>
+        /// <returns></returns>
+        public ILProcessor AddMethod()
+        {
+            Method = behaviour.TypeDefinition.AddMethod(MethodName,
+                    MethodAttributes.Public | MethodAttributes.Virtual | MethodAttributes.HideBySig,
+                    module.ImportReference<bool>());
+
+            WriterParameter = Method.AddParam<NetworkWriter>("writer");
+            InitializeParameter = Method.AddParam<bool>("initialize");
+            Method.Body.InitLocals = true;
+            worker = Method.Body.GetILProcessor();
+            return worker;
+        }
+
+        public void AddLocals()
+        {
+            DirtyLocal = Method.AddLocal<bool>();
+            DirtyBitsLocal = Method.AddLocal<ulong>();
+
+            // store dirty bit in local variable to avoid calling property multiple times
+            worker.Append(worker.Create(OpCodes.Ldarg_0));
+            worker.Append(worker.Create(OpCodes.Call, (NetworkBehaviour nb) => nb.SyncVarDirtyBits));
+            worker.Append(worker.Create(OpCodes.Stloc, DirtyBitsLocal));
+        }
+
+        public void WriteBaseCall()
+        {
+            // dirty = base.Serialize(...)
+
+            MethodReference baseSerialize = behaviour.TypeDefinition.BaseType.GetMethodInBaseType(MethodName);
+            if (baseSerialize != null)
+            {
+                // base
+                worker.Append(worker.Create(OpCodes.Ldarg_0));
+                // writer
+                worker.Append(worker.Create(OpCodes.Ldarg, WriterParameter));
+                // inital?
+                worker.Append(worker.Create(OpCodes.Ldarg, InitializeParameter));
+                worker.Append(worker.Create(OpCodes.Call, module.ImportReference(baseSerialize)));
+                // store to variable
+                worker.Append(worker.Create(OpCodes.Stloc, DirtyLocal));
+            }
+        }
+
+        public void WriteIfInitial(Action Body)
+        {
+            // Generates: if (initial)
+            Instruction endIfLabel = worker.Create(OpCodes.Nop);
+            // initial
+            worker.Append(worker.Create(OpCodes.Ldarg, InitializeParameter));
+            worker.Append(worker.Create(OpCodes.Brfalse, endIfLabel));
+
+            // body
+            Body.Invoke();
+            // always return true if initial
+
+            // Generates: return true
+            worker.Append(worker.Create(OpCodes.Ldc_I4_1));
+            worker.Append(worker.Create(OpCodes.Ret));
+
+            // Generates: end if (initial)
+            worker.Append(endIfLabel);
+        }
+
+        /// <summary>
+        /// Writes dirty bit mask for this NB,
+        /// <para>Shifts by number of syncvars in base class, then writes number of bits in this class</para>
+        /// </summary>
+        public void WriteDirtyBitMask()
+        {
+            MethodReference writeBitsMethod = module.ImportReference(WriterParameter.ParameterType.Resolve().GetMethod(nameof(NetworkWriter.Write)));
+
+            // Generates: writer.Write(dirtyBits >> b, n)
+            // where b is syncvars in base, n is syncvars in this
+
+            // load writer
+            worker.Append(worker.Create(OpCodes.Ldarg, WriterParameter));
+            // load dirty bits
+            worker.Append(worker.Create(OpCodes.Ldloc, DirtyBitsLocal));
+
+            // shift if there are syncvars in base class
+            if (behaviour.SyncVarInBase > 0)
+            {
+                // load inBaseCount
+                worker.Append(worker.Create(OpCodes.Ldc_I4, behaviour.SyncVarInBase));
+                // right shift, dirtyBits >> inBaseCount
+                worker.Append(worker.Create(OpCodes.Shr));
+            }
+            // load syncVarCount
+            worker.Append(worker.Create(OpCodes.Ldc_I4, behaviour.SyncVars.Count));
+            // call Write
+            worker.Append(worker.Create(OpCodes.Call, writeBitsMethod));
+        }
+
+
+        /// <summary>
+        /// Generates: if ((dirtyBits & 1uL) != 0uL)
+        /// <para>where 1uL is the syncvar's dirty bit</para>
+        /// </summary>
+        /// <param name="syncvar"></param>
+        /// <param name="falseLabel"></param>
+        public void WriteIfSyncVarDirty(FoundSyncVar syncvar, Action Body)
+        {
+            Instruction endIfLabel = worker.Create(OpCodes.Nop);
+            // load dirtyBit
+            // load syncvarIndex
+            // AND operation
+
+            // if zero, jump to label
+
+            worker.Append(worker.Create(OpCodes.Ldloc, DirtyBitsLocal));
+            worker.Append(worker.Create(OpCodes.Ldc_I8, syncvar.DirtyBit));
+            worker.Append(worker.Create(OpCodes.And));
+            worker.Append(worker.Create(OpCodes.Brfalse, endIfLabel));
+
+            Body.Invoke();
+
+            // say that this NB is dirty
+            worker.Append(worker.Create(OpCodes.Ldc_I4_1));
+            // set dirtyLocal to true
+            worker.Append(worker.Create(OpCodes.Stloc, DirtyLocal));
+
+            worker.Append(endIfLabel);
+        }
+
+
+        public void WriteReturnDirty()
+        {
+            worker.Append(worker.Create(OpCodes.Ldloc, DirtyLocal));
+            worker.Append(worker.Create(OpCodes.Ret));
+        }
+    }
+}
diff --git a/Assets/Mirage/Weaver/Processors/NetworkBehaviour/SerializeHelper.cs.meta b/Assets/Mirage/Weaver/Processors/NetworkBehaviour/SerializeHelper.cs.meta
new file mode 100644
index 00000000000..3e104b0526b
--- /dev/null
+++ b/Assets/Mirage/Weaver/Processors/NetworkBehaviour/SerializeHelper.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 325f0ad0f149d7d4181e93c1bfa89ac5
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Weaver/Processors/NetworkBehaviourProcessor.cs b/Assets/Mirage/Weaver/Processors/NetworkBehaviourProcessor.cs
index 50e64d65171..dfc20f5b6bc 100644
--- a/Assets/Mirage/Weaver/Processors/NetworkBehaviourProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/NetworkBehaviourProcessor.cs
@@ -31,7 +31,7 @@ public NetworkBehaviourProcessor(TypeDefinition td, Readers readers, Writers wri
             this.logger = logger;
             serverRpcProcessor = new ServerRpcProcessor(netBehaviourSubclass.Module, readers, writers, logger);
             clientRpcProcessor = new ClientRpcProcessor(netBehaviourSubclass.Module, readers, writers, logger);
-            syncVarProcessor = new SyncVarProcessor(netBehaviourSubclass.Module, readers, writers, propertySiteProcessor, logger);
+            syncVarProcessor = new SyncVarProcessor(netBehaviourSubclass.Module, readers, writers, propertySiteProcessor);
             syncObjectProcessor = new SyncObjectProcessor(readers, writers, logger);
         }
 
@@ -48,7 +48,14 @@ public bool Process()
             Weaver.DebugLog(netBehaviourSubclass, "Process Start");
             MarkAsProcessed(netBehaviourSubclass);
 
-            syncVarProcessor.ProcessSyncVars(netBehaviourSubclass);
+            try
+            {
+                syncVarProcessor.ProcessSyncVars(netBehaviourSubclass, logger);
+            }
+            catch (NetworkBehaviourException e)
+            {
+                logger.Error(e);
+            }
 
             syncObjectProcessor.ProcessSyncObjects(netBehaviourSubclass);
 
diff --git a/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs b/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
index 3abe76b15f4..463225bc141 100644
--- a/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
@@ -1,6 +1,5 @@
 using System;
-using System.Collections.Generic;
-using Mirage.Serialization;
+using Mirage.Weaver.NetworkBehaviours;
 using Mirage.Weaver.SyncVars;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
@@ -15,60 +14,53 @@ namespace Mirage.Weaver
     /// </summary>
     public class SyncVarProcessor
     {
-        private readonly List<FoundSyncVar> syncVars = new List<FoundSyncVar>();
-
         private readonly ModuleDefinition module;
         private readonly Readers readers;
         private readonly Writers writers;
         private readonly PropertySiteProcessor propertySiteProcessor;
-        private readonly IWeaverLogger logger;
-
-        // ulong = 64 bytes
-        const int SyncVarLimit = 64;
-        private const string SyncVarCountField = "SYNC_VAR_COUNT";
 
+        private FoundNetworkBehaviour behaviour;
 
-        public SyncVarProcessor(ModuleDefinition module, Readers readers, Writers writers, PropertySiteProcessor propertySiteProcessor, IWeaverLogger logger)
+        public SyncVarProcessor(ModuleDefinition module, Readers readers, Writers writers, PropertySiteProcessor propertySiteProcessor)
         {
             this.module = module;
             this.readers = readers;
             this.writers = writers;
             this.propertySiteProcessor = propertySiteProcessor;
-            this.logger = logger;
         }
 
-        public void ProcessSyncVars(TypeDefinition td)
+        public void ProcessSyncVars(TypeDefinition td, IWeaverLogger logger)
         {
+            behaviour = new FoundNetworkBehaviour(td);
             // 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
 
             // get numbers of syncvars in parent class, it will be added to syncvars in this class for total
-            int syncVarCount = td.BaseType.Resolve().GetConst<int>(SyncVarCountField);
+            behaviour.GetSyncVarCountFromBase();
 
             // find syncvars
             foreach (FieldDefinition fd in td.Fields)
             {
-                if (IsValidSyncVar(fd))
+                // try/catch for each field, and log once
+                // we dont want to spam multiple logs for a single field
+                try
                 {
-                    syncVars.Add(new FoundSyncVar(fd, syncVarCount));
-                    syncVarCount++;
+                    if (IsValidSyncVar(fd))
+                    {
+                        FoundSyncVar syncVar = behaviour.AddSyncVar(fd);
+                        ProcessSyncVar(syncVar);
+                    }
+                }
+                catch (SyncVarException e)
+                {
+                    logger.Error(e);
                 }
             }
 
-            if (syncVarCount >= SyncVarLimit)
-            {
-                logger.Error($"{td.Name} has too many SyncVars. Consider refactoring your class into multiple components", td);
-            }
-
-            td.SetConst(SyncVarCountField, syncVarCount);
+            behaviour.SetSyncVarCount();
 
-            foreach (FoundSyncVar syncVar in syncVars)
-            {
-                ProcessSyncVar(syncVar);
-            }
-
-            GenerateSerialization(td);
-            GenerateDeSerialization(td);
+            GenerateSerialization();
+            GenerateDeserialization();
         }
 
         bool IsValidSyncVar(FieldDefinition field)
@@ -80,27 +72,23 @@ bool IsValidSyncVar(FieldDefinition field)
 
             if (field.FieldType.IsGenericParameter)
             {
-                logger.Error($"{field.Name} cannot be synced since it's a generic parameter", field);
-                return false;
+                throw new SyncVarException($"{field.Name} cannot be synced since it's a generic parameter", field);
             }
 
             if ((field.Attributes & FieldAttributes.Static) != 0)
             {
-                logger.Error($"{field.Name} cannot be static", field);
-                return false;
+                throw new SyncVarException($"{field.Name} cannot be static", field);
             }
 
             if (field.FieldType.IsArray)
             {
                 // todo should arrays really be blocked?
-                logger.Error($"{field.Name} has invalid type. Use SyncLists instead of arrays", field);
-                return false;
+                throw new SyncVarException($"{field.Name} has invalid type. Use SyncLists instead of arrays", field);
             }
 
             if (SyncObjectProcessor.ImplementsSyncObject(field.FieldType))
             {
-                logger.Warning($"{field.Name} has [SyncVar] attribute. ISyncObject should not be marked with SyncVar", field);
-                return false;
+                throw new SyncVarException($"{field.Name} has [SyncVar] attribute. ISyncObject should not be marked with SyncVar", field);
             }
 
             return true;
@@ -136,15 +124,8 @@ void ProcessSyncVar(FoundSyncVar syncVar)
                 propertySiteProcessor.Getters[fd] = get;
             }
 
-            try
-            {
-                syncVar.ProcessAttributes();
-            }
-            catch (WeaverException e)
-            {
-                // todo what do we do if syncvar has errors?
-                logger.Error(e);
-            }
+            syncVar.ProcessAttributes();
+            syncVar.FindSerializeFunctions(writers, readers);
         }
 
         MethodDefinition GenerateSyncVarGetter(FoundSyncVar syncVar)
@@ -203,12 +184,12 @@ MethodDefinition GenerateSyncVarSetter(FoundSyncVar syncVar)
 
             worker.Append(worker.Create(OpCodes.Brtrue, endOfMethod));
 
-            // T oldValue = value;
+            // T oldValue = value
             VariableDefinition oldValue = set.AddLocal(originalType);
             WriteLoadField(worker, syncVar);
             worker.Append(worker.Create(OpCodes.Stloc, oldValue));
 
-            // fieldValue = value;
+            // fieldValue = value
             WriteStoreField(worker, valueParam, syncVar);
 
             // this.SetDirtyBit(dirtyBit)
@@ -228,17 +209,17 @@ MethodDefinition GenerateSyncVarSetter(FoundSyncVar syncVar)
                 worker.Append(worker.Create<NetworkBehaviour>(OpCodes.Call, nb => nb.GetSyncVarHookGuard(default)));
                 worker.Append(worker.Create(OpCodes.Brtrue, label));
 
-                // setSyncVarHookGuard(dirtyBit, true);
+                // setSyncVarHookGuard(dirtyBit, true)
                 worker.Append(worker.Create(OpCodes.Ldarg_0));
                 worker.Append(worker.Create(OpCodes.Ldc_I8, syncVar.DirtyBit));
                 worker.Append(worker.Create(OpCodes.Ldc_I4_1));
                 worker.Append(worker.Create<NetworkBehaviour>(OpCodes.Call, nb => nb.SetSyncVarHookGuard(default, default)));
 
                 // call hook (oldValue, newValue)
-                // Generates: OnValueChanged(oldValue, value);
+                // Generates: OnValueChanged(oldValue, value)
                 WriteCallHookMethodUsingArgument(worker, syncVar.HookMethod, oldValue);
 
-                // setSyncVarHookGuard(dirtyBit, false);
+                // setSyncVarHookGuard(dirtyBit, false)
                 worker.Append(worker.Create(OpCodes.Ldarg_0));
                 worker.Append(worker.Create(OpCodes.Ldc_I8, syncVar.DirtyBit));
                 worker.Append(worker.Create(OpCodes.Ldc_I4_0));
@@ -260,7 +241,7 @@ MethodDefinition GenerateSyncVarSetter(FoundSyncVar syncVar)
         /// </summary>
         /// <param name="worker"></param>
         /// <param name="syncVar"></param>
-        private void WriteLoadField(ILProcessor worker, FoundSyncVar syncVar)
+        void WriteLoadField(ILProcessor worker, FoundSyncVar syncVar)
         {
             FieldDefinition fd = syncVar.FieldDefinition;
             TypeReference originalType = syncVar.OriginalType;
@@ -295,7 +276,7 @@ private void WriteLoadField(ILProcessor worker, FoundSyncVar syncVar)
         /// <param name="worker"></param>
         /// <param name="valueParam"></param>
         /// <param name="syncVar"></param>
-        private void WriteStoreField(ILProcessor worker, ParameterDefinition valueParam, FoundSyncVar syncVar)
+        void WriteStoreField(ILProcessor worker, ParameterDefinition valueParam, FoundSyncVar syncVar)
         {
             FieldDefinition fd = syncVar.FieldDefinition;
 
@@ -395,207 +376,104 @@ void WriteEndFunctionCall()
             }
         }
 
-        void GenerateSerialization(TypeDefinition netBehaviourSubclass)
+        void GenerateSerialization()
         {
-            Weaver.DebugLog(netBehaviourSubclass, "  GenerateSerialization");
+            Weaver.DebugLog(behaviour.TypeDefinition, "  GenerateSerialization");
 
-            const string SerializeMethodName = nameof(NetworkBehaviour.SerializeSyncVars);
-            if (netBehaviourSubclass.GetMethod(SerializeMethodName) != null)
+            // Dont create method if users has manually overridden it
+            if (behaviour.HasManualSerializeOverride())
                 return;
 
-            if (syncVars.Count == 0)
-            {
-                // no synvars,  no need for custom OnSerialize
+            // dont create if there are no syncvars
+            if (behaviour.SyncVars.Count == 0)
                 return;
-            }
-
-            MethodDefinition serialize = netBehaviourSubclass.AddMethod(SerializeMethodName,
-                    MethodAttributes.Public | MethodAttributes.Virtual | MethodAttributes.HideBySig,
-                    module.ImportReference<bool>());
 
-            ParameterDefinition writerParameter = serialize.AddParam<NetworkWriter>("writer");
-            ParameterDefinition initializeParameter = serialize.AddParam<bool>("initialize");
-            ILProcessor worker = serialize.Body.GetILProcessor();
+            var helper = new SerializeHelper(module, behaviour);
+            ILProcessor worker = helper.AddMethod();
 
-            serialize.Body.InitLocals = true;
+            helper.AddLocals();
+            helper.WriteBaseCall();
 
-            // loc_0,  this local variable is to determine if any variable was dirty
-            VariableDefinition dirtyLocal = serialize.AddLocal<bool>();
-
-            MethodReference baseSerialize = netBehaviourSubclass.BaseType.GetMethodInBaseType(SerializeMethodName);
-            if (baseSerialize != null)
-            {
-                // base
-                worker.Append(worker.Create(OpCodes.Ldarg_0));
-                // writer
-                worker.Append(worker.Create(OpCodes.Ldarg, writerParameter));
-                // forceAll
-                worker.Append(worker.Create(OpCodes.Ldarg, initializeParameter));
-                worker.Append(worker.Create(OpCodes.Call, module.ImportReference(baseSerialize)));
-                // set dirtyLocal to result of base.OnSerialize()
-                worker.Append(worker.Create(OpCodes.Stloc, dirtyLocal));
-            }
-
-            // Generates: if (forceAll);
-            Instruction initialStateLabel = worker.Create(OpCodes.Nop);
-            // forceAll
-            worker.Append(worker.Create(OpCodes.Ldarg, initializeParameter));
-            worker.Append(worker.Create(OpCodes.Brfalse, initialStateLabel));
-
-            foreach (FoundSyncVar syncVar in syncVars)
+            helper.WriteIfInitial(() =>
             {
-                WriteVariable(worker, writerParameter, syncVar.FieldDefinition);
-            }
-
-            // always return true if forceAll
-
-            // Generates: return true
-            worker.Append(worker.Create(OpCodes.Ldc_I4_1));
-            worker.Append(worker.Create(OpCodes.Ret));
-
-            // Generates: end if (forceAll);
-            worker.Append(initialStateLabel);
+                foreach (FoundSyncVar syncVar in behaviour.SyncVars)
+                {
+                    WriteVariable(worker, helper.WriterParameter, syncVar);
+                }
+            });
 
             // write dirty bits before the data fields
-            // Generates: writer.WritePackedUInt64 (base.get_syncVarDirtyBits ());
-            // writer
-            worker.Append(worker.Create(OpCodes.Ldarg, writerParameter));
-            // base
-            worker.Append(worker.Create(OpCodes.Ldarg_0));
-            worker.Append(worker.Create(OpCodes.Call, (NetworkBehaviour nb) => nb.SyncVarDirtyBits));
-            MethodReference writeUint64Func = writers.TryGetFunction<ulong>(null);
-            worker.Append(worker.Create(OpCodes.Call, writeUint64Func));
+            helper.WriteDirtyBitMask();
 
             // generate a writer call for any dirty variable in this class
 
             // start at number of syncvars in parent
-            int dirtyBit = netBehaviourSubclass.BaseType.Resolve().GetConst<int>(SyncVarCountField);
-            foreach (FoundSyncVar syncVar in syncVars)
+            foreach (FoundSyncVar syncVar in behaviour.SyncVars)
             {
-                Instruction varLabel = worker.Create(OpCodes.Nop);
-
-                // Generates: if ((base.get_syncVarDirtyBits() & 1uL) != 0uL)
-                // base
-                worker.Append(worker.Create(OpCodes.Ldarg_0));
-                worker.Append(worker.Create(OpCodes.Call, (NetworkBehaviour nb) => nb.SyncVarDirtyBits));
-                // 8 bytes = long
-                worker.Append(worker.Create(OpCodes.Ldc_I8, 1L << dirtyBit));
-                worker.Append(worker.Create(OpCodes.And));
-                worker.Append(worker.Create(OpCodes.Brfalse, varLabel));
-
-                // Generates a call to the writer for that field
-                WriteVariable(worker, writerParameter, syncVar.FieldDefinition);
-
-                // something was dirty
-                worker.Append(worker.Create(OpCodes.Ldc_I4_1));
-                // set dirtyLocal to true
-                worker.Append(worker.Create(OpCodes.Stloc, dirtyLocal));
-
-                worker.Append(varLabel);
-                dirtyBit += 1;
+                helper.WriteIfSyncVarDirty(syncVar, () =>
+                {
+                    // Generates a call to the writer for that field
+                    WriteVariable(worker, helper.WriterParameter, syncVar);
+                });
             }
 
             // generate: return dirtyLocal
-            worker.Append(worker.Create(OpCodes.Ldloc, dirtyLocal));
-            worker.Append(worker.Create(OpCodes.Ret));
+            helper.WriteReturnDirty();
         }
 
-        private void WriteVariable(ILProcessor worker, ParameterDefinition writerParameter, FieldDefinition syncVar)
+        static void WriteVariable(ILProcessor worker, ParameterDefinition writerParameter, FoundSyncVar syncVar)
         {
+            // if WriteFunction is null it means there was an error earlier, so we dont need to do anything here
+            if (syncVar.WriteFunction == null) { return; }
+
             // Generates a writer call for each sync variable
             // writer
             worker.Append(worker.Create(OpCodes.Ldarg, writerParameter));
             // this
             worker.Append(worker.Create(OpCodes.Ldarg_0));
-            worker.Append(worker.Create(OpCodes.Ldfld, syncVar.MakeHostGenericIfNeeded()));
-            MethodReference writeFunc = writers.TryGetFunction(syncVar.FieldType, null);
-            if (writeFunc != null)
-            {
-                worker.Append(worker.Create(OpCodes.Call, writeFunc));
-            }
-            else
-            {
-                logger.Error($"{syncVar.Name} has unsupported type. Use a supported Mirage type instead", syncVar);
-            }
+            worker.Append(worker.Create(OpCodes.Ldfld, syncVar.FieldDefinition.MakeHostGenericIfNeeded()));
+            worker.Append(worker.Create(OpCodes.Call, syncVar.WriteFunction));
         }
 
-        void GenerateDeSerialization(TypeDefinition netBehaviourSubclass)
+        void GenerateDeserialization()
         {
-            Weaver.DebugLog(netBehaviourSubclass, "  GenerateDeSerialization");
+            Weaver.DebugLog(behaviour.TypeDefinition, "  GenerateDeSerialization");
 
-            const string DeserializeMethodName = nameof(NetworkBehaviour.DeserializeSyncVars);
-            if (netBehaviourSubclass.GetMethod(DeserializeMethodName) != null)
+            // Dont create method if users has manually overridden it
+            if (behaviour.HasManualDeserializeOverride())
                 return;
 
-            if (syncVars.Count == 0)
-            {
-                // no synvars,  no need for custom OnDeserialize
+            // dont create if there are no syncvars
+            if (behaviour.SyncVars.Count == 0)
                 return;
-            }
-
-            MethodDefinition serialize = netBehaviourSubclass.AddMethod(DeserializeMethodName,
-                    MethodAttributes.Public | MethodAttributes.Virtual | MethodAttributes.HideBySig);
 
-            ParameterDefinition readerParam = serialize.AddParam<NetworkReader>("reader");
-            ParameterDefinition initializeParam = serialize.AddParam<bool>("initialState");
-            ILProcessor serWorker = serialize.Body.GetILProcessor();
-            // setup local for dirty bits
-            serialize.Body.InitLocals = true;
-            VariableDefinition dirtyBitsLocal = serialize.AddLocal<long>();
-
-            MethodReference baseDeserialize = netBehaviourSubclass.BaseType.GetMethodInBaseType(DeserializeMethodName);
-            if (baseDeserialize != null)
-            {
-                // base
-                serWorker.Append(serWorker.Create(OpCodes.Ldarg_0));
-                // reader
-                serWorker.Append(serWorker.Create(OpCodes.Ldarg, readerParam));
-                // initialState
-                serWorker.Append(serWorker.Create(OpCodes.Ldarg, initializeParam));
-                serWorker.Append(serWorker.Create(OpCodes.Call, module.ImportReference(baseDeserialize)));
-            }
 
-            // Generates: if (initialState);
-            Instruction initialStateLabel = serWorker.Create(OpCodes.Nop);
+            var helper = new DeserializeHelper(module, behaviour);
+            ILProcessor worker = helper.AddMethod();
 
-            serWorker.Append(serWorker.Create(OpCodes.Ldarg, initializeParam));
-            serWorker.Append(serWorker.Create(OpCodes.Brfalse, initialStateLabel));
+            helper.AddLocals();
+            helper.WriteBaseCall();
 
-            foreach (FoundSyncVar syncVar in syncVars)
+            helper.WriteIfInitial(() =>
             {
-                DeserializeField(serWorker, serialize, syncVar);
-            }
-
-            serWorker.Append(serWorker.Create(OpCodes.Ret));
-
-            // Generates: end if (initialState);
-            serWorker.Append(initialStateLabel);
+                foreach (FoundSyncVar syncVar in behaviour.SyncVars)
+                {
+                    DeserializeField(worker, helper.Method, syncVar);
+                }
+            });
 
-            // get dirty bits
-            serWorker.Append(serWorker.Create(OpCodes.Ldarg, readerParam));
-            serWorker.Append(serWorker.Create(OpCodes.Call, readers.TryGetFunction<ulong>(null)));
-            serWorker.Append(serWorker.Create(OpCodes.Stloc, dirtyBitsLocal));
+            helper.ReadDirtyBitMask();
 
             // conditionally read each syncvar
-            // start at number of syncvars in parent
-            int dirtyBit = netBehaviourSubclass.BaseType.Resolve().GetConst<int>(SyncVarCountField);
-            foreach (FoundSyncVar syncVar in syncVars)
+            foreach (FoundSyncVar syncVar in behaviour.SyncVars)
             {
-                Instruction varLabel = serWorker.Create(OpCodes.Nop);
-
-                // check if dirty bit is set
-                serWorker.Append(serWorker.Create(OpCodes.Ldloc, dirtyBitsLocal));
-                serWorker.Append(serWorker.Create(OpCodes.Ldc_I8, 1L << dirtyBit));
-                serWorker.Append(serWorker.Create(OpCodes.And));
-                serWorker.Append(serWorker.Create(OpCodes.Brfalse, varLabel));
-
-                DeserializeField(serWorker, serialize, syncVar);
-
-                serWorker.Append(varLabel);
-                dirtyBit += 1;
+                helper.WriteIfSyncVarDirty(syncVar, () =>
+                {
+                    DeserializeField(worker, helper.Method, syncVar);
+                });
             }
 
-            serWorker.Append(serWorker.Create(OpCodes.Ret));
+            worker.Append(worker.Create(OpCodes.Ret));
         }
 
         /// <summary>
@@ -606,33 +484,32 @@ void GenerateDeSerialization(TypeDefinition netBehaviourSubclass)
         /// <param name="deserialize"></param>
         /// <param name="initialState"></param>
         /// <param name="hookResult"></param>
-        void DeserializeField(ILProcessor worker, MethodDefinition deserialize, FoundSyncVar syncvar)
+        void DeserializeField(ILProcessor worker, MethodDefinition deserialize, FoundSyncVar syncVar)
         {
-            FieldDefinition fd = syncvar.FieldDefinition;
-            TypeReference originalType = syncvar.OriginalType;
+            // if ReadFunction is null it means there was an error earlier, so we dont need to do anything here
+            if (syncVar.ReadFunction == null) { return; }
+
+            FieldDefinition fd = syncVar.FieldDefinition;
+            TypeReference originalType = syncVar.OriginalType;
 
             /*
              Generates code like:
                 // for hook
-                int oldValue = a;
-                Networka = reader.ReadPackedInt32();
+                int oldValue = a
+                Networka = reader.ReadPackedInt32()
                 if (!SyncVarEqual(oldValue, ref a))
-                {
-                    OnSetA(oldValue, Networka);
-                }
+                    OnSetA(oldValue, Networka)
              */
-            MethodReference readFunc = readers.TryGetFunction(fd.FieldType, null);
-            if (readFunc == null)
-            {
-                logger.Error($"{fd.Name} has unsupported type. Use a supported Mirage type instead", fd);
-                return;
-            }
 
-            // T oldValue = value;
-            VariableDefinition oldValue = deserialize.AddLocal(originalType);
-            WriteLoadField(worker, syncvar);
+            // T oldValue = value
+            VariableDefinition oldValue = null;
+            if (syncVar.HasHookMethod)
+            {
+                oldValue = deserialize.AddLocal(originalType);
+                WriteLoadField(worker, syncVar);
 
-            worker.Append(worker.Create(OpCodes.Stloc, oldValue));
+                worker.Append(worker.Create(OpCodes.Stloc, oldValue));
+            }
 
             // read value and store in syncvar BEFORE calling the hook
             // -> this makes way more sense. by definition, the hook is
@@ -648,11 +525,11 @@ void DeserializeField(ILProcessor worker, MethodDefinition deserialize, FoundSyn
             // reader. for 'reader.Read()' below
             worker.Append(worker.Create(OpCodes.Ldarg_1));
             // reader.Read()
-            worker.Append(worker.Create(OpCodes.Call, readFunc));
+            worker.Append(worker.Create(OpCodes.Call, syncVar.ReadFunction));
             // syncvar
             worker.Append(worker.Create(OpCodes.Stfld, fd.MakeHostGenericIfNeeded()));
 
-            if (syncvar.HasHookMethod)
+            if (syncVar.HasHookMethod)
             {
                 // call hook
                 // but only if SyncVar changed. otherwise a client would
@@ -660,7 +537,7 @@ void DeserializeField(ILProcessor worker, MethodDefinition deserialize, FoundSyn
                 // didn't change from the default values on the client.
                 // see also: https://github.com/vis2k/Mirror/issues/1278
 
-                // Generates: if (!SyncVarEqual);
+                // Generates: if (!SyncVarEqual)
                 Instruction syncVarEqualLabel = worker.Create(OpCodes.Nop);
 
                 // 'this.' for 'this.SyncVarEqual'
@@ -668,7 +545,7 @@ void DeserializeField(ILProcessor worker, MethodDefinition deserialize, FoundSyn
                 // 'oldValue'
                 worker.Append(worker.Create(OpCodes.Ldloc, oldValue));
                 // 'newValue'
-                WriteLoadField(worker, syncvar);
+                WriteLoadField(worker, syncVar);
                 // call the function
                 MethodReference syncVarEqual = module.ImportReference<NetworkBehaviour>(nb => nb.SyncVarEqual<object>(default, default));
                 var syncVarEqualGm = new GenericInstanceMethod(syncVarEqual.GetElementMethod());
@@ -677,10 +554,10 @@ void DeserializeField(ILProcessor worker, MethodDefinition deserialize, FoundSyn
                 worker.Append(worker.Create(OpCodes.Brtrue, syncVarEqualLabel));
 
                 // call the hook
-                // Generates: OnValueChanged(oldValue, this.syncVar);
-                WriteCallHookMethodUsingField(worker, syncvar.HookMethod, oldValue, syncvar);
+                // Generates: OnValueChanged(oldValue, this.syncVar)
+                WriteCallHookMethodUsingField(worker, syncVar.HookMethod, oldValue, syncVar);
 
-                // Generates: end if (!SyncVarEqual);
+                // Generates: end if (!SyncVarEqual)
                 worker.Append(syncVarEqualLabel);
             }
         }
diff --git a/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs b/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs
index c43b561795e..c029fc3ea16 100644
--- a/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs
@@ -22,6 +22,8 @@ public FoundSyncVar(FieldDefinition fieldDefinition, int dirtyIndex)
 
         public bool HasHookMethod { get; private set; }
         public MethodDefinition HookMethod { get; private set; }
+        public MethodReference WriteFunction { get; private set; }
+        public MethodReference ReadFunction { get; private set; }
 
         /// <summary>
         /// Changing the type of the field to the wrapper type, if one exists
@@ -74,5 +76,19 @@ public void ProcessAttributes()
             HookMethod = HookMethodFinder.GetHookMethod(FieldDefinition, OriginalType);
             HasHookMethod = HookMethod != null;
         }
+
+        public void FindSerializeFunctions(Writers writers, Readers readers)
+        {
+            try
+            {
+                WriteFunction = writers.GetFunction_Thorws(FieldDefinition.FieldType);
+                ReadFunction = readers.GetFunction_Thorws(FieldDefinition.FieldType);
+            }
+            catch (SerializeFunctionException e)
+            {
+                throw new SyncVarException($"{FieldDefinition.Name} is an unsupported type. {e.Message}", FieldDefinition);
+            }
+        }
+
     }
 }
diff --git a/Assets/Mirage/Weaver/TypeExtensions.cs b/Assets/Mirage/Weaver/TypeExtensions.cs
index 834b51ec0c7..729bacacc9b 100644
--- a/Assets/Mirage/Weaver/TypeExtensions.cs
+++ b/Assets/Mirage/Weaver/TypeExtensions.cs
@@ -23,10 +23,19 @@ public static List<MethodDefinition> GetMethods(this TypeDefinition td, string m
             return td.Methods.Where(method => method.Name == methodName).ToList();
         }
 
-        public static MethodReference GetMethodInBaseType(this TypeReference td, string methodName)
+        /// <summary>
+        /// Finds a method in base type
+        /// <para>
+        /// IMPORTANT: dont resolve <paramref name="typeReference"/> before calling this or methods can not be made into generic methods
+        /// </para>
+        /// </summary>
+        /// <param name="typeReference">Unresolved type reference, dont resolve if generic</param>
+        /// <param name="methodName"></param>
+        /// <returns></returns>
+        public static MethodReference GetMethodInBaseType(this TypeReference typeReference, string methodName)
         {
-            TypeDefinition typedef = td.Resolve();
-            TypeReference typeRef = td;
+            TypeDefinition typedef = typeReference.Resolve();
+            TypeReference typeRef = typeReference;
             while (typedef != null)
             {
                 foreach (MethodDefinition md in typedef.Methods)
@@ -36,7 +45,8 @@ public static MethodReference GetMethodInBaseType(this TypeReference td, string
                         MethodReference method = md;
                         if (typeRef.IsGenericInstance)
                         {
-                            var baseTypeInstance = (GenericInstanceType)td;
+                            // use in reference here to make method generic
+                            var baseTypeInstance = (GenericInstanceType)typeReference;
                             method = method.MakeHostInstanceGeneric(baseTypeInstance);
                         }
 
diff --git a/Assets/Mirage/Weaver/WeaverExceptions.cs b/Assets/Mirage/Weaver/WeaverExceptions.cs
index 6533a46d427..46d6772c7c8 100644
--- a/Assets/Mirage/Weaver/WeaverExceptions.cs
+++ b/Assets/Mirage/Weaver/WeaverExceptions.cs
@@ -21,6 +21,11 @@ internal class SerializeFunctionException : WeaverException
         public SerializeFunctionException(string message, MemberReference memberReference) : base(message, memberReference, null) { }
     }
 
+    internal class NetworkBehaviourException : WeaverException
+    {
+        public NetworkBehaviourException(string message, TypeDefinition type) : base(message, type, null) { }
+    }
+
     internal class SyncVarException : WeaverException
     {
         public SyncVarException(string message, MemberReference memberReference) : base(message, memberReference, null) { }
@@ -30,8 +35,8 @@ internal class SyncVarException : WeaverException
 
 namespace Mirage.Weaver.SyncVars
 {
-    internal class HookMethodException : WeaverException
+    internal class HookMethodException : SyncVarException
     {
-        public HookMethodException(string message, MemberReference memberReference) : base(message, memberReference, null) { }
+        public HookMethodException(string message, MemberReference memberReference) : base(message, memberReference) { }
     }
 }
diff --git a/Assets/Tests/Weaver/SyncVarTests.cs b/Assets/Tests/Weaver/SyncVarTests.cs
index 9fdde4a7984..229dd535b1b 100644
--- a/Assets/Tests/Weaver/SyncVarTests.cs
+++ b/Assets/Tests/Weaver/SyncVarTests.cs
@@ -39,27 +39,21 @@ public void SyncVarsGenericField()
         [Test]
         public void SyncVarsGenericParam()
         {
-            HasError("Cannot generate write function for generic type MySyncVar`1. Use a supported type or provide a custom write function",
-                "SyncVarTests.SyncVarsGenericParam.SyncVarsGenericParam/MySyncVar`1<System.Int32>");
-            HasError("invalidVar has unsupported type. Use a supported Mirage type instead",
+            HasError("invalidVar is an unsupported type. Cannot generate write function for generic type MySyncVar`1. Use a supported type or provide a custom write function",
                 "SyncVarTests.SyncVarsGenericParam.SyncVarsGenericParam/MySyncVar`1<System.Int32> SyncVarTests.SyncVarsGenericParam.SyncVarsGenericParam::invalidVar");
         }
 
         [Test]
         public void SyncVarsInterface()
         {
-            HasError("Cannot generate write function for interface IMySyncVar. Use a supported type or provide a custom write function",
-                "SyncVarTests.SyncVarsInterface.SyncVarsInterface/IMySyncVar");
-            HasError("invalidVar has unsupported type. Use a supported Mirage type instead",
+            HasError("invalidVar is an unsupported type. Cannot generate write function for interface IMySyncVar. Use a supported type or provide a custom write function",
                 "SyncVarTests.SyncVarsInterface.SyncVarsInterface/IMySyncVar SyncVarTests.SyncVarsInterface.SyncVarsInterface::invalidVar");
         }
 
         [Test]
         public void SyncVarsUnityComponent()
         {
-            HasError("Cannot generate write function for component type TextMesh. Use a supported type or provide a custom write function",
-                "UnityEngine.TextMesh");
-            HasError("invalidVar has unsupported type. Use a supported Mirage type instead",
+            HasError("invalidVar is an unsupported type. Cannot generate write function for component type TextMesh. Use a supported type or provide a custom write function",
                 "UnityEngine.TextMesh SyncVarTests.SyncVarsUnityComponent.SyncVarsUnityComponent::invalidVar");
         }
 
@@ -73,7 +67,7 @@ public void SyncVarsCantBeArray()
         [Test]
         public void SyncVarsSyncList()
         {
-            HasWarning("syncints has [SyncVar] attribute. ISyncObject should not be marked with SyncVar",
+            HasError("syncints has [SyncVar] attribute. ISyncObject should not be marked with SyncVar",
                 "Mirage.Collections.SyncList`1<System.Int32> SyncVarTests.SyncVarsSyncList.SyncVarsSyncList::syncints");
         }
 

From 99c31c8df337c363a2b4a0be9843dcf8fe24913c Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Fri, 20 Aug 2021 22:12:03 +0100
Subject: [PATCH 127/166] fix: fixing log message for checking observers for
 connected player

---
 Assets/Mirage/Runtime/ServerObjectManager.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/Assets/Mirage/Runtime/ServerObjectManager.cs b/Assets/Mirage/Runtime/ServerObjectManager.cs
index 7405c2697b2..d48ff634fb2 100644
--- a/Assets/Mirage/Runtime/ServerObjectManager.cs
+++ b/Assets/Mirage/Runtime/ServerObjectManager.cs
@@ -218,9 +218,9 @@ public void ReplaceCharacter(INetworkPlayer player, NetworkIdentity identity, bo
 
         void SpawnObserversForConnection(INetworkPlayer player)
         {
-            if (logger.LogEnabled()) logger.Log("Spawning " + Server.World.SpawnedIdentities.Count + " objects for conn " + player);
+            if (logger.LogEnabled()) logger.Log($"Checking Observers on {Server.World.SpawnedIdentities.Count} objects for player: {player}");
 
-            if (!player.IsReady)
+            if (!player.SceneIsReady)
             {
                 // client needs to finish initializing before we can spawn objects
                 // otherwise it would not find them.
@@ -233,7 +233,7 @@ void SpawnObserversForConnection(INetworkPlayer player)
             {
                 if (identity.gameObject.activeSelf)
                 {
-                    if (logger.LogEnabled()) logger.Log("Sending spawn message for current server objects name='" + identity.name + "' netId=" + identity.NetId + " sceneId=" + identity.sceneId);
+                    if (logger.LogEnabled()) logger.Log($"Checking Observers on server objects name='{identity.name}' netId={identity.NetId} sceneId={identity.sceneId}");
 
                     bool visible = identity.OnCheckObserver(player);
                     if (visible)

From b090fa2f619ec87de4bc1534343e977247de12f5 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Sat, 21 Aug 2021 14:37:10 +0100
Subject: [PATCH 128/166] fix: fixing mistake in log change

---
 Assets/Mirage/Runtime/ServerObjectManager.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Assets/Mirage/Runtime/ServerObjectManager.cs b/Assets/Mirage/Runtime/ServerObjectManager.cs
index d48ff634fb2..046145a030e 100644
--- a/Assets/Mirage/Runtime/ServerObjectManager.cs
+++ b/Assets/Mirage/Runtime/ServerObjectManager.cs
@@ -220,7 +220,7 @@ void SpawnObserversForConnection(INetworkPlayer player)
         {
             if (logger.LogEnabled()) logger.Log($"Checking Observers on {Server.World.SpawnedIdentities.Count} objects for player: {player}");
 
-            if (!player.SceneIsReady)
+            if (!player.IsReady)
             {
                 // client needs to finish initializing before we can spawn objects
                 // otherwise it would not find them.

From 3daac58bbf2bed7a1e4ca5d42477293085ad9a6f Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Sat, 21 Aug 2021 13:54:46 +0000
Subject: [PATCH 129/166] chore(release): 101.4.2 [skip ci]

## [101.4.2](https://github.com/MirageNet/Mirage/compare/v101.4.1...v101.4.2) (2021-08-21)

### Bug Fixes

* fixing log message for checking observers for connected player ([99c31c8](https://github.com/MirageNet/Mirage/commit/99c31c8df337c363a2b4a0be9843dcf8fe24913c))
* fixing mistake in log change ([b090fa2](https://github.com/MirageNet/Mirage/commit/b090fa2f619ec87de4bc1534343e977247de12f5))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs              | 2 +-
 Assets/Mirage/CHANGELOG.md                                | 8 ++++++++
 Assets/Mirage/Components/AssemblyInfo.cs                  | 2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                     | 2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs         | 2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs                    | 2 +-
 .../Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs     | 2 +-
 Assets/Mirage/package.json                                | 2 +-
 8 files changed, 15 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index 0b0bfc4bd34..9cbf1dc037a 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.4.1")]
+[assembly: AssemblyVersion("101.4.2")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index 5d267cd9f17..e14cffe3300 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,11 @@
+## [101.4.2](https://github.com/MirageNet/Mirage/compare/v101.4.1...v101.4.2) (2021-08-21)
+
+
+### Bug Fixes
+
+* fixing log message for checking observers for connected player ([99c31c8](https://github.com/MirageNet/Mirage/commit/99c31c8df337c363a2b4a0be9843dcf8fe24913c))
+* fixing mistake in log change ([b090fa2](https://github.com/MirageNet/Mirage/commit/b090fa2f619ec87de4bc1534343e977247de12f5))
+
 ## [101.4.1](https://github.com/MirageNet/Mirage/compare/v101.4.0...v101.4.1) (2021-08-19)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index 95803e3bbab..93aa286996c 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.4.1")]
+[assembly: AssemblyVersion("101.4.2")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index c6a37d8eded..9b172eeb3e4 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.4.1")]
+[assembly: AssemblyVersion("101.4.2")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index 6c792255f70..9b2bd840a5f 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.4.1")]
+[assembly: AssemblyVersion("101.4.2")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index 0b0bfc4bd34..9cbf1dc037a 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.4.1")]
+[assembly: AssemblyVersion("101.4.2")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index 0b0bfc4bd34..9cbf1dc037a 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.4.1")]
+[assembly: AssemblyVersion("101.4.2")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 59222d5d446..82d34d685ff 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "101.4.1",
+    "version": "101.4.2",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From a7563890c49ca0958332f8fb9fedcca5111ed85f Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Tue, 17 Aug 2021 21:47:00 +0100
Subject: [PATCH 130/166] perf: sending reply id as nullable

this will send it as 1 bit instead of 8 if there is no value
---
 Assets/Mirage/Runtime/Messages.cs            | 3 ++-
 Assets/Mirage/Runtime/ServerObjectManager.cs | 2 +-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/Assets/Mirage/Runtime/Messages.cs b/Assets/Mirage/Runtime/Messages.cs
index af9e47730e5..fb20a172f78 100644
--- a/Assets/Mirage/Runtime/Messages.cs
+++ b/Assets/Mirage/Runtime/Messages.cs
@@ -39,7 +39,8 @@ public struct ServerRpcMessage
 
         // if the server Rpc can return values
         // this then a ServerRpcReply will be sent with this id
-        public int replyId;
+        // use nullable for syncing so sent as 1 bit if null, but 0 for no id else where in the code
+        public int? replyId;
         // the parameters for the Cmd function
         // -> ArraySegment to avoid unnecessary allocations
         public ArraySegment<byte> payload;
diff --git a/Assets/Mirage/Runtime/ServerObjectManager.cs b/Assets/Mirage/Runtime/ServerObjectManager.cs
index 046145a030e..a0cdaa4e10d 100644
--- a/Assets/Mirage/Runtime/ServerObjectManager.cs
+++ b/Assets/Mirage/Runtime/ServerObjectManager.cs
@@ -388,7 +388,7 @@ void OnServerRpcMessage(INetworkPlayer player, ServerRpcMessage msg)
             using (PooledNetworkReader networkReader = NetworkReaderPool.GetReader(msg.payload))
             {
                 networkReader.ObjectLocator = Server.World;
-                identity.HandleRemoteCall(skeleton, msg.componentIndex, networkReader, player, msg.replyId);
+                identity.HandleRemoteCall(skeleton, msg.componentIndex, networkReader, player, msg.replyId.GetValueOrDefault());
             }
         }
 

From cef807ae869c126d21a7a18813364f8c8d2bf728 Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Sun, 22 Aug 2021 15:07:16 +0000
Subject: [PATCH 131/166] chore(release): 101.5.0 [skip ci]

# [101.5.0](https://github.com/MirageNet/Mirage/compare/v101.4.2...v101.5.0) (2021-08-22)

### Features

* **NetworkVisibility:** adding default implementation for OnRebuildObservers ([2bcf22f](https://github.com/MirageNet/Mirage/commit/2bcf22f26c1e76f0ed28a066a8c8384f8396077a))

### Performance Improvements

* sending reply id as nullable ([a756389](https://github.com/MirageNet/Mirage/commit/a7563890c49ca0958332f8fb9fedcca5111ed85f))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs         |  2 +-
 Assets/Mirage/CHANGELOG.md                           | 12 ++++++++++++
 Assets/Mirage/Components/AssemblyInfo.cs             |  2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                |  2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs    |  2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs               |  2 +-
 .../RigidbodyPhysics/Scripts/AssemblyInfo.cs         |  2 +-
 Assets/Mirage/package.json                           |  2 +-
 8 files changed, 19 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index 9cbf1dc037a..34daf13a66f 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.4.2")]
+[assembly: AssemblyVersion("101.5.0")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index e14cffe3300..984c8fbfacd 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,15 @@
+# [101.5.0](https://github.com/MirageNet/Mirage/compare/v101.4.2...v101.5.0) (2021-08-22)
+
+
+### Features
+
+* **NetworkVisibility:** adding default implementation for OnRebuildObservers ([2bcf22f](https://github.com/MirageNet/Mirage/commit/2bcf22f26c1e76f0ed28a066a8c8384f8396077a))
+
+
+### Performance Improvements
+
+* sending reply id as nullable ([a756389](https://github.com/MirageNet/Mirage/commit/a7563890c49ca0958332f8fb9fedcca5111ed85f))
+
 ## [101.4.2](https://github.com/MirageNet/Mirage/compare/v101.4.1...v101.4.2) (2021-08-21)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index 93aa286996c..31089722c74 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.4.2")]
+[assembly: AssemblyVersion("101.5.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index 9b172eeb3e4..4970c6bcf59 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.4.2")]
+[assembly: AssemblyVersion("101.5.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index 9b2bd840a5f..ac7066ed42b 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.4.2")]
+[assembly: AssemblyVersion("101.5.0")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index 9cbf1dc037a..34daf13a66f 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.4.2")]
+[assembly: AssemblyVersion("101.5.0")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index 9cbf1dc037a..34daf13a66f 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.4.2")]
+[assembly: AssemblyVersion("101.5.0")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 82d34d685ff..1daebe1f206 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "101.4.2",
+    "version": "101.5.0",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From de1216690a1823724fbb6c717d55a80e44784fa5 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Sun, 22 Aug 2021 17:18:30 +0100
Subject: [PATCH 132/166] perf: adding throw helper methods so that
 AggressiveInlining works (#894)

methods that throw will never be inlined, so instead they can call another method that does the throwing
---
 .../GenericTypesSerializationExtensions.cs           | 12 ++++++++++--
 Assets/Mirage/Runtime/Serialization/NetworkReader.cs |  6 +++++-
 Assets/Mirage/Runtime/Serialization/NetworkWriter.cs |  6 +++++-
 .../Serialization/Packers/QuaternionPacker.cs        |  8 ++++++--
 4 files changed, 26 insertions(+), 6 deletions(-)

diff --git a/Assets/Mirage/Runtime/Serialization/GenericTypesSerializationExtensions.cs b/Assets/Mirage/Runtime/Serialization/GenericTypesSerializationExtensions.cs
index 4b5cc397769..8ed7730e0ad 100644
--- a/Assets/Mirage/Runtime/Serialization/GenericTypesSerializationExtensions.cs
+++ b/Assets/Mirage/Runtime/Serialization/GenericTypesSerializationExtensions.cs
@@ -41,10 +41,14 @@ public static class GenericTypesSerializationExtensions
         public static void Write<T>(this NetworkWriter writer, T value)
         {
             if (Writer<T>.Write == null)
-                throw new KeyNotFoundException($"No writer found for {typeof(T)}. See https://miragenet.github.io/Mirage/Articles/General/Troubleshooting.html for details");
+                ThrowIfWriterNotFound<T>();
 
             Writer<T>.Write(writer, value);
         }
+        static void ThrowIfWriterNotFound<T>()
+        {
+            throw new KeyNotFoundException($"No writer found for {typeof(T)}. See https://miragenet.github.io/Mirage/Articles/General/Troubleshooting.html for details");
+        }
 
         /// <summary>
         /// Reads any data type that mirror supports
@@ -57,9 +61,13 @@ public static void Write<T>(this NetworkWriter writer, T value)
         public static T Read<T>(this NetworkReader reader)
         {
             if (Reader<T>.Read == null)
-                throw new KeyNotFoundException($"No reader found for {typeof(T)}. See https://miragenet.github.io/Mirage/Articles/General/Troubleshooting.html for details");
+                ThrowIfReaderNotFound<T>();
 
             return Reader<T>.Read(reader);
         }
+        static void ThrowIfReaderNotFound<T>()
+        {
+            throw new KeyNotFoundException($"No reader found for {typeof(T)}. See https://miragenet.github.io/Mirage/Articles/General/Troubleshooting.html for details");
+        }
     }
 }
diff --git a/Assets/Mirage/Runtime/Serialization/NetworkReader.cs b/Assets/Mirage/Runtime/Serialization/NetworkReader.cs
index 955388e932e..83b7256dc49 100644
--- a/Assets/Mirage/Runtime/Serialization/NetworkReader.cs
+++ b/Assets/Mirage/Runtime/Serialization/NetworkReader.cs
@@ -164,9 +164,13 @@ void CheckNewLength(int newPosition)
         {
             if (newPosition > bitLength)
             {
-                throw new EndOfStreamException($"Can not read over end of buffer, new position {newPosition}, length {bitLength} bits");
+                ThrowPositionOverLength(newPosition);
             }
         }
+        void ThrowPositionOverLength(int newPosition)
+        {
+            throw new EndOfStreamException($"Can not read over end of buffer, new position {newPosition}, length {bitLength} bits");
+        }
 
         private void PadToByte()
         {
diff --git a/Assets/Mirage/Runtime/Serialization/NetworkWriter.cs b/Assets/Mirage/Runtime/Serialization/NetworkWriter.cs
index 0e8680c7c24..a3b04d23dda 100644
--- a/Assets/Mirage/Runtime/Serialization/NetworkWriter.cs
+++ b/Assets/Mirage/Runtime/Serialization/NetworkWriter.cs
@@ -184,10 +184,14 @@ void CheckCapacity(int newLength)
                 }
                 else
                 {
-                    throw new InvalidOperationException($"Can not write over end of buffer, new length {newLength}, capacity {bitCapacity}");
+                    ThrowLengthOverCapacity(newLength);
                 }
             }
         }
+        void ThrowLengthOverCapacity(int newLength)
+        {
+            throw new InvalidOperationException($"Can not write over end of buffer, new length {newLength}, capacity {bitCapacity}");
+        }
 
         private void PadToByte()
         {
diff --git a/Assets/Mirage/Runtime/Serialization/Packers/QuaternionPacker.cs b/Assets/Mirage/Runtime/Serialization/Packers/QuaternionPacker.cs
index e021535a9a6..cc3c5a36e85 100644
--- a/Assets/Mirage/Runtime/Serialization/Packers/QuaternionPacker.cs
+++ b/Assets/Mirage/Runtime/Serialization/Packers/QuaternionPacker.cs
@@ -183,9 +183,12 @@ static void GetSmallerDimensions(uint largestIndex, ref Quaternion quaternion, o
                     c = quaternion.z;
                     return;
                 default:
-                    throw new IndexOutOfRangeException("Invalid Quaternion index!");
+                    ThrowIfOutOfRange();
+                    a = b = c = default;
+                    return;
             }
         }
+        static void ThrowIfOutOfRange() => throw new IndexOutOfRangeException("Invalid Quaternion index!");
 
 
         [MethodImpl(MethodImplOptions.AggressiveInlining)]
@@ -213,7 +216,8 @@ public Quaternion Unpack(NetworkReader reader)
                 case 3:
                     return new Quaternion(a, b, c, largest);
                 default:
-                    throw new IndexOutOfRangeException("Invalid Quaternion index!");
+                    ThrowIfOutOfRange();
+                    return default;
             }
         }
     }

From 754fda53f3590278d86b843d9e335fcfe29a08f6 Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Sun, 22 Aug 2021 16:31:57 +0000
Subject: [PATCH 133/166] chore(release): 101.5.1 [skip ci]

## [101.5.1](https://github.com/MirageNet/Mirage/compare/v101.5.0...v101.5.1) (2021-08-22)

### Performance Improvements

* adding throw helper methods so that AggressiveInlining works ([#894](https://github.com/MirageNet/Mirage/issues/894)) ([de12166](https://github.com/MirageNet/Mirage/commit/de1216690a1823724fbb6c717d55a80e44784fa5))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs               | 2 +-
 Assets/Mirage/CHANGELOG.md                                 | 7 +++++++
 Assets/Mirage/Components/AssemblyInfo.cs                   | 2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                      | 2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs          | 2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs                     | 2 +-
 .../Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs      | 2 +-
 Assets/Mirage/package.json                                 | 2 +-
 8 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index 34daf13a66f..f581acdcd0f 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.5.0")]
+[assembly: AssemblyVersion("101.5.1")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index 984c8fbfacd..0e1e59c181b 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,10 @@
+## [101.5.1](https://github.com/MirageNet/Mirage/compare/v101.5.0...v101.5.1) (2021-08-22)
+
+
+### Performance Improvements
+
+* adding throw helper methods so that AggressiveInlining works ([#894](https://github.com/MirageNet/Mirage/issues/894)) ([de12166](https://github.com/MirageNet/Mirage/commit/de1216690a1823724fbb6c717d55a80e44784fa5))
+
 # [101.5.0](https://github.com/MirageNet/Mirage/compare/v101.4.2...v101.5.0) (2021-08-22)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index 31089722c74..cff42398724 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.5.0")]
+[assembly: AssemblyVersion("101.5.1")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index 4970c6bcf59..6fb226b69f7 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.5.0")]
+[assembly: AssemblyVersion("101.5.1")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index ac7066ed42b..4302bc3d9aa 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.5.0")]
+[assembly: AssemblyVersion("101.5.1")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index 34daf13a66f..f581acdcd0f 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.5.0")]
+[assembly: AssemblyVersion("101.5.1")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index 34daf13a66f..f581acdcd0f 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.5.0")]
+[assembly: AssemblyVersion("101.5.1")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 1daebe1f206..8cf0876de8b 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "101.5.0",
+    "version": "101.5.1",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From 1660ca690bee0ef58e398d36511233ebd9975188 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Sun, 22 Aug 2021 18:00:40 +0100
Subject: [PATCH 134/166] feat(serialization): attribute to set bit size for
 ints base syncvars (#882)

---
 Assets/Mirage/Runtime/AssemblyInfo.cs         |   3 +-
 .../Runtime/Serialization/WeaverAttributes.cs |  27 +++-
 .../Weaver/Processors/SyncVarProcessor.cs     | 134 +++++++++++++-----
 .../Processors/SyncVars/BitCountFinder.cs     |  71 ++++++++++
 .../SyncVars/BitCountFinder.cs.meta           |  11 ++
 .../Processors/SyncVars/FoundSyncVar.cs       |   8 +-
 Assets/Mirage/Weaver/WeaverExceptions.cs      |   4 +
 Assets/Tests/Generated.meta                   |   8 ++
 Assets/Tests/Generated/BitCountTests.meta     |   8 ++
 .../BitCountBehaviour_MyByteEnum_4.cs         |  74 ++++++++++
 .../BitCountBehaviour_MyByteEnum_4.cs.meta    |  11 ++
 .../BitCountBehaviour_MyEnum_4.cs             |  74 ++++++++++
 .../BitCountBehaviour_MyEnum_4.cs.meta        |  11 ++
 .../BitCountTests/BitCountBehaviour_int_10.cs |  66 +++++++++
 .../BitCountBehaviour_int_10.cs.meta          |  11 ++
 .../BitCountTests/BitCountBehaviour_int_17.cs |  66 +++++++++
 .../BitCountBehaviour_int_17.cs.meta          |  11 ++
 .../BitCountTests/BitCountBehaviour_int_32.cs |  66 +++++++++
 .../BitCountBehaviour_int_32.cs.meta          |  11 ++
 .../BitCountBehaviour_short_12.cs             |  66 +++++++++
 .../BitCountBehaviour_short_12.cs.meta        |  11 ++
 .../BitCountBehaviour_short_4.cs              |  66 +++++++++
 .../BitCountBehaviour_short_4.cs.meta         |  11 ++
 .../BitCountBehaviour_ulong_24.cs             |  66 +++++++++
 .../BitCountBehaviour_ulong_24.cs.meta        |  11 ++
 .../BitCountBehaviour_ulong_5.cs              |  66 +++++++++
 .../BitCountBehaviour_ulong_5.cs.meta         |  11 ++
 .../BitCountBehaviour_ulong_64.cs             |  66 +++++++++
 .../BitCountBehaviour_ulong_64.cs.meta        |  11 ++
 .../Mirage.Tests.Generated.Runtime.asmdef     |  28 ++++
 ...Mirage.Tests.Generated.Runtime.asmdef.meta |   7 +
 Assets/Tests/Generators.meta                  |   8 ++
 .../Generators/.BitCountTestTemplate.txt      |  66 +++++++++
 .../Tests/Generators/BitCountTestGenerator.cs |  57 ++++++++
 .../Generators/BitCountTestGenerator.cs.meta  |  11 ++
 Assets/Tests/Generators/CodeGen.meta          |   8 ++
 .../Generators/CodeGen/CreateFromTemplate.cs  |  31 ++++
 .../CodeGen/CreateFromTemplate.cs.meta        |  11 ++
 .../Mirage.Tests.TestGenerators.asmdef        |  15 ++
 .../Mirage.Tests.TestGenerators.asmdef.meta   |   7 +
 Assets/Tests/Generators/README.MD             |   1 +
 Assets/Tests/Generators/README.MD.meta        |   7 +
 Assets/Tests/Weaver/BitAttributeTests.cs      |  59 ++++++++
 Assets/Tests/Weaver/BitAttributeTests.cs.meta |  11 ++
 .../Weaver/BitAttributeTests~/BitCount.cs     |  57 ++++++++
 .../BitCountOverTypeSize.cs                   |  66 +++++++++
 Assets/Tests/Weaver/Tests.cs                  |  44 +++++-
 47 files changed, 1511 insertions(+), 43 deletions(-)
 create mode 100644 Assets/Mirage/Weaver/Processors/SyncVars/BitCountFinder.cs
 create mode 100644 Assets/Mirage/Weaver/Processors/SyncVars/BitCountFinder.cs.meta
 create mode 100644 Assets/Tests/Generated.meta
 create mode 100644 Assets/Tests/Generated/BitCountTests.meta
 create mode 100644 Assets/Tests/Generated/BitCountTests/BitCountBehaviour_MyByteEnum_4.cs
 create mode 100644 Assets/Tests/Generated/BitCountTests/BitCountBehaviour_MyByteEnum_4.cs.meta
 create mode 100644 Assets/Tests/Generated/BitCountTests/BitCountBehaviour_MyEnum_4.cs
 create mode 100644 Assets/Tests/Generated/BitCountTests/BitCountBehaviour_MyEnum_4.cs.meta
 create mode 100644 Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_10.cs
 create mode 100644 Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_10.cs.meta
 create mode 100644 Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_17.cs
 create mode 100644 Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_17.cs.meta
 create mode 100644 Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_32.cs
 create mode 100644 Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_32.cs.meta
 create mode 100644 Assets/Tests/Generated/BitCountTests/BitCountBehaviour_short_12.cs
 create mode 100644 Assets/Tests/Generated/BitCountTests/BitCountBehaviour_short_12.cs.meta
 create mode 100644 Assets/Tests/Generated/BitCountTests/BitCountBehaviour_short_4.cs
 create mode 100644 Assets/Tests/Generated/BitCountTests/BitCountBehaviour_short_4.cs.meta
 create mode 100644 Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_24.cs
 create mode 100644 Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_24.cs.meta
 create mode 100644 Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_5.cs
 create mode 100644 Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_5.cs.meta
 create mode 100644 Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_64.cs
 create mode 100644 Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_64.cs.meta
 create mode 100644 Assets/Tests/Generated/Mirage.Tests.Generated.Runtime.asmdef
 create mode 100644 Assets/Tests/Generated/Mirage.Tests.Generated.Runtime.asmdef.meta
 create mode 100644 Assets/Tests/Generators.meta
 create mode 100644 Assets/Tests/Generators/.BitCountTestTemplate.txt
 create mode 100644 Assets/Tests/Generators/BitCountTestGenerator.cs
 create mode 100644 Assets/Tests/Generators/BitCountTestGenerator.cs.meta
 create mode 100644 Assets/Tests/Generators/CodeGen.meta
 create mode 100644 Assets/Tests/Generators/CodeGen/CreateFromTemplate.cs
 create mode 100644 Assets/Tests/Generators/CodeGen/CreateFromTemplate.cs.meta
 create mode 100644 Assets/Tests/Generators/Mirage.Tests.TestGenerators.asmdef
 create mode 100644 Assets/Tests/Generators/Mirage.Tests.TestGenerators.asmdef.meta
 create mode 100644 Assets/Tests/Generators/README.MD
 create mode 100644 Assets/Tests/Generators/README.MD.meta
 create mode 100644 Assets/Tests/Weaver/BitAttributeTests.cs
 create mode 100644 Assets/Tests/Weaver/BitAttributeTests.cs.meta
 create mode 100644 Assets/Tests/Weaver/BitAttributeTests~/BitCount.cs
 create mode 100644 Assets/Tests/Weaver/BitAttributeTests~/BitCountOverTypeSize.cs

diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index 6fb226b69f7..a54c4359f2d 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -6,8 +6,9 @@
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
 [assembly: InternalsVisibleTo("Mirage.Tests.Generated")]
+[assembly: InternalsVisibleTo("Mirage.Tests.Generated.Runtime")]
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
 [assembly: InternalsVisibleTo("Mirage.Tests.Performance.Editor")]
 [assembly: InternalsVisibleTo("Mirage.Tests.Performance.Runtime")]
 [assembly: InternalsVisibleTo("Mirage.Editor")]
-[assembly: InternalsVisibleTo("Unity.Mirage.CodeGen")]
\ No newline at end of file
+[assembly: InternalsVisibleTo("Unity.Mirage.CodeGen")]
diff --git a/Assets/Mirage/Runtime/Serialization/WeaverAttributes.cs b/Assets/Mirage/Runtime/Serialization/WeaverAttributes.cs
index 48b208476e5..1294af11fe1 100644
--- a/Assets/Mirage/Runtime/Serialization/WeaverAttributes.cs
+++ b/Assets/Mirage/Runtime/Serialization/WeaverAttributes.cs
@@ -7,4 +7,29 @@ namespace Mirage.Serialization
     /// </summary>
     [AttributeUsage(AttributeTargets.Method)]
     public sealed class WeaverIgnoreAttribute : Attribute { }
-}
\ No newline at end of file
+
+    /// <summary>
+    /// Tells weaver how many bits to sue for field
+    /// <para>Only works with interager fields (byte, int, ulong, enums etc)</para>
+    /// <para>
+    /// NOTE: bits are truncated when using this, so signed values will lose their sign.
+    /// </para>
+    /// </summary>
+    [AttributeUsage(AttributeTargets.Field | AttributeTargets.Parameter)]
+    public class BitCountAttribute : Attribute
+    {
+        /// <summary>
+        /// Value should be between 1 and 64
+        /// </summary>
+        public int BitCount { get; private set; }
+
+        /// <summary>
+        /// 
+        /// </summary>
+        /// <param name="bitCount">Value should be between 1 and 64</param>
+        public BitCountAttribute(int bitCount)
+        {
+            BitCount = bitCount;
+        }
+    }
+}
diff --git a/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs b/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
index 463225bc141..487ab6e1637 100644
--- a/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
@@ -1,4 +1,5 @@
 using System;
+using Mirage.Serialization;
 using Mirage.Weaver.NetworkBehaviours;
 using Mirage.Weaver.SyncVars;
 using Mono.Cecil;
@@ -398,7 +399,7 @@ void GenerateSerialization()
             {
                 foreach (FoundSyncVar syncVar in behaviour.SyncVars)
                 {
-                    WriteVariable(worker, helper.WriterParameter, syncVar);
+                    WriteFromField(worker, helper.WriterParameter, syncVar);
                 }
             });
 
@@ -413,7 +414,7 @@ void GenerateSerialization()
                 helper.WriteIfSyncVarDirty(syncVar, () =>
                 {
                     // Generates a call to the writer for that field
-                    WriteVariable(worker, helper.WriterParameter, syncVar);
+                    WriteFromField(worker, helper.WriterParameter, syncVar);
                 });
             }
 
@@ -421,20 +422,47 @@ void GenerateSerialization()
             helper.WriteReturnDirty();
         }
 
-        static void WriteVariable(ILProcessor worker, ParameterDefinition writerParameter, FoundSyncVar syncVar)
+        void WriteFromField(ILProcessor worker, ParameterDefinition writerParameter, FoundSyncVar syncVar)
         {
-            // if WriteFunction is null it means there was an error earlier, so we dont need to do anything here
-            if (syncVar.WriteFunction == null) { return; }
+            if (syncVar.BitCount.HasValue)
+            {
+                WriteWithBitCount();
+            }
+            else
+            {
+                WriteDefault();
+            }
 
-            // Generates a writer call for each sync variable
-            // writer
-            worker.Append(worker.Create(OpCodes.Ldarg, writerParameter));
-            // this
-            worker.Append(worker.Create(OpCodes.Ldarg_0));
-            worker.Append(worker.Create(OpCodes.Ldfld, syncVar.FieldDefinition.MakeHostGenericIfNeeded()));
-            worker.Append(worker.Create(OpCodes.Call, syncVar.WriteFunction));
+            // Local Functions
+
+            void WriteDefault()
+            {
+                // if WriteFunction is null it means there was an error earlier, so we dont need to do anything here
+                if (syncVar.WriteFunction == null) { return; }
+
+                // Generates a writer call for each sync variable
+                // writer
+                worker.Append(worker.Create(OpCodes.Ldarg, writerParameter));
+                // this
+                worker.Append(worker.Create(OpCodes.Ldarg_0));
+                worker.Append(worker.Create(OpCodes.Ldfld, syncVar.FieldDefinition.MakeHostGenericIfNeeded()));
+                worker.Append(worker.Create(OpCodes.Call, syncVar.WriteFunction));
+            }
+
+            void WriteWithBitCount()
+            {
+                MethodReference writeWithBitCount = module.ImportReference(writerParameter.ParameterType.Resolve().GetMethod(nameof(NetworkWriter.Write)));
+
+                worker.Append(worker.Create(OpCodes.Ldarg, writerParameter));
+                worker.Append(worker.Create(OpCodes.Ldarg_0));
+                worker.Append(worker.Create(OpCodes.Ldfld, syncVar.FieldDefinition.MakeHostGenericIfNeeded()));
+                worker.Append(worker.Create(OpCodes.Conv_U8));
+                worker.Append(worker.Create(OpCodes.Ldc_I4, syncVar.BitCount.Value));
+                worker.Append(worker.Create(OpCodes.Call, writeWithBitCount));
+            }
         }
 
+
         void GenerateDeserialization()
         {
             Weaver.DebugLog(behaviour.TypeDefinition, "  GenerateDeSerialization");
@@ -458,7 +486,7 @@ void GenerateDeserialization()
             {
                 foreach (FoundSyncVar syncVar in behaviour.SyncVars)
                 {
-                    DeserializeField(worker, helper.Method, syncVar);
+                    DeserializeField(worker, helper.Method, helper.ReaderParameter, syncVar);
                 }
             });
 
@@ -469,7 +497,7 @@ void GenerateDeserialization()
             {
                 helper.WriteIfSyncVarDirty(syncVar, () =>
                 {
-                    DeserializeField(worker, helper.Method, syncVar);
+                    DeserializeField(worker, helper.Method, helper.ReaderParameter, syncVar);
                 });
             }
 
@@ -484,12 +512,8 @@ void GenerateDeserialization()
         /// <param name="deserialize"></param>
         /// <param name="initialState"></param>
         /// <param name="hookResult"></param>
-        void DeserializeField(ILProcessor worker, MethodDefinition deserialize, FoundSyncVar syncVar)
+        void DeserializeField(ILProcessor worker, MethodDefinition deserialize, ParameterDefinition readerParameter, FoundSyncVar syncVar)
         {
-            // if ReadFunction is null it means there was an error earlier, so we dont need to do anything here
-            if (syncVar.ReadFunction == null) { return; }
-
-            FieldDefinition fd = syncVar.FieldDefinition;
             TypeReference originalType = syncVar.OriginalType;
 
             /*
@@ -501,6 +525,7 @@ void DeserializeField(ILProcessor worker, MethodDefinition deserialize, FoundSyn
                     OnSetA(oldValue, Networka)
              */
 
+            // Store old value in local variable, we need it for Hook
             // T oldValue = value
             VariableDefinition oldValue = null;
             if (syncVar.HasHookMethod)
@@ -512,22 +537,7 @@ void DeserializeField(ILProcessor worker, MethodDefinition deserialize, FoundSyn
             }
 
             // read value and store in syncvar BEFORE calling the hook
-            // -> this makes way more sense. by definition, the hook is
-            //    supposed to be called after it was changed. not before.
-            // -> setting it BEFORE calling the hook fixes the following bug:
-            //    https://github.com/vis2k/Mirror/issues/1151 in host mode
-            //    where the value during the Hook call would call Cmds on
-            //    the host server, and they would all happen and compare
-            //    values BEFORE the hook even returned and hence BEFORE the
-            //    actual value was even set.
-            // put 'this.' onto stack for 'this.syncvar' below
-            worker.Append(worker.Create(OpCodes.Ldarg_0));
-            // reader. for 'reader.Read()' below
-            worker.Append(worker.Create(OpCodes.Ldarg_1));
-            // reader.Read()
-            worker.Append(worker.Create(OpCodes.Call, syncVar.ReadFunction));
-            // syncvar
-            worker.Append(worker.Create(OpCodes.Stfld, fd.MakeHostGenericIfNeeded()));
+            ReadToField(worker, readerParameter, syncVar);
 
             if (syncVar.HasHookMethod)
             {
@@ -561,5 +571,59 @@ void DeserializeField(ILProcessor worker, MethodDefinition deserialize, FoundSyn
                 worker.Append(syncVarEqualLabel);
             }
         }
+
+        void ReadToField(ILProcessor worker, ParameterDefinition readerParameter, FoundSyncVar syncVar)
+        {
+            if (syncVar.BitCount.HasValue)
+            {
+                ReadWithBitCount();
+            }
+            else
+            {
+                ReadDefault();
+            }
+
+            // Local Functions
+
+            void ReadDefault()
+            {
+                // if ReadFunction is null it means there was an error earlier, so we dont need to do anything here
+                if (syncVar.ReadFunction == null) { return; }
+
+                // put `this` on stack, for Stfld later
+                worker.Append(worker.Create(OpCodes.Ldarg_0));
+
+                // add `reader` to stack
+                worker.Append(worker.Create(OpCodes.Ldarg, readerParameter));
+                // call read function
+                worker.Append(worker.Create(OpCodes.Call, syncVar.ReadFunction));
+
+                // store result of read to `this.syncvar`
+                worker.Append(worker.Create(OpCodes.Stfld, syncVar.FieldDefinition.MakeHostGenericIfNeeded()));
+            }
+            void ReadWithBitCount()
+            {
+                MethodReference readWithBitCount = module.ImportReference(readerParameter.ParameterType.Resolve().GetMethod(nameof(NetworkReader.Read)));
+
+
+                // put `this` on stack, for Stfld later
+                worker.Append(worker.Create(OpCodes.Ldarg_0));
+
+                // add `reader` to stack
+                worker.Append(worker.Create(OpCodes.Ldarg, readerParameter));
+                // add `bitCount` to stack
+                worker.Append(worker.Create(OpCodes.Ldc_I4, syncVar.BitCount.Value));
+                // call `reader.read(bitCount)` function
+                worker.Append(worker.Create(OpCodes.Call, readWithBitCount));
+
+                // convert result to correct size if needed
+                if (syncVar.BitCountConvert.HasValue)
+                {
+                    worker.Append(worker.Create(syncVar.BitCountConvert.Value));
+                }
+
+                worker.Append(worker.Create(OpCodes.Stfld, syncVar.FieldDefinition.MakeHostGenericIfNeeded()));
+            }
+        }
     }
 }
diff --git a/Assets/Mirage/Weaver/Processors/SyncVars/BitCountFinder.cs b/Assets/Mirage/Weaver/Processors/SyncVars/BitCountFinder.cs
new file mode 100644
index 00000000000..3f087630c8f
--- /dev/null
+++ b/Assets/Mirage/Weaver/Processors/SyncVars/BitCountFinder.cs
@@ -0,0 +1,71 @@
+using Mirage.Serialization;
+using Mono.Cecil;
+using Mono.Cecil.Cil;
+
+namespace Mirage.Weaver.SyncVars
+{
+    public static class BitCountFinder
+    {
+        public static (int? bitCount, OpCode? ConvertCode) GetBitCount(FieldDefinition syncVar)
+        {
+            CustomAttribute attribute = syncVar.GetCustomAttribute<BitCountAttribute>();
+            if (attribute == null)
+                return default;
+
+            int bitCount = (int)attribute.ConstructorArguments[0].Value;
+
+            if (bitCount <= 0)
+                throw new BitCountException("BitCount should be above 0", syncVar);
+
+            int maxSize = GetTypeMaxSize(syncVar.FieldType, syncVar);
+
+            if (bitCount > maxSize)
+                throw new BitCountException($"BitCount can not be above target type size, bitCount:{bitCount}, type:{syncVar.FieldType.Name}, max size:{maxSize}", syncVar);
+
+            return (bitCount, GetConvertType(syncVar.FieldType));
+        }
+
+        static int GetTypeMaxSize(TypeReference type, FieldDefinition syncVar)
+        {
+            if (type.Is<byte>()) return 8;
+            if (type.Is<ushort>()) return 16;
+            if (type.Is<short>()) return 16;
+            if (type.Is<uint>()) return 32;
+            if (type.Is<int>()) return 32;
+            if (type.Is<ulong>()) return 64;
+            if (type.Is<long>()) return 64;
+
+            if (type.Resolve().IsEnum)
+            {
+                // use underlying enum type for max size
+                TypeReference enumType = type.Resolve().GetEnumUnderlyingType();
+                return GetTypeMaxSize(enumType, syncVar);
+            }
+
+            throw new BitCountException($"{type.FullName} is not a supported type for [BitCount]", syncVar);
+        }
+
+        /// <summary>
+        /// Read returns a ulong, so if field is a smaller type it must be converted to a int32. all smaller types are padded to anyway
+        /// </summary>
+        /// <param name="syncVar"></param>
+        /// <returns></returns>
+        static OpCode? GetConvertType(TypeReference type)
+        {
+            if (type.Is<byte>()) return OpCodes.Conv_I4;
+            if (type.Is<ushort>()) return OpCodes.Conv_I4;
+            if (type.Is<short>()) return OpCodes.Conv_I4;
+            if (type.Is<uint>()) return OpCodes.Conv_I4;
+            if (type.Is<int>()) return OpCodes.Conv_I4;
+
+            if (type.Resolve().IsEnum)
+            {
+                // use underlying enum type for cast
+                TypeReference enumType = type.Resolve().GetEnumUnderlyingType();
+                return GetConvertType(enumType);
+            }
+
+            return default;
+        }
+    }
+}
diff --git a/Assets/Mirage/Weaver/Processors/SyncVars/BitCountFinder.cs.meta b/Assets/Mirage/Weaver/Processors/SyncVars/BitCountFinder.cs.meta
new file mode 100644
index 00000000000..a6b5d8753cd
--- /dev/null
+++ b/Assets/Mirage/Weaver/Processors/SyncVars/BitCountFinder.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 892bfdd121a4b66478af01a9274b4d14
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs b/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs
index c029fc3ea16..4dc31edddd1 100644
--- a/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs
@@ -1,4 +1,5 @@
 using Mono.Cecil;
+using Mono.Cecil.Cil;
 using UnityEngine;
 
 namespace Mirage.Weaver.SyncVars
@@ -22,6 +23,10 @@ public FoundSyncVar(FieldDefinition fieldDefinition, int dirtyIndex)
 
         public bool HasHookMethod { get; private set; }
         public MethodDefinition HookMethod { get; private set; }
+
+        public int? BitCount { get; private set; }
+        public OpCode? BitCountConvert { get; internal set; }
+
         public MethodReference WriteFunction { get; private set; }
         public MethodReference ReadFunction { get; private set; }
 
@@ -75,6 +80,8 @@ public void ProcessAttributes()
         {
             HookMethod = HookMethodFinder.GetHookMethod(FieldDefinition, OriginalType);
             HasHookMethod = HookMethod != null;
+
+            (BitCount, BitCountConvert) = BitCountFinder.GetBitCount(FieldDefinition);
         }
 
         public void FindSerializeFunctions(Writers writers, Readers readers)
@@ -89,6 +96,5 @@ public void FindSerializeFunctions(Writers writers, Readers readers)
                 throw new SyncVarException($"{FieldDefinition.Name} is an unsupported type. {e.Message}", FieldDefinition);
             }
         }
-
     }
 }
diff --git a/Assets/Mirage/Weaver/WeaverExceptions.cs b/Assets/Mirage/Weaver/WeaverExceptions.cs
index 46d6772c7c8..7360515dd0c 100644
--- a/Assets/Mirage/Weaver/WeaverExceptions.cs
+++ b/Assets/Mirage/Weaver/WeaverExceptions.cs
@@ -39,4 +39,8 @@ internal class HookMethodException : SyncVarException
     {
         public HookMethodException(string message, MemberReference memberReference) : base(message, memberReference) { }
     }
+    internal class BitCountException : SyncVarException
+    {
+        public BitCountException(string message, MemberReference memberReference) : base(message, memberReference) { }
+    }
 }
diff --git a/Assets/Tests/Generated.meta b/Assets/Tests/Generated.meta
new file mode 100644
index 00000000000..72280d1d74c
--- /dev/null
+++ b/Assets/Tests/Generated.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 959b4c94d03a0c44da786a55c306ee00
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/BitCountTests.meta b/Assets/Tests/Generated/BitCountTests.meta
new file mode 100644
index 00000000000..706e5c13295
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountTests.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: d467a8a2dda82ad4a8133a09f6ffac51
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_MyByteEnum_4.cs b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_MyByteEnum_4.cs
new file mode 100644
index 00000000000..3c1b76eedff
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_MyByteEnum_4.cs
@@ -0,0 +1,74 @@
+// DO NOT EDIT: GENERATED BY BitCountTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.BitCountAttributeTests
+{
+    [System.Flags, System.Serializable]
+    public enum MyByteEnum : byte
+    {
+        None = 0,
+        HasHealth = 1,
+        HasArmor = 2,
+        HasGun = 4,
+        HasAmmo = 8,
+    }
+    public class BitCountBehaviour_MyByteEnum_4 : NetworkBehaviour
+    {
+        [BitCount(4)]
+        [SyncVar] public MyByteEnum myValue;
+
+        public event Action<MyByteEnum> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCount(4)] MyByteEnum myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class BitCountTest_MyByteEnum_4 : ClientServerSetup<BitCountBehaviour_MyByteEnum_4>
+    {
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            var behaviour = new BitCountBehaviour_MyByteEnum_4();
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                behaviour.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(4));
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            const MyByteEnum value = (MyByteEnum)3;
+
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(1), $"4 bits is 1 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_MyByteEnum_4.cs.meta b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_MyByteEnum_4.cs.meta
new file mode 100644
index 00000000000..d8b85647df5
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_MyByteEnum_4.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 07a82e15515c61743a462a884a5e0c58
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_MyEnum_4.cs b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_MyEnum_4.cs
new file mode 100644
index 00000000000..8f230b0bd14
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_MyEnum_4.cs
@@ -0,0 +1,74 @@
+// DO NOT EDIT: GENERATED BY BitCountTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.BitCountAttributeTests
+{
+    [System.Flags, System.Serializable]
+    public enum MyEnum
+    {
+        None = 0,
+        HasHealth = 1,
+        HasArmor = 2,
+        HasGun = 4,
+        HasAmmo = 8,
+    }
+    public class BitCountBehaviour_MyEnum_4 : NetworkBehaviour
+    {
+        [BitCount(4)]
+        [SyncVar] public MyEnum myValue;
+
+        public event Action<MyEnum> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCount(4)] MyEnum myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class BitCountTest_MyEnum_4 : ClientServerSetup<BitCountBehaviour_MyEnum_4>
+    {
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            var behaviour = new BitCountBehaviour_MyEnum_4();
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                behaviour.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(4));
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            const MyEnum value = (MyEnum)3;
+
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(1), $"4 bits is 1 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_MyEnum_4.cs.meta b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_MyEnum_4.cs.meta
new file mode 100644
index 00000000000..417ba6194ea
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_MyEnum_4.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: a88893ffaef084b45acf2820fb664975
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_10.cs b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_10.cs
new file mode 100644
index 00000000000..5535653fdbc
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_10.cs
@@ -0,0 +1,66 @@
+// DO NOT EDIT: GENERATED BY BitCountTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.BitCountAttributeTests
+{
+    
+    public class BitCountBehaviour_int_10 : NetworkBehaviour
+    {
+        [BitCount(10)]
+        [SyncVar] public int myValue;
+
+        public event Action<int> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCount(10)] int myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class BitCountTest_int_10 : ClientServerSetup<BitCountBehaviour_int_10>
+    {
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            var behaviour = new BitCountBehaviour_int_10();
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                behaviour.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(10));
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            const int value = 20;
+
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(2), $"10 bits is 2 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_10.cs.meta b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_10.cs.meta
new file mode 100644
index 00000000000..468cbc7af03
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_10.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 35eb226fb46a6194a948d714de75dc54
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_17.cs b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_17.cs
new file mode 100644
index 00000000000..b8fac129964
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_17.cs
@@ -0,0 +1,66 @@
+// DO NOT EDIT: GENERATED BY BitCountTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.BitCountAttributeTests
+{
+    
+    public class BitCountBehaviour_int_17 : NetworkBehaviour
+    {
+        [BitCount(17)]
+        [SyncVar] public int myValue;
+
+        public event Action<int> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCount(17)] int myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class BitCountTest_int_17 : ClientServerSetup<BitCountBehaviour_int_17>
+    {
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            var behaviour = new BitCountBehaviour_int_17();
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                behaviour.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(17));
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            const int value = 20;
+
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(3), $"17 bits is 3 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_17.cs.meta b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_17.cs.meta
new file mode 100644
index 00000000000..96a2c3ba411
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_17.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: c88ea0247a9d41043b6247338c9eca4d
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_32.cs b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_32.cs
new file mode 100644
index 00000000000..ba37312a6e7
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_32.cs
@@ -0,0 +1,66 @@
+// DO NOT EDIT: GENERATED BY BitCountTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.BitCountAttributeTests
+{
+    
+    public class BitCountBehaviour_int_32 : NetworkBehaviour
+    {
+        [BitCount(32)]
+        [SyncVar] public int myValue;
+
+        public event Action<int> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCount(32)] int myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class BitCountTest_int_32 : ClientServerSetup<BitCountBehaviour_int_32>
+    {
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            var behaviour = new BitCountBehaviour_int_32();
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                behaviour.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(32));
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            const int value = 20;
+
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(4), $"32 bits is 4 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_32.cs.meta b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_32.cs.meta
new file mode 100644
index 00000000000..ea77a629c26
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_32.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 6e3bb7a2ea9da0846a7ce769f31e1b3c
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_short_12.cs b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_short_12.cs
new file mode 100644
index 00000000000..bf0a5812ad2
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_short_12.cs
@@ -0,0 +1,66 @@
+// DO NOT EDIT: GENERATED BY BitCountTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.BitCountAttributeTests
+{
+    
+    public class BitCountBehaviour_short_12 : NetworkBehaviour
+    {
+        [BitCount(12)]
+        [SyncVar] public short myValue;
+
+        public event Action<short> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCount(12)] short myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class BitCountTest_short_12 : ClientServerSetup<BitCountBehaviour_short_12>
+    {
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            var behaviour = new BitCountBehaviour_short_12();
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                behaviour.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(12));
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            const short value = 20;
+
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(2), $"12 bits is 2 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_short_12.cs.meta b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_short_12.cs.meta
new file mode 100644
index 00000000000..fc4fd397a86
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_short_12.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 445320b56bb07754cb55b25514abf4d4
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_short_4.cs b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_short_4.cs
new file mode 100644
index 00000000000..7216966f504
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_short_4.cs
@@ -0,0 +1,66 @@
+// DO NOT EDIT: GENERATED BY BitCountTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.BitCountAttributeTests
+{
+    
+    public class BitCountBehaviour_short_4 : NetworkBehaviour
+    {
+        [BitCount(4)]
+        [SyncVar] public short myValue;
+
+        public event Action<short> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCount(4)] short myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class BitCountTest_short_4 : ClientServerSetup<BitCountBehaviour_short_4>
+    {
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            var behaviour = new BitCountBehaviour_short_4();
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                behaviour.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(4));
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            const short value = 20;
+
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(1), $"4 bits is 1 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_short_4.cs.meta b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_short_4.cs.meta
new file mode 100644
index 00000000000..e2594abe8a6
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_short_4.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 66b0359ad03bbbd438468152ea395144
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_24.cs b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_24.cs
new file mode 100644
index 00000000000..827a72e1247
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_24.cs
@@ -0,0 +1,66 @@
+// DO NOT EDIT: GENERATED BY BitCountTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.BitCountAttributeTests
+{
+    
+    public class BitCountBehaviour_ulong_24 : NetworkBehaviour
+    {
+        [BitCount(24)]
+        [SyncVar] public ulong myValue;
+
+        public event Action<ulong> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCount(24)] ulong myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class BitCountTest_ulong_24 : ClientServerSetup<BitCountBehaviour_ulong_24>
+    {
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            var behaviour = new BitCountBehaviour_ulong_24();
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                behaviour.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(24));
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            const ulong value = 20;
+
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(3), $"24 bits is 3 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_24.cs.meta b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_24.cs.meta
new file mode 100644
index 00000000000..288ac5a1091
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_24.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: e11a7f817944ccc4cb4bcf80be0e8bfb
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_5.cs b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_5.cs
new file mode 100644
index 00000000000..e29fbe6742f
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_5.cs
@@ -0,0 +1,66 @@
+// DO NOT EDIT: GENERATED BY BitCountTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.BitCountAttributeTests
+{
+    
+    public class BitCountBehaviour_ulong_5 : NetworkBehaviour
+    {
+        [BitCount(5)]
+        [SyncVar] public ulong myValue;
+
+        public event Action<ulong> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCount(5)] ulong myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class BitCountTest_ulong_5 : ClientServerSetup<BitCountBehaviour_ulong_5>
+    {
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            var behaviour = new BitCountBehaviour_ulong_5();
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                behaviour.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(5));
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            const ulong value = 20;
+
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(1), $"5 bits is 1 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_5.cs.meta b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_5.cs.meta
new file mode 100644
index 00000000000..1a9bbe6a8dd
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_5.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 46af30f0b26070a40a79fb8bcd03a987
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_64.cs b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_64.cs
new file mode 100644
index 00000000000..7882bcb9141
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_64.cs
@@ -0,0 +1,66 @@
+// DO NOT EDIT: GENERATED BY BitCountTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.BitCountAttributeTests
+{
+    
+    public class BitCountBehaviour_ulong_64 : NetworkBehaviour
+    {
+        [BitCount(64)]
+        [SyncVar] public ulong myValue;
+
+        public event Action<ulong> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCount(64)] ulong myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class BitCountTest_ulong_64 : ClientServerSetup<BitCountBehaviour_ulong_64>
+    {
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            var behaviour = new BitCountBehaviour_ulong_64();
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                behaviour.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(64));
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            const ulong value = 20;
+
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(8), $"64 bits is 8 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_64.cs.meta b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_64.cs.meta
new file mode 100644
index 00000000000..1fae091dbaa
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_64.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 20adbacec1c8df644bc7f00d9ca44f2d
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/Mirage.Tests.Generated.Runtime.asmdef b/Assets/Tests/Generated/Mirage.Tests.Generated.Runtime.asmdef
new file mode 100644
index 00000000000..f3c7c536fc2
--- /dev/null
+++ b/Assets/Tests/Generated/Mirage.Tests.Generated.Runtime.asmdef
@@ -0,0 +1,28 @@
+{
+    "name": "Mirage.Tests.Generated.Runtime",
+    "references": [
+        "Mirage",
+        "Mirage.SocketLayer",
+        "Mirage.Tests.Common",
+        "Mirage.Authenticators",
+        "UniTask",
+        "Mirage.Components",
+        "WeaverTestExtraAssembly",
+        "UnityEngine.TestRunner",
+        "UnityEditor.TestRunner",
+        "Mirage.Tests.Runtime"
+    ],
+    "includePlatforms": [],
+    "excludePlatforms": [],
+    "allowUnsafeCode": false,
+    "overrideReferences": true,
+    "precompiledReferences": [
+        "nunit.framework.dll"
+    ],
+    "autoReferenced": false,
+    "defineConstraints": [
+        "UNITY_INCLUDE_TESTS"
+    ],
+    "versionDefines": [],
+    "noEngineReferences": false
+}
\ No newline at end of file
diff --git a/Assets/Tests/Generated/Mirage.Tests.Generated.Runtime.asmdef.meta b/Assets/Tests/Generated/Mirage.Tests.Generated.Runtime.asmdef.meta
new file mode 100644
index 00000000000..082d39f0140
--- /dev/null
+++ b/Assets/Tests/Generated/Mirage.Tests.Generated.Runtime.asmdef.meta
@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: 623d4c4b0a3850d49b923867013da0eb
+AssemblyDefinitionImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generators.meta b/Assets/Tests/Generators.meta
new file mode 100644
index 00000000000..3ebde75e787
--- /dev/null
+++ b/Assets/Tests/Generators.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: a8a7620e2308ab3489f038bfcf2c779f
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generators/.BitCountTestTemplate.txt b/Assets/Tests/Generators/.BitCountTestTemplate.txt
new file mode 100644
index 00000000000..d880543e0c8
--- /dev/null
+++ b/Assets/Tests/Generators/.BitCountTestTemplate.txt
@@ -0,0 +1,66 @@
+// DO NOT EDIT: GENERATED BY BitCountTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.BitCountAttributeTests
+{
+    %%EXTRA_TYPE%%
+    public class BitCountBehaviour_%%TYPE%%_%%BIT_COUNT%% : NetworkBehaviour
+    {
+        [BitCount(%%BIT_COUNT%%)]
+        [SyncVar] public %%TYPE%% myValue;
+
+        public event Action<%%TYPE%%> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCount(%%BIT_COUNT%%)] %%TYPE%% myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class BitCountTest_%%TYPE%%_%%BIT_COUNT%% : ClientServerSetup<BitCountBehaviour_%%TYPE%%_%%BIT_COUNT%%>
+    {
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            var behaviour = new BitCountBehaviour_%%TYPE%%_%%BIT_COUNT%%();
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                behaviour.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(%%BIT_COUNT%%));
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            const %%TYPE%% value = %%EXTRA_VALUE%%;
+
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(%%PAYLOAD_SIZE%%), $"%%BIT_COUNT%% bits is %%PAYLOAD_SIZE%% bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generators/BitCountTestGenerator.cs b/Assets/Tests/Generators/BitCountTestGenerator.cs
new file mode 100644
index 00000000000..cb84913d308
--- /dev/null
+++ b/Assets/Tests/Generators/BitCountTestGenerator.cs
@@ -0,0 +1,57 @@
+using JamesFrowen.SimpleCodeGen;
+using UnityEditor;
+using UnityEngine;
+
+namespace Mirage.Tests.CodeGenerators
+{
+    public static class BitCountTestGenerator
+    {
+        [MenuItem("Tests Generators/BitCount")]
+        public static void CreateAll()
+        {
+            var fromTemplate = new CreateFromTemplate("./Assets/Tests/Generators/.BitCountTestTemplate.txt");
+            Create(fromTemplate, "int", 10);
+            Create(fromTemplate, "int", 17);
+            Create(fromTemplate, "int", 32);
+            Create(fromTemplate, "short", 4);
+            Create(fromTemplate, "short", 12);
+            Create(fromTemplate, "ulong", 5);
+            Create(fromTemplate, "ulong", 24);
+            Create(fromTemplate, "ulong", 64);
+            Create(fromTemplate, "MyEnum", 4, "(MyEnum)3",
+    @"[System.Flags, System.Serializable]
+    public enum MyEnum
+    {
+        None = 0,
+        HasHealth = 1,
+        HasArmor = 2,
+        HasGun = 4,
+        HasAmmo = 8,
+    }");
+
+            Create(fromTemplate, "MyByteEnum", 4, "(MyByteEnum)3",
+    @"[System.Flags, System.Serializable]
+    public enum MyByteEnum : byte
+    {
+        None = 0,
+        HasHealth = 1,
+        HasArmor = 2,
+        HasGun = 4,
+        HasAmmo = 8,
+    }");
+
+            AssetDatabase.Refresh();
+        }
+
+        private static void Create(CreateFromTemplate fromTemplate, string type, int bitCount, string extraValue = "20", string extraType = "")
+        {
+            fromTemplate.Replace("%%BIT_COUNT%%", bitCount);
+            fromTemplate.Replace("%%TYPE%%", type);
+            fromTemplate.Replace("%%PAYLOAD_SIZE%%", Mathf.CeilToInt(bitCount / 8f));
+            fromTemplate.Replace("%%EXTRA_TYPE%%", extraType);
+            fromTemplate.Replace("%%EXTRA_VALUE%%", extraValue);
+
+            fromTemplate.WriteToFile($"./Assets/Tests/Generated/BitCountTests/BitCountBehaviour_{type}_{bitCount}.cs");
+        }
+    }
+}
diff --git a/Assets/Tests/Generators/BitCountTestGenerator.cs.meta b/Assets/Tests/Generators/BitCountTestGenerator.cs.meta
new file mode 100644
index 00000000000..34645994dda
--- /dev/null
+++ b/Assets/Tests/Generators/BitCountTestGenerator.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 90ae595f827df5b43b12bab6c3d82b8f
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generators/CodeGen.meta b/Assets/Tests/Generators/CodeGen.meta
new file mode 100644
index 00000000000..c884ff35da0
--- /dev/null
+++ b/Assets/Tests/Generators/CodeGen.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 6f2f5611cb7ad244a88cffa0e4bf9376
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generators/CodeGen/CreateFromTemplate.cs b/Assets/Tests/Generators/CodeGen/CreateFromTemplate.cs
new file mode 100644
index 00000000000..50463c3b047
--- /dev/null
+++ b/Assets/Tests/Generators/CodeGen/CreateFromTemplate.cs
@@ -0,0 +1,31 @@
+using System.IO;
+namespace JamesFrowen.SimpleCodeGen
+{
+    public sealed class CreateFromTemplate
+    {
+        readonly string template;
+        string output;
+
+        public CreateFromTemplate(string templatePath)
+        {
+            template = File.ReadAllText(templatePath);
+            output = template;
+        }
+
+        public void Replace(string oldValue, string newValue)
+        {
+            output = output.Replace(oldValue, newValue);
+        }
+        public void Replace(string oldValue, object newValue)
+        {
+            output = output.Replace(oldValue, newValue.ToString());
+        }
+
+        public void WriteToFile(string path)
+        {
+            File.WriteAllText(path, output);
+            // reset output to template after writing
+            output = template;
+        }
+    }
+}
diff --git a/Assets/Tests/Generators/CodeGen/CreateFromTemplate.cs.meta b/Assets/Tests/Generators/CodeGen/CreateFromTemplate.cs.meta
new file mode 100644
index 00000000000..65346c12cd1
--- /dev/null
+++ b/Assets/Tests/Generators/CodeGen/CreateFromTemplate.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 41eb920ccfef56d4e86c2564d5e0a68d
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generators/Mirage.Tests.TestGenerators.asmdef b/Assets/Tests/Generators/Mirage.Tests.TestGenerators.asmdef
new file mode 100644
index 00000000000..71a1c342c37
--- /dev/null
+++ b/Assets/Tests/Generators/Mirage.Tests.TestGenerators.asmdef
@@ -0,0 +1,15 @@
+{
+    "name": "Mirage.Tests.TestGenerators",
+    "references": [],
+    "includePlatforms": [
+        "Editor"
+    ],
+    "excludePlatforms": [],
+    "allowUnsafeCode": false,
+    "overrideReferences": false,
+    "precompiledReferences": [],
+    "autoReferenced": true,
+    "defineConstraints": [],
+    "versionDefines": [],
+    "noEngineReferences": false
+}
\ No newline at end of file
diff --git a/Assets/Tests/Generators/Mirage.Tests.TestGenerators.asmdef.meta b/Assets/Tests/Generators/Mirage.Tests.TestGenerators.asmdef.meta
new file mode 100644
index 00000000000..00d6e730b00
--- /dev/null
+++ b/Assets/Tests/Generators/Mirage.Tests.TestGenerators.asmdef.meta
@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: d58bd1be3b2a645438017811c3ef3f73
+AssemblyDefinitionImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generators/README.MD b/Assets/Tests/Generators/README.MD
new file mode 100644
index 00000000000..5317763a8ab
--- /dev/null
+++ b/Assets/Tests/Generators/README.MD
@@ -0,0 +1 @@
+These scripts create tests file from template files. This allows many tests that have similar logic to be created and maintained more easily.
\ No newline at end of file
diff --git a/Assets/Tests/Generators/README.MD.meta b/Assets/Tests/Generators/README.MD.meta
new file mode 100644
index 00000000000..422f5e5df00
--- /dev/null
+++ b/Assets/Tests/Generators/README.MD.meta
@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: e95babff3aec6204496e13373c5e5785
+TextScriptImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Weaver/BitAttributeTests.cs b/Assets/Tests/Weaver/BitAttributeTests.cs
new file mode 100644
index 00000000000..326b4ee339c
--- /dev/null
+++ b/Assets/Tests/Weaver/BitAttributeTests.cs
@@ -0,0 +1,59 @@
+using NUnit.Framework;
+
+namespace Mirage.Weaver
+{
+    public class BitAttributeTests : TestsBuildFromTestName
+    {
+        [Test]
+        public void BitCount()
+        {
+            IsSuccess();
+        }
+
+        [Test]
+        public void BitCountOverTypeSize()
+        {
+            HasErrorCount(13);
+
+            HasError("BitCount can not be above target type size, bitCount:9, type:Byte, max size:8",
+                "System.Byte BitAttributeTests.BitCountOverTypeSize.MyBehaviour::value1");
+
+            HasError("BitCount can not be above target type size, bitCount:17, type:Int16, max size:16",
+                "System.Int16 BitAttributeTests.BitCountOverTypeSize.MyBehaviour::value2");
+
+            HasError("BitCount can not be above target type size, bitCount:17, type:UInt16, max size:16",
+                "System.UInt16 BitAttributeTests.BitCountOverTypeSize.MyBehaviour::value3");
+
+            HasError("BitCount can not be above target type size, bitCount:33, type:Int32, max size:32",
+                "System.Int32 BitAttributeTests.BitCountOverTypeSize.MyBehaviour::value4");
+
+            HasError("BitCount can not be above target type size, bitCount:33, type:UInt32, max size:32",
+                "System.UInt32 BitAttributeTests.BitCountOverTypeSize.MyBehaviour::value5");
+
+            HasError("BitCount can not be above target type size, bitCount:65, type:Int64, max size:64",
+                "System.Int64 BitAttributeTests.BitCountOverTypeSize.MyBehaviour::value6");
+
+            HasError("BitCount can not be above target type size, bitCount:65, type:UInt64, max size:64",
+                "System.UInt64 BitAttributeTests.BitCountOverTypeSize.MyBehaviour::value7");
+
+            HasError("BitCount can not be above target type size, bitCount:9, type:MyByteEnum, max size:8",
+                "BitAttributeTests.BitCountOverTypeSize.MyByteEnum BitAttributeTests.BitCountOverTypeSize.MyBehaviour::value8");
+
+            HasError("BitCount can not be above target type size, bitCount:17, type:MyShortEnum, max size:16",
+                "BitAttributeTests.BitCountOverTypeSize.MyShortEnum BitAttributeTests.BitCountOverTypeSize.MyBehaviour::value9");
+
+            HasError("BitCount can not be above target type size, bitCount:33, type:MyIntEnum, max size:32",
+                "BitAttributeTests.BitCountOverTypeSize.MyIntEnum BitAttributeTests.BitCountOverTypeSize.MyBehaviour::value10");
+
+
+            HasError("UnityEngine.Vector3 is not a supported type for [BitCount]",
+                "UnityEngine.Vector3 BitAttributeTests.BitCountOverTypeSize.MyBehaviour::value11");
+
+            HasError("BitCount should be above 0",
+                "System.Int32 BitAttributeTests.BitCountOverTypeSize.MyBehaviour::value12");
+
+            HasError("BitCount should be above 0",
+                "System.Int32 BitAttributeTests.BitCountOverTypeSize.MyBehaviour::value13");
+        }
+    }
+}
diff --git a/Assets/Tests/Weaver/BitAttributeTests.cs.meta b/Assets/Tests/Weaver/BitAttributeTests.cs.meta
new file mode 100644
index 00000000000..4873e55a264
--- /dev/null
+++ b/Assets/Tests/Weaver/BitAttributeTests.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 98aca615f3f650a42bcf5ec505b26b5f
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Weaver/BitAttributeTests~/BitCount.cs b/Assets/Tests/Weaver/BitAttributeTests~/BitCount.cs
new file mode 100644
index 00000000000..8caf01d6019
--- /dev/null
+++ b/Assets/Tests/Weaver/BitAttributeTests~/BitCount.cs
@@ -0,0 +1,57 @@
+using Mirage;
+using Mirage.Serialization;
+
+namespace BitAttributeTests.BitCountOverTypeSize
+{
+    // should expect 1 error per field
+    public class MyBehaviour : NetworkBehaviour
+    {
+        [BitCount(5)]
+        [SyncVar] public byte value1;
+
+        [BitCount(10)]
+        [SyncVar] public short value2;
+
+        [BitCount(9)]
+        [SyncVar] public ushort value3;
+
+        [BitCount(20)]
+        [SyncVar] public int value4;
+
+        [BitCount(10)]
+        [SyncVar] public uint value5;
+
+        [BitCount(48)]
+        [SyncVar] public long value6;
+
+        [BitCount(5)]
+        [SyncVar] public ulong value7;
+
+        [BitCount(3)]
+        [SyncVar] public MyByteEnum value8;
+
+        [BitCount(10)]
+        [SyncVar] public MyShortEnum value9;
+
+        [BitCount(5)]
+        [SyncVar] public MyIntEnum value10;
+    }
+
+    public enum MyIntEnum
+    {
+        none = 0,
+        value = 1,
+    }
+
+    public enum MyShortEnum : ushort
+    {
+        none = 0,
+        value = 1,
+    }
+
+    public enum MyByteEnum : byte
+    {
+        none = 0,
+        value = 1,
+    }
+}
\ No newline at end of file
diff --git a/Assets/Tests/Weaver/BitAttributeTests~/BitCountOverTypeSize.cs b/Assets/Tests/Weaver/BitAttributeTests~/BitCountOverTypeSize.cs
new file mode 100644
index 00000000000..4dda117cbca
--- /dev/null
+++ b/Assets/Tests/Weaver/BitAttributeTests~/BitCountOverTypeSize.cs
@@ -0,0 +1,66 @@
+using Mirage;
+using Mirage.Serialization;
+
+namespace BitAttributeTests.BitCountOverTypeSize
+{
+    // should expect 1 error per field
+    public class MyBehaviour : NetworkBehaviour
+    {
+        [BitCount(9)]
+        [SyncVar] public byte value1;
+
+        [BitCount(17)]
+        [SyncVar] public short value2;
+
+        [BitCount(17)]
+        [SyncVar] public ushort value3;
+
+        [BitCount(33)]
+        [SyncVar] public int value4;
+
+        [BitCount(33)]
+        [SyncVar] public uint value5;
+
+        [BitCount(65)]
+        [SyncVar] public long value6;
+
+        [BitCount(65)]
+        [SyncVar] public ulong value7;
+
+        [BitCount(9)]
+        [SyncVar] public MyByteEnum value8;
+
+        [BitCount(17)]
+        [SyncVar] public MyShortEnum value9;
+
+        [BitCount(33)]
+        [SyncVar] public MyIntEnum value10;
+
+        [BitCount(20)]
+        [SyncVar] public UnityEngine.Vector3 value11;
+
+        [BitCount(0)]
+        [SyncVar] public int value12;
+
+        [BitCount(-1)]
+        [SyncVar] public int value13;
+    }
+
+    public enum MyIntEnum
+    {
+        none = 0,
+        value = 1,
+    }
+
+    public enum MyShortEnum : ushort
+    {
+        none = 0,
+        value = 1,
+    }
+
+    public enum MyByteEnum : byte
+    {
+        none = 0,
+        value = 1,
+    }
+}
\ No newline at end of file
diff --git a/Assets/Tests/Weaver/Tests.cs b/Assets/Tests/Weaver/Tests.cs
index c94d3bfd283..7d0fa735dcf 100644
--- a/Assets/Tests/Weaver/Tests.cs
+++ b/Assets/Tests/Weaver/Tests.cs
@@ -24,23 +24,57 @@ public virtual void TestSetup()
         [AssertionMethod]
         protected void IsSuccess()
         {
-            Assert.That(weaverLog.Diagnostics, Is.Empty, $"Failed because there are Diagnostics message: \n  {string.Join("\n  ", weaverLog.Diagnostics.Select(x => x.MessageData))}\n");
+            Assert.That(weaverLog.Diagnostics, Is.Empty, $"Failed because there are Diagnostics messages: \n  {string.Join("\n  ", weaverLog.Diagnostics.Select(x => x.MessageData))}\n");
+        }
+
+        /// <summary>
+        /// Like <see cref="IsSuccess"/> but doesn't fail if there are warnings
+        /// </summary>
+        [AssertionMethod]
+        protected void NoErrors()
+        {
+            DiagnosticMessage[] errors = weaverLog.Diagnostics.Where(x => x.DiagnosticType == DiagnosticType.Error).ToArray();
+            Assert.That(errors, Is.Empty, $"Failed because there are Error messages: \n  {string.Join("\n  ", errors.Select(d => d.MessageData))}\n");
+        }
+
+        [AssertionMethod]
+        protected void HasErrorCount(int count)
+        {
+            string[] errorMessages = weaverLog.Diagnostics
+                .Where(d => d.DiagnosticType == DiagnosticType.Error)
+                .Select(d => d.MessageData).ToArray();
+
+            Assert.That(errorMessages.Length, Is.EqualTo(count), $"Error messages: \n  {string.Join("\n  ", errorMessages)}\n");
         }
 
         [AssertionMethod]
         protected void HasError(string messsage, string atType)
         {
-            Assert.That(weaverLog.Diagnostics
+            string fullMessage = $"{messsage} (at {atType})";
+            string[] errorMessages = weaverLog.Diagnostics
                 .Where(d => d.DiagnosticType == DiagnosticType.Error)
-                .Select(d => d.MessageData), Contains.Item($"{messsage} (at {atType})"));
+                .Select(d => d.MessageData).ToArray();
+
+            Assert.That(errorMessages, Contains.Item(fullMessage),
+                $"Could not find error message in list\n" +
+                $"  Message: \n    {fullMessage}\n" +
+                $"  Errors: \n    {string.Join("\n    ", errorMessages)}\n"
+                );
         }
 
         [AssertionMethod]
         protected void HasWarning(string messsage, string atType)
         {
-            Assert.That(weaverLog.Diagnostics
+            string fullMessage = $"{messsage} (at {atType})";
+            string[] warningMessages = weaverLog.Diagnostics
                 .Where(d => d.DiagnosticType == DiagnosticType.Warning)
-                .Select(d => d.MessageData), Contains.Item($"{messsage} (at {atType})"));
+                .Select(d => d.MessageData).ToArray();
+
+            Assert.That(warningMessages, Contains.Item(fullMessage),
+                $"Could not find warning message in list\n" +
+                $"  Message: \n    {fullMessage}\n" +
+                $"  Warings: \n    {string.Join("\n    ", warningMessages)}\n"
+                );
         }
     }
 

From c737c649536052423c54c3a87f8a4ff80a085cd9 Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Sun, 22 Aug 2021 17:15:42 +0000
Subject: [PATCH 135/166] chore(release): 101.6.0 [skip ci]

# [101.6.0](https://github.com/MirageNet/Mirage/compare/v101.5.1...v101.6.0) (2021-08-22)

### Features

* **serialization:** attribute to set bit size for ints base syncvars ([#882](https://github.com/MirageNet/Mirage/issues/882)) ([1660ca6](https://github.com/MirageNet/Mirage/commit/1660ca690bee0ef58e398d36511233ebd9975188))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs               | 2 +-
 Assets/Mirage/CHANGELOG.md                                 | 7 +++++++
 Assets/Mirage/Components/AssemblyInfo.cs                   | 2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                      | 2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs          | 2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs                     | 2 +-
 .../Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs      | 2 +-
 Assets/Mirage/package.json                                 | 2 +-
 8 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index f581acdcd0f..44bcd9a3738 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.5.1")]
+[assembly: AssemblyVersion("101.6.0")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index 0e1e59c181b..d550235aadb 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,10 @@
+# [101.6.0](https://github.com/MirageNet/Mirage/compare/v101.5.1...v101.6.0) (2021-08-22)
+
+
+### Features
+
+* **serialization:** attribute to set bit size for ints base syncvars ([#882](https://github.com/MirageNet/Mirage/issues/882)) ([1660ca6](https://github.com/MirageNet/Mirage/commit/1660ca690bee0ef58e398d36511233ebd9975188))
+
 ## [101.5.1](https://github.com/MirageNet/Mirage/compare/v101.5.0...v101.5.1) (2021-08-22)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index cff42398724..c70e197d567 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.5.1")]
+[assembly: AssemblyVersion("101.6.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index a54c4359f2d..be31376d30b 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.5.1")]
+[assembly: AssemblyVersion("101.6.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index 4302bc3d9aa..15835013383 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.5.1")]
+[assembly: AssemblyVersion("101.6.0")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index f581acdcd0f..44bcd9a3738 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.5.1")]
+[assembly: AssemblyVersion("101.6.0")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index f581acdcd0f..44bcd9a3738 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.5.1")]
+[assembly: AssemblyVersion("101.6.0")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 8cf0876de8b..0b1e28dc0f3 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "101.5.1",
+    "version": "101.6.0",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From 82d7e515aa82320c8d363fdbada10dfaabee3bcf Mon Sep 17 00:00:00 2001
From: uwee <uweenukr@gmail.com>
Date: Mon, 23 Aug 2021 10:20:41 -0400
Subject: [PATCH 136/166] refactor: test use existing fixtures (#901)

---
 .../Runtime/NetworkIdentityCallbackTests.cs   | 20 +++++--------------
 1 file changed, 5 insertions(+), 15 deletions(-)

diff --git a/Assets/Tests/Runtime/NetworkIdentityCallbackTests.cs b/Assets/Tests/Runtime/NetworkIdentityCallbackTests.cs
index fd0391f1344..5415f031941 100644
--- a/Assets/Tests/Runtime/NetworkIdentityCallbackTests.cs
+++ b/Assets/Tests/Runtime/NetworkIdentityCallbackTests.cs
@@ -1,4 +1,5 @@
 using System.Collections.Generic;
+using Mirage.Tests.Runtime.ClientServer;
 using NSubstitute;
 using NUnit.Framework;
 using UnityEngine;
@@ -7,7 +8,7 @@
 
 namespace Mirage.Tests.Runtime
 {
-    public class NetworkIdentityCallbackTests
+    public class NetworkIdentityCallbackTests : ClientServerSetup<MockComponent>
     {
         #region test components
         class RebuildEmptyObserversNetworkBehaviour : NetworkVisibility
@@ -21,23 +22,13 @@ class RebuildEmptyObserversNetworkBehaviour : NetworkVisibility
 
         GameObject gameObject;
         NetworkIdentity identity;
-        private NetworkServer server;
-        private ServerObjectManager serverObjectManager;
-        private NetworkClient client;
-        private GameObject networkServerGameObject;
 
         INetworkPlayer player1;
         INetworkPlayer player2;
 
         [SetUp]
-        public void SetUp()
+        public override void ExtraSetup()
         {
-            networkServerGameObject = new GameObject();
-            server = networkServerGameObject.AddComponent<NetworkServer>();
-            serverObjectManager = networkServerGameObject.AddComponent<ServerObjectManager>();
-            serverObjectManager.Server = server;
-            client = networkServerGameObject.AddComponent<NetworkClient>();
-
             gameObject = new GameObject();
             identity = gameObject.AddComponent<NetworkIdentity>();
             identity.Server = server;
@@ -48,12 +39,11 @@ public void SetUp()
         }
 
         [TearDown]
-        public void TearDown()
+        public override void ExtraTearDown()
         {
             // set isServer is false. otherwise Destroy instead of
             // DestroyImmediate is called internally, giving an error in Editor
             Object.DestroyImmediate(gameObject);
-            Object.DestroyImmediate(networkServerGameObject);
         }
 
 
@@ -77,7 +67,7 @@ public void AddAllReadyServerConnectionsToObservers()
 
             // add all to observers. should have the two ready connections then.
             identity.AddAllReadyServerConnectionsToObservers();
-            Assert.That(identity.observers, Is.EquivalentTo(new[] { player1, server.LocalPlayer }));
+            Assert.That(identity.observers, Is.EquivalentTo(new[] { player1, server.LocalPlayer, serverPlayer }));
 
             // clean up
             server.Stop();

From ccef5fb0302ff97d897f17698e53967e014a9a95 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Tue, 24 Aug 2021 14:07:32 +0100
Subject: [PATCH 137/166] feat: attributes to use zig zag encoding (#897)

* feat: attributes to use zig zag encoding

* setting up tests and bitcountfinder

* fixing weaver tests

* fixxing tests

* implementing read/write for zigzagencode

* updating tests

* updating template
---
 .../Runtime/Serialization/WeaverAttributes.cs | 11 ++-
 .../Weaver/Processors/SyncVarProcessor.cs     | 29 +++++++
 .../Processors/SyncVars/BitCountFinder.cs     |  2 +-
 .../Processors/SyncVars/FoundSyncVar.cs       |  5 +-
 .../Processors/SyncVars/ZigZagFinder.cs       | 43 ++++++++++
 .../Processors/SyncVars/ZigZagFinder.cs.meta  | 11 +++
 Assets/Mirage/Weaver/WeaverExceptions.cs      |  4 +
 .../BitCountBehaviour_MyByteEnum_4.cs         | 16 +++-
 .../BitCountBehaviour_MyEnum_4.cs             | 16 +++-
 .../BitCountTests/BitCountBehaviour_int_10.cs | 16 +++-
 .../BitCountTests/BitCountBehaviour_int_17.cs | 16 +++-
 .../BitCountTests/BitCountBehaviour_int_32.cs | 16 +++-
 .../BitCountBehaviour_short_12.cs             | 16 +++-
 .../BitCountBehaviour_short_4.cs              | 16 +++-
 .../BitCountBehaviour_ulong_24.cs             | 16 +++-
 .../BitCountBehaviour_ulong_5.cs              | 16 +++-
 .../BitCountBehaviour_ulong_64.cs             | 16 +++-
 Assets/Tests/Generated/ZigZagTests.meta       |  8 ++
 .../ZigZagBehaviour_MyEnum2_4_negative.cs     | 81 +++++++++++++++++++
 ...ZigZagBehaviour_MyEnum2_4_negative.cs.meta | 11 +++
 .../ZigZagTests/ZigZagBehaviour_MyEnum_4.cs   | 81 +++++++++++++++++++
 .../ZigZagBehaviour_MyEnum_4.cs.meta          | 11 +++
 .../ZigZagTests/ZigZagBehaviour_int_10.cs     | 75 +++++++++++++++++
 .../ZigZagBehaviour_int_10.cs.meta            | 11 +++
 .../ZigZagBehaviour_int_10_negative.cs        | 75 +++++++++++++++++
 .../ZigZagBehaviour_int_10_negative.cs.meta   | 11 +++
 .../ZigZagTests/ZigZagBehaviour_long_10.cs    | 75 +++++++++++++++++
 .../ZigZagBehaviour_long_10.cs.meta           | 11 +++
 .../ZigZagBehaviour_long_10_negative.cs       | 75 +++++++++++++++++
 .../ZigZagBehaviour_long_10_negative.cs.meta  | 11 +++
 .../ZigZagTests/ZigZagBehaviour_short_10.cs   | 75 +++++++++++++++++
 .../ZigZagBehaviour_short_10.cs.meta          | 11 +++
 .../ZigZagBehaviour_short_10_negative.cs      | 75 +++++++++++++++++
 .../ZigZagBehaviour_short_10_negative.cs.meta | 11 +++
 .../Generators/.BitCountTestTemplate.txt      | 16 +++-
 .../Tests/Generators/.ZigzagTestTemplate.txt  | 75 +++++++++++++++++
 .../Tests/Generators/BitCountTestGenerator.cs |  2 +-
 .../Tests/Generators/ZigZagTestGenerator.cs   | 52 ++++++++++++
 .../Generators/ZigZagTestGenerator.cs.meta    | 11 +++
 Assets/Tests/Weaver/BitAttributeTests.cs      | 21 +++++
 .../Weaver/BitAttributeTests~/BitCount.cs     |  2 +-
 .../Tests/Weaver/BitAttributeTests~/ZigZag.cs | 30 +++++++
 .../BitAttributeTests~/ZigZagNoBitCount.cs    | 27 +++++++
 43 files changed, 1171 insertions(+), 38 deletions(-)
 create mode 100644 Assets/Mirage/Weaver/Processors/SyncVars/ZigZagFinder.cs
 create mode 100644 Assets/Mirage/Weaver/Processors/SyncVars/ZigZagFinder.cs.meta
 create mode 100644 Assets/Tests/Generated/ZigZagTests.meta
 create mode 100644 Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_MyEnum2_4_negative.cs
 create mode 100644 Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_MyEnum2_4_negative.cs.meta
 create mode 100644 Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_MyEnum_4.cs
 create mode 100644 Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_MyEnum_4.cs.meta
 create mode 100644 Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_int_10.cs
 create mode 100644 Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_int_10.cs.meta
 create mode 100644 Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_int_10_negative.cs
 create mode 100644 Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_int_10_negative.cs.meta
 create mode 100644 Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_long_10.cs
 create mode 100644 Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_long_10.cs.meta
 create mode 100644 Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_long_10_negative.cs
 create mode 100644 Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_long_10_negative.cs.meta
 create mode 100644 Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_short_10.cs
 create mode 100644 Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_short_10.cs.meta
 create mode 100644 Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_short_10_negative.cs
 create mode 100644 Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_short_10_negative.cs.meta
 create mode 100644 Assets/Tests/Generators/.ZigzagTestTemplate.txt
 create mode 100644 Assets/Tests/Generators/ZigZagTestGenerator.cs
 create mode 100644 Assets/Tests/Generators/ZigZagTestGenerator.cs.meta
 create mode 100644 Assets/Tests/Weaver/BitAttributeTests~/ZigZag.cs
 create mode 100644 Assets/Tests/Weaver/BitAttributeTests~/ZigZagNoBitCount.cs

diff --git a/Assets/Mirage/Runtime/Serialization/WeaverAttributes.cs b/Assets/Mirage/Runtime/Serialization/WeaverAttributes.cs
index 1294af11fe1..be370564b24 100644
--- a/Assets/Mirage/Runtime/Serialization/WeaverAttributes.cs
+++ b/Assets/Mirage/Runtime/Serialization/WeaverAttributes.cs
@@ -12,7 +12,7 @@ public sealed class WeaverIgnoreAttribute : Attribute { }
     /// Tells weaver how many bits to sue for field
     /// <para>Only works with interager fields (byte, int, ulong, enums etc)</para>
     /// <para>
-    /// NOTE: bits are truncated when using this, so signed values will lose their sign.
+    /// NOTE: bits are truncated when using this, so signed values will lose their sign. Use <see cref="ZigZagEncodeAttribute"/> as well if value might be negative
     /// </para>
     /// </summary>
     [AttributeUsage(AttributeTargets.Field | AttributeTargets.Parameter)]
@@ -32,4 +32,13 @@ public BitCountAttribute(int bitCount)
             BitCount = bitCount;
         }
     }
+
+    /// <summary>
+    /// Used along size <see cref="BitCountAttribute"/> to encodes a interager value using <see cref="ZigZag"/> so that both positive and negative values can be sent
+    /// </summary>
+    [AttributeUsage(AttributeTargets.Field | AttributeTargets.Parameter)]
+    public class ZigZagEncodeAttribute : Attribute
+    {
+        public ZigZagEncodeAttribute() { }
+    }
 }
diff --git a/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs b/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
index 487ab6e1637..638b727c9f3 100644
--- a/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
@@ -456,10 +456,25 @@ void WriteWithBitCount()
                 worker.Append(worker.Create(OpCodes.Ldarg, writerParameter));
                 worker.Append(worker.Create(OpCodes.Ldarg_0));
                 worker.Append(worker.Create(OpCodes.Ldfld, syncVar.FieldDefinition.MakeHostGenericIfNeeded()));
+
+                if (syncVar.UseZigZagEncoding)
+                {
+                    WriteZigZag();
+                }
+
                 worker.Append(worker.Create(OpCodes.Conv_U8));
                 worker.Append(worker.Create(OpCodes.Ldc_I4, syncVar.BitCount.Value));
                 worker.Append(worker.Create(OpCodes.Call, writeWithBitCount));
             }
+            void WriteZigZag()
+            {
+                bool useLong = syncVar.FieldDefinition.FieldType.Is<long>();
+                MethodReference encode = useLong
+                    ? module.ImportReference((long v) => ZigZag.Encode(v))
+                    : module.ImportReference((int v) => ZigZag.Encode(v));
+
+                worker.Append(worker.Create(OpCodes.Call, encode));
+            }
         }
 
 
@@ -622,8 +637,22 @@ void ReadWithBitCount()
                     worker.Append(worker.Create(syncVar.BitCountConvert.Value));
                 }
 
+                if (syncVar.UseZigZagEncoding)
+                {
+                    ReadZigZag();
+                }
+
                 worker.Append(worker.Create(OpCodes.Stfld, syncVar.FieldDefinition.MakeHostGenericIfNeeded()));
             }
+            void ReadZigZag()
+            {
+                bool useLong = syncVar.FieldDefinition.FieldType.Is<long>();
+                MethodReference encode = useLong
+                    ? module.ImportReference((ulong v) => ZigZag.Decode(v))
+                    : module.ImportReference((uint v) => ZigZag.Decode(v));
+
+                worker.Append(worker.Create(OpCodes.Call, encode));
+            }
         }
     }
 }
diff --git a/Assets/Mirage/Weaver/Processors/SyncVars/BitCountFinder.cs b/Assets/Mirage/Weaver/Processors/SyncVars/BitCountFinder.cs
index 3f087630c8f..8135788bdb4 100644
--- a/Assets/Mirage/Weaver/Processors/SyncVars/BitCountFinder.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncVars/BitCountFinder.cs
@@ -1,4 +1,4 @@
-using Mirage.Serialization;
+using Mirage.Serialization;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
 
diff --git a/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs b/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs
index 4dc31edddd1..ab4db519780 100644
--- a/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs
@@ -25,7 +25,9 @@ public FoundSyncVar(FieldDefinition fieldDefinition, int dirtyIndex)
         public MethodDefinition HookMethod { get; private set; }
 
         public int? BitCount { get; private set; }
-        public OpCode? BitCountConvert { get; internal set; }
+        public OpCode? BitCountConvert { get; private set; }
+
+        public bool UseZigZagEncoding { get; private set; }
 
         public MethodReference WriteFunction { get; private set; }
         public MethodReference ReadFunction { get; private set; }
@@ -82,6 +84,7 @@ public void ProcessAttributes()
             HasHookMethod = HookMethod != null;
 
             (BitCount, BitCountConvert) = BitCountFinder.GetBitCount(FieldDefinition);
+            UseZigZagEncoding = ZigZagFinder.HasZigZag(FieldDefinition, BitCount.HasValue);
         }
 
         public void FindSerializeFunctions(Writers writers, Readers readers)
diff --git a/Assets/Mirage/Weaver/Processors/SyncVars/ZigZagFinder.cs b/Assets/Mirage/Weaver/Processors/SyncVars/ZigZagFinder.cs
new file mode 100644
index 00000000000..ac85197a09e
--- /dev/null
+++ b/Assets/Mirage/Weaver/Processors/SyncVars/ZigZagFinder.cs
@@ -0,0 +1,43 @@
+using Mirage.Serialization;
+using Mono.Cecil;
+
+namespace Mirage.Weaver.SyncVars
+{
+    public static class ZigZagFinder
+    {
+        public static bool HasZigZag(FieldDefinition syncVar, bool hasBitCount)
+        {
+            bool hasAttribute = syncVar.HasCustomAttribute<ZigZagEncodeAttribute>();
+            if (!hasAttribute)
+                return false;
+
+            if (!hasBitCount)
+                throw new ZigZagException($"[ZigZagEncode] can only be used with [BitCount]", syncVar);
+
+            ThrowIfUnsignedType(syncVar.FieldType, syncVar);
+            return true;
+        }
+
+        /// <summary>
+        /// Any Int or enum based type is valid
+        /// </summary>
+        /// <param name="type"></param>
+        /// <param name="syncVar"></param>
+        static void ThrowIfUnsignedType(TypeReference type, FieldDefinition syncVar)
+        {
+            // throw if unsigned
+            if (type.Is<byte>()
+             || type.Is<ushort>()
+             || type.Is<uint>()
+             || type.Is<ulong>())
+                throw new ZigZagException($"[ZigZagEncode] can only be used on a signed type", syncVar);
+
+            if (type.Resolve().IsEnum)
+            {
+                // check underlying field is signed
+                TypeReference enumType = type.Resolve().GetEnumUnderlyingType();
+                ThrowIfUnsignedType(enumType, syncVar);
+            }
+        }
+    }
+}
diff --git a/Assets/Mirage/Weaver/Processors/SyncVars/ZigZagFinder.cs.meta b/Assets/Mirage/Weaver/Processors/SyncVars/ZigZagFinder.cs.meta
new file mode 100644
index 00000000000..1de0c4343ce
--- /dev/null
+++ b/Assets/Mirage/Weaver/Processors/SyncVars/ZigZagFinder.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 2850309dac2d1b6449117002259e889d
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Weaver/WeaverExceptions.cs b/Assets/Mirage/Weaver/WeaverExceptions.cs
index 7360515dd0c..d0d2bfcc74b 100644
--- a/Assets/Mirage/Weaver/WeaverExceptions.cs
+++ b/Assets/Mirage/Weaver/WeaverExceptions.cs
@@ -43,4 +43,8 @@ internal class BitCountException : SyncVarException
     {
         public BitCountException(string message, MemberReference memberReference) : base(message, memberReference) { }
     }
+    internal class ZigZagException : SyncVarException
+    {
+        public ZigZagException(string message, MemberReference memberReference) : base(message, memberReference) { }
+    }
 }
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_MyByteEnum_4.cs b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_MyByteEnum_4.cs
index 3c1b76eedff..a39bbee2c3e 100644
--- a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_MyByteEnum_4.cs
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_MyByteEnum_4.cs
@@ -5,6 +5,7 @@
 using Mirage.Serialization;
 using Mirage.Tests.Runtime.ClientServer;
 using NUnit.Framework;
+using UnityEngine;
 using UnityEngine.TestTools;
 
 namespace Mirage.Tests.Runtime.Generated.BitCountAttributeTests
@@ -33,16 +34,26 @@ public void RpcSomeFunction([BitCount(4)] MyByteEnum myParam)
     }
     public class BitCountTest_MyByteEnum_4 : ClientServerSetup<BitCountBehaviour_MyByteEnum_4>
     {
+        const MyByteEnum value = (MyByteEnum)3;
+
         [Test]
         public void SyncVarIsBitPacked()
         {
-            var behaviour = new BitCountBehaviour_MyByteEnum_4();
+            serverComponent.myValue = value;
 
             using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
             {
-                behaviour.SerializeSyncVars(writer, true);
+                serverComponent.SerializeSyncVars(writer, true);
 
                 Assert.That(writer.BitPosition, Is.EqualTo(4));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(4));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
             }
         }
 
@@ -50,7 +61,6 @@ public void SyncVarIsBitPacked()
         // [Ignore("Rpc not supported yet")]
         public IEnumerator RpcIsBitPacked()
         {
-            const MyByteEnum value = (MyByteEnum)3;
 
             int called = 0;
             clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_MyEnum_4.cs b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_MyEnum_4.cs
index 8f230b0bd14..88bc3ddd003 100644
--- a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_MyEnum_4.cs
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_MyEnum_4.cs
@@ -5,6 +5,7 @@
 using Mirage.Serialization;
 using Mirage.Tests.Runtime.ClientServer;
 using NUnit.Framework;
+using UnityEngine;
 using UnityEngine.TestTools;
 
 namespace Mirage.Tests.Runtime.Generated.BitCountAttributeTests
@@ -33,16 +34,26 @@ public void RpcSomeFunction([BitCount(4)] MyEnum myParam)
     }
     public class BitCountTest_MyEnum_4 : ClientServerSetup<BitCountBehaviour_MyEnum_4>
     {
+        const MyEnum value = (MyEnum)3;
+
         [Test]
         public void SyncVarIsBitPacked()
         {
-            var behaviour = new BitCountBehaviour_MyEnum_4();
+            serverComponent.myValue = value;
 
             using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
             {
-                behaviour.SerializeSyncVars(writer, true);
+                serverComponent.SerializeSyncVars(writer, true);
 
                 Assert.That(writer.BitPosition, Is.EqualTo(4));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(4));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
             }
         }
 
@@ -50,7 +61,6 @@ public void SyncVarIsBitPacked()
         // [Ignore("Rpc not supported yet")]
         public IEnumerator RpcIsBitPacked()
         {
-            const MyEnum value = (MyEnum)3;
 
             int called = 0;
             clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_10.cs b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_10.cs
index 5535653fdbc..8de9bb7281d 100644
--- a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_10.cs
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_10.cs
@@ -5,6 +5,7 @@
 using Mirage.Serialization;
 using Mirage.Tests.Runtime.ClientServer;
 using NUnit.Framework;
+using UnityEngine;
 using UnityEngine.TestTools;
 
 namespace Mirage.Tests.Runtime.Generated.BitCountAttributeTests
@@ -25,16 +26,26 @@ public void RpcSomeFunction([BitCount(10)] int myParam)
     }
     public class BitCountTest_int_10 : ClientServerSetup<BitCountBehaviour_int_10>
     {
+        const int value = 20;
+
         [Test]
         public void SyncVarIsBitPacked()
         {
-            var behaviour = new BitCountBehaviour_int_10();
+            serverComponent.myValue = value;
 
             using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
             {
-                behaviour.SerializeSyncVars(writer, true);
+                serverComponent.SerializeSyncVars(writer, true);
 
                 Assert.That(writer.BitPosition, Is.EqualTo(10));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(10));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
             }
         }
 
@@ -42,7 +53,6 @@ public void SyncVarIsBitPacked()
         // [Ignore("Rpc not supported yet")]
         public IEnumerator RpcIsBitPacked()
         {
-            const int value = 20;
 
             int called = 0;
             clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_17.cs b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_17.cs
index b8fac129964..9f6a18556ff 100644
--- a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_17.cs
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_17.cs
@@ -5,6 +5,7 @@
 using Mirage.Serialization;
 using Mirage.Tests.Runtime.ClientServer;
 using NUnit.Framework;
+using UnityEngine;
 using UnityEngine.TestTools;
 
 namespace Mirage.Tests.Runtime.Generated.BitCountAttributeTests
@@ -25,16 +26,26 @@ public void RpcSomeFunction([BitCount(17)] int myParam)
     }
     public class BitCountTest_int_17 : ClientServerSetup<BitCountBehaviour_int_17>
     {
+        const int value = 20;
+
         [Test]
         public void SyncVarIsBitPacked()
         {
-            var behaviour = new BitCountBehaviour_int_17();
+            serverComponent.myValue = value;
 
             using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
             {
-                behaviour.SerializeSyncVars(writer, true);
+                serverComponent.SerializeSyncVars(writer, true);
 
                 Assert.That(writer.BitPosition, Is.EqualTo(17));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(17));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
             }
         }
 
@@ -42,7 +53,6 @@ public void SyncVarIsBitPacked()
         // [Ignore("Rpc not supported yet")]
         public IEnumerator RpcIsBitPacked()
         {
-            const int value = 20;
 
             int called = 0;
             clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_32.cs b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_32.cs
index ba37312a6e7..4b26edd2aee 100644
--- a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_32.cs
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_int_32.cs
@@ -5,6 +5,7 @@
 using Mirage.Serialization;
 using Mirage.Tests.Runtime.ClientServer;
 using NUnit.Framework;
+using UnityEngine;
 using UnityEngine.TestTools;
 
 namespace Mirage.Tests.Runtime.Generated.BitCountAttributeTests
@@ -25,16 +26,26 @@ public void RpcSomeFunction([BitCount(32)] int myParam)
     }
     public class BitCountTest_int_32 : ClientServerSetup<BitCountBehaviour_int_32>
     {
+        const int value = 20;
+
         [Test]
         public void SyncVarIsBitPacked()
         {
-            var behaviour = new BitCountBehaviour_int_32();
+            serverComponent.myValue = value;
 
             using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
             {
-                behaviour.SerializeSyncVars(writer, true);
+                serverComponent.SerializeSyncVars(writer, true);
 
                 Assert.That(writer.BitPosition, Is.EqualTo(32));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(32));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
             }
         }
 
@@ -42,7 +53,6 @@ public void SyncVarIsBitPacked()
         // [Ignore("Rpc not supported yet")]
         public IEnumerator RpcIsBitPacked()
         {
-            const int value = 20;
 
             int called = 0;
             clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_short_12.cs b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_short_12.cs
index bf0a5812ad2..2cd71c925b1 100644
--- a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_short_12.cs
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_short_12.cs
@@ -5,6 +5,7 @@
 using Mirage.Serialization;
 using Mirage.Tests.Runtime.ClientServer;
 using NUnit.Framework;
+using UnityEngine;
 using UnityEngine.TestTools;
 
 namespace Mirage.Tests.Runtime.Generated.BitCountAttributeTests
@@ -25,16 +26,26 @@ public void RpcSomeFunction([BitCount(12)] short myParam)
     }
     public class BitCountTest_short_12 : ClientServerSetup<BitCountBehaviour_short_12>
     {
+        const short value = 20;
+
         [Test]
         public void SyncVarIsBitPacked()
         {
-            var behaviour = new BitCountBehaviour_short_12();
+            serverComponent.myValue = value;
 
             using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
             {
-                behaviour.SerializeSyncVars(writer, true);
+                serverComponent.SerializeSyncVars(writer, true);
 
                 Assert.That(writer.BitPosition, Is.EqualTo(12));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(12));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
             }
         }
 
@@ -42,7 +53,6 @@ public void SyncVarIsBitPacked()
         // [Ignore("Rpc not supported yet")]
         public IEnumerator RpcIsBitPacked()
         {
-            const short value = 20;
 
             int called = 0;
             clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_short_4.cs b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_short_4.cs
index 7216966f504..f87d4d81ee3 100644
--- a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_short_4.cs
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_short_4.cs
@@ -5,6 +5,7 @@
 using Mirage.Serialization;
 using Mirage.Tests.Runtime.ClientServer;
 using NUnit.Framework;
+using UnityEngine;
 using UnityEngine.TestTools;
 
 namespace Mirage.Tests.Runtime.Generated.BitCountAttributeTests
@@ -25,16 +26,26 @@ public void RpcSomeFunction([BitCount(4)] short myParam)
     }
     public class BitCountTest_short_4 : ClientServerSetup<BitCountBehaviour_short_4>
     {
+        const short value = 3;
+
         [Test]
         public void SyncVarIsBitPacked()
         {
-            var behaviour = new BitCountBehaviour_short_4();
+            serverComponent.myValue = value;
 
             using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
             {
-                behaviour.SerializeSyncVars(writer, true);
+                serverComponent.SerializeSyncVars(writer, true);
 
                 Assert.That(writer.BitPosition, Is.EqualTo(4));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(4));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
             }
         }
 
@@ -42,7 +53,6 @@ public void SyncVarIsBitPacked()
         // [Ignore("Rpc not supported yet")]
         public IEnumerator RpcIsBitPacked()
         {
-            const short value = 20;
 
             int called = 0;
             clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_24.cs b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_24.cs
index 827a72e1247..9b45887fb1b 100644
--- a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_24.cs
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_24.cs
@@ -5,6 +5,7 @@
 using Mirage.Serialization;
 using Mirage.Tests.Runtime.ClientServer;
 using NUnit.Framework;
+using UnityEngine;
 using UnityEngine.TestTools;
 
 namespace Mirage.Tests.Runtime.Generated.BitCountAttributeTests
@@ -25,16 +26,26 @@ public void RpcSomeFunction([BitCount(24)] ulong myParam)
     }
     public class BitCountTest_ulong_24 : ClientServerSetup<BitCountBehaviour_ulong_24>
     {
+        const ulong value = 20;
+
         [Test]
         public void SyncVarIsBitPacked()
         {
-            var behaviour = new BitCountBehaviour_ulong_24();
+            serverComponent.myValue = value;
 
             using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
             {
-                behaviour.SerializeSyncVars(writer, true);
+                serverComponent.SerializeSyncVars(writer, true);
 
                 Assert.That(writer.BitPosition, Is.EqualTo(24));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(24));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
             }
         }
 
@@ -42,7 +53,6 @@ public void SyncVarIsBitPacked()
         // [Ignore("Rpc not supported yet")]
         public IEnumerator RpcIsBitPacked()
         {
-            const ulong value = 20;
 
             int called = 0;
             clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_5.cs b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_5.cs
index e29fbe6742f..cfa249a7be7 100644
--- a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_5.cs
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_5.cs
@@ -5,6 +5,7 @@
 using Mirage.Serialization;
 using Mirage.Tests.Runtime.ClientServer;
 using NUnit.Framework;
+using UnityEngine;
 using UnityEngine.TestTools;
 
 namespace Mirage.Tests.Runtime.Generated.BitCountAttributeTests
@@ -25,16 +26,26 @@ public void RpcSomeFunction([BitCount(5)] ulong myParam)
     }
     public class BitCountTest_ulong_5 : ClientServerSetup<BitCountBehaviour_ulong_5>
     {
+        const ulong value = 20;
+
         [Test]
         public void SyncVarIsBitPacked()
         {
-            var behaviour = new BitCountBehaviour_ulong_5();
+            serverComponent.myValue = value;
 
             using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
             {
-                behaviour.SerializeSyncVars(writer, true);
+                serverComponent.SerializeSyncVars(writer, true);
 
                 Assert.That(writer.BitPosition, Is.EqualTo(5));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(5));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
             }
         }
 
@@ -42,7 +53,6 @@ public void SyncVarIsBitPacked()
         // [Ignore("Rpc not supported yet")]
         public IEnumerator RpcIsBitPacked()
         {
-            const ulong value = 20;
 
             int called = 0;
             clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
diff --git a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_64.cs b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_64.cs
index 7882bcb9141..9ca48769627 100644
--- a/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_64.cs
+++ b/Assets/Tests/Generated/BitCountTests/BitCountBehaviour_ulong_64.cs
@@ -5,6 +5,7 @@
 using Mirage.Serialization;
 using Mirage.Tests.Runtime.ClientServer;
 using NUnit.Framework;
+using UnityEngine;
 using UnityEngine.TestTools;
 
 namespace Mirage.Tests.Runtime.Generated.BitCountAttributeTests
@@ -25,16 +26,26 @@ public void RpcSomeFunction([BitCount(64)] ulong myParam)
     }
     public class BitCountTest_ulong_64 : ClientServerSetup<BitCountBehaviour_ulong_64>
     {
+        const ulong value = 20;
+
         [Test]
         public void SyncVarIsBitPacked()
         {
-            var behaviour = new BitCountBehaviour_ulong_64();
+            serverComponent.myValue = value;
 
             using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
             {
-                behaviour.SerializeSyncVars(writer, true);
+                serverComponent.SerializeSyncVars(writer, true);
 
                 Assert.That(writer.BitPosition, Is.EqualTo(64));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(64));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
             }
         }
 
@@ -42,7 +53,6 @@ public void SyncVarIsBitPacked()
         // [Ignore("Rpc not supported yet")]
         public IEnumerator RpcIsBitPacked()
         {
-            const ulong value = 20;
 
             int called = 0;
             clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
diff --git a/Assets/Tests/Generated/ZigZagTests.meta b/Assets/Tests/Generated/ZigZagTests.meta
new file mode 100644
index 00000000000..7405489ec7f
--- /dev/null
+++ b/Assets/Tests/Generated/ZigZagTests.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 21a2a3c1512fe0b42af86e8b54ba7a33
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_MyEnum2_4_negative.cs b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_MyEnum2_4_negative.cs
new file mode 100644
index 00000000000..a1411649410
--- /dev/null
+++ b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_MyEnum2_4_negative.cs
@@ -0,0 +1,81 @@
+// DO NOT EDIT: GENERATED BY ZigZagTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.ZigZagAttributeTests
+{
+    [System.Serializable]
+    public enum MyEnum2
+    {
+        Negative = -1,
+        Zero = 0,
+        Positive = 1,
+    }
+    public class ZigZagBehaviour_MyEnum2_4_negative : NetworkBehaviour
+    {
+        [BitCount(4), ZigZagEncode]
+        [SyncVar] public MyEnum2 myValue;
+
+        public event Action<MyEnum2> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCount(4), ZigZagEncode] MyEnum2 myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class ZigZagTest_MyEnum2_4_negative : ClientServerSetup<ZigZagBehaviour_MyEnum2_4_negative>
+    {
+        const MyEnum2 value = (MyEnum2)(-1);
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(4));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(4));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(1), $"4 bits is 1 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_MyEnum2_4_negative.cs.meta b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_MyEnum2_4_negative.cs.meta
new file mode 100644
index 00000000000..a43e72c5c8a
--- /dev/null
+++ b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_MyEnum2_4_negative.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 93d454d332b06d34589a44dc7704fa83
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_MyEnum_4.cs b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_MyEnum_4.cs
new file mode 100644
index 00000000000..6b43cc916c0
--- /dev/null
+++ b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_MyEnum_4.cs
@@ -0,0 +1,81 @@
+// DO NOT EDIT: GENERATED BY ZigZagTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.ZigZagAttributeTests
+{
+    [System.Serializable]
+    public enum MyEnum
+    {
+        Negative = -1,
+        Zero = 0,
+        Positive = 1,
+    }
+    public class ZigZagBehaviour_MyEnum_4 : NetworkBehaviour
+    {
+        [BitCount(4), ZigZagEncode]
+        [SyncVar] public MyEnum myValue;
+
+        public event Action<MyEnum> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCount(4), ZigZagEncode] MyEnum myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class ZigZagTest_MyEnum_4 : ClientServerSetup<ZigZagBehaviour_MyEnum_4>
+    {
+        const MyEnum value = (MyEnum)1;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(4));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(4));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(1), $"4 bits is 1 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_MyEnum_4.cs.meta b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_MyEnum_4.cs.meta
new file mode 100644
index 00000000000..0c652b659fb
--- /dev/null
+++ b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_MyEnum_4.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 8352249ab3b565e4daa89d65f9afb9ca
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_int_10.cs b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_int_10.cs
new file mode 100644
index 00000000000..333f4f88ee6
--- /dev/null
+++ b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_int_10.cs
@@ -0,0 +1,75 @@
+// DO NOT EDIT: GENERATED BY ZigZagTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.ZigZagAttributeTests
+{
+    
+    public class ZigZagBehaviour_int_10 : NetworkBehaviour
+    {
+        [BitCount(10), ZigZagEncode]
+        [SyncVar] public int myValue;
+
+        public event Action<int> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCount(10), ZigZagEncode] int myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class ZigZagTest_int_10 : ClientServerSetup<ZigZagBehaviour_int_10>
+    {
+        const int value = 100;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(10));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(10));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(2), $"10 bits is 2 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_int_10.cs.meta b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_int_10.cs.meta
new file mode 100644
index 00000000000..c31d6b6ab34
--- /dev/null
+++ b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_int_10.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 6acef4578f12518468496121bf1df8de
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_int_10_negative.cs b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_int_10_negative.cs
new file mode 100644
index 00000000000..6f718a31608
--- /dev/null
+++ b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_int_10_negative.cs
@@ -0,0 +1,75 @@
+// DO NOT EDIT: GENERATED BY ZigZagTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.ZigZagAttributeTests
+{
+    
+    public class ZigZagBehaviour_int_10_negative : NetworkBehaviour
+    {
+        [BitCount(10), ZigZagEncode]
+        [SyncVar] public int myValue;
+
+        public event Action<int> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCount(10), ZigZagEncode] int myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class ZigZagTest_int_10_negative : ClientServerSetup<ZigZagBehaviour_int_10_negative>
+    {
+        const int value = -25;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(10));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(10));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(2), $"10 bits is 2 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_int_10_negative.cs.meta b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_int_10_negative.cs.meta
new file mode 100644
index 00000000000..9176e8f0b2c
--- /dev/null
+++ b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_int_10_negative.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 42b348f9e44bab244878c17bfec84701
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_long_10.cs b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_long_10.cs
new file mode 100644
index 00000000000..09df8a04588
--- /dev/null
+++ b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_long_10.cs
@@ -0,0 +1,75 @@
+// DO NOT EDIT: GENERATED BY ZigZagTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.ZigZagAttributeTests
+{
+    
+    public class ZigZagBehaviour_long_10 : NetworkBehaviour
+    {
+        [BitCount(10), ZigZagEncode]
+        [SyncVar] public long myValue;
+
+        public event Action<long> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCount(10), ZigZagEncode] long myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class ZigZagTest_long_10 : ClientServerSetup<ZigZagBehaviour_long_10>
+    {
+        const long value = 14;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(10));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(10));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(2), $"10 bits is 2 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_long_10.cs.meta b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_long_10.cs.meta
new file mode 100644
index 00000000000..b5d11ac3119
--- /dev/null
+++ b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_long_10.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 172d661bb687b6d49a7ab94b3417bafc
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_long_10_negative.cs b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_long_10_negative.cs
new file mode 100644
index 00000000000..c36c5d9e52c
--- /dev/null
+++ b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_long_10_negative.cs
@@ -0,0 +1,75 @@
+// DO NOT EDIT: GENERATED BY ZigZagTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.ZigZagAttributeTests
+{
+    
+    public class ZigZagBehaviour_long_10_negative : NetworkBehaviour
+    {
+        [BitCount(10), ZigZagEncode]
+        [SyncVar] public long myValue;
+
+        public event Action<long> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCount(10), ZigZagEncode] long myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class ZigZagTest_long_10_negative : ClientServerSetup<ZigZagBehaviour_long_10_negative>
+    {
+        const long value = -30;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(10));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(10));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(2), $"10 bits is 2 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_long_10_negative.cs.meta b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_long_10_negative.cs.meta
new file mode 100644
index 00000000000..9ca75464db6
--- /dev/null
+++ b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_long_10_negative.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 43ae8061a6b6d9442a52e73c698b2cd4
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_short_10.cs b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_short_10.cs
new file mode 100644
index 00000000000..aba3f2af2b3
--- /dev/null
+++ b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_short_10.cs
@@ -0,0 +1,75 @@
+// DO NOT EDIT: GENERATED BY ZigZagTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.ZigZagAttributeTests
+{
+    
+    public class ZigZagBehaviour_short_10 : NetworkBehaviour
+    {
+        [BitCount(10), ZigZagEncode]
+        [SyncVar] public short myValue;
+
+        public event Action<short> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCount(10), ZigZagEncode] short myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class ZigZagTest_short_10 : ClientServerSetup<ZigZagBehaviour_short_10>
+    {
+        const short value = 15;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(10));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(10));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(2), $"10 bits is 2 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_short_10.cs.meta b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_short_10.cs.meta
new file mode 100644
index 00000000000..a956d669b9c
--- /dev/null
+++ b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_short_10.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: c026d578164f23c41a2419a1d42e07cc
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_short_10_negative.cs b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_short_10_negative.cs
new file mode 100644
index 00000000000..f4276a0da95
--- /dev/null
+++ b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_short_10_negative.cs
@@ -0,0 +1,75 @@
+// DO NOT EDIT: GENERATED BY ZigZagTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.ZigZagAttributeTests
+{
+    
+    public class ZigZagBehaviour_short_10_negative : NetworkBehaviour
+    {
+        [BitCount(10), ZigZagEncode]
+        [SyncVar] public short myValue;
+
+        public event Action<short> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCount(10), ZigZagEncode] short myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class ZigZagTest_short_10_negative : ClientServerSetup<ZigZagBehaviour_short_10_negative>
+    {
+        const short value = -20;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(10));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(10));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(2), $"10 bits is 2 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_short_10_negative.cs.meta b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_short_10_negative.cs.meta
new file mode 100644
index 00000000000..d1146b071b9
--- /dev/null
+++ b/Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_short_10_negative.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 08c0171828b97284c9b3caf4b2e128eb
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generators/.BitCountTestTemplate.txt b/Assets/Tests/Generators/.BitCountTestTemplate.txt
index d880543e0c8..45fb7acfc40 100644
--- a/Assets/Tests/Generators/.BitCountTestTemplate.txt
+++ b/Assets/Tests/Generators/.BitCountTestTemplate.txt
@@ -5,6 +5,7 @@ using System.Collections;
 using Mirage.Serialization;
 using Mirage.Tests.Runtime.ClientServer;
 using NUnit.Framework;
+using UnityEngine;
 using UnityEngine.TestTools;
 
 namespace Mirage.Tests.Runtime.Generated.BitCountAttributeTests
@@ -25,16 +26,26 @@ namespace Mirage.Tests.Runtime.Generated.BitCountAttributeTests
     }
     public class BitCountTest_%%TYPE%%_%%BIT_COUNT%% : ClientServerSetup<BitCountBehaviour_%%TYPE%%_%%BIT_COUNT%%>
     {
+        const %%TYPE%% value = %%EXTRA_VALUE%%;
+
         [Test]
         public void SyncVarIsBitPacked()
         {
-            var behaviour = new BitCountBehaviour_%%TYPE%%_%%BIT_COUNT%%();
+            serverComponent.myValue = value;
 
             using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
             {
-                behaviour.SerializeSyncVars(writer, true);
+                serverComponent.SerializeSyncVars(writer, true);
 
                 Assert.That(writer.BitPosition, Is.EqualTo(%%BIT_COUNT%%));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(%%BIT_COUNT%%));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
             }
         }
 
@@ -42,7 +53,6 @@ namespace Mirage.Tests.Runtime.Generated.BitCountAttributeTests
         // [Ignore("Rpc not supported yet")]
         public IEnumerator RpcIsBitPacked()
         {
-            const %%TYPE%% value = %%EXTRA_VALUE%%;
 
             int called = 0;
             clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
diff --git a/Assets/Tests/Generators/.ZigzagTestTemplate.txt b/Assets/Tests/Generators/.ZigzagTestTemplate.txt
new file mode 100644
index 00000000000..5cf6a71412e
--- /dev/null
+++ b/Assets/Tests/Generators/.ZigzagTestTemplate.txt
@@ -0,0 +1,75 @@
+// DO NOT EDIT: GENERATED BY ZigZagTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.ZigZagAttributeTests
+{
+    %%EXTRA_TYPE%%
+    public class ZigZagBehaviour_%%TYPE%%_%%BIT_COUNT%%%%EXTRA_NAME%% : NetworkBehaviour
+    {
+        [BitCount(%%BIT_COUNT%%), ZigZagEncode]
+        [SyncVar] public %%TYPE%% myValue;
+
+        public event Action<%%TYPE%%> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCount(%%BIT_COUNT%%), ZigZagEncode] %%TYPE%% myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class ZigZagTest_%%TYPE%%_%%BIT_COUNT%%%%EXTRA_NAME%% : ClientServerSetup<ZigZagBehaviour_%%TYPE%%_%%BIT_COUNT%%%%EXTRA_NAME%%>
+    {
+        const %%TYPE%% value = %%EXTRA_VALUE%%;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(%%BIT_COUNT%%));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(%%BIT_COUNT%%));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(%%PAYLOAD_SIZE%%), $"%%BIT_COUNT%% bits is %%PAYLOAD_SIZE%% bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generators/BitCountTestGenerator.cs b/Assets/Tests/Generators/BitCountTestGenerator.cs
index cb84913d308..8be647c188f 100644
--- a/Assets/Tests/Generators/BitCountTestGenerator.cs
+++ b/Assets/Tests/Generators/BitCountTestGenerator.cs
@@ -13,7 +13,7 @@ public static void CreateAll()
             Create(fromTemplate, "int", 10);
             Create(fromTemplate, "int", 17);
             Create(fromTemplate, "int", 32);
-            Create(fromTemplate, "short", 4);
+            Create(fromTemplate, "short", 4, "3");
             Create(fromTemplate, "short", 12);
             Create(fromTemplate, "ulong", 5);
             Create(fromTemplate, "ulong", 24);
diff --git a/Assets/Tests/Generators/ZigZagTestGenerator.cs b/Assets/Tests/Generators/ZigZagTestGenerator.cs
new file mode 100644
index 00000000000..d4da55ec5d4
--- /dev/null
+++ b/Assets/Tests/Generators/ZigZagTestGenerator.cs
@@ -0,0 +1,52 @@
+using JamesFrowen.SimpleCodeGen;
+using UnityEditor;
+using UnityEngine;
+
+namespace Mirage.Tests.CodeGenerators
+{
+    public static class ZigZagTestGenerator
+    {
+        [MenuItem("Tests Generators/ZigZag")]
+        public static void CreateAll()
+        {
+            var fromTemplate = new CreateFromTemplate("./Assets/Tests/Generators/.ZigZagTestTemplate.txt");
+            Create(fromTemplate, "short", extraValue: "15");
+            Create(fromTemplate, "short", extraValue: "-20", extraName: "_negative");
+            Create(fromTemplate, "int", extraValue: "100");
+            Create(fromTemplate, "int", extraValue: "-25", extraName: "_negative");
+            Create(fromTemplate, "long", extraValue: "14");
+            Create(fromTemplate, "long", extraValue: "-30", extraName: "_negative");
+
+            Create(fromTemplate, "MyEnum", 4, "(MyEnum)1",
+  @"[System.Serializable]
+    public enum MyEnum
+    {
+        Negative = -1,
+        Zero = 0,
+        Positive = 1,
+    }");
+            Create(fromTemplate, "MyEnum2", 4, "(MyEnum2)(-1)",
+  @"[System.Serializable]
+    public enum MyEnum2
+    {
+        Negative = -1,
+        Zero = 0,
+        Positive = 1,
+    }", extraName: "_negative");
+
+            AssetDatabase.Refresh();
+        }
+
+        private static void Create(CreateFromTemplate fromTemplate, string type, int bitCount = 10, string extraValue = "20", string extraType = "", string extraName = "")
+        {
+            fromTemplate.Replace("%%BIT_COUNT%%", bitCount);
+            fromTemplate.Replace("%%TYPE%%", type);
+            fromTemplate.Replace("%%PAYLOAD_SIZE%%", Mathf.CeilToInt(bitCount / 8f));
+            fromTemplate.Replace("%%EXTRA_TYPE%%", extraType);
+            fromTemplate.Replace("%%EXTRA_VALUE%%", extraValue);
+            fromTemplate.Replace("%%EXTRA_NAME%%", extraName);
+
+            fromTemplate.WriteToFile($"./Assets/Tests/Generated/ZigZagTests/ZigZagBehaviour_{type}_{bitCount}{extraName}.cs");
+        }
+    }
+}
diff --git a/Assets/Tests/Generators/ZigZagTestGenerator.cs.meta b/Assets/Tests/Generators/ZigZagTestGenerator.cs.meta
new file mode 100644
index 00000000000..0b67fd39d8a
--- /dev/null
+++ b/Assets/Tests/Generators/ZigZagTestGenerator.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: d0e468692e3a93748a6f22464211c89e
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Weaver/BitAttributeTests.cs b/Assets/Tests/Weaver/BitAttributeTests.cs
index 326b4ee339c..eb7b5ebd25e 100644
--- a/Assets/Tests/Weaver/BitAttributeTests.cs
+++ b/Assets/Tests/Weaver/BitAttributeTests.cs
@@ -55,5 +55,26 @@ public void BitCountOverTypeSize()
             HasError("BitCount should be above 0",
                 "System.Int32 BitAttributeTests.BitCountOverTypeSize.MyBehaviour::value13");
         }
+
+        [Test]
+        public void ZigZag()
+        {
+            IsSuccess();
+        }
+
+        [Test]
+        public void ZigZagNoBitCount()
+        {
+            HasErrorCount(3);
+
+            HasError("[ZigZagEncode] can only be used with [BitCount]",
+                "System.Int32 BitAttributeTests.ZigZagNoBitCount.MyBehaviour::value1");
+
+            HasError("[ZigZagEncode] can only be used on a signed type",
+                "System.UInt32 BitAttributeTests.ZigZagNoBitCount.MyBehaviour::value2");
+
+            HasError("[ZigZagEncode] can only be used on a signed type",
+                "BitAttributeTests.ZigZagNoBitCount.MyShortEnum BitAttributeTests.ZigZagNoBitCount.MyBehaviour::value3");
+        }
     }
 }
diff --git a/Assets/Tests/Weaver/BitAttributeTests~/BitCount.cs b/Assets/Tests/Weaver/BitAttributeTests~/BitCount.cs
index 8caf01d6019..04047c5f6e3 100644
--- a/Assets/Tests/Weaver/BitAttributeTests~/BitCount.cs
+++ b/Assets/Tests/Weaver/BitAttributeTests~/BitCount.cs
@@ -1,7 +1,7 @@
 using Mirage;
 using Mirage.Serialization;
 
-namespace BitAttributeTests.BitCountOverTypeSize
+namespace BitAttributeTests.BitCount
 {
     // should expect 1 error per field
     public class MyBehaviour : NetworkBehaviour
diff --git a/Assets/Tests/Weaver/BitAttributeTests~/ZigZag.cs b/Assets/Tests/Weaver/BitAttributeTests~/ZigZag.cs
new file mode 100644
index 00000000000..e5ca0570b25
--- /dev/null
+++ b/Assets/Tests/Weaver/BitAttributeTests~/ZigZag.cs
@@ -0,0 +1,30 @@
+using Mirage;
+using Mirage.Serialization;
+
+namespace BitAttributeTests.ZigZag
+{
+    // should expect 1 error per field
+    public class MyBehaviour : NetworkBehaviour
+    {
+        [BitCount(10), ZigZagEncode]
+        [SyncVar] public int value1;
+
+        [BitCount(4), ZigZagEncode]
+        [SyncVar] public MyIntEnum value2;
+
+        [BitCount(4), ZigZagEncode]
+        [SyncVar] public MyShortEnum value3;
+    }
+
+    public enum MyIntEnum
+    {
+        none = 0,
+        value = 1,
+    }
+
+    public enum MyShortEnum : short
+    {
+        none = 0,
+        value = 1,
+    }
+}
\ No newline at end of file
diff --git a/Assets/Tests/Weaver/BitAttributeTests~/ZigZagNoBitCount.cs b/Assets/Tests/Weaver/BitAttributeTests~/ZigZagNoBitCount.cs
new file mode 100644
index 00000000000..90ffc7e18b4
--- /dev/null
+++ b/Assets/Tests/Weaver/BitAttributeTests~/ZigZagNoBitCount.cs
@@ -0,0 +1,27 @@
+using Mirage;
+using Mirage.Serialization;
+
+namespace BitAttributeTests.ZigZagNoBitCount
+{
+    // should expect 1 error per field
+    public class MyBehaviour : NetworkBehaviour
+    {
+        // error, ZigZag can't be used by itself
+        [ZigZagEncode]
+        [SyncVar] public int value1;
+
+        // error, ZigZag should be used on signed fields
+        [BitCount(8), ZigZagEncode]
+        [SyncVar] public uint value2;
+
+        // error, ZigZag should be used on signed fields
+        [BitCount(8), ZigZagEncode]
+        [SyncVar] public MyShortEnum value3;
+    }
+
+    public enum MyShortEnum : ushort
+    {
+        none = 0,
+        value = 1,
+    }
+}
\ No newline at end of file

From 7cfc6a1bd5d35cdc14e9963f8e4f236eb6cfddbd Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Tue, 24 Aug 2021 13:21:22 +0000
Subject: [PATCH 138/166] chore(release): 101.7.0 [skip ci]

# [101.7.0](https://github.com/MirageNet/Mirage/compare/v101.6.0...v101.7.0) (2021-08-24)

### Features

* attributes to use zig zag encoding ([#897](https://github.com/MirageNet/Mirage/issues/897)) ([ccef5fb](https://github.com/MirageNet/Mirage/commit/ccef5fb0302ff97d897f17698e53967e014a9a95))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs               | 2 +-
 Assets/Mirage/CHANGELOG.md                                 | 7 +++++++
 Assets/Mirage/Components/AssemblyInfo.cs                   | 2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                      | 2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs          | 2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs                     | 2 +-
 .../Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs      | 2 +-
 Assets/Mirage/package.json                                 | 2 +-
 8 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index 44bcd9a3738..8e912e94d52 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.6.0")]
+[assembly: AssemblyVersion("101.7.0")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index d550235aadb..b7be5dd5e9d 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,10 @@
+# [101.7.0](https://github.com/MirageNet/Mirage/compare/v101.6.0...v101.7.0) (2021-08-24)
+
+
+### Features
+
+* attributes to use zig zag encoding ([#897](https://github.com/MirageNet/Mirage/issues/897)) ([ccef5fb](https://github.com/MirageNet/Mirage/commit/ccef5fb0302ff97d897f17698e53967e014a9a95))
+
 # [101.6.0](https://github.com/MirageNet/Mirage/compare/v101.5.1...v101.6.0) (2021-08-22)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index c70e197d567..0a98067adf5 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.6.0")]
+[assembly: AssemblyVersion("101.7.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index be31376d30b..9ec540a320a 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.6.0")]
+[assembly: AssemblyVersion("101.7.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index 15835013383..899dd26ae97 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.6.0")]
+[assembly: AssemblyVersion("101.7.0")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index 44bcd9a3738..8e912e94d52 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.6.0")]
+[assembly: AssemblyVersion("101.7.0")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index 44bcd9a3738..8e912e94d52 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.6.0")]
+[assembly: AssemblyVersion("101.7.0")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 0b1e28dc0f3..5ccabf33fa9 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "101.6.0",
+    "version": "101.7.0",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From 1c22ea63217a3206cb0eb41174135e8fc0133138 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Tue, 24 Aug 2021 15:59:35 +0100
Subject: [PATCH 139/166] feat: attributes to calculate bit count of a given
 range (#902)

* feat: attributes to calculate bit count of a given range

* weaver tests

* generated tests

* implementing bitcount from range

* updating tests

* fixing test

* fixing bitcount breaking for no large value
---
 .../Serialization/Packers/BitHelper.cs        |  5 +-
 .../Packers/VariableIntPacker.cs              |  2 +-
 .../Runtime/Serialization/WeaverAttributes.cs |  6 ++
 .../Weaver/Processors/SyncVarProcessor.cs     | 18 ++++
 .../Processors/SyncVars/BitCountFinder.cs     |  4 +-
 .../SyncVars/BitCountFromRangeFinder.cs       | 89 ++++++++++++++++++
 .../SyncVars/BitCountFromRangeFinder.cs.meta  | 11 +++
 .../Processors/SyncVars/FoundSyncVar.cs       |  8 ++
 Assets/Mirage/Weaver/WeaverExceptions.cs      |  4 +
 .../Generated/BitCountFromRangeTests.meta     |  8 ++
 .../BitCountBehaviour_MyByteEnum_0_3.cs       | 82 +++++++++++++++++
 .../BitCountBehaviour_MyByteEnum_0_3.cs.meta  | 11 +++
 .../BitCountBehaviour_MyDirection_N1_1.cs     | 81 ++++++++++++++++
 ...BitCountBehaviour_MyDirection_N1_1.cs.meta | 11 +++
 .../BitCountBehaviour_int_N1000_0.cs          | 75 +++++++++++++++
 .../BitCountBehaviour_int_N1000_0.cs.meta     | 11 +++
 .../BitCountBehaviour_int_N10_10.cs           | 75 +++++++++++++++
 .../BitCountBehaviour_int_N10_10.cs.meta      | 11 +++
 .../BitCountBehaviour_int_N20000_20000.cs     | 75 +++++++++++++++
 ...BitCountBehaviour_int_N20000_20000.cs.meta | 11 +++
 .../BitCountBehaviour_int_N2000_N1000.cs      | 75 +++++++++++++++
 .../BitCountBehaviour_int_N2000_N1000.cs.meta | 11 +++
 ...untBehaviour_int_N2147483648_2147483647.cs | 75 +++++++++++++++
 ...haviour_int_N2147483648_2147483647.cs.meta | 11 +++
 ...Behaviour_int_N2147483648_2147483647max.cs | 75 +++++++++++++++
 ...iour_int_N2147483648_2147483647max.cs.meta | 11 +++
 ...Behaviour_int_N2147483648_2147483647min.cs | 75 +++++++++++++++
 ...iour_int_N2147483648_2147483647min.cs.meta | 11 +++
 .../BitCountBehaviour_short_N1000_1000.cs     | 75 +++++++++++++++
 ...BitCountBehaviour_short_N1000_1000.cs.meta | 11 +++
 .../BitCountBehaviour_short_N10_10.cs         | 75 +++++++++++++++
 .../BitCountBehaviour_short_N10_10.cs.meta    | 11 +++
 .../BitCountBehaviour_short_N32768_32767.cs   | 75 +++++++++++++++
 ...tCountBehaviour_short_N32768_32767.cs.meta | 11 +++
 .../BitCountBehaviour_uint_0_5000.cs          | 75 +++++++++++++++
 .../BitCountBehaviour_uint_0_5000.cs.meta     | 11 +++
 .../BitCountBehaviour_ushort_0_65535.cs       | 75 +++++++++++++++
 .../BitCountBehaviour_ushort_0_65535.cs.meta  | 11 +++
 .../.BitCountFromRangeTestTemplate.txt        | 75 +++++++++++++++
 .../BitCountFromRangeTestGenerator.cs         | 65 +++++++++++++
 .../BitCountFromRangeTestGenerator.cs.meta    | 11 +++
 .../Serialization/Packers/BitHelperTest.cs    | 26 +++++-
 .../Serialization/Packers/FloatPackerTests.cs |  2 +-
 Assets/Tests/Weaver/BitAttributeTests.cs      | 92 +++++++++++++------
 .../BitAttributeTests~/BitCountFromRange.cs   | 42 +++++++++
 .../BitCountFromRangeInvalid.cs               | 41 +++++++++
 ...ountOverTypeSize.cs => BitCountInvalid.cs} |  2 +-
 .../{ZigZagNoBitCount.cs => ZigZagInvalid.cs} |  2 +-
 48 files changed, 1692 insertions(+), 38 deletions(-)
 create mode 100644 Assets/Mirage/Weaver/Processors/SyncVars/BitCountFromRangeFinder.cs
 create mode 100644 Assets/Mirage/Weaver/Processors/SyncVars/BitCountFromRangeFinder.cs.meta
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests.meta
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_MyByteEnum_0_3.cs
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_MyByteEnum_0_3.cs.meta
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_MyDirection_N1_1.cs
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_MyDirection_N1_1.cs.meta
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N1000_0.cs
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N1000_0.cs.meta
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N10_10.cs
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N10_10.cs.meta
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N20000_20000.cs
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N20000_20000.cs.meta
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2000_N1000.cs
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2000_N1000.cs.meta
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2147483648_2147483647.cs
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2147483648_2147483647.cs.meta
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2147483648_2147483647max.cs
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2147483648_2147483647max.cs.meta
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2147483648_2147483647min.cs
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2147483648_2147483647min.cs.meta
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_short_N1000_1000.cs
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_short_N1000_1000.cs.meta
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_short_N10_10.cs
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_short_N10_10.cs.meta
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_short_N32768_32767.cs
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_short_N32768_32767.cs.meta
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_uint_0_5000.cs
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_uint_0_5000.cs.meta
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_ushort_0_65535.cs
 create mode 100644 Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_ushort_0_65535.cs.meta
 create mode 100644 Assets/Tests/Generators/.BitCountFromRangeTestTemplate.txt
 create mode 100644 Assets/Tests/Generators/BitCountFromRangeTestGenerator.cs
 create mode 100644 Assets/Tests/Generators/BitCountFromRangeTestGenerator.cs.meta
 create mode 100644 Assets/Tests/Weaver/BitAttributeTests~/BitCountFromRange.cs
 create mode 100644 Assets/Tests/Weaver/BitAttributeTests~/BitCountFromRangeInvalid.cs
 rename Assets/Tests/Weaver/BitAttributeTests~/{BitCountOverTypeSize.cs => BitCountInvalid.cs} (96%)
 rename Assets/Tests/Weaver/BitAttributeTests~/{ZigZagNoBitCount.cs => ZigZagInvalid.cs} (92%)

diff --git a/Assets/Mirage/Runtime/Serialization/Packers/BitHelper.cs b/Assets/Mirage/Runtime/Serialization/Packers/BitHelper.cs
index 92e5e8a708c..7645f7d2580 100644
--- a/Assets/Mirage/Runtime/Serialization/Packers/BitHelper.cs
+++ b/Assets/Mirage/Runtime/Serialization/Packers/BitHelper.cs
@@ -22,6 +22,7 @@ MIT License
 SOFTWARE.
 */
 
+using System;
 using UnityEngine;
 
 namespace Mirage.Serialization
@@ -39,7 +40,7 @@ public static class BitHelper
         /// <returns></returns>
         public static int BitCount(float max, float precision)
         {
-            return Mathf.CeilToInt(Mathf.Log(2 * max / precision, 2));
+            return Mathf.FloorToInt(Mathf.Log(2 * max / precision, 2)) + 1;
         }
 
         /// <summary>
@@ -53,7 +54,7 @@ public static int BitCount(float max, float precision)
         /// <returns></returns>
         public static int BitCount(ulong max)
         {
-            return Mathf.CeilToInt(Mathf.Log(max, 2));
+            return (int)Math.Floor(Math.Log(max, 2)) + 1;
         }
     }
 }
diff --git a/Assets/Mirage/Runtime/Serialization/Packers/VariableIntPacker.cs b/Assets/Mirage/Runtime/Serialization/Packers/VariableIntPacker.cs
index 89595211d42..4db324edb6a 100644
--- a/Assets/Mirage/Runtime/Serialization/Packers/VariableIntPacker.cs
+++ b/Assets/Mirage/Runtime/Serialization/Packers/VariableIntPacker.cs
@@ -43,7 +43,7 @@ public sealed class VariableIntPacker
         readonly bool throwIfOverLarge;
 
         public VariableIntPacker(ulong smallValue, ulong mediumValue)
-            : this(smallValue, mediumValue, ulong.MaxValue, false) { }
+            : this(BitHelper.BitCount(smallValue), BitHelper.BitCount(mediumValue), 64, false) { }
         public VariableIntPacker(ulong smallValue, ulong mediumValue, ulong largeValue, bool throwIfOverLarge = true)
             : this(BitHelper.BitCount(smallValue), BitHelper.BitCount(mediumValue), BitHelper.BitCount(largeValue), throwIfOverLarge) { }
 
diff --git a/Assets/Mirage/Runtime/Serialization/WeaverAttributes.cs b/Assets/Mirage/Runtime/Serialization/WeaverAttributes.cs
index be370564b24..65c604c2247 100644
--- a/Assets/Mirage/Runtime/Serialization/WeaverAttributes.cs
+++ b/Assets/Mirage/Runtime/Serialization/WeaverAttributes.cs
@@ -33,6 +33,12 @@ public BitCountAttribute(int bitCount)
         }
     }
 
+    [AttributeUsage(AttributeTargets.Field | AttributeTargets.Parameter)]
+    public class BitCountFromRangeAttribute : Attribute
+    {
+        public BitCountFromRangeAttribute(int min, int max) { }
+    }
+
     /// <summary>
     /// Used along size <see cref="BitCountAttribute"/> to encodes a interager value using <see cref="ZigZag"/> so that both positive and negative values can be sent
     /// </summary>
diff --git a/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs b/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
index 638b727c9f3..9674091c73b 100644
--- a/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
@@ -461,6 +461,10 @@ void WriteWithBitCount()
                 {
                     WriteZigZag();
                 }
+                if (syncVar.BitCountMinValue.HasValue)
+                {
+                    WriteSubtractMinValue();
+                }
 
                 worker.Append(worker.Create(OpCodes.Conv_U8));
                 worker.Append(worker.Create(OpCodes.Ldc_I4, syncVar.BitCount.Value));
@@ -475,6 +479,11 @@ void WriteZigZag()
 
                 worker.Append(worker.Create(OpCodes.Call, encode));
             }
+            void WriteSubtractMinValue()
+            {
+                worker.Append(worker.Create(OpCodes.Ldc_I4, syncVar.BitCountMinValue.Value));
+                worker.Append(worker.Create(OpCodes.Sub));
+            }
         }
 
 
@@ -641,6 +650,10 @@ void ReadWithBitCount()
                 {
                     ReadZigZag();
                 }
+                if (syncVar.BitCountMinValue.HasValue)
+                {
+                    ReadAddMinValue();
+                }
 
                 worker.Append(worker.Create(OpCodes.Stfld, syncVar.FieldDefinition.MakeHostGenericIfNeeded()));
             }
@@ -653,6 +666,11 @@ void ReadZigZag()
 
                 worker.Append(worker.Create(OpCodes.Call, encode));
             }
+            void ReadAddMinValue()
+            {
+                worker.Append(worker.Create(OpCodes.Ldc_I4, syncVar.BitCountMinValue.Value));
+                worker.Append(worker.Create(OpCodes.Add));
+            }
         }
     }
 }
diff --git a/Assets/Mirage/Weaver/Processors/SyncVars/BitCountFinder.cs b/Assets/Mirage/Weaver/Processors/SyncVars/BitCountFinder.cs
index 8135788bdb4..a92ba7e890b 100644
--- a/Assets/Mirage/Weaver/Processors/SyncVars/BitCountFinder.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncVars/BitCountFinder.cs
@@ -20,7 +20,7 @@ public static (int? bitCount, OpCode? ConvertCode) GetBitCount(FieldDefinition s
             int maxSize = GetTypeMaxSize(syncVar.FieldType, syncVar);
 
             if (bitCount > maxSize)
-                throw new BitCountException($"BitCount can not be above target type size, bitCount:{bitCount}, type:{syncVar.FieldType.Name}, max size:{maxSize}", syncVar);
+                throw new BitCountException($"BitCount can not be above target type size, bitCount:{bitCount}, max size:{maxSize}, type:{syncVar.FieldType.Name}", syncVar);
 
             return (bitCount, GetConvertType(syncVar.FieldType));
         }
@@ -50,7 +50,7 @@ static int GetTypeMaxSize(TypeReference type, FieldDefinition syncVar)
         /// </summary>
         /// <param name="syncVar"></param>
         /// <returns></returns>
-        static OpCode? GetConvertType(TypeReference type)
+        public static OpCode? GetConvertType(TypeReference type)
         {
             if (type.Is<byte>()) return OpCodes.Conv_I4;
             if (type.Is<ushort>()) return OpCodes.Conv_I4;
diff --git a/Assets/Mirage/Weaver/Processors/SyncVars/BitCountFromRangeFinder.cs b/Assets/Mirage/Weaver/Processors/SyncVars/BitCountFromRangeFinder.cs
new file mode 100644
index 00000000000..befb68f6572
--- /dev/null
+++ b/Assets/Mirage/Weaver/Processors/SyncVars/BitCountFromRangeFinder.cs
@@ -0,0 +1,89 @@
+using System;
+using Mirage.Serialization;
+using Mono.Cecil;
+using Mono.Cecil.Cil;
+
+namespace Mirage.Weaver.SyncVars
+{
+    public static class BitCountFromRangeFinder
+    {
+        internal static (int? BitCount, OpCode? BitCountConvert, int? MinValue) GetBitFoundFromRange(FieldDefinition syncVar, bool hasBitCount)
+        {
+            CustomAttribute attribute = syncVar.GetCustomAttribute<BitCountFromRangeAttribute>();
+
+            if (hasBitCount)
+                throw new BitCountFromRangeException($"[BitCountFromRange] can't be used with [BitCount]", syncVar);
+
+            int min = (int)attribute.ConstructorArguments[0].Value;
+            int max = (int)attribute.ConstructorArguments[1].Value;
+
+            if (min >= max)
+                throw new BitCountFromRangeException("Max must be greater than min", syncVar);
+
+            long minAllowedMin = GetTypeMin(syncVar.FieldType, syncVar);
+            long maxAllowedMax = GetTypeMax(syncVar.FieldType, syncVar);
+
+            if (min < minAllowedMin)
+                throw new BitCountException($"Min must be less than types min value, min:{min}, min allowed:{minAllowedMin}, type:{syncVar.FieldType.Name}", syncVar);
+
+            if (max > maxAllowedMax)
+                throw new BitCountException($"Max must be greater than types max value, max:{max}, max allowed:{maxAllowedMax}, type:{syncVar.FieldType.Name}", syncVar);
+
+            // make sure to cast max to long so incase range is bigger than int value
+            long range = checked((long)max - min);
+            int bitCount = (int)Math.Floor(Math.Log(range, 2)) + 1;
+            if (bitCount < 0 || bitCount > 32)
+                throw new OverflowException($"Bit Count could not be calcualted, min:{min}, max:{max}, bitCount:{bitCount}");
+
+            int? minResult;
+            if (min == 0) minResult = null;
+            else minResult = min;
+
+            return (bitCount, BitCountFinder.GetConvertType(syncVar.FieldType), minResult);
+        }
+
+        static int GetTypeMax(TypeReference type, FieldDefinition syncVar)
+        {
+            if (type.Is<byte>()) return byte.MaxValue;
+            if (type.Is<ushort>()) return ushort.MaxValue;
+            if (type.Is<short>()) return short.MaxValue;
+            if (type.Is<int>()
+             || type.Is<uint>()) return int.MaxValue;
+
+            if (type.Resolve().IsEnum)
+            {
+                // use underlying enum type for max size
+                TypeReference enumType = type.Resolve().GetEnumUnderlyingType();
+                return GetTypeMax(enumType, syncVar);
+            }
+
+            // long is not a support type because it is not commonly used and
+            // would take a lot more code to make it works with all possible
+            // ranges of values:
+            // - min and max both negative long values
+            // - min and max both above long.max
+            // we would need a type bigger than long in order to easily handle
+            // both of these, and that is before dealing with IL stuff
+
+            throw new BitCountFromRangeException($"{type.FullName} is not a supported type for [BitCountFromRange]", syncVar);
+        }
+
+        static int GetTypeMin(TypeReference type, FieldDefinition syncVar)
+        {
+            if (type.Is<byte>()) return byte.MinValue;
+            if (type.Is<ushort>()) return ushort.MinValue;
+            if (type.Is<short>()) return short.MinValue;
+            if (type.Is<int>()) return int.MinValue;
+            if (type.Is<uint>()) return 0;
+
+            if (type.Resolve().IsEnum)
+            {
+                // use underlying enum type for max size
+                TypeReference enumType = type.Resolve().GetEnumUnderlyingType();
+                return GetTypeMin(enumType, syncVar);
+            }
+
+            throw new BitCountFromRangeException($"{type.FullName} is not a supported type for [BitCountFromRange]", syncVar);
+        }
+    }
+}
diff --git a/Assets/Mirage/Weaver/Processors/SyncVars/BitCountFromRangeFinder.cs.meta b/Assets/Mirage/Weaver/Processors/SyncVars/BitCountFromRangeFinder.cs.meta
new file mode 100644
index 00000000000..c562dd523d1
--- /dev/null
+++ b/Assets/Mirage/Weaver/Processors/SyncVars/BitCountFromRangeFinder.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: e7a6055fed770e04daf0873769890c37
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs b/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs
index ab4db519780..193cdead6fe 100644
--- a/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs
@@ -1,3 +1,5 @@
+using System.Runtime.CompilerServices;
+using Mirage.Serialization;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
 using UnityEngine;
@@ -28,6 +30,7 @@ public FoundSyncVar(FieldDefinition fieldDefinition, int dirtyIndex)
         public OpCode? BitCountConvert { get; private set; }
 
         public bool UseZigZagEncoding { get; private set; }
+        public int? BitCountMinValue { get; private set; }
 
         public MethodReference WriteFunction { get; private set; }
         public MethodReference ReadFunction { get; private set; }
@@ -78,6 +81,7 @@ private static bool CheckWrapType(ModuleDefinition module, TypeReference origina
         /// Finds any attribute values needed for this syncvar
         /// </summary>
         /// <param name="module"></param>
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
         public void ProcessAttributes()
         {
             HookMethod = HookMethodFinder.GetHookMethod(FieldDefinition, OriginalType);
@@ -85,6 +89,10 @@ public void ProcessAttributes()
 
             (BitCount, BitCountConvert) = BitCountFinder.GetBitCount(FieldDefinition);
             UseZigZagEncoding = ZigZagFinder.HasZigZag(FieldDefinition, BitCount.HasValue);
+
+            // do this if check here so it doesn't override fields unless attribute exists
+            if (FieldDefinition.HasCustomAttribute<BitCountFromRangeAttribute>())
+                (BitCount, BitCountConvert, BitCountMinValue) = BitCountFromRangeFinder.GetBitFoundFromRange(FieldDefinition, BitCount.HasValue);
         }
 
         public void FindSerializeFunctions(Writers writers, Readers readers)
diff --git a/Assets/Mirage/Weaver/WeaverExceptions.cs b/Assets/Mirage/Weaver/WeaverExceptions.cs
index d0d2bfcc74b..09cbb4f9ac5 100644
--- a/Assets/Mirage/Weaver/WeaverExceptions.cs
+++ b/Assets/Mirage/Weaver/WeaverExceptions.cs
@@ -47,4 +47,8 @@ internal class ZigZagException : SyncVarException
     {
         public ZigZagException(string message, MemberReference memberReference) : base(message, memberReference) { }
     }
+    internal class BitCountFromRangeException : SyncVarException
+    {
+        public BitCountFromRangeException(string message, MemberReference memberReference) : base(message, memberReference) { }
+    }
 }
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests.meta b/Assets/Tests/Generated/BitCountFromRangeTests.meta
new file mode 100644
index 00000000000..1992c1d0462
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 8cb64a68508b9124e83b82d7b32e82c9
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_MyByteEnum_0_3.cs b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_MyByteEnum_0_3.cs
new file mode 100644
index 00000000000..8152b911020
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_MyByteEnum_0_3.cs
@@ -0,0 +1,82 @@
+// DO NOT EDIT: GENERATED BY BitCountFromRangeTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.BitCountFromRangeAttributeTests
+{
+    [System.Serializable]
+    public enum MyByteEnum : byte
+    {
+        None = 0,
+        Slow = 1,
+        Fast = 2,
+        ReallyFast = 3,
+    }
+    public class BitCountRangeBehaviour_MyByteEnum_0_3 : NetworkBehaviour
+    {
+        [BitCountFromRange(0, 3)]
+        [SyncVar] public MyByteEnum myValue;
+
+        public event Action<MyByteEnum> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCountFromRange(0, 3)] MyByteEnum myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class BitCountRangeTest_MyByteEnum_0_3 : ClientServerSetup<BitCountRangeBehaviour_MyByteEnum_0_3>
+    {
+        const MyByteEnum value = (MyByteEnum)3;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(2));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(2));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(1), $"%%BIT_COUNT%% bits is 1 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_MyByteEnum_0_3.cs.meta b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_MyByteEnum_0_3.cs.meta
new file mode 100644
index 00000000000..a3810817a63
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_MyByteEnum_0_3.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 4d8e66d66d5618448b302ab8caca0f55
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_MyDirection_N1_1.cs b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_MyDirection_N1_1.cs
new file mode 100644
index 00000000000..0d18eacb414
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_MyDirection_N1_1.cs
@@ -0,0 +1,81 @@
+// DO NOT EDIT: GENERATED BY BitCountFromRangeTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.BitCountFromRangeAttributeTests
+{
+    [System.Serializable]
+    public enum MyDirection
+    {
+        Left = -1,
+        None = 0,
+        Right = 1,
+    }
+    public class BitCountRangeBehaviour_MyDirection_N1_1 : NetworkBehaviour
+    {
+        [BitCountFromRange(-1, 1)]
+        [SyncVar] public MyDirection myValue;
+
+        public event Action<MyDirection> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCountFromRange(-1, 1)] MyDirection myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class BitCountRangeTest_MyDirection_N1_1 : ClientServerSetup<BitCountRangeBehaviour_MyDirection_N1_1>
+    {
+        const MyDirection value = (MyDirection)1;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(2));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(2));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(1), $"%%BIT_COUNT%% bits is 1 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_MyDirection_N1_1.cs.meta b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_MyDirection_N1_1.cs.meta
new file mode 100644
index 00000000000..cc2411f12fc
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_MyDirection_N1_1.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: e32d5ef3ae40159449bc6fbbbac79324
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N1000_0.cs b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N1000_0.cs
new file mode 100644
index 00000000000..777ad40c833
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N1000_0.cs
@@ -0,0 +1,75 @@
+// DO NOT EDIT: GENERATED BY BitCountFromRangeTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.BitCountFromRangeAttributeTests
+{
+    
+    public class BitCountRangeBehaviour_int_N1000_0 : NetworkBehaviour
+    {
+        [BitCountFromRange(-1000, 0)]
+        [SyncVar] public int myValue;
+
+        public event Action<int> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCountFromRange(-1000, 0)] int myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class BitCountRangeTest_int_N1000_0 : ClientServerSetup<BitCountRangeBehaviour_int_N1000_0>
+    {
+        const int value = -3;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(10));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(10));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(2), $"%%BIT_COUNT%% bits is 2 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N1000_0.cs.meta b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N1000_0.cs.meta
new file mode 100644
index 00000000000..67fc8f7d921
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N1000_0.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 6f21c9537a83df8459b9398d50f35a2d
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N10_10.cs b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N10_10.cs
new file mode 100644
index 00000000000..c7e0fb8df62
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N10_10.cs
@@ -0,0 +1,75 @@
+// DO NOT EDIT: GENERATED BY BitCountFromRangeTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.BitCountFromRangeAttributeTests
+{
+    
+    public class BitCountRangeBehaviour_int_N10_10 : NetworkBehaviour
+    {
+        [BitCountFromRange(-10, 10)]
+        [SyncVar] public int myValue;
+
+        public event Action<int> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCountFromRange(-10, 10)] int myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class BitCountRangeTest_int_N10_10 : ClientServerSetup<BitCountRangeBehaviour_int_N10_10>
+    {
+        const int value = -3;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(5));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(5));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(1), $"%%BIT_COUNT%% bits is 1 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N10_10.cs.meta b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N10_10.cs.meta
new file mode 100644
index 00000000000..70748131cdb
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N10_10.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: d6c31636d3a73ea44bc785bad897c15b
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N20000_20000.cs b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N20000_20000.cs
new file mode 100644
index 00000000000..4c3b06f116e
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N20000_20000.cs
@@ -0,0 +1,75 @@
+// DO NOT EDIT: GENERATED BY BitCountFromRangeTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.BitCountFromRangeAttributeTests
+{
+    
+    public class BitCountRangeBehaviour_int_N20000_20000 : NetworkBehaviour
+    {
+        [BitCountFromRange(-20000, 20000)]
+        [SyncVar] public int myValue;
+
+        public event Action<int> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCountFromRange(-20000, 20000)] int myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class BitCountRangeTest_int_N20000_20000 : ClientServerSetup<BitCountRangeBehaviour_int_N20000_20000>
+    {
+        const int value = 20;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(16));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(16));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(2), $"%%BIT_COUNT%% bits is 2 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N20000_20000.cs.meta b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N20000_20000.cs.meta
new file mode 100644
index 00000000000..832159149d5
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N20000_20000.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 9db35aefff56e4e429ab9ff1ab253843
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2000_N1000.cs b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2000_N1000.cs
new file mode 100644
index 00000000000..d2b748167dc
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2000_N1000.cs
@@ -0,0 +1,75 @@
+// DO NOT EDIT: GENERATED BY BitCountFromRangeTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.BitCountFromRangeAttributeTests
+{
+    
+    public class BitCountRangeBehaviour_int_N2000_N1000 : NetworkBehaviour
+    {
+        [BitCountFromRange(-2000, -1000)]
+        [SyncVar] public int myValue;
+
+        public event Action<int> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCountFromRange(-2000, -1000)] int myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class BitCountRangeTest_int_N2000_N1000 : ClientServerSetup<BitCountRangeBehaviour_int_N2000_N1000>
+    {
+        const int value = -1400;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(10));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(10));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(2), $"%%BIT_COUNT%% bits is 2 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2000_N1000.cs.meta b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2000_N1000.cs.meta
new file mode 100644
index 00000000000..1813e75cdb8
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2000_N1000.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 0eea04a1bda1c754b96acc9673305628
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2147483648_2147483647.cs b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2147483648_2147483647.cs
new file mode 100644
index 00000000000..103f3b3fc2b
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2147483648_2147483647.cs
@@ -0,0 +1,75 @@
+// DO NOT EDIT: GENERATED BY BitCountFromRangeTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.BitCountFromRangeAttributeTests
+{
+    
+    public class BitCountRangeBehaviour_int_N2147483648_2147483647 : NetworkBehaviour
+    {
+        [BitCountFromRange(-2147483648, 2147483647)]
+        [SyncVar] public int myValue;
+
+        public event Action<int> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCountFromRange(-2147483648, 2147483647)] int myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class BitCountRangeTest_int_N2147483648_2147483647 : ClientServerSetup<BitCountRangeBehaviour_int_N2147483648_2147483647>
+    {
+        const int value = 20;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(32));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(32));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(4), $"%%BIT_COUNT%% bits is 4 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2147483648_2147483647.cs.meta b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2147483648_2147483647.cs.meta
new file mode 100644
index 00000000000..6722d0e62ea
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2147483648_2147483647.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: b852711d948988b4a830ab1b481a1495
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2147483648_2147483647max.cs b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2147483648_2147483647max.cs
new file mode 100644
index 00000000000..a6dcdc15935
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2147483648_2147483647max.cs
@@ -0,0 +1,75 @@
+// DO NOT EDIT: GENERATED BY BitCountFromRangeTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.BitCountFromRangeAttributeTests
+{
+    
+    public class BitCountRangeBehaviour_int_N2147483648_2147483647max : NetworkBehaviour
+    {
+        [BitCountFromRange(-2147483648, 2147483647)]
+        [SyncVar] public int myValue;
+
+        public event Action<int> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCountFromRange(-2147483648, 2147483647)] int myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class BitCountRangeTest_int_N2147483648_2147483647max : ClientServerSetup<BitCountRangeBehaviour_int_N2147483648_2147483647max>
+    {
+        const int value = 2147483647;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(32));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(32));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(4), $"%%BIT_COUNT%% bits is 4 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2147483648_2147483647max.cs.meta b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2147483648_2147483647max.cs.meta
new file mode 100644
index 00000000000..c625e48cc4f
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2147483648_2147483647max.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: e3ed26ede4a35fe46b0aa6e7b940b13a
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2147483648_2147483647min.cs b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2147483648_2147483647min.cs
new file mode 100644
index 00000000000..a53d94a6d82
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2147483648_2147483647min.cs
@@ -0,0 +1,75 @@
+// DO NOT EDIT: GENERATED BY BitCountFromRangeTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.BitCountFromRangeAttributeTests
+{
+    
+    public class BitCountRangeBehaviour_int_N2147483648_2147483647min : NetworkBehaviour
+    {
+        [BitCountFromRange(-2147483648, 2147483647)]
+        [SyncVar] public int myValue;
+
+        public event Action<int> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCountFromRange(-2147483648, 2147483647)] int myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class BitCountRangeTest_int_N2147483648_2147483647min : ClientServerSetup<BitCountRangeBehaviour_int_N2147483648_2147483647min>
+    {
+        const int value = -2147483648;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(32));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(32));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(4), $"%%BIT_COUNT%% bits is 4 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2147483648_2147483647min.cs.meta b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2147483648_2147483647min.cs.meta
new file mode 100644
index 00000000000..7ac49b0a887
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_int_N2147483648_2147483647min.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 475ddf87783481044bda2d5d6bdf8d26
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_short_N1000_1000.cs b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_short_N1000_1000.cs
new file mode 100644
index 00000000000..d5bc4f4b50e
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_short_N1000_1000.cs
@@ -0,0 +1,75 @@
+// DO NOT EDIT: GENERATED BY BitCountFromRangeTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.BitCountFromRangeAttributeTests
+{
+    
+    public class BitCountRangeBehaviour_short_N1000_1000 : NetworkBehaviour
+    {
+        [BitCountFromRange(-1000, 1000)]
+        [SyncVar] public short myValue;
+
+        public event Action<short> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCountFromRange(-1000, 1000)] short myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class BitCountRangeTest_short_N1000_1000 : ClientServerSetup<BitCountRangeBehaviour_short_N1000_1000>
+    {
+        const short value = 20;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(11));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(11));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(2), $"%%BIT_COUNT%% bits is 2 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_short_N1000_1000.cs.meta b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_short_N1000_1000.cs.meta
new file mode 100644
index 00000000000..545bf4d5c6a
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_short_N1000_1000.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 7248f0425f0bf0649992c0f5fd7556ec
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_short_N10_10.cs b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_short_N10_10.cs
new file mode 100644
index 00000000000..73628040d29
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_short_N10_10.cs
@@ -0,0 +1,75 @@
+// DO NOT EDIT: GENERATED BY BitCountFromRangeTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.BitCountFromRangeAttributeTests
+{
+    
+    public class BitCountRangeBehaviour_short_N10_10 : NetworkBehaviour
+    {
+        [BitCountFromRange(-10, 10)]
+        [SyncVar] public short myValue;
+
+        public event Action<short> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCountFromRange(-10, 10)] short myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class BitCountRangeTest_short_N10_10 : ClientServerSetup<BitCountRangeBehaviour_short_N10_10>
+    {
+        const short value = 3;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(5));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(5));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(1), $"%%BIT_COUNT%% bits is 1 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_short_N10_10.cs.meta b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_short_N10_10.cs.meta
new file mode 100644
index 00000000000..7a982fad959
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_short_N10_10.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 61d0b259f5374ab468087fe9fd17b494
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_short_N32768_32767.cs b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_short_N32768_32767.cs
new file mode 100644
index 00000000000..42a61cbd506
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_short_N32768_32767.cs
@@ -0,0 +1,75 @@
+// DO NOT EDIT: GENERATED BY BitCountFromRangeTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.BitCountFromRangeAttributeTests
+{
+    
+    public class BitCountRangeBehaviour_short_N32768_32767 : NetworkBehaviour
+    {
+        [BitCountFromRange(-32768, 32767)]
+        [SyncVar] public short myValue;
+
+        public event Action<short> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCountFromRange(-32768, 32767)] short myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class BitCountRangeTest_short_N32768_32767 : ClientServerSetup<BitCountRangeBehaviour_short_N32768_32767>
+    {
+        const short value = 20;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(16));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(16));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(2), $"%%BIT_COUNT%% bits is 2 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_short_N32768_32767.cs.meta b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_short_N32768_32767.cs.meta
new file mode 100644
index 00000000000..7f5130eddcd
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_short_N32768_32767.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: b6281106769e0da4ca0398acd49ff8ad
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_uint_0_5000.cs b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_uint_0_5000.cs
new file mode 100644
index 00000000000..06278f00689
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_uint_0_5000.cs
@@ -0,0 +1,75 @@
+// DO NOT EDIT: GENERATED BY BitCountFromRangeTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.BitCountFromRangeAttributeTests
+{
+    
+    public class BitCountRangeBehaviour_uint_0_5000 : NetworkBehaviour
+    {
+        [BitCountFromRange(0, 5000)]
+        [SyncVar] public uint myValue;
+
+        public event Action<uint> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCountFromRange(0, 5000)] uint myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class BitCountRangeTest_uint_0_5000 : ClientServerSetup<BitCountRangeBehaviour_uint_0_5000>
+    {
+        const uint value = 20;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(13));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(13));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(2), $"%%BIT_COUNT%% bits is 2 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_uint_0_5000.cs.meta b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_uint_0_5000.cs.meta
new file mode 100644
index 00000000000..5806ac4345b
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_uint_0_5000.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: b52848db0c07bc34b95cbf06565b93c6
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_ushort_0_65535.cs b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_ushort_0_65535.cs
new file mode 100644
index 00000000000..7986ba83c39
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_ushort_0_65535.cs
@@ -0,0 +1,75 @@
+// DO NOT EDIT: GENERATED BY BitCountFromRangeTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.BitCountFromRangeAttributeTests
+{
+    
+    public class BitCountRangeBehaviour_ushort_0_65535 : NetworkBehaviour
+    {
+        [BitCountFromRange(0, 65535)]
+        [SyncVar] public ushort myValue;
+
+        public event Action<ushort> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCountFromRange(0, 65535)] ushort myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class BitCountRangeTest_ushort_0_65535 : ClientServerSetup<BitCountRangeBehaviour_ushort_0_65535>
+    {
+        const ushort value = 20;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(16));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(16));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(2), $"%%BIT_COUNT%% bits is 2 bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_ushort_0_65535.cs.meta b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_ushort_0_65535.cs.meta
new file mode 100644
index 00000000000..f1b0716d055
--- /dev/null
+++ b/Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_ushort_0_65535.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 605402d9d5f5fbb4296dd881d3243581
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generators/.BitCountFromRangeTestTemplate.txt b/Assets/Tests/Generators/.BitCountFromRangeTestTemplate.txt
new file mode 100644
index 00000000000..b97f039d2e5
--- /dev/null
+++ b/Assets/Tests/Generators/.BitCountFromRangeTestTemplate.txt
@@ -0,0 +1,75 @@
+// DO NOT EDIT: GENERATED BY BitCountFromRangeTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.BitCountFromRangeAttributeTests
+{
+    %%EXTRA_TYPE%%
+    public class BitCountRangeBehaviour_%%NAME%% : NetworkBehaviour
+    {
+        [BitCountFromRange(%%MIN%%, %%MAX%%)]
+        [SyncVar] public %%TYPE%% myValue;
+
+        public event Action<%%TYPE%%> onRpc;
+
+        [ClientRpc]
+        public void RpcSomeFunction([BitCountFromRange(%%MIN%%, %%MAX%%)] %%TYPE%% myParam)
+        {
+            onRpc?.Invoke(myParam);
+        }
+    }
+    public class BitCountRangeTest_%%NAME%% : ClientServerSetup<BitCountRangeBehaviour_%%NAME%%>
+    {
+        const %%TYPE%% value = %%EXTRA_VALUE%%;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(%%EXPECTED_BIT_COUNT%%));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(%%EXPECTED_BIT_COUNT%%));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value));
+                }
+            }
+        }
+
+        // [UnityTest]
+        // [Ignore("Rpc not supported yet")]
+        public IEnumerator RpcIsBitPacked()
+        {
+            int called = 0;
+            clientComponent.onRpc += (v) => { called++; Assert.That(v, Is.EqualTo(value)); };
+
+            client.MessageHandler.UnregisterHandler<RpcMessage>();
+            int payloadSize = 0;
+            client.MessageHandler.RegisterHandler<RpcMessage>((player, msg) =>
+            {
+                // store value in variable because assert will throw and be catch by message wrapper
+                payloadSize = msg.payload.Count;
+                clientObjectManager.OnRpcMessage(msg);
+            });
+
+
+            serverComponent.RpcSomeFunction(value);
+            yield return null;
+            Assert.That(called, Is.EqualTo(1));
+            Assert.That(payloadSize, Is.EqualTo(%%PAYLOAD_SIZE%%), $"%%BIT_COUNT%% bits is %%PAYLOAD_SIZE%% bytes in payload");
+        }
+    }
+}
diff --git a/Assets/Tests/Generators/BitCountFromRangeTestGenerator.cs b/Assets/Tests/Generators/BitCountFromRangeTestGenerator.cs
new file mode 100644
index 00000000000..07bc702e365
--- /dev/null
+++ b/Assets/Tests/Generators/BitCountFromRangeTestGenerator.cs
@@ -0,0 +1,65 @@
+using JamesFrowen.SimpleCodeGen;
+using UnityEditor;
+using UnityEngine;
+
+namespace Mirage.Tests.CodeGenerators
+{
+    public static class BitCountFromRangeTestGenerator
+    {
+        [MenuItem("Tests Generators/BitCountFromRange")]
+        public static void CreateAll()
+        {
+            var fromTemplate = new CreateFromTemplate("./Assets/Tests/Generators/.BitCountFromRangeTestTemplate.txt");
+            Create(fromTemplate, "int", -10, 10, 5, "-3");
+            Create(fromTemplate, "int", -20_000, 20_000, 16);
+            Create(fromTemplate, "int", -1_000, 0, 10, "-3");
+            Create(fromTemplate, "int", -2000, -1000, 10, "-1400");
+            Create(fromTemplate, "int", int.MinValue, int.MaxValue, 32);
+            Create(fromTemplate, "int", int.MinValue, int.MaxValue, 32, int.MinValue.ToString(), extraName: "min");
+            Create(fromTemplate, "int", int.MinValue, int.MaxValue, 32, int.MaxValue.ToString(), extraName: "max");
+            Create(fromTemplate, "uint", 0, 5000, 13);
+            Create(fromTemplate, "short", -10, 10, 5, "3");
+            Create(fromTemplate, "short", -1000, 1000, 11);
+            Create(fromTemplate, "short", short.MinValue, short.MaxValue, 16);
+            Create(fromTemplate, "ushort", ushort.MinValue, ushort.MaxValue, 16);
+            Create(fromTemplate, "MyDirection", -1, 1, 2, "(MyDirection)1",
+    @"[System.Serializable]
+    public enum MyDirection
+    {
+        Left = -1,
+        None = 0,
+        Right = 1,
+    }");
+
+            Create(fromTemplate, "MyByteEnum", 0, 3, 2, "(MyByteEnum)3",
+    @"[System.Serializable]
+    public enum MyByteEnum : byte
+    {
+        None = 0,
+        Slow = 1,
+        Fast = 2,
+        ReallyFast = 3,
+    }");
+
+            AssetDatabase.Refresh();
+        }
+
+        private static void Create(CreateFromTemplate fromTemplate, string type, int min, int max, int expectedBitCount, string extraValue = "20", string extraType = "", string extraName = "")
+        {
+            fromTemplate.Replace("%%MIN%%", min);
+            fromTemplate.Replace("%%MAX%%", max);
+            fromTemplate.Replace("%%EXPECTED_BIT_COUNT%%", expectedBitCount);
+            fromTemplate.Replace("%%TYPE%%", type);
+            fromTemplate.Replace("%%PAYLOAD_SIZE%%", Mathf.CeilToInt(expectedBitCount / 8f));
+            fromTemplate.Replace("%%EXTRA_TYPE%%", extraType);
+            fromTemplate.Replace("%%EXTRA_VALUE%%", extraValue);
+
+            string minString = min.ToString().Replace('-', 'N');
+            string maxString = max.ToString().Replace('-', 'N');
+            string name = $"{type}_{minString}_{maxString}{extraName}";
+            fromTemplate.Replace("%%NAME%%", name);
+
+            fromTemplate.WriteToFile($"./Assets/Tests/Generated/BitCountFromRangeTests/BitCountBehaviour_{name}.cs");
+        }
+    }
+}
diff --git a/Assets/Tests/Generators/BitCountFromRangeTestGenerator.cs.meta b/Assets/Tests/Generators/BitCountFromRangeTestGenerator.cs.meta
new file mode 100644
index 00000000000..5dd98ac2022
--- /dev/null
+++ b/Assets/Tests/Generators/BitCountFromRangeTestGenerator.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 421bd88d0fe180b4d84ebb89bf06dde4
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Runtime/Serialization/Packers/BitHelperTest.cs b/Assets/Tests/Runtime/Serialization/Packers/BitHelperTest.cs
index 6b7e1280ea3..b71e499cf5d 100644
--- a/Assets/Tests/Runtime/Serialization/Packers/BitHelperTest.cs
+++ b/Assets/Tests/Runtime/Serialization/Packers/BitHelperTest.cs
@@ -1,4 +1,4 @@
-using Mirage.Serialization;
+using Mirage.Serialization;
 using NUnit.Framework;
 
 namespace Mirage.Tests.Runtime.Serialization.Packers
@@ -13,9 +13,31 @@ public class BitHelperTest
         [TestCase(2000, 0.01f, ExpectedResult = 19)]
         // 1023 is 10 bits, but max is -+ so 11 bits
         [TestCase(1023, 1, ExpectedResult = 11)]
-        public int ReturnCorrectBitCount(float max, float precision)
+        [TestCase(16, 0.5f, ExpectedResult = 7)]
+        public int ReturnCorrectBitCountForMaxPrecision(float max, float precision)
         {
             return BitHelper.BitCount(max, precision);
         }
+
+        [Test]
+        [TestCase(0b1UL, ExpectedResult = 1)]
+        [TestCase(0b10UL, ExpectedResult = 2)]
+        [TestCase(0b11UL, ExpectedResult = 2)]
+        [TestCase(0b100UL, ExpectedResult = 3)]
+        [TestCase(0b101UL, ExpectedResult = 3)]
+        [TestCase(0b110UL, ExpectedResult = 3)]
+        [TestCase(0b111UL, ExpectedResult = 3)]
+        [TestCase(8UL, ExpectedResult = 4)]
+        [TestCase(15UL, ExpectedResult = 4)]
+        [TestCase(16UL, ExpectedResult = 5)]
+        [TestCase(31UL, ExpectedResult = 5)]
+        [TestCase(32UL, ExpectedResult = 6)]
+        [TestCase(63UL, ExpectedResult = 6)]
+        [TestCase(255UL, ExpectedResult = 8)]
+        [TestCase(256UL, ExpectedResult = 9)]
+        public int ReturnCorrectBitCountForRange(ulong range)
+        {
+            return BitHelper.BitCount(range);
+        }
     }
 }
diff --git a/Assets/Tests/Runtime/Serialization/Packers/FloatPackerTests.cs b/Assets/Tests/Runtime/Serialization/Packers/FloatPackerTests.cs
index ef813cfdf70..d5d0fc1d3df 100644
--- a/Assets/Tests/Runtime/Serialization/Packers/FloatPackerTests.cs
+++ b/Assets/Tests/Runtime/Serialization/Packers/FloatPackerTests.cs
@@ -1,4 +1,4 @@
-using Mirage.Serialization;
+using Mirage.Serialization;
 using NUnit.Framework;
 using Random = UnityEngine.Random;
 
diff --git a/Assets/Tests/Weaver/BitAttributeTests.cs b/Assets/Tests/Weaver/BitAttributeTests.cs
index eb7b5ebd25e..c9f550b4b1d 100644
--- a/Assets/Tests/Weaver/BitAttributeTests.cs
+++ b/Assets/Tests/Weaver/BitAttributeTests.cs
@@ -11,49 +11,49 @@ public void BitCount()
         }
 
         [Test]
-        public void BitCountOverTypeSize()
+        public void BitCountInvalid()
         {
             HasErrorCount(13);
 
-            HasError("BitCount can not be above target type size, bitCount:9, type:Byte, max size:8",
-                "System.Byte BitAttributeTests.BitCountOverTypeSize.MyBehaviour::value1");
+            HasError("BitCount can not be above target type size, bitCount:9, max size:8, type:Byte",
+                "System.Byte BitAttributeTests.BitCountInvalid.MyBehaviour::value1");
 
-            HasError("BitCount can not be above target type size, bitCount:17, type:Int16, max size:16",
-                "System.Int16 BitAttributeTests.BitCountOverTypeSize.MyBehaviour::value2");
+            HasError("BitCount can not be above target type size, bitCount:17, max size:16, type:Int16",
+                "System.Int16 BitAttributeTests.BitCountInvalid.MyBehaviour::value2");
 
-            HasError("BitCount can not be above target type size, bitCount:17, type:UInt16, max size:16",
-                "System.UInt16 BitAttributeTests.BitCountOverTypeSize.MyBehaviour::value3");
+            HasError("BitCount can not be above target type size, bitCount:17, max size:16, type:UInt16",
+                "System.UInt16 BitAttributeTests.BitCountInvalid.MyBehaviour::value3");
 
-            HasError("BitCount can not be above target type size, bitCount:33, type:Int32, max size:32",
-                "System.Int32 BitAttributeTests.BitCountOverTypeSize.MyBehaviour::value4");
+            HasError("BitCount can not be above target type size, bitCount:33, max size:32, type:Int32",
+                "System.Int32 BitAttributeTests.BitCountInvalid.MyBehaviour::value4");
 
-            HasError("BitCount can not be above target type size, bitCount:33, type:UInt32, max size:32",
-                "System.UInt32 BitAttributeTests.BitCountOverTypeSize.MyBehaviour::value5");
+            HasError("BitCount can not be above target type size, bitCount:33, max size:32, type:UInt32",
+                "System.UInt32 BitAttributeTests.BitCountInvalid.MyBehaviour::value5");
 
-            HasError("BitCount can not be above target type size, bitCount:65, type:Int64, max size:64",
-                "System.Int64 BitAttributeTests.BitCountOverTypeSize.MyBehaviour::value6");
+            HasError("BitCount can not be above target type size, bitCount:65, max size:64, type:Int64",
+                "System.Int64 BitAttributeTests.BitCountInvalid.MyBehaviour::value6");
 
-            HasError("BitCount can not be above target type size, bitCount:65, type:UInt64, max size:64",
-                "System.UInt64 BitAttributeTests.BitCountOverTypeSize.MyBehaviour::value7");
+            HasError("BitCount can not be above target type size, bitCount:65, max size:64, type:UInt64",
+                "System.UInt64 BitAttributeTests.BitCountInvalid.MyBehaviour::value7");
 
-            HasError("BitCount can not be above target type size, bitCount:9, type:MyByteEnum, max size:8",
-                "BitAttributeTests.BitCountOverTypeSize.MyByteEnum BitAttributeTests.BitCountOverTypeSize.MyBehaviour::value8");
+            HasError("BitCount can not be above target type size, bitCount:9, max size:8, type:MyByteEnum",
+                "BitAttributeTests.BitCountInvalid.MyByteEnum BitAttributeTests.BitCountInvalid.MyBehaviour::value8");
 
-            HasError("BitCount can not be above target type size, bitCount:17, type:MyShortEnum, max size:16",
-                "BitAttributeTests.BitCountOverTypeSize.MyShortEnum BitAttributeTests.BitCountOverTypeSize.MyBehaviour::value9");
+            HasError("BitCount can not be above target type size, bitCount:17, max size:16, type:MyShortEnum",
+                "BitAttributeTests.BitCountInvalid.MyShortEnum BitAttributeTests.BitCountInvalid.MyBehaviour::value9");
 
-            HasError("BitCount can not be above target type size, bitCount:33, type:MyIntEnum, max size:32",
-                "BitAttributeTests.BitCountOverTypeSize.MyIntEnum BitAttributeTests.BitCountOverTypeSize.MyBehaviour::value10");
+            HasError("BitCount can not be above target type size, bitCount:33, max size:32, type:MyIntEnum",
+                "BitAttributeTests.BitCountInvalid.MyIntEnum BitAttributeTests.BitCountInvalid.MyBehaviour::value10");
 
 
             HasError("UnityEngine.Vector3 is not a supported type for [BitCount]",
-                "UnityEngine.Vector3 BitAttributeTests.BitCountOverTypeSize.MyBehaviour::value11");
+                "UnityEngine.Vector3 BitAttributeTests.BitCountInvalid.MyBehaviour::value11");
 
             HasError("BitCount should be above 0",
-                "System.Int32 BitAttributeTests.BitCountOverTypeSize.MyBehaviour::value12");
+                "System.Int32 BitAttributeTests.BitCountInvalid.MyBehaviour::value12");
 
             HasError("BitCount should be above 0",
-                "System.Int32 BitAttributeTests.BitCountOverTypeSize.MyBehaviour::value13");
+                "System.Int32 BitAttributeTests.BitCountInvalid.MyBehaviour::value13");
         }
 
         [Test]
@@ -63,18 +63,54 @@ public void ZigZag()
         }
 
         [Test]
-        public void ZigZagNoBitCount()
+        public void ZigZagInvalid()
         {
             HasErrorCount(3);
 
             HasError("[ZigZagEncode] can only be used with [BitCount]",
-                "System.Int32 BitAttributeTests.ZigZagNoBitCount.MyBehaviour::value1");
+                "System.Int32 BitAttributeTests.ZigZagInvalid.MyBehaviour::value1");
 
             HasError("[ZigZagEncode] can only be used on a signed type",
-                "System.UInt32 BitAttributeTests.ZigZagNoBitCount.MyBehaviour::value2");
+                "System.UInt32 BitAttributeTests.ZigZagInvalid.MyBehaviour::value2");
 
             HasError("[ZigZagEncode] can only be used on a signed type",
-                "BitAttributeTests.ZigZagNoBitCount.MyShortEnum BitAttributeTests.ZigZagNoBitCount.MyBehaviour::value3");
+                "BitAttributeTests.ZigZagInvalid.MyShortEnum BitAttributeTests.ZigZagInvalid.MyBehaviour::value3");
+        }
+
+        [Test]
+        public void BitCountFromRange()
+        {
+            IsSuccess();
+        }
+
+        [Test]
+        public void BitCountFromRangeInvalid()
+        {
+            HasErrorCount(8);
+
+            HasError("Max must be greater than min",
+                "System.Int32 BitAttributeTests.BitCountFromRangeInvalid.MyBehaviour::value1");
+
+            HasError("Max must be greater than min",
+                "System.Int32 BitAttributeTests.BitCountFromRangeInvalid.MyBehaviour::value2");
+
+            HasError("[BitCountFromRange] can't be used with [BitCount]",
+                "System.Int32 BitAttributeTests.BitCountFromRangeInvalid.MyBehaviour::value3");
+
+            HasError($"Max must be greater than types max value, max:{300}, max allowed:{byte.MaxValue}, type:Byte",
+                "System.Byte BitAttributeTests.BitCountFromRangeInvalid.MyBehaviour::value4");
+
+            HasError($"Max must be greater than types max value, max:{int.MaxValue}, max allowed:{short.MaxValue}, type:Int16",
+                "System.Int16 BitAttributeTests.BitCountFromRangeInvalid.MyBehaviour::value5");
+
+            HasError($"Min must be less than types min value, min:{-50}, min allowed:{uint.MinValue}, type:UInt32",
+                "System.UInt32 BitAttributeTests.BitCountFromRangeInvalid.MyBehaviour::value6");
+
+            HasError("UnityEngine.Vector3 is not a supported type for [BitCountFromRange]",
+               "UnityEngine.Vector3 BitAttributeTests.BitCountFromRangeInvalid.MyBehaviour::value7");
+
+            HasError("System.Int64 is not a supported type for [BitCountFromRange]",
+               "System.Int64 BitAttributeTests.BitCountFromRangeInvalid.MyBehaviour::value8");
         }
     }
 }
diff --git a/Assets/Tests/Weaver/BitAttributeTests~/BitCountFromRange.cs b/Assets/Tests/Weaver/BitAttributeTests~/BitCountFromRange.cs
new file mode 100644
index 00000000000..631c8b6fed8
--- /dev/null
+++ b/Assets/Tests/Weaver/BitAttributeTests~/BitCountFromRange.cs
@@ -0,0 +1,42 @@
+using Mirage;
+using Mirage.Serialization;
+
+namespace BitAttributeTests.BitCountFromRange
+{
+    // should expect 1 error per field
+    public class MyBehaviour : NetworkBehaviour
+    {
+        [BitCountFromRange(-100, 100)]
+        [SyncVar] public int value1;
+
+        [BitCountFromRange(100, 1000)]
+        [SyncVar] public int value2;
+
+        [BitCountFromRange(0, 1000)]
+        [SyncVar] public uint value3;
+
+        [BitCountFromRange(0, 250)]
+        [SyncVar] public byte value4;
+
+        [BitCountFromRange(-1, 1)]
+        [SyncVar] public MyDirection value5;
+
+        [BitCountFromRange(0, 1)]
+        [SyncVar] public MyShortEnum value6;
+
+        [BitCountFromRange(0, 6)]
+        [SyncVar] public System.DayOfWeek value7;
+    }
+
+    public enum MyDirection  {
+        left = -1,
+        none = 0,
+        right = 1
+    }
+
+    public enum MyShortEnum : ushort
+    {
+        none = 0,
+        value = 1,
+    }
+}
\ No newline at end of file
diff --git a/Assets/Tests/Weaver/BitAttributeTests~/BitCountFromRangeInvalid.cs b/Assets/Tests/Weaver/BitAttributeTests~/BitCountFromRangeInvalid.cs
new file mode 100644
index 00000000000..bfc77dca0bd
--- /dev/null
+++ b/Assets/Tests/Weaver/BitAttributeTests~/BitCountFromRangeInvalid.cs
@@ -0,0 +1,41 @@
+using Mirage;
+using Mirage.Serialization;
+
+namespace BitAttributeTests.BitCountFromRangeInvalid
+{
+    // should expect 1 error per field
+    public class MyBehaviour : NetworkBehaviour
+    {
+        // error, max must be greater than min
+        [BitCountFromRange(0, 0)]
+        [SyncVar] public int value1;
+
+        // error, max must be greater than min
+        [BitCountFromRange(10, 2)]
+        [SyncVar] public int value2;
+
+        // error, cant be used with bitcount
+        [BitCount(4), BitCountFromRange(0, 8)]
+        [SyncVar] public int value3;
+
+        // error, max is above type max
+        [BitCountFromRange(0, 300)]
+        [SyncVar] public byte value4;
+
+        // error, max is above type max
+        [BitCountFromRange(0, int.MaxValue)]
+        [SyncVar] public short value5;
+
+        // error, min is below type max
+        [BitCountFromRange(-50, 50)]
+        [SyncVar] public uint value6;
+
+        // error, unsupported type
+        [BitCountFromRange(-50, 50)]
+        [SyncVar] public UnityEngine.Vector3 value7;
+
+        // error, unsupported type
+        [BitCountFromRange(-50, 50)]
+        [SyncVar] public long value8;
+    }
+}
\ No newline at end of file
diff --git a/Assets/Tests/Weaver/BitAttributeTests~/BitCountOverTypeSize.cs b/Assets/Tests/Weaver/BitAttributeTests~/BitCountInvalid.cs
similarity index 96%
rename from Assets/Tests/Weaver/BitAttributeTests~/BitCountOverTypeSize.cs
rename to Assets/Tests/Weaver/BitAttributeTests~/BitCountInvalid.cs
index 4dda117cbca..1e9cfc3c8bb 100644
--- a/Assets/Tests/Weaver/BitAttributeTests~/BitCountOverTypeSize.cs
+++ b/Assets/Tests/Weaver/BitAttributeTests~/BitCountInvalid.cs
@@ -1,7 +1,7 @@
 using Mirage;
 using Mirage.Serialization;
 
-namespace BitAttributeTests.BitCountOverTypeSize
+namespace BitAttributeTests.BitCountInvalid
 {
     // should expect 1 error per field
     public class MyBehaviour : NetworkBehaviour
diff --git a/Assets/Tests/Weaver/BitAttributeTests~/ZigZagNoBitCount.cs b/Assets/Tests/Weaver/BitAttributeTests~/ZigZagInvalid.cs
similarity index 92%
rename from Assets/Tests/Weaver/BitAttributeTests~/ZigZagNoBitCount.cs
rename to Assets/Tests/Weaver/BitAttributeTests~/ZigZagInvalid.cs
index 90ffc7e18b4..b078662bf72 100644
--- a/Assets/Tests/Weaver/BitAttributeTests~/ZigZagNoBitCount.cs
+++ b/Assets/Tests/Weaver/BitAttributeTests~/ZigZagInvalid.cs
@@ -1,7 +1,7 @@
 using Mirage;
 using Mirage.Serialization;
 
-namespace BitAttributeTests.ZigZagNoBitCount
+namespace BitAttributeTests.ZigZagInvalid
 {
     // should expect 1 error per field
     public class MyBehaviour : NetworkBehaviour

From 094b863e3537c4eb2dc8514da9e2d37f0be0b9c1 Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Tue, 24 Aug 2021 15:16:37 +0000
Subject: [PATCH 140/166] chore(release): 101.8.0 [skip ci]

# [101.8.0](https://github.com/MirageNet/Mirage/compare/v101.7.0...v101.8.0) (2021-08-24)

### Features

* attributes to calculate bit count of a given range ([#902](https://github.com/MirageNet/Mirage/issues/902)) ([1c22ea6](https://github.com/MirageNet/Mirage/commit/1c22ea63217a3206cb0eb41174135e8fc0133138))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs               | 2 +-
 Assets/Mirage/CHANGELOG.md                                 | 7 +++++++
 Assets/Mirage/Components/AssemblyInfo.cs                   | 2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                      | 2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs          | 2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs                     | 2 +-
 .../Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs      | 2 +-
 Assets/Mirage/package.json                                 | 2 +-
 8 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index 8e912e94d52..ca972e7a2bd 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.7.0")]
+[assembly: AssemblyVersion("101.8.0")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index b7be5dd5e9d..ba141818bfa 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,10 @@
+# [101.8.0](https://github.com/MirageNet/Mirage/compare/v101.7.0...v101.8.0) (2021-08-24)
+
+
+### Features
+
+* attributes to calculate bit count of a given range ([#902](https://github.com/MirageNet/Mirage/issues/902)) ([1c22ea6](https://github.com/MirageNet/Mirage/commit/1c22ea63217a3206cb0eb41174135e8fc0133138))
+
 # [101.7.0](https://github.com/MirageNet/Mirage/compare/v101.6.0...v101.7.0) (2021-08-24)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index 0a98067adf5..4f47dcb6b29 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.7.0")]
+[assembly: AssemblyVersion("101.8.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index 9ec540a320a..1eb1021afa0 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.7.0")]
+[assembly: AssemblyVersion("101.8.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index 899dd26ae97..7bb514be3fb 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.7.0")]
+[assembly: AssemblyVersion("101.8.0")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index 8e912e94d52..ca972e7a2bd 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.7.0")]
+[assembly: AssemblyVersion("101.8.0")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index 8e912e94d52..ca972e7a2bd 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.7.0")]
+[assembly: AssemblyVersion("101.8.0")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 5ccabf33fa9..495c25e84d6 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "101.7.0",
+    "version": "101.8.0",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From 11945b1dbfe27c1a3a5143a7bc2f73ebfc5eb8eb Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Tue, 24 Aug 2021 16:21:01 +0100
Subject: [PATCH 141/166] docs: adding docs for bitpacking (#898)

---
 doc/Articles/Guides/BitPacking/BitCount.md    | 113 ++++++++++++++++
 .../Guides/BitPacking/BitCountFromRange.md    | 127 ++++++++++++++++++
 doc/Articles/Guides/BitPacking/FloatPacker.md |   1 +
 .../Guides/BitPacking/QuaternionPacker.md     |   1 +
 doc/Articles/Guides/BitPacking/VarIntBlock.md |   3 +
 .../Guides/BitPacking/VectorPacker.md         |   1 +
 .../Guides/BitPacking/ZigZagEncode.md         |  97 +++++++++++++
 doc/Articles/Guides/BitPacking/index.md       |  13 ++
 doc/Articles/Guides/BitPacking/toc.yml        |  16 +++
 doc/Articles/Guides/toc.yml                   |   3 +
 10 files changed, 375 insertions(+)
 create mode 100644 doc/Articles/Guides/BitPacking/BitCount.md
 create mode 100644 doc/Articles/Guides/BitPacking/BitCountFromRange.md
 create mode 100644 doc/Articles/Guides/BitPacking/FloatPacker.md
 create mode 100644 doc/Articles/Guides/BitPacking/QuaternionPacker.md
 create mode 100644 doc/Articles/Guides/BitPacking/VarIntBlock.md
 create mode 100644 doc/Articles/Guides/BitPacking/VectorPacker.md
 create mode 100644 doc/Articles/Guides/BitPacking/ZigZagEncode.md
 create mode 100644 doc/Articles/Guides/BitPacking/index.md
 create mode 100644 doc/Articles/Guides/BitPacking/toc.yml

diff --git a/doc/Articles/Guides/BitPacking/BitCount.md b/doc/Articles/Guides/BitPacking/BitCount.md
new file mode 100644
index 00000000000..0e64bb52de2
--- /dev/null
+++ b/doc/Articles/Guides/BitPacking/BitCount.md
@@ -0,0 +1,113 @@
+# Bit Count
+
+The bit count of Integer based fields can be set using <xref:Mirage.Serialization.BitCountAttribute> 
+
+This will truncate the bits so that only the small bits are sent. There is no range checking for values using BitCount, so value that are too big or negative will not be unpacked correctly
+
+This means that `BitCount` should not be used with values that can be negative because this data will be lost. If you do need to send negative values then use [ZigZagEncode](./ZigZagEncode.md) or [BitCountFromRange](./BitCountFromRange.md)
+
+### Use cases
+
+- A Value with a maximum value
+- An index in an array of known size
+    - eg array with 10 elements, index can be sent as 4 bits
+- A Random int hash where you only need to send 16 bits
+
+### Supported Types
+
+- Byte
+- Short
+- UShort
+- Int
+- Uint
+- Long
+- ULong
+- Enum
+
+### Example 1
+
+Health which is between 0 and 100
+
+```cs
+public class MyNetworkBehaviour : NetworkBehaviour 
+{
+    [SyncVar, BitCount(7)]
+    public int Health;
+}
+```
+
+`BitCount = 7` so max value of Health is `127`
+
+`health = 57` will serialize to `011_1001`
+
+`health = -1` *(out of range)* will serialize to `111_1111`
+
+`health = 130` *(out of range)* will serialize to `000_0010`
+
+
+### Example 2
+
+Weapon index in a list of 6 weapons
+```cs
+public class MyNetworkBehaviour : NetworkBehaviour 
+{
+    [SyncVar, BitCount(3)]
+    public int WeaponIndex;
+}
+```
+
+`BitCount = 7` so max value of Health is 7
+
+`WeaponIndex = 5` will serialize to `101`
+
+
+### Generated Code
+
+Source:
+```cs 
+[SyncVar, BitCount(7)]
+public int myValue;
+```
+
+Generated:
+```cs
+public override bool SerializeSyncVars(NetworkWriter writer, bool initialState)
+{
+    ulong syncVarDirtyBits = base.SyncVarDirtyBits;
+    bool result = base.SerializeSyncVars(writer, initialize);
+
+    if (initialState) 
+    {
+        writer.Write((ulong)this.myValue, 7);
+        return true;
+    }
+
+    writer.Write(syncVarDirtyBits, 1);
+    if ((syncVarDirtyBits & 1UL) != 0UL)
+    {
+        writer.Write((ulong)this.myValue, 7);
+        result = true;
+    }
+
+    return result;
+}
+
+public override void DeserializeSyncVars(NetworkReader reader, bool initialState)
+{
+    base.DeserializeSyncVars(reader, initialState);
+
+    if (initialState)
+    {
+        this.myValue = reader.Read(7);
+        return;
+    }
+
+    ulong dirtyMask = reader.Read(1);
+    if ((dirtyMask & 1UL) != 0UL)
+    {
+        this.myValue = reader.Read(7);
+    }
+}
+```
+
+*last updated for Mirage v101.6.0*
\ No newline at end of file
diff --git a/doc/Articles/Guides/BitPacking/BitCountFromRange.md b/doc/Articles/Guides/BitPacking/BitCountFromRange.md
new file mode 100644
index 00000000000..1221bd01ccc
--- /dev/null
+++ b/doc/Articles/Guides/BitPacking/BitCountFromRange.md
@@ -0,0 +1,127 @@
+# Bit Count From Range
+
+The bit count of Integer based fields can be set using <xref:Mirage.Serialization.BitCountFromRangeAttribute>, It will use the given range to calculate the required bit count. This works in a similar way to [BitCount](./BitCount.md)
+
+The min value is subtracted from the value before it is written and added back on after it is read. This will shift all written values into the positive range for writing so that the sign bit is not lost.
+
+This will truncate the bits so that only the small bits are sent. There is no range checking for values using BitCount, so value that are too big or too small will not be unpacked correctly.
+
+Bit Count is calculated using `bitCount = Ceiling(Log2(max - min))`, so `min = -100`, `max = 100` results in `bit count = 8`
+
+Values are written using `Write(value - min, bitCount)` and read using `value = Read(bitCount) + min`
+
+### Use cases
+
+- A Value with a minimum and maximum value
+
+### Supported Types
+
+- Byte
+- Short
+- UShort
+- Int
+- Uint
+- Long
+- ULong
+- Enum
+
+### Example 1
+
+A modifier which can add to a character value to increase or decrease it
+
+```cs
+public class MyNetworkBehaviour : NetworkBehaviour 
+{
+    [SyncVar, BitCountFromRange(-100, 100)]
+    public int modifier;
+}
+```
+
+`Range = 200` so bit count is 8, causing real range to be -100 to 155
+
+`modifier = 57` will serialize to `1001_1101`
+
+`modifier = -57` will serialize to `0010_1011`
+
+`modifier = -110` *(out of range)*  will serialize to `1111_0110`
+
+`modifier = 130` will serialize to `1110_0110`, even tho 130 is out of range there is enough range because bit count rounds up.
+
+`modifier = 170` *(out of range)* will serialize to `0000_1110`
+
+
+### Example 2
+
+A Direction enum to say which way a model is facing
+
+```cs
+public enum MyDirection
+{
+    Backwards = -1,
+    None = 0,
+    Forwards = 1,
+}
+public class MyNetworkBehaviour : NetworkBehaviour 
+{
+    [SyncVar, BitCount(-1, 1)]
+    public MyDirection direction;
+}
+```
+
+`Range = 3` so bit count is `2`, causing real range to be -1 to 2
+
+`direction = -1` will serialize to `00`
+
+`direction = 1` will serialize to `10`
+
+
+### Generated Code
+
+Source:
+```cs 
+[SyncVar, BitCountFromRange(-100, 100)]
+public int myValue;
+```
+
+Generated:
+```cs
+public override bool SerializeSyncVars(NetworkWriter writer, bool initialState)
+{
+    ulong syncVarDirtyBits = base.SyncVarDirtyBits;
+    bool result = base.SerializeSyncVars(writer, initialize);
+
+    if (initialState) 
+    {
+        writer.Write((ulong)(this.myValue - (-100)), 8);
+        return true;
+    }
+
+    writer.Write(syncVarDirtyBits, 1);
+    if ((syncVarDirtyBits & 1UL) != 0UL)
+    {
+        writer.Write((ulong)(this.myValue - (-100)), 8);
+        result = true;
+    }
+
+    return result;
+}
+
+public override void DeserializeSyncVars(NetworkReader reader, bool initialState)
+{
+    base.DeserializeSyncVars(reader, initialState);
+
+    if (initialState)
+    {
+        this.myValue = reader.Read(8) + (-100);
+        return;
+    }
+    
+    ulong dirtyMask = reader.Read(1);
+    if ((dirtyMask & 1UL) != 0UL)
+    {
+        this.myValue = reader.Read(8) + (-100);
+    }
+}
+```
+
+*last updated for Mirage v101.6.0*
\ No newline at end of file
diff --git a/doc/Articles/Guides/BitPacking/FloatPacker.md b/doc/Articles/Guides/BitPacking/FloatPacker.md
new file mode 100644
index 00000000000..3843df1ca19
--- /dev/null
+++ b/doc/Articles/Guides/BitPacking/FloatPacker.md
@@ -0,0 +1 @@
+*work in progress*
\ No newline at end of file
diff --git a/doc/Articles/Guides/BitPacking/QuaternionPacker.md b/doc/Articles/Guides/BitPacking/QuaternionPacker.md
new file mode 100644
index 00000000000..3843df1ca19
--- /dev/null
+++ b/doc/Articles/Guides/BitPacking/QuaternionPacker.md
@@ -0,0 +1 @@
+*work in progress*
\ No newline at end of file
diff --git a/doc/Articles/Guides/BitPacking/VarIntBlock.md b/doc/Articles/Guides/BitPacking/VarIntBlock.md
new file mode 100644
index 00000000000..c750cd75012
--- /dev/null
+++ b/doc/Articles/Guides/BitPacking/VarIntBlock.md
@@ -0,0 +1,3 @@
+*work in progress*
+
+// todo update name to match attribute
\ No newline at end of file
diff --git a/doc/Articles/Guides/BitPacking/VectorPacker.md b/doc/Articles/Guides/BitPacking/VectorPacker.md
new file mode 100644
index 00000000000..3843df1ca19
--- /dev/null
+++ b/doc/Articles/Guides/BitPacking/VectorPacker.md
@@ -0,0 +1 @@
+*work in progress*
\ No newline at end of file
diff --git a/doc/Articles/Guides/BitPacking/ZigZagEncode.md b/doc/Articles/Guides/BitPacking/ZigZagEncode.md
new file mode 100644
index 00000000000..11b55a2fa56
--- /dev/null
+++ b/doc/Articles/Guides/BitPacking/ZigZagEncode.md
@@ -0,0 +1,97 @@
+# ZigZag Encode
+
+To encoding a value using [ZigZag Encoding](https://gist.github.com/mfuerstenau/ba870a29e16536fdbaba) you can use the <xref:Mirage.Serialization.ZigZagEncodeAttribute> 
+
+This will cause negative values to be encoded as positive so that the sign bit is not lost when packing.
+
+This works best with [VarIntBlock](./VarIntBlock.md) but also works with [BitCount](./BitCount.md).
+
+This attribute can not be used on the same field as [BitCountFromRange](./BitCountFromRange.md), this is because `BitCountFromRange` already ensures negative values are packed correctly.
+
+> [!NOTE]
+> The sign of a value will take up 1 bit, so if the value is in range -+100 it will need a bit count of 8
+
+### Use cases
+
+- A value that can be negative or positive
+
+### Supported Types
+
+- Byte
+- Short
+- Int
+- Long
+- Enum
+
+### Example 1
+
+A modifier which can add to a character value to increase or decrease it
+
+```cs
+public class MyNetworkBehaviour : NetworkBehaviour 
+{
+    [SyncVar, BitCount(8), ZigZagEncode]
+    public int modifier;
+}
+```
+
+`Range = 200` so bit count is 8, causing real range to be -128 to 127
+
+`modifier = 57` will serialize to `0111_0010`
+
+`modifier = -57` will serialize to `0111_0001`
+
+`modifier = -110` will serialize to `1101_1011`, even tho -110 is out of range there is enough range because bit count rounds up.
+
+`modifier = 130` *(out of range)* will serialize to `0000_0100`
+
+### Generated Code
+
+Source:
+```cs 
+[SyncVar, BitCount(8), ZigZagEncode]
+public int myValue;
+```
+
+Generated:
+```cs
+public override bool SerializeSyncVars(NetworkWriter writer, bool initialState)
+{
+    ulong syncVarDirtyBits = base.SyncVarDirtyBits;
+    bool result = base.SerializeSyncVars(writer, initialize);
+
+    if (initialState) 
+    {
+        writer.Write((ulong)ZigZag.Encode(this.myValue), 8);
+        return true;
+    }
+
+    writer.Write(syncVarDirtyBits, 1);
+    if ((syncVarDirtyBits & 1UL) != 0UL)
+    {
+        writer.Write((ulong)ZigZag.Encode(this.myValue), 8);
+        result = true;
+    }
+
+    return result;
+}
+
+public override void DeserializeSyncVars(NetworkReader reader, bool initialState)
+{
+    base.DeserializeSyncVars(reader, initialState);
+
+    if (initialState)
+    {
+        this.myValue = ZigZag.Decode(reader.Read(8));
+        return;
+    }
+
+    ulong dirtyMask = reader.Read(1);
+    if ((dirtyMask & 1UL) != 0UL)
+    {
+        this.myValue = ZigZag.Decode(reader.Read(8));
+    }
+}
+```
+
+*last updated for Mirage v101.6.0*
\ No newline at end of file
diff --git a/doc/Articles/Guides/BitPacking/index.md b/doc/Articles/Guides/BitPacking/index.md
new file mode 100644
index 00000000000..487e6c14397
--- /dev/null
+++ b/doc/Articles/Guides/BitPacking/index.md
@@ -0,0 +1,13 @@
+# Bit Packing
+
+Bit packing is a form of data compression that reducing that number of bits it takes to serialize a value.
+
+A simple example of this is an integer that is always between 0 and 100. Normally an integer will be serialized as 32 bits, but knowing its range is 100 it can be packed into only 7 bits.
+
+## Bit Packing in Mirage
+
+Mirage has many attributes that can be applied to SyncVars and Rpc parameters
+
+- [BitCount](./BitCount.md) Sets the number of bits on an integer
+- [BitCountFromRange](./BitCountFromRange.md) Sets the number of bits from a given range, rounding up.
+- [ZigZagEncode](./ZigZagEncode.md) Encodes a value using [ZigZag Encoding](https://gist.github.com/mfuerstenau/ba870a29e16536fdbaba). Only useable with [BitCount](./BitCount.md) or [VarIntBlock](./VarIntBlock.md)
diff --git a/doc/Articles/Guides/BitPacking/toc.yml b/doc/Articles/Guides/BitPacking/toc.yml
new file mode 100644
index 00000000000..14a8676642b
--- /dev/null
+++ b/doc/Articles/Guides/BitPacking/toc.yml
@@ -0,0 +1,16 @@
+- name: Overview
+  href: index.md
+- name: Bit Count
+  href: BitCount.md
+- name: Bit Count From Range
+  href: BitCountFromRange.md
+- name: ZigZag Encode
+  href: ZigZagEncode.md
+- name: Variable Sized Int Block packer
+  href: VarIntBlock.md
+- name: Float Packer
+  href: FloatPacker.md
+- name: Vector Packer
+  href: VectorPacker.md
+- name: Quaternion Packer
+  href: QuaternionPacker.md
diff --git a/doc/Articles/Guides/toc.yml b/doc/Articles/Guides/toc.yml
index a95b844a025..346bba0b66e 100644
--- a/doc/Articles/Guides/toc.yml
+++ b/doc/Articles/Guides/toc.yml
@@ -28,6 +28,9 @@
 - name: GameObjects
   href: GameObjects/toc.yml
   topicHref: GameObjects/index.md
+- name: Bit Packing
+  href: BitPacking/toc.yml
+  topicHref: BitPacking/index.md
 - name: Mirror Migration Guide
   topicHref: MirrorMigration.md
 - name: Community Guides

From cb3edec122979d7f5ee647f7623c5ea959b21574 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Thu, 26 Aug 2021 16:50:15 +0100
Subject: [PATCH 142/166] docs(Weaver): adding doc commments to WeaverException

---
 Assets/Mirage/Weaver/WeaverExceptions.cs | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/Assets/Mirage/Weaver/WeaverExceptions.cs b/Assets/Mirage/Weaver/WeaverExceptions.cs
index 09cbb4f9ac5..60053de0a75 100644
--- a/Assets/Mirage/Weaver/WeaverExceptions.cs
+++ b/Assets/Mirage/Weaver/WeaverExceptions.cs
@@ -4,7 +4,20 @@
 
 namespace Mirage.Weaver
 {
+    /// <summary>
+    /// Weaver Exception should be thrown when there is a problem with the users code that they should fix
+    /// <para>
+    ///     For example, if the user uses an unsupported type a WeaverException should be thrown with a
+    ///     message explaining the problem, and the MemberReference to help the user find the issue
+    /// </para>
+    /// <para>
+    ///     For Exception that are internally to weaver (eg weaver didn't work right) and normal Exception should be thrown
+    /// </para>
+    /// </summary>
+    // should be caught within weaver and returned to user using DiagnosticMessage
+#pragma warning disable S3871 // Exception types should be "public"
     internal abstract class WeaverException : Exception
+#pragma warning restore S3871 // Exception types should be "public"
     {
         public readonly SequencePoint SequencePoint;
         public readonly MemberReference MemberReference;

From ca949ea15b900ee7d35d180b73e44103ed54d064 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Thu, 26 Aug 2021 17:06:16 +0100
Subject: [PATCH 143/166] fix(NanoSocket): adding dispose and finalize (#904)

this will hopefully clean up state when unity force reloads assemblies
---
 .../Mirage/Runtime/Sockets/Udp/NanoSocket.cs  | 32 +++++++++++++------
 1 file changed, 23 insertions(+), 9 deletions(-)

diff --git a/Assets/Mirage/Runtime/Sockets/Udp/NanoSocket.cs b/Assets/Mirage/Runtime/Sockets/Udp/NanoSocket.cs
index f5d16fd93be..49e10a33e79 100644
--- a/Assets/Mirage/Runtime/Sockets/Udp/NanoSocket.cs
+++ b/Assets/Mirage/Runtime/Sockets/Udp/NanoSocket.cs
@@ -9,16 +9,30 @@ public class NanoSocketException : Exception
     {
         public NanoSocketException(string message) : base(message) { }
     }
-    public class NanoSocket : ISocket
+    public sealed class NanoSocket : ISocket, IDisposable
     {
         Socket socket;
         NanoEndPoint receiveEndPoint;
         readonly int bufferSize;
 
+        bool needsDisposing;
+
         public NanoSocket(UdpSocketFactory factory)
         {
             bufferSize = factory.BufferSize;
         }
+        ~NanoSocket()
+        {
+            Dispose();
+        }
+
+        void InitSocket()
+        {
+            socket = UDP.Create(bufferSize, bufferSize);
+            UDP.SetDontFragment(socket);
+            UDP.SetNonBlocking(socket);
+            needsDisposing = true;
+        }
 
         public void Bind(IEndPoint endPoint)
         {
@@ -32,9 +46,16 @@ public void Bind(IEndPoint endPoint)
             }
         }
 
-        public void Close()
+        public void Dispose()
         {
+            if (!needsDisposing) return;
             UDP.Destroy(ref socket);
+            needsDisposing = false;
+        }
+
+        public void Close()
+        {
+            Dispose();
         }
 
         public void Connect(IEndPoint endPoint)
@@ -67,12 +88,5 @@ public void Send(IEndPoint endPoint, byte[] packet, int length)
             var nanoEndPoint = (NanoEndPoint)endPoint;
             UDP.Send(socket, ref nanoEndPoint.address, packet, length);
         }
-
-        void InitSocket()
-        {
-            socket = UDP.Create(bufferSize, bufferSize);
-            UDP.SetDontFragment(socket);
-            UDP.SetNonBlocking(socket);
-        }
     }
 }

From 273d27ce03efee81f507def913ce9a906b1a38f2 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Thu, 26 Aug 2021 17:07:47 +0100
Subject: [PATCH 144/166] feat: attributes to use new float bit packers (#896)

* feat: attributes to use new float bit packers

* docs

* adding attribute

* implementing float packer attribute and tests

* init static field

* finishing weaver tests

* removing old todo

* renaming FloatPackerAttribute to FloatPackAttribute and removing FromBitCount

* improving doc comments
---
 .../Serialization/Packers/FloatPacker.cs      |  11 +-
 .../Serialization/Packers/QuaternionPacker.cs |   2 +-
 .../Runtime/Serialization/WeaverAttributes.cs |  41 ++++--
 Assets/Mirage/Weaver/ModuleExtension.cs       |  15 ++-
 .../Weaver/Processors/SyncVarProcessor.cs     | 118 ++++++++++++++++--
 .../Processors/SyncVars/BitCountFinder.cs     |   2 +-
 .../SyncVars/BitCountFromRangeFinder.cs       |   4 +-
 .../Processors/SyncVars/FloatPackerFinder.cs  |  60 +++++++++
 .../SyncVars/FloatPackerFinder.cs.meta        |  11 ++
 .../Processors/SyncVars/FoundSyncVar.cs       |  11 ++
 .../Processors/SyncVars/ZigZagFinder.cs       |   2 +-
 Assets/Mirage/Weaver/WeaverExceptions.cs      |   4 +
 Assets/Tests/Generated/FloatPackTests.meta    |   8 ++
 .../FloatPackBehaviour_100_10.cs              |  44 +++++++
 .../FloatPackBehaviour_100_10.cs.meta         |  11 ++
 .../FloatPackBehaviour_100_14.cs              |  44 +++++++
 .../FloatPackBehaviour_100_14.cs.meta         |  11 ++
 .../FloatPackBehaviour_10_10.cs               |  44 +++++++
 .../FloatPackBehaviour_10_10.cs.meta          |  11 ++
 .../FloatPackTests/FloatPackBehaviour_1_8.cs  |  44 +++++++
 .../FloatPackBehaviour_1_8.cs.meta            |  11 ++
 .../FloatPackBehaviour_500_14.cs              |  44 +++++++
 .../FloatPackBehaviour_500_14.cs.meta         |  11 ++
 .../FloatPackBehaviour_500_17.cs              |  44 +++++++
 .../FloatPackBehaviour_500_17.cs.meta         |  11 ++
 .../FloatPackerBehaviour_100_10.cs            |  44 +++++++
 .../FloatPackerBehaviour_100_10.cs.meta       |  11 ++
 .../FloatPackerBehaviour_100_14.cs            |  44 +++++++
 .../FloatPackerBehaviour_100_14.cs.meta       |  11 ++
 .../FloatPackerBehaviour_10_10.cs             |  44 +++++++
 .../FloatPackerBehaviour_10_10.cs.meta        |  11 ++
 .../FloatPackerBehaviour_1_8.cs               |  44 +++++++
 .../FloatPackerBehaviour_1_8.cs.meta          |  11 ++
 .../FloatPackerBehaviour_500_14.cs            |  44 +++++++
 .../FloatPackerBehaviour_500_14.cs.meta       |  11 ++
 .../FloatPackerBehaviour_500_17.cs            |  44 +++++++
 .../FloatPackerBehaviour_500_17.cs.meta       |  11 ++
 .../Generators/.FloatPackTestTemplate.txt     |  44 +++++++
 .../Generators/FloatPackTestGenerator.cs      |  36 ++++++
 .../Generators/FloatPackTestGenerator.cs.meta |  11 ++
 .../Packers/FloatPackerCreateTest.cs          |   8 +-
 Assets/Tests/Weaver/BitAttributeTests.cs      |  37 ++++++
 .../Weaver/BitAttributeTests~/BitCount.cs     |   1 -
 .../Weaver/BitAttributeTests~/FloatPack.cs    |  20 +++
 .../BitAttributeTests~/FloatPackInvalid.cs    |  44 +++++++
 .../Tests/Weaver/BitAttributeTests~/ZigZag.cs |   1 -
 doc/Articles/Guides/BitPacking/BitCount.md    |   2 +-
 .../Guides/BitPacking/BitCountFromRange.md    |   2 +-
 doc/Articles/Guides/BitPacking/FloatPack.md   | 108 ++++++++++++++++
 doc/Articles/Guides/BitPacking/FloatPacker.md |   1 -
 .../Guides/BitPacking/ZigZagEncode.md         |   2 +-
 doc/Articles/Guides/BitPacking/index.md       |   1 +
 doc/Articles/Guides/BitPacking/toc.yml        |   2 +-
 53 files changed, 1216 insertions(+), 53 deletions(-)
 create mode 100644 Assets/Mirage/Weaver/Processors/SyncVars/FloatPackerFinder.cs
 create mode 100644 Assets/Mirage/Weaver/Processors/SyncVars/FloatPackerFinder.cs.meta
 create mode 100644 Assets/Tests/Generated/FloatPackTests.meta
 create mode 100644 Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_100_10.cs
 create mode 100644 Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_100_10.cs.meta
 create mode 100644 Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_100_14.cs
 create mode 100644 Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_100_14.cs.meta
 create mode 100644 Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_10_10.cs
 create mode 100644 Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_10_10.cs.meta
 create mode 100644 Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_1_8.cs
 create mode 100644 Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_1_8.cs.meta
 create mode 100644 Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_500_14.cs
 create mode 100644 Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_500_14.cs.meta
 create mode 100644 Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_500_17.cs
 create mode 100644 Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_500_17.cs.meta
 create mode 100644 Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_100_10.cs
 create mode 100644 Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_100_10.cs.meta
 create mode 100644 Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_100_14.cs
 create mode 100644 Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_100_14.cs.meta
 create mode 100644 Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_10_10.cs
 create mode 100644 Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_10_10.cs.meta
 create mode 100644 Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_1_8.cs
 create mode 100644 Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_1_8.cs.meta
 create mode 100644 Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_500_14.cs
 create mode 100644 Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_500_14.cs.meta
 create mode 100644 Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_500_17.cs
 create mode 100644 Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_500_17.cs.meta
 create mode 100644 Assets/Tests/Generators/.FloatPackTestTemplate.txt
 create mode 100644 Assets/Tests/Generators/FloatPackTestGenerator.cs
 create mode 100644 Assets/Tests/Generators/FloatPackTestGenerator.cs.meta
 create mode 100644 Assets/Tests/Weaver/BitAttributeTests~/FloatPack.cs
 create mode 100644 Assets/Tests/Weaver/BitAttributeTests~/FloatPackInvalid.cs
 create mode 100644 doc/Articles/Guides/BitPacking/FloatPack.md
 delete mode 100644 doc/Articles/Guides/BitPacking/FloatPacker.md

diff --git a/Assets/Mirage/Runtime/Serialization/Packers/FloatPacker.cs b/Assets/Mirage/Runtime/Serialization/Packers/FloatPacker.cs
index 800f7d5c5e5..e7b9f9d8f80 100644
--- a/Assets/Mirage/Runtime/Serialization/Packers/FloatPacker.cs
+++ b/Assets/Mirage/Runtime/Serialization/Packers/FloatPacker.cs
@@ -49,21 +49,12 @@ public sealed class FloatPacker
         /// <param name="lowestPrecision">lowest precision, actual precision will be caculated from number of bits used</param>
         public FloatPacker(float max, float lowestPrecision) : this(max, BitHelper.BitCount(max, lowestPrecision)) { }
 
-        /// <summary>
-        /// Create a new instance using bit count
-        /// </summary>
-        /// <param name="max"></param>
-        /// <param name="lowestPrecision">lowest precision, actual precision will be caculated from number of bits used</param>
-        public static FloatPacker FromBitCount(float max, int bitCount)
-        {
-            return new FloatPacker(max, bitCount);
-        }
         /// <summary>
         /// 
         /// </summary>
         /// <param name="max"></param>
         /// <param name="lowestPrecision">lowest precision, actual precision will be caculated from number of bits used</param>
-        private FloatPacker(float max, int bitCount)
+        public FloatPacker(float max, int bitCount)
         {
             this.bitCount = bitCount;
             // not sure what max bit count should be,
diff --git a/Assets/Mirage/Runtime/Serialization/Packers/QuaternionPacker.cs b/Assets/Mirage/Runtime/Serialization/Packers/QuaternionPacker.cs
index cc3c5a36e85..4387be760ca 100644
--- a/Assets/Mirage/Runtime/Serialization/Packers/QuaternionPacker.cs
+++ b/Assets/Mirage/Runtime/Serialization/Packers/QuaternionPacker.cs
@@ -62,7 +62,7 @@ public QuaternionPacker(int quaternionBitLength = 10)
             // (this.BitLength - 1) because pack sign by itself
             bitCountPerElement = quaternionBitLength;
             totalBitCount = 2 + (quaternionBitLength * 3);
-            floatPacker = FloatPacker.FromBitCount(MaxValue, quaternionBitLength);
+            floatPacker = new FloatPacker(MaxValue, quaternionBitLength);
             readMask = (uint)BitMask.Mask(bitCountPerElement);
         }
 
diff --git a/Assets/Mirage/Runtime/Serialization/WeaverAttributes.cs b/Assets/Mirage/Runtime/Serialization/WeaverAttributes.cs
index 65c604c2247..cc6fc0b034d 100644
--- a/Assets/Mirage/Runtime/Serialization/WeaverAttributes.cs
+++ b/Assets/Mirage/Runtime/Serialization/WeaverAttributes.cs
@@ -2,6 +2,9 @@
 
 namespace Mirage.Serialization
 {
+    // weaver doesn't need constructor parameters to be used, so we can have constructor without fields/properties
+#pragma warning disable IDE0060 // Remove unused parameter
+
     /// <summary>
     /// Tells Weaver to ignore an Extension method
     /// </summary>
@@ -14,37 +17,51 @@ public sealed class WeaverIgnoreAttribute : Attribute { }
     /// <para>
     /// NOTE: bits are truncated when using this, so signed values will lose their sign. Use <see cref="ZigZagEncodeAttribute"/> as well if value might be negative
     /// </para>
+    /// <para>Also See: <see href="https://miragenet.github.io/Mirage/Articles/Guides/BitPacking/BitCount.html">Bit Packing Documentation</see></para>
     /// </summary>
     [AttributeUsage(AttributeTargets.Field | AttributeTargets.Parameter)]
     public class BitCountAttribute : Attribute
     {
-        /// <summary>
-        /// Value should be between 1 and 64
-        /// </summary>
-        public int BitCount { get; private set; }
-
-        /// <summary>
-        /// 
-        /// </summary>
         /// <param name="bitCount">Value should be between 1 and 64</param>
-        public BitCountAttribute(int bitCount)
-        {
-            BitCount = bitCount;
-        }
+        public BitCountAttribute(int bitCount) { }
     }
 
+    /// <summary>
+    /// Calculates bitcount from then given min/max values and then packs using <see cref="BitCountAttribute"/>
+    /// <para>Also See: <see href="https://miragenet.github.io/Mirage/Articles/Guides/BitPacking/BitCountFromRange.html">Bit Packing Documentation</see></para>
+    /// </summary>
     [AttributeUsage(AttributeTargets.Field | AttributeTargets.Parameter)]
     public class BitCountFromRangeAttribute : Attribute
     {
+        /// <param name="min">minimum possible int value</param>
+        /// <param name="max">minimum possible max value</param>
         public BitCountFromRangeAttribute(int min, int max) { }
     }
 
     /// <summary>
     /// Used along size <see cref="BitCountAttribute"/> to encodes a interager value using <see cref="ZigZag"/> so that both positive and negative values can be sent
+    /// <para>Also See: <see href="https://miragenet.github.io/Mirage/Articles/Guides/BitPacking/BitCountFromRange.html">Bit Packing Documentation</see></para>
     /// </summary>
     [AttributeUsage(AttributeTargets.Field | AttributeTargets.Parameter)]
     public class ZigZagEncodeAttribute : Attribute
     {
         public ZigZagEncodeAttribute() { }
     }
+
+    /// <summary>
+    /// Packs a float field, clamped from -max to +max, with 
+    /// <para>Also See: <see href="https://miragenet.github.io/Mirage/Articles/Guides/BitPacking/BitCountFromRange.html">Bit Packing Documentation</see></para>
+    /// </summary>
+    [AttributeUsage(AttributeTargets.Field | AttributeTargets.Parameter)]
+    public class FloatPackAttribute : Attribute
+    {
+        /// <param name="max">Max value of the float</param>
+        /// <param name="precision">Smallest possible value of the field. Real precision woll be caculated using bitcount but will always be lower than this parameter</param>
+        public FloatPackAttribute(float max, float precision) { }
+
+        /// <param name="max">Max value of the float</param>
+        /// <param name="bitCount">number of bits to pack the field into.</param>
+        public FloatPackAttribute(float max, int bitCount) { }
+    }
+#pragma warning restore IDE0060 // Remove unused parameter
 }
diff --git a/Assets/Mirage/Weaver/ModuleExtension.cs b/Assets/Mirage/Weaver/ModuleExtension.cs
index 71aa1441570..597a9000ffa 100644
--- a/Assets/Mirage/Weaver/ModuleExtension.cs
+++ b/Assets/Mirage/Weaver/ModuleExtension.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Linq.Expressions;
 using System.Reflection;
 using Mono.Cecil;
@@ -9,6 +9,17 @@ namespace Mirage.Weaver
     public static class ModuleExtension
     {
         public static MethodReference ImportReference(this ModuleDefinition module, Expression<Action> expression) => ImportReference(module, (LambdaExpression)expression);
+
+        /// <summary>
+        /// this can be used to import reference to a non-static method
+        /// <para>
+        /// for example, <code>(NetworkWriter writer) => writer.Write(default, default)</code>
+        /// </para>
+        /// </summary>
+        /// <typeparam name="T"></typeparam>
+        /// <param name="module"></param>
+        /// <param name="expression"></param>
+        /// <returns></returns>
         public static MethodReference ImportReference<T>(this ModuleDefinition module, Expression<Action<T>> expression) => ImportReference(module, (LambdaExpression)expression);
 
         public static TypeReference ImportReference<T>(this ModuleDefinition module) => module.ImportReference(typeof(T));
@@ -53,4 +64,4 @@ public static TypeDefinition GeneratedClass(this ModuleDefinition module)
             return type;
         }
     }
-}
\ No newline at end of file
+}
diff --git a/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs b/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
index 9674091c73b..34ef0c66054 100644
--- a/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
@@ -1,9 +1,11 @@
 using System;
+using System.Linq;
 using Mirage.Serialization;
 using Mirage.Weaver.NetworkBehaviours;
 using Mirage.Weaver.SyncVars;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
+using Mono.Cecil.Rocks;
 using FieldAttributes = Mono.Cecil.FieldAttributes;
 using MethodAttributes = Mono.Cecil.MethodAttributes;
 using PropertyAttributes = Mono.Cecil.PropertyAttributes;
@@ -40,7 +42,8 @@ public void ProcessSyncVars(TypeDefinition td, IWeaverLogger logger)
             behaviour.GetSyncVarCountFromBase();
 
             // find syncvars
-            foreach (FieldDefinition fd in td.Fields)
+            // use ToArray to create copy, ProcessSyncVar might add new fields
+            foreach (FieldDefinition fd in td.Fields.ToArray())
             {
                 // try/catch for each field, and log once
                 // we dont want to spam multiple logs for a single field
@@ -127,6 +130,73 @@ void ProcessSyncVar(FoundSyncVar syncVar)
 
             syncVar.ProcessAttributes();
             syncVar.FindSerializeFunctions(writers, readers);
+
+            if (syncVar.FloatPackSettings.HasValue)
+            {
+                createFloatPackField(syncVar);
+            }
+        }
+
+        private void createFloatPackField(FoundSyncVar syncVar)
+        {
+            TypeReference packerRer = module.ImportReference(typeof(FloatPacker));
+            var packerField = new FieldDefinition($"{syncVar.FieldDefinition.Name}__Packer", FieldAttributes.Private | FieldAttributes.Static, packerRer);
+            packerField.DeclaringType = syncVar.FieldDefinition.DeclaringType;
+            syncVar.FieldDefinition.DeclaringType.Fields.Add(packerField);
+            syncVar.PackerField = packerField;
+
+
+            // todo move this
+            MethodDefinition cctor = behaviour.TypeDefinition.GetMethod(".cctor");
+            if (cctor != null)
+            {
+                // remove the return opcode from end of function. will add our own later.
+                if (cctor.Body.Instructions.Count != 0)
+                {
+                    Instruction retInstr = cctor.Body.Instructions[cctor.Body.Instructions.Count - 1];
+                    if (retInstr.OpCode == OpCodes.Ret)
+                    {
+                        cctor.Body.Instructions.RemoveAt(cctor.Body.Instructions.Count - 1);
+                    }
+                    else
+                    {
+                        throw new FloatPackException($"{behaviour.TypeDefinition.Name} has invalid class constructor", cctor);
+                    }
+                }
+            }
+            else
+            {
+                // make one!
+                cctor = behaviour.TypeDefinition.AddMethod(".cctor", MethodAttributes.Private |
+                        MethodAttributes.HideBySig |
+                        MethodAttributes.SpecialName |
+                        MethodAttributes.RTSpecialName |
+                        MethodAttributes.Static);
+            }
+
+            ILProcessor worker = cctor.Body.GetILProcessor();
+
+            worker.Append(worker.Create(OpCodes.Ldc_R4, syncVar.FloatPackSettings.Value.max));
+
+            // floatPacker has 2 constructors, get the one that matches the attribute type
+            MethodReference packerCtor = null;
+            if (syncVar.FloatPackSettings.Value.precision.HasValue)
+            {
+                worker.Append(worker.Create(OpCodes.Ldc_R4, syncVar.FloatPackSettings.Value.precision.Value));
+                packerCtor = module.ImportReference(packerRer.Resolve().GetConstructors().First(x => x.Parameters[1].ParameterType.Is<float>()));
+            }
+            else if (syncVar.FloatPackSettings.Value.bitCount.HasValue)
+            {
+                worker.Append(worker.Create(OpCodes.Ldc_I4, syncVar.FloatPackSettings.Value.bitCount.Value));
+                packerCtor = module.ImportReference(packerRer.Resolve().GetConstructors().First(x => x.Parameters[1].ParameterType.Is<int>()));
+            }
+            else
+            {
+                throw new InvalidOperationException($"Invalid FloatPackSettings");
+            }
+            worker.Append(worker.Create(OpCodes.Newobj, packerCtor));
+            worker.Append(worker.Create(OpCodes.Stsfld, packerField));
+            worker.Append(worker.Create(OpCodes.Ret));
         }
 
         MethodDefinition GenerateSyncVarGetter(FoundSyncVar syncVar)
@@ -428,6 +498,10 @@ void WriteFromField(ILProcessor worker, ParameterDefinition writerParameter, Fou
             {
                 WriteWithBitCount();
             }
+            else if (syncVar.FloatPackSettings.HasValue)
+            {
+                WriteFloatPack();
+            }
             else
             {
                 WriteDefault();
@@ -484,6 +558,18 @@ void WriteSubtractMinValue()
                 worker.Append(worker.Create(OpCodes.Ldc_I4, syncVar.BitCountMinValue.Value));
                 worker.Append(worker.Create(OpCodes.Sub));
             }
+            void WriteFloatPack()
+            {
+                MethodReference packMethod = module.ImportReference((FloatPacker p) => p.Pack(default, default));
+
+                // Generates: packer.pack(writer, field)
+                worker.Append(worker.Create(OpCodes.Ldarg_0));
+                worker.Append(worker.Create(OpCodes.Ldfld, syncVar.PackerField.MakeHostGenericIfNeeded()));
+                worker.Append(worker.Create(OpCodes.Ldarg, writerParameter));
+                worker.Append(worker.Create(OpCodes.Ldarg_0));
+                worker.Append(worker.Create(OpCodes.Ldfld, syncVar.FieldDefinition.MakeHostGenericIfNeeded()));
+                worker.Append(worker.Create(OpCodes.Call, packMethod));
+            }
         }
 
 
@@ -598,14 +684,22 @@ void DeserializeField(ILProcessor worker, MethodDefinition deserialize, Paramete
 
         void ReadToField(ILProcessor worker, ParameterDefinition readerParameter, FoundSyncVar syncVar)
         {
+            // all methods 
+            worker.Append(worker.Create(OpCodes.Ldarg_0));
             if (syncVar.BitCount.HasValue)
             {
                 ReadWithBitCount();
             }
+            else if (syncVar.FloatPackSettings.HasValue)
+            {
+                ReadFloatPack();
+            }
             else
             {
                 ReadDefault();
             }
+            worker.Append(worker.Create(OpCodes.Stfld, syncVar.FieldDefinition.MakeHostGenericIfNeeded()));
+
 
             // Local Functions
 
@@ -614,25 +708,15 @@ void ReadDefault()
                 // if ReadFunction is null it means there was an error earlier, so we dont need to do anything here
                 if (syncVar.ReadFunction == null) { return; }
 
-                // put `this` on stack, for Stfld later
-                worker.Append(worker.Create(OpCodes.Ldarg_0));
-
                 // add `reader` to stack
                 worker.Append(worker.Create(OpCodes.Ldarg, readerParameter));
                 // call read function
                 worker.Append(worker.Create(OpCodes.Call, syncVar.ReadFunction));
-
-                // store result of read to `this.syncvar`
-                worker.Append(worker.Create(OpCodes.Stfld, syncVar.FieldDefinition.MakeHostGenericIfNeeded()));
             }
             void ReadWithBitCount()
             {
                 MethodReference readWithBitCount = module.ImportReference(readerParameter.ParameterType.Resolve().GetMethod(nameof(NetworkReader.Read)));
 
-
-                // put `this` on stack, for Stfld later
-                worker.Append(worker.Create(OpCodes.Ldarg_0));
-
                 // add `reader` to stack
                 worker.Append(worker.Create(OpCodes.Ldarg, readerParameter));
                 // add `bitCount` to stack
@@ -654,8 +738,6 @@ void ReadWithBitCount()
                 {
                     ReadAddMinValue();
                 }
-
-                worker.Append(worker.Create(OpCodes.Stfld, syncVar.FieldDefinition.MakeHostGenericIfNeeded()));
             }
             void ReadZigZag()
             {
@@ -671,6 +753,16 @@ void ReadAddMinValue()
                 worker.Append(worker.Create(OpCodes.Ldc_I4, syncVar.BitCountMinValue.Value));
                 worker.Append(worker.Create(OpCodes.Add));
             }
+            void ReadFloatPack()
+            {
+                MethodReference unpackMethod = module.ImportReference((FloatPacker p) => p.Unpack(default(NetworkReader)));
+
+                // Generates: ... = packer.unpack(reader)
+                worker.Append(worker.Create(OpCodes.Ldarg_0));
+                worker.Append(worker.Create(OpCodes.Ldfld, syncVar.PackerField.MakeHostGenericIfNeeded()));
+                worker.Append(worker.Create(OpCodes.Ldarg, readerParameter));
+                worker.Append(worker.Create(OpCodes.Call, unpackMethod));
+            }
         }
     }
 }
diff --git a/Assets/Mirage/Weaver/Processors/SyncVars/BitCountFinder.cs b/Assets/Mirage/Weaver/Processors/SyncVars/BitCountFinder.cs
index a92ba7e890b..042a14ada99 100644
--- a/Assets/Mirage/Weaver/Processors/SyncVars/BitCountFinder.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncVars/BitCountFinder.cs
@@ -4,7 +4,7 @@
 
 namespace Mirage.Weaver.SyncVars
 {
-    public static class BitCountFinder
+    internal static class BitCountFinder
     {
         public static (int? bitCount, OpCode? ConvertCode) GetBitCount(FieldDefinition syncVar)
         {
diff --git a/Assets/Mirage/Weaver/Processors/SyncVars/BitCountFromRangeFinder.cs b/Assets/Mirage/Weaver/Processors/SyncVars/BitCountFromRangeFinder.cs
index befb68f6572..cbc7e0d66fb 100644
--- a/Assets/Mirage/Weaver/Processors/SyncVars/BitCountFromRangeFinder.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncVars/BitCountFromRangeFinder.cs
@@ -5,9 +5,9 @@
 
 namespace Mirage.Weaver.SyncVars
 {
-    public static class BitCountFromRangeFinder
+    internal static class BitCountFromRangeFinder
     {
-        internal static (int? BitCount, OpCode? BitCountConvert, int? MinValue) GetBitFoundFromRange(FieldDefinition syncVar, bool hasBitCount)
+        public static (int? BitCount, OpCode? BitCountConvert, int? MinValue) GetBitFoundFromRange(FieldDefinition syncVar, bool hasBitCount)
         {
             CustomAttribute attribute = syncVar.GetCustomAttribute<BitCountFromRangeAttribute>();
 
diff --git a/Assets/Mirage/Weaver/Processors/SyncVars/FloatPackerFinder.cs b/Assets/Mirage/Weaver/Processors/SyncVars/FloatPackerFinder.cs
new file mode 100644
index 00000000000..1e8b0db6642
--- /dev/null
+++ b/Assets/Mirage/Weaver/Processors/SyncVars/FloatPackerFinder.cs
@@ -0,0 +1,60 @@
+using System;
+using Mirage.Serialization;
+using Mono.Cecil;
+
+namespace Mirage.Weaver.SyncVars
+{
+    internal static class FloatPackFinder
+    {
+        public static FloatPackSettings? GetPackerSettings(FieldDefinition syncVar)
+        {
+            CustomAttribute attribute = syncVar.GetCustomAttribute<FloatPackAttribute>();
+            if (attribute == null)
+                return default;
+
+            if (!syncVar.FieldType.Is<float>())
+            {
+                throw new FloatPackException($"{syncVar.FieldType} is not a supported type for [FloatPack]", syncVar);
+            }
+
+            var settings = new FloatPackSettings();
+            settings.max = (float)attribute.ConstructorArguments[0].Value;
+            if (settings.max <= 0)
+            {
+                throw new FloatPackException($"Max must be above 0, max:{settings.max}", syncVar);
+            }
+
+            CustomAttributeArgument arg1 = attribute.ConstructorArguments[1];
+            if (arg1.Type.Is<float>())
+            {
+                float precision = (float)arg1.Value;
+                if (precision < 0)
+                {
+                    throw new FloatPackException($"Precsion must be positive, precision:{precision}", syncVar);
+                }
+                // todo is there a better way to check if Precsion is too small?
+                double expectedBitCount = Math.Floor(Math.Log(2 * settings.max / precision, 2)) + 1;
+                if (expectedBitCount > 30)
+                {
+                    throw new FloatPackException($"Precsion is too small, precision:{precision}", syncVar);
+                }
+                settings.precision = precision;
+            }
+            else
+            {
+                int bitCount = (int)arg1.Value;
+                if (bitCount > 30)
+                {
+                    throw new FloatPackException($"BitCount must be between 1 and 30 (inclusive), bitCount:{bitCount}", syncVar);
+                }
+                if (bitCount < 1)
+                {
+                    throw new FloatPackException($"BitCount must be between 1 and 30 (inclusive), bitCount:{bitCount}", syncVar);
+                }
+                settings.bitCount = bitCount;
+            }
+
+            return settings;
+        }
+    }
+}
diff --git a/Assets/Mirage/Weaver/Processors/SyncVars/FloatPackerFinder.cs.meta b/Assets/Mirage/Weaver/Processors/SyncVars/FloatPackerFinder.cs.meta
new file mode 100644
index 00000000000..9b467b8a2c7
--- /dev/null
+++ b/Assets/Mirage/Weaver/Processors/SyncVars/FloatPackerFinder.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: a372f47637a776542badc91a4ecaab1b
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs b/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs
index 193cdead6fe..f09d2f77162 100644
--- a/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs
@@ -6,6 +6,12 @@
 
 namespace Mirage.Weaver.SyncVars
 {
+    internal struct FloatPackSettings
+    {
+        public float max;
+        public float? precision;
+        public int? bitCount;
+    }
     internal class FoundSyncVar
     {
         public readonly FieldDefinition FieldDefinition;
@@ -32,6 +38,9 @@ public FoundSyncVar(FieldDefinition fieldDefinition, int dirtyIndex)
         public bool UseZigZagEncoding { get; private set; }
         public int? BitCountMinValue { get; private set; }
 
+        public FloatPackSettings? FloatPackSettings { get; private set; }
+        public FieldDefinition PackerField { get; internal set; }
+
         public MethodReference WriteFunction { get; private set; }
         public MethodReference ReadFunction { get; private set; }
 
@@ -93,6 +102,8 @@ public void ProcessAttributes()
             // do this if check here so it doesn't override fields unless attribute exists
             if (FieldDefinition.HasCustomAttribute<BitCountFromRangeAttribute>())
                 (BitCount, BitCountConvert, BitCountMinValue) = BitCountFromRangeFinder.GetBitFoundFromRange(FieldDefinition, BitCount.HasValue);
+
+            FloatPackSettings = FloatPackFinder.GetPackerSettings(FieldDefinition);
         }
 
         public void FindSerializeFunctions(Writers writers, Readers readers)
diff --git a/Assets/Mirage/Weaver/Processors/SyncVars/ZigZagFinder.cs b/Assets/Mirage/Weaver/Processors/SyncVars/ZigZagFinder.cs
index ac85197a09e..b526f7d352a 100644
--- a/Assets/Mirage/Weaver/Processors/SyncVars/ZigZagFinder.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncVars/ZigZagFinder.cs
@@ -3,7 +3,7 @@
 
 namespace Mirage.Weaver.SyncVars
 {
-    public static class ZigZagFinder
+    internal static class ZigZagFinder
     {
         public static bool HasZigZag(FieldDefinition syncVar, bool hasBitCount)
         {
diff --git a/Assets/Mirage/Weaver/WeaverExceptions.cs b/Assets/Mirage/Weaver/WeaverExceptions.cs
index 60053de0a75..abfb9ed46d9 100644
--- a/Assets/Mirage/Weaver/WeaverExceptions.cs
+++ b/Assets/Mirage/Weaver/WeaverExceptions.cs
@@ -64,4 +64,8 @@ internal class BitCountFromRangeException : SyncVarException
     {
         public BitCountFromRangeException(string message, MemberReference memberReference) : base(message, memberReference) { }
     }
+    internal class FloatPackException : SyncVarException
+    {
+        public FloatPackException(string message, MemberReference memberReference) : base(message, memberReference) { }
+    }
 }
diff --git a/Assets/Tests/Generated/FloatPackTests.meta b/Assets/Tests/Generated/FloatPackTests.meta
new file mode 100644
index 00000000000..7894b920595
--- /dev/null
+++ b/Assets/Tests/Generated/FloatPackTests.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 26357b638cc57df4faada16fce93ea05
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_100_10.cs b/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_100_10.cs
new file mode 100644
index 00000000000..7e4ed2297b4
--- /dev/null
+++ b/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_100_10.cs
@@ -0,0 +1,44 @@
+// DO NOT EDIT: GENERATED BY FloatPackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.FloatPackAttributeTests
+{
+    public class FloatPackBehaviour_100_10 : NetworkBehaviour
+    {
+        [FloatPack(100, 0.2f)]
+        [SyncVar] public float myValue;
+    }
+    public class FloatPackTest_100_10 : ClientServerSetup<FloatPackBehaviour_100_10>
+    {
+        const float value = 5.2f;
+        const float within = 0.196f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(10));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(10));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_100_10.cs.meta b/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_100_10.cs.meta
new file mode 100644
index 00000000000..ac255a646f8
--- /dev/null
+++ b/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_100_10.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: ad89b419431e6004ca48c95535ff2500
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_100_14.cs b/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_100_14.cs
new file mode 100644
index 00000000000..87acf219f29
--- /dev/null
+++ b/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_100_14.cs
@@ -0,0 +1,44 @@
+// DO NOT EDIT: GENERATED BY FloatPackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.FloatPackAttributeTests
+{
+    public class FloatPackBehaviour_100_14 : NetworkBehaviour
+    {
+        [FloatPack(100, 0.02f)]
+        [SyncVar] public float myValue;
+    }
+    public class FloatPackTest_100_14 : ClientServerSetup<FloatPackBehaviour_100_14>
+    {
+        const float value = 5.2f;
+        const float within = 0.0123f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(14));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(14));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_100_14.cs.meta b/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_100_14.cs.meta
new file mode 100644
index 00000000000..b7f8135c4a0
--- /dev/null
+++ b/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_100_14.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 016ea61e12913554fbceaf553a970d39
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_10_10.cs b/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_10_10.cs
new file mode 100644
index 00000000000..731de4ac00f
--- /dev/null
+++ b/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_10_10.cs
@@ -0,0 +1,44 @@
+// DO NOT EDIT: GENERATED BY FloatPackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.FloatPackAttributeTests
+{
+    public class FloatPackBehaviour_10_10 : NetworkBehaviour
+    {
+        [FloatPack(10, 10)]
+        [SyncVar] public float myValue;
+    }
+    public class FloatPackTest_10_10 : ClientServerSetup<FloatPackBehaviour_10_10>
+    {
+        const float value = 3.3f;
+        const float within = 0.0191f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(10));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(10));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_10_10.cs.meta b/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_10_10.cs.meta
new file mode 100644
index 00000000000..1c0f4e16147
--- /dev/null
+++ b/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_10_10.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 3736f9e65388d0a4dad0c506535044a4
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_1_8.cs b/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_1_8.cs
new file mode 100644
index 00000000000..5485265ee04
--- /dev/null
+++ b/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_1_8.cs
@@ -0,0 +1,44 @@
+// DO NOT EDIT: GENERATED BY FloatPackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.FloatPackAttributeTests
+{
+    public class FloatPackBehaviour_1_8 : NetworkBehaviour
+    {
+        [FloatPack(1, 8)]
+        [SyncVar] public float myValue;
+    }
+    public class FloatPackTest_1_8 : ClientServerSetup<FloatPackBehaviour_1_8>
+    {
+        const float value = 0.2f;
+        const float within = 0.00785f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(8));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(8));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_1_8.cs.meta b/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_1_8.cs.meta
new file mode 100644
index 00000000000..0733489db2e
--- /dev/null
+++ b/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_1_8.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 689399c2254fca041840b7084462a871
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_500_14.cs b/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_500_14.cs
new file mode 100644
index 00000000000..a6d707fc853
--- /dev/null
+++ b/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_500_14.cs
@@ -0,0 +1,44 @@
+// DO NOT EDIT: GENERATED BY FloatPackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.FloatPackAttributeTests
+{
+    public class FloatPackBehaviour_500_14 : NetworkBehaviour
+    {
+        [FloatPack(500, 0.1f)]
+        [SyncVar] public float myValue;
+    }
+    public class FloatPackTest_500_14 : ClientServerSetup<FloatPackBehaviour_500_14>
+    {
+        const float value = 5.2f;
+        const float within = 0.0123f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(14));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(14));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_500_14.cs.meta b/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_500_14.cs.meta
new file mode 100644
index 00000000000..48629925d93
--- /dev/null
+++ b/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_500_14.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: d6364115de1c8e541b3e0ff8371fb856
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_500_17.cs b/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_500_17.cs
new file mode 100644
index 00000000000..c02115614dd
--- /dev/null
+++ b/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_500_17.cs
@@ -0,0 +1,44 @@
+// DO NOT EDIT: GENERATED BY FloatPackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.FloatPackAttributeTests
+{
+    public class FloatPackBehaviour_500_17 : NetworkBehaviour
+    {
+        [FloatPack(500, 0.01f)]
+        [SyncVar] public float myValue;
+    }
+    public class FloatPackTest_500_17 : ClientServerSetup<FloatPackBehaviour_500_17>
+    {
+        const float value = 5.2f;
+        const float within = 0.00763f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(17));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(17));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_500_17.cs.meta b/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_500_17.cs.meta
new file mode 100644
index 00000000000..b279434cf5f
--- /dev/null
+++ b/Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_500_17.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 38ae51883e12f624d891bd79db46c359
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_100_10.cs b/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_100_10.cs
new file mode 100644
index 00000000000..2edcf8f2aab
--- /dev/null
+++ b/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_100_10.cs
@@ -0,0 +1,44 @@
+// DO NOT EDIT: GENERATED BY FloatPackerTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.FloatPackAttributeTests
+{
+    public class FloatPackerBehaviour_100_10 : NetworkBehaviour
+    {
+        [FloatPack(100, 0.2f)]
+        [SyncVar] public float myValue;
+    }
+    public class FloatPackerTest_100_10 : ClientServerSetup<FloatPackerBehaviour_100_10>
+    {
+        const float value = 5.2f;
+        const float within = 0.196f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(10));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(10));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_100_10.cs.meta b/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_100_10.cs.meta
new file mode 100644
index 00000000000..6dbcd835d45
--- /dev/null
+++ b/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_100_10.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 9678c41610ac52e4a95f474a89446a23
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_100_14.cs b/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_100_14.cs
new file mode 100644
index 00000000000..dce5bf4fc23
--- /dev/null
+++ b/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_100_14.cs
@@ -0,0 +1,44 @@
+// DO NOT EDIT: GENERATED BY FloatPackerTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.FloatPackAttributeTests
+{
+    public class FloatPackerBehaviour_100_14 : NetworkBehaviour
+    {
+        [FloatPack(100, 0.02f)]
+        [SyncVar] public float myValue;
+    }
+    public class FloatPackerTest_100_14 : ClientServerSetup<FloatPackerBehaviour_100_14>
+    {
+        const float value = 5.2f;
+        const float within = 0.0123f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(14));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(14));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_100_14.cs.meta b/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_100_14.cs.meta
new file mode 100644
index 00000000000..9c91617cfb4
--- /dev/null
+++ b/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_100_14.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 33011e2565ac67f48b66606e7d360e2a
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_10_10.cs b/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_10_10.cs
new file mode 100644
index 00000000000..c9bc287cec3
--- /dev/null
+++ b/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_10_10.cs
@@ -0,0 +1,44 @@
+// DO NOT EDIT: GENERATED BY FloatPackerTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.FloatPackAttributeTests
+{
+    public class FloatPackerBehaviour_10_10 : NetworkBehaviour
+    {
+        [FloatPack(10, 10)]
+        [SyncVar] public float myValue;
+    }
+    public class FloatPackerTest_10_10 : ClientServerSetup<FloatPackerBehaviour_10_10>
+    {
+        const float value = 3.3f;
+        const float within = 0.0191f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(10));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(10));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_10_10.cs.meta b/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_10_10.cs.meta
new file mode 100644
index 00000000000..0421c3d45a8
--- /dev/null
+++ b/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_10_10.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 222af70b43bdd24468eee2da3f8eae1f
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_1_8.cs b/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_1_8.cs
new file mode 100644
index 00000000000..ef9aec4daa7
--- /dev/null
+++ b/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_1_8.cs
@@ -0,0 +1,44 @@
+// DO NOT EDIT: GENERATED BY FloatPackerTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.FloatPackAttributeTests
+{
+    public class FloatPackerBehaviour_1_8 : NetworkBehaviour
+    {
+        [FloatPack(1, 8)]
+        [SyncVar] public float myValue;
+    }
+    public class FloatPackerTest_1_8 : ClientServerSetup<FloatPackerBehaviour_1_8>
+    {
+        const float value = 0.2f;
+        const float within = 0.00785f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(8));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(8));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_1_8.cs.meta b/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_1_8.cs.meta
new file mode 100644
index 00000000000..7d67b64d4e5
--- /dev/null
+++ b/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_1_8.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 2c63b55225b8ff14b9298e4860a7dcad
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_500_14.cs b/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_500_14.cs
new file mode 100644
index 00000000000..aa3e1c5702d
--- /dev/null
+++ b/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_500_14.cs
@@ -0,0 +1,44 @@
+// DO NOT EDIT: GENERATED BY FloatPackerTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.FloatPackAttributeTests
+{
+    public class FloatPackerBehaviour_500_14 : NetworkBehaviour
+    {
+        [FloatPack(500, 0.1f)]
+        [SyncVar] public float myValue;
+    }
+    public class FloatPackerTest_500_14 : ClientServerSetup<FloatPackerBehaviour_500_14>
+    {
+        const float value = 5.2f;
+        const float within = 0.0123f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(14));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(14));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_500_14.cs.meta b/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_500_14.cs.meta
new file mode 100644
index 00000000000..30506f4a048
--- /dev/null
+++ b/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_500_14.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: bf6b1ade8d5c5a24292673973a45dcc4
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_500_17.cs b/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_500_17.cs
new file mode 100644
index 00000000000..49b59ab3226
--- /dev/null
+++ b/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_500_17.cs
@@ -0,0 +1,44 @@
+// DO NOT EDIT: GENERATED BY FloatPackerTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.FloatPackAttributeTests
+{
+    public class FloatPackerBehaviour_500_17 : NetworkBehaviour
+    {
+        [FloatPack(500, 0.01f)]
+        [SyncVar] public float myValue;
+    }
+    public class FloatPackerTest_500_17 : ClientServerSetup<FloatPackerBehaviour_500_17>
+    {
+        const float value = 5.2f;
+        const float within = 0.00763f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(17));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(17));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_500_17.cs.meta b/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_500_17.cs.meta
new file mode 100644
index 00000000000..92cb5f50800
--- /dev/null
+++ b/Assets/Tests/Generated/FloatPackTests/FloatPackerBehaviour_500_17.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: b8133725884ec334eb3d0b3e2036c57c
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generators/.FloatPackTestTemplate.txt b/Assets/Tests/Generators/.FloatPackTestTemplate.txt
new file mode 100644
index 00000000000..ca0ef346ba1
--- /dev/null
+++ b/Assets/Tests/Generators/.FloatPackTestTemplate.txt
@@ -0,0 +1,44 @@
+// DO NOT EDIT: GENERATED BY FloatPackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.FloatPackAttributeTests
+{
+    public class FloatPackBehaviour_%%NAME%% : NetworkBehaviour
+    {
+        [FloatPack(%%PACKER_ATTRIBUTE%%)]
+        [SyncVar] public float myValue;
+    }
+    public class FloatPackTest_%%NAME%% : ClientServerSetup<FloatPackBehaviour_%%NAME%%>
+    {
+        const float value = %%VALUE%%;
+        const float within = %%WITHIN%%;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(%%BIT_COUNT%%));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(%%BIT_COUNT%%));
+
+                    Assert.That(clientComponent.myValue, Is.EqualTo(value).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generators/FloatPackTestGenerator.cs b/Assets/Tests/Generators/FloatPackTestGenerator.cs
new file mode 100644
index 00000000000..10c6aa4a30d
--- /dev/null
+++ b/Assets/Tests/Generators/FloatPackTestGenerator.cs
@@ -0,0 +1,36 @@
+using JamesFrowen.SimpleCodeGen;
+using UnityEditor;
+
+namespace Mirage.Tests.CodeGenerators
+{
+    public static class FloatPackTestGenerator
+    {
+        [MenuItem("Tests Generators/FloatPack")]
+        public static void CreateAll()
+        {
+            var fromTemplate = new CreateFromTemplate("./Assets/Tests/Generators/.FloatPackTestTemplate.txt");
+            Create(fromTemplate, 100f, "0.2f", 5.2f, 0.196f, 10);
+            Create(fromTemplate, 100f, "0.02f", 5.2f, 0.0123f, 14);
+
+            Create(fromTemplate, 500f, "0.1f", 5.2f, 0.0123f, 14);
+            Create(fromTemplate, 500f, "0.01f", 5.2f, 0.00763f, 17);
+
+            Create(fromTemplate, 1f, "8", 0.2f, 0.00785f, 8);
+            Create(fromTemplate, 10f, "10", 3.3f, 0.0191f, 10);
+
+            AssetDatabase.Refresh();
+        }
+
+        private static void Create(CreateFromTemplate fromTemplate, float max, string ArgAttribute2, float value, float within, int bitcount)
+        {
+            string name = $"{max}_{bitcount}";
+            fromTemplate.Replace("%%NAME%%", name);
+            fromTemplate.Replace("%%PACKER_ATTRIBUTE%%", $"{max}, {ArgAttribute2}");
+            fromTemplate.Replace("%%VALUE%%", $"{value}f");
+            fromTemplate.Replace("%%WITHIN%%", $"{within}f");
+            fromTemplate.Replace("%%BIT_COUNT%%", bitcount);
+
+            fromTemplate.WriteToFile($"./Assets/Tests/Generated/FloatPackTests/FloatPackBehaviour_{name}.cs");
+        }
+    }
+}
diff --git a/Assets/Tests/Generators/FloatPackTestGenerator.cs.meta b/Assets/Tests/Generators/FloatPackTestGenerator.cs.meta
new file mode 100644
index 00000000000..10f6b09c6cd
--- /dev/null
+++ b/Assets/Tests/Generators/FloatPackTestGenerator.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 98f2d5e1451cc1a4f9a0b1bd5d242990
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Runtime/Serialization/Packers/FloatPackerCreateTest.cs b/Assets/Tests/Runtime/Serialization/Packers/FloatPackerCreateTest.cs
index d9440b4fdc2..bbb38744951 100644
--- a/Assets/Tests/Runtime/Serialization/Packers/FloatPackerCreateTest.cs
+++ b/Assets/Tests/Runtime/Serialization/Packers/FloatPackerCreateTest.cs
@@ -23,7 +23,7 @@ public int CreateUsingPrecsion(float precision)
         [Test]
         public void PackFromBitCountPacksToCorrectCount([Range(1, 30)] int bitCount)
         {
-            var packer = FloatPacker.FromBitCount(100, bitCount);
+            var packer = new FloatPacker(100, bitCount);
 
             packer.Pack(writer, 1f);
 
@@ -35,7 +35,7 @@ public void ThrowsIfBitCountIsLessThan1([Range(-10, 0)] int bitCount)
         {
             ArgumentException exception = Assert.Throws<ArgumentException>(() =>
             {
-                FloatPacker.FromBitCount(10, bitCount);
+                _ = new FloatPacker(10, bitCount);
             });
 
             var expected = new ArgumentException("Bit count is too low, bit count should be between 1 and 30", "bitCount");
@@ -47,7 +47,7 @@ public void ThrowsIfBitCountIsGreaterThan30([Range(31, 40)] int bitCount)
         {
             ArgumentException exception = Assert.Throws<ArgumentException>(() =>
             {
-                FloatPacker.FromBitCount(10, bitCount);
+                _ = new FloatPacker(10, bitCount);
             });
 
             var expected = new ArgumentException("Bit count is too high, bit count should be between 1 and 30", "bitCount");
@@ -59,7 +59,7 @@ public void ThrowsIfMaxIsZero()
         {
             ArgumentException exception = Assert.Throws<ArgumentException>(() =>
             {
-                FloatPacker.FromBitCount(0, 1);
+                _ = new FloatPacker(0, 1);
             });
 
             var expected = new ArgumentException("Max can not be 0", "max");
diff --git a/Assets/Tests/Weaver/BitAttributeTests.cs b/Assets/Tests/Weaver/BitAttributeTests.cs
index c9f550b4b1d..d77a70fb965 100644
--- a/Assets/Tests/Weaver/BitAttributeTests.cs
+++ b/Assets/Tests/Weaver/BitAttributeTests.cs
@@ -112,5 +112,42 @@ public void BitCountFromRangeInvalid()
             HasError("System.Int64 is not a supported type for [BitCountFromRange]",
                "System.Int64 BitAttributeTests.BitCountFromRangeInvalid.MyBehaviour::value8");
         }
+
+        [Test]
+        public void FloatPack()
+        {
+            IsSuccess();
+        }
+
+        [Test]
+        public void FloatPackInvalid()
+        {
+            HasErrorCount(9);
+
+            HasError("System.Double is not a supported type for [FloatPack]",
+                "System.Double BitAttributeTests.FloatPackInvalid.MyBehaviour::value1");
+
+            HasError("System.Int32 is not a supported type for [FloatPack]",
+                "System.Int32 BitAttributeTests.FloatPackInvalid.MyBehaviour::value2");
+
+            HasError("UnityEngine.Vector3 is not a supported type for [FloatPack]",
+                "UnityEngine.Vector3 BitAttributeTests.FloatPackInvalid.MyBehaviour::value3");
+
+            HasError("BitCount must be between 1 and 30 (inclusive), bitCount:31",
+                "System.Single BitAttributeTests.FloatPackInvalid.MyBehaviour::value4");
+            HasError("BitCount must be between 1 and 30 (inclusive), bitCount:0",
+                "System.Single BitAttributeTests.FloatPackInvalid.MyBehaviour::value5");
+
+            HasError("Max must be above 0, max:0",
+                "System.Single BitAttributeTests.FloatPackInvalid.MyBehaviour::value6");
+            HasError("Max must be above 0, max:-5",
+                "System.Single BitAttributeTests.FloatPackInvalid.MyBehaviour::value7");
+
+            HasError($"Precsion is too small, precision:{float.Epsilon}",
+                "System.Single BitAttributeTests.FloatPackInvalid.MyBehaviour::value8");
+
+            HasError("Precsion must be positive, precision:-0.1",
+                "System.Single BitAttributeTests.FloatPackInvalid.MyBehaviour::value9");
+        }
     }
 }
diff --git a/Assets/Tests/Weaver/BitAttributeTests~/BitCount.cs b/Assets/Tests/Weaver/BitAttributeTests~/BitCount.cs
index 04047c5f6e3..2ac84dfd0d6 100644
--- a/Assets/Tests/Weaver/BitAttributeTests~/BitCount.cs
+++ b/Assets/Tests/Weaver/BitAttributeTests~/BitCount.cs
@@ -3,7 +3,6 @@
 
 namespace BitAttributeTests.BitCount
 {
-    // should expect 1 error per field
     public class MyBehaviour : NetworkBehaviour
     {
         [BitCount(5)]
diff --git a/Assets/Tests/Weaver/BitAttributeTests~/FloatPack.cs b/Assets/Tests/Weaver/BitAttributeTests~/FloatPack.cs
new file mode 100644
index 00000000000..2eadf517538
--- /dev/null
+++ b/Assets/Tests/Weaver/BitAttributeTests~/FloatPack.cs
@@ -0,0 +1,20 @@
+using Mirage;
+using Mirage.Serialization;
+
+namespace BitAttributeTests.FloatPack
+{
+    public class MyBehaviour : NetworkBehaviour
+    {
+        [FloatPack(100f, 0.1f)]
+        [SyncVar] public float value1;
+
+        [FloatPack(1000f, 1f)]
+        [SyncVar] public float value2;
+
+        [FloatPack(10000f, 8)]
+        [SyncVar] public float value3;
+
+        [FloatPack(1f, 9)]
+        [SyncVar] public float value4;
+    }
+}
\ No newline at end of file
diff --git a/Assets/Tests/Weaver/BitAttributeTests~/FloatPackInvalid.cs b/Assets/Tests/Weaver/BitAttributeTests~/FloatPackInvalid.cs
new file mode 100644
index 00000000000..b378aca4263
--- /dev/null
+++ b/Assets/Tests/Weaver/BitAttributeTests~/FloatPackInvalid.cs
@@ -0,0 +1,44 @@
+using Mirage;
+using Mirage.Serialization;
+
+namespace BitAttributeTests.FloatPackInvalid
+{
+    public class MyBehaviour : NetworkBehaviour
+    {
+        // error, unsupported type
+        [FloatPack(100f, 0.1f)]
+        [SyncVar] public double value1;
+
+        // error, unsupported type
+        [FloatPack(1000f, 1f)]
+        [SyncVar] public int value2;
+
+        // error, unsupported type
+        [FloatPack(10000f, 8)]
+        [SyncVar] public UnityEngine.Vector3 value3;
+
+        // error, bit count out of range
+        [FloatPack(1f, 31)]
+        [SyncVar] public float value4;
+
+        // error, bit count out of range
+        [FloatPack(1f, 0)]
+        [SyncVar] public float value5;
+
+        // error, max can't be zero
+        [FloatPack(0, 10)]
+        [SyncVar] public float value6;
+
+        // error, max can't be zero
+        [FloatPack(-5, 10)]
+        [SyncVar] public float value7;
+
+        // error, precision too low
+        [FloatPack(1f, float.Epsilon)]
+        [SyncVar] public float value8;
+
+        // error, precision negative
+        [FloatPack(1f, -0.1f)]
+        [SyncVar] public float value9;
+    }
+}
\ No newline at end of file
diff --git a/Assets/Tests/Weaver/BitAttributeTests~/ZigZag.cs b/Assets/Tests/Weaver/BitAttributeTests~/ZigZag.cs
index e5ca0570b25..856f1a5be73 100644
--- a/Assets/Tests/Weaver/BitAttributeTests~/ZigZag.cs
+++ b/Assets/Tests/Weaver/BitAttributeTests~/ZigZag.cs
@@ -3,7 +3,6 @@
 
 namespace BitAttributeTests.ZigZag
 {
-    // should expect 1 error per field
     public class MyBehaviour : NetworkBehaviour
     {
         [BitCount(10), ZigZagEncode]
diff --git a/doc/Articles/Guides/BitPacking/BitCount.md b/doc/Articles/Guides/BitPacking/BitCount.md
index 0e64bb52de2..c43d12f30fb 100644
--- a/doc/Articles/Guides/BitPacking/BitCount.md
+++ b/doc/Articles/Guides/BitPacking/BitCount.md
@@ -110,4 +110,4 @@ public override void DeserializeSyncVars(NetworkReader reader, bool initialState
 }
 ```
 
-*last updated for Mirage v101.6.0*
\ No newline at end of file
+*last updated for Mirage v101.8.0*
\ No newline at end of file
diff --git a/doc/Articles/Guides/BitPacking/BitCountFromRange.md b/doc/Articles/Guides/BitPacking/BitCountFromRange.md
index 1221bd01ccc..f0839881d6d 100644
--- a/doc/Articles/Guides/BitPacking/BitCountFromRange.md
+++ b/doc/Articles/Guides/BitPacking/BitCountFromRange.md
@@ -124,4 +124,4 @@ public override void DeserializeSyncVars(NetworkReader reader, bool initialState
 }
 ```
 
-*last updated for Mirage v101.6.0*
\ No newline at end of file
+*last updated for Mirage v101.8.0*
\ No newline at end of file
diff --git a/doc/Articles/Guides/BitPacking/FloatPack.md b/doc/Articles/Guides/BitPacking/FloatPack.md
new file mode 100644
index 00000000000..2ca274744db
--- /dev/null
+++ b/doc/Articles/Guides/BitPacking/FloatPack.md
@@ -0,0 +1,108 @@
+# Bit Count
+
+A float value can be compressed using <xref:Mirage.Serialization.FloatPackAttribute> 
+
+The float value will be quantize and turned into an integer with at least the resolution that is given in the attribute.
+
+The real resolution used it calculated from the bitcount required to pack the value. For example if max is `100`, and resolution is `0.1f`, then there are `2000` discrete values are needed to pack this, this requires 11 bits. 11 bits allows for `2047` discrete values so the real resolution used will be `0.0977f`.
+
+Value are packed so that 0 will unpack are 0, and other values are rounded to nearest int so that rounding errors stays as low as possible.
+
+Values are clamped so values out of range will be packed as min/max value instead
+
+### Use cases
+
+- A Value with a maximum value
+
+### Supported Types
+
+- Float
+
+### Example 1
+
+Health which is between 0 and 100
+
+```cs
+public class MyNetworkBehaviour : NetworkBehaviour 
+{
+    [SyncVar, FloatPack(100f, 0.02f)]
+    public int Health;
+}
+```
+
+`Max = 100`, `resolution = 0.02f` so bit count is 14
+
+`health = 57.2f` will serialize to `01_0010_0100_1101` and deserialize to `57.197f`
+
+`health = -13.5f` will serialize to `11_1011_1010_1110` and deserialize to `-13.503f`
+
+`health = 120f` will be clamped to `100f`
+
+
+### Example 2
+
+A Percent that where you only want to send 8 bits
+
+```cs
+public class MyNetworkBehaviour : NetworkBehaviour 
+{
+    [SyncVar, FloatPack(1f, 8)]
+    public int Percent;
+}
+```
+
+`Max = 1f`, `bitCount = 8` so resolution will be `0.00787f`
+
+### Generated Code
+
+Source:
+```cs 
+[SyncVar, FloatPack(100f, 0.02f)]
+public int myValue;
+```
+
+Generated:
+```cs
+
+private FloatPacker myValue__Packer = new FloatPacker(100f, 0.02f);
+
+public override bool SerializeSyncVars(NetworkWriter writer, bool initialState)
+{
+    ulong syncVarDirtyBits = base.SyncVarDirtyBits;
+    bool result = base.SerializeSyncVars(writer, initialize);
+
+    if (initialState) 
+    {
+        myValue__Packer.Pack(writer, this.myValue);
+        return true;
+    }
+
+    writer.Write(syncVarDirtyBits, 1);
+    if ((syncVarDirtyBits & 1UL) != 0UL)
+    {
+        myValue__Packer.Pack(writer, this.myValue);
+        result = true;
+    }
+
+    return result;
+}
+
+public override void DeserializeSyncVars(NetworkReader reader, bool initialState)
+{
+    base.DeserializeSyncVars(reader, initialState);
+
+    if (initialState)
+    {
+        this.myValue = myValue__Packer.Unpack(reader);
+        return;
+    }
+
+    ulong dirtyMask = reader.Read(1);
+    if ((dirtyMask & 1UL) != 0UL)
+    {
+        this.myValue = myValue__Packer.Unpack(reader);
+    }
+}
+```
+
+*last updated for Mirage v101.8.0*
\ No newline at end of file
diff --git a/doc/Articles/Guides/BitPacking/FloatPacker.md b/doc/Articles/Guides/BitPacking/FloatPacker.md
deleted file mode 100644
index 3843df1ca19..00000000000
--- a/doc/Articles/Guides/BitPacking/FloatPacker.md
+++ /dev/null
@@ -1 +0,0 @@
-*work in progress*
\ No newline at end of file
diff --git a/doc/Articles/Guides/BitPacking/ZigZagEncode.md b/doc/Articles/Guides/BitPacking/ZigZagEncode.md
index 11b55a2fa56..b3406f4623f 100644
--- a/doc/Articles/Guides/BitPacking/ZigZagEncode.md
+++ b/doc/Articles/Guides/BitPacking/ZigZagEncode.md
@@ -94,4 +94,4 @@ public override void DeserializeSyncVars(NetworkReader reader, bool initialState
 }
 ```
 
-*last updated for Mirage v101.6.0*
\ No newline at end of file
+*last updated for Mirage v101.8.0*
\ No newline at end of file
diff --git a/doc/Articles/Guides/BitPacking/index.md b/doc/Articles/Guides/BitPacking/index.md
index 487e6c14397..6e1e0d97c97 100644
--- a/doc/Articles/Guides/BitPacking/index.md
+++ b/doc/Articles/Guides/BitPacking/index.md
@@ -11,3 +11,4 @@ Mirage has many attributes that can be applied to SyncVars and Rpc parameters
 - [BitCount](./BitCount.md) Sets the number of bits on an integer
 - [BitCountFromRange](./BitCountFromRange.md) Sets the number of bits from a given range, rounding up.
 - [ZigZagEncode](./ZigZagEncode.md) Encodes a value using [ZigZag Encoding](https://gist.github.com/mfuerstenau/ba870a29e16536fdbaba). Only useable with [BitCount](./BitCount.md) or [VarIntBlock](./VarIntBlock.md)
+- [FloatPack](./FloatPack.md) Compresses a float value.
\ No newline at end of file
diff --git a/doc/Articles/Guides/BitPacking/toc.yml b/doc/Articles/Guides/BitPacking/toc.yml
index 14a8676642b..b68ef6b1bf2 100644
--- a/doc/Articles/Guides/BitPacking/toc.yml
+++ b/doc/Articles/Guides/BitPacking/toc.yml
@@ -9,7 +9,7 @@
 - name: Variable Sized Int Block packer
   href: VarIntBlock.md
 - name: Float Packer
-  href: FloatPacker.md
+  href: FloatPack.md
 - name: Vector Packer
   href: VectorPacker.md
 - name: Quaternion Packer

From e5124b78f466bf2c0904e80c721710372fbbe31c Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Thu, 26 Aug 2021 16:21:24 +0000
Subject: [PATCH 145/166] chore(release): 101.9.0 [skip ci]

# [101.9.0](https://github.com/MirageNet/Mirage/compare/v101.8.0...v101.9.0) (2021-08-26)

### Bug Fixes

* **NanoSocket:** adding dispose and finalize ([#904](https://github.com/MirageNet/Mirage/issues/904)) ([ca949ea](https://github.com/MirageNet/Mirage/commit/ca949ea15b900ee7d35d180b73e44103ed54d064))

### Features

* attributes to use new float bit packers ([#896](https://github.com/MirageNet/Mirage/issues/896)) ([273d27c](https://github.com/MirageNet/Mirage/commit/273d27ce03efee81f507def913ce9a906b1a38f2))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs         |  2 +-
 Assets/Mirage/CHANGELOG.md                           | 12 ++++++++++++
 Assets/Mirage/Components/AssemblyInfo.cs             |  2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                |  2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs    |  2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs               |  2 +-
 .../RigidbodyPhysics/Scripts/AssemblyInfo.cs         |  2 +-
 Assets/Mirage/package.json                           |  2 +-
 8 files changed, 19 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index ca972e7a2bd..1e01bb8cecb 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.8.0")]
+[assembly: AssemblyVersion("101.9.0")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index ba141818bfa..03ed01d7dc4 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,15 @@
+# [101.9.0](https://github.com/MirageNet/Mirage/compare/v101.8.0...v101.9.0) (2021-08-26)
+
+
+### Bug Fixes
+
+* **NanoSocket:** adding dispose and finalize ([#904](https://github.com/MirageNet/Mirage/issues/904)) ([ca949ea](https://github.com/MirageNet/Mirage/commit/ca949ea15b900ee7d35d180b73e44103ed54d064))
+
+
+### Features
+
+* attributes to use new float bit packers ([#896](https://github.com/MirageNet/Mirage/issues/896)) ([273d27c](https://github.com/MirageNet/Mirage/commit/273d27ce03efee81f507def913ce9a906b1a38f2))
+
 # [101.8.0](https://github.com/MirageNet/Mirage/compare/v101.7.0...v101.8.0) (2021-08-24)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index 4f47dcb6b29..e6b4d3cb653 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.8.0")]
+[assembly: AssemblyVersion("101.9.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index 1eb1021afa0..05a899a0bed 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.8.0")]
+[assembly: AssemblyVersion("101.9.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index 7bb514be3fb..fb100314441 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.8.0")]
+[assembly: AssemblyVersion("101.9.0")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index ca972e7a2bd..1e01bb8cecb 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.8.0")]
+[assembly: AssemblyVersion("101.9.0")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index ca972e7a2bd..1e01bb8cecb 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.8.0")]
+[assembly: AssemblyVersion("101.9.0")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 495c25e84d6..9b7ee215152 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "101.8.0",
+    "version": "101.9.0",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From ffb22458067bc538986df76c623963ef17cd67a9 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Sat, 28 Aug 2021 23:23:15 +0100
Subject: [PATCH 146/166] chore: updating FUNDING.yml [skip ci] (#903)

---
 FUNDING.yml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/FUNDING.yml b/FUNDING.yml
index 9f35c823c81..7610a3f27c2 100644
--- a/FUNDING.yml
+++ b/FUNDING.yml
@@ -1 +1,4 @@
-github: vis2k
+github: [James-Frowen, dragonslaya84]
+
+# add multiple people using array:
+# github: [user1, user2]

From 8ceb4d194800f04cc1ef0f54a382cc41dd2a0b57 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Sun, 29 Aug 2021 00:37:22 +0100
Subject: [PATCH 147/166] chore: updating license request ready for 2020 lts

---
 .github/workflows/request-activation-file.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/request-activation-file.yml b/.github/workflows/request-activation-file.yml
index c02bfb08c9e..b263077d814 100644
--- a/.github/workflows/request-activation-file.yml
+++ b/.github/workflows/request-activation-file.yml
@@ -6,7 +6,7 @@ on:
 jobs:
   requestActivationFile:
     runs-on: ubuntu-latest
-    container: unityci/editor:ubuntu-2020.1.17f1-base-0.10.0
+    container: unityci/editor:ubuntu-2020.3.17f1-base-0.15.0
     steps:
       - name: Request manual activation file
         continue-on-error: true
@@ -16,7 +16,7 @@ jobs:
         uses: actions/upload-artifact@v2.2.4
         with:
             name: Manual Activation File
-            path: Unity_v2020.1.17f1.alf
+            path: Unity_v2020.3.9f1.alf
 
       - name: Next Steps
         run: |

From 42c97c0169a43c313776afb95e37bb5d1d1ad7d7 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Sun, 29 Aug 2021 00:47:26 +0100
Subject: [PATCH 148/166] chore: fixing license request [skip ci]

---
 .github/workflows/request-activation-file.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/request-activation-file.yml b/.github/workflows/request-activation-file.yml
index b263077d814..d12f1a6f92f 100644
--- a/.github/workflows/request-activation-file.yml
+++ b/.github/workflows/request-activation-file.yml
@@ -16,7 +16,7 @@ jobs:
         uses: actions/upload-artifact@v2.2.4
         with:
             name: Manual Activation File
-            path: Unity_v2020.3.9f1.alf
+            path: Unity_v2020.3.17f1.alf
 
       - name: Next Steps
         run: |

From 2bc42c512432ece82bf1eabc53ccf65d27e54556 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Sun, 29 Aug 2021 15:13:26 +0100
Subject: [PATCH 149/166] fix: improving warning message for taking too many
 objects from pool

---
 Assets/Mirage/Runtime/SocketLayer/Pool.cs  |  2 +-
 Assets/Tests/SocketLayer/BufferPoolTest.cs | 10 +++++-----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/Assets/Mirage/Runtime/SocketLayer/Pool.cs b/Assets/Mirage/Runtime/SocketLayer/Pool.cs
index 82650534c44..f815d95346a 100644
--- a/Assets/Mirage/Runtime/SocketLayer/Pool.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/Pool.cs
@@ -69,7 +69,7 @@ public Pool(CreateNewItem createNew, int bufferSize, int startPoolSize, int maxP
 
         private T CreateNewBuffer()
         {
-            if (created >= maxPoolSize && logger.IsLogTypeAllowed(LogType.Warning)) logger.Log(LogType.Warning, $"Buffer Max Size reached, created:{created + 1} max:{maxPoolSize}");
+            if (created >= maxPoolSize && logger.IsLogTypeAllowed(LogType.Warning)) logger.Log(LogType.Warning, $"Pool Max Size reached, type:{typeof(T).Name} created:{created + 1} max:{maxPoolSize}");
             created++;
             return createNew.Invoke(bufferSize, this);
         }
diff --git a/Assets/Tests/SocketLayer/BufferPoolTest.cs b/Assets/Tests/SocketLayer/BufferPoolTest.cs
index 41a64805d35..6e5cdf80ef6 100644
--- a/Assets/Tests/SocketLayer/BufferPoolTest.cs
+++ b/Assets/Tests/SocketLayer/BufferPoolTest.cs
@@ -25,7 +25,7 @@ public void ThrowsIfCreateIsNull()
         [Test]
         public void CallsCreateStartCountTimesWithCorrectArgs()
         {
-            var create = Substitute.For<Pool<TestBuffer>.CreateNewItem>();
+            Pool<TestBuffer>.CreateNewItem create = Substitute.For<Pool<TestBuffer>.CreateNewItem>();
 
             const int startCount = 5;
             const int bufferSize = 100;
@@ -37,7 +37,7 @@ public void CallsCreateStartCountTimesWithCorrectArgs()
         [Test]
         public void TakeDoesntCreateTillEmpty()
         {
-            var create = Substitute.For<Pool<TestBuffer>.CreateNewItem>();
+            Pool<TestBuffer>.CreateNewItem create = Substitute.For<Pool<TestBuffer>.CreateNewItem>();
             create.Invoke(default, default).Returns((args) => TestBuffer.Create((int)args[0], (Pool<TestBuffer>)args[0]));
 
             const int startCount = 5;
@@ -62,7 +62,7 @@ public void TakeDoesntCreateTillEmpty()
         [Test]
         public void CanTakeMoreAfterPuttingSomeBackWithoutCreatingNew()
         {
-            var create = Substitute.For<Pool<TestBuffer>.CreateNewItem>();
+            Pool<TestBuffer>.CreateNewItem create = Substitute.For<Pool<TestBuffer>.CreateNewItem>();
             create.Invoke(default, default).Returns((args) => TestBuffer.Create((int)args[0], (Pool<TestBuffer>)args[1]));
 
             const int startCount = 5;
@@ -131,7 +131,7 @@ public void TakingMoreBuffersThanMaxLogsWarning()
 
             LogAssert.NoUnexpectedReceived();
 
-            LogAssert.Expect(UnityEngine.LogType.Warning, $"Buffer Max Size reached, created:{maxCount + 1} max:{maxCount}");
+            LogAssert.Expect(UnityEngine.LogType.Warning, $"Pool Max Size reached, type:{typeof(TestBuffer).Name} created:{maxCount + 1} max:{maxCount}");
             temp[maxCount] = pool.Take();
             LogAssert.NoUnexpectedReceived();
 
@@ -152,7 +152,7 @@ public void PutingMoreBuffersThanMaxLogsWarning()
             }
 
             // have to expect this so that noUnexpected doesn't fail below
-            LogAssert.Expect(UnityEngine.LogType.Warning, $"Buffer Max Size reached, created:{maxCount + 1} max:{maxCount}");
+            LogAssert.Expect(UnityEngine.LogType.Warning, $"Pool Max Size reached, type:{typeof(TestBuffer).Name} created:{maxCount + 1} max:{maxCount}");
 
             for (int i = 0; i < maxCount; i++)
             {

From 4f508113120a4b643d287fb2871825107cd25294 Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Sun, 29 Aug 2021 14:28:31 +0000
Subject: [PATCH 150/166] chore(release): 101.9.1 [skip ci]

## [101.9.1](https://github.com/MirageNet/Mirage/compare/v101.9.0...v101.9.1) (2021-08-29)

### Bug Fixes

* improving warning message for taking too many objects from pool ([2bc42c5](https://github.com/MirageNet/Mirage/commit/2bc42c512432ece82bf1eabc53ccf65d27e54556))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs               | 2 +-
 Assets/Mirage/CHANGELOG.md                                 | 7 +++++++
 Assets/Mirage/Components/AssemblyInfo.cs                   | 2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                      | 2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs          | 2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs                     | 2 +-
 .../Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs      | 2 +-
 Assets/Mirage/package.json                                 | 2 +-
 8 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index 1e01bb8cecb..122c7d27700 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.9.0")]
+[assembly: AssemblyVersion("101.9.1")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index 03ed01d7dc4..ecaea74a451 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,10 @@
+## [101.9.1](https://github.com/MirageNet/Mirage/compare/v101.9.0...v101.9.1) (2021-08-29)
+
+
+### Bug Fixes
+
+* improving warning message for taking too many objects from pool ([2bc42c5](https://github.com/MirageNet/Mirage/commit/2bc42c512432ece82bf1eabc53ccf65d27e54556))
+
 # [101.9.0](https://github.com/MirageNet/Mirage/compare/v101.8.0...v101.9.0) (2021-08-26)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index e6b4d3cb653..d4000bd5a7b 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.9.0")]
+[assembly: AssemblyVersion("101.9.1")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index 05a899a0bed..9ee05d1052f 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.9.0")]
+[assembly: AssemblyVersion("101.9.1")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index fb100314441..c9da8c39519 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.9.0")]
+[assembly: AssemblyVersion("101.9.1")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index 1e01bb8cecb..122c7d27700 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.9.0")]
+[assembly: AssemblyVersion("101.9.1")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index 1e01bb8cecb..122c7d27700 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.9.0")]
+[assembly: AssemblyVersion("101.9.1")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 9b7ee215152..61b53d740ec 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "101.9.0",
+    "version": "101.9.1",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From 8815b7e21712b45662bc3edaf28facccf934cd52 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Sun, 29 Aug 2021 23:27:09 +0100
Subject: [PATCH 151/166] docs: adding socketlayer to docfx (#906)

* adding socketlayer to docfx

* docs: fixing doc common for socket layer
---
 Assets/Mirage/Runtime/SocketLayer/ByteBuffer.cs | 2 +-
 doc/docfx.json                                  | 2 ++
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/Assets/Mirage/Runtime/SocketLayer/ByteBuffer.cs b/Assets/Mirage/Runtime/SocketLayer/ByteBuffer.cs
index 768a5d41b05..dfc611b3076 100644
--- a/Assets/Mirage/Runtime/SocketLayer/ByteBuffer.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/ByteBuffer.cs
@@ -3,7 +3,7 @@
 namespace Mirage.SocketLayer
 {
     /// <summary>
-    /// Warpper around a byte[] that belongs to a <see cref="BufferPool"/>
+    /// Warpper around a byte[] that belongs to a <see cref="Pool{T}"/>
     /// </summary>
     public sealed class ByteBuffer : IDisposable
     {
diff --git a/doc/docfx.json b/doc/docfx.json
index d51645ed157..afba5151407 100644
--- a/doc/docfx.json
+++ b/doc/docfx.json
@@ -4,7 +4,9 @@
             "src": [
                 {
                     "files": [
+                        "Mirage.SocketLayer.csproj",
                         "Mirage.csproj",
+                        "Mirage.Sockets.Udp.csproj",
                         "Mirage.Authenticators.csproj",
                         "Mirage.Components.csproj"
                     ],

From 289826e422e15183c9bfaff5f4848f89fa79e7e3 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Mon, 30 Aug 2021 00:23:03 +0100
Subject: [PATCH 152/166] chore: adding CompilationLog to gitignore [skip ci]

---
 .gitignore | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/.gitignore b/.gitignore
index 3d2a6b69c01..7a6c093275b 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,6 @@
+# Created by weaver tests
+Assets/Tests/Weaver/**/CompilationLog.txt
+
 # Created by performance test
 Assets/StreamingAssets/
 Assets/StreamingAssets.meta

From 9d3f0568943e531474f56852453233e173e3508f Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Mon, 30 Aug 2021 00:25:32 +0100
Subject: [PATCH 153/166] fix: fixing namespace for display metrics

---
 .../Components/DisplayMetrics/DisplayMetricsAverageGui.cs      | 2 +-
 .../Mirage/Components/DisplayMetrics/RequestServerMetrics.cs   | 3 +--
 Assets/Mirage/Components/DisplayMetrics/SetDisplayMetrics.cs   | 3 +--
 3 files changed, 3 insertions(+), 5 deletions(-)

diff --git a/Assets/Mirage/Components/DisplayMetrics/DisplayMetricsAverageGui.cs b/Assets/Mirage/Components/DisplayMetrics/DisplayMetricsAverageGui.cs
index dc0d42a62b8..905e16bff41 100644
--- a/Assets/Mirage/Components/DisplayMetrics/DisplayMetricsAverageGui.cs
+++ b/Assets/Mirage/Components/DisplayMetrics/DisplayMetricsAverageGui.cs
@@ -1,7 +1,7 @@
 using Mirage.SocketLayer;
 using UnityEngine;
 
-namespace JamesFrowen.NetworkingBenchmark
+namespace Mirage.DisplayMetrics
 {
     public class DisplayMetricsAverageGui : MonoBehaviour
     {
diff --git a/Assets/Mirage/Components/DisplayMetrics/RequestServerMetrics.cs b/Assets/Mirage/Components/DisplayMetrics/RequestServerMetrics.cs
index d14b2c060b3..ca2f0c988ec 100644
--- a/Assets/Mirage/Components/DisplayMetrics/RequestServerMetrics.cs
+++ b/Assets/Mirage/Components/DisplayMetrics/RequestServerMetrics.cs
@@ -1,11 +1,10 @@
 using System;
 using System.Collections;
 using System.Collections.Generic;
-using Mirage;
 using Mirage.SocketLayer;
 using UnityEngine;
 
-namespace JamesFrowen.NetworkingBenchmark
+namespace Mirage.DisplayMetrics
 {
     public class RequestServerMetrics : MonoBehaviour
     {
diff --git a/Assets/Mirage/Components/DisplayMetrics/SetDisplayMetrics.cs b/Assets/Mirage/Components/DisplayMetrics/SetDisplayMetrics.cs
index 184539d6b24..5fc66d8a6eb 100644
--- a/Assets/Mirage/Components/DisplayMetrics/SetDisplayMetrics.cs
+++ b/Assets/Mirage/Components/DisplayMetrics/SetDisplayMetrics.cs
@@ -1,7 +1,6 @@
-using Mirage;
 using UnityEngine;
 
-namespace JamesFrowen.NetworkingBenchmark
+namespace Mirage.DisplayMetrics
 {
     public class SetDisplayMetrics : MonoBehaviour
     {

From 9ca8a611dd55e6b633d4e3be4c7c56f77b9613be Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Mon, 30 Aug 2021 00:29:45 +0100
Subject: [PATCH 154/166] refactor: adding DontDestroy to NetworkManagerHud so
 DDOL is optional

---
 Assets/Mirage/Components/NetworkManagerHud.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/Assets/Mirage/Components/NetworkManagerHud.cs b/Assets/Mirage/Components/NetworkManagerHud.cs
index 33dde7b42e9..0587d5a1f4c 100644
--- a/Assets/Mirage/Components/NetworkManagerHud.cs
+++ b/Assets/Mirage/Components/NetworkManagerHud.cs
@@ -7,6 +7,7 @@ public class NetworkManagerHud : MonoBehaviour
     {
         public NetworkManager NetworkManager;
         public string NetworkAddress = "localhost";
+        public bool DontDestroy = true;
 
         [Header("Prefab Canvas Elements")]
         public InputField NetworkAddressInput;
@@ -16,7 +17,9 @@ public class NetworkManagerHud : MonoBehaviour
 
         private void Start()
         {
-            DontDestroyOnLoad(transform.root.gameObject);
+            if (DontDestroy)
+                DontDestroyOnLoad(transform.root.gameObject);
+
             Application.runInBackground = true;
 
             // return to offset menu when server or client is stopped

From e3ee1fd53b012d148f7d285ead62c2f48badb2a8 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Mon, 30 Aug 2021 00:36:18 +0100
Subject: [PATCH 155/166] test: fixing namespace for weaver tests

---
 Assets/Tests/Weaver/Assembler.cs                  | 5 +++--
 Assets/Tests/Weaver/BitAttributeTests.cs          | 2 +-
 Assets/Tests/Weaver/ClientRpcTests.cs             | 2 +-
 Assets/Tests/Weaver/ClientServerAttributeTests.cs | 3 ++-
 Assets/Tests/Weaver/GeneralTests.cs               | 2 +-
 Assets/Tests/Weaver/GeneratedReaderWriterTests.cs | 2 +-
 Assets/Tests/Weaver/MonoBehaviourTests.cs         | 2 +-
 Assets/Tests/Weaver/NetworkBehaviourTests.cs      | 2 +-
 Assets/Tests/Weaver/ServerRpcTests.cs             | 2 +-
 Assets/Tests/Weaver/SyncDictionaryTests.cs        | 2 +-
 Assets/Tests/Weaver/SyncListTests.cs              | 2 +-
 Assets/Tests/Weaver/SyncSetTests.cs               | 2 +-
 Assets/Tests/Weaver/SyncVarHookTests.cs           | 2 +-
 Assets/Tests/Weaver/SyncVarTests.cs               | 2 +-
 Assets/Tests/Weaver/Tests.cs                      | 3 ++-
 Assets/Tests/Weaver/WeaverTestLocator.cs          | 2 +-
 16 files changed, 20 insertions(+), 17 deletions(-)

diff --git a/Assets/Tests/Weaver/Assembler.cs b/Assets/Tests/Weaver/Assembler.cs
index 1529f1e6076..6f100faabfe 100644
--- a/Assets/Tests/Weaver/Assembler.cs
+++ b/Assets/Tests/Weaver/Assembler.cs
@@ -1,12 +1,13 @@
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
+using Mirage.Weaver;
 using Mono.Cecil;
 using Unity.CompilationPipeline.Common.ILPostProcessing;
 using UnityEditor.Compilation;
 using UnityEngine;
 
-namespace Mirage.Weaver
+namespace Mirage.Tests.Weaver
 {
     public class CompiledAssembly : ICompiledAssembly
     {
@@ -133,7 +134,7 @@ public AssemblyDefinition Build(IWeaverLogger logger)
                     References = assemblyBuilder.defaultReferences
                 };
 
-                var weaver = new Weaver(logger);
+                var weaver = new Mirage.Weaver.Weaver(logger);
 
                 assembly = weaver.Weave(compiledAssembly);
             };
diff --git a/Assets/Tests/Weaver/BitAttributeTests.cs b/Assets/Tests/Weaver/BitAttributeTests.cs
index d77a70fb965..91dd47fc9fd 100644
--- a/Assets/Tests/Weaver/BitAttributeTests.cs
+++ b/Assets/Tests/Weaver/BitAttributeTests.cs
@@ -1,6 +1,6 @@
 using NUnit.Framework;
 
-namespace Mirage.Weaver
+namespace Mirage.Tests.Weaver
 {
     public class BitAttributeTests : TestsBuildFromTestName
     {
diff --git a/Assets/Tests/Weaver/ClientRpcTests.cs b/Assets/Tests/Weaver/ClientRpcTests.cs
index f5d5e4b0d76..cb460209574 100644
--- a/Assets/Tests/Weaver/ClientRpcTests.cs
+++ b/Assets/Tests/Weaver/ClientRpcTests.cs
@@ -1,6 +1,6 @@
 using NUnit.Framework;
 
-namespace Mirage.Weaver
+namespace Mirage.Tests.Weaver
 {
     public class ClientRpcTests : TestsBuildFromTestName
     {
diff --git a/Assets/Tests/Weaver/ClientServerAttributeTests.cs b/Assets/Tests/Weaver/ClientServerAttributeTests.cs
index 482abf3013a..a2e92beb06c 100644
--- a/Assets/Tests/Weaver/ClientServerAttributeTests.cs
+++ b/Assets/Tests/Weaver/ClientServerAttributeTests.cs
@@ -1,11 +1,12 @@
 using System;
 using System.Linq;
 using System.Linq.Expressions;
+using Mirage.Weaver;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
 using NUnit.Framework;
 
-namespace Mirage.Weaver
+namespace Mirage.Tests.Weaver
 {
     public class ClientServerAttributeTests : TestsBuildFromTestName
     {
diff --git a/Assets/Tests/Weaver/GeneralTests.cs b/Assets/Tests/Weaver/GeneralTests.cs
index 271d0521375..56cbdf79818 100644
--- a/Assets/Tests/Weaver/GeneralTests.cs
+++ b/Assets/Tests/Weaver/GeneralTests.cs
@@ -1,6 +1,6 @@
 using NUnit.Framework;
 
-namespace Mirage.Weaver
+namespace Mirage.Tests.Weaver
 {
     public class GeneralTests : TestsBuildFromTestName
     {
diff --git a/Assets/Tests/Weaver/GeneratedReaderWriterTests.cs b/Assets/Tests/Weaver/GeneratedReaderWriterTests.cs
index 644311da365..b70f3cd9729 100644
--- a/Assets/Tests/Weaver/GeneratedReaderWriterTests.cs
+++ b/Assets/Tests/Weaver/GeneratedReaderWriterTests.cs
@@ -1,6 +1,6 @@
 using NUnit.Framework;
 
-namespace Mirage.Weaver
+namespace Mirage.Tests.Weaver
 {
     public class GeneratedReaderWriterTests : TestsBuildFromTestName
     {
diff --git a/Assets/Tests/Weaver/MonoBehaviourTests.cs b/Assets/Tests/Weaver/MonoBehaviourTests.cs
index b12aed90d94..59eeec1af40 100644
--- a/Assets/Tests/Weaver/MonoBehaviourTests.cs
+++ b/Assets/Tests/Weaver/MonoBehaviourTests.cs
@@ -1,6 +1,6 @@
 using NUnit.Framework;
 
-namespace Mirage.Weaver
+namespace Mirage.Tests.Weaver
 {
     public class MonoBehaviourTests : TestsBuildFromTestName
     {
diff --git a/Assets/Tests/Weaver/NetworkBehaviourTests.cs b/Assets/Tests/Weaver/NetworkBehaviourTests.cs
index 65e3b306301..981be379f8b 100644
--- a/Assets/Tests/Weaver/NetworkBehaviourTests.cs
+++ b/Assets/Tests/Weaver/NetworkBehaviourTests.cs
@@ -1,6 +1,6 @@
 using NUnit.Framework;
 
-namespace Mirage.Weaver
+namespace Mirage.Tests.Weaver
 {
     public class NetworkBehaviourTests : TestsBuildFromTestName
     {
diff --git a/Assets/Tests/Weaver/ServerRpcTests.cs b/Assets/Tests/Weaver/ServerRpcTests.cs
index ed733bef456..3455270b7af 100644
--- a/Assets/Tests/Weaver/ServerRpcTests.cs
+++ b/Assets/Tests/Weaver/ServerRpcTests.cs
@@ -1,6 +1,6 @@
 using NUnit.Framework;
 
-namespace Mirage.Weaver
+namespace Mirage.Tests.Weaver
 {
     public class ServerRpcTests : TestsBuildFromTestName
     {
diff --git a/Assets/Tests/Weaver/SyncDictionaryTests.cs b/Assets/Tests/Weaver/SyncDictionaryTests.cs
index 0edd4a2e179..77c926023c0 100644
--- a/Assets/Tests/Weaver/SyncDictionaryTests.cs
+++ b/Assets/Tests/Weaver/SyncDictionaryTests.cs
@@ -1,6 +1,6 @@
 using NUnit.Framework;
 
-namespace Mirage.Weaver
+namespace Mirage.Tests.Weaver
 {
     // Some tests for SyncObjects are in SyncListTests and apply to SyncDictionary too
     public class SyncDictionaryTests : TestsBuildFromTestName
diff --git a/Assets/Tests/Weaver/SyncListTests.cs b/Assets/Tests/Weaver/SyncListTests.cs
index c8a36c27f55..303d73e18d2 100644
--- a/Assets/Tests/Weaver/SyncListTests.cs
+++ b/Assets/Tests/Weaver/SyncListTests.cs
@@ -1,6 +1,6 @@
 using NUnit.Framework;
 
-namespace Mirage.Weaver
+namespace Mirage.Tests.Weaver
 {
     public class SyncListTests : TestsBuildFromTestName
     {
diff --git a/Assets/Tests/Weaver/SyncSetTests.cs b/Assets/Tests/Weaver/SyncSetTests.cs
index 210a6d40554..7e2afb10699 100644
--- a/Assets/Tests/Weaver/SyncSetTests.cs
+++ b/Assets/Tests/Weaver/SyncSetTests.cs
@@ -1,6 +1,6 @@
 using NUnit.Framework;
 
-namespace Mirage.Weaver
+namespace Mirage.Tests.Weaver
 {
     // Some tests for SyncObjects are in SyncListTests and apply to SyncDictionary too
     public class SyncSetTests : TestsBuildFromTestName
diff --git a/Assets/Tests/Weaver/SyncVarHookTests.cs b/Assets/Tests/Weaver/SyncVarHookTests.cs
index 262c901e1e8..bce28a22d92 100644
--- a/Assets/Tests/Weaver/SyncVarHookTests.cs
+++ b/Assets/Tests/Weaver/SyncVarHookTests.cs
@@ -1,6 +1,6 @@
 using NUnit.Framework;
 
-namespace Mirage.Weaver
+namespace Mirage.Tests.Weaver
 {
     public class SyncVarHookTests : TestsBuildFromTestName
     {
diff --git a/Assets/Tests/Weaver/SyncVarTests.cs b/Assets/Tests/Weaver/SyncVarTests.cs
index 229dd535b1b..d52b7c2aabc 100644
--- a/Assets/Tests/Weaver/SyncVarTests.cs
+++ b/Assets/Tests/Weaver/SyncVarTests.cs
@@ -1,6 +1,6 @@
 using NUnit.Framework;
 
-namespace Mirage.Weaver
+namespace Mirage.Tests.Weaver
 {
     public class SyncVarTests : TestsBuildFromTestName
     {
diff --git a/Assets/Tests/Weaver/Tests.cs b/Assets/Tests/Weaver/Tests.cs
index 7d0fa735dcf..1ac36df5e8d 100644
--- a/Assets/Tests/Weaver/Tests.cs
+++ b/Assets/Tests/Weaver/Tests.cs
@@ -6,8 +6,9 @@
 using NUnit.Framework;
 using Unity.CompilationPipeline.Common.Diagnostics;
 using UnityEngine;
+using Logger = Mirage.Weaver.Logger;
 
-namespace Mirage.Weaver
+namespace Mirage.Tests.Weaver
 {
     public class AssertionMethodAttribute : Attribute { }
 
diff --git a/Assets/Tests/Weaver/WeaverTestLocator.cs b/Assets/Tests/Weaver/WeaverTestLocator.cs
index 74136abc40b..f5a386f4233 100644
--- a/Assets/Tests/Weaver/WeaverTestLocator.cs
+++ b/Assets/Tests/Weaver/WeaverTestLocator.cs
@@ -2,7 +2,7 @@
 using UnityEditor;
 using UnityEngine;
 
-namespace Mirage.Weaver
+namespace Mirage.Tests.Weaver
 {
     /// <summary>
     /// This class is used by weaver tests to find the current directory used for weaver outputs

From d38a8bb02fd7c88c8cdb6aa0ee8f397eef97bd1e Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Mon, 30 Aug 2021 00:37:26 +0100
Subject: [PATCH 156/166] refactor(weaver): fixing naming collision with logger

---
 Assets/Mirage/Weaver/MirageILPostProcessor.cs                 | 2 +-
 Assets/Mirage/Weaver/{Logger.cs => WeaverLogger.cs}           | 2 +-
 Assets/Mirage/Weaver/{Logger.cs.meta => WeaverLogger.cs.meta} | 2 +-
 Assets/Tests/Weaver/Tests.cs                                  | 4 ++--
 4 files changed, 5 insertions(+), 5 deletions(-)
 rename Assets/Mirage/Weaver/{Logger.cs => WeaverLogger.cs} (97%)
 rename Assets/Mirage/Weaver/{Logger.cs.meta => WeaverLogger.cs.meta} (83%)

diff --git a/Assets/Mirage/Weaver/MirageILPostProcessor.cs b/Assets/Mirage/Weaver/MirageILPostProcessor.cs
index 6d09a92d1ae..cb4c206e282 100644
--- a/Assets/Mirage/Weaver/MirageILPostProcessor.cs
+++ b/Assets/Mirage/Weaver/MirageILPostProcessor.cs
@@ -17,7 +17,7 @@ public override ILPostProcessResult Process(ICompiledAssembly compiledAssembly)
             if (!WillProcess(compiledAssembly))
                 return null;
 
-            var logger = new Logger();
+            var logger = new WeaverLogger();
             var weaver = new Weaver(logger);
 
             AssemblyDefinition assemblyDefinition = weaver.Weave(compiledAssembly);
diff --git a/Assets/Mirage/Weaver/Logger.cs b/Assets/Mirage/Weaver/WeaverLogger.cs
similarity index 97%
rename from Assets/Mirage/Weaver/Logger.cs
rename to Assets/Mirage/Weaver/WeaverLogger.cs
index cb1f19dde13..bbfdf1c0fc3 100644
--- a/Assets/Mirage/Weaver/Logger.cs
+++ b/Assets/Mirage/Weaver/WeaverLogger.cs
@@ -8,7 +8,7 @@
 
 namespace Mirage.Weaver
 {
-    public class Logger : IWeaverLogger
+    public class WeaverLogger : IWeaverLogger
     {
         public List<DiagnosticMessage> Diagnostics = new List<DiagnosticMessage>();
 
diff --git a/Assets/Mirage/Weaver/Logger.cs.meta b/Assets/Mirage/Weaver/WeaverLogger.cs.meta
similarity index 83%
rename from Assets/Mirage/Weaver/Logger.cs.meta
rename to Assets/Mirage/Weaver/WeaverLogger.cs.meta
index 3f62978c19c..11e7a75035f 100644
--- a/Assets/Mirage/Weaver/Logger.cs.meta
+++ b/Assets/Mirage/Weaver/WeaverLogger.cs.meta
@@ -1,5 +1,5 @@
 fileFormatVersion: 2
-guid: 2a21c60c40a4c4d679c2b71a7c40882e
+guid: ec36b2acb3f2954488ef1e7d0c07a864
 MonoImporter:
   externalObjects: {}
   serializedVersion: 2
diff --git a/Assets/Tests/Weaver/Tests.cs b/Assets/Tests/Weaver/Tests.cs
index 1ac36df5e8d..bf0af27748e 100644
--- a/Assets/Tests/Weaver/Tests.cs
+++ b/Assets/Tests/Weaver/Tests.cs
@@ -2,11 +2,11 @@
 using System.IO;
 using System.Linq;
 using Mirage.Logging;
+using Mirage.Weaver;
 using Mono.Cecil;
 using NUnit.Framework;
 using Unity.CompilationPipeline.Common.Diagnostics;
 using UnityEngine;
-using Logger = Mirage.Weaver.Logger;
 
 namespace Mirage.Tests.Weaver
 {
@@ -84,7 +84,7 @@ public abstract class Tests
     {
         public static readonly ILogger logger = LogFactory.GetLogger<Tests>(LogType.Exception);
 
-        protected Logger weaverLog = new Logger();
+        protected WeaverLogger weaverLog = new WeaverLogger();
 
         protected AssemblyDefinition assembly;
 

From c382adb3285211c4f915e22ff35273b3b53472e6 Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Sun, 29 Aug 2021 23:53:53 +0000
Subject: [PATCH 157/166] chore(release): 101.9.2 [skip ci]

## [101.9.2](https://github.com/MirageNet/Mirage/compare/v101.9.1...v101.9.2) (2021-08-29)

### Bug Fixes

* fixing namespace for display metrics ([9d3f056](https://github.com/MirageNet/Mirage/commit/9d3f0568943e531474f56852453233e173e3508f))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs               | 2 +-
 Assets/Mirage/CHANGELOG.md                                 | 7 +++++++
 Assets/Mirage/Components/AssemblyInfo.cs                   | 2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                      | 2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs          | 2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs                     | 2 +-
 .../Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs      | 2 +-
 Assets/Mirage/package.json                                 | 2 +-
 8 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index 122c7d27700..be5d058044b 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.9.1")]
+[assembly: AssemblyVersion("101.9.2")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index ecaea74a451..79755dfcf16 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,10 @@
+## [101.9.2](https://github.com/MirageNet/Mirage/compare/v101.9.1...v101.9.2) (2021-08-29)
+
+
+### Bug Fixes
+
+* fixing namespace for display metrics ([9d3f056](https://github.com/MirageNet/Mirage/commit/9d3f0568943e531474f56852453233e173e3508f))
+
 ## [101.9.1](https://github.com/MirageNet/Mirage/compare/v101.9.0...v101.9.1) (2021-08-29)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index d4000bd5a7b..a5a1714bd50 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.9.1")]
+[assembly: AssemblyVersion("101.9.2")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index 9ee05d1052f..79ef073a0b9 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.9.1")]
+[assembly: AssemblyVersion("101.9.2")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index c9da8c39519..6db8bb2d008 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.9.1")]
+[assembly: AssemblyVersion("101.9.2")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index 122c7d27700..be5d058044b 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.9.1")]
+[assembly: AssemblyVersion("101.9.2")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index 122c7d27700..be5d058044b 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.9.1")]
+[assembly: AssemblyVersion("101.9.2")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 61b53d740ec..8e0c408c95e 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "101.9.1",
+    "version": "101.9.2",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From dfd3b6b134d452ecba53453c3809421faa456338 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Mon, 30 Aug 2021 15:46:48 +0100
Subject: [PATCH 158/166] chore: upgrade to docs CI to Unity 2020 LTS (#907)

---
 .github/workflows/docs.yml | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index ff055949ebd..255af92c762 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -8,14 +8,14 @@ jobs:
     runs-on: ubuntu-latest
     # available list of containers here:
     # https://hub.docker.com/r/unityci/editor/tags?page=1&ordering=last_updated&name=ubuntu-2020.1.17f1-base
-    container: unityci/editor:ubuntu-2020.1.17f1-base-0.10.0
+    container: unityci/editor:ubuntu-2020.3.17f1-base-0.15.0
 
     steps:
       - name: Activate unity
         # exit code is 1 for manual activation
         continue-on-error: true
         env:
-          UNITY_LICENSE: ${{ secrets.UNITY_LICENSE2 }}
+          UNITY_LICENSE: ${{ secrets.UNITY_LICENSE_2020_3_17 }}
         run: |          
           echo "$UNITY_LICENSE" | tr -d '\r' > UnityLicenseFile.ulf
           unity-editor -nographics -logFile /dev/stdout -manualLicenseFile UnityLicenseFile.ulf -quit
@@ -27,7 +27,7 @@ jobs:
         uses: actions/cache@v2
         with:
           path: Library
-          key: Library-2020.1.17
+          key: Library-Library-2020.3.17
 
       - name: Generate Solution
         run: unity-editor -nographics -logFile /dev/stdout -customBuildName Mirage -projectPath . -executeMethod  UnityEditor.SyncVS.SyncSolution -quit
@@ -35,7 +35,14 @@ jobs:
       - name: Install docfx
         uses: MirageNet/setup-docfx@v1
 
-      - name: Generate API
+      # Unity2020.3+Linux seems to check for meta data in wrong order, No idea why
+      #   So for metadata we have to run twice so that it correctly finds references to other c# projects
+      #   First run we do without warningsAsErrors, (it will give warning for cref not found)
+      #   Second run we do it with warningsAsErrors, (it should find cref and not give warning)
+      - name: Generate API 1
+        run: docfx metadata --logLevel Warning doc/docfx.json
+
+      - name: Generate API 2
         run: docfx metadata --logLevel Warning --warningsAsErrors doc/docfx.json
 
       - name: Build Docs

From 149bf5adc44f60ad810c2233afceea32c5af2e2a Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Tue, 31 Aug 2021 14:51:55 +0100
Subject: [PATCH 159/166] feat: attributes to use new vector bit packers (#905)

* new exceptions

* adding attributes and tests

* starting weaver tests

* implementing packers and finishing weaver tests

* docs

* rough notes

* adding other headers
---
 .../Serialization/Packers/Vector2Packer.cs    |  12 +-
 .../Serialization/Packers/Vector3Packer.cs    |  12 +
 .../Runtime/Serialization/WeaverAttributes.cs |  34 ++-
 .../Processors/NetworkBehaviourProcessor.cs   |  92 ++++---
 .../Weaver/Processors/SyncVarProcessor.cs     | 200 +++++++++-----
 .../Processors/SyncVars/FloatPackerFinder.cs  | 246 +++++++++++++++++-
 .../Processors/SyncVars/FoundSyncVar.cs       |  22 ++
 Assets/Mirage/Weaver/TypeExtensions.cs        |  11 +
 Assets/Mirage/Weaver/WeaverExceptions.cs      |  15 +-
 .../Tests/Generated/QuaternionPackTests.meta  |   8 +
 .../QuaternionPackBehaviour_10_0.cs           |  50 ++++
 .../QuaternionPackBehaviour_10_0.cs.meta      |  11 +
 .../QuaternionPackBehaviour_10_45.cs          |  50 ++++
 .../QuaternionPackBehaviour_10_45.cs.meta     |  11 +
 .../QuaternionPackBehaviour_8_0.cs            |  50 ++++
 .../QuaternionPackBehaviour_8_0.cs.meta       |  11 +
 .../QuaternionPackBehaviour_8_45.cs           |  50 ++++
 .../QuaternionPackBehaviour_8_45.cs.meta      |  11 +
 .../QuaternionPackBehaviour_9_0.cs            |  50 ++++
 .../QuaternionPackBehaviour_9_0.cs.meta       |  11 +
 .../QuaternionPackBehaviour_9_45.cs           |  50 ++++
 .../QuaternionPackBehaviour_9_45.cs.meta      |  11 +
 Assets/Tests/Generated/Vector2PackTests.meta  |   8 +
 .../Vector2PackBehaviour_1000_42b3.cs         |  45 ++++
 .../Vector2PackBehaviour_1000_42b3.cs.meta    |  11 +
 .../Vector2PackBehaviour_1000_42f.cs          |  45 ++++
 .../Vector2PackBehaviour_1000_42f.cs.meta     |  11 +
 .../Vector2PackBehaviour_1000_42f3.cs         |  45 ++++
 .../Vector2PackBehaviour_1000_42f3.cs.meta    |  11 +
 .../Vector2PackBehaviour_1000_45f.cs          |  45 ++++
 .../Vector2PackBehaviour_1000_45f.cs.meta     |  11 +
 .../Vector2PackBehaviour_100_28b3.cs          |  45 ++++
 .../Vector2PackBehaviour_100_28b3.cs.meta     |  11 +
 .../Vector2PackBehaviour_100_28f.cs           |  45 ++++
 .../Vector2PackBehaviour_100_28f.cs.meta      |  11 +
 .../Vector2PackBehaviour_100_28f3.cs          |  45 ++++
 .../Vector2PackBehaviour_100_28f3.cs.meta     |  11 +
 .../Vector2PackBehaviour_100_30f.cs           |  45 ++++
 .../Vector2PackBehaviour_100_30f.cs.meta      |  11 +
 .../Vector2PackBehaviour_200_39b3.cs          |  45 ++++
 .../Vector2PackBehaviour_200_39b3.cs.meta     |  11 +
 .../Vector2PackBehaviour_200_39f.cs           |  45 ++++
 .../Vector2PackBehaviour_200_39f.cs.meta      |  11 +
 .../Vector2PackBehaviour_200_39f3.cs          |  45 ++++
 .../Vector2PackBehaviour_200_39f3.cs.meta     |  11 +
 Assets/Tests/Generated/Vector3PackTests.meta  |   8 +
 .../Vector3PackBehaviour_1000_42b3.cs         |  46 ++++
 .../Vector3PackBehaviour_1000_42b3.cs.meta    |  11 +
 .../Vector3PackBehaviour_1000_42f.cs          |  46 ++++
 .../Vector3PackBehaviour_1000_42f.cs.meta     |  11 +
 .../Vector3PackBehaviour_1000_42f3.cs         |  46 ++++
 .../Vector3PackBehaviour_1000_42f3.cs.meta    |  11 +
 .../Vector3PackBehaviour_1000_45f.cs          |  46 ++++
 .../Vector3PackBehaviour_1000_45f.cs.meta     |  11 +
 .../Vector3PackBehaviour_100_28b3.cs          |  46 ++++
 .../Vector3PackBehaviour_100_28b3.cs.meta     |  11 +
 .../Vector3PackBehaviour_100_28f.cs           |  46 ++++
 .../Vector3PackBehaviour_100_28f.cs.meta      |  11 +
 .../Vector3PackBehaviour_100_28f3.cs          |  46 ++++
 .../Vector3PackBehaviour_100_28f3.cs.meta     |  11 +
 .../Vector3PackBehaviour_100_30f.cs           |  46 ++++
 .../Vector3PackBehaviour_100_30f.cs.meta      |  11 +
 .../Vector3PackBehaviour_200_39b3.cs          |  46 ++++
 .../Vector3PackBehaviour_200_39b3.cs.meta     |  11 +
 .../Vector3PackBehaviour_200_39f.cs           |  46 ++++
 .../Vector3PackBehaviour_200_39f.cs.meta      |  11 +
 .../Vector3PackBehaviour_200_39f3.cs          |  46 ++++
 .../Vector3PackBehaviour_200_39f3.cs.meta     |  11 +
 .../.QuaternionPackTestTemplate.txt           |  50 ++++
 .../Generators/.Vector2PackTestTemplate.txt   |  45 ++++
 .../Generators/.Vector3PackTestTemplate.txt   |  46 ++++
 .../Generators/QuaternionPackTestGenerator.cs |  36 +++
 .../QuaternionPackTestGenerator.cs.meta       |  11 +
 .../Generators/Vector2PackTestGenerator.cs    |  42 +++
 .../Vector2PackTestGenerator.cs.meta          |  11 +
 .../Generators/Vector3PackTestGenerator.cs    |  42 +++
 .../Vector3PackTestGenerator.cs.meta          |  11 +
 Assets/Tests/Weaver/BitAttributeTests.cs      |  90 +++++++
 .../BitAttributeTests~/QuaternionPack.cs      |  15 ++
 .../QuaternionPackInvalid.cs                  |  25 ++
 .../Weaver/BitAttributeTests~/Vector2Pack.cs  |  24 ++
 .../BitAttributeTests~/Vector2PackInvalid.cs  |  45 ++++
 .../Weaver/BitAttributeTests~/Vector3Pack.cs  |  24 ++
 .../BitAttributeTests~/Vector3PackInvalid.cs  |  53 ++++
 .../Guides/BitPacking/QuaternionPacker.md     | 112 +++++++-
 .../Guides/BitPacking/VectorPacker.md         | 107 +++++++-
 86 files changed, 2951 insertions(+), 115 deletions(-)
 create mode 100644 Assets/Tests/Generated/QuaternionPackTests.meta
 create mode 100644 Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_10_0.cs
 create mode 100644 Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_10_0.cs.meta
 create mode 100644 Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_10_45.cs
 create mode 100644 Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_10_45.cs.meta
 create mode 100644 Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_8_0.cs
 create mode 100644 Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_8_0.cs.meta
 create mode 100644 Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_8_45.cs
 create mode 100644 Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_8_45.cs.meta
 create mode 100644 Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_9_0.cs
 create mode 100644 Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_9_0.cs.meta
 create mode 100644 Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_9_45.cs
 create mode 100644 Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_9_45.cs.meta
 create mode 100644 Assets/Tests/Generated/Vector2PackTests.meta
 create mode 100644 Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_42b3.cs
 create mode 100644 Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_42b3.cs.meta
 create mode 100644 Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_42f.cs
 create mode 100644 Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_42f.cs.meta
 create mode 100644 Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_42f3.cs
 create mode 100644 Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_42f3.cs.meta
 create mode 100644 Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_45f.cs
 create mode 100644 Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_45f.cs.meta
 create mode 100644 Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_28b3.cs
 create mode 100644 Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_28b3.cs.meta
 create mode 100644 Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_28f.cs
 create mode 100644 Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_28f.cs.meta
 create mode 100644 Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_28f3.cs
 create mode 100644 Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_28f3.cs.meta
 create mode 100644 Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_30f.cs
 create mode 100644 Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_30f.cs.meta
 create mode 100644 Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_200_39b3.cs
 create mode 100644 Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_200_39b3.cs.meta
 create mode 100644 Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_200_39f.cs
 create mode 100644 Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_200_39f.cs.meta
 create mode 100644 Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_200_39f3.cs
 create mode 100644 Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_200_39f3.cs.meta
 create mode 100644 Assets/Tests/Generated/Vector3PackTests.meta
 create mode 100644 Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_42b3.cs
 create mode 100644 Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_42b3.cs.meta
 create mode 100644 Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_42f.cs
 create mode 100644 Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_42f.cs.meta
 create mode 100644 Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_42f3.cs
 create mode 100644 Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_42f3.cs.meta
 create mode 100644 Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_45f.cs
 create mode 100644 Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_45f.cs.meta
 create mode 100644 Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_28b3.cs
 create mode 100644 Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_28b3.cs.meta
 create mode 100644 Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_28f.cs
 create mode 100644 Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_28f.cs.meta
 create mode 100644 Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_28f3.cs
 create mode 100644 Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_28f3.cs.meta
 create mode 100644 Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_30f.cs
 create mode 100644 Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_30f.cs.meta
 create mode 100644 Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_200_39b3.cs
 create mode 100644 Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_200_39b3.cs.meta
 create mode 100644 Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_200_39f.cs
 create mode 100644 Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_200_39f.cs.meta
 create mode 100644 Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_200_39f3.cs
 create mode 100644 Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_200_39f3.cs.meta
 create mode 100644 Assets/Tests/Generators/.QuaternionPackTestTemplate.txt
 create mode 100644 Assets/Tests/Generators/.Vector2PackTestTemplate.txt
 create mode 100644 Assets/Tests/Generators/.Vector3PackTestTemplate.txt
 create mode 100644 Assets/Tests/Generators/QuaternionPackTestGenerator.cs
 create mode 100644 Assets/Tests/Generators/QuaternionPackTestGenerator.cs.meta
 create mode 100644 Assets/Tests/Generators/Vector2PackTestGenerator.cs
 create mode 100644 Assets/Tests/Generators/Vector2PackTestGenerator.cs.meta
 create mode 100644 Assets/Tests/Generators/Vector3PackTestGenerator.cs
 create mode 100644 Assets/Tests/Generators/Vector3PackTestGenerator.cs.meta
 create mode 100644 Assets/Tests/Weaver/BitAttributeTests~/QuaternionPack.cs
 create mode 100644 Assets/Tests/Weaver/BitAttributeTests~/QuaternionPackInvalid.cs
 create mode 100644 Assets/Tests/Weaver/BitAttributeTests~/Vector2Pack.cs
 create mode 100644 Assets/Tests/Weaver/BitAttributeTests~/Vector2PackInvalid.cs
 create mode 100644 Assets/Tests/Weaver/BitAttributeTests~/Vector3Pack.cs
 create mode 100644 Assets/Tests/Weaver/BitAttributeTests~/Vector3PackInvalid.cs

diff --git a/Assets/Mirage/Runtime/Serialization/Packers/Vector2Packer.cs b/Assets/Mirage/Runtime/Serialization/Packers/Vector2Packer.cs
index f2b3019daad..18853671a37 100644
--- a/Assets/Mirage/Runtime/Serialization/Packers/Vector2Packer.cs
+++ b/Assets/Mirage/Runtime/Serialization/Packers/Vector2Packer.cs
@@ -1,4 +1,4 @@
-/*
+/*
 MIT License
 
 Copyright (c) 2021 James Frowen
@@ -31,6 +31,16 @@ public sealed class Vector2Packer
         readonly FloatPacker xPacker;
         readonly FloatPacker yPacker;
 
+        public Vector2Packer(float xMax, float yMax, int xBitCount, int yBitCount)
+        {
+            xPacker = new FloatPacker(xMax, xBitCount);
+            yPacker = new FloatPacker(yMax, yBitCount);
+        }
+        public Vector2Packer(float xMax, float yMax, float xPrecision, float yPrecision)
+        {
+            xPacker = new FloatPacker(xMax, xPrecision);
+            yPacker = new FloatPacker(yMax, yPrecision);
+        }
         public Vector2Packer(Vector2 max, Vector2 precision)
         {
             xPacker = new FloatPacker(max.x, precision.x);
diff --git a/Assets/Mirage/Runtime/Serialization/Packers/Vector3Packer.cs b/Assets/Mirage/Runtime/Serialization/Packers/Vector3Packer.cs
index eea88ab2517..9fac207fad3 100644
--- a/Assets/Mirage/Runtime/Serialization/Packers/Vector3Packer.cs
+++ b/Assets/Mirage/Runtime/Serialization/Packers/Vector3Packer.cs
@@ -32,6 +32,18 @@ public sealed class Vector3Packer
         readonly FloatPacker yPacker;
         readonly FloatPacker zPacker;
 
+        public Vector3Packer(float xMax, float yMax, float zMax, int xBitCount, int yBitCount, int zBitCount)
+        {
+            xPacker = new FloatPacker(xMax, xBitCount);
+            yPacker = new FloatPacker(yMax, yBitCount);
+            zPacker = new FloatPacker(zMax, zBitCount);
+        }
+        public Vector3Packer(float xMax, float yMax, float zMax, float xPrecision, float yPrecision, float zPrecision)
+        {
+            xPacker = new FloatPacker(xMax, xPrecision);
+            yPacker = new FloatPacker(yMax, yPrecision);
+            zPacker = new FloatPacker(zMax, zPrecision);
+        }
         public Vector3Packer(Vector3 max, Vector3 precision)
         {
             xPacker = new FloatPacker(max.x, precision.x);
diff --git a/Assets/Mirage/Runtime/Serialization/WeaverAttributes.cs b/Assets/Mirage/Runtime/Serialization/WeaverAttributes.cs
index cc6fc0b034d..3a7a3646cc7 100644
--- a/Assets/Mirage/Runtime/Serialization/WeaverAttributes.cs
+++ b/Assets/Mirage/Runtime/Serialization/WeaverAttributes.cs
@@ -60,8 +60,40 @@ public class FloatPackAttribute : Attribute
         public FloatPackAttribute(float max, float precision) { }
 
         /// <param name="max">Max value of the float</param>
-        /// <param name="bitCount">number of bits to pack the field into.</param>
+        /// <param name="bitCount">number of bits to pack the field into</param>
         public FloatPackAttribute(float max, int bitCount) { }
     }
+
+    /// <summary>
+    /// 
+    /// </summary>
+    public class Vector3PackAttribute : Attribute
+    {
+        public Vector3PackAttribute(float xMax, float yMax, float zMax, float xPrecision, float yPrecision, float zPrecision) { }
+        public Vector3PackAttribute(float xMax, float yMax, float zMax, float precision) { }
+
+        public Vector3PackAttribute(float xMax, float yMax, float zMax, int xBitCount, int yBitCount, int ZBitCount) { }
+        public Vector3PackAttribute(float xMax, float yMax, float zMax, int bitCount) { }
+    }
+
+    /// <summary>
+    /// 
+    /// </summary>
+    public class Vector2PackAttribute : Attribute
+    {
+        public Vector2PackAttribute(float xMax, float yMax, float xPrecision, float yPrecision) { }
+        public Vector2PackAttribute(float xMax, float yMax, float precision) { }
+
+        public Vector2PackAttribute(float xMax, float yMax, int xBitCount, int yBitCount) { }
+        public Vector2PackAttribute(float xMax, float yMax, int bitCount) { }
+    }
+
+    /// <summary>
+    /// 
+    /// </summary>
+    public class QuaternionPackAttribute : Attribute
+    {
+        public QuaternionPackAttribute(int bitPerElement) { }
+    }
 #pragma warning restore IDE0060 // Remove unused parameter
 }
diff --git a/Assets/Mirage/Weaver/Processors/NetworkBehaviourProcessor.cs b/Assets/Mirage/Weaver/Processors/NetworkBehaviourProcessor.cs
index dfc20f5b6bc..a63b70fd0e9 100644
--- a/Assets/Mirage/Weaver/Processors/NetworkBehaviourProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/NetworkBehaviourProcessor.cs
@@ -1,3 +1,4 @@
+using System;
 using System.Collections.Generic;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
@@ -89,45 +90,11 @@ void RegisterRpcs()
         {
             Weaver.DebugLog(netBehaviourSubclass, "  GenerateConstants ");
 
-            // find static constructor
-            MethodDefinition cctor = netBehaviourSubclass.GetMethod(".cctor");
-            if (cctor != null)
-            {
-                // remove the return opcode from end of function. will add our own later.
-                if (cctor.Body.Instructions.Count != 0)
-                {
-                    Instruction retInstr = cctor.Body.Instructions[cctor.Body.Instructions.Count - 1];
-                    if (retInstr.OpCode == OpCodes.Ret)
-                    {
-                        cctor.Body.Instructions.RemoveAt(cctor.Body.Instructions.Count - 1);
-                    }
-                    else
-                    {
-                        logger.Error($"{netBehaviourSubclass.Name} has invalid class constructor", cctor);
-                        return;
-                    }
-                }
-            }
-            else
+            AddToStaticConstructor(netBehaviourSubclass, (worker) =>
             {
-                // make one!
-                cctor = netBehaviourSubclass.AddMethod(".cctor", MethodAttributes.Private |
-                        MethodAttributes.HideBySig |
-                        MethodAttributes.SpecialName |
-                        MethodAttributes.RTSpecialName |
-                        MethodAttributes.Static);
-            }
-
-            ILProcessor cctorWorker = cctor.Body.GetILProcessor();
-
-            serverRpcProcessor.RegisterServerRpcs(cctorWorker);
-
-            clientRpcProcessor.RegisterClientRpcs(cctorWorker);
-
-            cctorWorker.Append(cctorWorker.Create(OpCodes.Ret));
-
-            // in case class had no cctor, it might have BeforeFieldInit, so injected cctor would be called too late
-            netBehaviourSubclass.Attributes &= ~TypeAttributes.BeforeFieldInit;
+                serverRpcProcessor.RegisterServerRpcs(worker);
+                clientRpcProcessor.RegisterClientRpcs(worker);
+            });
         }
 
         void ProcessRpcs()
@@ -169,5 +136,54 @@ void ProcessRpcs()
 
             RegisterRpcs();
         }
+
+        /// <summary>
+        /// Adds code to static Constructor
+        /// <para>
+        /// If Constructor is missing a new one will be created
+        /// </para>
+        /// </summary>
+        /// <param name="body">code to write</param>
+        public static void AddToStaticConstructor(TypeDefinition typeDefinition, Action<ILProcessor> body)
+        {
+            MethodDefinition cctor = typeDefinition.GetMethod(".cctor");
+            if (cctor != null)
+            {
+                // remove the return opcode from end of function. will add our own later.
+                if (cctor.Body.Instructions.Count != 0)
+                {
+                    Instruction retInstr = cctor.Body.Instructions[cctor.Body.Instructions.Count - 1];
+                    if (retInstr.OpCode == OpCodes.Ret)
+                    {
+                        cctor.Body.Instructions.RemoveAt(cctor.Body.Instructions.Count - 1);
+                    }
+                    else
+                    {
+                        throw new NetworkBehaviourException($"{typeDefinition.Name} has invalid static constructor", cctor, cctor.GetSequencePoint(retInstr));
+                    }
+                }
+            }
+            else
+            {
+                // make one!
+                cctor = typeDefinition.AddMethod(".cctor", MethodAttributes.Private |
+                        MethodAttributes.HideBySig |
+                        MethodAttributes.SpecialName |
+                        MethodAttributes.RTSpecialName |
+                        MethodAttributes.Static);
+            }
+
+            ILProcessor worker = cctor.Body.GetILProcessor();
+
+            // add new code to bottom of constructor
+            // todo should we be adding new code to top of function instead? incase user has early return in custom constructor?
+            body.Invoke(worker);
+
+            // re-add return bececause we removed it earlier
+            worker.Append(worker.Create(OpCodes.Ret));
+
+            // in case class had no cctor, it might have BeforeFieldInit, so injected cctor would be called too late
+            typeDefinition.Attributes &= ~TypeAttributes.BeforeFieldInit;
+        }
     }
 }
diff --git a/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs b/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
index 34ef0c66054..a362b21855e 100644
--- a/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncVarProcessor.cs
@@ -1,11 +1,9 @@
 using System;
-using System.Linq;
 using Mirage.Serialization;
 using Mirage.Weaver.NetworkBehaviours;
 using Mirage.Weaver.SyncVars;
 using Mono.Cecil;
 using Mono.Cecil.Cil;
-using Mono.Cecil.Rocks;
 using FieldAttributes = Mono.Cecil.FieldAttributes;
 using MethodAttributes = Mono.Cecil.MethodAttributes;
 using PropertyAttributes = Mono.Cecil.PropertyAttributes;
@@ -135,68 +133,133 @@ void ProcessSyncVar(FoundSyncVar syncVar)
             {
                 createFloatPackField(syncVar);
             }
+            if (syncVar.Vector3PackSettings.HasValue)
+            {
+                createVector3PackField(syncVar);
+            }
+            if (syncVar.Vector2PackSettings.HasValue)
+            {
+                createVector2PackField(syncVar);
+            }
+            if (syncVar.QuaternionBitCount.HasValue)
+            {
+                createQuaternionPackField(syncVar);
+            }
         }
 
         private void createFloatPackField(FoundSyncVar syncVar)
         {
-            TypeReference packerRer = module.ImportReference(typeof(FloatPacker));
-            var packerField = new FieldDefinition($"{syncVar.FieldDefinition.Name}__Packer", FieldAttributes.Private | FieldAttributes.Static, packerRer);
-            packerField.DeclaringType = syncVar.FieldDefinition.DeclaringType;
-            syncVar.FieldDefinition.DeclaringType.Fields.Add(packerField);
-            syncVar.PackerField = packerField;
-
+            syncVar.PackerField = behaviour.TypeDefinition.AddField<FloatPacker>($"{syncVar.FieldDefinition.Name}__Packer", FieldAttributes.Private | FieldAttributes.Static);
 
-            // todo move this
-            MethodDefinition cctor = behaviour.TypeDefinition.GetMethod(".cctor");
-            if (cctor != null)
+            NetworkBehaviourProcessor.AddToStaticConstructor(behaviour.TypeDefinition, (worker) =>
             {
-                // remove the return opcode from end of function. will add our own later.
-                if (cctor.Body.Instructions.Count != 0)
+                FloatPackSettings settings = syncVar.FloatPackSettings.Value;
+
+                worker.Append(worker.Create(OpCodes.Ldc_R4, settings.max));
+
+                // packer has 2 constructors, get the one that matches the attribute type
+                MethodReference packerCtor = null;
+                if (settings.precision.HasValue)
                 {
-                    Instruction retInstr = cctor.Body.Instructions[cctor.Body.Instructions.Count - 1];
-                    if (retInstr.OpCode == OpCodes.Ret)
-                    {
-                        cctor.Body.Instructions.RemoveAt(cctor.Body.Instructions.Count - 1);
-                    }
-                    else
-                    {
-                        throw new FloatPackException($"{behaviour.TypeDefinition.Name} has invalid class constructor", cctor);
-                    }
+                    worker.Append(worker.Create(OpCodes.Ldc_R4, settings.precision.Value));
+                    packerCtor = module.ImportReference(() => new FloatPacker(default, default(float)));
                 }
-            }
-            else
+                else if (settings.bitCount.HasValue)
+                {
+                    worker.Append(worker.Create(OpCodes.Ldc_I4, settings.bitCount.Value));
+                    packerCtor = module.ImportReference(() => new FloatPacker(default, default(int)));
+                }
+                else
+                {
+                    throw new InvalidOperationException($"Invalid FloatPackSettings");
+                }
+                worker.Append(worker.Create(OpCodes.Newobj, packerCtor));
+                worker.Append(worker.Create(OpCodes.Stsfld, syncVar.PackerField));
+            });
+        }
+
+        private void createVector3PackField(FoundSyncVar syncVar)
+        {
+            syncVar.PackerField = behaviour.TypeDefinition.AddField<Vector3Packer>($"{syncVar.FieldDefinition.Name}__Packer", FieldAttributes.Private | FieldAttributes.Static);
+
+            NetworkBehaviourProcessor.AddToStaticConstructor(behaviour.TypeDefinition, (worker) =>
             {
-                // make one!
-                cctor = behaviour.TypeDefinition.AddMethod(".cctor", MethodAttributes.Private |
-                        MethodAttributes.HideBySig |
-                        MethodAttributes.SpecialName |
-                        MethodAttributes.RTSpecialName |
-                        MethodAttributes.Static);
-            }
+                Vector3PackSettings settings = syncVar.Vector3PackSettings.Value;
 
-            ILProcessor worker = cctor.Body.GetILProcessor();
+                worker.Append(worker.Create(OpCodes.Ldc_R4, settings.max.x));
+                worker.Append(worker.Create(OpCodes.Ldc_R4, settings.max.y));
+                worker.Append(worker.Create(OpCodes.Ldc_R4, settings.max.z));
 
-            worker.Append(worker.Create(OpCodes.Ldc_R4, syncVar.FloatPackSettings.Value.max));
+                // packer has 2 constructors, get the one that matches the attribute type
+                MethodReference packerCtor = null;
+                if (settings.precision.HasValue)
+                {
+                    worker.Append(worker.Create(OpCodes.Ldc_R4, settings.precision.Value.x));
+                    worker.Append(worker.Create(OpCodes.Ldc_R4, settings.precision.Value.y));
+                    worker.Append(worker.Create(OpCodes.Ldc_R4, settings.precision.Value.z));
+                    packerCtor = module.ImportReference(() => new Vector3Packer(default(float), default(float), default(float), default(float), default(float), default(float)));
+                }
+                else if (settings.bitCount.HasValue)
+                {
+                    worker.Append(worker.Create(OpCodes.Ldc_I4, settings.bitCount.Value.x));
+                    worker.Append(worker.Create(OpCodes.Ldc_I4, settings.bitCount.Value.y));
+                    worker.Append(worker.Create(OpCodes.Ldc_I4, settings.bitCount.Value.z));
+                    packerCtor = module.ImportReference(() => new Vector3Packer(default(float), default(float), default(float), default(int), default(int), default(int)));
+                }
+                else
+                {
+                    throw new InvalidOperationException($"Invalid Vector3PackSettings");
+                }
+                worker.Append(worker.Create(OpCodes.Newobj, packerCtor));
+                worker.Append(worker.Create(OpCodes.Stsfld, syncVar.PackerField));
+            });
+        }
+        private void createVector2PackField(FoundSyncVar syncVar)
+        {
+            syncVar.PackerField = behaviour.TypeDefinition.AddField<Vector2Packer>($"{syncVar.FieldDefinition.Name}__Packer", FieldAttributes.Private | FieldAttributes.Static);
 
-            // floatPacker has 2 constructors, get the one that matches the attribute type
-            MethodReference packerCtor = null;
-            if (syncVar.FloatPackSettings.Value.precision.HasValue)
+            NetworkBehaviourProcessor.AddToStaticConstructor(behaviour.TypeDefinition, (worker) =>
             {
-                worker.Append(worker.Create(OpCodes.Ldc_R4, syncVar.FloatPackSettings.Value.precision.Value));
-                packerCtor = module.ImportReference(packerRer.Resolve().GetConstructors().First(x => x.Parameters[1].ParameterType.Is<float>()));
-            }
-            else if (syncVar.FloatPackSettings.Value.bitCount.HasValue)
-            {
-                worker.Append(worker.Create(OpCodes.Ldc_I4, syncVar.FloatPackSettings.Value.bitCount.Value));
-                packerCtor = module.ImportReference(packerRer.Resolve().GetConstructors().First(x => x.Parameters[1].ParameterType.Is<int>()));
-            }
-            else
+                Vector2PackSettings settings = syncVar.Vector2PackSettings.Value;
+
+                worker.Append(worker.Create(OpCodes.Ldc_R4, settings.max.x));
+                worker.Append(worker.Create(OpCodes.Ldc_R4, settings.max.y));
+
+                // packer has 2 constructors, get the one that matches the attribute type
+                MethodReference packerCtor = null;
+                if (settings.precision.HasValue)
+                {
+                    worker.Append(worker.Create(OpCodes.Ldc_R4, settings.precision.Value.x));
+                    worker.Append(worker.Create(OpCodes.Ldc_R4, settings.precision.Value.y));
+                    packerCtor = module.ImportReference(() => new Vector2Packer(default(float), default(float), default(float), default(float)));
+                }
+                else if (settings.bitCount.HasValue)
+                {
+                    worker.Append(worker.Create(OpCodes.Ldc_I4, settings.bitCount.Value.x));
+                    worker.Append(worker.Create(OpCodes.Ldc_I4, settings.bitCount.Value.y));
+                    packerCtor = module.ImportReference(() => new Vector2Packer(default(float), default(float), default(int), default(int)));
+                }
+                else
+                {
+                    throw new InvalidOperationException($"Invalid Vector2PackSettings");
+                }
+                worker.Append(worker.Create(OpCodes.Newobj, packerCtor));
+                worker.Append(worker.Create(OpCodes.Stsfld, syncVar.PackerField));
+            });
+        }
+        private void createQuaternionPackField(FoundSyncVar syncVar)
+        {
+            syncVar.PackerField = behaviour.TypeDefinition.AddField<QuaternionPacker>($"{syncVar.FieldDefinition.Name}__Packer", FieldAttributes.Private | FieldAttributes.Static);
+
+            NetworkBehaviourProcessor.AddToStaticConstructor(behaviour.TypeDefinition, (worker) =>
             {
-                throw new InvalidOperationException($"Invalid FloatPackSettings");
-            }
-            worker.Append(worker.Create(OpCodes.Newobj, packerCtor));
-            worker.Append(worker.Create(OpCodes.Stsfld, packerField));
-            worker.Append(worker.Create(OpCodes.Ret));
+                int bitCount = syncVar.QuaternionBitCount.Value;
+
+                worker.Append(worker.Create(OpCodes.Ldc_I4, bitCount));
+                MethodReference packerCtor = module.ImportReference(() => new QuaternionPacker(default(int)));
+                worker.Append(worker.Create(OpCodes.Newobj, packerCtor));
+                worker.Append(worker.Create(OpCodes.Stsfld, syncVar.PackerField));
+            });
         }
 
         MethodDefinition GenerateSyncVarGetter(FoundSyncVar syncVar)
@@ -500,7 +563,19 @@ void WriteFromField(ILProcessor worker, ParameterDefinition writerParameter, Fou
             }
             else if (syncVar.FloatPackSettings.HasValue)
             {
-                WriteFloatPack();
+                WritePacker(module.ImportReference((FloatPacker p) => p.Pack(default, default)));
+            }
+            else if (syncVar.Vector2PackSettings.HasValue)
+            {
+                WritePacker(module.ImportReference((Vector2Packer p) => p.Pack(default, default)));
+            }
+            else if (syncVar.Vector3PackSettings.HasValue)
+            {
+                WritePacker(module.ImportReference((Vector3Packer p) => p.Pack(default, default)));
+            }
+            else if (syncVar.QuaternionBitCount.HasValue)
+            {
+                WritePacker(module.ImportReference((QuaternionPacker p) => p.Pack(default, default)));
             }
             else
             {
@@ -558,10 +633,8 @@ void WriteSubtractMinValue()
                 worker.Append(worker.Create(OpCodes.Ldc_I4, syncVar.BitCountMinValue.Value));
                 worker.Append(worker.Create(OpCodes.Sub));
             }
-            void WriteFloatPack()
+            void WritePacker(MethodReference packMethod)
             {
-                MethodReference packMethod = module.ImportReference((FloatPacker p) => p.Pack(default, default));
-
                 // Generates: packer.pack(writer, field)
                 worker.Append(worker.Create(OpCodes.Ldarg_0));
                 worker.Append(worker.Create(OpCodes.Ldfld, syncVar.PackerField.MakeHostGenericIfNeeded()));
@@ -692,7 +765,20 @@ void ReadToField(ILProcessor worker, ParameterDefinition readerParameter, FoundS
             }
             else if (syncVar.FloatPackSettings.HasValue)
             {
-                ReadFloatPack();
+                ReadPacker(module.ImportReference((FloatPacker p) => p.Unpack(default(NetworkReader))));
+            }
+            else if (syncVar.Vector2PackSettings.HasValue)
+            {
+                ReadPacker(module.ImportReference((Vector2Packer p) => p.Unpack(default(NetworkReader))));
+            }
+            else if (syncVar.Vector3PackSettings.HasValue)
+            {
+                ReadPacker(module.ImportReference((Vector3Packer p) => p.Unpack(default(NetworkReader))));
+            }
+
+            else if (syncVar.QuaternionBitCount.HasValue)
+            {
+                ReadPacker(module.ImportReference((QuaternionPacker p) => p.Unpack(default(NetworkReader))));
             }
             else
             {
@@ -753,10 +839,8 @@ void ReadAddMinValue()
                 worker.Append(worker.Create(OpCodes.Ldc_I4, syncVar.BitCountMinValue.Value));
                 worker.Append(worker.Create(OpCodes.Add));
             }
-            void ReadFloatPack()
+            void ReadPacker(MethodReference unpackMethod)
             {
-                MethodReference unpackMethod = module.ImportReference((FloatPacker p) => p.Unpack(default(NetworkReader)));
-
                 // Generates: ... = packer.unpack(reader)
                 worker.Append(worker.Create(OpCodes.Ldarg_0));
                 worker.Append(worker.Create(OpCodes.Ldfld, syncVar.PackerField.MakeHostGenericIfNeeded()));
diff --git a/Assets/Mirage/Weaver/Processors/SyncVars/FloatPackerFinder.cs b/Assets/Mirage/Weaver/Processors/SyncVars/FloatPackerFinder.cs
index 1e8b0db6642..55c96cdfd48 100644
--- a/Assets/Mirage/Weaver/Processors/SyncVars/FloatPackerFinder.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncVars/FloatPackerFinder.cs
@@ -1,6 +1,7 @@
-using System;
+using System;
 using Mirage.Serialization;
 using Mono.Cecil;
+using UnityEngine;
 
 namespace Mirage.Weaver.SyncVars
 {
@@ -28,33 +29,250 @@ internal static class FloatPackFinder
             if (arg1.Type.Is<float>())
             {
                 float precision = (float)arg1.Value;
-                if (precision < 0)
+                ValidatePrecision(syncVar, settings.max, precision, (s, m) => new FloatPackException(s, m));
+                settings.precision = precision;
+            }
+            else
+            {
+                int bitCount = (int)arg1.Value;
+                ValidateBitCount(syncVar, bitCount, (s, m) => new FloatPackException(s, m));
+                settings.bitCount = bitCount;
+            }
+
+            return settings;
+        }
+
+        public static void ValidatePrecision<T>(FieldDefinition syncVar, float max, float precision, Func<string, MemberReference, T> CreateException) where T : WeaverException
+        {
+            if (precision < 0)
+            {
+                throw CreateException.Invoke($"Precsion must be positive, precision:{precision}", syncVar);
+            }
+            // todo is there a better way to check if Precsion is too small?
+            double expectedBitCount = Math.Floor(Math.Log(2 * max / precision, 2)) + 1;
+            if (expectedBitCount > 30)
+            {
+                throw CreateException.Invoke($"Precsion is too small, precision:{precision}", syncVar);
+            }
+        }
+        public static void ValidateBitCount<T>(FieldDefinition syncVar, int bitCount, Func<string, MemberReference, T> CreateException) where T : WeaverException
+        {
+            if (bitCount > 30)
+            {
+                throw CreateException.Invoke($"BitCount must be between 1 and 30 (inclusive), bitCount:{bitCount}", syncVar);
+            }
+            if (bitCount < 1)
+            {
+                throw CreateException.Invoke($"BitCount must be between 1 and 30 (inclusive), bitCount:{bitCount}", syncVar);
+            }
+        }
+    }
+
+    internal static class Vector2Finder
+    {
+        public static Vector2PackSettings? GetPackerSettings(FieldDefinition syncVar)
+        {
+            CustomAttribute attribute = syncVar.GetCustomAttribute<Vector2PackAttribute>();
+            if (attribute == null)
+                return default;
+
+            if (!syncVar.FieldType.Is<Vector2>())
+            {
+                throw new Vector2PackException($"{syncVar.FieldType} is not a supported type for [Vector2Pack]", syncVar);
+            }
+
+            var settings = new Vector2PackSettings();
+            for (int i = 0; i < 2; i++)
+            {
+                settings.max[i] = (float)attribute.ConstructorArguments[i].Value;
+                if (settings.max[i] <= 0)
                 {
-                    throw new FloatPackException($"Precsion must be positive, precision:{precision}", syncVar);
+                    throw new Vector2PackException($"Max must be above 0, max:{settings.max}", syncVar);
                 }
-                // todo is there a better way to check if Precsion is too small?
-                double expectedBitCount = Math.Floor(Math.Log(2 * settings.max / precision, 2)) + 1;
-                if (expectedBitCount > 30)
+            }
+
+            if (attribute.ConstructorArguments.Count == 3)
+            {
+                CustomAttributeArgument arg = attribute.ConstructorArguments[2];
+                if (arg.Type.Is<float>())
                 {
-                    throw new FloatPackException($"Precsion is too small, precision:{precision}", syncVar);
+                    Precisionfrom1(syncVar, ref settings, arg);
+                }
+                else
+                {
+                    BitCountfrom1(syncVar, ref settings, arg);
                 }
-                settings.precision = precision;
             }
             else
             {
-                int bitCount = (int)arg1.Value;
-                if (bitCount > 30)
+                CustomAttributeArgument xArg = attribute.ConstructorArguments[2];
+                CustomAttributeArgument yArg = attribute.ConstructorArguments[3];
+                if (xArg.Type.Is<float>())
                 {
-                    throw new FloatPackException($"BitCount must be between 1 and 30 (inclusive), bitCount:{bitCount}", syncVar);
+                    PrecisionFrom2(syncVar, ref settings, xArg, yArg);
                 }
-                if (bitCount < 1)
+                else
                 {
-                    throw new FloatPackException($"BitCount must be between 1 and 30 (inclusive), bitCount:{bitCount}", syncVar);
+                    BitCountFrom2(syncVar, ref settings, xArg, yArg);
                 }
-                settings.bitCount = bitCount;
             }
 
             return settings;
         }
+
+        private static void Precisionfrom1(FieldDefinition syncVar, ref Vector2PackSettings settings, CustomAttributeArgument arg)
+        {
+            // check vs all 3 axis
+            float precision = (float)arg.Value;
+            FloatPackFinder.ValidatePrecision(syncVar, settings.max.x, precision, (s, m) => new Vector2PackException(s, m));
+            FloatPackFinder.ValidatePrecision(syncVar, settings.max.y, precision, (s, m) => new Vector2PackException(s, m));
+            settings.precision = new Vector2(precision, precision);
+        }
+        private static void BitCountfrom1(FieldDefinition syncVar, ref Vector2PackSettings settings, CustomAttributeArgument arg)
+        {
+            int bitCount = (int)arg.Value;
+            FloatPackFinder.ValidateBitCount(syncVar, bitCount, (s, m) => new Vector2PackException(s, m));
+            settings.bitCount = new Vector2Int(bitCount, bitCount);
+        }
+        private static void PrecisionFrom2(FieldDefinition syncVar, ref Vector2PackSettings settings, CustomAttributeArgument xArg, CustomAttributeArgument yArg)
+        {
+            // check vs all 3 axis
+            var precision = new Vector2(
+                (float)xArg.Value,
+                (float)yArg.Value);
+            FloatPackFinder.ValidatePrecision(syncVar, settings.max.x, precision.x, (s, m) => new Vector2PackException(s, m));
+            FloatPackFinder.ValidatePrecision(syncVar, settings.max.y, precision.y, (s, m) => new Vector2PackException(s, m));
+            settings.precision = precision;
+        }
+        private static void BitCountFrom2(FieldDefinition syncVar, ref Vector2PackSettings settings, CustomAttributeArgument xArg, CustomAttributeArgument yArg)
+        {
+            // check vs all 3 axis
+            FloatPackFinder.ValidateBitCount(syncVar, (int)xArg.Value, (s, m) => new Vector2PackException(s, m));
+            FloatPackFinder.ValidateBitCount(syncVar, (int)yArg.Value, (s, m) => new Vector2PackException(s, m));
+            settings.bitCount = new Vector2Int(
+                (int)xArg.Value,
+                (int)yArg.Value);
+        }
+
+    }
+
+    internal static class Vector3Finder
+    {
+        public static Vector3PackSettings? GetPackerSettings(FieldDefinition syncVar)
+        {
+            CustomAttribute attribute = syncVar.GetCustomAttribute<Vector3PackAttribute>();
+            if (attribute == null)
+                return default;
+
+            if (!syncVar.FieldType.Is<Vector3>())
+            {
+                throw new Vector3PackException($"{syncVar.FieldType} is not a supported type for [Vector3Pack]", syncVar);
+            }
+
+            var settings = new Vector3PackSettings();
+            for (int i = 0; i < 3; i++)
+            {
+                settings.max[i] = (float)attribute.ConstructorArguments[i].Value;
+                if (settings.max[i] <= 0)
+                {
+                    throw new Vector3PackException($"Max must be above 0, max:{settings.max}", syncVar);
+                }
+            }
+
+            if (attribute.ConstructorArguments.Count == 4)
+            {
+                CustomAttributeArgument arg = attribute.ConstructorArguments[3];
+                if (arg.Type.Is<float>())
+                {
+                    Precisionfrom1(syncVar, ref settings, arg);
+                }
+                else
+                {
+                    BitCountfrom1(syncVar, ref settings, arg);
+                }
+            }
+            else
+            {
+                CustomAttributeArgument xArg = attribute.ConstructorArguments[3];
+                CustomAttributeArgument yArg = attribute.ConstructorArguments[4];
+                CustomAttributeArgument zArg = attribute.ConstructorArguments[5];
+                if (xArg.Type.Is<float>())
+                {
+                    PrecisionFrom3(syncVar, ref settings, xArg, yArg, zArg);
+                }
+                else
+                {
+                    BitCountFrom3(syncVar, ref settings, xArg, yArg, zArg);
+                }
+            }
+
+            return settings;
+        }
+
+        private static void Precisionfrom1(FieldDefinition syncVar, ref Vector3PackSettings settings, CustomAttributeArgument arg)
+        {
+            // check vs all 3 axis
+            float precision = (float)arg.Value;
+            FloatPackFinder.ValidatePrecision(syncVar, settings.max.x, precision, (s, m) => new Vector3PackException(s, m));
+            FloatPackFinder.ValidatePrecision(syncVar, settings.max.y, precision, (s, m) => new Vector3PackException(s, m));
+            FloatPackFinder.ValidatePrecision(syncVar, settings.max.z, precision, (s, m) => new Vector3PackException(s, m));
+            settings.precision = new Vector3(precision, precision, precision);
+        }
+        private static void BitCountfrom1(FieldDefinition syncVar, ref Vector3PackSettings settings, CustomAttributeArgument arg)
+        {
+            // check vs all 3 axis
+            var bitCount = (int)arg.Value;
+            FloatPackFinder.ValidateBitCount(syncVar, bitCount, (s, m) => new Vector3PackException(s, m));
+            settings.bitCount = new Vector3Int(bitCount, bitCount, bitCount);
+        }
+        private static void PrecisionFrom3(FieldDefinition syncVar, ref Vector3PackSettings settings, CustomAttributeArgument xArg, CustomAttributeArgument yArg, CustomAttributeArgument zArg)
+        {
+            // check vs all 3 axis
+            var precision = new Vector3(
+                (float)xArg.Value,
+                (float)yArg.Value,
+                (float)zArg.Value);
+            FloatPackFinder.ValidatePrecision(syncVar, settings.max.x, precision.x, (s, m) => new Vector3PackException(s, m));
+            FloatPackFinder.ValidatePrecision(syncVar, settings.max.y, precision.y, (s, m) => new Vector3PackException(s, m));
+            FloatPackFinder.ValidatePrecision(syncVar, settings.max.z, precision.z, (s, m) => new Vector3PackException(s, m));
+            settings.precision = precision;
+        }
+        private static void BitCountFrom3(FieldDefinition syncVar, ref Vector3PackSettings settings, CustomAttributeArgument xArg, CustomAttributeArgument yArg, CustomAttributeArgument zArg)
+        {
+            // check vs all 3 axis
+            FloatPackFinder.ValidateBitCount(syncVar, (int)xArg.Value, (s, m) => new Vector3PackException(s, m));
+            FloatPackFinder.ValidateBitCount(syncVar, (int)yArg.Value, (s, m) => new Vector3PackException(s, m));
+            FloatPackFinder.ValidateBitCount(syncVar, (int)zArg.Value, (s, m) => new Vector3PackException(s, m));
+            settings.bitCount = new Vector3Int(
+                (int)xArg.Value,
+                (int)yArg.Value,
+                (int)zArg.Value);
+        }
+    }
+
+    internal static class QuaternionFinder
+    {
+        public static int? GetBitCount(FieldDefinition syncVar)
+        {
+            CustomAttribute attribute = syncVar.GetCustomAttribute<QuaternionPackAttribute>();
+            if (attribute == null)
+                return default;
+
+            if (!syncVar.FieldType.Is<Quaternion>())
+            {
+                throw new QuaternionPackException($"{syncVar.FieldType} is not a supported type for [QuaternionPack]", syncVar);
+            }
+
+            int bitCount = (int)attribute.ConstructorArguments[0].Value;
+
+            if (bitCount <= 0)
+                throw new QuaternionPackException("BitCount should be above 0", syncVar);
+
+            // no reason for 20, but seems higher than anyone should need
+            if (bitCount > 20)
+                throw new QuaternionPackException("BitCount should be below 20", syncVar);
+
+            return bitCount;
+        }
     }
 }
diff --git a/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs b/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs
index f09d2f77162..69089fd362c 100644
--- a/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs
+++ b/Assets/Mirage/Weaver/Processors/SyncVars/FoundSyncVar.cs
@@ -12,6 +12,19 @@ internal struct FloatPackSettings
         public float? precision;
         public int? bitCount;
     }
+    internal struct Vector2PackSettings
+    {
+        public Vector2 max;
+        public Vector2? precision;
+        public Vector2Int? bitCount;
+    }
+    internal struct Vector3PackSettings
+    {
+        public Vector3 max;
+        public Vector3? precision;
+        public Vector3Int? bitCount;
+    }
+
     internal class FoundSyncVar
     {
         public readonly FieldDefinition FieldDefinition;
@@ -39,8 +52,14 @@ public FoundSyncVar(FieldDefinition fieldDefinition, int dirtyIndex)
         public int? BitCountMinValue { get; private set; }
 
         public FloatPackSettings? FloatPackSettings { get; private set; }
+        public Vector2PackSettings? Vector2PackSettings { get; private set; }
+        public Vector3PackSettings? Vector3PackSettings { get; private set; }
+        public int? QuaternionBitCount { get; private set; }
+
         public FieldDefinition PackerField { get; internal set; }
 
+
+
         public MethodReference WriteFunction { get; private set; }
         public MethodReference ReadFunction { get; private set; }
 
@@ -104,6 +123,9 @@ public void ProcessAttributes()
                 (BitCount, BitCountConvert, BitCountMinValue) = BitCountFromRangeFinder.GetBitFoundFromRange(FieldDefinition, BitCount.HasValue);
 
             FloatPackSettings = FloatPackFinder.GetPackerSettings(FieldDefinition);
+            Vector2PackSettings = Vector2Finder.GetPackerSettings(FieldDefinition);
+            Vector3PackSettings = Vector3Finder.GetPackerSettings(FieldDefinition);
+            QuaternionBitCount = QuaternionFinder.GetBitCount(FieldDefinition);
         }
 
         public void FindSerializeFunctions(Writers writers, Readers readers)
diff --git a/Assets/Mirage/Weaver/TypeExtensions.cs b/Assets/Mirage/Weaver/TypeExtensions.cs
index 729bacacc9b..56ba057f2b4 100644
--- a/Assets/Mirage/Weaver/TypeExtensions.cs
+++ b/Assets/Mirage/Weaver/TypeExtensions.cs
@@ -121,6 +121,17 @@ public static MethodDefinition AddMethod(this TypeDefinition typeDefinition, str
         public static MethodDefinition AddMethod(this TypeDefinition typeDefinition, string name, MethodAttributes attributes) =>
             AddMethod(typeDefinition, name, attributes, typeDefinition.Module.ImportReference(typeof(void)));
 
+        public static FieldDefinition AddField<T>(this TypeDefinition typeDefinition, string name, FieldAttributes attributes) =>
+            AddField(typeDefinition, typeDefinition.Module.ImportReference(typeof(T)), name, attributes);
+
+        public static FieldDefinition AddField(this TypeDefinition typeDefinition, TypeReference fieldType, string name, FieldAttributes attributes)
+        {
+            var field = new FieldDefinition(name, attributes, fieldType);
+            field.DeclaringType = typeDefinition;
+            typeDefinition.Fields.Add(field);
+            return field;
+        }
+
         /// <summary>
         /// Creates a generic type out of another type, if needed.
         /// </summary>
diff --git a/Assets/Mirage/Weaver/WeaverExceptions.cs b/Assets/Mirage/Weaver/WeaverExceptions.cs
index abfb9ed46d9..4f3c2bebbc2 100644
--- a/Assets/Mirage/Weaver/WeaverExceptions.cs
+++ b/Assets/Mirage/Weaver/WeaverExceptions.cs
@@ -36,7 +36,8 @@ internal class SerializeFunctionException : WeaverException
 
     internal class NetworkBehaviourException : WeaverException
     {
-        public NetworkBehaviourException(string message, TypeDefinition type) : base(message, type, null) { }
+        public NetworkBehaviourException(string message, TypeDefinition type, SequencePoint sequencePoint = null) : base(message, type, sequencePoint) { }
+        public NetworkBehaviourException(string message, MemberReference memberReference, SequencePoint sequencePoint = null) : base(message, memberReference, sequencePoint) { }
     }
 
     internal class SyncVarException : WeaverException
@@ -68,4 +69,16 @@ internal class FloatPackException : SyncVarException
     {
         public FloatPackException(string message, MemberReference memberReference) : base(message, memberReference) { }
     }
+    internal class Vector3PackException : SyncVarException
+    {
+        public Vector3PackException(string message, MemberReference memberReference) : base(message, memberReference) { }
+    }
+    internal class Vector2PackException : SyncVarException
+    {
+        public Vector2PackException(string message, MemberReference memberReference) : base(message, memberReference) { }
+    }
+    internal class QuaternionPackException : SyncVarException
+    {
+        public QuaternionPackException(string message, MemberReference memberReference) : base(message, memberReference) { }
+    }
 }
diff --git a/Assets/Tests/Generated/QuaternionPackTests.meta b/Assets/Tests/Generated/QuaternionPackTests.meta
new file mode 100644
index 00000000000..c6fdc1af174
--- /dev/null
+++ b/Assets/Tests/Generated/QuaternionPackTests.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: d7bca41a46502324099c2f7c0bc703f2
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_10_0.cs b/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_10_0.cs
new file mode 100644
index 00000000000..df5c1316430
--- /dev/null
+++ b/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_10_0.cs
@@ -0,0 +1,50 @@
+// DO NOT EDIT: GENERATED BY QuaternionPackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.QuaternionPackAttributeTests
+{
+    public class QuaternionPackBehaviour_10_0 : NetworkBehaviour
+    {
+        [QuaternionPack(10)]
+        [SyncVar] public Quaternion myValue;
+    }
+    public class QuaternionPackTest_10_0 : ClientServerSetup<QuaternionPackBehaviour_10_0>
+    {
+        static readonly Quaternion value = new Quaternion(0f, 0.7071068f, 0f, 0.7071068f);
+        const float within = 0.00135f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(32));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(32));
+
+                    Vector3 inVec = value * Vector3.forward;
+                    Vector3 outVec = clientComponent.myValue * Vector3.forward;
+
+                    // allow for extra within when rotating vector
+                    Assert.AreEqual(inVec.x, outVec.x, within * 2, $"vx off by {Mathf.Abs(inVec.x - outVec.x)}");
+                    Assert.AreEqual(inVec.y, outVec.y, within * 2, $"vy off by {Mathf.Abs(inVec.y - outVec.y)}");
+                    Assert.AreEqual(inVec.z, outVec.z, within * 2, $"vz off by {Mathf.Abs(inVec.z - outVec.z)}");
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_10_0.cs.meta b/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_10_0.cs.meta
new file mode 100644
index 00000000000..c5dc8fb5daf
--- /dev/null
+++ b/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_10_0.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 4ab9fd8937a174e4bb517b25a6feaea1
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_10_45.cs b/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_10_45.cs
new file mode 100644
index 00000000000..64bbde5b59a
--- /dev/null
+++ b/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_10_45.cs
@@ -0,0 +1,50 @@
+// DO NOT EDIT: GENERATED BY QuaternionPackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.QuaternionPackAttributeTests
+{
+    public class QuaternionPackBehaviour_10_45 : NetworkBehaviour
+    {
+        [QuaternionPack(10)]
+        [SyncVar] public Quaternion myValue;
+    }
+    public class QuaternionPackTest_10_45 : ClientServerSetup<QuaternionPackBehaviour_10_45>
+    {
+        static readonly Quaternion value = new Quaternion(0.2705981f, 0.6532815f, -0.2705981f, 0.6532815f);
+        const float within = 0.00135f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(32));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(32));
+
+                    Vector3 inVec = value * Vector3.forward;
+                    Vector3 outVec = clientComponent.myValue * Vector3.forward;
+
+                    // allow for extra within when rotating vector
+                    Assert.AreEqual(inVec.x, outVec.x, within * 2, $"vx off by {Mathf.Abs(inVec.x - outVec.x)}");
+                    Assert.AreEqual(inVec.y, outVec.y, within * 2, $"vy off by {Mathf.Abs(inVec.y - outVec.y)}");
+                    Assert.AreEqual(inVec.z, outVec.z, within * 2, $"vz off by {Mathf.Abs(inVec.z - outVec.z)}");
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_10_45.cs.meta b/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_10_45.cs.meta
new file mode 100644
index 00000000000..33c2db1a7f6
--- /dev/null
+++ b/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_10_45.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 2aae041c7c6f09e41943dcad2727b69a
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_8_0.cs b/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_8_0.cs
new file mode 100644
index 00000000000..fa778d2499b
--- /dev/null
+++ b/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_8_0.cs
@@ -0,0 +1,50 @@
+// DO NOT EDIT: GENERATED BY QuaternionPackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.QuaternionPackAttributeTests
+{
+    public class QuaternionPackBehaviour_8_0 : NetworkBehaviour
+    {
+        [QuaternionPack(8)]
+        [SyncVar] public Quaternion myValue;
+    }
+    public class QuaternionPackTest_8_0 : ClientServerSetup<QuaternionPackBehaviour_8_0>
+    {
+        static readonly Quaternion value = new Quaternion(0f, 0.7071068f, 0f, 0.7071068f);
+        const float within = 0.0054f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(26));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(26));
+
+                    Vector3 inVec = value * Vector3.forward;
+                    Vector3 outVec = clientComponent.myValue * Vector3.forward;
+
+                    // allow for extra within when rotating vector
+                    Assert.AreEqual(inVec.x, outVec.x, within * 2, $"vx off by {Mathf.Abs(inVec.x - outVec.x)}");
+                    Assert.AreEqual(inVec.y, outVec.y, within * 2, $"vy off by {Mathf.Abs(inVec.y - outVec.y)}");
+                    Assert.AreEqual(inVec.z, outVec.z, within * 2, $"vz off by {Mathf.Abs(inVec.z - outVec.z)}");
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_8_0.cs.meta b/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_8_0.cs.meta
new file mode 100644
index 00000000000..dea1117b642
--- /dev/null
+++ b/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_8_0.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 9ee00da2473d29a4699af571979e004a
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_8_45.cs b/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_8_45.cs
new file mode 100644
index 00000000000..3fb00441157
--- /dev/null
+++ b/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_8_45.cs
@@ -0,0 +1,50 @@
+// DO NOT EDIT: GENERATED BY QuaternionPackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.QuaternionPackAttributeTests
+{
+    public class QuaternionPackBehaviour_8_45 : NetworkBehaviour
+    {
+        [QuaternionPack(8)]
+        [SyncVar] public Quaternion myValue;
+    }
+    public class QuaternionPackTest_8_45 : ClientServerSetup<QuaternionPackBehaviour_8_45>
+    {
+        static readonly Quaternion value = new Quaternion(0.2705981f, 0.6532815f, -0.2705981f, 0.6532815f);
+        const float within = 0.0054f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(26));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(26));
+
+                    Vector3 inVec = value * Vector3.forward;
+                    Vector3 outVec = clientComponent.myValue * Vector3.forward;
+
+                    // allow for extra within when rotating vector
+                    Assert.AreEqual(inVec.x, outVec.x, within * 2, $"vx off by {Mathf.Abs(inVec.x - outVec.x)}");
+                    Assert.AreEqual(inVec.y, outVec.y, within * 2, $"vy off by {Mathf.Abs(inVec.y - outVec.y)}");
+                    Assert.AreEqual(inVec.z, outVec.z, within * 2, $"vz off by {Mathf.Abs(inVec.z - outVec.z)}");
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_8_45.cs.meta b/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_8_45.cs.meta
new file mode 100644
index 00000000000..9e86c248805
--- /dev/null
+++ b/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_8_45.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: ff61adfaa015039468c52bd397fbb3b6
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_9_0.cs b/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_9_0.cs
new file mode 100644
index 00000000000..64df146f37c
--- /dev/null
+++ b/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_9_0.cs
@@ -0,0 +1,50 @@
+// DO NOT EDIT: GENERATED BY QuaternionPackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.QuaternionPackAttributeTests
+{
+    public class QuaternionPackBehaviour_9_0 : NetworkBehaviour
+    {
+        [QuaternionPack(9)]
+        [SyncVar] public Quaternion myValue;
+    }
+    public class QuaternionPackTest_9_0 : ClientServerSetup<QuaternionPackBehaviour_9_0>
+    {
+        static readonly Quaternion value = new Quaternion(0f, 0.7071068f, 0f, 0.7071068f);
+        const float within = 0.0027f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(29));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(29));
+
+                    Vector3 inVec = value * Vector3.forward;
+                    Vector3 outVec = clientComponent.myValue * Vector3.forward;
+
+                    // allow for extra within when rotating vector
+                    Assert.AreEqual(inVec.x, outVec.x, within * 2, $"vx off by {Mathf.Abs(inVec.x - outVec.x)}");
+                    Assert.AreEqual(inVec.y, outVec.y, within * 2, $"vy off by {Mathf.Abs(inVec.y - outVec.y)}");
+                    Assert.AreEqual(inVec.z, outVec.z, within * 2, $"vz off by {Mathf.Abs(inVec.z - outVec.z)}");
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_9_0.cs.meta b/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_9_0.cs.meta
new file mode 100644
index 00000000000..796d984c61f
--- /dev/null
+++ b/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_9_0.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: e96f6231777d2634783d2c5b3f01d2ae
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_9_45.cs b/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_9_45.cs
new file mode 100644
index 00000000000..4ba25dd5600
--- /dev/null
+++ b/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_9_45.cs
@@ -0,0 +1,50 @@
+// DO NOT EDIT: GENERATED BY QuaternionPackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.QuaternionPackAttributeTests
+{
+    public class QuaternionPackBehaviour_9_45 : NetworkBehaviour
+    {
+        [QuaternionPack(9)]
+        [SyncVar] public Quaternion myValue;
+    }
+    public class QuaternionPackTest_9_45 : ClientServerSetup<QuaternionPackBehaviour_9_45>
+    {
+        static readonly Quaternion value = new Quaternion(0.2705981f, 0.6532815f, -0.2705981f, 0.6532815f);
+        const float within = 0.0027f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(29));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(29));
+
+                    Vector3 inVec = value * Vector3.forward;
+                    Vector3 outVec = clientComponent.myValue * Vector3.forward;
+
+                    // allow for extra within when rotating vector
+                    Assert.AreEqual(inVec.x, outVec.x, within * 2, $"vx off by {Mathf.Abs(inVec.x - outVec.x)}");
+                    Assert.AreEqual(inVec.y, outVec.y, within * 2, $"vy off by {Mathf.Abs(inVec.y - outVec.y)}");
+                    Assert.AreEqual(inVec.z, outVec.z, within * 2, $"vz off by {Mathf.Abs(inVec.z - outVec.z)}");
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_9_45.cs.meta b/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_9_45.cs.meta
new file mode 100644
index 00000000000..be847736caa
--- /dev/null
+++ b/Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_9_45.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: eb3e6e061e904fc45abc3bfc793042db
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/Vector2PackTests.meta b/Assets/Tests/Generated/Vector2PackTests.meta
new file mode 100644
index 00000000000..d0b299f5bdf
--- /dev/null
+++ b/Assets/Tests/Generated/Vector2PackTests.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 799eefc3ace83a8419c274dc0e7e875e
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_42b3.cs b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_42b3.cs
new file mode 100644
index 00000000000..86079b9374a
--- /dev/null
+++ b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_42b3.cs
@@ -0,0 +1,45 @@
+// DO NOT EDIT: GENERATED BY Vector2PackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.Vector2PackAttributeTests
+{
+    public class Vector2PackBehaviour_1000_42b3 : NetworkBehaviour
+    {
+        [Vector2Pack(1000f, 200f, 15, 12)]
+        [SyncVar] public Vector2 myValue;
+    }
+    public class Vector2PackTest_1000_42b3 : ClientServerSetup<Vector2PackBehaviour_1000_42b3>
+    {
+        static readonly Vector2 value = new Vector2(10.3f, 0.2f);
+        const float within = 0.2f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(27));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(27));
+
+                    Assert.That(clientComponent.myValue.x, Is.EqualTo(value.x).Within(within));
+                    Assert.That(clientComponent.myValue.y, Is.EqualTo(value.y).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_42b3.cs.meta b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_42b3.cs.meta
new file mode 100644
index 00000000000..2eed0c19f27
--- /dev/null
+++ b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_42b3.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 25f9aeee1a91f9e4eb1979a2e7116d38
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_42f.cs b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_42f.cs
new file mode 100644
index 00000000000..dcebf3d9e22
--- /dev/null
+++ b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_42f.cs
@@ -0,0 +1,45 @@
+// DO NOT EDIT: GENERATED BY Vector2PackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.Vector2PackAttributeTests
+{
+    public class Vector2PackBehaviour_1000_42f : NetworkBehaviour
+    {
+        [Vector2Pack(1000f, 200f, 0.1f)]
+        [SyncVar] public Vector2 myValue;
+    }
+    public class Vector2PackTest_1000_42f : ClientServerSetup<Vector2PackBehaviour_1000_42f>
+    {
+        static readonly Vector2 value = new Vector2(-10.3f, 0.2f);
+        const float within = 0.1f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(27));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(27));
+
+                    Assert.That(clientComponent.myValue.x, Is.EqualTo(value.x).Within(within));
+                    Assert.That(clientComponent.myValue.y, Is.EqualTo(value.y).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_42f.cs.meta b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_42f.cs.meta
new file mode 100644
index 00000000000..ed07125943f
--- /dev/null
+++ b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_42f.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: f971655ad9eedd8488898f1d8748e810
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_42f3.cs b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_42f3.cs
new file mode 100644
index 00000000000..045fc9c5133
--- /dev/null
+++ b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_42f3.cs
@@ -0,0 +1,45 @@
+// DO NOT EDIT: GENERATED BY Vector2PackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.Vector2PackAttributeTests
+{
+    public class Vector2PackBehaviour_1000_42f3 : NetworkBehaviour
+    {
+        [Vector2Pack(1000f, 200f, 0.1f, 0.1f)]
+        [SyncVar] public Vector2 myValue;
+    }
+    public class Vector2PackTest_1000_42f3 : ClientServerSetup<Vector2PackBehaviour_1000_42f3>
+    {
+        static readonly Vector2 value = new Vector2(-10.3f, 0.2f);
+        const float within = 0.1f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(27));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(27));
+
+                    Assert.That(clientComponent.myValue.x, Is.EqualTo(value.x).Within(within));
+                    Assert.That(clientComponent.myValue.y, Is.EqualTo(value.y).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_42f3.cs.meta b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_42f3.cs.meta
new file mode 100644
index 00000000000..e20b255090f
--- /dev/null
+++ b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_42f3.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 0f745c72deb25f544a6f0e19afe226a7
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_45f.cs b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_45f.cs
new file mode 100644
index 00000000000..c430df1a30a
--- /dev/null
+++ b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_45f.cs
@@ -0,0 +1,45 @@
+// DO NOT EDIT: GENERATED BY Vector2PackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.Vector2PackAttributeTests
+{
+    public class Vector2PackBehaviour_1000_45f : NetworkBehaviour
+    {
+        [Vector2Pack(1000f, 200f, 15)]
+        [SyncVar] public Vector2 myValue;
+    }
+    public class Vector2PackTest_1000_45f : ClientServerSetup<Vector2PackBehaviour_1000_45f>
+    {
+        static readonly Vector2 value = new Vector2(10.3f, 0.2f);
+        const float within = 0.2f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(30));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(30));
+
+                    Assert.That(clientComponent.myValue.x, Is.EqualTo(value.x).Within(within));
+                    Assert.That(clientComponent.myValue.y, Is.EqualTo(value.y).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_45f.cs.meta b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_45f.cs.meta
new file mode 100644
index 00000000000..7643e377541
--- /dev/null
+++ b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_1000_45f.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 360aac510dd0ef946a5c80d0e5b278d7
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_28b3.cs b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_28b3.cs
new file mode 100644
index 00000000000..4546d45e91f
--- /dev/null
+++ b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_28b3.cs
@@ -0,0 +1,45 @@
+// DO NOT EDIT: GENERATED BY Vector2PackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.Vector2PackAttributeTests
+{
+    public class Vector2PackBehaviour_100_28b3 : NetworkBehaviour
+    {
+        [Vector2Pack(100f, 20f, 10, 8)]
+        [SyncVar] public Vector2 myValue;
+    }
+    public class Vector2PackTest_100_28b3 : ClientServerSetup<Vector2PackBehaviour_100_28b3>
+    {
+        static readonly Vector2 value = new Vector2(-10.3f, 0.2f);
+        const float within = 0.2f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(18));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(18));
+
+                    Assert.That(clientComponent.myValue.x, Is.EqualTo(value.x).Within(within));
+                    Assert.That(clientComponent.myValue.y, Is.EqualTo(value.y).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_28b3.cs.meta b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_28b3.cs.meta
new file mode 100644
index 00000000000..9afe7ae1f7d
--- /dev/null
+++ b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_28b3.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: cf2dc9d21ae411e41a1186cb0421241d
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_28f.cs b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_28f.cs
new file mode 100644
index 00000000000..a732014e115
--- /dev/null
+++ b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_28f.cs
@@ -0,0 +1,45 @@
+// DO NOT EDIT: GENERATED BY Vector2PackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.Vector2PackAttributeTests
+{
+    public class Vector2PackBehaviour_100_28f : NetworkBehaviour
+    {
+        [Vector2Pack(100f, 20f, 0.2f)]
+        [SyncVar] public Vector2 myValue;
+    }
+    public class Vector2PackTest_100_28f : ClientServerSetup<Vector2PackBehaviour_100_28f>
+    {
+        static readonly Vector2 value = new Vector2(10.3f, 0.2f);
+        const float within = 0.2f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(18));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(18));
+
+                    Assert.That(clientComponent.myValue.x, Is.EqualTo(value.x).Within(within));
+                    Assert.That(clientComponent.myValue.y, Is.EqualTo(value.y).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_28f.cs.meta b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_28f.cs.meta
new file mode 100644
index 00000000000..178bad568cc
--- /dev/null
+++ b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_28f.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: f273b7db27b47834c98d905b91fcf338
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_28f3.cs b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_28f3.cs
new file mode 100644
index 00000000000..e48f73cba87
--- /dev/null
+++ b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_28f3.cs
@@ -0,0 +1,45 @@
+// DO NOT EDIT: GENERATED BY Vector2PackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.Vector2PackAttributeTests
+{
+    public class Vector2PackBehaviour_100_28f3 : NetworkBehaviour
+    {
+        [Vector2Pack(100f, 20f, 0.2f, 0.2f)]
+        [SyncVar] public Vector2 myValue;
+    }
+    public class Vector2PackTest_100_28f3 : ClientServerSetup<Vector2PackBehaviour_100_28f3>
+    {
+        static readonly Vector2 value = new Vector2(10.3f, 0.2f);
+        const float within = 0.2f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(18));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(18));
+
+                    Assert.That(clientComponent.myValue.x, Is.EqualTo(value.x).Within(within));
+                    Assert.That(clientComponent.myValue.y, Is.EqualTo(value.y).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_28f3.cs.meta b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_28f3.cs.meta
new file mode 100644
index 00000000000..a818a105349
--- /dev/null
+++ b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_28f3.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: b0278e1b693fa114c85e8186dbfafa80
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_30f.cs b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_30f.cs
new file mode 100644
index 00000000000..c0c9739464d
--- /dev/null
+++ b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_30f.cs
@@ -0,0 +1,45 @@
+// DO NOT EDIT: GENERATED BY Vector2PackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.Vector2PackAttributeTests
+{
+    public class Vector2PackBehaviour_100_30f : NetworkBehaviour
+    {
+        [Vector2Pack(100f, 100f, 10)]
+        [SyncVar] public Vector2 myValue;
+    }
+    public class Vector2PackTest_100_30f : ClientServerSetup<Vector2PackBehaviour_100_30f>
+    {
+        static readonly Vector2 value = new Vector2(-10.3f, 0.2f);
+        const float within = 0.2f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(20));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(20));
+
+                    Assert.That(clientComponent.myValue.x, Is.EqualTo(value.x).Within(within));
+                    Assert.That(clientComponent.myValue.y, Is.EqualTo(value.y).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_30f.cs.meta b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_30f.cs.meta
new file mode 100644
index 00000000000..90e8724f3ca
--- /dev/null
+++ b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_100_30f.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 9c33d1136da75674e80c5e00fc855fba
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_200_39b3.cs b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_200_39b3.cs
new file mode 100644
index 00000000000..40411574094
--- /dev/null
+++ b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_200_39b3.cs
@@ -0,0 +1,45 @@
+// DO NOT EDIT: GENERATED BY Vector2PackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.Vector2PackAttributeTests
+{
+    public class Vector2PackBehaviour_200_39b3 : NetworkBehaviour
+    {
+        [Vector2Pack(200f, 200f, 13, 13)]
+        [SyncVar] public Vector2 myValue;
+    }
+    public class Vector2PackTest_200_39b3 : ClientServerSetup<Vector2PackBehaviour_200_39b3>
+    {
+        static readonly Vector2 value = new Vector2(10.3f, 0.2f);
+        const float within = 0.2f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(26));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(26));
+
+                    Assert.That(clientComponent.myValue.x, Is.EqualTo(value.x).Within(within));
+                    Assert.That(clientComponent.myValue.y, Is.EqualTo(value.y).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_200_39b3.cs.meta b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_200_39b3.cs.meta
new file mode 100644
index 00000000000..d0bc23e4ccc
--- /dev/null
+++ b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_200_39b3.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 335c52ef3cd088549badd8afe9034960
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_200_39f.cs b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_200_39f.cs
new file mode 100644
index 00000000000..5b200033fbe
--- /dev/null
+++ b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_200_39f.cs
@@ -0,0 +1,45 @@
+// DO NOT EDIT: GENERATED BY Vector2PackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.Vector2PackAttributeTests
+{
+    public class Vector2PackBehaviour_200_39f : NetworkBehaviour
+    {
+        [Vector2Pack(200f, 200f, 13)]
+        [SyncVar] public Vector2 myValue;
+    }
+    public class Vector2PackTest_200_39f : ClientServerSetup<Vector2PackBehaviour_200_39f>
+    {
+        static readonly Vector2 value = new Vector2(10.3f, 0.2f);
+        const float within = 0.2f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(26));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(26));
+
+                    Assert.That(clientComponent.myValue.x, Is.EqualTo(value.x).Within(within));
+                    Assert.That(clientComponent.myValue.y, Is.EqualTo(value.y).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_200_39f.cs.meta b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_200_39f.cs.meta
new file mode 100644
index 00000000000..0075dfc9e98
--- /dev/null
+++ b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_200_39f.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 6fe0b2162a3f56444be6dc02105e1096
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_200_39f3.cs b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_200_39f3.cs
new file mode 100644
index 00000000000..ce53a68a8de
--- /dev/null
+++ b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_200_39f3.cs
@@ -0,0 +1,45 @@
+// DO NOT EDIT: GENERATED BY Vector2PackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.Vector2PackAttributeTests
+{
+    public class Vector2PackBehaviour_200_39f3 : NetworkBehaviour
+    {
+        [Vector2Pack(200f, 200f, 0.05f, 0.05f)]
+        [SyncVar] public Vector2 myValue;
+    }
+    public class Vector2PackTest_200_39f3 : ClientServerSetup<Vector2PackBehaviour_200_39f3>
+    {
+        static readonly Vector2 value = new Vector2(-10.3f, 0.2f);
+        const float within = 0.1f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(26));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(26));
+
+                    Assert.That(clientComponent.myValue.x, Is.EqualTo(value.x).Within(within));
+                    Assert.That(clientComponent.myValue.y, Is.EqualTo(value.y).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_200_39f3.cs.meta b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_200_39f3.cs.meta
new file mode 100644
index 00000000000..099e5ebe2de
--- /dev/null
+++ b/Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_200_39f3.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 8fda5902998bd514e80caee89a1711f6
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/Vector3PackTests.meta b/Assets/Tests/Generated/Vector3PackTests.meta
new file mode 100644
index 00000000000..d5120f0a329
--- /dev/null
+++ b/Assets/Tests/Generated/Vector3PackTests.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: a569ce7d0369c2e428e992a41ec3b569
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_42b3.cs b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_42b3.cs
new file mode 100644
index 00000000000..3f2235debe7
--- /dev/null
+++ b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_42b3.cs
@@ -0,0 +1,46 @@
+// DO NOT EDIT: GENERATED BY Vector3PackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.Vector3PackAttributeTests
+{
+    public class Vector3PackBehaviour_1000_42b3 : NetworkBehaviour
+    {
+        [Vector3Pack(1000f, 200f, 1000f, 15, 12, 15)]
+        [SyncVar] public Vector3 myValue;
+    }
+    public class Vector3PackTest_1000_42b3 : ClientServerSetup<Vector3PackBehaviour_1000_42b3>
+    {
+        static readonly Vector3 value = new Vector3(10.3f, 0.2f, 20f);
+        const float within = 0.2f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(42));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(42));
+
+                    Assert.That(clientComponent.myValue.x, Is.EqualTo(value.x).Within(within));
+                    Assert.That(clientComponent.myValue.y, Is.EqualTo(value.y).Within(within));
+                    Assert.That(clientComponent.myValue.z, Is.EqualTo(value.z).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_42b3.cs.meta b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_42b3.cs.meta
new file mode 100644
index 00000000000..516650fa069
--- /dev/null
+++ b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_42b3.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 4499369b48aebcd4d9e9f49521ab1c89
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_42f.cs b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_42f.cs
new file mode 100644
index 00000000000..480694baa15
--- /dev/null
+++ b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_42f.cs
@@ -0,0 +1,46 @@
+// DO NOT EDIT: GENERATED BY Vector3PackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.Vector3PackAttributeTests
+{
+    public class Vector3PackBehaviour_1000_42f : NetworkBehaviour
+    {
+        [Vector3Pack(1000f, 200f, 1000f, 0.1f)]
+        [SyncVar] public Vector3 myValue;
+    }
+    public class Vector3PackTest_1000_42f : ClientServerSetup<Vector3PackBehaviour_1000_42f>
+    {
+        static readonly Vector3 value = new Vector3(-10.3f, 0.2f, 20f);
+        const float within = 0.1f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(42));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(42));
+
+                    Assert.That(clientComponent.myValue.x, Is.EqualTo(value.x).Within(within));
+                    Assert.That(clientComponent.myValue.y, Is.EqualTo(value.y).Within(within));
+                    Assert.That(clientComponent.myValue.z, Is.EqualTo(value.z).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_42f.cs.meta b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_42f.cs.meta
new file mode 100644
index 00000000000..a346db8c561
--- /dev/null
+++ b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_42f.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 61a4dff1c7f48fa4abca392cea2cf26c
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_42f3.cs b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_42f3.cs
new file mode 100644
index 00000000000..1a13e6d9a95
--- /dev/null
+++ b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_42f3.cs
@@ -0,0 +1,46 @@
+// DO NOT EDIT: GENERATED BY Vector3PackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.Vector3PackAttributeTests
+{
+    public class Vector3PackBehaviour_1000_42f3 : NetworkBehaviour
+    {
+        [Vector3Pack(1000f, 200f, 1000f, 0.1f, 0.1f, 0.1f)]
+        [SyncVar] public Vector3 myValue;
+    }
+    public class Vector3PackTest_1000_42f3 : ClientServerSetup<Vector3PackBehaviour_1000_42f3>
+    {
+        static readonly Vector3 value = new Vector3(-10.3f, 0.2f, 20f);
+        const float within = 0.1f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(42));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(42));
+
+                    Assert.That(clientComponent.myValue.x, Is.EqualTo(value.x).Within(within));
+                    Assert.That(clientComponent.myValue.y, Is.EqualTo(value.y).Within(within));
+                    Assert.That(clientComponent.myValue.z, Is.EqualTo(value.z).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_42f3.cs.meta b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_42f3.cs.meta
new file mode 100644
index 00000000000..718c8ba4270
--- /dev/null
+++ b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_42f3.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: e1eaae3b2239bb04288ae1054b457c3e
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_45f.cs b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_45f.cs
new file mode 100644
index 00000000000..bbd26d13da3
--- /dev/null
+++ b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_45f.cs
@@ -0,0 +1,46 @@
+// DO NOT EDIT: GENERATED BY Vector3PackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.Vector3PackAttributeTests
+{
+    public class Vector3PackBehaviour_1000_45f : NetworkBehaviour
+    {
+        [Vector3Pack(1000f, 200f, 1000f, 15)]
+        [SyncVar] public Vector3 myValue;
+    }
+    public class Vector3PackTest_1000_45f : ClientServerSetup<Vector3PackBehaviour_1000_45f>
+    {
+        static readonly Vector3 value = new Vector3(10.3f, 0.2f, 20f);
+        const float within = 0.2f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(45));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(45));
+
+                    Assert.That(clientComponent.myValue.x, Is.EqualTo(value.x).Within(within));
+                    Assert.That(clientComponent.myValue.y, Is.EqualTo(value.y).Within(within));
+                    Assert.That(clientComponent.myValue.z, Is.EqualTo(value.z).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_45f.cs.meta b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_45f.cs.meta
new file mode 100644
index 00000000000..bb132843093
--- /dev/null
+++ b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_1000_45f.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 62f606820e70b4f4e8426fcaf52459a4
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_28b3.cs b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_28b3.cs
new file mode 100644
index 00000000000..c9b4b41f8da
--- /dev/null
+++ b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_28b3.cs
@@ -0,0 +1,46 @@
+// DO NOT EDIT: GENERATED BY Vector3PackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.Vector3PackAttributeTests
+{
+    public class Vector3PackBehaviour_100_28b3 : NetworkBehaviour
+    {
+        [Vector3Pack(100f, 20f, 100f, 10, 8, 10)]
+        [SyncVar] public Vector3 myValue;
+    }
+    public class Vector3PackTest_100_28b3 : ClientServerSetup<Vector3PackBehaviour_100_28b3>
+    {
+        static readonly Vector3 value = new Vector3(-10.3f, 0.2f, 20f);
+        const float within = 0.2f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(28));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(28));
+
+                    Assert.That(clientComponent.myValue.x, Is.EqualTo(value.x).Within(within));
+                    Assert.That(clientComponent.myValue.y, Is.EqualTo(value.y).Within(within));
+                    Assert.That(clientComponent.myValue.z, Is.EqualTo(value.z).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_28b3.cs.meta b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_28b3.cs.meta
new file mode 100644
index 00000000000..ad8ffff1d92
--- /dev/null
+++ b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_28b3.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: df73554e4d468d44fb5d363a7871f5b5
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_28f.cs b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_28f.cs
new file mode 100644
index 00000000000..6e2680a6461
--- /dev/null
+++ b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_28f.cs
@@ -0,0 +1,46 @@
+// DO NOT EDIT: GENERATED BY Vector3PackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.Vector3PackAttributeTests
+{
+    public class Vector3PackBehaviour_100_28f : NetworkBehaviour
+    {
+        [Vector3Pack(100f, 20f, 100f, 0.2f)]
+        [SyncVar] public Vector3 myValue;
+    }
+    public class Vector3PackTest_100_28f : ClientServerSetup<Vector3PackBehaviour_100_28f>
+    {
+        static readonly Vector3 value = new Vector3(10.3f, 0.2f, 20f);
+        const float within = 0.2f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(28));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(28));
+
+                    Assert.That(clientComponent.myValue.x, Is.EqualTo(value.x).Within(within));
+                    Assert.That(clientComponent.myValue.y, Is.EqualTo(value.y).Within(within));
+                    Assert.That(clientComponent.myValue.z, Is.EqualTo(value.z).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_28f.cs.meta b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_28f.cs.meta
new file mode 100644
index 00000000000..e79c15a5926
--- /dev/null
+++ b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_28f.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 201a148d2fce2454fada358a9f3572c4
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_28f3.cs b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_28f3.cs
new file mode 100644
index 00000000000..63c7fa39148
--- /dev/null
+++ b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_28f3.cs
@@ -0,0 +1,46 @@
+// DO NOT EDIT: GENERATED BY Vector3PackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.Vector3PackAttributeTests
+{
+    public class Vector3PackBehaviour_100_28f3 : NetworkBehaviour
+    {
+        [Vector3Pack(100f, 20f, 100f, 0.2f, 0.2f, 0.2f)]
+        [SyncVar] public Vector3 myValue;
+    }
+    public class Vector3PackTest_100_28f3 : ClientServerSetup<Vector3PackBehaviour_100_28f3>
+    {
+        static readonly Vector3 value = new Vector3(10.3f, 0.2f, 20f);
+        const float within = 0.2f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(28));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(28));
+
+                    Assert.That(clientComponent.myValue.x, Is.EqualTo(value.x).Within(within));
+                    Assert.That(clientComponent.myValue.y, Is.EqualTo(value.y).Within(within));
+                    Assert.That(clientComponent.myValue.z, Is.EqualTo(value.z).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_28f3.cs.meta b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_28f3.cs.meta
new file mode 100644
index 00000000000..831a4f25261
--- /dev/null
+++ b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_28f3.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: adef600428bbf1544b685f42f50180a9
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_30f.cs b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_30f.cs
new file mode 100644
index 00000000000..03b3e785ae2
--- /dev/null
+++ b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_30f.cs
@@ -0,0 +1,46 @@
+// DO NOT EDIT: GENERATED BY Vector3PackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.Vector3PackAttributeTests
+{
+    public class Vector3PackBehaviour_100_30f : NetworkBehaviour
+    {
+        [Vector3Pack(100f, 100f, 100f, 10)]
+        [SyncVar] public Vector3 myValue;
+    }
+    public class Vector3PackTest_100_30f : ClientServerSetup<Vector3PackBehaviour_100_30f>
+    {
+        static readonly Vector3 value = new Vector3(-10.3f, 0.2f, 20f);
+        const float within = 0.2f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(30));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(30));
+
+                    Assert.That(clientComponent.myValue.x, Is.EqualTo(value.x).Within(within));
+                    Assert.That(clientComponent.myValue.y, Is.EqualTo(value.y).Within(within));
+                    Assert.That(clientComponent.myValue.z, Is.EqualTo(value.z).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_30f.cs.meta b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_30f.cs.meta
new file mode 100644
index 00000000000..55b1b558d8e
--- /dev/null
+++ b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_100_30f.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 9e7a916509c44c84197b54c590648493
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_200_39b3.cs b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_200_39b3.cs
new file mode 100644
index 00000000000..50cedccd166
--- /dev/null
+++ b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_200_39b3.cs
@@ -0,0 +1,46 @@
+// DO NOT EDIT: GENERATED BY Vector3PackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.Vector3PackAttributeTests
+{
+    public class Vector3PackBehaviour_200_39b3 : NetworkBehaviour
+    {
+        [Vector3Pack(200f, 200f, 200f, 13, 13, 13)]
+        [SyncVar] public Vector3 myValue;
+    }
+    public class Vector3PackTest_200_39b3 : ClientServerSetup<Vector3PackBehaviour_200_39b3>
+    {
+        static readonly Vector3 value = new Vector3(10.3f, 0.2f, 20f);
+        const float within = 0.2f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(39));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(39));
+
+                    Assert.That(clientComponent.myValue.x, Is.EqualTo(value.x).Within(within));
+                    Assert.That(clientComponent.myValue.y, Is.EqualTo(value.y).Within(within));
+                    Assert.That(clientComponent.myValue.z, Is.EqualTo(value.z).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_200_39b3.cs.meta b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_200_39b3.cs.meta
new file mode 100644
index 00000000000..3274ebbae55
--- /dev/null
+++ b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_200_39b3.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 1befa91894c23e34fa364fadf7d44ab9
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_200_39f.cs b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_200_39f.cs
new file mode 100644
index 00000000000..ed5749b48bb
--- /dev/null
+++ b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_200_39f.cs
@@ -0,0 +1,46 @@
+// DO NOT EDIT: GENERATED BY Vector3PackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.Vector3PackAttributeTests
+{
+    public class Vector3PackBehaviour_200_39f : NetworkBehaviour
+    {
+        [Vector3Pack(200f, 200f, 200f, 13)]
+        [SyncVar] public Vector3 myValue;
+    }
+    public class Vector3PackTest_200_39f : ClientServerSetup<Vector3PackBehaviour_200_39f>
+    {
+        static readonly Vector3 value = new Vector3(10.3f, 0.2f, 20f);
+        const float within = 0.2f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(39));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(39));
+
+                    Assert.That(clientComponent.myValue.x, Is.EqualTo(value.x).Within(within));
+                    Assert.That(clientComponent.myValue.y, Is.EqualTo(value.y).Within(within));
+                    Assert.That(clientComponent.myValue.z, Is.EqualTo(value.z).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_200_39f.cs.meta b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_200_39f.cs.meta
new file mode 100644
index 00000000000..63cc9e7c093
--- /dev/null
+++ b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_200_39f.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 96c1c96f45ce08c48afcb836421a3fb8
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_200_39f3.cs b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_200_39f3.cs
new file mode 100644
index 00000000000..4c88339b238
--- /dev/null
+++ b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_200_39f3.cs
@@ -0,0 +1,46 @@
+// DO NOT EDIT: GENERATED BY Vector3PackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.Vector3PackAttributeTests
+{
+    public class Vector3PackBehaviour_200_39f3 : NetworkBehaviour
+    {
+        [Vector3Pack(200f, 200f, 200f, 0.05f, 0.05f, 0.05f)]
+        [SyncVar] public Vector3 myValue;
+    }
+    public class Vector3PackTest_200_39f3 : ClientServerSetup<Vector3PackBehaviour_200_39f3>
+    {
+        static readonly Vector3 value = new Vector3(-10.3f, 0.2f, -20f);
+        const float within = 0.1f;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(39));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(39));
+
+                    Assert.That(clientComponent.myValue.x, Is.EqualTo(value.x).Within(within));
+                    Assert.That(clientComponent.myValue.y, Is.EqualTo(value.y).Within(within));
+                    Assert.That(clientComponent.myValue.z, Is.EqualTo(value.z).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_200_39f3.cs.meta b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_200_39f3.cs.meta
new file mode 100644
index 00000000000..a545c7db462
--- /dev/null
+++ b/Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_200_39f3.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: f449b59b1825478419f46284820806c3
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generators/.QuaternionPackTestTemplate.txt b/Assets/Tests/Generators/.QuaternionPackTestTemplate.txt
new file mode 100644
index 00000000000..5874508a315
--- /dev/null
+++ b/Assets/Tests/Generators/.QuaternionPackTestTemplate.txt
@@ -0,0 +1,50 @@
+// DO NOT EDIT: GENERATED BY QuaternionPackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.QuaternionPackAttributeTests
+{
+    public class QuaternionPackBehaviour_%%NAME%% : NetworkBehaviour
+    {
+        [QuaternionPack(%%PACKER_ATTRIBUTE%%)]
+        [SyncVar] public Quaternion myValue;
+    }
+    public class QuaternionPackTest_%%NAME%% : ClientServerSetup<QuaternionPackBehaviour_%%NAME%%>
+    {
+        static readonly Quaternion value = %%VALUE%%;
+        const float within = %%WITHIN%%;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(%%BIT_COUNT%%));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(%%BIT_COUNT%%));
+
+                    Vector3 inVec = value * Vector3.forward;
+                    Vector3 outVec = clientComponent.myValue * Vector3.forward;
+
+                    // allow for extra within when rotating vector
+                    Assert.AreEqual(inVec.x, outVec.x, within * 2, $"vx off by {Mathf.Abs(inVec.x - outVec.x)}");
+                    Assert.AreEqual(inVec.y, outVec.y, within * 2, $"vy off by {Mathf.Abs(inVec.y - outVec.y)}");
+                    Assert.AreEqual(inVec.z, outVec.z, within * 2, $"vz off by {Mathf.Abs(inVec.z - outVec.z)}");
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generators/.Vector2PackTestTemplate.txt b/Assets/Tests/Generators/.Vector2PackTestTemplate.txt
new file mode 100644
index 00000000000..cd028685a31
--- /dev/null
+++ b/Assets/Tests/Generators/.Vector2PackTestTemplate.txt
@@ -0,0 +1,45 @@
+// DO NOT EDIT: GENERATED BY Vector2PackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.Vector2PackAttributeTests
+{
+    public class Vector2PackBehaviour_%%NAME%% : NetworkBehaviour
+    {
+        [Vector2Pack(%%PACKER_ATTRIBUTE%%)]
+        [SyncVar] public Vector2 myValue;
+    }
+    public class Vector2PackTest_%%NAME%% : ClientServerSetup<Vector2PackBehaviour_%%NAME%%>
+    {
+        static readonly Vector2 value = %%VALUE%%;
+        const float within = %%WITHIN%%;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(%%BIT_COUNT%%));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(%%BIT_COUNT%%));
+
+                    Assert.That(clientComponent.myValue.x, Is.EqualTo(value.x).Within(within));
+                    Assert.That(clientComponent.myValue.y, Is.EqualTo(value.y).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generators/.Vector3PackTestTemplate.txt b/Assets/Tests/Generators/.Vector3PackTestTemplate.txt
new file mode 100644
index 00000000000..c29c23c6a36
--- /dev/null
+++ b/Assets/Tests/Generators/.Vector3PackTestTemplate.txt
@@ -0,0 +1,46 @@
+// DO NOT EDIT: GENERATED BY Vector3PackTestGenerator.cs
+
+using System;
+using System.Collections;
+using Mirage.Serialization;
+using Mirage.Tests.Runtime.ClientServer;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+
+namespace Mirage.Tests.Runtime.Generated.Vector3PackAttributeTests
+{
+    public class Vector3PackBehaviour_%%NAME%% : NetworkBehaviour
+    {
+        [Vector3Pack(%%PACKER_ATTRIBUTE%%)]
+        [SyncVar] public Vector3 myValue;
+    }
+    public class Vector3PackTest_%%NAME%% : ClientServerSetup<Vector3PackBehaviour_%%NAME%%>
+    {
+        static readonly Vector3 value = %%VALUE%%;
+        const float within = %%WITHIN%%;
+
+        [Test]
+        public void SyncVarIsBitPacked()
+        {
+            serverComponent.myValue = value;
+
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                serverComponent.SerializeSyncVars(writer, true);
+
+                Assert.That(writer.BitPosition, Is.EqualTo(%%BIT_COUNT%%));
+
+                using (PooledNetworkReader reader = NetworkReaderPool.GetReader(writer.ToArraySegment()))
+                {
+                    clientComponent.DeserializeSyncVars(reader, true);
+                    Assert.That(reader.BitPosition, Is.EqualTo(%%BIT_COUNT%%));
+
+                    Assert.That(clientComponent.myValue.x, Is.EqualTo(value.x).Within(within));
+                    Assert.That(clientComponent.myValue.y, Is.EqualTo(value.y).Within(within));
+                    Assert.That(clientComponent.myValue.z, Is.EqualTo(value.z).Within(within));
+                }
+            }
+        }
+    }
+}
diff --git a/Assets/Tests/Generators/QuaternionPackTestGenerator.cs b/Assets/Tests/Generators/QuaternionPackTestGenerator.cs
new file mode 100644
index 00000000000..5b0ed943334
--- /dev/null
+++ b/Assets/Tests/Generators/QuaternionPackTestGenerator.cs
@@ -0,0 +1,36 @@
+using JamesFrowen.SimpleCodeGen;
+using UnityEditor;
+using UnityEngine;
+
+namespace Mirage.Tests.CodeGenerators
+{
+    public static class QuaternionPackTestGenerator
+    {
+        [MenuItem("Tests Generators/QuaternionPack")]
+        public static void CreateAll()
+        {
+            var fromTemplate = new CreateFromTemplate("./Assets/Tests/Generators/.QuaternionPackTestTemplate.txt");
+            Create(fromTemplate, 8, Quaternion.Euler(0, 90, 0), 0.00540f);
+            Create(fromTemplate, 9, Quaternion.Euler(0, 90, 0), 0.00270f);
+            Create(fromTemplate, 10, Quaternion.Euler(0, 90, 0), 0.00135f);
+
+            Create(fromTemplate, 8, Quaternion.Euler(45, 90, 0), 0.00540f);
+            Create(fromTemplate, 9, Quaternion.Euler(45, 90, 0), 0.00270f);
+            Create(fromTemplate, 10, Quaternion.Euler(45, 90, 0), 0.00135f);
+
+            AssetDatabase.Refresh();
+        }
+
+        private static void Create(CreateFromTemplate fromTemplate, int bitCount, Quaternion value, float within)
+        {
+            string name = $"{bitCount}_{(int)(value.eulerAngles.x)}";
+            fromTemplate.Replace("%%NAME%%", name);
+            fromTemplate.Replace("%%PACKER_ATTRIBUTE%%", $"{bitCount}");
+            fromTemplate.Replace("%%VALUE%%", $"new Quaternion({value.x}f, {value.y}f, {value.z}f, {value.w}f)");
+            fromTemplate.Replace("%%WITHIN%%", $"{within}f");
+            fromTemplate.Replace("%%BIT_COUNT%%", bitCount * 3 + 2);
+
+            fromTemplate.WriteToFile($"./Assets/Tests/Generated/QuaternionPackTests/QuaternionPackBehaviour_{name}.cs");
+        }
+    }
+}
diff --git a/Assets/Tests/Generators/QuaternionPackTestGenerator.cs.meta b/Assets/Tests/Generators/QuaternionPackTestGenerator.cs.meta
new file mode 100644
index 00000000000..1c9a2722024
--- /dev/null
+++ b/Assets/Tests/Generators/QuaternionPackTestGenerator.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 22983137b5d94354e93b3878d6aeb268
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generators/Vector2PackTestGenerator.cs b/Assets/Tests/Generators/Vector2PackTestGenerator.cs
new file mode 100644
index 00000000000..effe5739f79
--- /dev/null
+++ b/Assets/Tests/Generators/Vector2PackTestGenerator.cs
@@ -0,0 +1,42 @@
+using JamesFrowen.SimpleCodeGen;
+using UnityEditor;
+using UnityEngine;
+
+namespace Mirage.Tests.CodeGenerators
+{
+    public static class Vector2PackTestGenerator
+    {
+        [MenuItem("Tests Generators/Vector2Pack")]
+        public static void CreateAll()
+        {
+            var fromTemplate = new CreateFromTemplate("./Assets/Tests/Generators/.Vector2PackTestTemplate.txt");
+            Create(fromTemplate, "100_28f3", new Vector2(100, 20), "0.2f, 0.2f", new Vector2(10.3f, 0.2f), 0.2f, 18);
+            Create(fromTemplate, "100_28f", new Vector2(100, 20), "0.2f", new Vector2(10.3f, 0.2f), 0.2f, 18);
+            Create(fromTemplate, "100_28b3", new Vector2(100, 20), "10, 8", new Vector2(-10.3f, 0.2f), 0.2f, 18);
+            Create(fromTemplate, "100_30f", new Vector2(100, 100), "10", new Vector2(-10.3f, 0.2f), 0.2f, 20);
+
+            Create(fromTemplate, "1000_42f3", new Vector2(1000, 200), "0.1f, 0.1f", new Vector2(-10.3f, 0.2f), 0.1f, 27);
+            Create(fromTemplate, "1000_42f", new Vector2(1000, 200), "0.1f", new Vector2(-10.3f, 0.2f), 0.1f, 27);
+            Create(fromTemplate, "1000_42b3", new Vector2(1000, 200), "15, 12", new Vector2(10.3f, 0.2f), 0.2f, 27);
+            Create(fromTemplate, "1000_45f", new Vector2(1000, 200), "15", new Vector2(10.3f, 0.2f), 0.2f, 30);
+
+            Create(fromTemplate, "200_39f3", new Vector2(200, 200), "0.05f, 0.05f", new Vector2(-10.3f, 0.2f), 0.1f, 26);
+            Create(fromTemplate, "200_39f", new Vector2(200, 200), "0.05f", new Vector2(-10.3f, 0.2f), 0.1f, 26);
+            Create(fromTemplate, "200_39b3", new Vector2(200, 200), "13, 13", new Vector2(10.3f, 0.2f), 0.2f, 26);
+            Create(fromTemplate, "200_39f", new Vector2(200, 200), "13", new Vector2(10.3f, 0.2f), 0.2f, 26);
+
+            AssetDatabase.Refresh();
+        }
+
+        private static void Create(CreateFromTemplate fromTemplate, string name, Vector2 max, string ArgAttribute2, Vector2 value, float within, int bitcount)
+        {
+            fromTemplate.Replace("%%NAME%%", name);
+            fromTemplate.Replace("%%PACKER_ATTRIBUTE%%", $"{max.x}f, {max.y}f, {ArgAttribute2}");
+            fromTemplate.Replace("%%VALUE%%", $"new Vector2({value.x}f, {value.y}f)");
+            fromTemplate.Replace("%%WITHIN%%", $"{within}f");
+            fromTemplate.Replace("%%BIT_COUNT%%", bitcount);
+
+            fromTemplate.WriteToFile($"./Assets/Tests/Generated/Vector2PackTests/Vector2PackBehaviour_{name}.cs");
+        }
+    }
+}
diff --git a/Assets/Tests/Generators/Vector2PackTestGenerator.cs.meta b/Assets/Tests/Generators/Vector2PackTestGenerator.cs.meta
new file mode 100644
index 00000000000..3ab378dd7a7
--- /dev/null
+++ b/Assets/Tests/Generators/Vector2PackTestGenerator.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 7159da5f683afc846bc0f7ff79ff273e
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Generators/Vector3PackTestGenerator.cs b/Assets/Tests/Generators/Vector3PackTestGenerator.cs
new file mode 100644
index 00000000000..c023309a7bd
--- /dev/null
+++ b/Assets/Tests/Generators/Vector3PackTestGenerator.cs
@@ -0,0 +1,42 @@
+using JamesFrowen.SimpleCodeGen;
+using UnityEditor;
+using UnityEngine;
+
+namespace Mirage.Tests.CodeGenerators
+{
+    public static class Vector3PackTestGenerator
+    {
+        [MenuItem("Tests Generators/Vector3Pack")]
+        public static void CreateAll()
+        {
+            var fromTemplate = new CreateFromTemplate("./Assets/Tests/Generators/.Vector3PackTestTemplate.txt");
+            Create(fromTemplate, "100_28f3", new Vector3(100, 20, 100), "0.2f, 0.2f, 0.2f", new Vector3(10.3f, 0.2f, 20), 0.2f, 28);
+            Create(fromTemplate, "100_28f", new Vector3(100, 20, 100), "0.2f", new Vector3(10.3f, 0.2f, 20), 0.2f, 28);
+            Create(fromTemplate, "100_28b3", new Vector3(100, 20, 100), "10, 8, 10", new Vector3(-10.3f, 0.2f, 20), 0.2f, 28);
+            Create(fromTemplate, "100_30f", new Vector3(100, 100, 100), "10", new Vector3(-10.3f, 0.2f, 20), 0.2f, 30);
+
+            Create(fromTemplate, "1000_42f3", new Vector3(1000, 200, 1000), "0.1f, 0.1f, 0.1f", new Vector3(-10.3f, 0.2f, 20), 0.1f, 42);
+            Create(fromTemplate, "1000_42f", new Vector3(1000, 200, 1000), "0.1f", new Vector3(-10.3f, 0.2f, 20), 0.1f, 42);
+            Create(fromTemplate, "1000_42b3", new Vector3(1000, 200, 1000), "15, 12, 15", new Vector3(10.3f, 0.2f, 20), 0.2f, 42);
+            Create(fromTemplate, "1000_45f", new Vector3(1000, 200, 1000), "15", new Vector3(10.3f, 0.2f, 20), 0.2f, 45);
+
+            Create(fromTemplate, "200_39f3", new Vector3(200, 200, 200), "0.05f, 0.05f, 0.05f", new Vector3(-10.3f, 0.2f, -20), 0.1f, 39);
+            Create(fromTemplate, "200_39f", new Vector3(200, 200, 200), "0.05f", new Vector3(-10.3f, 0.2f, -20), 0.1f, 39);
+            Create(fromTemplate, "200_39b3", new Vector3(200, 200, 200), "13, 13, 13", new Vector3(10.3f, 0.2f, 20), 0.2f, 39);
+            Create(fromTemplate, "200_39f", new Vector3(200, 200, 200), "13", new Vector3(10.3f, 0.2f, 20), 0.2f, 39);
+
+            AssetDatabase.Refresh();
+        }
+
+        private static void Create(CreateFromTemplate fromTemplate, string name, Vector3 max, string ArgAttribute2, Vector3 value, float within, int bitcount)
+        {
+            fromTemplate.Replace("%%NAME%%", name);
+            fromTemplate.Replace("%%PACKER_ATTRIBUTE%%", $"{max.x}f, {max.y}f, {max.z}f, {ArgAttribute2}");
+            fromTemplate.Replace("%%VALUE%%", $"new Vector3({value.x}f, {value.y}f, {value.z}f)");
+            fromTemplate.Replace("%%WITHIN%%", $"{within}f");
+            fromTemplate.Replace("%%BIT_COUNT%%", bitcount);
+
+            fromTemplate.WriteToFile($"./Assets/Tests/Generated/Vector3PackTests/Vector3PackBehaviour_{name}.cs");
+        }
+    }
+}
diff --git a/Assets/Tests/Generators/Vector3PackTestGenerator.cs.meta b/Assets/Tests/Generators/Vector3PackTestGenerator.cs.meta
new file mode 100644
index 00000000000..a1128cc4e0f
--- /dev/null
+++ b/Assets/Tests/Generators/Vector3PackTestGenerator.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 4969467fbe50f75458f056c7915f65fd
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/Tests/Weaver/BitAttributeTests.cs b/Assets/Tests/Weaver/BitAttributeTests.cs
index 91dd47fc9fd..a6316270e4f 100644
--- a/Assets/Tests/Weaver/BitAttributeTests.cs
+++ b/Assets/Tests/Weaver/BitAttributeTests.cs
@@ -149,5 +149,95 @@ public void FloatPackInvalid()
             HasError("Precsion must be positive, precision:-0.1",
                 "System.Single BitAttributeTests.FloatPackInvalid.MyBehaviour::value9");
         }
+
+        [Test]
+        public void Vector3Pack()
+        {
+            IsSuccess();
+        }
+
+        [Test]
+        public void Vector3PackInvalid()
+        {
+            HasErrorCount(11);
+            HasError("System.Single is not a supported type for [Vector3Pack]",
+               "System.Single BitAttributeTests.Vector3PackInvalid.MyBehaviour::value1");
+            HasError("UnityEngine.Vector2 is not a supported type for [Vector3Pack]",
+               "UnityEngine.Vector2 BitAttributeTests.Vector3PackInvalid.MyBehaviour::value2");
+
+            HasError("BitCount must be between 1 and 30 (inclusive), bitCount:31",
+               "UnityEngine.Vector3 BitAttributeTests.Vector3PackInvalid.MyBehaviour::value3");
+            HasError("BitCount must be between 1 and 30 (inclusive), bitCount:31",
+               "UnityEngine.Vector3 BitAttributeTests.Vector3PackInvalid.MyBehaviour::value4");
+
+            HasError("BitCount must be between 1 and 30 (inclusive), bitCount:0",
+               "UnityEngine.Vector3 BitAttributeTests.Vector3PackInvalid.MyBehaviour::value5");
+            HasError("BitCount must be between 1 and 30 (inclusive), bitCount:0",
+               "UnityEngine.Vector3 BitAttributeTests.Vector3PackInvalid.MyBehaviour::value6");
+            HasError("BitCount must be between 1 and 30 (inclusive), bitCount:0",
+               "UnityEngine.Vector3 BitAttributeTests.Vector3PackInvalid.MyBehaviour::value7");
+
+            HasError("Max must be above 0, max:(-1.0, 0.0, 0.0)",
+               "UnityEngine.Vector3 BitAttributeTests.Vector3PackInvalid.MyBehaviour::value8");
+            HasError("Max must be above 0, max:(1.0, -1.0, 0.0)",
+               "UnityEngine.Vector3 BitAttributeTests.Vector3PackInvalid.MyBehaviour::value9");
+            HasError("Max must be above 0, max:(1.0, 1.0, -1.0)",
+               "UnityEngine.Vector3 BitAttributeTests.Vector3PackInvalid.MyBehaviour::value10");
+            HasError("Max must be above 0, max:(-1.0, 0.0, 0.0)",
+               "UnityEngine.Vector3 BitAttributeTests.Vector3PackInvalid.MyBehaviour::value11");
+        }
+
+        [Test]
+        public void Vector2Pack()
+        {
+            IsSuccess();
+        }
+
+        [Test]
+        public void Vector2PackInvalid()
+        {
+            HasErrorCount(9);
+            HasError("System.Single is not a supported type for [Vector2Pack]",
+               "System.Single BitAttributeTests.Vector2PackInvalid.MyBehaviour::value1");
+            HasError("UnityEngine.Vector3 is not a supported type for [Vector2Pack]",
+               "UnityEngine.Vector3 BitAttributeTests.Vector2PackInvalid.MyBehaviour::value2");
+
+            HasError("BitCount must be between 1 and 30 (inclusive), bitCount:31",
+               "UnityEngine.Vector2 BitAttributeTests.Vector2PackInvalid.MyBehaviour::value3");
+            HasError("BitCount must be between 1 and 30 (inclusive), bitCount:31",
+               "UnityEngine.Vector2 BitAttributeTests.Vector2PackInvalid.MyBehaviour::value4");
+            HasError("BitCount must be between 1 and 30 (inclusive), bitCount:0",
+               "UnityEngine.Vector2 BitAttributeTests.Vector2PackInvalid.MyBehaviour::value5");
+            HasError("BitCount must be between 1 and 30 (inclusive), bitCount:0",
+               "UnityEngine.Vector2 BitAttributeTests.Vector2PackInvalid.MyBehaviour::value6");
+            HasError("Max must be above 0, max:(-1.0, 0.0)",
+               "UnityEngine.Vector2 BitAttributeTests.Vector2PackInvalid.MyBehaviour::value7");
+            HasError("Max must be above 0, max:(1.0, -1.0)",
+               "UnityEngine.Vector2 BitAttributeTests.Vector2PackInvalid.MyBehaviour::value8");
+            HasError("Max must be above 0, max:(-1.0, 0.0)",
+               "UnityEngine.Vector2 BitAttributeTests.Vector2PackInvalid.MyBehaviour::value9");
+        }
+
+        [Test]
+        public void QuaternionPack()
+        {
+            IsSuccess();
+        }
+
+        [Test]
+        public void QuaternionPackInvalid()
+        {
+            HasErrorCount(4);
+
+            HasError("System.Single is not a supported type for [QuaternionPack]",
+               "System.Single BitAttributeTests.QuaternionPackInvalid.MyBehaviour::value1");
+            HasError("UnityEngine.Vector3 is not a supported type for [QuaternionPack]",
+               "UnityEngine.Vector3 BitAttributeTests.QuaternionPackInvalid.MyBehaviour::value2");
+
+            HasError("BitCount should be above 0",
+               "UnityEngine.Quaternion BitAttributeTests.QuaternionPackInvalid.MyBehaviour::value3");
+            HasError("BitCount should be below 20",
+               "UnityEngine.Quaternion BitAttributeTests.QuaternionPackInvalid.MyBehaviour::value4");
+        }
     }
 }
diff --git a/Assets/Tests/Weaver/BitAttributeTests~/QuaternionPack.cs b/Assets/Tests/Weaver/BitAttributeTests~/QuaternionPack.cs
new file mode 100644
index 00000000000..23da1fecc20
--- /dev/null
+++ b/Assets/Tests/Weaver/BitAttributeTests~/QuaternionPack.cs
@@ -0,0 +1,15 @@
+using Mirage;
+using Mirage.Serialization;
+using UnityEngine;
+
+namespace BitAttributeTests.QuaternionPack
+{
+    public class MyBehaviour : NetworkBehaviour
+    {
+        [QuaternionPack(9)]
+        [SyncVar] public Quaternion value1;
+
+        [QuaternionPack(10)]
+        [SyncVar] public Quaternion value3;
+    }
+}
\ No newline at end of file
diff --git a/Assets/Tests/Weaver/BitAttributeTests~/QuaternionPackInvalid.cs b/Assets/Tests/Weaver/BitAttributeTests~/QuaternionPackInvalid.cs
new file mode 100644
index 00000000000..54d3b6ed3e7
--- /dev/null
+++ b/Assets/Tests/Weaver/BitAttributeTests~/QuaternionPackInvalid.cs
@@ -0,0 +1,25 @@
+using Mirage;
+using Mirage.Serialization;
+using UnityEngine;
+
+namespace BitAttributeTests.QuaternionPackInvalid
+{
+    public class MyBehaviour : NetworkBehaviour
+    {
+        // error, invalid type
+        [QuaternionPack(9)]
+        [SyncVar] public float value1;
+
+        // error, invalid type
+        [QuaternionPack(9)]
+        [SyncVar] public Vector3 value2;
+
+        // error, should be above 0
+        [QuaternionPack(0)]
+        [SyncVar] public Quaternion value3;
+
+        // error, should be below 20
+        [QuaternionPack(21)]
+        [SyncVar] public Quaternion value4;
+    }
+}
\ No newline at end of file
diff --git a/Assets/Tests/Weaver/BitAttributeTests~/Vector2Pack.cs b/Assets/Tests/Weaver/BitAttributeTests~/Vector2Pack.cs
new file mode 100644
index 00000000000..3552600ce9b
--- /dev/null
+++ b/Assets/Tests/Weaver/BitAttributeTests~/Vector2Pack.cs
@@ -0,0 +1,24 @@
+using Mirage;
+using Mirage.Serialization;
+using UnityEngine;
+
+namespace BitAttributeTests.Vector2Pack
+{
+    public class MyBehaviour : NetworkBehaviour
+    {
+        [Vector2Pack(100, 20, 0.1f, 0.1f)]
+        [SyncVar] public Vector2 value1;
+
+        [Vector2Pack(100, 20, 0.1f)]
+        [SyncVar] public Vector2 value2;
+
+        [Vector2Pack(100, 20, 10, 8)]
+        [SyncVar] public Vector2 value3;
+
+        [Vector2Pack(100, 20, 10)]
+        [SyncVar] public Vector2 value4;
+
+        [Vector2Pack(100, 100, 10)]
+        [SyncVar] public Vector2 value5;
+    }
+}
\ No newline at end of file
diff --git a/Assets/Tests/Weaver/BitAttributeTests~/Vector2PackInvalid.cs b/Assets/Tests/Weaver/BitAttributeTests~/Vector2PackInvalid.cs
new file mode 100644
index 00000000000..591e4db1d14
--- /dev/null
+++ b/Assets/Tests/Weaver/BitAttributeTests~/Vector2PackInvalid.cs
@@ -0,0 +1,45 @@
+using Mirage;
+using Mirage.Serialization;
+using UnityEngine;
+
+namespace BitAttributeTests.Vector2PackInvalid
+{
+    public class MyBehaviour : NetworkBehaviour
+    {
+        // error, invalid type
+        [Vector2Pack(1f, 1f, 10, 10)]
+        [SyncVar] public float value1;
+
+        // error, invalid type
+        [Vector2Pack(1f, 1f, 10, 10)]
+        [SyncVar] public Vector3 value2;
+
+        // error, bit count out of range
+        [Vector2Pack(1f, 1f, 31, 31)]
+        [SyncVar] public Vector2 value3;
+
+        // error, bit count out of range
+        [Vector2Pack(1f, 1f, 31)]
+        [SyncVar] public Vector2 value4;
+
+        // error, bit count out of range
+        [Vector2Pack(1f, 1f, 0, 10)]
+        [SyncVar] public Vector2 value5;
+
+        // error, bit count out of range
+        [Vector2Pack(1f, 1f, 10, 0)]
+        [SyncVar] public Vector2 value6;
+
+        // error, bit count out of range
+        [Vector2Pack(-1f, 1f, 10)]
+        [SyncVar] public Vector2 value7;
+
+        // error, bit count out of range
+        [Vector2Pack(1f, -1f, 10)]
+        [SyncVar] public Vector2 value8;
+
+        // error, bit count out of range
+        [Vector2Pack(-1f, -1f, 10, 10)]
+        [SyncVar] public Vector2 value9;
+    }
+}
\ No newline at end of file
diff --git a/Assets/Tests/Weaver/BitAttributeTests~/Vector3Pack.cs b/Assets/Tests/Weaver/BitAttributeTests~/Vector3Pack.cs
new file mode 100644
index 00000000000..2abd51efae3
--- /dev/null
+++ b/Assets/Tests/Weaver/BitAttributeTests~/Vector3Pack.cs
@@ -0,0 +1,24 @@
+using Mirage;
+using Mirage.Serialization;
+using UnityEngine;
+
+namespace BitAttributeTests.Vector3Pack
+{
+    public class MyBehaviour : NetworkBehaviour
+    {
+        [Vector3Pack(100, 20, 80, 0.1f, 0.05f, 0.1f)]
+        [SyncVar] public Vector3 value1;
+
+        [Vector3Pack(100, 20, 80, 0.1f)]
+        [SyncVar] public Vector3 value2;
+
+        [Vector3Pack(100, 20, 80, 10, 8, 10)]
+        [SyncVar] public Vector3 value3;
+
+        [Vector3Pack(100, 20, 80, 10)]
+        [SyncVar] public Vector3 value4;
+
+        [Vector3Pack(100, 100, 100, 10)]
+        [SyncVar] public Vector3 value5;
+    }
+}
\ No newline at end of file
diff --git a/Assets/Tests/Weaver/BitAttributeTests~/Vector3PackInvalid.cs b/Assets/Tests/Weaver/BitAttributeTests~/Vector3PackInvalid.cs
new file mode 100644
index 00000000000..44aac7be0aa
--- /dev/null
+++ b/Assets/Tests/Weaver/BitAttributeTests~/Vector3PackInvalid.cs
@@ -0,0 +1,53 @@
+using Mirage;
+using Mirage.Serialization;
+using UnityEngine;
+
+namespace BitAttributeTests.Vector3PackInvalid
+{
+    public class MyBehaviour : NetworkBehaviour
+    {
+        // error, invalid type
+        [Vector3Pack(1f, 1f, 1f, 10)]
+        [SyncVar] public float value1;
+
+        // error, bit count out of range
+        [Vector3Pack(1f, 1f, 1f, 10)]
+        [SyncVar] public Vector2 value2;
+
+        // error, bit count out of range
+        [Vector3Pack(1f, 1f, 1f, 31, 31, 31)]
+        [SyncVar] public Vector3 value3;
+
+        // error, bit count out of range
+        [Vector3Pack(1f, 1f, 1f, 31)]
+        [SyncVar] public Vector3 value4;
+
+        // error, bit count out of range
+        [Vector3Pack(1f, 1f, 1f, 0, 10, 10)]
+        [SyncVar] public Vector3 value5;
+
+        // error, bit count out of range
+        [Vector3Pack(1f, 1f, 1f, 10, 0, 10)]
+        [SyncVar] public Vector3 value6;
+
+        // error, bit count out of range
+        [Vector3Pack(1f, 1f, 1f, 10, 10, 0)]
+        [SyncVar] public Vector3 value7;
+
+        // error, bit count out of range
+        [Vector3Pack(-1f, 1f, 1f, 10)]
+        [SyncVar] public Vector3 value8;
+
+        // error, bit count out of range
+        [Vector3Pack(1f, -1f, 1f, 10)]
+        [SyncVar] public Vector3 value9;
+
+        // error, bit count out of range
+        [Vector3Pack(1f, 1f, -1f, 10)]
+        [SyncVar] public Vector3 value10;
+
+        // error, bit count out of range
+        [Vector3Pack(-1f, -1f, 1f, 10, 10, 10)]
+        [SyncVar] public Vector3 value11;
+    }
+}
\ No newline at end of file
diff --git a/doc/Articles/Guides/BitPacking/QuaternionPacker.md b/doc/Articles/Guides/BitPacking/QuaternionPacker.md
index 3843df1ca19..3c9c3cb7587 100644
--- a/doc/Articles/Guides/BitPacking/QuaternionPacker.md
+++ b/doc/Articles/Guides/BitPacking/QuaternionPacker.md
@@ -1 +1,111 @@
-*work in progress*
\ No newline at end of file
+*work in progress*
+
+### Quaternion Rules
+
+Quaternions can be packed using some of the mathematically rules they follow
+
+
+#### Quaternions should be normalized
+
+x^2 + y^2 + z^2 + w^2 = 1
+
+Because of this we only need to send the smallest 3 value as we can calculate the largest one again on the other side.
+
+We also need to send the index to say which of the 4 elements was the largest
+
+largest = sqrt(1 - a^2 + b^2 + c^2)
+
+#### Positive and Negative Quaternions represent the same rotation
+
+Q(x,y,z,w) === Q(-x,-y,-z,-w)
+
+If the largest element is negative we would have to send its sign in order to calculate the correct rotation.
+
+However because Q=-Q, if the largest element is negative we can just flip the sign of all 4 elements instead.
+
+#### Max of second largest element
+
+The value of the 2nd largest element is when it is also equal to the largest so we have
+
+L^2 + L^2 = 1
+
+From this we can find the max value for 2nd largest is 
+
+L = +- 1 / sqrt(2) = +- ~0.707
+
+This allows us to pack the smallest 3 elements in range -0.707 to +0.707 instead of -1 to +1
+
+#### Result
+
+Combining all this we can send each of the smallest 3 elements with 9 bits, and 2 bits for the index of the largest element. Which reduces the size of a Quaternion from 128 bits unpacked to only 29 bits.
+
+The precision of the smallest 3 can in increased or decreased to change the bit counts by multiples of 3. eg 10 bits per element will result is 32 bits total.
+
+
+### Supported Types
+
+- Quaternion
+
+### Example 1
+
+```cs
+public class MyNetworkBehaviour : NetworkBehaviour 
+{
+    [SyncVar, QuaternionPack(9)]
+    public Quaternion direction;
+}
+```
+
+### Generated Code
+
+Source:
+```cs 
+[SyncVar, QuaternionPack(9)]
+public int myValue;
+```
+
+Generated:
+```cs
+
+private QuaternionPacker myValue__Packer = new QuaternionPacker(9);
+
+public override bool SerializeSyncVars(NetworkWriter writer, bool initialState)
+{
+    ulong syncVarDirtyBits = base.SyncVarDirtyBits;
+    bool result = base.SerializeSyncVars(writer, initialize);
+
+    if (initialState) 
+    {
+        myValue__Packer.Pack(writer, this.myValue);
+        return true;
+    }
+
+    writer.Write(syncVarDirtyBits, 1);
+    if ((syncVarDirtyBits & 1UL) != 0UL)
+    {
+        myValue__Packer.Pack(writer, this.myValue);
+        result = true;
+    }
+
+    return result;
+}
+
+public override void DeserializeSyncVars(NetworkReader reader, bool initialState)
+{
+    base.DeserializeSyncVars(reader, initialState);
+
+    if (initialState)
+    {
+        this.myValue = myValue__Packer.Unpack(reader);
+        return;
+    }
+
+    ulong dirtyMask = reader.Read(1);
+    if ((dirtyMask & 1UL) != 0UL)
+    {
+        this.myValue = myValue__Packer.Unpack(reader);
+    }
+}
+```
+
+*last updated for Mirage v101.8.0*
\ No newline at end of file
diff --git a/doc/Articles/Guides/BitPacking/VectorPacker.md b/doc/Articles/Guides/BitPacking/VectorPacker.md
index 3843df1ca19..0b6ba1ce695 100644
--- a/doc/Articles/Guides/BitPacking/VectorPacker.md
+++ b/doc/Articles/Guides/BitPacking/VectorPacker.md
@@ -1 +1,106 @@
-*work in progress*
\ No newline at end of file
+
+*work in progress*
+
+# Bit Count
+
+A Vector2 or Vector3 can be compressed using <xref:Mirage.Serialization.Vector2PackAttribute> or <xref:Mirage.Serialization.Vector3PackAttribute> 
+
+This attributes work in the same way as [FloatPack](./FloatPack.md) expect on 2 or 3 dimensions instead of 1
+
+### Use cases
+
+- A Vector value with a maximum value
+
+### Supported Types
+
+- Vector2 (<xref:Mirage.Serialization.Vector2PackAttribute>)
+- Vector3 (<xref:Mirage.Serialization.Vector3PackAttribute>)
+
+### Example 1
+
+Health which is between 0 and 100
+
+```cs
+public class MyNetworkBehaviour : NetworkBehaviour 
+{
+    [SyncVar, FloatPack(100f, 0.02f)]
+    public int Health;
+}
+```
+
+`Max = 100`, `resolution = 0.02f` so bit count is 14
+
+`health = 57.2f` will serialize to `01_0010_0100_1101` and deserialize to `57.197f`
+
+`health = -13.5f` will serialize to `11_1011_1010_1110` and deserialize to `-13.503f`
+
+`health = 120f` will be clamped to `100f`
+
+
+### Example 2
+
+A Percent that where you only want to send 8 bits
+
+```cs
+public class MyNetworkBehaviour : NetworkBehaviour 
+{
+    [SyncVar, FloatPack(1f, 8)]
+    public int Percent;
+}
+```
+
+`Max = 1f`, `bitCount = 8` so resolution will be `0.00787f`
+
+### Generated Code
+
+Source:
+```cs 
+[SyncVar, FloatPack(100f, 0.02f)]
+public int myValue;
+```
+
+Generated:
+```cs
+
+private FloatPacker myValue__Packer = new FloatPacker(100f, 0.02f);
+
+public override bool SerializeSyncVars(NetworkWriter writer, bool initialState)
+{
+    ulong syncVarDirtyBits = base.SyncVarDirtyBits;
+    bool result = base.SerializeSyncVars(writer, initialize);
+
+    if (initialState) 
+    {
+        myValue__Packer.Pack(writer, this.myValue);
+        return true;
+    }
+
+    writer.Write(syncVarDirtyBits, 1);
+    if ((syncVarDirtyBits & 1UL) != 0UL)
+    {
+        myValue__Packer.Pack(writer, this.myValue);
+        result = true;
+    }
+
+    return result;
+}
+
+public override void DeserializeSyncVars(NetworkReader reader, bool initialState)
+{
+    base.DeserializeSyncVars(reader, initialState);
+
+    if (initialState)
+    {
+        this.myValue = myValue__Packer.Unpack(reader);
+        return;
+    }
+
+    ulong dirtyMask = reader.Read(1);
+    if ((dirtyMask & 1UL) != 0UL)
+    {
+        this.myValue = myValue__Packer.Unpack(reader);
+    }
+}
+```
+
+*last updated for Mirage v101.8.0*
\ No newline at end of file

From 825cae89cfa66cda6cd2edbdb603e31045e79bbd Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Tue, 31 Aug 2021 14:59:30 +0100
Subject: [PATCH 160/166] refactor: chaning error to warning

This is broken with additive scenes, so making it a warning instead
see https://github.com/MirageNet/Mirage/issues/909
---
 Assets/Mirage/Editor/NetworkScenePostProcess.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Assets/Mirage/Editor/NetworkScenePostProcess.cs b/Assets/Mirage/Editor/NetworkScenePostProcess.cs
index cf5ce62a182..fab9ec42d25 100644
--- a/Assets/Mirage/Editor/NetworkScenePostProcess.cs
+++ b/Assets/Mirage/Editor/NetworkScenePostProcess.cs
@@ -57,7 +57,7 @@ public static void OnPostProcessScene()
                     }
                     // throwing an exception would only show it for one object
                     // because this function would return afterwards.
-                    else logger.LogError("Scene " + identity.gameObject.scene.path + " needs to be opened and resaved, because the scene object " + identity.name + " has no valid sceneId yet.");
+                    else logger.LogWarning("Scene " + identity.gameObject.scene.path + " needs to be opened and resaved, because the scene object " + identity.name + " has no valid sceneId yet.");
                 }
             }
         }

From 6edec25307704e4e1be3e3e5f78c6cc565ecfafe Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Tue, 31 Aug 2021 14:15:32 +0000
Subject: [PATCH 161/166] chore(release): 101.10.0 [skip ci]

# [101.10.0](https://github.com/MirageNet/Mirage/compare/v101.9.2...v101.10.0) (2021-08-31)

### Features

* attributes to use new vector bit packers ([#905](https://github.com/MirageNet/Mirage/issues/905)) ([149bf5a](https://github.com/MirageNet/Mirage/commit/149bf5adc44f60ad810c2233afceea32c5af2e2a))
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs               | 2 +-
 Assets/Mirage/CHANGELOG.md                                 | 7 +++++++
 Assets/Mirage/Components/AssemblyInfo.cs                   | 2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                      | 2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs          | 2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs                     | 2 +-
 .../Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs      | 2 +-
 Assets/Mirage/package.json                                 | 2 +-
 8 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index be5d058044b..4f346db0e8b 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.9.2")]
+[assembly: AssemblyVersion("101.10.0")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index 79755dfcf16..99bc299dc52 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,10 @@
+# [101.10.0](https://github.com/MirageNet/Mirage/compare/v101.9.2...v101.10.0) (2021-08-31)
+
+
+### Features
+
+* attributes to use new vector bit packers ([#905](https://github.com/MirageNet/Mirage/issues/905)) ([149bf5a](https://github.com/MirageNet/Mirage/commit/149bf5adc44f60ad810c2233afceea32c5af2e2a))
+
 ## [101.9.2](https://github.com/MirageNet/Mirage/compare/v101.9.1...v101.9.2) (2021-08-29)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index a5a1714bd50..d2d729f5145 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.9.2")]
+[assembly: AssemblyVersion("101.10.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index 79ef073a0b9..7f96fc34e58 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.9.2")]
+[assembly: AssemblyVersion("101.10.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index 6db8bb2d008..5c660c71881 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.9.2")]
+[assembly: AssemblyVersion("101.10.0")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index be5d058044b..4f346db0e8b 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.9.2")]
+[assembly: AssemblyVersion("101.10.0")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index be5d058044b..4f346db0e8b 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.9.2")]
+[assembly: AssemblyVersion("101.10.0")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 8e0c408c95e..3fe82200037 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "101.9.2",
+    "version": "101.10.0",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",

From 2c8cb98a72fb472aee38ca860d489c062c643a66 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Tue, 31 Aug 2021 17:43:23 +0100
Subject: [PATCH 162/166] docs: fixing doc titles

---
 doc/Articles/Guides/BitPacking/FloatPack.md                  | 2 +-
 .../BitPacking/{QuaternionPacker.md => QuaternionPack.md}    | 1 +
 .../Guides/BitPacking/{VectorPacker.md => VectorPack.md}     | 5 +----
 3 files changed, 3 insertions(+), 5 deletions(-)
 rename doc/Articles/Guides/BitPacking/{QuaternionPacker.md => QuaternionPack.md} (98%)
 rename doc/Articles/Guides/BitPacking/{VectorPacker.md => VectorPack.md} (97%)

diff --git a/doc/Articles/Guides/BitPacking/FloatPack.md b/doc/Articles/Guides/BitPacking/FloatPack.md
index 2ca274744db..914db15b069 100644
--- a/doc/Articles/Guides/BitPacking/FloatPack.md
+++ b/doc/Articles/Guides/BitPacking/FloatPack.md
@@ -1,4 +1,4 @@
-# Bit Count
+# Float Pack
 
 A float value can be compressed using <xref:Mirage.Serialization.FloatPackAttribute> 
 
diff --git a/doc/Articles/Guides/BitPacking/QuaternionPacker.md b/doc/Articles/Guides/BitPacking/QuaternionPack.md
similarity index 98%
rename from doc/Articles/Guides/BitPacking/QuaternionPacker.md
rename to doc/Articles/Guides/BitPacking/QuaternionPack.md
index 3c9c3cb7587..200f62ef5f7 100644
--- a/doc/Articles/Guides/BitPacking/QuaternionPacker.md
+++ b/doc/Articles/Guides/BitPacking/QuaternionPack.md
@@ -1,4 +1,5 @@
 *work in progress*
+# Quaternion PacK
 
 ### Quaternion Rules
 
diff --git a/doc/Articles/Guides/BitPacking/VectorPacker.md b/doc/Articles/Guides/BitPacking/VectorPack.md
similarity index 97%
rename from doc/Articles/Guides/BitPacking/VectorPacker.md
rename to doc/Articles/Guides/BitPacking/VectorPack.md
index 0b6ba1ce695..c8b6fbc0994 100644
--- a/doc/Articles/Guides/BitPacking/VectorPacker.md
+++ b/doc/Articles/Guides/BitPacking/VectorPack.md
@@ -1,7 +1,4 @@
-
-*work in progress*
-
-# Bit Count
+# Vector Pack
 
 A Vector2 or Vector3 can be compressed using <xref:Mirage.Serialization.Vector2PackAttribute> or <xref:Mirage.Serialization.Vector3PackAttribute> 
 

From 4b65b13e11ddffb0ef5a390e4b9f6be49c67c2b2 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Tue, 31 Aug 2021 23:34:15 +0100
Subject: [PATCH 163/166] docs: fixing toc and updating examples for vector

---
 doc/Articles/Guides/BitPacking/VectorPack.md | 64 ++++++++++++--------
 doc/Articles/Guides/BitPacking/index.md      |  4 +-
 doc/Articles/Guides/BitPacking/toc.yml       | 10 +--
 3 files changed, 48 insertions(+), 30 deletions(-)

diff --git a/doc/Articles/Guides/BitPacking/VectorPack.md b/doc/Articles/Guides/BitPacking/VectorPack.md
index c8b6fbc0994..c31b2677835 100644
--- a/doc/Articles/Guides/BitPacking/VectorPack.md
+++ b/doc/Articles/Guides/BitPacking/VectorPack.md
@@ -15,51 +15,56 @@ This attributes work in the same way as [FloatPack](./FloatPack.md) expect on 2
 
 ### Example 1
 
-Health which is between 0 and 100
+A Position in bounds +-100 in all xyz with 0.05 precision for all axis 
 
 ```cs
 public class MyNetworkBehaviour : NetworkBehaviour 
 {
-    [SyncVar, FloatPack(100f, 0.02f)]
-    public int Health;
+    [SyncVar, Vector3Pack(100f, 100f, 100f, 0.05f)]
+    public Vector3 Position;
 }
 ```
 
-`Max = 100`, `resolution = 0.02f` so bit count is 14
-
-`health = 57.2f` will serialize to `01_0010_0100_1101` and deserialize to `57.197f`
-
-`health = -13.5f` will serialize to `11_1011_1010_1110` and deserialize to `-13.503f`
+### Example 2
 
-`health = 120f` will be clamped to `100f`
+A Position in bounds +-100 in all xz with 0.05 precision, but with +-20 and precision 0.1 in y axis
 
+```cs
+public class MyNetworkBehaviour : NetworkBehaviour 
+{
+    [SyncVar, Vector3Pack(100f, 20f, 100f, 0.05f, 0.1f, 0.05f)]
+    public Vector3 Position;
+}
+```
 
-### Example 2
+### Example 3
 
-A Percent that where you only want to send 8 bits
+A Position in for a long 2d map
 
 ```cs
 public class MyNetworkBehaviour : NetworkBehaviour 
 {
-    [SyncVar, FloatPack(1f, 8)]
-    public int Percent;
+    [SyncVar, Vector2Pack(1000f, 80f, 0.05f)]
+    public Vector2 Position;
 }
 ```
 
-`Max = 1f`, `bitCount = 8` so resolution will be `0.00787f`
-
 ### Generated Code
 
 Source:
 ```cs 
-[SyncVar, FloatPack(100f, 0.02f)]
-public int myValue;
+[SyncVar, Vector3Pack(100f, 20f, 100f, 0.05f, 0.1f, 0.05f)]
+public int myValue1;
+
+[SyncVar, Vector2Pack(1000f, 80f, 0.05f)]
+public int myValue2;
 ```
 
 Generated:
 ```cs
 
-private FloatPacker myValue__Packer = new FloatPacker(100f, 0.02f);
+private Vector3Packer myValue1__Packer = new Vector3Packer(1100f, 20f, 100f, 0.05f, 0.1f, 0.05f);
+private Vector2Packer myValue2__Packer = new Vector2Packer(1000f, 80f, 0.05f, 0.05f);
 
 public override bool SerializeSyncVars(NetworkWriter writer, bool initialState)
 {
@@ -68,14 +73,20 @@ public override bool SerializeSyncVars(NetworkWriter writer, bool initialState)
 
     if (initialState) 
     {
-        myValue__Packer.Pack(writer, this.myValue);
+        myValue1__Packer.Pack(writer, this.myValue1);
+        myValue2__Packer.Pack(writer, this.myValue2);
         return true;
     }
 
-    writer.Write(syncVarDirtyBits, 1);
+    writer.Write(syncVarDirtyBits, 2);
     if ((syncVarDirtyBits & 1UL) != 0UL)
     {
-        myValue__Packer.Pack(writer, this.myValue);
+        myValue1__Packer.Pack(writer, this.myValue1);
+        result = true;
+    }
+    if ((syncVarDirtyBits & 2UL) != 0UL)
+    {
+        myValue2__Packer.Pack(writer, this.myValue2);
         result = true;
     }
 
@@ -88,14 +99,19 @@ public override void DeserializeSyncVars(NetworkReader reader, bool initialState
 
     if (initialState)
     {
-        this.myValue = myValue__Packer.Unpack(reader);
+        this.myValue1 = myValue1__Packer.Unpack(reader);
+        this.myValue2 = myValue2__Packer.Unpack(reader);
         return;
     }
 
-    ulong dirtyMask = reader.Read(1);
+    ulong dirtyMask = reader.Read(2);
     if ((dirtyMask & 1UL) != 0UL)
     {
-        this.myValue = myValue__Packer.Unpack(reader);
+        this.myValue1 = myValue1__Packer.Unpack(reader);
+    }
+    if ((dirtyMask & 2UL) != 0UL)
+    {
+        this.myValue2 = myValue2__Packer.Unpack(reader);
     }
 }
 ```
diff --git a/doc/Articles/Guides/BitPacking/index.md b/doc/Articles/Guides/BitPacking/index.md
index 6e1e0d97c97..b1252259166 100644
--- a/doc/Articles/Guides/BitPacking/index.md
+++ b/doc/Articles/Guides/BitPacking/index.md
@@ -11,4 +11,6 @@ Mirage has many attributes that can be applied to SyncVars and Rpc parameters
 - [BitCount](./BitCount.md) Sets the number of bits on an integer
 - [BitCountFromRange](./BitCountFromRange.md) Sets the number of bits from a given range, rounding up.
 - [ZigZagEncode](./ZigZagEncode.md) Encodes a value using [ZigZag Encoding](https://gist.github.com/mfuerstenau/ba870a29e16536fdbaba). Only useable with [BitCount](./BitCount.md) or [VarIntBlock](./VarIntBlock.md)
-- [FloatPack](./FloatPack.md) Compresses a float value.
\ No newline at end of file
+- [FloatPack](./FloatPack.md) Compresses a float value.
+- [VectorPack](./VectorPack.md) Compresses a Vector value.
+- [QuaternionPack](./QuaternionPack.md) Compresses a Quaternion value.
\ No newline at end of file
diff --git a/doc/Articles/Guides/BitPacking/toc.yml b/doc/Articles/Guides/BitPacking/toc.yml
index b68ef6b1bf2..52cb2f4597d 100644
--- a/doc/Articles/Guides/BitPacking/toc.yml
+++ b/doc/Articles/Guides/BitPacking/toc.yml
@@ -8,9 +8,9 @@
   href: ZigZagEncode.md
 - name: Variable Sized Int Block packer
   href: VarIntBlock.md
-- name: Float Packer
+- name: Float Pack
   href: FloatPack.md
-- name: Vector Packer
-  href: VectorPacker.md
-- name: Quaternion Packer
-  href: QuaternionPacker.md
+- name: Vector Pack
+  href: VectorPack.md
+- name: Quaternion Pack
+  href: QuaternionPack.md

From d16bd25c11d2f1b0444c83dfab42eb41d7d67285 Mon Sep 17 00:00:00 2001
From: James Frowen <jamesfrowendev@gmail.com>
Date: Wed, 1 Sep 2021 19:50:10 +0100
Subject: [PATCH 164/166] docs: adding example and generated code for rpc

---
 .../Guides/Communications/RpcExamples.md      | 65 +++++++++++++++++++
 doc/Articles/Guides/Communications/toc.yml    |  4 +-
 2 files changed, 68 insertions(+), 1 deletion(-)
 create mode 100644 doc/Articles/Guides/Communications/RpcExamples.md

diff --git a/doc/Articles/Guides/Communications/RpcExamples.md b/doc/Articles/Guides/Communications/RpcExamples.md
new file mode 100644
index 00000000000..2602df10ae1
--- /dev/null
+++ b/doc/Articles/Guides/Communications/RpcExamples.md
@@ -0,0 +1,65 @@
+# Rpc Examples
+
+Examples of Rpc and generated code
+
+## Example 1
+
+Set players name from client and have it synced to other players
+
+```cs
+public class Player : NetworkBehaviour
+{
+    [SyncVar] 
+    public string PlayerName;
+
+    [ServerRpc]
+    public void RpcChangeName(string newName)
+    {
+        PlayerName = newName;
+    }
+}
+```
+
+### Generated code
+
+Weaver moves the user code into a new function and then replace the body of the Rpc with an Internal send call
+
+RPCs are registered using the classes static constructor with methods that will read all the parameter and then invoke the user code method
+
+```cs
+public class Player : NetworkBehaviour
+{
+    [SyncVar] 
+    public string PlayerName;
+
+    [ServerRpc]
+    public void RpcChangeName(string newName)
+    {
+        if (this.IsServer)
+        {
+            UserCode_RpcChangeName(newName);
+        }
+        else 
+        {
+            using (PooledNetworkWriter writer = NetworkWriterPool.GetWriter())
+            {
+                writer.WriteString(newName);
+                this.SendServerRpcInternal(typeof(Player), "RpcChangeName", writer, 0, true);
+            }
+        }
+    }
+
+    public void UserCode_RpcChangeName(string newName)
+    {
+        PlayerName = newName;
+    }
+    protected void Skeleton_RpcChangeName(NetworkReader reader, INetworkPlayer senderConnection, int replyId)
+    {
+        this.UserCode_RpcChangeName(reader.ReadString());
+    }
+    static Player()
+    {
+        RemoteCallHelper.RegisterServerRpcDelegate(typeof(Player), "RpcChangeName", new CmdDelegate(null.Skeleton_RpcChangeName), false);
+    }
+}
+```
\ No newline at end of file
diff --git a/doc/Articles/Guides/Communications/toc.yml b/doc/Articles/Guides/Communications/toc.yml
index 76041958654..18b1ea22c02 100644
--- a/doc/Articles/Guides/Communications/toc.yml
+++ b/doc/Articles/Guides/Communications/toc.yml
@@ -7,4 +7,6 @@
 - name: Network Behaviour Callbacks
   href: NetworkBehaviourCallbacks.md
 - name: Network Messages
-  href: NetworkMessages.md
\ No newline at end of file
+  href: NetworkMessages.md
+- name: Rpc Examples
+  href: RpcExamples.md
\ No newline at end of file

From 2a9bdec6887bc67e7f53bb46f13592607b5c72b8 Mon Sep 17 00:00:00 2001
From: dragonslaya84 <santos_steve@hotmail.com>
Date: Thu, 2 Sep 2021 11:14:02 -0400
Subject: [PATCH 165/166] feat: new improved scene manager  (#892)

Co-authored-by: James Frowen <jamesfrowendev@gmail.com>
Co-authored-by: dragonslaya <dragonslaya.ss@gmail.com>

BREAKING CHANGE: NetworkSceneManager has been re-written, many events and methods now have new names.
---
 Assets/Mirage/Runtime/CharacterSpawner.cs     |  18 +-
 Assets/Mirage/Runtime/ClientObjectManager.cs  |   4 +-
 Assets/Mirage/Runtime/INetworkPlayer.cs       |   5 +-
 Assets/Mirage/Runtime/INetworkSceneManager.cs |  31 +-
 Assets/Mirage/Runtime/Messages.cs             |   7 +-
 Assets/Mirage/Runtime/NetworkIdentity.cs      |  12 +-
 Assets/Mirage/Runtime/NetworkPlayer.cs        |   6 +-
 Assets/Mirage/Runtime/NetworkSceneManager.cs  | 625 +++++++++++++-----
 Assets/Mirage/Runtime/ServerObjectManager.cs  |  18 +-
 .../AdditiveScenes/Scripts/ZoneHandler.cs     |   4 +-
 .../Samples~/ChangeScene/Scenes/Main.unity    | 149 +++--
 .../ChangeScene/Scripts/SceneSwitcherHud.cs   |  15 +-
 .../Scripts/MultiSceneNetManager.cs           |   5 +-
 Assets/Mirage/package.json                    |   2 +-
 .../Editor/NetworkIdentityCallbackTests.cs    |   8 +-
 .../ClientServer/NetworkSceneManagerTests.cs  |  90 ++-
 .../ClientServer/NetworkServerTests.cs        |   4 +-
 .../ClientServer/ServerObjectManagerTests.cs  |   2 +-
 .../Runtime/Host/CharacterSpawnerTest.cs      |   2 +-
 .../Tests/Runtime/Host/HostComponentTests.cs  |   2 +-
 .../Runtime/Host/NetworkSceneManagerTests.cs  | 210 +++++-
 .../Runtime/Host/ServerObjectManagerTest.cs   |  14 +-
 Assets/Tests/Runtime/MessagePackerTest.cs     |  16 +-
 .../Runtime/NetworkIdentityCallbackTests.cs   |   8 +-
 .../Tests/Runtime/NetworkMatchCheckerTest.cs  |   2 +-
 doc/Articles/Guides/MirrorMigration.md        |   4 +-
 26 files changed, 909 insertions(+), 354 deletions(-)

diff --git a/Assets/Mirage/Runtime/CharacterSpawner.cs b/Assets/Mirage/Runtime/CharacterSpawner.cs
index e32c6eec930..b4d8d27bfff 100644
--- a/Assets/Mirage/Runtime/CharacterSpawner.cs
+++ b/Assets/Mirage/Runtime/CharacterSpawner.cs
@@ -43,11 +43,11 @@ public virtual void Awake()
             {
                 if (SceneManager != null)
                 {
-                    SceneManager.ClientSceneChanged.AddListener(OnClientSceneChanged);
+                    SceneManager.OnClientFinishedSceneChange.AddListener(OnClientFinishedSceneChange);
                 }
                 else
                 {
-                    Client.Authenticated.AddListener(c => Client.Send(new AddCharacterMessage()));
+                    Client.Authenticated.AddListener(OnClientAuthenticated);
                 }
 
                 if (ClientObjectManager != null)
@@ -73,8 +73,8 @@ void OnDestroy()
         {
             if (Client != null && SceneManager != null)
             {
-                SceneManager.ClientSceneChanged.RemoveListener(OnClientSceneChanged);
-                Client.Authenticated.RemoveListener(c => Client.Send(new AddCharacterMessage()));
+                SceneManager.OnClientFinishedSceneChange.RemoveListener(OnClientFinishedSceneChange);
+                Client.Authenticated.RemoveListener(OnClientAuthenticated);
             }
             if (Server != null)
             {
@@ -82,6 +82,11 @@ void OnDestroy()
             }
         }
 
+        private void OnClientAuthenticated(INetworkPlayer _)
+        {
+            Client.Send(new AddCharacterMessage());
+        }
+
         private void OnServerStarted()
         {
             Server.MessageHandler.RegisterHandler<AddCharacterMessage>(OnServerAddPlayerInternal);
@@ -91,8 +96,9 @@ private void OnServerStarted()
         /// Called on the client when a normal scene change happens.
         /// <para>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.</para>
         /// </summary>
-        /// <param name="conn">Connection to the server.</param>
-        private void OnClientSceneChanged(string sceneName, SceneOperation sceneOperation)
+        /// <param name="scenePath"></param>
+        /// <param name="sceneOperation">The type of scene load that happened.</param>
+        public virtual void OnClientFinishedSceneChange(string scenePath, SceneOperation sceneOperation)
         {
             if (AutoSpawn && sceneOperation == SceneOperation.Normal)
                 RequestServerSpawnPlayer();
diff --git a/Assets/Mirage/Runtime/ClientObjectManager.cs b/Assets/Mirage/Runtime/ClientObjectManager.cs
index b9bbc0a0fd6..a1024f1734b 100644
--- a/Assets/Mirage/Runtime/ClientObjectManager.cs
+++ b/Assets/Mirage/Runtime/ClientObjectManager.cs
@@ -57,7 +57,7 @@ public void Start()
                 Client.Disconnected.AddListener(OnClientDisconnected);
 
                 if (NetworkSceneManager != null)
-                    NetworkSceneManager.ClientSceneChanged.AddListener(OnClientSceneChanged);
+                    NetworkSceneManager.OnClientFinishedSceneChange.AddListener(OnFinishedSceneChange);
             }
         }
 
@@ -87,7 +87,7 @@ void OnClientDisconnected(ClientStoppedReason reason)
             syncVarReceiver = null;
         }
 
-        void OnClientSceneChanged(string scenePath, SceneOperation sceneOperation)
+        void OnFinishedSceneChange(string scenePath, SceneOperation sceneOperation)
         {
             PrepareToSpawnSceneObjects();
         }
diff --git a/Assets/Mirage/Runtime/INetworkPlayer.cs b/Assets/Mirage/Runtime/INetworkPlayer.cs
index 40b982d7c1a..87aed2f941f 100644
--- a/Assets/Mirage/Runtime/INetworkPlayer.cs
+++ b/Assets/Mirage/Runtime/INetworkPlayer.cs
@@ -81,6 +81,9 @@ public interface IAuthenticatedObject
 
     public interface ISceneLoader
     {
-        bool IsReady { get; set; }
+        /// <summary>
+        ///     Scene is fully loaded and we now can do things with player.
+        /// </summary>
+        bool SceneIsReady { get; set; }
     }
 }
diff --git a/Assets/Mirage/Runtime/INetworkSceneManager.cs b/Assets/Mirage/Runtime/INetworkSceneManager.cs
index ea81c11687c..32a6c6ab115 100644
--- a/Assets/Mirage/Runtime/INetworkSceneManager.cs
+++ b/Assets/Mirage/Runtime/INetworkSceneManager.cs
@@ -1,5 +1,7 @@
 using System;
+using System.Collections.Generic;
 using UnityEngine.Events;
+using UnityEngine.SceneManagement;
 
 namespace Mirage
 {
@@ -22,23 +24,42 @@ public interface INetworkSceneManager
         /// <summary>
         /// Event fires when the Client starts changing scene.
         /// </summary>
-        SceneChangeEvent ClientChangeScene { get; }
+        SceneChangeEvent OnClientStartedSceneChange { get; }
 
         /// <summary>
         /// Event fires after the Client has completed its scene change.
         /// </summary>
-        SceneChangeEvent ClientSceneChanged { get; }
+        SceneChangeEvent OnClientFinishedSceneChange { get; }
 
         /// <summary>
         /// Event fires before Server changes scene.
         /// </summary>
-        SceneChangeEvent ServerChangeScene { get; }
+        SceneChangeEvent OnServerStartedSceneChange { get; }
 
         /// <summary>
         /// Event fires after Server has completed scene change.
         /// </summary>
-        SceneChangeEvent ServerSceneChanged { get; }
+        SceneChangeEvent OnServerFinishedSceneChange { get; }
 
-        void ChangeServerScene(string scenePath, SceneOperation sceneOperation = SceneOperation.Normal);
+        /// <summary>
+        ///     Allows server to fully load in a new scene and override current active scene.
+        /// </summary>
+        /// <param name="scenePath">The full path to the scene file or the name of the scene.</param>
+        void ServerLoadSceneNormal(string scenePath);
+
+        /// <summary>
+        ///     Allows server to fully load in another scene on top of current active scene.
+        /// </summary>
+        /// <param name="scenePath">The full path to the scene file or the name of the scene.</param>
+        /// <param name="players">List of player's that are receiving the new scene load.</param>
+        /// <param name="shouldClientLoadNormally">Should the clients load this additively too or load it full normal scene change.</param>
+        void ServerLoadSceneAdditively(string scenePath, IEnumerable<INetworkPlayer> players, bool shouldClientLoadNormally = false);
+
+        /// <summary>
+        ///     Allows server to fully unload a scene additively.
+        /// </summary>
+        /// <param name="scene">The scene handle which we want to unload additively.</param>
+        /// <param name="players">List of player's that are receiving the new scene unload.</param>
+        void ServerUnloadSceneAdditively(Scene scene, IEnumerable<INetworkPlayer> players);
     }
 }
diff --git a/Assets/Mirage/Runtime/Messages.cs b/Assets/Mirage/Runtime/Messages.cs
index fb20a172f78..b4fb0c0d625 100644
--- a/Assets/Mirage/Runtime/Messages.cs
+++ b/Assets/Mirage/Runtime/Messages.cs
@@ -1,4 +1,5 @@
 using System;
+using System.Collections.Generic;
 using UnityEngine;
 
 namespace Mirage
@@ -18,10 +19,10 @@ public struct AddCharacterMessage { }
     [NetworkMessage]
     public struct SceneMessage
     {
-        public string scenePath;
+        public string MainActivateScene;
         // Normal = 0, LoadAdditive = 1, UnloadAdditive = 2
-        public SceneOperation sceneOperation;
-        public string[] additiveScenes;
+        public SceneOperation SceneOperation;
+        public List<string> AdditiveScenes;
     }
 
     [NetworkMessage]
diff --git a/Assets/Mirage/Runtime/NetworkIdentity.cs b/Assets/Mirage/Runtime/NetworkIdentity.cs
index 9ee7f2e4d9c..0e2872bb0db 100644
--- a/Assets/Mirage/Runtime/NetworkIdentity.cs
+++ b/Assets/Mirage/Runtime/NetworkIdentity.cs
@@ -1009,12 +1009,12 @@ internal void AddAllReadyServerConnectionsToObservers()
             // add all server connections
             foreach (INetworkPlayer player in Server.Players)
             {
-                if (player.IsReady)
+                if (player.SceneIsReady)
                     AddObserver(player);
             }
 
             // add local host connection (if any)
-            if (Server.LocalPlayer != null && Server.LocalPlayer.IsReady)
+            if (Server.LocalPlayer != null && Server.LocalPlayer.SceneIsReady)
             {
                 AddObserver(Server.LocalPlayer);
             }
@@ -1038,7 +1038,7 @@ public void RebuildObservers(bool initialize)
             // -> 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 (ConnectionToClient != null && ConnectionToClient.IsReady)
+            if (ConnectionToClient != null && ConnectionToClient.SceneIsReady)
             {
                 newObservers.Add(ConnectionToClient);
             }
@@ -1064,7 +1064,7 @@ public void RebuildObservers(bool initialize)
                 observers.Clear();
                 foreach (INetworkPlayer player in newObservers)
                 {
-                    if (player != null && player.IsReady)
+                    if (player != null && player.SceneIsReady)
                         observers.Add(player);
                 }
             }
@@ -1096,7 +1096,7 @@ bool AddNewObservers(bool initialize, bool changed)
             {
                 // only add ready connections.
                 // otherwise the player might not be in the world yet or anymore
-                if (player != null && player.IsReady && (initialize || !observers.Contains(player)))
+                if (player != null && player.SceneIsReady && (initialize || !observers.Contains(player)))
                 {
                     // new observer
                     player.AddToVisList(this);
@@ -1247,7 +1247,7 @@ void SendUpdateVarsMessage()
                     if (ownerWritten > 0)
                     {
                         varsMessage.payload = ownerWriter.ToArraySegment();
-                        if (ConnectionToClient != null && ConnectionToClient.IsReady)
+                        if (ConnectionToClient != null && ConnectionToClient.SceneIsReady)
                             ConnectionToClient.Send(varsMessage);
                     }
 
diff --git a/Assets/Mirage/Runtime/NetworkPlayer.cs b/Assets/Mirage/Runtime/NetworkPlayer.cs
index 17a998e5480..ba70331755c 100644
--- a/Assets/Mirage/Runtime/NetworkPlayer.cs
+++ b/Assets/Mirage/Runtime/NetworkPlayer.cs
@@ -52,11 +52,11 @@ public sealed class NetworkPlayer : INetworkPlayer, IMessageSender
         public object AuthenticationData { get; set; }
 
         /// <summary>
-        /// Flag that tells if the connection has been marked as "ready" by a client calling ClientScene.Ready().
-        /// <para>This property is read-only. It is set by the system on the client when ClientScene.Ready() is called, and set by the system on the server when a ready message is received from a client.</para>
+        /// Flag that tells us if the scene has fully loaded in for player.
+        /// <para>This property is read-only. It is set by the system on the client when the scene has fully loaded, and set by the system on the server when a ready message is received from a client.</para>
         /// <para>A client that is ready is sent spawned objects by the server and updates to the state of spawned objects. A client that is not ready is not sent spawned objects.</para>
         /// </summary>
-        public bool IsReady { get; set; }
+        public bool SceneIsReady { get; set; }
 
         /// <summary>
         /// The IP address / URL / FQDN associated with the connection.
diff --git a/Assets/Mirage/Runtime/NetworkSceneManager.cs b/Assets/Mirage/Runtime/NetworkSceneManager.cs
index e70d47de632..9d7e4ee2a8a 100644
--- a/Assets/Mirage/Runtime/NetworkSceneManager.cs
+++ b/Assets/Mirage/Runtime/NetworkSceneManager.cs
@@ -1,5 +1,6 @@
 using System;
 using System.Collections.Generic;
+using System.Linq;
 using Cysharp.Threading.Tasks;
 using Mirage.Logging;
 using UnityEngine;
@@ -19,161 +20,236 @@ namespace Mirage
     [DisallowMultipleComponent]
     public class NetworkSceneManager : MonoBehaviour, INetworkSceneManager
     {
+        #region Fields
+
         static readonly ILogger logger = LogFactory.GetLogger(typeof(NetworkSceneManager));
 
+        [Header("Setup Settings")]
+
         [FormerlySerializedAs("client")]
         public NetworkClient Client;
+
         [FormerlySerializedAs("server")]
         public NetworkServer Server;
 
         /// <summary>
-        /// Sets the NetworksSceneManagers GameObject to DontDestroyOnLoad. Default = true.
+        ///     Sets the NetworksSceneManagers GameObject to DontDestroyOnLoad. Default = true.
         /// </summary>
         public bool DontDestroy = true;
 
+        private readonly Dictionary<Scene, HashSet<INetworkPlayer>> _serverSceneData = new Dictionary<Scene, HashSet<INetworkPlayer>>();
+
+        /// <summary>
+        /// The path of the current active scene.
+        /// <para>If using additive scenes this will be the first scene.</para>
+        /// <para>Value from  <see cref="SceneManager.GetActiveScene()"/> </para>
+        /// </summary>
+        /// <remarks>
+        /// <para>New clients that connect to a server will automatically load this scene.</para>
+        /// <para>This is used to make sure that all scene changes are initialized by Mirage.</para>
+        /// </remarks>
+        public string ActiveScenePath => SceneManager.GetActiveScene().path;
+
+        /// <summary>
+        /// Used by the client to load the full additive scene list that the server has upon connection
+        /// </summary>
+        internal readonly List<string> ClientPendingAdditiveSceneLoadingList = new List<string>();
+
+        /// <summary>
+        ///     Information on any scene that is currently being loaded.
+        /// </summary>
+        public AsyncOperation SceneLoadingAsyncOperationInfo;
+
+
+        /// <summary>
+        ///     Collection of scenes and which player's are in those scenes.
+        /// </summary>
+        public IReadOnlyDictionary<Scene, HashSet<INetworkPlayer>> ServerSceneData => _serverSceneData;
+
+        #endregion
+
+        #region Events
+
         [Header("Events")]
 
         [FormerlySerializedAs("ClientChangeScene")]
-        [SerializeField] SceneChangeEvent _clientChangeScene = new SceneChangeEvent();
+        [SerializeField] SceneChangeEvent _onClientStartedSceneChange = new SceneChangeEvent();
 
         [FormerlySerializedAs("ClientSceneChanged")]
-        [SerializeField] SceneChangeEvent _clientSceneChanged = new SceneChangeEvent();
+        [SerializeField] SceneChangeEvent _onClientFinishedSceneChange = new SceneChangeEvent();
 
         [FormerlySerializedAs("ServerChangeScene")]
-        [SerializeField] SceneChangeEvent _serverChangeScene = new SceneChangeEvent();
+        [SerializeField] SceneChangeEvent _onServerStartedSceneChange = new SceneChangeEvent();
 
         [FormerlySerializedAs("ServerSceneChanged")]
-        [SerializeField] SceneChangeEvent _serverSceneChanged = new SceneChangeEvent();
+        [SerializeField] SceneChangeEvent _onServerFinishedSceneChange = new SceneChangeEvent();
 
         /// <summary>
         /// Event fires when the Client starts changing scene.
         /// </summary>
-        public SceneChangeEvent ClientChangeScene => _clientChangeScene;
+        public SceneChangeEvent OnClientStartedSceneChange => _onClientStartedSceneChange;
 
         /// <summary>
         /// Event fires after the Client has completed its scene change.
         /// </summary>
-        public SceneChangeEvent ClientSceneChanged => _clientSceneChanged;
+        public SceneChangeEvent OnClientFinishedSceneChange => _onClientFinishedSceneChange;
 
         /// <summary>
         /// Event fires before Server changes scene.
         /// </summary>
-        public SceneChangeEvent ServerChangeScene => _serverChangeScene;
+        public SceneChangeEvent OnServerStartedSceneChange => _onServerStartedSceneChange;
 
         /// <summary>
         /// Event fires after Server has completed scene change.
         /// </summary>
-        public SceneChangeEvent ServerSceneChanged => _serverSceneChanged;
+        public SceneChangeEvent OnServerFinishedSceneChange => _onServerFinishedSceneChange;
 
-        /// <summary>
-        /// The path of the current active scene.
-        /// <para>If using additive scenes this will be the first scene.</para>
-        /// <para>Value from  <see cref="SceneManager.GetActiveScene()"/> </para>
-        /// </summary>
-        /// <remarks>
-        /// <para>New clients that connect to a server will automatically load this scene.</para>
-        /// <para>This is used to make sure that all scene changes are initialized by Mirage.</para>
-        /// </remarks>
-        public string ActiveScenePath => SceneManager.GetActiveScene().path;
-
-        AsyncOperation clientLoadingOperation;
-
-        /// <summary>
-        /// Used by the server to track all additive scenes. To notify clients upon connection 
-        /// </summary>
-        internal List<string> additiveSceneList = new List<string>();
+        #endregion
 
-        /// <summary>
-        /// Used by the client to load the full additive scene list that the server has upon connection
-        /// </summary>
-        internal List<string> pendingAdditiveSceneList = new List<string>();
+        #region Unity Methods
 
-        public void Start()
+        public virtual void Start()
         {
             if (DontDestroy)
                 DontDestroyOnLoad(gameObject);
 
             if (Client != null)
-            {
                 Client.Started.AddListener(RegisterClientMessages);
-            }
+
             if (Server != null)
             {
                 Server.Authenticated.AddListener(OnServerAuthenticated);
+                Server.Disconnected.AddListener(OnServerPlayerDisconnected);
             }
         }
 
-        void OnDestroy()
+        public virtual void OnDestroy()
         {
             if (Client != null)
                 Client.Started.RemoveListener(RegisterClientMessages);
+
+            if (Server != null)
+                Server.Authenticated.RemoveListener(OnServerAuthenticated);
         }
 
-        #region Client
+        #endregion
 
-        void RegisterClientMessages()
-        {
-            Client.MessageHandler.RegisterHandler<SceneMessage>(ClientSceneMessage);
-            if (!Client.IsLocalClient)
-            {
-                Client.MessageHandler.RegisterHandler<SceneReadyMessage>(ClientSceneReadyMessage);
-                Client.MessageHandler.RegisterHandler<NotReadyMessage>(ClientNotReadyMessage);
-            }
-        }
+        #region Scene Data Methods
 
-        internal void ClientSceneMessage(INetworkPlayer player, SceneMessage msg)
+        /// <summary>
+        ///     Check whether or not the player is in a specific scene or not.
+        /// </summary>
+        /// <param name="sceneHandler">The scene handler id we want to check in.</param>
+        /// <param name="player">The player we want to check for.</param>
+        /// <returns>Returns true or false if the player is in the scene specified.</returns>
+        public bool IsPlayerInScene(Scene scene, INetworkPlayer player)
         {
-            if (!Client.IsConnected)
+            if (!scene.IsValid())
+                throw new ArgumentException("Scene is not valid", nameof(scene));
+
+            if (!ServerSceneData.TryGetValue(scene, out HashSet<INetworkPlayer> players))
             {
-                throw new InvalidOperationException("ClientSceneMessage: cannot change network scene while client is disconnected");
+                throw new KeyNotFoundException($"Could not find player list for scene:{scene}");
             }
-            if (string.IsNullOrEmpty(msg.scenePath))
+
+            foreach (INetworkPlayer networkPlayer in players)
             {
-                throw new ArgumentNullException(nameof(msg.scenePath), $"ClientSceneMessage: {nameof(msg.scenePath)} cannot be empty or null");
+                if (!networkPlayer.Equals(player)) continue;
+
+                return true;
             }
 
-            if (logger.LogEnabled()) logger.Log($"ClientSceneMessage: changing scenes from: {ActiveScenePath} to: {msg.scenePath}");
+            return false;
+        }
 
-            //Additive are scenes loaded on server and this client is not a host client
-            if (msg.additiveScenes != null && msg.additiveScenes.Length > 0 && Client && !Client.IsLocalClient)
+        /// <summary>
+        ///     What scene is this specific player currently in.
+        /// </summary>
+        /// <param name="player">The player we want to check against.</param>
+        /// <returns>Returns back a array of scene's the player is currently in.</returns>
+        public Scene[] ScenesPlayerIsIn(INetworkPlayer player)
+        {
+            var data = new List<Scene>();
+            ScenesPlayerIsInNonAlloc(player, data);
+            return data.ToArray();
+        }
+        public void ScenesPlayerIsInNonAlloc(INetworkPlayer player, List<Scene> scenes)
+        {
+            foreach (KeyValuePair<Scene, HashSet<INetworkPlayer>> scene in _serverSceneData)
             {
-                foreach (string scene in msg.additiveScenes)
-                {
-                    pendingAdditiveSceneList.Add(scene);
-                }
+                if (scene.Value.Contains(player))
+                    scenes.Add(scene.Key);
             }
+        }
 
-            // Let client prepare for scene change
-            OnClientChangeScene(msg.scenePath, msg.sceneOperation);
+        #endregion
 
-            ApplyOperationAsync(msg.scenePath, msg.sceneOperation).Forget();
-        }
+        #region Client Side
 
-        internal void ClientSceneReadyMessage(INetworkPlayer player, SceneReadyMessage msg)
+        /// <summary>
+        ///     Register incoming client messages.
+        /// </summary>
+        private void RegisterClientMessages()
         {
-            logger.Log("ClientSceneReadyMessage");
+            Client.MessageHandler.RegisterHandler<SceneMessage>(ClientStartSceneMessage);
 
-            //Server has finished changing scene. Allow the client to finish.
-            if (clientLoadingOperation != null)
-                clientLoadingOperation.allowSceneActivation = true;
+            if (Client.IsLocalClient) return;
+
+            Client.MessageHandler.RegisterHandler<SceneReadyMessage>(ClientFinishedLoadingSceneMessage);
+            Client.MessageHandler.RegisterHandler<NotReadyMessage>(ClientNotReadyMessage);
         }
 
-        internal void ClientNotReadyMessage(INetworkPlayer player, NotReadyMessage msg)
+        /// <summary>
+        ///     Received message from server to start loading scene or scenes.
+        ///
+        ///     <para>Default implementation is to load main activate scene server is using and load any
+        ///     other additive scenes in background and notify event handler. If this is not intended
+        ///     behavior you need please override this function.</para>
+        /// </summary>
+        /// <param name="player"></param>
+        /// <param name="message"></param>
+        public virtual void ClientStartSceneMessage(INetworkPlayer player, SceneMessage message)
         {
-            logger.Log("NetworkSceneManager.OnClientNotReadyMessageInternal");
+            if (!Client.IsConnected)
+                throw new InvalidOperationException("[NetworkSceneManager] - SceneLoadStartedMessage: cannot change network scene while client is disconnected");
+
+            if (string.IsNullOrEmpty(message.MainActivateScene))
+                throw new ArgumentException($"[NetworkSceneManager] - SceneLoadStartedMessage: {nameof(message.MainActivateScene)} cannot be empty or null", nameof(message));
 
-            Client.Player.IsReady = false;
+            if (logger.LogEnabled()) logger.Log($"[NetworkSceneManager] - SceneLoadStartedMessage: changing scenes from: {ActiveScenePath} to: {message.MainActivateScene}");
+
+            //Additive are scenes loaded on server and this client is not a host client
+            if (message.AdditiveScenes != null && message.AdditiveScenes.Count > 0 && Client && !Client.IsLocalClient)
+            {
+                for (int sceneIndex = 0; sceneIndex < message.AdditiveScenes.Count; sceneIndex++)
+                {
+                    if (string.IsNullOrEmpty(message.AdditiveScenes[sceneIndex])) continue;
+
+                    ClientPendingAdditiveSceneLoadingList.Add(message.AdditiveScenes[sceneIndex]);
+                }
+            }
+
+            // Notify others that client has started to change scenes.
+            OnClientStartedSceneChange?.Invoke(message.MainActivateScene, message.SceneOperation);
+
+            LoadSceneAsync(message.MainActivateScene, new[] { player }, message.SceneOperation).Forget();
         }
 
         /// <summary>
-        /// Called from ClientChangeScene immediately before SceneManager.LoadSceneAsync is executed
-        /// <para>This allows client to do work / cleanup / prep before the scene changes.</para>
+        ///     Received message from server that it has finished loading the scene.
+        ///
+        ///     <para>Default implementation will set AllowSceneActivation = true and invoke event handler.
+        ///     If this is not good enough intended behavior then override this method.</para>
         /// </summary>
-        /// <param name="scenePath">Path of the scene that's about to be loaded</param>
-        /// <param name="sceneOperation">Scene operation that's about to happen</param>
-        internal void OnClientChangeScene(string scenePath, SceneOperation sceneOperation)
+        /// <param name="player">The player who sent the message.</param>
+        /// <param name="message">The message data coming back from server.</param>
+        protected internal virtual void ClientFinishedLoadingSceneMessage(INetworkPlayer player, SceneReadyMessage message)
         {
-            ClientChangeScene?.Invoke(scenePath, sceneOperation);
+            logger.Log("[NetworkSceneManager] - ClientSceneReadyMessage");
+
+            //Server has finished changing scene. Allow the client to finish.
+            if (SceneLoadingAsyncOperationInfo != null)
+                SceneLoadingAsyncOperationInfo.allowSceneActivation = true;
         }
 
         /// <summary>
@@ -182,21 +258,41 @@ internal void OnClientChangeScene(string scenePath, SceneOperation sceneOperatio
         /// </summary>
         /// <param name="scenePath">Path of the scene that was just loaded</param>
         /// <param name="sceneOperation">Scene operation that was just  happen</param>
-        internal void OnClientSceneChanged(string scenePath, SceneOperation sceneOperation)
+        internal void OnClientSceneLoadFinished(string scenePath, SceneOperation sceneOperation)
         {
-            if (pendingAdditiveSceneList.Count > 0 && Client && !Client.IsLocalClient)
+            if (ClientPendingAdditiveSceneLoadingList.Count > 0 && Client && !Client.IsLocalClient)
             {
-                ApplyOperationAsync(pendingAdditiveSceneList[0], SceneOperation.LoadAdditive).Forget();
-                pendingAdditiveSceneList.RemoveAt(0);
+                if (string.IsNullOrEmpty(ClientPendingAdditiveSceneLoadingList[0]))
+                    throw new ArgumentNullException(nameof(scenePath), "Some how a null scene path has been entered.");
+
+                LoadSceneAsync(ClientPendingAdditiveSceneLoadingList[0], new[] { Client.Player }, SceneOperation.LoadAdditive).Forget();
+
+                ClientPendingAdditiveSceneLoadingList.RemoveAt(0);
+
                 return;
             }
 
             //set ready after scene change has completed
-            if (!Client.Player.IsReady)
-                SetClientReady();
+            if (!Client.Player.SceneIsReady)
+                SetSceneIsReady();
 
             //Call event once all scene related actions (subscenes and ready) are done.
-            ClientSceneChanged?.Invoke(scenePath, sceneOperation);
+            OnClientFinishedSceneChange?.Invoke(scenePath, sceneOperation);
+        }
+
+        /// <summary>
+        ///     Received message that player is not ready.
+        ///
+        ///     <para>Default implementation is to set player to not ready.</para>
+        /// </summary>
+        /// <param name="player">The player that is currently not ready.</param>
+        /// <param name="message">The message data coming in.</param>
+        protected internal virtual void ClientNotReadyMessage(INetworkPlayer player, NotReadyMessage message)
+        {
+            if (logger.LogEnabled())
+                logger.Log("[NetworkSceneManager] - OnClientNotReadyMessageInternal");
+
+            Client.Player.SceneIsReady = false;
         }
 
         /// <summary>
@@ -204,16 +300,16 @@ internal void OnClientSceneChanged(string scenePath, SceneOperation sceneOperati
         /// <para>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 message with an appropriate handler which instantiates the players object for example.</para>
         /// </summary>
         /// <exception cref="InvalidOperationException">When called with an null or disconnected client</exception>
-        public void SetClientReady()
+        public void SetSceneIsReady()
         {
             if (!Client || !Client.Active)
-                throw new InvalidOperationException("Ready() called with an null or disconnected client");
+                throw new InvalidOperationException("[NetworkSceneManager] - Scene ready called with an null or disconnected client");
 
-            if (logger.LogEnabled()) logger.Log("ClientScene.Ready() called.");
+            if (logger.LogEnabled()) logger.Log("[NetworkSceneManager] - Scene is loaded and ready has been called.");
 
             // Set these before sending the ReadyMessage, otherwise host client
             // will fail in InternalAddPlayer with null readyConnection.
-            Client.Player.IsReady = true;
+            Client.Player.SceneIsReady = true;
 
             // Tell server we're ready to have a player object spawned
             Client.Player.Send(new ReadyMessage());
@@ -221,132 +317,331 @@ public void SetClientReady()
 
         #endregion
 
-        #region Server
+        #region Server Side
 
-        // called after successful authentication
-        void OnServerAuthenticated(INetworkPlayer player)
+        /// <summary>
+        ///     Allows server to fully load new scene or additive load in another scene.
+        /// </summary>
+        /// <param name="scenePath">The full path to the scenes files or the names of the scenes.</param>
+        /// <param name="players">List of player's we want to send the new scene loading or unloading to.</param>
+        /// <param name="shouldClientLoadOrUnloadNormally">Should client load or unload the scene in normal non additive way</param>
+        /// <param name="sceneOperation">Choose type of scene loading we are doing <see cref="SceneOperation"/>.</param>
+        private void ServerSceneLoading(string scenePath, IEnumerable<INetworkPlayer> players,
+            bool shouldClientLoadOrUnloadNormally, SceneOperation sceneOperation = SceneOperation.Normal)
         {
-            logger.Log("NetworkSceneManager.OnServerAuthenticated");
+            if (string.IsNullOrEmpty(scenePath))
+            {
+                throw new ArgumentNullException(nameof(scenePath),
+                    "[NetworkSceneManager] - ServerChangeScene: " + nameof(scenePath) + " cannot be empty or null");
+            }
 
-            player.Send(new SceneMessage { scenePath = ActiveScenePath, additiveScenes = additiveSceneList.ToArray() });
-            player.Send(new SceneReadyMessage());
+            if (logger.LogEnabled()) logger.Log("[NetworkSceneManager] - ServerChangeScene " + scenePath);
+
+            // Let server prepare for scene change
+            logger.Log("[NetworkSceneManager] - OnServerChangeScene");
+
+            OnServerStartedSceneChange?.Invoke(scenePath, sceneOperation);
+
+            if (players == null)
+                throw new ArgumentNullException(nameof(players), "No player's were added to send for information");
+
+            if (!Server.LocalClientActive)
+                LoadSceneAsync(scenePath, players, sceneOperation).Forget();
+
+            // notify all clients about the new scene
+            if (shouldClientLoadOrUnloadNormally)
+            {
+                sceneOperation = SceneOperation.Normal;
+            }
+
+            var message = new SceneMessage { MainActivateScene = scenePath, SceneOperation = sceneOperation };
+            NetworkServer.SendToMany(players, message);
         }
 
         /// <summary>
-        /// This causes the server to switch scenes and sets the ActiveScenePath.
-        /// <para>Clients that connect to this server will automatically switch to this scene. This automatically sets clients to be not-ready. The clients must call Ready() again to participate in the new scene.</para>
+        /// 
         /// </summary>
-        /// <param name="scenePath"></param>
-        /// <param name="operation"></param>
-        /// <exception cref="ArgumentNullException">Scene path was not valid.</exception>
-        public void ChangeServerScene(string scenePath, SceneOperation sceneOperation = SceneOperation.Normal)
+        /// <param name="scene"></param>
+        /// <param name="players"></param>
+        private void ServerSceneUnLoading(Scene scene, IEnumerable<INetworkPlayer> players)
         {
-            if (string.IsNullOrEmpty(scenePath))
-            {
-                throw new ArgumentNullException(nameof(scenePath), "ServerChangeScene: " + nameof(scenePath) + " cannot be empty or null");
-            }
+            if (scene.handle == 0)
+                throw new ArgumentNullException(nameof(scene),
+                    "[NetworkSceneManager] - ServerChangeScene: " + nameof(scene) + " cannot be null");
+
+            if (players == null || !players.Any())
+                throw new ArgumentNullException(nameof(players),
+                    "[NetworkSceneManager] - list of player's cannot be null or no players.");
 
-            if (logger.LogEnabled()) logger.Log("ServerChangeScene " + scenePath);
+            if (logger.LogEnabled()) logger.Log("[NetworkSceneManager] - ServerChangeScene " + scene.name);
 
             // Let server prepare for scene change
-            OnServerChangeScene(scenePath, sceneOperation);
+            if (logger.LogEnabled()) logger.Log("[NetworkSceneManager] - OnServerChangeScene");
 
+            OnServerStartedSceneChange?.Invoke(scene.path, SceneOperation.UnloadAdditive);
+
+            // if not host
             if (!Server.LocalClientActive)
-                ApplyOperationAsync(scenePath, sceneOperation).Forget();
+                UnLoadSceneAsync(scene, SceneOperation.UnloadAdditive).Forget();
 
             // notify all clients about the new scene
-            Server.SendToAll(new SceneMessage { scenePath = scenePath, sceneOperation = sceneOperation });
+            var msg = new SceneMessage { MainActivateScene = scene.path, SceneOperation = SceneOperation.UnloadAdditive };
+            NetworkServer.SendToMany(players, msg);
         }
 
         /// <summary>
-        /// Called from ChangeServerScene immediately before NetworkSceneManager's LoadSceneAsync is executed
-        /// <para>This allows server to do work / cleanup / prep before the scene changes.</para>
+        ///     Allows server to fully load in a new scene and override current active scene.
         /// </summary>
-        /// <param name="scenePath">Path of the scene that's about to be loaded</param>
-        internal void OnServerChangeScene(string scenePath, SceneOperation operation)
+        /// <param name="scenePath">The full path to the scene file or the name of the scene.</param>
+        public void ServerLoadSceneNormal(string scenePath)
         {
-            logger.Log("OnServerChangeScene");
+            if (!Server && !Server.Active) throw new InvalidOperationException("[NetworkSceneManager] - Server is null or server is currently not active.");
 
-            ServerChangeScene?.Invoke(scenePath, operation);
+            ServerSceneLoading(scenePath, Server.Players, true);
         }
 
         /// <summary>
-        /// Called on the server when a scene is completed loaded, when the scene load was initiated by the server with ChangeServerScene().
+        ///     Allows server to fully load in another scene on top of current active scene.
+        /// </summary>
+        /// <param name="scenePath">The full path to the scene file or the name of the scene.</param>
+        /// <param name="players">Collection of player's that are receiving the new scene load.</param>
+        /// <param name="shouldClientLoadNormally">Should the clients load this additively too or load it full normal scene change.</param>
+        public void ServerLoadSceneAdditively(string scenePath, IEnumerable<INetworkPlayer> players, bool shouldClientLoadNormally = false)
+        {
+            if (!Server && !Server.Active) return;
+
+            ServerSceneLoading(scenePath, players, shouldClientLoadNormally, SceneOperation.LoadAdditive);
+        }
+
+        /// <summary>
+        ///     Allows server to fully unload a scene additively.
+        /// </summary>
+        /// <param name="scene">The scene handle which we want to unload additively.</param>
+        /// <param name="players">Collection of player's that are receiving the new scene unload.</param>
+        public void ServerUnloadSceneAdditively(Scene scene, IEnumerable<INetworkPlayer> players)
+        {
+            if (Server == null || !Server.Active) throw new InvalidOperationException("Server is not active or is null");
+
+            ServerSceneUnLoading(scene, players);
+        }
+
+        /// <summary>
+        ///     When player authenticates to server we send a message to them to load up main scene and
+        ///     any other scenes that are loaded on server.
+        ///
+        ///     <para>Default implementation takes main activate scene as main and any other loaded scenes and sends it to player's
+        ///     Please override this function if this is not intended behavior for you.</para>
+        /// </summary>
+        /// <param name="player">The current player that finished authenticating.</param>
+        public virtual void OnServerAuthenticated(INetworkPlayer player)
+        {
+            logger.Log("[NetworkSceneManager] - OnServerAuthenticated");
+
+            List<string> additiveScenes = GetAdditiveScenes();
+
+            player.Send(new SceneMessage { MainActivateScene = ActiveScenePath, AdditiveScenes = additiveScenes });
+            player.Send(new SceneReadyMessage());
+
+        }
+        static List<string> GetAdditiveScenes()
+        {
+            var additiveScenes = new List<string>(SceneManager.sceneCount - 1);
+
+            // add all scenes exect active to additive list
+            Scene activeScene = SceneManager.GetActiveScene();
+            for (int sceneIndex = 0; sceneIndex < SceneManager.sceneCount; sceneIndex++)
+            {
+                Scene scene = SceneManager.GetSceneAt(sceneIndex);
+                if (scene != activeScene)
+                {
+                    additiveScenes.Add(scene.path);
+                }
+            }
+
+            return additiveScenes;
+        }
+
+        /// <summary>
+        ///     Called on the server when a scene is completed loaded, when the scene load was initiated by the server with ChangeServerScene().
         /// </summary>
         /// <param name="scenePath">The name of the new scene.</param>
-        internal void OnServerSceneChanged(string scenePath, SceneOperation operation)
+        /// <param name="operation">The type of scene loading we want to do.</param>
+        internal void OnServerFinishedSceneLoad(string scenePath, SceneOperation operation)
         {
-            logger.Log("OnServerSceneChanged");
+            logger.Log(" [NetworkSceneManager] - OnServerSceneChanged");
 
             Server.SendToAll(new SceneReadyMessage());
 
-            ServerSceneChanged?.Invoke(scenePath, operation);
+            OnServerFinishedSceneChange?.Invoke(scenePath, operation);
+        }
+
+        /// <summary>
+        ///     When player disconnects from server we will need to clean up info in scenes related to user.
+        /// <para>Default implementation we loop through list of scenes and find where this player was in and removed them from list.</para>
+        /// </summary>
+        /// <param name="disconnectedPlayer"></param>
+        protected internal virtual void OnServerPlayerDisconnected(INetworkPlayer disconnectedPlayer)
+        {
+            foreach (KeyValuePair<Scene, HashSet<INetworkPlayer>> scene in _serverSceneData)
+            {
+                foreach (INetworkPlayer player in scene.Value)
+                {
+                    if (disconnectedPlayer != player) continue;
+
+                    scene.Value.Remove(disconnectedPlayer);
+
+                    break;
+                }
+            }
         }
 
         #endregion
 
         #region Scene Operations
 
-        UniTask ApplyOperationAsync(string scenePath, SceneOperation sceneOperation = SceneOperation.Normal)
+        /// <summary>
+        ///     Finish loading the scene.
+        /// </summary>
+        /// <param name="scenePath">The full path to the scene file or the name of the scene that is finishing.</param>
+        /// <param name="sceneOperation">Choose type of scene loading we are doing <see cref="SceneOperation"/>.</param>
+        internal void CompleteLoadingScene(string scenePath, SceneOperation sceneOperation)
+        {
+            // If server mode call this to make sure scene finishes loading
+            if (Server && Server.Active)
+            {
+                if (logger.LogEnabled())
+                    logger.Log("[NetworkSceneManager] - Host: " + sceneOperation + " operation for scene: " +
+                               scenePath);
+
+                // call OnServerSceneChanged
+                OnServerFinishedSceneLoad(scenePath, sceneOperation);
+
+                Scene scene = SceneManager.GetSceneAt(SceneManager.sceneCount - 1);
+
+                if (_serverSceneData.ContainsKey(scene))
+                {
+                    // Check to make sure this scene was not already loaded. If it was let's clear old data on it.
+                    logger.Log(
+                        $"[NetworkSceneManager] - Scene load operation: {SceneOperation.Normal}. Scene was already loaded once before. Clearing scene related data in {_serverSceneData}.");
+
+                    _serverSceneData.Remove(scene);
+                }
+
+                _serverSceneData.Add(scene, new HashSet<INetworkPlayer>(Server.Players));
+            }
+
+            // If client let's call this to finish client scene loading too
+            if (Client && Client.Active)
+            {
+                if (logger.LogEnabled())
+                    logger.Log("[NetworkSceneManager] - Client: " + sceneOperation + " operation for scene: " +
+                               scenePath);
+
+                OnClientSceneLoadFinished(scenePath, sceneOperation);
+            }
+        }
+
+        /// <summary>
+        ///     Internal usage to apply unloading a scene correctly. Other api will be available to override things.
+        /// </summary>
+        /// <param name="scenePath">The full path to the scene file or the name of the scene.</param>
+        /// <param name="sceneOperation">Choose type of scene loading we are doing <see cref="SceneOperation"/>.</param>
+        /// <returns></returns>
+        private UniTask UnLoadSceneAsync(Scene scenePath, SceneOperation sceneOperation)
+        {
+            switch (sceneOperation)
+            {
+                case SceneOperation.UnloadAdditive:
+                    return UnLoadSceneAdditiveAsync(scenePath);
+                default:
+                    throw new InvalidEnumArgumentException(nameof(sceneOperation), (int)sceneOperation,
+                        typeof(SceneOperation));
+            }
+        }
+
+        /// <summary>
+        ///     Internal usage to apply loading a scene correctly. Other api will be available to override things.
+        /// </summary>
+        /// <param name="scenePath">The full path to the scene file or the name of the scene.</param>
+        /// <param name="players">List of player's we want to track which scene they are in.</param>
+        /// <param name="sceneOperation">Choose type of scene loading we are doing <see cref="SceneOperation"/>.</param>
+        private UniTask LoadSceneAsync(string scenePath, IEnumerable<INetworkPlayer> players, SceneOperation sceneOperation = SceneOperation.Normal)
         {
             switch (sceneOperation)
             {
-                case SceneOperation.Normal: return ApplyNormalOperationAsync(scenePath);
-                case SceneOperation.LoadAdditive: return ApplyAdditiveLoadOperationAsync(scenePath);
-                case SceneOperation.UnloadAdditive: return ApplyUnloadAdditiveOperationAsync(scenePath);
+                case SceneOperation.Normal:
+                    return LoadSceneNormalAsync(scenePath);
+                case SceneOperation.LoadAdditive:
+                    return LoadSceneAdditiveAsync(scenePath, players);
+                case SceneOperation.UnloadAdditive:
+                    return UnLoadSceneAdditiveAsync(scenePath);
                 default:
-                    // Should never happen
-                    throw new InvalidEnumArgumentException(nameof(sceneOperation), (int)sceneOperation, typeof(SceneOperation));
+                    throw new InvalidEnumArgumentException(nameof(sceneOperation), (int)sceneOperation,
+                        typeof(SceneOperation));
             }
         }
 
-        async UniTask ApplyNormalOperationAsync(string scenePath)
+        /// <summary>
+        ///     Load our scene up in a normal unity fashion.
+        /// </summary>
+        /// <param name="scenePath">The full path to the scene file or the name of the scene.</param>
+        private async UniTask LoadSceneNormalAsync(string scenePath)
         {
             //Scene is already active.
             if (ActiveScenePath.Equals(scenePath))
             {
-                FinishLoadScene(scenePath, SceneOperation.Normal);
+                CompleteLoadingScene(scenePath, SceneOperation.Normal);
             }
             else
             {
-                clientLoadingOperation = SceneManager.LoadSceneAsync(scenePath);
+                SceneLoadingAsyncOperationInfo = SceneManager.LoadSceneAsync(scenePath);
 
                 //If non host client. Wait for server to finish scene change
                 if (Client && Client.Active && !Client.IsLocalClient)
                 {
-                    clientLoadingOperation.allowSceneActivation = false;
+                    SceneLoadingAsyncOperationInfo.allowSceneActivation = false;
                 }
 
-                await clientLoadingOperation;
+                await SceneLoadingAsyncOperationInfo;
+
+                logger.Assert(scenePath == ActiveScenePath, "[NetworkSceneManager] - Scene being loaded was not the active scene");
 
-                logger.Assert(scenePath == ActiveScenePath, "Scene being loaded was not the active scene");
-                FinishLoadScene(ActiveScenePath, SceneOperation.Normal);
+                CompleteLoadingScene(ActiveScenePath, SceneOperation.Normal);
             }
         }
 
-        async UniTask ApplyAdditiveLoadOperationAsync(string scenePath)
+        /// <summary>
+        ///     Load our scene additively.
+        /// </summary>
+        /// <param name="scenePath">The full path to the scene file or the name of the scene.</param>
+        /// <param name="players">The list of players we want to track to know what scene they are on.</param>
+        private async UniTask LoadSceneAdditiveAsync(string scenePath, IEnumerable<INetworkPlayer> players)
         {
-            // Ensure additive scene is not already loaded
-            if (SceneManager.GetSceneByPath(scenePath).IsValid())
-            {
-                logger.LogWarning($"Scene {scenePath} is already loaded");
-            }
-            else
+            await SceneManager.LoadSceneAsync(scenePath, LoadSceneMode.Additive);
+
+            Scene scene = SceneManager.GetSceneAt(SceneManager.sceneCount - 1);
+
+            if (Server && Server.Active)
             {
-                await SceneManager.LoadSceneAsync(scenePath, LoadSceneMode.Additive);
-                additiveSceneList.Add(scenePath);
-                FinishLoadScene(scenePath, SceneOperation.LoadAdditive);
+                _serverSceneData.Add(scene, new HashSet<INetworkPlayer>(players));
             }
+
+            CompleteLoadingScene(scenePath, SceneOperation.LoadAdditive);
         }
 
-        async UniTask ApplyUnloadAdditiveOperationAsync(string scenePath)
+        /// <summary>
+        ///     Unload our scene additively.
+        /// </summary>
+        /// <param name="scenePath">The full path to the scene file or the name of the scene.</param>
+        /// <returns></returns>
+        private async UniTask UnLoadSceneAdditiveAsync(string scenePath)
         {
             // Ensure additive scene is actually loaded
             if (SceneManager.GetSceneByPath(scenePath).IsValid())
             {
                 await SceneManager.UnloadSceneAsync(scenePath, UnloadSceneOptions.UnloadAllEmbeddedSceneObjects);
-                additiveSceneList.Remove(scenePath);
-                FinishLoadScene(scenePath, SceneOperation.UnloadAdditive);
+
+                CompleteLoadingScene(scenePath, SceneOperation.UnloadAdditive);
             }
             else
             {
@@ -354,38 +649,42 @@ async UniTask ApplyUnloadAdditiveOperationAsync(string scenePath)
             }
         }
 
-        internal void FinishLoadScene(string scenePath, SceneOperation sceneOperation)
+        /// <summary>
+        ///     Unload our scene additively.
+        /// </summary>
+        /// <param name="scene">The scene data handle to know which scene to unload in case of multiple scenes of same name / path.</param>
+        private async UniTask UnLoadSceneAdditiveAsync(Scene scene)
         {
-            // host mode?
-            if (Client && Client.IsLocalClient)
+            // Ensure additive scene is actually loaded
+            if (scene.IsValid())
             {
-                if (logger.LogEnabled()) logger.Log("Host: " + sceneOperation.ToString() + " operation for scene: " + scenePath);
+                await SceneManager.UnloadSceneAsync(scene, UnloadSceneOptions.UnloadAllEmbeddedSceneObjects);
 
-                // call OnServerSceneChanged
-                OnServerSceneChanged(scenePath, sceneOperation);
-
-                if (Client.IsConnected)
-                {
-                    // let client know that we changed scene
-                    OnClientSceneChanged(scenePath, sceneOperation);
-                }
+                CompleteLoadingScene(scene.path, SceneOperation.UnloadAdditive);
             }
-            // server-only mode?
-            else if (Server && Server.Active)
+            else
             {
-                if (logger.LogEnabled()) logger.Log("Server: " + sceneOperation.ToString() + " operation for scene: " + scenePath);
-
-                OnServerSceneChanged(scenePath, sceneOperation);
+                logger.LogWarning($"[NetworkSceneManager] - Cannot unload {scene} with UnloadAdditive operation");
             }
-            // client-only mode?
-            else if (Client && Client.Active && !Client.IsLocalClient)
-            {
-                if (logger.LogEnabled()) logger.Log("Client: " + sceneOperation.ToString() + " operation for scene: " + scenePath);
 
-                OnClientSceneChanged(scenePath, sceneOperation);
+            if (Server && Server.Active)
+            {
+                _serverSceneData.Remove(scene);
             }
         }
 
+        /// <summary>
+        ///     Let's us get scene by full path or by its name.
+        /// </summary>
+        /// <param name="scenePath">The path or name representing the scene.</param>
+        /// <returns>Returns back correct scene data.</returns>
+        public Scene GetSceneByPathOrName(string scenePath)
+        {
+            Scene scene = SceneManager.GetSceneByPath(scenePath);
+
+            return !string.IsNullOrEmpty(scene.name) ? scene : SceneManager.GetSceneByName(scenePath);
+        }
+
         #endregion
     }
 }
diff --git a/Assets/Mirage/Runtime/ServerObjectManager.cs b/Assets/Mirage/Runtime/ServerObjectManager.cs
index a0cdaa4e10d..49ac8a6e7fe 100644
--- a/Assets/Mirage/Runtime/ServerObjectManager.cs
+++ b/Assets/Mirage/Runtime/ServerObjectManager.cs
@@ -59,8 +59,8 @@ public void Start()
 
                 if (NetworkSceneManager != null)
                 {
-                    NetworkSceneManager.ServerChangeScene.AddListener(OnServerChangeScene);
-                    NetworkSceneManager.ServerSceneChanged.AddListener(OnServerSceneChanged);
+                    NetworkSceneManager.OnServerStartedSceneChange.AddListener(OnStartedSceneChange);
+                    NetworkSceneManager.OnServerFinishedSceneChange.AddListener(OnFinishedSceneChange);
                 }
             }
         }
@@ -91,12 +91,12 @@ void OnServerStopped()
             nextNetworkId = 1;
         }
 
-        void OnServerChangeScene(string scenePath, SceneOperation sceneOperation)
+        void OnStartedSceneChange(string scenePath, SceneOperation sceneOperation)
         {
             SetAllClientsNotReady();
         }
 
-        void OnServerSceneChanged(string scenePath, SceneOperation sceneOperation)
+        void OnFinishedSceneChange(string scenePath, SceneOperation sceneOperation)
         {
             SpawnOrActivate();
         }
@@ -220,7 +220,7 @@ void SpawnObserversForConnection(INetworkPlayer player)
         {
             if (logger.LogEnabled()) logger.Log($"Checking Observers on {Server.World.SpawnedIdentities.Count} objects for player: {player}");
 
-            if (!player.IsReady)
+            if (!player.SceneIsReady)
             {
                 // client needs to finish initializing before we can spawn objects
                 // otherwise it would not find them.
@@ -327,7 +327,7 @@ void Respawn(NetworkIdentity identity)
 
         internal void ShowForConnection(NetworkIdentity identity, INetworkPlayer player)
         {
-            if (player.IsReady)
+            if (player.SceneIsReady)
                 SendSpawnMessage(identity, player);
         }
 
@@ -665,7 +665,7 @@ public void SetClientReady(INetworkPlayer player)
             if (logger.LogEnabled()) logger.Log("SetClientReadyInternal for conn:" + player);
 
             // set ready
-            player.IsReady = true;
+            player.SceneIsReady = true;
 
             // client is ready to start spawning objects
             if (player.Identity != null)
@@ -691,10 +691,10 @@ public void SetAllClientsNotReady()
         /// <param name="player">The connection of the client to make not ready.</param>
         public void SetClientNotReady(INetworkPlayer player)
         {
-            if (player.IsReady)
+            if (player.SceneIsReady)
             {
                 if (logger.LogEnabled()) logger.Log("PlayerNotReady " + player);
-                player.IsReady = false;
+                player.SceneIsReady = false;
                 player.RemoveObservers();
 
                 player.Send(new NotReadyMessage());
diff --git a/Assets/Mirage/Samples~/AdditiveScenes/Scripts/ZoneHandler.cs b/Assets/Mirage/Samples~/AdditiveScenes/Scripts/ZoneHandler.cs
index 8e9d28fc371..5392c066684 100644
--- a/Assets/Mirage/Samples~/AdditiveScenes/Scripts/ZoneHandler.cs
+++ b/Assets/Mirage/Samples~/AdditiveScenes/Scripts/ZoneHandler.cs
@@ -22,7 +22,7 @@ void OnTriggerEnter(Collider other)
             if (logger.LogEnabled()) logger.LogFormat(LogType.Log, "Loading {0}", subScene);
 
             NetworkIdentity networkIdentity = other.gameObject.GetComponent<NetworkIdentity>();
-            networkIdentity.ConnectionToClient.Send(new SceneMessage { scenePath = subScene, sceneOperation = SceneOperation.LoadAdditive });
+            networkIdentity.ConnectionToClient.Send(new SceneMessage { MainActivateScene = subScene, SceneOperation = SceneOperation.LoadAdditive });
         }
 
         [Server]
@@ -31,7 +31,7 @@ void OnTriggerExit(Collider other)
             if (logger.LogEnabled()) logger.LogFormat(LogType.Log, "Unloading {0}", subScene);
 
             NetworkIdentity networkIdentity = other.gameObject.GetComponent<NetworkIdentity>();
-            networkIdentity.ConnectionToClient.Send(new SceneMessage { scenePath = subScene, sceneOperation = SceneOperation.UnloadAdditive });
+            networkIdentity.ConnectionToClient.Send(new SceneMessage { MainActivateScene = subScene, SceneOperation = SceneOperation.UnloadAdditive });
         }
     }
 }
diff --git a/Assets/Mirage/Samples~/ChangeScene/Scenes/Main.unity b/Assets/Mirage/Samples~/ChangeScene/Scenes/Main.unity
index 2cade7bbccc..476e5a1e07f 100644
--- a/Assets/Mirage/Samples~/ChangeScene/Scenes/Main.unity
+++ b/Assets/Mirage/Samples~/ChangeScene/Scenes/Main.unity
@@ -38,12 +38,12 @@ RenderSettings:
   m_ReflectionIntensity: 1
   m_CustomReflection: {fileID: 0}
   m_Sun: {fileID: 0}
-  m_IndirectSpecularColor: {r: 0, g: 0, b: 0, a: 1}
+  m_IndirectSpecularColor: {r: 0.37311953, g: 0.38074014, b: 0.3587274, a: 1}
   m_UseRadianceAmbientProbe: 0
 --- !u!157 &3
 LightmapSettings:
   m_ObjectHideFlags: 0
-  serializedVersion: 11
+  serializedVersion: 12
   m_GIWorkflowMode: 1
   m_GISettings:
     serializedVersion: 2
@@ -98,7 +98,7 @@ LightmapSettings:
     m_TrainingDataDestination: TrainingData
     m_LightProbeSampleCountMultiplier: 4
   m_LightingDataAsset: {fileID: 0}
-  m_UseShadowmask: 1
+  m_LightingSettings: {fileID: 0}
 --- !u!196 &4
 NavMeshSettings:
   serializedVersion: 2
@@ -118,6 +118,8 @@ NavMeshSettings:
     manualTileSize: 0
     tileSize: 256
     accuratePlacement: 0
+    maxJobWorkers: 0
+    preserveTilesOutsideBounds: 0
     debug:
       m_Flags: 0
   m_NavMeshData: {fileID: 0}
@@ -173,6 +175,7 @@ MonoBehaviour:
   m_Material: {fileID: 0}
   m_Color: {r: 0.19607843, g: 0.19607843, b: 0.19607843, a: 1}
   m_RaycastTarget: 1
+  m_RaycastPadding: {x: 0, y: 0, z: 0, w: 0}
   m_Maskable: 1
   m_OnCullStateChanged:
     m_PersistentCalls:
@@ -239,16 +242,16 @@ MonoBehaviour:
   Client: {fileID: 450078216}
   Server: {fileID: 450078217}
   DontDestroy: 1
-  _clientChangeScene:
+  _clientStartedSceneChange:
     m_PersistentCalls:
       m_Calls: []
-  _clientSceneChanged:
+  _clientFinishedSceneChange:
     m_PersistentCalls:
       m_Calls: []
-  _serverChangeScene:
+  _serverStartedSceneChange:
     m_PersistentCalls:
       m_Calls: []
-  _serverSceneChanged:
+  _serverFinishedSceneChange:
     m_PersistentCalls:
       m_Calls: []
 --- !u!114 &450078213
@@ -310,7 +313,12 @@ MonoBehaviour:
   m_EditorClassIdentifier: 
   EnablePeerMetrics: 0
   SocketFactory: {fileID: 450078214}
+  DisconnectOnException: 1
   authenticator: {fileID: 0}
+  _started:
+    _event:
+      m_PersistentCalls:
+        m_Calls: []
   _connected:
     _event:
       m_PersistentCalls:
@@ -337,6 +345,7 @@ MonoBehaviour:
   m_EditorClassIdentifier: 
   EnablePeerMetrics: 0
   MaxConnections: 4
+  DisconnectOnException: 1
   Listening: 1
   SocketFactory: {fileID: 450078214}
   authenticator: {fileID: 0}
@@ -396,8 +405,7 @@ MonoBehaviour:
   SceneManager: {fileID: 450078212}
   ClientObjectManager: {fileID: 450078220}
   ServerObjectManager: {fileID: 450078213}
-  PlayerPrefab: {fileID: 3878225662718291898, guid: 234985fef22d66a4ca2dba0e688f1743,
-    type: 3}
+  PlayerPrefab: {fileID: 3878225662718291898, guid: 234985fef22d66a4ca2dba0e688f1743, type: 3}
   AutoSpawn: 1
   startPositionIndex: 0
   startPositions:
@@ -598,6 +606,7 @@ MonoBehaviour:
   m_EditorClassIdentifier: 
   m_Navigation:
     m_Mode: 3
+    m_WrapAround: 0
     m_SelectOnUp: {fileID: 0}
     m_SelectOnDown: {fileID: 0}
     m_SelectOnLeft: {fileID: 0}
@@ -628,6 +637,7 @@ MonoBehaviour:
     m_PersistentCalls:
       m_Calls:
       - m_Target: {fileID: 1141063017}
+        m_TargetAssemblyTypeName: 
         m_MethodName: AdditiveButtonHandler
         m_Mode: 1
         m_Arguments:
@@ -653,6 +663,7 @@ MonoBehaviour:
   m_Material: {fileID: 0}
   m_Color: {r: 1, g: 1, b: 1, a: 1}
   m_RaycastTarget: 1
+  m_RaycastPadding: {x: 0, y: 0, z: 0, w: 0}
   m_Maskable: 1
   m_OnCullStateChanged:
     m_PersistentCalls:
@@ -823,6 +834,7 @@ MonoBehaviour:
   m_Material: {fileID: 0}
   m_Color: {r: 0.19607843, g: 0.19607843, b: 0.19607843, a: 1}
   m_RaycastTarget: 1
+  m_RaycastPadding: {x: 0, y: 0, z: 0, w: 0}
   m_Maskable: 1
   m_OnCullStateChanged:
     m_PersistentCalls:
@@ -881,7 +893,7 @@ MonoBehaviour:
   m_Script: {fileID: 11500000, guid: 43d53bca23122b54fb0ebaddebf2e987, type: 3}
   m_Name: 
   m_EditorClassIdentifier: 
-  sceneManager: {fileID: 0}
+  sceneManager: {fileID: 450078212}
   AdditiveButtonText: {fileID: 1173114603}
 --- !u!114 &1141063018
 MonoBehaviour:
@@ -922,6 +934,7 @@ MonoBehaviour:
   m_FallbackScreenDPI: 96
   m_DefaultSpriteDPI: 96
   m_DynamicPixelsPerUnit: 1
+  m_PresetInfoIsWorld: 0
 --- !u!223 &1141063020
 Canvas:
   m_ObjectHideFlags: 0
@@ -1017,6 +1030,7 @@ MonoBehaviour:
   m_Material: {fileID: 0}
   m_Color: {r: 0.19607843, g: 0.19607843, b: 0.19607843, a: 1}
   m_RaycastTarget: 1
+  m_RaycastPadding: {x: 0, y: 0, z: 0, w: 0}
   m_Maskable: 1
   m_OnCullStateChanged:
     m_PersistentCalls:
@@ -1096,6 +1110,7 @@ MonoBehaviour:
   m_EditorClassIdentifier: 
   m_Navigation:
     m_Mode: 3
+    m_WrapAround: 0
     m_SelectOnUp: {fileID: 0}
     m_SelectOnDown: {fileID: 0}
     m_SelectOnLeft: {fileID: 0}
@@ -1126,6 +1141,7 @@ MonoBehaviour:
     m_PersistentCalls:
       m_Calls:
       - m_Target: {fileID: 1141063017}
+        m_TargetAssemblyTypeName: 
         m_MethodName: Room1ButtonHandler
         m_Mode: 1
         m_Arguments:
@@ -1151,6 +1167,7 @@ MonoBehaviour:
   m_Material: {fileID: 0}
   m_Color: {r: 1, g: 1, b: 1, a: 1}
   m_RaycastTarget: 1
+  m_RaycastPadding: {x: 0, y: 0, z: 0, w: 0}
   m_Maskable: 1
   m_OnCullStateChanged:
     m_PersistentCalls:
@@ -1226,6 +1243,7 @@ MonoBehaviour:
   m_EditorClassIdentifier: 
   m_Navigation:
     m_Mode: 3
+    m_WrapAround: 0
     m_SelectOnUp: {fileID: 0}
     m_SelectOnDown: {fileID: 0}
     m_SelectOnLeft: {fileID: 0}
@@ -1256,6 +1274,7 @@ MonoBehaviour:
     m_PersistentCalls:
       m_Calls:
       - m_Target: {fileID: 1141063017}
+        m_TargetAssemblyTypeName: 
         m_MethodName: Room2ButtonHandler
         m_Mode: 1
         m_Arguments:
@@ -1281,6 +1300,7 @@ MonoBehaviour:
   m_Material: {fileID: 0}
   m_Color: {r: 1, g: 1, b: 1, a: 1}
   m_RaycastTarget: 1
+  m_RaycastPadding: {x: 0, y: 0, z: 0, w: 0}
   m_Maskable: 1
   m_OnCullStateChanged:
     m_PersistentCalls:
@@ -1441,6 +1461,7 @@ MonoBehaviour:
   m_Material: {fileID: 0}
   m_Color: {r: 1, g: 1, b: 1, a: 0.15686275}
   m_RaycastTarget: 1
+  m_RaycastPadding: {x: 0, y: 0, z: 0, w: 0}
   m_Maskable: 1
   m_OnCullStateChanged:
     m_PersistentCalls:
@@ -1488,68 +1509,55 @@ PrefabInstance:
   m_Modification:
     m_TransformParent: {fileID: 0}
     m_Modifications:
-    - target: {fileID: 1818873914431344369, guid: 685b07ee95b6b6b4db30b2440e670157,
-        type: 3}
+    - target: {fileID: 1818873914431344369, guid: 685b07ee95b6b6b4db30b2440e670157, type: 3}
       propertyPath: m_RootOrder
       value: 1
       objectReference: {fileID: 0}
-    - target: {fileID: 1818873914431344369, guid: 685b07ee95b6b6b4db30b2440e670157,
-        type: 3}
+    - target: {fileID: 1818873914431344369, guid: 685b07ee95b6b6b4db30b2440e670157, type: 3}
       propertyPath: m_LocalPosition.x
       value: -5
       objectReference: {fileID: 0}
-    - target: {fileID: 1818873914431344369, guid: 685b07ee95b6b6b4db30b2440e670157,
-        type: 3}
+    - target: {fileID: 1818873914431344369, guid: 685b07ee95b6b6b4db30b2440e670157, type: 3}
       propertyPath: m_LocalPosition.y
       value: 0
       objectReference: {fileID: 0}
-    - target: {fileID: 1818873914431344369, guid: 685b07ee95b6b6b4db30b2440e670157,
-        type: 3}
+    - target: {fileID: 1818873914431344369, guid: 685b07ee95b6b6b4db30b2440e670157, type: 3}
       propertyPath: m_LocalPosition.z
       value: 0
       objectReference: {fileID: 0}
-    - target: {fileID: 1818873914431344369, guid: 685b07ee95b6b6b4db30b2440e670157,
-        type: 3}
+    - target: {fileID: 1818873914431344369, guid: 685b07ee95b6b6b4db30b2440e670157, type: 3}
       propertyPath: m_LocalRotation.w
       value: 1
       objectReference: {fileID: 0}
-    - target: {fileID: 1818873914431344369, guid: 685b07ee95b6b6b4db30b2440e670157,
-        type: 3}
+    - target: {fileID: 1818873914431344369, guid: 685b07ee95b6b6b4db30b2440e670157, type: 3}
       propertyPath: m_LocalRotation.x
       value: 0
       objectReference: {fileID: 0}
-    - target: {fileID: 1818873914431344369, guid: 685b07ee95b6b6b4db30b2440e670157,
-        type: 3}
+    - target: {fileID: 1818873914431344369, guid: 685b07ee95b6b6b4db30b2440e670157, type: 3}
       propertyPath: m_LocalRotation.y
       value: 0
       objectReference: {fileID: 0}
-    - target: {fileID: 1818873914431344369, guid: 685b07ee95b6b6b4db30b2440e670157,
-        type: 3}
+    - target: {fileID: 1818873914431344369, guid: 685b07ee95b6b6b4db30b2440e670157, type: 3}
       propertyPath: m_LocalRotation.z
       value: 0
       objectReference: {fileID: 0}
-    - target: {fileID: 1818873914431344369, guid: 685b07ee95b6b6b4db30b2440e670157,
-        type: 3}
+    - target: {fileID: 1818873914431344369, guid: 685b07ee95b6b6b4db30b2440e670157, type: 3}
       propertyPath: m_LocalEulerAnglesHint.x
       value: 0
       objectReference: {fileID: 0}
-    - target: {fileID: 1818873914431344369, guid: 685b07ee95b6b6b4db30b2440e670157,
-        type: 3}
+    - target: {fileID: 1818873914431344369, guid: 685b07ee95b6b6b4db30b2440e670157, type: 3}
       propertyPath: m_LocalEulerAnglesHint.y
       value: 0
       objectReference: {fileID: 0}
-    - target: {fileID: 1818873914431344369, guid: 685b07ee95b6b6b4db30b2440e670157,
-        type: 3}
+    - target: {fileID: 1818873914431344369, guid: 685b07ee95b6b6b4db30b2440e670157, type: 3}
       propertyPath: m_LocalEulerAnglesHint.z
       value: 0
       objectReference: {fileID: 0}
-    - target: {fileID: 1818873914431344371, guid: 685b07ee95b6b6b4db30b2440e670157,
-        type: 3}
+    - target: {fileID: 1818873914431344371, guid: 685b07ee95b6b6b4db30b2440e670157, type: 3}
       propertyPath: sceneId
       value: 4160360001
       objectReference: {fileID: 0}
-    - target: {fileID: 1818873914431344372, guid: 685b07ee95b6b6b4db30b2440e670157,
-        type: 3}
+    - target: {fileID: 1818873914431344372, guid: 685b07ee95b6b6b4db30b2440e670157, type: 3}
       propertyPath: m_Name
       value: SceneObject
       objectReference: {fileID: 0}
@@ -1562,73 +1570,59 @@ PrefabInstance:
   m_Modification:
     m_TransformParent: {fileID: 0}
     m_Modifications:
-    - target: {fileID: 6727010246441667690, guid: a6be402bdabdcda42927e4593587fefb,
-        type: 3}
+    - target: {fileID: 6727010246441667690, guid: a6be402bdabdcda42927e4593587fefb, type: 3}
       propertyPath: m_Name
       value: ServerOnlySceneObject
       objectReference: {fileID: 0}
-    - target: {fileID: 6727010246441667693, guid: a6be402bdabdcda42927e4593587fefb,
-        type: 3}
+    - target: {fileID: 6727010246441667693, guid: a6be402bdabdcda42927e4593587fefb, type: 3}
       propertyPath: sceneId
       value: 3166183123
       objectReference: {fileID: 0}
-    - target: {fileID: 6727010246441667693, guid: a6be402bdabdcda42927e4593587fefb,
-        type: 3}
+    - target: {fileID: 6727010246441667693, guid: a6be402bdabdcda42927e4593587fefb, type: 3}
       propertyPath: m_AssetId
       value: a6be402bdabdcda42927e4593587fefb
       objectReference: {fileID: 0}
-    - target: {fileID: 6727010246441667695, guid: a6be402bdabdcda42927e4593587fefb,
-        type: 3}
+    - target: {fileID: 6727010246441667695, guid: a6be402bdabdcda42927e4593587fefb, type: 3}
       propertyPath: m_RootOrder
       value: 3
       objectReference: {fileID: 0}
-    - target: {fileID: 6727010246441667695, guid: a6be402bdabdcda42927e4593587fefb,
-        type: 3}
+    - target: {fileID: 6727010246441667695, guid: a6be402bdabdcda42927e4593587fefb, type: 3}
       propertyPath: m_LocalPosition.x
       value: -6
       objectReference: {fileID: 0}
-    - target: {fileID: 6727010246441667695, guid: a6be402bdabdcda42927e4593587fefb,
-        type: 3}
+    - target: {fileID: 6727010246441667695, guid: a6be402bdabdcda42927e4593587fefb, type: 3}
       propertyPath: m_LocalPosition.y
       value: 0
       objectReference: {fileID: 0}
-    - target: {fileID: 6727010246441667695, guid: a6be402bdabdcda42927e4593587fefb,
-        type: 3}
+    - target: {fileID: 6727010246441667695, guid: a6be402bdabdcda42927e4593587fefb, type: 3}
       propertyPath: m_LocalPosition.z
       value: 0
       objectReference: {fileID: 0}
-    - target: {fileID: 6727010246441667695, guid: a6be402bdabdcda42927e4593587fefb,
-        type: 3}
+    - target: {fileID: 6727010246441667695, guid: a6be402bdabdcda42927e4593587fefb, type: 3}
       propertyPath: m_LocalRotation.w
       value: 1
       objectReference: {fileID: 0}
-    - target: {fileID: 6727010246441667695, guid: a6be402bdabdcda42927e4593587fefb,
-        type: 3}
+    - target: {fileID: 6727010246441667695, guid: a6be402bdabdcda42927e4593587fefb, type: 3}
       propertyPath: m_LocalRotation.x
       value: 0
       objectReference: {fileID: 0}
-    - target: {fileID: 6727010246441667695, guid: a6be402bdabdcda42927e4593587fefb,
-        type: 3}
+    - target: {fileID: 6727010246441667695, guid: a6be402bdabdcda42927e4593587fefb, type: 3}
       propertyPath: m_LocalRotation.y
       value: 0
       objectReference: {fileID: 0}
-    - target: {fileID: 6727010246441667695, guid: a6be402bdabdcda42927e4593587fefb,
-        type: 3}
+    - target: {fileID: 6727010246441667695, guid: a6be402bdabdcda42927e4593587fefb, type: 3}
       propertyPath: m_LocalRotation.z
       value: 0
       objectReference: {fileID: 0}
-    - target: {fileID: 6727010246441667695, guid: a6be402bdabdcda42927e4593587fefb,
-        type: 3}
+    - target: {fileID: 6727010246441667695, guid: a6be402bdabdcda42927e4593587fefb, type: 3}
       propertyPath: m_LocalEulerAnglesHint.x
       value: 0
       objectReference: {fileID: 0}
-    - target: {fileID: 6727010246441667695, guid: a6be402bdabdcda42927e4593587fefb,
-        type: 3}
+    - target: {fileID: 6727010246441667695, guid: a6be402bdabdcda42927e4593587fefb, type: 3}
       propertyPath: m_LocalEulerAnglesHint.y
       value: 0
       objectReference: {fileID: 0}
-    - target: {fileID: 6727010246441667695, guid: a6be402bdabdcda42927e4593587fefb,
-        type: 3}
+    - target: {fileID: 6727010246441667695, guid: a6be402bdabdcda42927e4593587fefb, type: 3}
       propertyPath: m_LocalEulerAnglesHint.z
       value: 0
       objectReference: {fileID: 0}
@@ -1694,6 +1688,7 @@ MonoBehaviour:
   m_Material: {fileID: 0}
   m_Color: {r: 0.19607843, g: 0.19607843, b: 0.19607843, a: 1}
   m_RaycastTarget: 1
+  m_RaycastPadding: {x: 0, y: 0, z: 0, w: 0}
   m_Maskable: 1
   m_OnCullStateChanged:
     m_PersistentCalls:
@@ -1848,6 +1843,7 @@ MonoBehaviour:
   m_Material: {fileID: 0}
   m_Color: {r: 0.19607843, g: 0.19607843, b: 0.19607843, a: 1}
   m_RaycastTarget: 1
+  m_RaycastPadding: {x: 0, y: 0, z: 0, w: 0}
   m_Maskable: 1
   m_OnCullStateChanged:
     m_PersistentCalls:
@@ -1908,6 +1904,7 @@ MonoBehaviour:
   m_Material: {fileID: 0}
   m_Color: {r: 1, g: 1, b: 1, a: 1}
   m_RaycastTarget: 1
+  m_RaycastPadding: {x: 0, y: 0, z: 0, w: 0}
   m_Maskable: 1
   m_OnCullStateChanged:
     m_PersistentCalls:
@@ -1957,6 +1954,7 @@ MonoBehaviour:
   m_EditorClassIdentifier: 
   m_Navigation:
     m_Mode: 3
+    m_WrapAround: 0
     m_SelectOnUp: {fileID: 0}
     m_SelectOnDown: {fileID: 0}
     m_SelectOnLeft: {fileID: 0}
@@ -1996,10 +1994,14 @@ MonoBehaviour:
   m_OnEndEdit:
     m_PersistentCalls:
       m_Calls: []
+  m_OnSubmit:
+    m_PersistentCalls:
+      m_Calls: []
   m_OnValueChanged:
     m_PersistentCalls:
       m_Calls:
       - m_Target: {fileID: 695766755316128326}
+        m_TargetAssemblyTypeName: 
         m_MethodName: OnNetworkAddressInputUpdate
         m_Mode: 1
         m_Arguments:
@@ -2017,6 +2019,7 @@ MonoBehaviour:
   m_CaretBlinkRate: 0.85
   m_CaretWidth: 1
   m_ReadOnly: 0
+  m_ShouldActivateOnSelect: 1
 --- !u!114 &7413922469818467064
 MonoBehaviour:
   m_ObjectHideFlags: 0
@@ -2031,6 +2034,7 @@ MonoBehaviour:
   m_EditorClassIdentifier: 
   m_Navigation:
     m_Mode: 3
+    m_WrapAround: 0
     m_SelectOnUp: {fileID: 0}
     m_SelectOnDown: {fileID: 0}
     m_SelectOnLeft: {fileID: 0}
@@ -2061,6 +2065,7 @@ MonoBehaviour:
     m_PersistentCalls:
       m_Calls:
       - m_Target: {fileID: 695766755316128326}
+        m_TargetAssemblyTypeName: 
         m_MethodName: StartHostButtonHandler
         m_Mode: 1
         m_Arguments:
@@ -2133,6 +2138,7 @@ MonoBehaviour:
   m_Material: {fileID: 0}
   m_Color: {r: 1, g: 1, b: 1, a: 1}
   m_RaycastTarget: 1
+  m_RaycastPadding: {x: 0, y: 0, z: 0, w: 0}
   m_Maskable: 1
   m_OnCullStateChanged:
     m_PersistentCalls:
@@ -2189,6 +2195,7 @@ MonoBehaviour:
   m_Material: {fileID: 0}
   m_Color: {r: 1, g: 1, b: 1, a: 1}
   m_RaycastTarget: 1
+  m_RaycastPadding: {x: 0, y: 0, z: 0, w: 0}
   m_Maskable: 1
   m_OnCullStateChanged:
     m_PersistentCalls:
@@ -2217,6 +2224,7 @@ MonoBehaviour:
   m_EditorClassIdentifier: 
   m_Navigation:
     m_Mode: 3
+    m_WrapAround: 0
     m_SelectOnUp: {fileID: 0}
     m_SelectOnDown: {fileID: 0}
     m_SelectOnLeft: {fileID: 0}
@@ -2247,6 +2255,7 @@ MonoBehaviour:
     m_PersistentCalls:
       m_Calls:
       - m_Target: {fileID: 695766755316128326}
+        m_TargetAssemblyTypeName: 
         m_MethodName: StartServerOnlyButtonHandler
         m_Mode: 1
         m_Arguments:
@@ -2300,6 +2309,7 @@ MonoBehaviour:
   m_Material: {fileID: 0}
   m_Color: {r: 0.19607843, g: 0.19607843, b: 0.19607843, a: 1}
   m_RaycastTarget: 1
+  m_RaycastPadding: {x: 0, y: 0, z: 0, w: 0}
   m_Maskable: 1
   m_OnCullStateChanged:
     m_PersistentCalls:
@@ -2388,6 +2398,7 @@ MonoBehaviour:
   m_Material: {fileID: 0}
   m_Color: {r: 0.19607843, g: 0.19607843, b: 0.19607843, a: 1}
   m_RaycastTarget: 1
+  m_RaycastPadding: {x: 0, y: 0, z: 0, w: 0}
   m_Maskable: 1
   m_OnCullStateChanged:
     m_PersistentCalls:
@@ -2475,6 +2486,7 @@ MonoBehaviour:
   m_Material: {fileID: 0}
   m_Color: {r: 1, g: 1, b: 1, a: 1}
   m_RaycastTarget: 1
+  m_RaycastPadding: {x: 0, y: 0, z: 0, w: 0}
   m_Maskable: 1
   m_OnCullStateChanged:
     m_PersistentCalls:
@@ -2503,6 +2515,7 @@ MonoBehaviour:
   m_EditorClassIdentifier: 
   m_Navigation:
     m_Mode: 3
+    m_WrapAround: 0
     m_SelectOnUp: {fileID: 0}
     m_SelectOnDown: {fileID: 0}
     m_SelectOnLeft: {fileID: 0}
@@ -2533,6 +2546,7 @@ MonoBehaviour:
     m_PersistentCalls:
       m_Calls:
       - m_Target: {fileID: 695766755316128326}
+        m_TargetAssemblyTypeName: 
         m_MethodName: StartClientButtonHandler
         m_Mode: 1
         m_Arguments:
@@ -2586,6 +2600,7 @@ MonoBehaviour:
   m_Material: {fileID: 0}
   m_Color: {r: 1, g: 1, b: 1, a: 1}
   m_RaycastTarget: 1
+  m_RaycastPadding: {x: 0, y: 0, z: 0, w: 0}
   m_Maskable: 1
   m_OnCullStateChanged:
     m_PersistentCalls:
@@ -2614,6 +2629,7 @@ MonoBehaviour:
   m_EditorClassIdentifier: 
   m_Navigation:
     m_Mode: 3
+    m_WrapAround: 0
     m_SelectOnUp: {fileID: 0}
     m_SelectOnDown: {fileID: 0}
     m_SelectOnLeft: {fileID: 0}
@@ -2644,6 +2660,7 @@ MonoBehaviour:
     m_PersistentCalls:
       m_Calls:
       - m_Target: {fileID: 695766755316128326}
+        m_TargetAssemblyTypeName: 
         m_MethodName: StopButtonHandler
         m_Mode: 1
         m_Arguments:
@@ -2708,6 +2725,7 @@ MonoBehaviour:
   m_Material: {fileID: 0}
   m_Color: {r: 0.19607843, g: 0.19607843, b: 0.19607843, a: 1}
   m_RaycastTarget: 1
+  m_RaycastPadding: {x: 0, y: 0, z: 0, w: 0}
   m_Maskable: 1
   m_OnCullStateChanged:
     m_PersistentCalls:
@@ -2831,6 +2849,7 @@ MonoBehaviour:
   m_Material: {fileID: 0}
   m_Color: {r: 0.19607843, g: 0.19607843, b: 0.19607843, a: 0.5}
   m_RaycastTarget: 1
+  m_RaycastPadding: {x: 0, y: 0, z: 0, w: 0}
   m_Maskable: 1
   m_OnCullStateChanged:
     m_PersistentCalls:
@@ -2912,6 +2931,7 @@ MonoBehaviour:
   m_Material: {fileID: 0}
   m_Color: {r: 1, g: 1, b: 1, a: 0.078431375}
   m_RaycastTarget: 1
+  m_RaycastPadding: {x: 0, y: 0, z: 0, w: 0}
   m_Maskable: 1
   m_OnCullStateChanged:
     m_PersistentCalls:
@@ -2986,6 +3006,7 @@ MonoBehaviour:
   m_Material: {fileID: 0}
   m_Color: {r: 0.19607843, g: 0.19607843, b: 0.19607843, a: 1}
   m_RaycastTarget: 1
+  m_RaycastPadding: {x: 0, y: 0, z: 0, w: 0}
   m_Maskable: 1
   m_OnCullStateChanged:
     m_PersistentCalls:
diff --git a/Assets/Mirage/Samples~/ChangeScene/Scripts/SceneSwitcherHud.cs b/Assets/Mirage/Samples~/ChangeScene/Scripts/SceneSwitcherHud.cs
index 26e17383ed5..a70fb1ad6d7 100644
--- a/Assets/Mirage/Samples~/ChangeScene/Scripts/SceneSwitcherHud.cs
+++ b/Assets/Mirage/Samples~/ChangeScene/Scripts/SceneSwitcherHud.cs
@@ -1,4 +1,6 @@
+using System.Collections.Generic;
 using UnityEngine;
+using UnityEngine.SceneManagement;
 using UnityEngine.UI;
 
 namespace Mirage.Examples.SceneChange
@@ -8,6 +10,7 @@ public class SceneSwitcherHud : MonoBehaviour
         public NetworkSceneManager sceneManager;
         public Text AdditiveButtonText;
         bool additiveLoaded;
+        private Scene _additiveLoadedScene;
 
         public void Update()
         {
@@ -23,27 +26,31 @@ public void Update()
 
         public void Room1ButtonHandler()
         {
-            sceneManager.ChangeServerScene("Room1");
+            sceneManager.ServerLoadSceneNormal("Room1");
             additiveLoaded = false;
         }
 
         public void Room2ButtonHandler()
         {
-            sceneManager.ChangeServerScene("Room2");
+            sceneManager.ServerLoadSceneNormal("Room2");
             additiveLoaded = false;
         }
 
         public void AdditiveButtonHandler()
         {
+            HashSet<INetworkPlayer> players = sceneManager.Server.Players;
+
             if (additiveLoaded)
             {
                 additiveLoaded = false;
-                sceneManager.ChangeServerScene("Additive", SceneOperation.UnloadAdditive);
+
+                sceneManager.ServerUnloadSceneAdditively(_additiveLoadedScene, players);
             }
             else
             {
                 additiveLoaded = true;
-                sceneManager.ChangeServerScene("Additive", SceneOperation.LoadAdditive);
+                sceneManager.ServerLoadSceneAdditively("Additive", players);
+                _additiveLoadedScene = SceneManager.GetSceneAt(SceneManager.sceneCount - 1);
             }
         }
     }
diff --git a/Assets/Mirage/Samples~/MultipleAdditiveScenes/Scripts/MultiSceneNetManager.cs b/Assets/Mirage/Samples~/MultipleAdditiveScenes/Scripts/MultiSceneNetManager.cs
index d07cf57cb74..980c6d1f700 100644
--- a/Assets/Mirage/Samples~/MultipleAdditiveScenes/Scripts/MultiSceneNetManager.cs
+++ b/Assets/Mirage/Samples~/MultipleAdditiveScenes/Scripts/MultiSceneNetManager.cs
@@ -46,7 +46,8 @@ public void OnServerAddPlayer(INetworkPlayer player)
         IEnumerator AddPlayerDelayed(INetworkPlayer player)
         {
             yield return new WaitForSeconds(.5f);
-            player.Send(new SceneMessage { scenePath = gameScene, sceneOperation = SceneOperation.LoadAdditive });
+
+            ServerObjectManager.NetworkSceneManager.ServerLoadSceneAdditively(gameScene, Server.Players);
 
             PlayerScore playerScore = player.Identity.GetComponent<PlayerScore>();
             playerScore.playerNumber = playerId;
@@ -79,7 +80,7 @@ IEnumerator LoadSubScenes()
         /// </summary>
         public void OnStopServer()
         {
-            Server.SendToAll(new SceneMessage { scenePath = gameScene, sceneOperation = SceneOperation.UnloadAdditive });
+            Server.SendToAll(new SceneMessage { MainActivateScene = gameScene, SceneOperation = SceneOperation.UnloadAdditive });
             StartCoroutine(UnloadSubScenes());
         }
 
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 3fe82200037..521ec77fe44 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -50,4 +50,4 @@
             "path": "Samples~/Tanks"
         }
     ]
-}
+}
\ No newline at end of file
diff --git a/Assets/Tests/Editor/NetworkIdentityCallbackTests.cs b/Assets/Tests/Editor/NetworkIdentityCallbackTests.cs
index 8c182d812bc..5df23872cc8 100644
--- a/Assets/Tests/Editor/NetworkIdentityCallbackTests.cs
+++ b/Assets/Tests/Editor/NetworkIdentityCallbackTests.cs
@@ -755,7 +755,7 @@ public void RebuildObserversAddsReadyConnectionsIfImplemented()
             // one with a ready connection, one with no ready connection, one with null connection
             RebuildObserversNetworkBehaviour comp = gameObject.AddComponent<RebuildObserversNetworkBehaviour>();
             comp.observer = Substitute.For<INetworkPlayer>();
-            comp.observer.IsReady.Returns(true);
+            comp.observer.SceneIsReady.Returns(true);
 
             // rebuild observers should add all component's ready observers
             identity.RebuildObservers(true);
@@ -770,7 +770,7 @@ public void RebuildObserversDoesntAddNotReadyConnectionsIfImplemented()
             // one with a ready connection, one with no ready connection, one with null connection
             RebuildObserversNetworkBehaviour comp = gameObject.AddComponent<RebuildObserversNetworkBehaviour>();
             comp.observer = Substitute.For<INetworkPlayer>();
-            comp.observer.IsReady.Returns(false);
+            comp.observer.SceneIsReady.Returns(false);
 
             // rebuild observers should add all component's ready observers
             identity.RebuildObservers(true);
@@ -781,9 +781,9 @@ public void RebuildObserversDoesntAddNotReadyConnectionsIfImplemented()
         public void RebuildObserversAddsReadyServerConnectionsIfNotImplemented()
         {
             INetworkPlayer readyConnection = Substitute.For<INetworkPlayer>();
-            readyConnection.IsReady.Returns(true);
+            readyConnection.SceneIsReady.Returns(true);
             INetworkPlayer notReadyConnection = Substitute.For<INetworkPlayer>();
-            notReadyConnection.IsReady.Returns(false);
+            notReadyConnection.SceneIsReady.Returns(false);
 
             // add some server connections
             server.Players.Add(readyConnection);
diff --git a/Assets/Tests/Runtime/ClientServer/NetworkSceneManagerTests.cs b/Assets/Tests/Runtime/ClientServer/NetworkSceneManagerTests.cs
index b5f09aafdea..d47f72f39e5 100644
--- a/Assets/Tests/Runtime/ClientServer/NetworkSceneManagerTests.cs
+++ b/Assets/Tests/Runtime/ClientServer/NetworkSceneManagerTests.cs
@@ -1,5 +1,6 @@
 using System;
 using System.Collections;
+using System.Collections.Generic;
 using Cysharp.Threading.Tasks;
 using NSubstitute;
 using NUnit.Framework;
@@ -24,15 +25,28 @@ public override void ExtraSetup()
 
         public override void ExtraTearDown()
         {
+            UnloadAdditiveScenes();
+
             bundle.Unload(true);
         }
 
+        private static void UnloadAdditiveScenes()
+        {
+            Scene active = SceneManager.GetActiveScene();
+            for (int i = 0; i < SceneManager.sceneCount; i++)
+            {
+                Scene scene = SceneManager.GetSceneAt(i);
+                if (active == scene) { continue; }
+                SceneManager.UnloadSceneAsync(scene);
+            }
+        }
+
         [Test]
         public void ClientSceneMessageExceptionTest()
         {
-            Assert.Throws<ArgumentNullException>(() =>
+            Assert.Throws<ArgumentException>(() =>
             {
-                clientSceneManager.ClientSceneMessage(null, new SceneMessage());
+                clientSceneManager.ClientStartSceneMessage(null, new SceneMessage());
             });
         }
 
@@ -40,8 +54,8 @@ public void ClientSceneMessageExceptionTest()
         public void FinishLoadSceneTest()
         {
             UnityAction<string, SceneOperation> func2 = Substitute.For<UnityAction<string, SceneOperation>>();
-            clientSceneManager.ClientSceneChanged.AddListener(func2);
-            clientSceneManager.FinishLoadScene("Assets/Mirror/Tests/Runtime/testScene.unity", SceneOperation.Normal);
+            clientSceneManager.OnClientFinishedSceneChange.AddListener(func2);
+            clientSceneManager.CompleteLoadingScene("Assets/Mirror/Tests/Runtime/testScene.unity", SceneOperation.Normal);
 
             func2.Received(1).Invoke(Arg.Any<string>(), Arg.Any<SceneOperation>());
         }
@@ -55,7 +69,7 @@ public void FinishLoadSceneTest()
 
             Assert.Throws<InvalidOperationException>(() =>
             {
-                clientSceneManager.ClientSceneMessage(null, new SceneMessage());
+                clientSceneManager.ClientStartSceneMessage(null, new SceneMessage());
             });
         });
 
@@ -65,9 +79,9 @@ public void FinishLoadSceneTest()
             int startInvoked = 0;
             int endInvoked = 0;
 
-            clientSceneManager.ClientChangeScene.AddListener((_, __) => startInvoked++);
-            clientSceneManager.ClientSceneChanged.AddListener((_, __) => endInvoked++);
-            clientSceneManager.ClientSceneMessage(null, new SceneMessage { scenePath = "Assets/Mirror/Tests/Runtime/testScene.unity" });
+            clientSceneManager.OnClientStartedSceneChange.AddListener((_, __) => startInvoked++);
+            clientSceneManager.OnClientFinishedSceneChange.AddListener((_, __) => endInvoked++);
+            clientSceneManager.ClientStartSceneMessage(null, new SceneMessage { MainActivateScene = "Assets/Mirror/Tests/Runtime/testScene.unity" });
 
             await AsyncUtil.WaitUntilWithTimeout(() => startInvoked == 1);
 
@@ -76,7 +90,7 @@ public void FinishLoadSceneTest()
             Assert.That(startInvoked == 1, "Start should only be called once");
             Assert.That(endInvoked == 0, "Should wait for ready before end is called");
 
-            clientSceneManager.ClientSceneReadyMessage(clientPlayer, new SceneReadyMessage());
+            clientSceneManager.ClientFinishedLoadingSceneMessage(clientPlayer, new SceneReadyMessage());
 
             await AsyncUtil.WaitUntilWithTimeout(() => endInvoked == 1);
 
@@ -92,16 +106,16 @@ public void ClientSceneMessageThrowsIfInvalidSceneOperation()
             int startInvoked = 0;
             int endInvoked = 0;
 
-            clientSceneManager.ClientChangeScene.AddListener((_, __) => startInvoked++);
-            clientSceneManager.ClientSceneChanged.AddListener((_, __) => endInvoked++);
+            clientSceneManager.OnClientStartedSceneChange.AddListener((_, __) => startInvoked++);
+            clientSceneManager.OnClientFinishedSceneChange.AddListener((_, __) => endInvoked++);
 
             var invalidOperation = (SceneOperation)10;
             InvalidEnumArgumentException exception = Assert.Throws<InvalidEnumArgumentException>(() =>
             {
-                clientSceneManager.ClientSceneMessage(null, new SceneMessage
+                clientSceneManager.ClientStartSceneMessage(null, new SceneMessage
                 {
-                    scenePath = "Assets/Mirror/Tests/Runtime/testScene.unity",
-                    sceneOperation = invalidOperation
+                    MainActivateScene = "Assets/Mirror/Tests/Runtime/testScene.unity",
+                    SceneOperation = invalidOperation
                 });
             });
 
@@ -119,8 +133,8 @@ public void NetworkSceneNameStringValueTest()
         public void ServerChangeSceneTest()
         {
             UnityAction<string, SceneOperation> func1 = Substitute.For<UnityAction<string, SceneOperation>>();
-            serverSceneManager.ServerChangeScene.AddListener(func1);
-            serverSceneManager.OnServerChangeScene("test", SceneOperation.Normal);
+            serverSceneManager.OnServerStartedSceneChange.AddListener(func1);
+            serverSceneManager.OnServerStartedSceneChange.Invoke("test", SceneOperation.Normal);
             func1.Received(1).Invoke(Arg.Any<string>(), Arg.Any<SceneOperation>());
         }
 
@@ -128,25 +142,51 @@ public void ServerChangeSceneTest()
         public void ServerSceneChangedTest()
         {
             UnityAction<string, SceneOperation> func1 = Substitute.For<UnityAction<string, SceneOperation>>();
-            serverSceneManager.ServerSceneChanged.AddListener(func1);
-            serverSceneManager.OnServerSceneChanged("test", SceneOperation.Normal);
+            serverSceneManager.OnServerFinishedSceneChange.AddListener(func1);
+            serverSceneManager.OnServerFinishedSceneChange.Invoke("test", SceneOperation.Normal);
             func1.Received(1).Invoke(Arg.Any<string>(), Arg.Any<SceneOperation>());
         }
 
         [Test]
-        public void OnClientSceneChangedAdditiveListTest()
+        public void OnClientSceneLoadFinishedTest()
+        {
+            clientSceneManager.ClientPendingAdditiveSceneLoadingList.Add(null);
+
+            ArgumentNullException exception = Assert.Throws<ArgumentNullException>(() =>
+            {
+                clientSceneManager.OnClientSceneLoadFinished(null, SceneOperation.Normal);
+            });
+
+            string message = new ArgumentNullException("scenePath", "Some how a null scene path has been entered.").Message;
+            Assert.That(exception, Has.Message.EqualTo(message));
+        }
+
+        [UnityTest]
+        public IEnumerator OnClientSceneChangedAdditiveListTest() => UniTask.ToCoroutine(async () =>
         {
-            clientSceneManager.pendingAdditiveSceneList.Add("Assets/Mirror/Tests/Runtime/testScene.unity");
-            clientSceneManager.OnClientSceneChanged(null, SceneOperation.Normal);
-            Assert.That(clientSceneManager.pendingAdditiveSceneList.Count == 0);
+            clientSceneManager.OnClientFinishedSceneChange.AddListener(CheckForPendingAdditiveSceneList);
+            clientSceneManager.ClientStartSceneMessage(client.Player, new SceneMessage { MainActivateScene = "Assets/Mirror/Tests/Runtime/testScene.unity", AdditiveScenes = new List<string> { "Assets/Mirror/Tests/Runtime/testScene.unity" } });
+
+            await AsyncUtil.WaitUntilWithTimeout(() => noAdditiveScenesFound);
+
+            Assert.That(noAdditiveScenesFound);
+        });
+
+        bool noAdditiveScenesFound;
+        void CheckForPendingAdditiveSceneList(string scenePath, SceneOperation sceneOperation)
+        {
+            if (clientSceneManager.ClientPendingAdditiveSceneLoadingList.Count == 0)
+            {
+                noAdditiveScenesFound = true;
+            }
         }
 
         [Test]
         public void ClientSceneMessagePendingAdditiveSceneListTest()
         {
             //Check for the additive scene in the pending list at the time of ClientChangeScene before its removed as part of it being loaded.
-            clientSceneManager.ClientChangeScene.AddListener(CheckForAdditiveScene);
-            clientSceneManager.ClientSceneMessage(client.Player, new SceneMessage { scenePath = "Assets/Mirror/Tests/Runtime/testScene.unity", additiveScenes = new[] { "Assets/Mirror/Tests/Runtime/testScene.unity" } });
+            clientSceneManager.OnClientStartedSceneChange.AddListener(CheckForAdditiveScene);
+            clientSceneManager.ClientStartSceneMessage(client.Player, new SceneMessage { MainActivateScene = "Assets/Mirror/Tests/Runtime/testScene.unity", AdditiveScenes = new List<string> { "Assets/Mirror/Tests/Runtime/testScene.unity" } });
 
             Assert.That(additiveSceneWasFound);
         }
@@ -154,7 +194,7 @@ public void ClientSceneMessagePendingAdditiveSceneListTest()
         bool additiveSceneWasFound;
         void CheckForAdditiveScene(string scenePath, SceneOperation sceneOperation)
         {
-            if (clientSceneManager.pendingAdditiveSceneList.Contains("Assets/Mirror/Tests/Runtime/testScene.unity"))
+            if (clientSceneManager.ClientPendingAdditiveSceneLoadingList.Contains("Assets/Mirror/Tests/Runtime/testScene.unity"))
             {
                 additiveSceneWasFound = true;
             }
diff --git a/Assets/Tests/Runtime/ClientServer/NetworkServerTests.cs b/Assets/Tests/Runtime/ClientServer/NetworkServerTests.cs
index 43ceb4b365d..c702cff016b 100644
--- a/Assets/Tests/Runtime/ClientServer/NetworkServerTests.cs
+++ b/Assets/Tests/Runtime/ClientServer/NetworkServerTests.cs
@@ -47,10 +47,10 @@ public void ThrowsIfListenIsCalledWhileAlreadyActive()
         {
             clientPlayer.Send(new ReadyMessage());
 
-            await AsyncUtil.WaitUntilWithTimeout(() => serverPlayer.IsReady);
+            await AsyncUtil.WaitUntilWithTimeout(() => serverPlayer.SceneIsReady);
 
             // ready?
-            Assert.That(serverPlayer.IsReady, Is.True);
+            Assert.That(serverPlayer.SceneIsReady, Is.True);
         });
 
         [UnityTest]
diff --git a/Assets/Tests/Runtime/ClientServer/ServerObjectManagerTests.cs b/Assets/Tests/Runtime/ClientServer/ServerObjectManagerTests.cs
index 3733211fe53..2dbd6a7a9ff 100644
--- a/Assets/Tests/Runtime/ClientServer/ServerObjectManagerTests.cs
+++ b/Assets/Tests/Runtime/ClientServer/ServerObjectManagerTests.cs
@@ -75,7 +75,7 @@ public void ThrowsIfSpawnCalledWithOwnerWithNoOwnerTest()
 
             ClientMessageHandler.RegisterHandler<SpawnMessage>(msg => invoked = true);
 
-            serverPlayer.IsReady = true;
+            serverPlayer.SceneIsReady = true;
 
             // call ShowForConnection
             serverObjectManager.ShowForConnection(serverIdentity, serverPlayer);
diff --git a/Assets/Tests/Runtime/Host/CharacterSpawnerTest.cs b/Assets/Tests/Runtime/Host/CharacterSpawnerTest.cs
index 3cd6a119196..a7a098b1188 100644
--- a/Assets/Tests/Runtime/Host/CharacterSpawnerTest.cs
+++ b/Assets/Tests/Runtime/Host/CharacterSpawnerTest.cs
@@ -43,7 +43,7 @@ public override void ExtraTearDown()
             bool invokeAddPlayerMessage = false;
             ServerMessageHandler.RegisterHandler<AddCharacterMessage>(msg => invokeAddPlayerMessage = true);
 
-            sceneManager.ChangeServerScene("Assets/Mirror/Tests/Runtime/testScene.unity");
+            sceneManager.ServerLoadSceneNormal("Assets/Mirror/Tests/Runtime/testScene.unity");
             // wait for messages to be processed
             await UniTask.Yield();
 
diff --git a/Assets/Tests/Runtime/Host/HostComponentTests.cs b/Assets/Tests/Runtime/Host/HostComponentTests.cs
index 8c98e31ec75..ee2f66ee944 100644
--- a/Assets/Tests/Runtime/Host/HostComponentTests.cs
+++ b/Assets/Tests/Runtime/Host/HostComponentTests.cs
@@ -101,7 +101,7 @@ public void StoppingHostShouldCallDisconnectedOnLocalClient()
             await UniTask.WaitUntil(() => !server.Active);
 
             UnityAction<string, SceneOperation> mockListener = Substitute.For<UnityAction<string, SceneOperation>>();
-            sceneManager.ClientChangeScene.AddListener(mockListener);
+            sceneManager.OnClientStartedSceneChange.AddListener(mockListener);
             await StartHost();
 
             client.Update();
diff --git a/Assets/Tests/Runtime/Host/NetworkSceneManagerTests.cs b/Assets/Tests/Runtime/Host/NetworkSceneManagerTests.cs
index 9e8f3a2e56c..4d660592909 100644
--- a/Assets/Tests/Runtime/Host/NetworkSceneManagerTests.cs
+++ b/Assets/Tests/Runtime/Host/NetworkSceneManagerTests.cs
@@ -1,8 +1,11 @@
 using System;
 using System.Collections;
+using System.Collections.Generic;
+using System.Linq;
 using Cysharp.Threading.Tasks;
 using NSubstitute;
 using NUnit.Framework;
+using UnityEditor.SceneManagement;
 using UnityEngine;
 using UnityEngine.Events;
 using UnityEngine.SceneManagement;
@@ -21,7 +24,7 @@ public override void ExtraSetup()
             bundle = AssetBundle.LoadFromFile("Assets/Tests/Runtime/TestScene/testscene");
 
             sceneEventFunction = Substitute.For<UnityAction<string, SceneOperation>>();
-            sceneManager.ServerSceneChanged.AddListener(sceneEventFunction);
+            sceneManager.OnServerFinishedSceneChange.AddListener(sceneEventFunction);
         }
 
         public override void ExtraTearDown()
@@ -35,10 +38,10 @@ public void FinishLoadSceneHostTest()
             UnityAction<string, SceneOperation> func2 = Substitute.For<UnityAction<string, SceneOperation>>();
             UnityAction<string, SceneOperation> func3 = Substitute.For<UnityAction<string, SceneOperation>>();
 
-            sceneManager.ServerSceneChanged.AddListener(func2);
-            sceneManager.ClientSceneChanged.AddListener(func3);
+            sceneManager.OnServerFinishedSceneChange.AddListener(func2);
+            sceneManager.OnClientFinishedSceneChange.AddListener(func3);
 
-            sceneManager.FinishLoadScene("test", SceneOperation.Normal);
+            sceneManager.CompleteLoadingScene("test", SceneOperation.Normal);
 
             func2.Received(1).Invoke(Arg.Any<string>(), Arg.Any<SceneOperation>());
             func3.Received(1).Invoke(Arg.Any<string>(), Arg.Any<SceneOperation>());
@@ -53,9 +56,9 @@ public void FinishLoadSceneHostTest()
 
             await AsyncUtil.WaitUntilWithTimeout(() => !client.Active);
 
-            sceneManager.ServerSceneChanged.AddListener(func1);
+            sceneManager.OnServerFinishedSceneChange.AddListener(func1);
 
-            sceneManager.FinishLoadScene("test", SceneOperation.Normal);
+            sceneManager.CompleteLoadingScene("test", SceneOperation.Normal);
 
             func1.Received(1).Invoke(Arg.Any<string>(), Arg.Any<SceneOperation>());
         });
@@ -68,14 +71,14 @@ public void FinishLoadSceneHostTest()
             UnityAction<string, SceneOperation> func1 = Substitute.For<UnityAction<string, SceneOperation>>();
             ClientMessageHandler.RegisterHandler<SceneMessage>(msg => invokeClientSceneMessage = true);
             ClientMessageHandler.RegisterHandler<NotReadyMessage>(msg => invokeNotReadyMessage = true);
-            sceneManager.ServerChangeScene.AddListener(func1);
+            sceneManager.OnServerStartedSceneChange.AddListener(func1);
 
-            sceneManager.ChangeServerScene("Assets/Mirror/Tests/Runtime/testScene.unity");
+            sceneManager.ServerLoadSceneNormal("Assets/Mirror/Tests/Runtime/testScene.unity");
 
-            await AsyncUtil.WaitUntilWithTimeout(() => sceneManager.ActiveScenePath.Equals("Assets/Mirror/Tests/Runtime/testScene.unity"));
+            await AsyncUtil.WaitUntilWithTimeout(() => sceneManager.ActiveScenePath != null);
 
             func1.Received(1).Invoke(Arg.Any<string>(), Arg.Any<SceneOperation>());
-            Assert.That(sceneManager.ActiveScenePath, Is.EqualTo("Assets/Mirror/Tests/Runtime/testScene.unity"));
+            Assert.That(sceneManager.ActiveScenePath, Is.Not.Null);
             Assert.That(invokeClientSceneMessage, Is.True);
             Assert.That(invokeNotReadyMessage, Is.True);
         });
@@ -86,20 +89,26 @@ public void ServerChangedFiredOnceTest()
             sceneEventFunction.Received(1).Invoke(Arg.Any<string>(), Arg.Any<SceneOperation>());
         }
 
+        [Test]
+        public void CheckServerSceneDataNotEmptyTest()
+        {
+            Assert.That(sceneManager.ServerSceneData, Is.Not.Null);
+        }
+
         [Test]
         public void ChangeServerSceneExceptionTest()
         {
             Assert.Throws<ArgumentNullException>(() =>
             {
-                sceneManager.ChangeServerScene(string.Empty);
+                sceneManager.ServerLoadSceneNormal(string.Empty);
             });
         }
 
         [Test]
         public void ReadyTest()
         {
-            sceneManager.SetClientReady();
-            Assert.That(client.Player.IsReady);
+            sceneManager.SetSceneIsReady();
+            Assert.That(client.Player.SceneIsReady);
         }
 
         [UnityTest]
@@ -111,7 +120,7 @@ public void ReadyTest()
 
             Assert.Throws<InvalidOperationException>(() =>
             {
-                sceneManager.SetClientReady();
+                sceneManager.SetSceneIsReady();
             });
         });
 
@@ -119,9 +128,9 @@ public void ReadyTest()
         public void ClientChangeSceneTest()
         {
             UnityAction<string, SceneOperation> func1 = Substitute.For<UnityAction<string, SceneOperation>>();
-            sceneManager.ClientChangeScene.AddListener(func1);
+            sceneManager.OnClientStartedSceneChange.AddListener(func1);
 
-            sceneManager.OnClientChangeScene("", SceneOperation.Normal);
+            sceneManager.OnClientStartedSceneChange.Invoke("", SceneOperation.Normal);
 
             func1.Received(1).Invoke(Arg.Any<string>(), Arg.Any<SceneOperation>());
         }
@@ -130,8 +139,8 @@ public void ClientChangeSceneTest()
         public void ClientSceneChangedTest()
         {
             UnityAction<string, SceneOperation> func1 = Substitute.For<UnityAction<string, SceneOperation>>();
-            sceneManager.ClientSceneChanged.AddListener(func1);
-            sceneManager.OnClientSceneChanged("test", SceneOperation.Normal);
+            sceneManager.OnClientFinishedSceneChange.AddListener(func1);
+            sceneManager.OnClientFinishedSceneChange.Invoke("test", SceneOperation.Normal);
             func1.Received(1).Invoke(Arg.Any<string>(), Arg.Any<SceneOperation>());
         }
 
@@ -139,8 +148,8 @@ public void ClientSceneChangedTest()
         public void ClientSceneReadyAfterChangedTest()
         {
             bool _readyAfterSceneChanged = false;
-            sceneManager.ClientSceneChanged.AddListener((string name, SceneOperation operation) => _readyAfterSceneChanged = client.Player.IsReady);
-            sceneManager.OnClientSceneChanged("test", SceneOperation.Normal);
+            sceneManager.OnClientFinishedSceneChange.AddListener((string name, SceneOperation operation) => _readyAfterSceneChanged = client.Player.SceneIsReady);
+            sceneManager.OnClientFinishedSceneChange.Invoke("test", SceneOperation.Normal);
 
             Assert.That(_readyAfterSceneChanged, Is.True);
         }
@@ -148,35 +157,182 @@ public void ClientSceneReadyAfterChangedTest()
         [UnityTest]
         public IEnumerator ChangeSceneAdditiveLoadTest() => UniTask.ToCoroutine(async () =>
         {
-            sceneManager.ChangeServerScene("Assets/Mirror/Tests/Runtime/testScene.unity", SceneOperation.LoadAdditive);
+            sceneManager.ServerLoadSceneAdditively("Assets/Mirror/Tests/Runtime/testScene.unity", new[] { client.Player });
 
-            await AsyncUtil.WaitUntilWithTimeout(() => SceneManager.GetSceneByName("testScene") != null);
+            await AsyncUtil.WaitUntilWithTimeout(() => sceneManager.ActiveScenePath != null);
 
-            Assert.That(SceneManager.GetSceneByName("testScene"), Is.Not.Null);
+            Assert.That(sceneManager.ActiveScenePath, Is.Not.Null);
         });
 
         [Test]
         public void ClientChangeSceneNotNullTest()
         {
-            Assert.That(sceneManager.ClientChangeScene, Is.Not.Null);
+            Assert.That(sceneManager.OnClientStartedSceneChange, Is.Not.Null);
         }
 
         [Test]
         public void ClientSceneChangedNotNullTest()
         {
-            Assert.That(sceneManager.ClientSceneChanged, Is.Not.Null);
+            Assert.That(sceneManager.OnClientFinishedSceneChange, Is.Not.Null);
         }
 
         [Test]
         public void ServerChangeSceneNotNullTest()
         {
-            Assert.That(sceneManager.ServerChangeScene, Is.Not.Null);
+            Assert.That(sceneManager.OnServerStartedSceneChange, Is.Not.Null);
         }
 
         [Test]
         public void ServerSceneChangedNotNullTest()
         {
-            Assert.That(sceneManager.ServerSceneChanged, Is.Not.Null);
+            Assert.That(sceneManager.OnServerFinishedSceneChange, Is.Not.Null);
+        }
+
+        [Test]
+        public void ServerCheckScenesPlayerIsInTest()
+        {
+            sceneManager.ServerLoadSceneNormal("Assets/Mirror/Tests/Runtime/testScene.unity");
+
+            Scene[] scenes = sceneManager.ScenesPlayerIsIn(server.LocalPlayer);
+
+            Assert.That(scenes, Is.Not.Null);
+        }
+
+        [UnityTest]
+        public IEnumerator ClientNotReadyMessageTest() => UniTask.ToCoroutine(async () =>
+        {
+            sceneManager.ClientNotReadyMessage(client.Player, new NotReadyMessage());
+
+            await UniTask.Delay(1);
+
+            Assert.That(sceneManager.Client.Player.SceneIsReady, Is.Not.True);
+        });
+
+        [Test]
+        public void ServerUnloadSceneCheckServerNotNullTest()
+        {
+            sceneManager.ServerLoadSceneNormal("Assets/Mirror/Tests/Runtime/testScene.unity");
+
+            sceneManager.Server = null;
+
+            InvalidOperationException exception = Assert.Throws<InvalidOperationException>(() =>
+            {
+                sceneManager.ServerUnloadSceneAdditively(SceneManager.GetActiveScene(), new[] { server.LocalPlayer });
+            });
+
+            string message = new InvalidOperationException("Server is not active or is null").Message;
+            Assert.That(exception, Has.Message.EqualTo(message));
+        }
+
+        [Test]
+        public void ServerUnloadSceneAdditivelySceneNotNullTest()
+        {
+            sceneManager.ServerLoadSceneNormal("Assets/Mirror/Tests/Runtime/testScene.unity");
+
+            ArgumentNullException exception = Assert.Throws<ArgumentNullException>(() =>
+            {
+                sceneManager.ServerUnloadSceneAdditively(new Scene(), null);
+            });
+
+            string message = new ArgumentNullException("scene", "[NetworkSceneManager] - ServerChangeScene: " + "scene" + " cannot be null").Message;
+            Assert.That(exception, Has.Message.EqualTo(message));
+        }
+
+
+        [Test]
+        public void ServerUnloadSceneAdditivelyPlayersNotNullTest()
+        {
+            sceneManager.ServerLoadSceneNormal("Assets/Mirror/Tests/Runtime/testScene.unity");
+
+            ArgumentNullException exception = Assert.Throws<ArgumentNullException>(() =>
+            {
+                sceneManager.ServerUnloadSceneAdditively(SceneManager.GetActiveScene(), null);
+            });
+
+            string message = new ArgumentNullException("players", "[NetworkSceneManager] - list of player's cannot be null or no players.").Message;
+            Assert.That(exception, Has.Message.EqualTo(message));
         }
+
+        [UnityTest]
+        public IEnumerator ServerUnloadSceneAdditivelyListenerInvokedTest() => UniTask.ToCoroutine(async () =>
+        {
+            bool _invokedOnServerStartedSceneChange = false;
+
+            sceneManager.ServerLoadSceneNormal("Assets/Mirror/Tests/Runtime/testScene.unity");
+
+            await EditorSceneManager.LoadSceneAsyncInPlayMode("Assets/Tests/Performance/Runtime/10K/Scenes/Scene.unity", new LoadSceneParameters { loadSceneMode = LoadSceneMode.Additive });
+
+            sceneManager.OnServerStartedSceneChange.AddListener((arg0, operation) => _invokedOnServerStartedSceneChange = true);
+
+            sceneManager.ServerUnloadSceneAdditively(SceneManager.GetActiveScene(), new[] { server.LocalPlayer });
+
+            await AsyncUtil.WaitUntilWithTimeout(() => _invokedOnServerStartedSceneChange);
+
+            Assert.That(_invokedOnServerStartedSceneChange, Is.True);
+        });
+
+        [Test]
+        public void ServerSceneLoadingNullPlayersCheckTest()
+        {
+            ArgumentNullException exception = Assert.Throws<ArgumentNullException>(() =>
+            {
+                sceneManager.ServerLoadSceneAdditively("Assets/Mirror/Tests/Runtime/testScene.unity", null);
+            });
+
+            string message = new ArgumentNullException("players", "No player's were added to send for information").Message;
+            Assert.That(exception, Has.Message.EqualTo(message));
+        }
+
+        [Test]
+        public void IsPlayerInSceneThrowForInvalidScene()
+        {
+            ArgumentException exception = Assert.Throws<ArgumentException>(() =>
+            {
+                sceneManager.IsPlayerInScene(default, server.LocalPlayer);
+            });
+
+            string message = new ArgumentException("Scene is not valid", "scene").Message;
+            Assert.That(exception, Has.Message.EqualTo(message));
+        }
+        [Test]
+        public void IsPlayerInSceneThrowForNotFoundScene()
+        {
+            Scene scene = SceneManager.CreateScene("Not Found Scene");
+            KeyNotFoundException exception = Assert.Throws<KeyNotFoundException>(() =>
+            {
+                sceneManager.IsPlayerInScene(scene, server.LocalPlayer);
+            });
+
+            string message = new KeyNotFoundException($"Could not find player list for scene:{scene}").Message;
+            Assert.That(exception, Has.Message.EqualTo(message));
+
+            // cleanup
+            SceneManager.UnloadSceneAsync(scene);
+        }
+
+
+        [UnityTest]
+        public IEnumerator OnServerDisconnectPlayerTest() => UniTask.ToCoroutine(async () =>
+        {
+            sceneManager.ServerLoadSceneNormal("Assets/Mirror/Tests/Runtime/testScene.unity");
+
+            await AsyncUtil.WaitUntilWithTimeout(() => sceneManager.ServerSceneData.Count > 0);
+
+            sceneManager.OnServerPlayerDisconnected(sceneManager.Server.Players.ElementAt(0));
+
+            Assert.That(sceneManager.IsPlayerInScene(sceneManager.ServerSceneData.ElementAt(0).Key,
+                server.Players.ElementAt(0)), Is.False);
+        });
+
+        [UnityTest]
+        public IEnumerator IsPlayerInSceneTest() => UniTask.ToCoroutine(async () =>
+        {
+            sceneManager.ServerLoadSceneNormal("Assets/Mirror/Tests/Runtime/testScene.unity");
+
+            await AsyncUtil.WaitUntilWithTimeout(() => sceneManager.ServerSceneData.Count > 0);
+
+            Assert.That(sceneManager.IsPlayerInScene(sceneManager.ServerSceneData.ElementAt(0).Key, server.Players.ElementAt(0)),
+                Is.True);
+        });
     }
 }
diff --git a/Assets/Tests/Runtime/Host/ServerObjectManagerTest.cs b/Assets/Tests/Runtime/Host/ServerObjectManagerTest.cs
index d058487b10e..196e1371a0c 100644
--- a/Assets/Tests/Runtime/Host/ServerObjectManagerTest.cs
+++ b/Assets/Tests/Runtime/Host/ServerObjectManagerTest.cs
@@ -17,13 +17,13 @@ public class ServerObjectManagerHostTest : HostSetup<MockComponent>
         public void SetClientReadyAndNotReadyTest()
         {
             (_, NetworkPlayer connection) = PipedConnections(ClientMessageHandler, ServerMessageHandler);
-            Assert.That(connection.IsReady, Is.False);
+            Assert.That(connection.SceneIsReady, Is.False);
 
             serverObjectManager.SetClientReady(connection);
-            Assert.That(connection.IsReady, Is.True);
+            Assert.That(connection.SceneIsReady, Is.True);
 
             serverObjectManager.SetClientNotReady(connection);
-            Assert.That(connection.IsReady, Is.False);
+            Assert.That(connection.SceneIsReady, Is.False);
         }
 
         [Test]
@@ -31,18 +31,18 @@ public void SetAllClientsNotReadyTest()
         {
             // add first ready client
             (_, NetworkPlayer first) = PipedConnections(ClientMessageHandler, ServerMessageHandler);
-            first.IsReady = true;
+            first.SceneIsReady = true;
             server.Players.Add(first);
 
             // add second ready client
             (_, NetworkPlayer second) = PipedConnections(ClientMessageHandler, ServerMessageHandler);
-            second.IsReady = true;
+            second.SceneIsReady = true;
             server.Players.Add(second);
 
             // set all not ready
             serverObjectManager.SetAllClientsNotReady();
-            Assert.That(first.IsReady, Is.False);
-            Assert.That(second.IsReady, Is.False);
+            Assert.That(first.SceneIsReady, Is.False);
+            Assert.That(second.SceneIsReady, Is.False);
         }
 
 
diff --git a/Assets/Tests/Runtime/MessagePackerTest.cs b/Assets/Tests/Runtime/MessagePackerTest.cs
index 06b3ebe89dd..9b95bf99d5b 100644
--- a/Assets/Tests/Runtime/MessagePackerTest.cs
+++ b/Assets/Tests/Runtime/MessagePackerTest.cs
@@ -28,16 +28,16 @@ public void TestPacking()
         {
             var message = new SceneMessage
             {
-                scenePath = "Hello world",
-                sceneOperation = SceneOperation.LoadAdditive
+                MainActivateScene = "Hello world",
+                SceneOperation = SceneOperation.LoadAdditive
             };
 
             byte[] data = MessagePacker.Pack(message);
 
             SceneMessage unpacked = MessagePacker.Unpack<SceneMessage>(data);
 
-            Assert.That(unpacked.scenePath, Is.EqualTo("Hello world"));
-            Assert.That(unpacked.sceneOperation, Is.EqualTo(SceneOperation.LoadAdditive));
+            Assert.That(unpacked.MainActivateScene, Is.EqualTo("Hello world"));
+            Assert.That(unpacked.SceneOperation, Is.EqualTo(SceneOperation.LoadAdditive));
         }
 
         [Test]
@@ -61,8 +61,8 @@ public void TestUnpackIdMismatch()
 
             var message = new SceneMessage
             {
-                scenePath = "Hello world",
-                sceneOperation = SceneOperation.LoadAdditive
+                MainActivateScene = "Hello world",
+                SceneOperation = SceneOperation.LoadAdditive
             };
 
             byte[] data = MessagePacker.Pack(message);
@@ -84,8 +84,8 @@ public void TestUnpackMessageNonGeneric()
             // try a regular message
             var message = new SceneMessage
             {
-                scenePath = "Hello world",
-                sceneOperation = SceneOperation.LoadAdditive
+                MainActivateScene = "Hello world",
+                SceneOperation = SceneOperation.LoadAdditive
             };
 
             byte[] data = MessagePacker.Pack(message);
diff --git a/Assets/Tests/Runtime/NetworkIdentityCallbackTests.cs b/Assets/Tests/Runtime/NetworkIdentityCallbackTests.cs
index 5415f031941..25621711ad4 100644
--- a/Assets/Tests/Runtime/NetworkIdentityCallbackTests.cs
+++ b/Assets/Tests/Runtime/NetworkIdentityCallbackTests.cs
@@ -50,8 +50,8 @@ public override void ExtraTearDown()
         [Test]
         public void AddAllReadyServerConnectionsToObservers()
         {
-            player1.IsReady.Returns(true);
-            player2.IsReady.Returns(false);
+            player1.SceneIsReady.Returns(true);
+            player2.SceneIsReady.Returns(false);
 
             // add some server connections
             server.Players.Add(player1);
@@ -60,7 +60,7 @@ public void AddAllReadyServerConnectionsToObservers()
             // add a host connection
             server.AddLocalConnection(client, Substitute.For<SocketLayer.IConnection>());
             server.InvokeLocalConnected();
-            server.LocalPlayer.IsReady = true;
+            server.LocalPlayer.SceneIsReady = true;
 
             // call OnStartServer so that observers dict is created
             identity.StartServer();
@@ -84,7 +84,7 @@ public void RebuildObserversAddsOwnReadyPlayer()
 
             // add own player connection
             (NetworkPlayer serverPlayer, NetworkPlayer _) = PipedConnections(Substitute.For<IMessageReceiver>(), Substitute.For<IMessageReceiver>());
-            serverPlayer.IsReady = true;
+            serverPlayer.SceneIsReady = true;
             identity.ConnectionToClient = serverPlayer;
 
             // call OnStartServer so that observers dict is created
diff --git a/Assets/Tests/Runtime/NetworkMatchCheckerTest.cs b/Assets/Tests/Runtime/NetworkMatchCheckerTest.cs
index 248f25ab47d..86b47266864 100644
--- a/Assets/Tests/Runtime/NetworkMatchCheckerTest.cs
+++ b/Assets/Tests/Runtime/NetworkMatchCheckerTest.cs
@@ -71,7 +71,7 @@ static NetworkPlayer CreatePlayer(GameObject character)
                 Identity = character.GetComponent<NetworkIdentity>()
             };
             player.Identity.ConnectionToClient = player;
-            player.IsReady = true;
+            player.SceneIsReady = true;
             return player;
         }
 
diff --git a/doc/Articles/Guides/MirrorMigration.md b/doc/Articles/Guides/MirrorMigration.md
index e4a909b3dfd..67c1eac3b86 100644
--- a/doc/Articles/Guides/MirrorMigration.md
+++ b/doc/Articles/Guides/MirrorMigration.md
@@ -182,7 +182,7 @@ These fields/properties have been renamed:
 | Mirror                                | Mirage                                                                                 |
 |:-------------------------------------:|:--------------------------------------------------------------------------------------:|
 | `ClientScene.localPlayer`             | [NetworkPlayer.Identity](xref:Mirage.NetworkPlayer.Identity)             |
-| `ClientScene.ready`                   | [NetworkClient.Connection.IsReady](xref:Mirage.NetworkPlayer.IsReady)                  |
+| `ClientScene.ready`                   | [NetworkClient.Connection.SceneIsReady](xref:Mirage.NetworkPlayer.SceneIsReady)                  |
 | `NetworkIdentity.assetId`             | [NetworkIdentity.AssetId](xref:Mirage.NetworkIdentity.AssetId)                         |
 | `NetworkIdentity.netId`               | [NetworkIdentity.NetId](xref:Mirage.NetworkIdentity.NetId)                             |
 | `NetworkIdentity.connectionToClient`  | [NetworkIdentity.ConnectionToClient](xref:Mirage.NetworkIdentity.ConnectionToClient)   |
@@ -194,7 +194,7 @@ These fields/properties have been renamed:
 | `NetworkBehaviour.netId`              | [NetworkBehaviour.NetId](xref:Mirage.NetworkBehaviour.NetId)                           |
 | `NetworkBehaviour.isClientOnly`       | [NetworkBehaviour.IsClientOnly](xref:Mirage.NetworkBehaviour.IsClientOnly)             |
 | `NetworkBehaviour.islocalPlayer`      | [NetworkBehaviour.IsLocalPlayer](xref:Mirage.NetworkBehaviour.IsLocalPlayer)           |
-| `NetworkConnection.isReady`           | [NetworkPlayer.IsReady](xref:Mirage.NetworkPlayer.IsReady)                             |
+| `NetworkConnection.isReady`           | [NetworkPlayer.SceneIsReady](xref:Mirage.NetworkPlayer.SceneIsReady)                             |
 | `NetworkConnection.identity`          | [NetworkPlayer.Identity](xref:Mirage.NetworkPlayer.Identity)                           |
 | `NetworkServer.active`                | [NetworkServer.Active](xref:Mirage.NetworkServer.Active)                               |
 | `NetworkServer.localConnection`       | [NetworkServer.LocalPlayer](xref:Mirage.NetworkServer.LocalPlayer)                     |

From 65d103413e4dd95eef07c0925866c942945a3ddb Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Thu, 2 Sep 2021 15:31:24 +0000
Subject: [PATCH 166/166] chore(release): 102.0.0 [skip ci]

# [102.0.0](https://github.com/MirageNet/Mirage/compare/v101.10.0...v102.0.0) (2021-09-02)

### Features

* new improved scene manager  ([#892](https://github.com/MirageNet/Mirage/issues/892)) ([2a9bdec](https://github.com/MirageNet/Mirage/commit/2a9bdec6887bc67e7f53bb46f13592607b5c72b8))

### BREAKING CHANGES

* NetworkSceneManager has been re-written, many events and methods now have new names.
---
 Assets/Mirage/Authenticators/AssemblyInfo.cs         |  2 +-
 Assets/Mirage/CHANGELOG.md                           | 12 ++++++++++++
 Assets/Mirage/Components/AssemblyInfo.cs             |  2 +-
 Assets/Mirage/Runtime/AssemblyInfo.cs                |  2 +-
 Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs    |  2 +-
 Assets/Mirage/Samples~/AssemblyInfo.cs               |  2 +-
 .../RigidbodyPhysics/Scripts/AssemblyInfo.cs         |  2 +-
 Assets/Mirage/package.json                           |  4 ++--
 8 files changed, 20 insertions(+), 8 deletions(-)

diff --git a/Assets/Mirage/Authenticators/AssemblyInfo.cs b/Assets/Mirage/Authenticators/AssemblyInfo.cs
index 4f346db0e8b..d8c25514ce6 100644
--- a/Assets/Mirage/Authenticators/AssemblyInfo.cs
+++ b/Assets/Mirage/Authenticators/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.10.0")]
+[assembly: AssemblyVersion("102.0.0")]
diff --git a/Assets/Mirage/CHANGELOG.md b/Assets/Mirage/CHANGELOG.md
index 99bc299dc52..1216a40d8be 100644
--- a/Assets/Mirage/CHANGELOG.md
+++ b/Assets/Mirage/CHANGELOG.md
@@ -1,3 +1,15 @@
+# [102.0.0](https://github.com/MirageNet/Mirage/compare/v101.10.0...v102.0.0) (2021-09-02)
+
+
+### Features
+
+* new improved scene manager  ([#892](https://github.com/MirageNet/Mirage/issues/892)) ([2a9bdec](https://github.com/MirageNet/Mirage/commit/2a9bdec6887bc67e7f53bb46f13592607b5c72b8))
+
+
+### BREAKING CHANGES
+
+* NetworkSceneManager has been re-written, many events and methods now have new names.
+
 # [101.10.0](https://github.com/MirageNet/Mirage/compare/v101.9.2...v101.10.0) (2021-08-31)
 
 
diff --git a/Assets/Mirage/Components/AssemblyInfo.cs b/Assets/Mirage/Components/AssemblyInfo.cs
index d2d729f5145..c18c8af63f1 100644
--- a/Assets/Mirage/Components/AssemblyInfo.cs
+++ b/Assets/Mirage/Components/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.10.0")]
+[assembly: AssemblyVersion("102.0.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Runtime")]
diff --git a/Assets/Mirage/Runtime/AssemblyInfo.cs b/Assets/Mirage/Runtime/AssemblyInfo.cs
index 7f96fc34e58..c3a7358a426 100644
--- a/Assets/Mirage/Runtime/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/AssemblyInfo.cs
@@ -1,7 +1,7 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.10.0")]
+[assembly: AssemblyVersion("102.0.0")]
 
 [assembly: InternalsVisibleTo("Mirage.Tests.Common")]
 [assembly: InternalsVisibleTo("Mirage.Tests")]
diff --git a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
index 5c660c71881..1bb36d15d06 100644
--- a/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
+++ b/Assets/Mirage/Runtime/SocketLayer/AssemblyInfo.cs
@@ -1,6 +1,6 @@
 using System.Reflection;
 using System.Runtime.CompilerServices;
 
-[assembly: AssemblyVersion("101.10.0")]
+[assembly: AssemblyVersion("102.0.0")]
 
 [assembly: InternalsVisibleTo("Mirage.SocketLayer.Tests")]
diff --git a/Assets/Mirage/Samples~/AssemblyInfo.cs b/Assets/Mirage/Samples~/AssemblyInfo.cs
index 4f346db0e8b..d8c25514ce6 100644
--- a/Assets/Mirage/Samples~/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.10.0")]
+[assembly: AssemblyVersion("102.0.0")]
diff --git a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
index 4f346db0e8b..d8c25514ce6 100644
--- a/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
+++ b/Assets/Mirage/Samples~/RigidbodyPhysics/Scripts/AssemblyInfo.cs
@@ -1,3 +1,3 @@
 using System.Reflection;
 
-[assembly: AssemblyVersion("101.10.0")]
+[assembly: AssemblyVersion("102.0.0")]
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
index 521ec77fe44..8b8ce86f7da 100644
--- a/Assets/Mirage/package.json
+++ b/Assets/Mirage/package.json
@@ -1,7 +1,7 @@
 {
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
-    "version": "101.10.0",
+    "version": "102.0.0",
     "unity": "2019.1",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",
@@ -50,4 +50,4 @@
             "path": "Samples~/Tanks"
         }
     ]
-}
\ No newline at end of file
+}