build!: Drop Unity 2020.3 LTS support

James-Frowen · James-Frowen · commit 989a7842bced · 2025-07-04T18:38:17.000+01:00
BREAKING CHANGE: Unity 2020.3 LTS is no longer supported due to end-of-life and incompatibility with recent fixes. The minimum supported version is now 2021.3 LTS.
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
@@ -23,7 +23,7 @@ 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-2021.3.5f1-base-3.0.0
+    container: unityci/editor:ubuntu-2021.3.30f1-base-3.0.0
 
     steps:
       - name: Activate unity
@@ -42,18 +42,11 @@ jobs:
         uses: actions/cache@v4
         with:
           path: Library
-          key: Library-2021.3.5
+          key: Library-2021.3.30
 
       - name: Generate Solution
         run: unity-editor -nographics -logFile /dev/stdout -customBuildName Mirage -projectPath . -executeMethod GitTools.Solution.Sync -quit
 
-      # unity 2020.3 outputs <ReferenceOutputAssembly>false</ReferenceOutputAssembly> on linux
-      # this breaks references to other csproj for docfx and sonar.
-      # This step is a work around for this so docfx runs in correctly
-      # replacing false with true in ReferenceOutputAssembly
-      - name: Fix Csproj
-        run: sed -i 's/<ReferenceOutputAssembly>false<\/ReferenceOutputAssembly>/<ReferenceOutputAssembly>true<\/ReferenceOutputAssembly>/g' *.csproj
-
       - uses: nikeee/docfx-action@v1.0.0
         with:
           args: metadata --logLevel Warning doc/docfx.json
diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
@@ -16,17 +16,6 @@ on:
 # https://hub.docker.com/r/unityci/editor/tags?page=1&ordering=last_updated&name=ubuntu-2020.1.17f1-base
 
 jobs:
-  Tests2020:
-    # note: reuseable workflow is a job, not a step
-    name: Run Tests 2020
-    uses: ./.github/workflows/run-test.yml
-    secrets: 
-      unity_license: ${{ secrets.UNITY_LICENSE2 }}
-      access_token: ${{ secrets.GITHUB_TOKEN }}
-    with:
-      unity_container: unityci/editor:ubuntu-2020.3.30f1-base-3.0.0
-      cache_key: Library-2020.3.30
-      test_results_name: Test results 2020
 
   Tests2021:
     name: Run Tests 2021
@@ -35,8 +24,8 @@ jobs:
       unity_license: ${{ secrets.UNITY_LICENSE_2021_3_4 }}
       access_token: ${{ secrets.GITHUB_TOKEN }}
     with:
-      unity_container: unityci/editor:ubuntu-2021.3.5f1-base-3.0.0
-      cache_key: Library-2021.3.5
+      unity_container: unityci/editor:ubuntu-2021.3.30f1-base-3.0.0
+      cache_key: Library-2021.3.30
       test_results_name: Test results 2021
 
   Tests2022:
@@ -47,8 +36,8 @@ jobs:
       unity_license: ${{ secrets.UNITY_LICENSE_2021_3_4 }}
       access_token: ${{ secrets.GITHUB_TOKEN }}
     with:
-      unity_container: unityci/editor:ubuntu-2022.2.8f1-base-3.0.0
-      cache_key: Library-2022.2.8
+      unity_container: unityci/editor:ubuntu-2022.3.6f1-base-3.0.0
+      cache_key: Library-2022.3.6
       test_results_name: Test results 2022
   
   Tests6000:
@@ -59,14 +48,14 @@ jobs:
       unity_license: ${{ secrets.UNITY_LICENSE_2021_3_4 }}
       access_token: ${{ secrets.GITHUB_TOKEN }}
     with:
-      unity_container: unityci/editor:ubuntu-6000.0.37f1-base-3.1.0
-      cache_key: Library-6000.0.37
+      unity_container: unityci/editor:ubuntu-6000.0.52f1-base-3.1.0
+      cache_key: Library-6000.0.52
       test_results_name: Test results 6000
 
   BuildIL2CPP:
     name: BuildIL2CPP
     runs-on: ubuntu-latest
-    container: unityci/editor:ubuntu-2022.2.8f1-linux-il2cpp-3.0.0
+    container: unityci/editor:ubuntu-2022.3.6f1-linux-il2cpp-3.0.0
     
     steps:
       - name: Activate unity
@@ -95,7 +84,7 @@ jobs:
 
   Publish:
     # only run once both tests and il2cpp have passed
-    needs: [Tests2020, Tests2021, Tests2022, Tests6000, BuildIL2CPP]
+    needs: [Tests2021, Tests2022, Tests6000, BuildIL2CPP]
     # only run on main
     if: github.ref == 'refs/heads/main'
     name: Publish
@@ -170,13 +159,6 @@ jobs:
       
       - name: Generate Solution
         run: unity-editor -nographics -logFile /dev/stdout -customBuildName Mirage -projectPath . -executeMethod  UnityEditor.SyncVS.SyncSolution -quit
-      
-      # unity 2020.3 outputs <ReferenceOutputAssembly>false</ReferenceOutputAssembly> on linux
-      # this breaks references to other csproj for docfx and sonar.
-      # This step is a work around for this so docfx runs in correctly
-      # replacing false with true in ReferenceOutputAssembly
-      - name: Fix Csproj
-        run: sed -i 's/<ReferenceOutputAssembly>false<\/ReferenceOutputAssembly>/<ReferenceOutputAssembly>true<\/ReferenceOutputAssembly>/g' *.csproj
 
       - name: Get test coverages
         uses: actions/download-artifact@v4
diff --git a/.github/workflows/request-activation-file.yml b/.github/workflows/request-activation-file.yml
@@ -6,11 +6,11 @@ on:
       unity-version:
         description: 'What unityci container to use. Just need part after `ubuntu-`'     
         required: true
-        default: '2020.3.17f1-base-0.15.0'
+        default: '2021.3.30f1-base-3.0.0'
       license-file:
         description: 'Name of generated file, version expect -base...'     
         required: true
-        default: '2020.3.17f1'
+        default: '2021.3.30f1'
   
 jobs:
   requestActivationFile:
diff --git a/Assets/Mirage/package.json b/Assets/Mirage/package.json
@@ -2,7 +2,7 @@
     "name": "com.miragenet.mirage",
     "displayName": "Mirage",
     "version": "151.3.3",
-    "unity": "2020.3",
+    "unity": "2021.3",
     "description": "Mirage is a high level Networking API for Unity, supporting different low level Transports.",
     "author": "Mirage",
     "repository": {
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -123,7 +123,7 @@ We can always use more test coverage.
 * **Use the same coding style as the one used in this project**.
 * **Documentation:** If your PR adds or changes any public properties or methods, you must retain the old versions preceded with `[Obsolete("Describe what to do/use instead")` attribute wherever possible, and you must update any relevant pages in the `/docs` folder. It's not done until it's documented!
 * **Welcome suggestions from the maintainers to improve your pull request**.
-* **Include unit tests for new code.** Unit tests for new code helps us check if it works. See the [Unity Test Runner](https://docs.unity3d.com/2020.3/Documentation/Manual/testing-editortestsrunner.html) for more information about running tests in unity.
+* **Include unit tests for new code.** Unit tests for new code helps us check if it works. See the [Unity Test Runner](https://docs.unity3d.com/2021.3/Documentation/Manual/testing-editortestsrunner.html) for more information about running tests in unity.
 
 Please follow our coding conventions (below) and make sure all of your commits are atomic (one feature per commit). Rebase your pull requests if necessary.
 
diff --git a/README.md b/README.md
@@ -61,7 +61,7 @@ Mirage has some notable differences from its distant sister, Mirror. The table b
 | 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 2020.3 LTS or later                  | Supports Unity 2020.3 LTS or later     |
+| Supports Unity 2021.3 LTS or later                  | Supports Unity 2021.3 LTS or later     |
 | Offers simple Socket API to implement new protocols | Each protocol requires a new transport |
 
 **Some notable features that Mirage has:**
@@ -94,7 +94,7 @@ If you want to contribute to Mirage, follow these steps:
     mkdir MirageNetworking
     git clone https://github.com/MirageNet/Mirage.git MirageNetworking
     ```
-3) Open the newly cloned repo in Unity 2020.3 LTS or later.
+3) Open the newly cloned repo in Unity 2021.3 LTS or later.
 
 ### Windows
 
@@ -108,7 +108,7 @@ If you want to contribute to Mirage, follow these steps:
     ```
     If you don't want to use administrator, [add symlink support](https://www.joshkel.com/2018/01/18/symlinks-in-windows/) to your account.
     If you don't enable symlinks, you will be able to work on Mirage but Unity will not see the examples.
-3) Open in Unity 2020.3 LTS or later and have fun!
+3) Open in Unity 2021.3 LTS or later and have fun!
 
 ## Transport and Sockets
 
