chore(repo): migrate TrProtocol to submodule and bump OTAPI to 3.3.8

- replace in-repo TrProtocol sources with submodule at src/TrProtocol (pinned to afd8a2c)
- update CI/docs for submodule workflow
- bump OTAPI.Upcoming 3.3.7 -> 3.3.8

Author: CedaryCat

.github/workflows/release.yml

@@ -18,6 +18,7 @@ jobs:
       uses: actions/checkout@v4
       with:
         fetch-depth: 0
+        submodules: recursive
 
     - name: Setup .NET SDK
       uses: actions/setup-dotnet@v4
@@ -58,6 +59,11 @@ jobs:
           --store-password-in-clear-text `
           --configfile NuGet.config
 
+    - name: Show submodule status
+      shell: pwsh
+      run: |
+        git submodule status --recursive
+
     - name: Restore dependencies
       shell: pwsh
       run: |

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "src/TrProtocol"]
+	path = src/TrProtocol
+	url = https://github.com/CedaryCat/TrProtocol.git

README.md

@@ -26,7 +26,8 @@ You only need a local source build when experimenting with patches or contributi
 
 
 ## Quick Start
-1) Restore and build
+1) Initialize submodules, restore and build
+- `git submodule update --init --recursive`
 - `dotnet restore src/OTAPI.UnifiedServerProcess.sln`
 - `dotnet build src/OTAPI.UnifiedServerProcess.sln -c Release`
 
@@ -44,7 +45,7 @@ You only need a local source build when experimenting with patches or contributi
 - RootContext: Per‑server root that holds the instance‑bound systems you previously accessed as statics (e.g., Main, Netplay, NetMessage, Collision). See `src/OTAPI.UnifiedServerProcess/Mods/RootContext.cs` and `src/OTAPI.UnifiedServerProcess/Core/PatchingLogic.cs`.
 - Context‑bound systems: USP’s patching pass rewrites static state and call sites to live under the context. From a mod/plugin perspective you use `ctx.Main`, `ctx.Netplay`, `ctx.NetMessage`, `ctx.Collision`, etc., instead of global `Terraria.*` statics.
 - GlobalNetwork sample: Demonstrates sharing global sockets while routing per‑client processing to the correct server context. See `src/OTAPI.UnifiedServerProcess.GlobalNetwork/Network/Router.cs` and `src/OTAPI.UnifiedServerProcess.GlobalNetwork/Servers/ServerContext.cs`.
-- TrProtocol: Strong‑typed packet models under `src/TrProtocol/NetPackets/*` plus a source generator for fast (de)serialization.
+- TrProtocol: Strong‑typed packet models under `src/TrProtocol/src/TrProtocol/NetPackets/*` plus a source generator for fast (de)serialization.
 - TileProvider: Replaces ITile/Tile with TileData + RefTileData and a context‑aware TileCollection. See `src/OTAPI.UnifiedServerProcess/Mods/TileProviderMod.cs`.
 
 
@@ -112,7 +113,7 @@ Note: This is a development/engineering project; APIs and features may evolve ov
 - Patching pipeline: `src/OTAPI.UnifiedServerProcess/Core/PatchingLogic.cs`
 - GlobalNetwork components: `Program.cs`, `Network/Router.cs`, `Servers/ServerContext.cs` under `src/OTAPI.UnifiedServerProcess.GlobalNetwork`
 - TileProvider: `Mods/TileProviderMod.cs`
-- TrProtocol: models and generators under `src/TrProtocol` and `src/TrProtocol.SerializerGenerator`
+- TrProtocol: models and generators under `src/TrProtocol/src/TrProtocol` and `src/TrProtocol/src/TrProtocol.SerializerGenerator`
 
 External resources for deeper technical detail:
 - DeepWiki: `https://deepwiki.com/CedaryCat/OTAPI.UnifiedServerProcess`

docs/Developer-Guide.md

@@ -41,6 +41,7 @@ After restore/build, the assemblies are available from NuGet; you don’t need t
 ## Build from Source (secondary)
 ```
 cd OTAPI.UnifiedServerProcess
+git submodule update --init --recursive
 dotnet restore src/OTAPI.UnifiedServerProcess.sln
 dotnet build src/OTAPI.UnifiedServerProcess.sln -c Release
 dotnet run -c Debug -p src/OTAPI.UnifiedServerProcess

src/OTAPI.UnifiedServerProcess.sln

@@ -11,11 +11,11 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "OTAPI.UnifiedServerProcess.
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "OTAPI.UnifiedServerProcess.ConsoleClient", "OTAPI.UnifiedServerProcess.ConsoleClient\OTAPI.UnifiedServerProcess.ConsoleClient.csproj", "{5BFD176F-57B3-711D-14AE-097425D79738}"
 EndProject
-Project("{D954291E-2A0B-460D-934E-DC6B0785DB48}") = "TrProtocol.Shared", "TrProtocol.Shared\TrProtocol.Shared.shproj", "{768417B4-D342-4006-B196-5F7178582209}"
+Project("{D954291E-2A0B-460D-934E-DC6B0785DB48}") = "TrProtocol.Shared", "TrProtocol\src\TrProtocol.Shared\TrProtocol.Shared.shproj", "{768417B4-D342-4006-B196-5F7178582209}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "TrProtocol.SerializerGenerator", "TrProtocol.SerializerGenerator\TrProtocol.SerializerGenerator.csproj", "{B49F3FA4-BBFC-934D-D703-7FEE77507D30}"
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "TrProtocol.SerializerGenerator", "TrProtocol\src\TrProtocol.SerializerGenerator\TrProtocol.SerializerGenerator.csproj", "{B49F3FA4-BBFC-934D-D703-7FEE77507D30}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "TrProtocol", "TrProtocol\TrProtocol.csproj", "{F252FFD8-5DE7-DAA8-BA3D-341C543C73EE}"
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "TrProtocol", "TrProtocol\src\TrProtocol\TrProtocol.csproj", "{F252FFD8-5DE7-DAA8-BA3D-341C543C73EE}"
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "解决方案项", "解决方案项", "{9FA3D6BD-1EC1-3BA5-80CB-CE02773A58D5}"
 	ProjectSection(SolutionItems) = preProject
@@ -135,8 +135,8 @@ Global
 		SolutionGuid = {A7CFB05D-AB46-4256-92A6-C8723719BBD5}
 	EndGlobalSection
 	GlobalSection(SharedMSBuildProjectFiles) = preSolution
-		TrProtocol.Shared\TrProtocol.Shared.projitems*{768417b4-d342-4006-b196-5f7178582209}*SharedItemsImports = 13
-		TrProtocol.Shared\TrProtocol.Shared.projitems*{b49f3fa4-bbfc-934d-d703-7fee77507d30}*SharedItemsImports = 5
-		TrProtocol.Shared\TrProtocol.Shared.projitems*{f252ffd8-5de7-daa8-ba3d-341c543c73ee}*SharedItemsImports = 5
+		TrProtocol\src\TrProtocol.Shared\TrProtocol.Shared.projitems*{768417b4-d342-4006-b196-5f7178582209}*SharedItemsImports = 13
+		TrProtocol\src\TrProtocol.Shared\TrProtocol.Shared.projitems*{b49f3fa4-bbfc-934d-d703-7fee77507d30}*SharedItemsImports = 5
+		TrProtocol\src\TrProtocol.Shared\TrProtocol.Shared.projitems*{f252ffd8-5de7-daa8-ba3d-341c543c73ee}*SharedItemsImports = 5
 	EndGlobalSection
 EndGlobal

src/OTAPI.UnifiedServerProcess/OTAPI.UnifiedServerProcess.csproj

@@ -19,13 +19,13 @@
 	</ItemGroup>
 
 	<ItemGroup>
-	  <PackageReference Include="OTAPI.Upcoming" Version="3.3.7-mf-a807e26.13" />
+	  <PackageReference Include="OTAPI.Upcoming" Version="3.3.8-mf-a807e26.16" />
 	  <PackageReference Include="MonoMod.RuntimeDetour.HookGen" Version="22.7.31.1" />
-		<PackageReference Include="ModFramework.Modules.CSharp" Version="1.1.15-mf-a807e26.13" />
+		<PackageReference Include="ModFramework.Modules.CSharp" Version="1.1.15-mf-a807e26.16" />
 	</ItemGroup>
 
 	<ItemGroup>
-		<ProjectReference Include="..\TrProtocol\TrProtocol.csproj" />
+		<ProjectReference Include="..\TrProtocol\src\TrProtocol\TrProtocol.csproj" />
 	</ItemGroup>
 
 	<Target Name="PreBuild" BeforeTargets="PreBuildEvent">