Update README.md

增加打印输出协议

.gitignore

@@ -129,4 +129,5 @@ DotNet/ThirdParty/obj/
 Bin/
 
 #Server_Config
-DotNet/Config/GameConfig
+DotNet/Config/GameConfig
+DotNet/Config/ProtoBuf/OpCode.Cache

Assets/AssetRaw/Configs/bytes/battle_tbbuff.bytes.meta

@@ -1,7 +0,0 @@
-fileFormatVersion: 2
-guid: 8f3bcefaf67e76141a6d8edeb8354fea
-TextScriptImporter:
-  externalObjects: {}
-  userData: 
-  assetBundleName: 
-  assetBundleVariant: 

Assets/AssetRaw/Configs/bytes/battle_tbbuffattr.bytes.meta

@@ -1,7 +0,0 @@
-fileFormatVersion: 2
-guid: 25113973d38eb5a48b064863830539a4
-TextScriptImporter:
-  externalObjects: {}
-  userData: 
-  assetBundleName: 
-  assetBundleVariant: 

Assets/AssetRaw/Configs/bytes/battle_tbskill.bytes.meta

@@ -1,7 +0,0 @@
-fileFormatVersion: 2
-guid: ef51ed54e72f97a4ab530b932680e08b
-TextScriptImporter:
-  externalObjects: {}
-  userData: 
-  assetBundleName: 
-  assetBundleVariant: 

Assets/AssetRaw/Configs/bytes/item_tbitem.bytes.meta

@@ -1,7 +0,0 @@
-fileFormatVersion: 2
-guid: 090163c612f34ac4fb80004ac5f057b4
-TextScriptImporter:
-  externalObjects: {}
-  userData: 
-  assetBundleName: 
-  assetBundleVariant: 

Assets/GameScripts/DotNet/Core/Define.cs

@@ -70,6 +70,10 @@ public static class Define
     /// </summary>
     public static string ClientCustomExportDirectory;
     /// <summary>
+    /// SceneConfig.xlsx的位置
+    /// </summary>
+    public static string SceneConfigPath;
+    /// <summary>
     /// 自定义导出代码存放的程序集
     /// </summary>
     public static string CustomExportAssembly;

Assets/GameScripts/DotNet/Core/Exporter/Excel/Base/ExportType.cs

@@ -1,12 +1,34 @@
 #if TENGINE_NET
 namespace TEngine.Core;
 
+/// <summary>
+/// 导出类型枚举，用于标识不同类型的导出操作。
+/// </summary>
 public enum ExportType
 {
-    None = 0,
-    ProtoBuf = 1,               // 导出ProtoBuf
-    AllExcelIncrement = 2,      // 所有-增量导出Excel
-    AllExcel = 3,               // 所有-全量导出Excel
-    Max,                        // 这个一定放最后
+    /// <summary>
+    /// 无导出类型。
+    /// </summary>
+    None = 0, 
+    /// <summary>
+    /// 导出ProtoBuf类型。
+    /// </summary>
+    ProtoBuf = 1,
+    /// <summary>
+    /// 导出网络协议并重新生成OpCode。
+    /// </summary>
+    ProtoBufAndOpCodeCache = 2,
+    /// <summary>
+    /// 所有数据的增量导出Excel类型。
+    /// </summary>
+    AllExcelIncrement = 3,
+    /// <summary>
+    /// 所有数据的全量导出Excel类型。
+    /// </summary>
+    AllExcel = 4,
+    /// <summary>
+    /// 导出类型枚举的最大值，一定要放在最后。
+    /// </summary>
+    Max,
 }
 #endif

Assets/GameScripts/DotNet/Core/Exporter/Exporter.cs

@@ -3,16 +3,21 @@ using System.Diagnostics;
 using System.Reflection;
 using System.Runtime.Loader;
 using System.Text;
-using TEngine.Core;
+using TEngine.Helper;
 using Microsoft.Extensions.Configuration;
 #pragma warning disable CS8601
 
-#pragma warning disable CS8618
 
 namespace TEngine.Core;
 
+/// <summary>
+/// 数据导出器，用于执行导出操作。
+/// </summary>
 public sealed class Exporter
 {
+    /// <summary>
+    /// 开始执行数据导出操作。
+    /// </summary>
     public void Start()
     {
         Console.OutputEncoding = Encoding.UTF8;
@@ -25,8 +30,9 @@ public sealed class Exporter
 
         LogInfo("请输入你想要做的操作:");
         LogInfo("1:导出网络协议（ProtoBuf）");
-        LogInfo("2:增量导出服务器启动Excel（包含常量枚举）");
-        LogInfo("3:全量导出服务器启动Excel（包含常量枚举）");
+        LogInfo("2:导出网络协议并重新生成OpCode（ProtoBuf）");
+        LogInfo("3:增量导出Excel（包含常量枚举）");
+        LogInfo("4:全量导出Excel（包含常量枚举）");
 
         var keyChar = Console.ReadKey().KeyChar;
             
@@ -39,13 +45,17 @@ public sealed class Exporter
             
         LogInfo("");
         exportType = (ExportType) key;
-        // LoadConfig();
-        
+
         switch (exportType)
         {
             case ExportType.ProtoBuf:
             {
-                _ = new ProtoBufExporter();
+                _ = new ProtoBufExporter(false);
+                break;
+            }
+            case ExportType.ProtoBufAndOpCodeCache:
+            {
+                _ = new ProtoBufExporter(true);
                 break;
             }
             case ExportType.AllExcel:
@@ -61,58 +71,19 @@ public sealed class Exporter
         Environment.Exit(0);
     }
 
-#if old
-    // private void LoadConfig()
-    // {
-    //     const string settingsName = "TEngineSettings.json";
-    //     var currentDirectory = Directory.GetCurrentDirectory();
-    //
-    //     if (!File.Exists(Path.Combine(currentDirectory, settingsName)))
-    //     {
-    //         throw new FileNotFoundException($"not found {settingsName} in OutputDirectory");
-    //     }
-    //
-    //     var configurationRoot = new ConfigurationBuilder().SetBasePath(Directory.GetCurrentDirectory())
-    //         .AddJsonFile(settingsName)
-    //         .Build();
-    //     // ProtoBuf文件所在的位置文件夹位置
-    //     ProtoBufDefine.ProtoBufDirectory = configurationRoot["Export:ProtoBufDirectory:Value"];
-    //     // ProtoBuf生成到服务端的文件夹位置
-    //     ProtoBufDefine.ServerDirectory = configurationRoot["Export:ProtoBufServerDirectory:Value"];
-    //     // ProtoBuf生成到客户端的文件夹位置
-    //     ProtoBufDefine.ClientDirectory = configurationRoot["Export:ProtoBufClientDirectory:Value"];
-    //     // ProtoBuf生成代码模板的位置
-    //     ProtoBufDefine.ProtoBufTemplatePath = configurationRoot["Export:ProtoBufTemplatePath:Value"];
-    //     // Excel配置文件根目录
-    //     ExcelDefine.ProgramPath = configurationRoot["Export:ExcelProgramPath:Value"];
-    //     // Excel版本文件的位置
-    //     ExcelDefine.ExcelVersionFile = configurationRoot["Export:ExcelVersionFile:Value"];
-    //     // Excel生成服务器代码的文件夹位置
-    //     ExcelDefine.ServerFileDirectory = configurationRoot["Export:ExcelServerFileDirectory:Value"];
-    //     // Excel生成客户端代码文件夹位置
-    //     ExcelDefine.ClientFileDirectory = configurationRoot["Export:ExcelClientFileDirectory:Value"];
-    //     // Excel生成服务器二进制数据文件夹位置
-    //     ExcelDefine.ServerBinaryDirectory = configurationRoot["Export:ExcelServerBinaryDirectory:Value"];
-    //     // Excel生成客户端二进制数据文件夹位置
-    //     ExcelDefine.ClientBinaryDirectory = configurationRoot["Export:ExcelClientBinaryDirectory:Value"];
-    //     // Excel生成服务器Json数据文件夹位置
-    //     ExcelDefine.ServerJsonDirectory = configurationRoot["Export:ExcelServerJsonDirectory:Value"];
-    //     // Excel生成客户端Json数据文件夹位置
-    //     ExcelDefine.ClientJsonDirectory = configurationRoot["Export:ExcelClientJsonDirectory:Value"];
-    //     // Excel生成代码模板的位置
-    //     ExcelDefine.ExcelTemplatePath = configurationRoot["Export:ExcelTemplatePath:Value"];
-    //     // 服务器自定义导出代码文件夹位置
-    //     ExcelDefine.ServerCustomExportDirectory = configurationRoot["Export:ServerCustomExportDirectory:Value"];
-    //     // 客户端自定义导出代码文件夹位置
-    //     ExcelDefine.ClientCustomExportDirectory = configurationRoot["Export:ClientCustomExportDirectory:Value"];
-    // }
-#endif
-
+    /// <summary>
+    /// 输出信息到控制台。
+    /// </summary>
+    /// <param name="msg">要输出的信息。</param>
     public static void LogInfo(string msg)
     {
         Console.WriteLine(msg);
     }
 
+    /// <summary>
+    /// 输出错误信息到控制台。
+    /// </summary>
+    /// <param name="msg">要输出的错误信息。</param>
     public static void LogError(string msg)
     {
         ConsoleColor color = Console.ForegroundColor;
@@ -121,6 +92,10 @@ public sealed class Exporter
         Console.ForegroundColor = color;
     }
 
+    /// <summary>
+    /// 输出异常信息到控制台。
+    /// </summary>
+    /// <param name="e">要输出的异常。</param>
     public static void LogError(Exception e)
     {
         ConsoleColor color = Console.ForegroundColor;

Assets/GameScripts/DotNet/Core/Exporter/ProtoBuf/OpCodeCache.cs

@@ -0,0 +1,60 @@
+#if TENGINE_NET
+using TEngine.Helper;
+
+namespace TEngine.Core;
+
+/// <summary>
+/// 网络协议操作码缓存。
+/// </summary>
+public class OpCodeCache
+{
+    private readonly List<uint> _opCodes = new List<uint>();
+    private readonly SortedDictionary<string, uint> _opcodeCache;
+    private readonly SortedDictionary<string, uint> _saveOpCodeCache = new();
+    private readonly string _opcodeCachePath = $"{Define.ProtoBufDirectory}OpCode.Cache";
+
+    /// <summary>
+    /// 构造函数，用于初始化网络协议操作码缓存。
+    /// </summary>
+    public OpCodeCache(bool regenerate)
+    {
+        if (File.Exists(_opcodeCachePath) && !regenerate)
+        {
+            var readAllText = File.ReadAllText(_opcodeCachePath);
+            _opcodeCache = readAllText.Deserialize<SortedDictionary<string, uint>>();
+            _opCodes.AddRange(_opcodeCache.Values);
+        }
+        else
+        {
+            _opcodeCache = new SortedDictionary<string, uint>();
+        }
+    }
+
+    /// <summary>
+    /// 保存网络协议操作码。
+    /// </summary>
+    public void Save()
+    {
+        File.WriteAllText(_opcodeCachePath, _saveOpCodeCache.ToJson());
+    }
+    
+    /// <summary>
+    /// 根据className获得OpCode、如果是新增的会产生一个新的OpCode。
+    /// </summary>
+    /// <param name="className">协议名。</param>
+    /// <param name="opcode">操作码。</param>
+    /// <returns></returns>
+    public uint GetOpcodeCache(string className, ref uint opcode)
+    {
+        if (!_opcodeCache.TryGetValue(className, out var opCode))
+        {
+            while (_opCodes.Contains(++opcode)) { }
+            opCode = opcode;
+            _opCodes.Add(opCode);
+        }
+        
+        _saveOpCodeCache.Add(className, opCode);
+        return opCode;
+    }
+}
+#endif

Assets/GameScripts/DotNet/Core/Exporter/ProtoBuf/OpCodeCache.cs.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: e0f0d02da06c4ca981417bfe43162809
+timeCreated: 1693928511

Assets/GameScripts/DotNet/Core/Exporter/ProtoBuf/ProtoBufExporter.cs

@@ -1,27 +1,52 @@
 #if TENGINE_NET
 using System.Text;
 using TEngine.Core.Network;
-#pragma warning disable CS8604
-#pragma warning disable CS8602
-#pragma warning disable CS8600
-#pragma warning disable CS8618
+using TEngine.Helper;
 
 namespace TEngine.Core;
 
+/// <summary>
+/// ProtoBuf操作码类型枚举
+/// </summary>
 public enum ProtoBufOpCodeType
 {
+    /// <summary>
+    /// 无
+    /// </summary>
     None = 0,
+    /// <summary>
+    /// 外部操作码类型
+    /// </summary>
     Outer = 1,
+    /// <summary>
+    /// 内部操作码类型
+    /// </summary>
     Inner = 2,
+    /// <summary>
+    /// 使用BSON的内部操作码类型
+    /// </summary>
     InnerBson = 3,
 }
 
+/// <summary>
+/// 操作码信息类
+/// </summary>
 public sealed class OpcodeInfo
 {
+    /// <summary>
+    /// 操作码
+    /// </summary>
     public uint Code;
+    /// <summary>
+    /// 名称
+    /// </summary>
     public string Name;
 }
 
+
+/// <summary>
+/// ProtoBuf导出器类
+/// </summary>
 public sealed class ProtoBufExporter
 {
     private uint _aMessage;
@@ -32,10 +57,13 @@ public sealed class ProtoBufExporter
     private uint _aRouteResponse;
     private string _serverTemplate;
     private string _clientTemplate;
-    
+    private readonly OpCodeCache _opCodeCache;
     private readonly List<OpcodeInfo> _opcodes = new();
 
-    public ProtoBufExporter()
+    /// <summary>
+    /// 构造函数，用于初始化导出器
+    /// </summary>
+    public ProtoBufExporter(bool regenerateOpCodeCache)
     {
         Console.OutputEncoding = Encoding.UTF8;
         
@@ -48,6 +76,23 @@ public sealed class ProtoBufExporter
         {
             Directory.CreateDirectory(Define.ProtoBufClientDirectory);
         }
+        
+        if (!Directory.Exists($"{Define.ProtoBufDirectory}Outer"))
+        {
+            Directory.CreateDirectory($"{Define.ProtoBufDirectory}Outer");
+        }
+        
+        if (!Directory.Exists($"{Define.ProtoBufDirectory}Inner"))
+        {
+            Directory.CreateDirectory($"{Define.ProtoBufDirectory}Inner");
+        }
+        
+        if (!Directory.Exists($"{Define.ProtoBufDirectory}InnerBosn"))
+        {
+            Directory.CreateDirectory($"{Define.ProtoBufDirectory}InnerBosn");
+        }
+
+        _opCodeCache = new OpCodeCache(regenerateOpCodeCache);
 
         var tasks = new Task[2];
         tasks[0] = Task.Run(RouteType);
@@ -59,21 +104,17 @@ public sealed class ProtoBufExporter
             await Start(ProtoBufOpCodeType.InnerBson);
         });
         Task.WaitAll(tasks);
+        _opCodeCache.Save();
     }
 
     private async Task Start(ProtoBufOpCodeType opCodeType)
     {
-        var protoFile = "";
+        List<string> files = new List<string>();
         var opCodeName = "";
-        var parameter = "";
-        var className = "";
-        var isMsgHead = false;
         OpcodeInfo opcodeInfo = null;
-        string responseTypeStr = null;
-        string customRouteType = null;
         _opcodes.Clear();
         var file = new StringBuilder();
-        var saveDirectory = new Dictionary<string,string>();
+        var saveDirectory = new Dictionary<string, string>();
         
         switch (opCodeType)
         {
@@ -86,9 +127,11 @@ public sealed class ProtoBufExporter
                 _aRouteRequest = Opcode.OuterRouteRequest;
                 _aRouteResponse = Opcode.OuterRouteResponse;
                 opCodeName = "OuterOpcode";
-                protoFile = $"{Define.ProtoBufDirectory}OuterMessage.proto";
                 saveDirectory.Add(Define.ProtoBufServerDirectory, _serverTemplate);
                 saveDirectory.Add(Define.ProtoBufClientDirectory, _clientTemplate);
+                var protoBufFiles = FileHelper.GetDirectoryFile(
+                    $"{Define.ProtoBufDirectory}Outer", "*.proto", SearchOption.AllDirectories);
+                files.AddRange(protoBufFiles);
                 break;
             }
             case ProtoBufOpCodeType.Inner:
@@ -101,8 +144,9 @@ public sealed class ProtoBufExporter
                 _aRouteRequest = Opcode.InnerRouteRequest + 1000;
                 _aRouteResponse = Opcode.InnerRouteResponse + 1000;
                 opCodeName = "InnerOpcode";
-                protoFile = $"{Define.ProtoBufDirectory}InnerMessage.proto";
                 saveDirectory.Add(Define.ProtoBufServerDirectory, _serverTemplate);
+                var protoBufFiles = FileHelper.GetDirectoryFile($"{Define.ProtoBufDirectory}Inner", "*.proto", SearchOption.AllDirectories);
+                files.AddRange(protoBufFiles);
                 break;
             }
             case ProtoBufOpCodeType.InnerBson:
@@ -115,204 +159,230 @@ public sealed class ProtoBufExporter
                 _aRouteRequest = Opcode.InnerBsonRouteRequest + 1000;
                 _aRouteResponse = Opcode.InnerBsonRouteResponse + 1000;
                 opCodeName = "InnerBsonOpcode";
-                protoFile = $"{Define.ProtoBufDirectory}InnerBsonMessage.proto";
                 saveDirectory.Add(Define.ProtoBufServerDirectory, _serverTemplate);
+                var protoBufFiles = FileHelper.GetDirectoryFile($"{Define.ProtoBufDirectory}InnerBosn", "*.proto", SearchOption.AllDirectories);
+                files.AddRange(protoBufFiles);
                 break;
             }
         }
-        
-        var protoFileText = await File.ReadAllTextAsync(protoFile);
 
-        foreach (var line in protoFileText.Split('\n'))
+        #region GenerateProtoFiles
+        foreach (var filePath in files)
         {
-            var currentLine = line.Trim();
-
-            if (string.IsNullOrWhiteSpace(currentLine))
-            {
-                continue;
-            }
+            var parameter = "";
+            var className = "";
+            var isMsgHead = false;
+            string responseTypeStr = null;
+            string customRouteType = null;
             
-            if (currentLine.StartsWith("///"))
+            var protoFileText = await File.ReadAllTextAsync(filePath);
+
+            foreach (var line in protoFileText.Split('\n'))
             {
-                file.AppendFormat("	/// <summary>\r\n" + "	/// {0}\r\n" + "	/// </summary>\r\n", currentLine.TrimStart(new[] {'/', '/', '/'}));
-                continue;
-            }
-
-            if (currentLine.StartsWith("message"))
-            {
-                isMsgHead = true;
-                opcodeInfo = new OpcodeInfo();
-                file.AppendLine("\t[ProtoContract]");
-                className = currentLine.Split(Define.SplitChars, StringSplitOptions.RemoveEmptyEntries)[1];
-                var splits = currentLine.Split(new[] {"//"}, StringSplitOptions.RemoveEmptyEntries);
-
-                if (splits.Length > 1)
-                {
-                    var parameterArray = currentLine.Split(new[] {"//"}, StringSplitOptions.RemoveEmptyEntries)[1].Trim().Split(',');
-                    parameter = parameterArray[0].Trim();
-
-                    switch (parameterArray.Length)
-                    {
-                        case 2:
-                            responseTypeStr = parameterArray[1].Trim();
-                            break;
-                        case 3:
-                        {
-                            customRouteType = parameterArray[1].Trim();
-
-                            if (parameterArray.Length == 3)
-                            {
-                                responseTypeStr = parameterArray[2].Trim();
-                            }
-
-                            break;
-                        }
-                    }
-                }
-                else
-                {
-                    parameter = "";
-                }
+                bool hadOpCode = true;
                 
-                file.Append(string.IsNullOrWhiteSpace(parameter)
-                    ? $"\tpublic partial class {className} : AProto"
-                    : $"\tpublic partial class {className} : AProto, {parameter}");
-                opcodeInfo.Name = className;
-                continue;
-            }
-            
-            if (!isMsgHead)
-            {
-                continue;
-            }
+                var currentLine = line.Trim();
 
-            switch (currentLine)
-            {
-                case "{":
+                if (string.IsNullOrWhiteSpace(currentLine))
                 {
-                    file.AppendLine("\n\t{");
-            
-                    if (string.IsNullOrWhiteSpace(parameter) || parameter == "IMessage")
+                    continue;
+                }
+
+                if (currentLine.StartsWith("///"))
+                {
+                    file.AppendFormat("	/// <summary>\r\n" + "	/// {0}\r\n" + "	/// </summary>\r\n", currentLine.TrimStart(new[] { '/', '/', '/' }));
+                    continue;
+                }
+
+                if (currentLine.StartsWith("message"))
+                {
+                    isMsgHead = true;
+                    opcodeInfo = new OpcodeInfo();
+                    file.AppendLine("\t[ProtoContract]");
+                    className = currentLine.Split(Define.SplitChars, StringSplitOptions.RemoveEmptyEntries)[1];
+                    var splits = currentLine.Split(new[] { "//" }, StringSplitOptions.RemoveEmptyEntries);
+
+                    if (splits.Length > 1)
                     {
-                        opcodeInfo.Code += ++_aMessage;
-                        file.AppendLine($"\t\tpublic uint OpCode() {{ return {opCodeName}.{className}; }}");
+                        var parameterArray = currentLine.Split(new[] { "//" }, StringSplitOptions.RemoveEmptyEntries)[1].Trim().Split(',');
+                        parameter = parameterArray[0].Trim();
+
+                        switch (parameterArray.Length)
+                        {
+                            case 2:
+                            {
+                                if (parameter == "ICustomRouteMessage")
+                                {
+                                    customRouteType = parameterArray[1].Trim();
+                                    break;
+                                }
+                                
+                                responseTypeStr = parameterArray[1].Trim();
+                                break;
+                            }
+                            case 3:
+                            {
+                                responseTypeStr = parameterArray[1].Trim();
+                                customRouteType = parameterArray[2].Trim();
+                                break;
+                            }
+                        }
                     }
                     else
                     {
-                        if (responseTypeStr != null)
+                        parameter = "";
+                    }
+
+                    file.Append(string.IsNullOrWhiteSpace(parameter)
+                        ? $"\tpublic partial class {className} : AProto"
+                        : $"\tpublic partial class {className} : AProto, {parameter}");
+                    opcodeInfo.Name = className;
+                    continue;
+                }
+
+                if (!isMsgHead)
+                {
+                    continue;
+                }
+
+                switch (currentLine)
+                {
+                    case "{":
+                    {
+                        file.AppendLine("\n\t{");
+
+                        if (string.IsNullOrWhiteSpace(parameter))
                         {
-                            file.AppendLine("\t\t[ProtoIgnore]");
-                            file.AppendLine($"\t\tpublic {responseTypeStr} ResponseType {{ get; set; }}");
-                            responseTypeStr = null;
+                            hadOpCode = false;
+                        }
+                        else if(parameter == "IMessage")
+                        {
+                            opcodeInfo.Code = _opCodeCache.GetOpcodeCache(className, ref _aMessage);
+                            file.AppendLine($"\t\tpublic uint OpCode() {{ return {opCodeName}.{className}; }}");
                         }
                         else
                         {
-                            if (parameter.Contains("RouteRequest"))
+                            if (responseTypeStr != null)
                             {
-                                Exporter.LogError($"{opcodeInfo.Name} 没指定ResponseType");
+                                file.AppendLine("\t\t[ProtoIgnore]");
+                                file.AppendLine($"\t\tpublic {responseTypeStr} ResponseType {{ get; set; }}");
+                                responseTypeStr = null;
                             }
-                        }
-
-                        file.AppendLine($"\t\tpublic uint OpCode() {{ return {opCodeName}.{className}; }}");
-                        
-                        if (customRouteType != null)
-                        {
-                            file.AppendLine($"\t\tpublic long RouteTypeOpCode() {{ return (long)RouteType.{customRouteType}; }}");
-                            customRouteType = null;
-                        }
-                        else if (parameter is "IAddressableRouteRequest" or "IAddressableRouteMessage")
-                        {
-                            file.AppendLine($"\t\tpublic long RouteTypeOpCode() {{ return CoreRouteType.Addressable; }}");
-                        }
-                        else if (parameter.EndsWith("BsonRouteMessage") || parameter.EndsWith("BsonRouteRequest"))
-                        {
-                            file.AppendLine($"\t\tpublic long RouteTypeOpCode() {{ return CoreRouteType.BsonRoute; }}");
-                        }
-                        else if (parameter is "IRouteMessage" or "IRouteRequest")
-                        {
-                            file.AppendLine($"\t\tpublic long RouteTypeOpCode() {{ return CoreRouteType.Route; }}");
-                        }
-
-                        switch (parameter)
-                        {
-                            case "IRequest":
-                            case "IBsonRequest":
+                            else
                             {
-                                opcodeInfo.Code += ++_aRequest;
-                                break;
-                            }
-                            case "IResponse":
-                            case "IBsonResponse":
-                            {
-                                opcodeInfo.Code += ++_aResponse;
-                                file.AppendLine("\t\t[ProtoMember(91, IsRequired = true)]");
-                                file.AppendLine("\t\tpublic uint ErrorCode { get; set; }");
-                                break;
-                            }
-                            default:
-                            {
-                                if (parameter.EndsWith("RouteMessage") || parameter == "IRouteMessage")
+                                if (parameter.Contains("RouteRequest"))
                                 {
-                                    opcodeInfo.Code += ++_aRouteMessage;
+                                    Exporter.LogError($"{opcodeInfo.Name} 没指定ResponseType");
                                 }
-                                else if (parameter.EndsWith("RouteRequest") || parameter == "IRouteRequest")
+                            }
+
+                            file.AppendLine($"\t\tpublic uint OpCode() {{ return {opCodeName}.{className}; }}");
+
+                            if (customRouteType != null)
+                            {
+                                file.AppendLine($"\t\tpublic long RouteTypeOpCode() {{ return (long)RouteType.{customRouteType}; }}");
+                                customRouteType = null;
+                            }
+                            else if (parameter is "IAddressableRouteRequest" or "IAddressableRouteMessage")
+                            {
+                                file.AppendLine($"\t\tpublic long RouteTypeOpCode() {{ return CoreRouteType.Addressable; }}");
+                            }
+                            else if (parameter.EndsWith("BsonRouteMessage") || parameter.EndsWith("BsonRouteRequest"))
+                            {
+                                file.AppendLine($"\t\tpublic long RouteTypeOpCode() {{ return CoreRouteType.BsonRoute; }}");
+                            }
+                            else if (parameter is "IRouteMessage" or "IRouteRequest")
+                            {
+                                file.AppendLine($"\t\tpublic long RouteTypeOpCode() {{ return CoreRouteType.Route; }}");
+                            }
+
+                            switch (parameter)
+                            {
+                                case "IRequest":
+                                case "IBsonRequest":
                                 {
-                                    opcodeInfo.Code += ++_aRouteRequest;
+                                    opcodeInfo.Code = _opCodeCache.GetOpcodeCache(className, ref _aRequest);
+                                    break;
                                 }
-                                else if (parameter.EndsWith("RouteResponse") || parameter == "IRouteResponse")
+                                case "IResponse":
+                                case "IBsonResponse":
                                 {
-                                    opcodeInfo.Code += ++_aRouteResponse;
+                                    opcodeInfo.Code = _opCodeCache.GetOpcodeCache(className, ref _aResponse);
                                     file.AppendLine("\t\t[ProtoMember(91, IsRequired = true)]");
                                     file.AppendLine("\t\tpublic uint ErrorCode { get; set; }");
+                                    break;
                                 }
+                                default:
+                                {
+                                    if (parameter.EndsWith("RouteMessage") || parameter == "IRouteMessage")
+                                    {
+                                        opcodeInfo.Code  = _opCodeCache.GetOpcodeCache(className, ref _aRouteMessage);
+                                    }
+                                    else if (parameter.EndsWith("RouteRequest") || parameter == "IRouteRequest")
+                                    {
+                                        opcodeInfo.Code = _opCodeCache.GetOpcodeCache(className, ref _aRouteRequest);
+                                    }
+                                    else if (parameter.EndsWith("RouteResponse") || parameter == "IRouteResponse")
+                                    {
+                                        opcodeInfo.Code = _opCodeCache.GetOpcodeCache(className, ref _aRouteResponse);
+                                        file.AppendLine("\t\t[ProtoMember(91, IsRequired = true)]");
+                                        file.AppendLine("\t\tpublic uint ErrorCode { get; set; }");
+                                    }
 
-                                break;
+                                    break;
+                                }
                             }
                         }
-                    }
-                    
-                    _opcodes.Add(opcodeInfo);
-                    continue;
-                }
-                case "}":
-                {
-                    isMsgHead = false;
-                    file.AppendLine("\t}");
-                    continue;
-                }
-                case "":
-                {
-                    continue;
-                }
-            }
-            
-            if (currentLine.StartsWith("//"))
-            {
-                file.AppendFormat("\t\t///<summary>\r\n" + "\t\t/// {0}\r\n" + "\t\t///</summary>\r\n", currentLine.TrimStart('/', '/'));
-                continue;
-            }
-            
-            if (currentLine.StartsWith("repeated"))
-            {
-                Repeated(file, currentLine);
-            }
-            else
-            {
-                Members(file, currentLine);
-            }
-        }
-        
-        var csName = $"{Path.GetFileNameWithoutExtension(protoFile)}.cs";
-        
-        foreach (var (directory, template) in saveDirectory)
-        {
-            var csFile = Path.Combine(directory, csName);
-            var content = template.Replace("(Content)", file.ToString());
-            await File.WriteAllTextAsync(csFile, content);
-        }
 
-        file.Clear();
+                        if (hadOpCode)
+                        {
+                            _opcodes.Add(opcodeInfo);
+                        }
+                        continue;
+                    }
+                    case "}":
+                    {
+                        isMsgHead = false;
+                        file.AppendLine("\t}");
+                        continue;
+                    }
+                    case "":
+                    {
+                        continue;
+                    }
+                }
+
+                if (currentLine.StartsWith("//"))
+                {
+                    file.AppendFormat("\t\t///<summary>\r\n" + "\t\t/// {0}\r\n" + "\t\t///</summary>\r\n", currentLine.TrimStart('/', '/'));
+                    continue;
+                }
+
+                if (currentLine.StartsWith("repeated"))
+                {
+                    Repeated(file, currentLine);
+                }
+                else
+                {
+                    Members(file, currentLine);
+                }
+            }
+
+            var csName = $"{Path.GetFileNameWithoutExtension(filePath)}.cs";
+
+            foreach (var (directory, template) in saveDirectory)
+            {
+                var csFile = Path.Combine(directory, csName);
+                var content = template.Replace("(Content)", file.ToString());
+                await File.WriteAllTextAsync(csFile, content);
+            }
+
+            file.Clear();
+        }
+        #endregion
         
+        #region GenerateOpCode
+        file.Clear();
         file.AppendLine("namespace TEngine");
         file.AppendLine("{");
         file.AppendLine($"\tpublic static partial class {opCodeName}");
@@ -333,6 +403,7 @@ public sealed class ProtoBufExporter
             var csFile = Path.Combine(directory, $"{opCodeName}.cs");
             await File.WriteAllTextAsync(csFile, file.ToString());
         }
+        #endregion
     }
 
     private async Task RouteType()
@@ -450,7 +521,10 @@ public sealed class ProtoBufExporter
                 return "null";
         }
     }
-    
+
+    /// <summary>
+    /// 加载模板
+    /// </summary>
     private void LoadTemplate()
     {
         string[] lines = File.ReadAllLines(Define.ProtoBufTemplatePath, Encoding.UTF8);

Assets/GameScripts/DotNet/Core/Helper/FileHelper.cs

@@ -1,26 +1,29 @@
 using System.Collections.Generic;
 using System.IO;
 
-namespace TEngine.Core
+namespace TEngine
 {
+    /// <summary>
+    /// 文件操作助手类，提供了各种文件操作方法。
+    /// </summary>
     public static class FileHelper
     {
         /// <summary>
-        /// 获取文件全路径。
+        /// 获取相对路径的完整路径。
         /// </summary>
-        /// <param name="relativePath"></param>
-        /// <returns></returns>
+        /// <param name="relativePath">相对路径。</param>
+        /// <returns>完整路径。</returns>
         public static string GetFullPath(string relativePath)
         {
             return Path.GetFullPath(Path.Combine(Directory.GetCurrentDirectory(), relativePath));
         }
 
         /// <summary>
-        /// 拷贝文件到目标路径、如果目标目录不存在会自动创建目录
+        /// 将文件复制到目标路径，如果目标目录不存在会自动创建目录。
         /// </summary>
-        /// <param name="sourceFile"></param>
-        /// <param name="destinationFile"></param>
-        /// <param name="overwrite"></param>
+        /// <param name="sourceFile">源文件路径。</param>
+        /// <param name="destinationFile">目标文件路径。</param>
+        /// <param name="overwrite">是否覆盖已存在的目标文件。</param>
         public static void Copy(string sourceFile, string destinationFile, bool overwrite)
         {
             var directoriesByFilePath = GetDirectoriesByFilePath(destinationFile);
@@ -39,10 +42,10 @@ namespace TEngine.Core
         }
 
         /// <summary>
-        /// 获取文件路径内的所有文件夹路径
+        /// 获取文件路径内的所有文件夹路径。
         /// </summary>
-        /// <param name="filePath"></param>
-        /// <returns></returns>
+        /// <param name="filePath">文件路径。</param>
+        /// <returns>文件夹路径列表。</returns>
         public static List<string> GetDirectoriesByFilePath(string filePath)
         {
             var dir = "";
@@ -59,11 +62,11 @@ namespace TEngine.Core
         }
 
         /// <summary>
-        /// 把文件夹里所有内容拷贝的目标位置
+        /// 将文件夹内的所有内容复制到目标位置。
         /// </summary>
-        /// <param name="sourceDirectory"></param>
-        /// <param name="destinationDirectory"></param>
-        /// <param name="overwrite"></param>
+        /// <param name="sourceDirectory">源文件夹路径。</param>
+        /// <param name="destinationDirectory">目标文件夹路径。</param>
+        /// <param name="overwrite">是否覆盖已存在的文件。</param>
         public static void CopyDirectory(string sourceDirectory, string destinationDirectory, bool overwrite)
         {
             // 创建目标文件夹
@@ -99,11 +102,23 @@ namespace TEngine.Core
                 CopyDirectory(directory, destinationPath, overwrite);
             }
         }
-        
+
         /// <summary>
-        /// 清除文件夹里的所有文件
+        /// 获取目录下的所有文件
         /// </summary>
-        /// <param name="folderPath"></param>
+        /// <param name="folderPath">文件夹路径。</param>
+        /// <param name="searchPattern">需要查找的文件通配符</param>
+        /// <param name="searchOption">查找的类型</param>
+        /// <returns></returns>
+        public static string[] GetDirectoryFile(string folderPath, string searchPattern, SearchOption searchOption)
+        {
+            return Directory.GetFiles(folderPath, searchPattern, searchOption);
+        }
+
+        /// <summary>
+        /// 清空文件夹内的所有文件。
+        /// </summary>
+        /// <param name="folderPath">文件夹路径。</param>
         public static void ClearDirectoryFile(string folderPath)
         {
             if (!Directory.Exists(folderPath))

Assets/GameScripts/DotNet/Core/Helper/StringHelper.cs

@@ -0,0 +1,191 @@
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.Globalization;
+using System.Reflection;
+using System.Text;
+
+namespace TEngine
+{
+    public static class StringHelper
+    {
+        public static IEnumerable<byte> ToBytes(this string str)
+        {
+            byte[] byteArray = Encoding.Default.GetBytes(str);
+            return byteArray;
+        }
+
+        public static byte[] ToByteArray(this string str)
+        {
+            byte[] byteArray = Encoding.Default.GetBytes(str);
+            return byteArray;
+        }
+
+        public static byte[] ToUtf8(this string str)
+        {
+            byte[] byteArray = Encoding.UTF8.GetBytes(str);
+            return byteArray;
+        }
+
+        public static byte[] HexToBytes(this string hexString)
+        {
+            if (hexString.Length % 2 != 0)
+            {
+                throw new ArgumentException(String.Format(CultureInfo.InvariantCulture, "The binary key cannot have an odd number of digits: {0}",
+                    hexString));
+            }
+
+            var hexAsBytes = new byte[hexString.Length / 2];
+            for (int index = 0; index < hexAsBytes.Length; index++)
+            {
+                string byteValue = "";
+                byteValue += hexString[index * 2];
+                byteValue += hexString[index * 2 + 1];
+                hexAsBytes[index] = byte.Parse(byteValue, NumberStyles.HexNumber, CultureInfo.InvariantCulture);
+            }
+
+            return hexAsBytes;
+        }
+
+        public static string Fmt(this string text, params object[] args)
+        {
+            return string.Format(text, args);
+        }
+
+        public static string ListToString<T>(this List<T> list)
+        {
+            StringBuilder sb = new StringBuilder();
+            foreach (T t in list)
+            {
+                sb.Append(t);
+                sb.Append(",");
+            }
+
+            return sb.ToString();
+        }
+
+        public static string ArrayToString<T>(this T[] args)
+        {
+            if (args == null)
+            {
+                return "";
+            }
+
+            string argStr = " [";
+            for (int arrIndex = 0; arrIndex < args.Length; arrIndex++)
+            {
+                argStr += args[arrIndex];
+                if (arrIndex != args.Length - 1)
+                {
+                    argStr += ", ";
+                }
+            }
+
+            argStr += "]";
+            return argStr;
+        }
+
+        public static string ArrayToString<T>(this T[] args, int index, int count)
+        {
+            if (args == null)
+            {
+                return "";
+            }
+
+            string argStr = " [";
+            for (int arrIndex = index; arrIndex < count + index; arrIndex++)
+            {
+                argStr += args[arrIndex];
+                if (arrIndex != args.Length - 1)
+                {
+                    argStr += ", ";
+                }
+            }
+
+            argStr += "]";
+            return argStr;
+        }
+
+        public static string PrintProto(this AProto proto, int stackIndex = 0, string propertyInfoName = "", bool isList = false, int listIndex = 0)
+        {
+            if (proto == null)
+            {
+                return "";
+            }
+
+            StringBuilder _stringBuilder = new StringBuilder();
+            _stringBuilder.Clear();
+
+            Type type = proto.GetType();
+            _stringBuilder.Append($"\n");
+            for (int i = 0; i < stackIndex; i++)
+            {
+                _stringBuilder.Append("\t");
+            }
+
+            propertyInfoName = isList ? $"[{propertyInfoName}][{listIndex}]" : $"[{propertyInfoName}]";
+            _stringBuilder.Append(stackIndex == 0? $"[{type.Name}]" : propertyInfoName);
+
+            var bindingFlags = BindingFlags.Public | BindingFlags.Instance;
+            var propertyInfos = type.GetProperties(bindingFlags);
+            for (var i = 0; i < propertyInfos.Length; ++i)
+            {
+                var propertyInfo = propertyInfos[i];
+
+                if (propertyInfo.PropertyType.BaseType == typeof (AProto))
+                {
+                    _stringBuilder.Append(PrintProto((AProto)propertyInfo.GetValue(proto), stackIndex + 1, propertyInfo.Name));
+                }
+                else if (propertyInfo.PropertyType.IsList() && propertyInfo.PropertyType.IsGenericType)
+                {
+                    object value = propertyInfo.GetValue(proto, null);
+                    if (value != null)
+                    {
+                        Type objType = value.GetType();
+                        int count = Convert.ToInt32(objType.GetProperty("Count").GetValue(value, null));
+                        for (int j = 0; j < count; j++)
+                        {
+                            object item = objType.GetProperty("Item").GetValue(value, new object[] { j });
+                            _stringBuilder.Append(PrintProto((AProto)item, stackIndex + 1, propertyInfo.Name, isList: true, listIndex: j));
+                        }
+                    }
+                }
+                else
+                {
+                    _stringBuilder.Append($"\n");
+                    for (int j = 0; j < stackIndex + 1; j++)
+                    {
+                        _stringBuilder.Append("\t");
+                    }
+
+                    _stringBuilder.Append($"[{propertyInfo.Name}]");
+                    _stringBuilder.Append(": ");
+                    _stringBuilder.Append(propertyInfo.GetValue(proto));
+                }
+            }
+
+            return _stringBuilder.ToString();
+        }
+
+        /// <summary>
+        /// 判断类型是否为可操作的列表类型
+        /// </summary>
+        /// <param name="type"></param>
+        /// <returns></returns>
+        public static bool IsList(this Type type)
+        {
+            if (typeof (System.Collections.IList).IsAssignableFrom(type))
+            {
+                return true;
+            }
+
+            foreach (var it in type.GetInterfaces())
+            {
+                if (it.IsGenericType && typeof (IList<>) == it.GetGenericTypeDefinition())
+                    return true;
+            }
+
+            return false;
+        }
+    }
+}

Assets/GameScripts/DotNet/Core/Helper/StringHelper.cs.meta

@@ -1,5 +1,5 @@
 fileFormatVersion: 2
-guid: 1b7dfd2b954f77047a61bf4c505f8cc1
+guid: c253fa0108e29234f9198e6b720bdbf7
 MonoImporter:
   externalObjects: {}
   serializedVersion: 2

Assets/GameScripts/DotNet/Core/Network/Message/Scheduler/ClientMessageScheduler.cs

@@ -9,6 +9,7 @@ namespace TEngine.Core.Network
         {
             try
             {
+                DisposePackInfo = false;
                 switch (packInfo.ProtocolCode)
                 {
                     case > Opcode.InnerRouteResponse:

Assets/GameScripts/DotNet/Core/Network/NetworkProtocol/KCP/Client/KCPClientNetwork.cs

@@ -56,7 +56,6 @@ namespace TEngine.Core.Network
                         ThreadSynchronizationContext.Main.Post(OnConnectDisconnect);
                     }
                     
-                    _socket.Disconnect(false);
                     _socket.Close();
                 }
 

Assets/GameScripts/DotNet/Core/TEngineSettingsHelper.cs

@@ -69,6 +69,8 @@ public static class TEngineSettingsHelper
         Define.ServerCustomExportDirectory = FileHelper.GetFullPath(root["Export:ServerCustomExportDirectory:Value"]);
         // 客户端自定义导出代码
         Define.ClientCustomExportDirectory = FileHelper.GetFullPath(root["Export:ClientCustomExportDirectory:Value"]);
+        // SceneConfig.xlsx的位置
+        Define.SceneConfigPath = FileHelper.GetFullPath(root["Export:SceneConfigPath:Value"]);
         // 自定义导出代码存放的程序集
         Define.CustomExportAssembly = FileHelper.GetFullPath(root["Export:CustomExportAssembly:Value"]);
     }

Assets/GameScripts/HotFix/GameLogic/GameApp.cs

@@ -24,6 +24,7 @@ public partial class GameApp:Singleton<GameApp>
         Utility.Unity.AddDestroyListener(Instance.OnDestroy);
         Utility.Unity.AddOnDrawGizmosListener(Instance.OnDrawGizmos);
         Utility.Unity.AddOnApplicationPauseListener(Instance.OnApplicationPause);
+        GameModule.Procedure.RestartProcedure(new GameLogic.OnEnterGameAppProcedure());
         Instance.StartGameLogic();
     }
 
@@ -33,7 +34,7 @@ public partial class GameApp:Singleton<GameApp>
     /// </summary>
     private void StartGameLogic()
     {
-
+        
     }
 
     /// <summary>

Assets/GameScripts/HotFix/GameLogic/OnEnterGameAppProcedure.cs

@@ -0,0 +1,13 @@
+using TEngine;
+
+namespace GameLogic
+{
+    public class OnEnterGameAppProcedure : ProcedureBase
+    {
+        protected override void OnEnter(IFsm<IProcedureManager> procedureOwner)
+        {
+            base.OnEnter(procedureOwner);
+            Log.Debug("OnEnter GameApp Procedure");
+        }
+    }
+}

Assets/GameScripts/HotFix/GameLogic/OnEnterGameAppProcedure.cs.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: 415b43b274b541a0a2312417644452b0
+timeCreated: 1692956662

Assets/GameScripts/Main/Procedure/ProcedureInitPackage.cs

@@ -25,17 +25,20 @@ namespace GameMain
         {
             if (GameModule.Resource.PlayMode == EPlayMode.HostPlayMode)
             {
-                UpdateData updateData = await RequestUpdateData();
-
-                if (updateData!=null)
+                if (SettingsUtils.EnableUpdateData())
                 {
-                    if (!string.IsNullOrEmpty(updateData.HostServerURL))
+                    UpdateData updateData = await RequestUpdateData();
+
+                    if (updateData!=null)
                     {
-                        SettingsUtils.FrameworkGlobalSettings.HostServerURL = updateData.HostServerURL;
-                    }
-                    if (!string.IsNullOrEmpty(updateData.FallbackHostServerURL))
-                    {
-                        SettingsUtils.FrameworkGlobalSettings.FallbackHostServerURL = updateData.FallbackHostServerURL;
+                        if (!string.IsNullOrEmpty(updateData.HostServerURL))
+                        {
+                            SettingsUtils.FrameworkGlobalSettings.HostServerURL = updateData.HostServerURL;
+                        }
+                        if (!string.IsNullOrEmpty(updateData.FallbackHostServerURL))
+                        {
+                            SettingsUtils.FrameworkGlobalSettings.FallbackHostServerURL = updateData.FallbackHostServerURL;
+                        }
                     }
                 }
             }

Assets/GameScripts/Main/Procedure/ProcedureLoadAssembly.cs

@@ -116,6 +116,7 @@ namespace GameMain
         
         private void AllAssemblyLoadComplete()
         {
+            ChangeState<ProcedureStartGame>(m_procedureOwner);
 #if UNITY_EDITOR
             m_MainLogicAssembly = AppDomain.CurrentDomain.GetAssemblies().
                 First(assembly => $"{assembly.GetName().Name}.dll" == SettingsUtils.HybridCLRCustomGlobalSettings.LogicMainDllName);
@@ -139,7 +140,6 @@ namespace GameMain
             }
             object[] objects = new object[] { new object[] { m_HotfixAssemblys } };
             entryMethod.Invoke(appType, objects);
-            ChangeState<ProcedureStartGame>(m_procedureOwner);
         }
 
         private Assembly GetMainLogicAssembly()

Assets/TEngine/AssetSetting/AssetBundleCollectorConfig.xml

@@ -31,7 +31,7 @@
       <Collector CollectPath="Assets/AssetRaw/Shaders" CollectGUID="2a4bceb84ed685447ace957f497eb810" CollectType="MainAssetCollector" AddressRule="AddressByFileName" PackRule="PackShaderVariants" FilterRule="CollectShaderVariants" UserData="" AssetTags="" />
     </Group>
     <Group GroupActiveRule="EnableGroup" GroupName="UI" GroupDesc="UI面板" AssetTags="UI">
-      <Collector CollectPath="Assets/AssetRaw/UI" CollectGUID="27e87d83814156648b58f380b834e046" CollectType="MainAssetCollector" AddressRule="AddressByFileName" PackRule="PackDirectory" FilterRule="CollectAll" UserData="" AssetTags="" />
+      <Collector CollectPath="Assets/AssetRaw/UI" CollectGUID="27e87d83814156648b58f380b834e046" CollectType="MainAssetCollector" AddressRule="AddressByFileName" PackRule="PackSeparately" FilterRule="CollectAll" UserData="" AssetTags="" />
     </Group>
     <Group GroupActiveRule="EnableGroup" GroupName="Fonts" GroupDesc="字体" AssetTags="Fonts">
       <Collector CollectPath="Assets/AssetRaw/Fonts" CollectGUID="2473375c9ee163a4b861278b38091455" CollectType="MainAssetCollector" AddressRule="AddressByFileName" PackRule="PackDirectory" FilterRule="CollectAll" UserData="" AssetTags="" />

Assets/TEngine/AssetSetting/AssetBundleCollectorSetting.asset

@@ -154,7 +154,7 @@ MonoBehaviour:
         CollectorGUID: 27e87d83814156648b58f380b834e046
         CollectorType: 0
         AddressRuleName: AddressByFileName
-        PackRuleName: PackDirectory
+        PackRuleName: PackSeparately
         FilterRuleName: CollectAll
         AssetTags: 
         UserData: 

Assets/TEngine/Editor/Resource/YooAsset/PackageCompareWindow.cs

@@ -0,0 +1,138 @@
+using System.IO;
+using System.Collections.Generic;
+using System.Linq;
+using UnityEngine;
+using UnityEditor;
+
+namespace YooAsset.Editor
+{
+	public class PackageCompareWindow : EditorWindow
+	{
+		static PackageCompareWindow _thisInstance;
+		
+		[MenuItem("YooAsset/补丁包比对工具", false, 302)]
+		static void ShowWindow()
+		{
+			if (_thisInstance == null)
+			{
+				_thisInstance = EditorWindow.GetWindow(typeof(PackageCompareWindow), false, "补丁包比对工具", true) as PackageCompareWindow;
+				_thisInstance.minSize = new Vector2(800, 600);
+			}
+			_thisInstance.Show();
+		}
+
+		private string _manifestPath1 = string.Empty;
+		private string _manifestPath2 = string.Empty;
+		private readonly List<PackageBundle> _changeList = new List<PackageBundle>();
+		private readonly List<PackageBundle> _newList = new List<PackageBundle>();
+		private Vector2 _scrollPos1;
+		private Vector2 _scrollPos2;
+
+		private void OnGUI()
+		{
+			GUILayout.Space(10);
+			EditorGUILayout.BeginHorizontal();
+			if (GUILayout.Button("选择补丁包1", GUILayout.MaxWidth(150)))
+			{
+				string resultPath = EditorUtility.OpenFilePanel("Find", "Assets/", "bytes");
+				if (string.IsNullOrEmpty(resultPath))
+					return;
+				_manifestPath1 = resultPath;
+			}
+			EditorGUILayout.LabelField(_manifestPath1);
+			EditorGUILayout.EndHorizontal();
+
+			GUILayout.Space(10);
+			EditorGUILayout.BeginHorizontal();
+			if (GUILayout.Button("选择补丁包2", GUILayout.MaxWidth(150)))
+			{
+				string resultPath = EditorUtility.OpenFilePanel("Find", "Assets/", "bytes");
+				if (string.IsNullOrEmpty(resultPath))
+					return;
+				_manifestPath2 = resultPath;
+			}
+			EditorGUILayout.LabelField(_manifestPath2);
+			EditorGUILayout.EndHorizontal();
+
+			if (string.IsNullOrEmpty(_manifestPath1) == false && string.IsNullOrEmpty(_manifestPath2) == false)
+			{
+				if (GUILayout.Button("比对差异", GUILayout.MaxWidth(150)))
+				{
+					ComparePackage(_changeList, _newList);
+				}
+			}
+
+			EditorGUILayout.Space();
+			using (new EditorGUI.DisabledScope(false))
+			{
+				int totalCount = _changeList.Count;
+				EditorGUILayout.Foldout(true, $"差异列表 ( {totalCount} )");
+
+				EditorGUI.indentLevel = 1;
+				_scrollPos1 = EditorGUILayout.BeginScrollView(_scrollPos1);
+				{
+					foreach (var bundle in _changeList)
+					{
+						EditorGUILayout.LabelField($"{bundle.BundleName} | {(bundle.FileSize / 1024)}K");
+					}
+				}
+				EditorGUILayout.EndScrollView();
+				EditorGUI.indentLevel = 0;
+			}
+
+			EditorGUILayout.Space();
+			using (new EditorGUI.DisabledScope(false))
+			{
+				int totalCount = _newList.Count;
+				EditorGUILayout.Foldout(true, $"新增列表 ( {totalCount} )");
+
+				EditorGUI.indentLevel = 1;
+				_scrollPos2 = EditorGUILayout.BeginScrollView(_scrollPos2);
+				{
+					foreach (var bundle in _newList)
+					{
+						EditorGUILayout.LabelField($"{bundle.BundleName}");
+					}
+				}
+				EditorGUILayout.EndScrollView();
+				EditorGUI.indentLevel = 0;
+			}
+		}
+
+		private void ComparePackage(List<PackageBundle> changeList, List<PackageBundle> newList)
+		{
+			changeList.Clear();
+			newList.Clear();
+
+			// 加载补丁清单1
+			byte[] bytesData1 = FileUtility.ReadAllBytes(_manifestPath1);
+			PackageManifest manifest1 = ManifestTools.DeserializeFromBinary(bytesData1);
+
+			// 加载补丁清单1
+			byte[] bytesData2 = FileUtility.ReadAllBytes(_manifestPath2);
+			PackageManifest manifest2 = ManifestTools.DeserializeFromBinary(bytesData2);
+
+			// 拷贝文件列表
+			foreach (var bundle2 in manifest2.BundleList)
+			{
+				if (manifest1.TryGetPackageBundle(bundle2.BundleName, out PackageBundle bundle1))
+				{
+					if (bundle2.FileHash != bundle1.FileHash)
+					{
+						changeList.Add(bundle2);
+					}
+				}
+				else
+				{
+					newList.Add(bundle2);
+				}
+			}
+
+			// 按字母重新排序
+			changeList.Sort((x, y) => string.Compare(x.BundleName, y.BundleName));
+			newList.Sort((x, y) => string.Compare(x.BundleName, y.BundleName));
+
+			Debug.Log("资源包差异比对完成！");
+		}
+	}
+}

Assets/TEngine/Editor/Resource/YooAsset/PackageCompareWindow.cs.meta

@@ -1,5 +1,5 @@
 fileFormatVersion: 2
-guid: 59821d6add0226e40a841e85a2cba8ec
+guid: 46962b0d15f63264bb45fe5be11f48cb
 MonoImporter:
   externalObjects: {}
   serializedVersion: 2

Assets/TEngine/Editor/Resource/YooAsset/PackageImportWindow.cs

@@ -0,0 +1,89 @@
+using System.IO;
+using UnityEngine;
+using UnityEditor;
+
+namespace YooAsset.Editor
+{
+	public class PackageImportWindow : EditorWindow
+	{
+		static PackageImportWindow _thisInstance;
+
+		[MenuItem("YooAsset/补丁包导入工具", false, 301)]
+		static void ShowWindow()
+		{
+			if (_thisInstance == null)
+			{
+				_thisInstance = EditorWindow.GetWindow(typeof(PackageImportWindow), false, "补丁包导入工具", true) as PackageImportWindow;
+				_thisInstance.minSize = new Vector2(800, 600);
+			}
+			_thisInstance.Show();
+		}
+
+		private string _manifestPath = string.Empty;
+
+		private void OnGUI()
+		{
+			GUILayout.Space(10);
+			EditorGUILayout.BeginHorizontal();
+			if (GUILayout.Button("选择补丁包", GUILayout.MaxWidth(150)))
+			{
+				string resultPath = EditorUtility.OpenFilePanel("Find", "Assets/", "bytes");
+				if (string.IsNullOrEmpty(resultPath))
+					return;
+				_manifestPath = resultPath;
+			}
+			EditorGUILayout.LabelField(_manifestPath);
+			EditorGUILayout.EndHorizontal();
+
+			if (string.IsNullOrEmpty(_manifestPath) == false)
+			{
+				if (GUILayout.Button("导入补丁包（全部文件）", GUILayout.MaxWidth(150)))
+				{
+					AssetBundleBuilderHelper.ClearStreamingAssetsFolder();
+					CopyPackageFiles(_manifestPath);
+				}
+			}
+		}
+
+		private void CopyPackageFiles(string manifestFilePath)
+		{
+			string manifestFileName = Path.GetFileNameWithoutExtension(manifestFilePath);
+			string outputDirectory = Path.GetDirectoryName(manifestFilePath);
+
+			// 加载补丁清单
+			byte[] bytesData = FileUtility.ReadAllBytes(manifestFilePath);
+			PackageManifest manifest = ManifestTools.DeserializeFromBinary(bytesData);
+
+			// 拷贝核心文件
+			{
+				string sourcePath = $"{outputDirectory}/{manifestFileName}.bytes";
+				string destPath = $"{AssetBundleBuilderHelper.GetStreamingAssetsFolderPath()}/{manifestFileName}.bytes";
+				EditorTools.CopyFile(sourcePath, destPath, true);
+			}
+			{
+				string sourcePath = $"{outputDirectory}/{manifestFileName}.hash";
+				string destPath = $"{AssetBundleBuilderHelper.GetStreamingAssetsFolderPath()}/{manifestFileName}.hash";
+				EditorTools.CopyFile(sourcePath, destPath, true);
+			}
+			{
+				string fileName = YooAssetSettingsData.GetPackageVersionFileName(manifest.PackageName);
+				string sourcePath = $"{outputDirectory}/{fileName}";
+				string destPath = $"{AssetBundleBuilderHelper.GetStreamingAssetsFolderPath()}/{fileName}";
+				EditorTools.CopyFile(sourcePath, destPath, true);
+			}
+
+			// 拷贝文件列表
+			int fileCount = 0;
+			foreach (var packageBundle in manifest.BundleList)
+			{
+				fileCount++;
+				string sourcePath = $"{outputDirectory}/{packageBundle.FileName}";
+				string destPath = $"{AssetBundleBuilderHelper.GetStreamingAssetsFolderPath()}/{packageBundle.FileName}";
+				EditorTools.CopyFile(sourcePath, destPath, true);
+			}
+
+			Debug.Log($"补丁包拷贝完成，一共拷贝了{fileCount}个资源文件");
+			AssetDatabase.Refresh();
+		}
+	}
+}

Assets/TEngine/Editor/Resource/YooAsset/PackageImportWindow.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 9054ed6f15278064aa817961e48878d5
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

Assets/TEngine/Editor/Utility/Type.cs

@@ -14,10 +14,6 @@ namespace TEngine.Editor
             "Assembly-CSharp",
             "GameMain.Runtime",
             "GameMain",
-            "GameBase",
-            "GameLogic",
-            "GameProto",
-            "BattleCore.Runtime",
         };
 
         private static readonly string[] RuntimeOrEditorAssemblyNames =
@@ -27,11 +23,7 @@ namespace TEngine.Editor
             "TEngine.Editor",
             "Assembly-CSharp-Editor",
             "GameMain",
-            "GameMain.Editor",
-            "GameBase",
-            "GameLogic",
-            "GameProto",
-            "BattleCore.Runtime",
+            "GameMain.Editor"
         };
 
         /// <summary>

Assets/TEngine/Libraries/System.Runtime.CompilerServices.Unsafe.dll.meta

@@ -0,0 +1,33 @@
+fileFormatVersion: 2
+guid: 4029d25cf768d5440b7366c5e62c963f
+PluginImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  iconMap: {}
+  executionOrder: {}
+  defineConstraints: []
+  isPreloaded: 0
+  isOverridable: 0
+  isExplicitlyReferenced: 0
+  validateReferences: 1
+  platformData:
+  - first:
+      Any: 
+    second:
+      enabled: 1
+      settings: {}
+  - first:
+      Editor: Editor
+    second:
+      enabled: 0
+      settings:
+        DefaultValueInitialized: true
+  - first:
+      Windows Store Apps: WindowsStoreApps
+    second:
+      enabled: 0
+      settings:
+        CPU: AnyCPU
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

Assets/TEngine/Runtime/Extension/OdinInspectorExtension.cs

@@ -1,134 +0,0 @@
-using System;
-using System.Diagnostics;
-using UnityEngine;
-
-#if !ODIN_INSPECTOR
-namespace Sirenix.OdinInspector
-{
-    [AttributeUsage(AttributeTargets.Method, AllowMultiple = false, Inherited = false)]
-    [Conditional("UNITY_EDITOR")]
-    public class ButtonAttribute : Attribute
-    {
-        public ButtonAttribute()
-        {
-        }
-
-        public ButtonAttribute(string name)
-        {
-        }
-    }
-
-    [AttributeUsage(AttributeTargets.All, AllowMultiple = false, Inherited = true)]
-    [Conditional("UNITY_EDITOR")]
-    public sealed class ReadOnlyAttribute : Attribute
-    {
-    }
-
-    [AttributeUsage(AttributeTargets.All, AllowMultiple = false, Inherited = false)]
-    [Conditional("UNITY_EDITOR")]
-    public class ShowInInspectorAttribute : Attribute
-    {
-    }
-
-    [AttributeUsage(AttributeTargets.All, AllowMultiple = true, Inherited = true)]
-    [Conditional("UNITY_EDITOR")]
-    public sealed class HideIfAttribute : Attribute
-    {
-        public string MemberName;
-        public object Value;
-        public bool Animate;
-
-        public HideIfAttribute(string memberName, bool animate = true)
-        {
-            this.MemberName = memberName;
-            this.Animate = animate;
-        }
-    }
-
-    [DontApplyToListElements]
-    [AttributeUsage(AttributeTargets.All, AllowMultiple = true, Inherited = true)]
-    [Conditional("UNITY_EDITOR")]
-    public sealed class OnValueChangedAttribute : Attribute
-    {
-        public string MethodName;
-
-        public bool IncludeChildren;
-
-        public OnValueChangedAttribute(string methodName, bool includeChildren = false)
-        {
-            this.MethodName = methodName;
-            this.IncludeChildren = includeChildren;
-        }
-    }
-
-    [AttributeUsage(AttributeTargets.All, AllowMultiple = false)]
-    [Conditional("UNITY_EDITOR")]
-    public class TableListAttribute : Attribute
-    {
-        public int DefaultMinColumnWidth = 40;
-        public bool DrawScrollView = true;
-
-        public int MinScrollViewHeight = 350;
-
-        public int CellPadding = 2;
-
-        public int NumberOfItemsPerPage;
-
-        public bool IsReadOnly;
-
-        public bool ShowIndexLabels;
-
-        public int MaxScrollViewHeight;
-
-        public bool AlwaysExpanded;
-
-        public bool HideToolbar;
-
-        [SerializeField] [HideInInspector] private bool showPagingHasValue;
-    }
-
-    [AttributeUsage(AttributeTargets.Class)]
-    public sealed class DontApplyToListElementsAttribute : Attribute
-    {
-    }
-
-    [AttributeUsage(AttributeTargets.All, AllowMultiple = false, Inherited = true)]
-    [DontApplyToListElements]
-    [Conditional("UNITY_EDITOR")]
-    public class PropertySpaceAttribute : Attribute
-    {
-        public float SpaceBefore;
-        public float SpaceAfter;
-
-        public PropertySpaceAttribute()
-        {
-            this.SpaceBefore = 8f;
-            this.SpaceAfter = 0.0f;
-        }
-
-        public PropertySpaceAttribute(float spaceBefore)
-        {
-            this.SpaceBefore = spaceBefore;
-            this.SpaceAfter = 0.0f;
-        }
-
-        public PropertySpaceAttribute(float spaceBefore, float spaceAfter)
-        {
-            this.SpaceBefore = spaceBefore;
-            this.SpaceAfter = spaceAfter;
-        }
-    }
-
-    [AttributeUsage(AttributeTargets.All, AllowMultiple = false, Inherited = true)]
-    [Conditional("UNITY_EDITOR")]
-    public class LabelTextAttribute : Attribute
-    {
-        public string Text;
-
-        public LabelTextAttribute(string text)
-        {
-            this.Text = text;
-        }
-    }
-}
-#endif

Assets/TEngine/Runtime/Extension/TransformExtension.cs

@@ -1,34 +0,0 @@
-using System.Collections.Generic;
-using UnityEngine;
-
-namespace TEngine
-{
-    public static partial class TransformExtension
-    {
-        public static float YDeg(this Transform tran)
-        {
-            return tran.eulerAngles.y;
-        }
-
-        public static void RemoveAllChildren(this Transform tran)
-        {
-            var count = tran.childCount;
-            for (int i = 0; i < count; i++)
-            {
-                GameObject.DestroyImmediate(tran.GetChild(0).gameObject);
-            }
-        }
-
-        public static List<Transform> GetAllChildren(this Transform tran)
-        {
-            var count = tran.childCount;
-            List<Transform> allTrans = new List<Transform>();
-            for (int i = 0; i < count; i++)
-            {
-                allTrans.Add(tran.GetChild(i));
-            }
-
-            return allTrans;
-        }
-    }
-}

Assets/TEngine/Runtime/GameFramework/Audio/AudioModule.cs

@@ -23,7 +23,7 @@ namespace TEngine
         
         private float _volume = 1f;
         private bool _enable = true;
-        private AudioCategory[] _audioCategories = new AudioCategory[(int)AudioType.Max];
+        private readonly AudioCategory[] _audioCategories = new AudioCategory[(int)AudioType.Max];
         private readonly float[] _categoriesVolume = new float[(int)AudioType.Max];
         public readonly Dictionary<string, AssetOperationHandle> AudioClipPool = new Dictionary<string, AssetOperationHandle>();
         public IResourceManager ResourceManager;
@@ -392,19 +392,20 @@ namespace TEngine
 
             for (int i = 0; i < (int)AudioType.Max; ++i)
             {
-                if (_audioCategories[i] != null)
+                var audioCategory = _audioCategories[i];
+                if (audioCategory != null)
                 {
-                    for (int j = 0; j < _audioCategories[i].AudioAgents.Count; ++j)
+                    for (int j = 0; j < audioCategory.AudioAgents.Count; ++j)
                     {
-                        if (_audioCategories[i].AudioAgents[j] != null)
+                        var audioAgent = audioCategory.AudioAgents[j];
+                        if (audioAgent != null)
                         {
-                            _audioCategories[i].AudioAgents[j].Destroy();
-                            _audioCategories[i].AudioAgents[j] = null;
+                            audioAgent.Destroy();
+                            audioAgent = null;
                         }
                     }
                 }
-
-                _audioCategories[i] = null;
+                audioCategory = null;
             }
 
             Initialize();
@@ -538,11 +539,11 @@ namespace TEngine
         /// </summary>
         private void Update()
         {
-            for (int i = 0; i < _audioCategories.Length; ++i)
+            foreach (var audioCategory in _audioCategories)
             {
-                if (_audioCategories[i] != null)
+                if (audioCategory != null)
                 {
-                    _audioCategories[i].Update(GameTime.deltaTime);
+                    audioCategory.Update(Time.deltaTime);
                 }
             }
         }

Assets/TEngine/Runtime/GameFramework/Procedure/ProcedureModule.cs

@@ -13,11 +13,9 @@ namespace TEngine
         private IProcedureManager m_ProcedureManager = null;
         private ProcedureBase m_EntranceProcedure = null;
 
-        [SerializeField]
-        private string[] m_AvailableProcedureTypeNames = null;
+        [SerializeField] private string[] m_AvailableProcedureTypeNames = null;
 
-        [SerializeField]
-        private string m_EntranceProcedureTypeName = null;
+        [SerializeField] private string m_EntranceProcedureTypeName = null;
 
         /// <summary>
         /// 获取当前流程。
@@ -30,6 +28,7 @@ namespace TEngine
                 {
                     return null;
                 }
+
                 return m_ProcedureManager.CurrentProcedure;
             }
         }
@@ -45,6 +44,7 @@ namespace TEngine
                 {
                     return 0f;
                 }
+
                 return m_ProcedureManager.CurrentProcedureTime;
             }
         }
@@ -140,5 +140,31 @@ namespace TEngine
         {
             return m_ProcedureManager.GetProcedure(procedureType);
         }
+
+        /// <summary>
+        /// 重启流程。
+        /// <remarks>默认使用第一个流程作为启动流程。</remarks>
+        /// </summary>
+        /// <param name="procedures">新的的流程。</param>
+        /// <returns>是否重启成功。</returns>
+        /// <exception cref="GameFrameworkException">重启异常。</exception>
+        public bool RestartProcedure(params ProcedureBase[] procedures)
+        {
+            if (procedures == null || procedures.Length <= 0)
+            {
+                throw new GameFrameworkException("RestartProcedure Failed procedures is invalid.");
+            }
+
+            if (!GameModule.Fsm.DestroyFsm<IProcedureManager>())
+            {
+                return false;
+            }
+            m_ProcedureManager = null;
+            m_ProcedureManager = GameFrameworkModuleSystem.GetModule<IProcedureManager>();
+            IFsmManager fsmManager = GameFrameworkModuleSystem.GetModule<IFsmManager>();
+            m_ProcedureManager.Initialize(fsmManager, procedures);
+            m_ProcedureManager.StartProcedure(procedures[0].GetType());
+            return true;
+        }
     }
-}
+}

Assets/TEngine/Runtime/GameFramework/Resource/Pool.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: 62c8f710f3264758a89eaefc4ae88921
+timeCreated: 1693831262

Assets/TEngine/Runtime/GameFramework/Resource/Pool/CreatePoolOperation.cs

@@ -0,0 +1,70 @@
+using YooAsset;
+
+namespace TEngine
+{
+	public class CreatePoolOperation : GameAsyncOperation
+	{
+		private enum ESteps
+		{
+			None,
+			Waiting,
+			Done,
+		}
+
+		private readonly AssetOperationHandle _handle;
+		private ESteps _steps = ESteps.None;
+
+		internal CreatePoolOperation(AssetOperationHandle handle)
+		{
+			_handle = handle;
+		}
+		protected override void OnStart()
+		{
+			_steps = ESteps.Waiting;
+		}
+		protected override void OnUpdate()
+		{
+			if (_steps == ESteps.None || _steps == ESteps.Done)
+				return;
+
+			if (_steps == ESteps.Waiting)
+			{
+				if (_handle.IsValid == false)
+				{
+					_steps = ESteps.Done;
+					Status = EOperationStatus.Failed;
+					Error = $"{nameof(AssetOperationHandle)} is invalid.";
+					return;
+				}
+
+				if (_handle.IsDone == false)
+					return;
+
+				if (_handle.AssetObject == null)
+				{
+					_steps = ESteps.Done;
+					Status = EOperationStatus.Failed;
+					Error = $"{nameof(AssetOperationHandle.AssetObject)} is null.";
+					return;
+				}
+
+				_steps = ESteps.Done;
+				Status = EOperationStatus.Succeed;
+			}
+		}
+
+		/// <summary>
+		/// 等待异步实例化结束。
+		/// </summary>
+		public void WaitForAsyncComplete()
+		{
+			if (_handle != null)
+			{
+				if (_steps == ESteps.Done)
+					return;
+				_handle.WaitForAsyncComplete();
+				OnUpdate();
+			}
+		}
+	}
+}

Assets/TEngine/Runtime/GameFramework/Resource/Pool/CreatePoolOperation.cs.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: 4e1853e7ff624c639fba990079beeee5
+timeCreated: 1693831296

Assets/TEngine/Runtime/GameFramework/Resource/Pool/GameObjectPool.cs

@@ -0,0 +1,234 @@
+using System.Collections.Generic;
+using UnityEngine;
+using YooAsset;
+
+namespace TEngine
+{
+	/// <summary>
+	/// 游戏物体对象池。
+	/// </summary>
+	internal class GameObjectPool
+	{
+		private readonly GameObject _root;
+		private readonly Queue<InstantiateOperation> _cacheOperations;
+		private readonly bool _dontDestroy;
+		private readonly int _initCapacity;
+		private readonly int _maxCapacity;
+		private readonly float _destroyTime;
+		private float _lastRestoreRealTime = -1f;
+
+		/// <summary>
+		/// 资源句柄。
+		/// </summary>
+		public AssetOperationHandle AssetHandle { private set; get; }
+
+		/// <summary>
+		/// 资源定位地址。
+		/// </summary>
+		public string Location { private set; get; }
+
+		/// <summary>
+		/// 内部缓存总数。
+		/// </summary>
+		public int CacheCount => _cacheOperations.Count;
+
+		/// <summary>
+		/// 外部使用总数。
+		/// </summary>
+		public int SpawnCount { private set; get; } = 0;
+
+		/// <summary>
+		/// 是否常驻不销毁。
+		/// </summary>
+		public bool DontDestroy => _dontDestroy;
+
+		/// <summary>
+		/// 游戏物体对象池。
+		/// </summary>
+		/// <param name="poolingRoot">对象池根节点。</param>
+		/// <param name="location">资源定位地址。</param>
+		/// <param name="dontDestroy">是否常驻不销毁。</param>
+		/// <param name="initCapacity">初始容量。</param>
+		/// <param name="maxCapacity">最大容量。</param>
+		/// <param name="destroyTime">对象池销毁时间。</param>
+		public GameObjectPool(GameObject poolingRoot, string location, bool dontDestroy, int initCapacity, int maxCapacity, float destroyTime)
+		{
+			_root = new GameObject(location);
+			_root.transform.parent = poolingRoot.transform;
+			Location = location;
+
+			_dontDestroy = dontDestroy;
+			_initCapacity = initCapacity;
+			_maxCapacity = maxCapacity;
+			_destroyTime = destroyTime;
+
+			// 创建缓存池
+			_cacheOperations = new Queue<InstantiateOperation>(initCapacity);
+		}
+
+		/// <summary>
+		/// 创建对象池。
+		/// </summary>
+		/// <param name="package">资源包。</param>
+		public void CreatePool(ResourcePackage package)
+		{
+			// 加载游戏对象
+			AssetHandle = package.LoadAssetAsync<GameObject>(Location);
+
+			// 创建初始对象
+			for (int i = 0; i < _initCapacity; i++)
+			{
+				var operation = AssetHandle.InstantiateAsync(_root.transform);
+				operation.Completed += Operation_Completed;
+				_cacheOperations.Enqueue(operation);
+			}
+		}
+		private void Operation_Completed(AsyncOperationBase obj)
+		{
+			if (obj.Status == EOperationStatus.Succeed)
+			{
+				var op = obj as InstantiateOperation;
+				if (op.Result != null)
+					op.Result.SetActive(false);
+			}
+		}
+
+		/// <summary>
+		/// 销毁游戏对象池。
+		/// </summary>
+		public void DestroyPool()
+		{
+			// 卸载资源对象
+			AssetHandle.Release();
+			AssetHandle = null;
+
+			// 销毁游戏对象
+			Object.Destroy(_root);
+			_cacheOperations.Clear();
+
+			SpawnCount = 0;
+		}
+
+		/// <summary>
+		/// 查询静默时间内是否可以销毁。
+		/// </summary>
+		public bool CanAutoDestroy()
+		{
+			if (_dontDestroy)
+				return false;
+			if (_destroyTime < 0)
+				return false;
+
+			if (_lastRestoreRealTime > 0 && SpawnCount <= 0)
+				return (Time.realtimeSinceStartup - _lastRestoreRealTime) > _destroyTime;
+			else
+				return false;
+		}
+
+		/// <summary>
+		/// 游戏对象池是否已经销毁。
+		/// </summary>
+		public bool IsDestroyed()
+		{
+			return AssetHandle == null;
+		}
+
+		/// <summary>
+		/// 回收操作。
+		/// </summary>
+		/// <param name="operation">资源实例化操作句柄。</param>
+		public void Restore(InstantiateOperation operation)
+		{
+			if (IsDestroyed())
+			{
+				DestroyInstantiateOperation(operation);
+				return;
+			}
+
+			SpawnCount--;
+			if (SpawnCount <= 0)
+				_lastRestoreRealTime = Time.realtimeSinceStartup;
+
+			// 如果外部逻辑销毁了游戏对象
+			if (operation.Status == EOperationStatus.Succeed)
+			{
+				if (operation.Result == null)
+					return;
+			}
+
+			// 如果缓存池还未满员
+			if (_cacheOperations.Count < _maxCapacity)
+			{
+				SetRestoreGameObject(operation.Result);
+				_cacheOperations.Enqueue(operation);
+			}
+			else
+			{
+				DestroyInstantiateOperation(operation);
+			}
+		}
+
+		/// <summary>
+		/// 丢弃操作。
+		/// </summary>
+		/// <param name="operation">资源实例化操作句柄。</param>
+		public void Discard(InstantiateOperation operation)
+		{
+			if (IsDestroyed())
+			{
+				DestroyInstantiateOperation(operation);
+				return;
+			}
+
+			SpawnCount--;
+			if (SpawnCount <= 0)
+				_lastRestoreRealTime = Time.realtimeSinceStartup;
+
+			DestroyInstantiateOperation(operation);
+		}
+
+		/// <summary>
+		/// 获取一个游戏对象。
+		/// </summary>
+		/// <param name="parent">父节点位置。</param>
+		/// <param name="position">位置。</param>
+		/// <param name="rotation">旋转。</param>
+		/// <param name="forceClone">是否强制克隆。</param>
+		/// <param name="userDatas">用户自定义数据。</param>
+		/// <returns>Spawn操作句柄。</returns>
+		public SpawnHandle Spawn(Transform parent, Vector3 position, Quaternion rotation, bool forceClone, params System.Object[] userDatas)
+		{
+			InstantiateOperation operation;
+			if (forceClone == false && _cacheOperations.Count > 0)
+				operation = _cacheOperations.Dequeue();
+			else
+				operation = AssetHandle.InstantiateAsync();
+
+			SpawnCount++;
+			SpawnHandle handle = new SpawnHandle(this, operation, parent, position, rotation, userDatas);
+			YooAssets.StartOperation(handle);
+			return handle;
+		}
+
+		private void DestroyInstantiateOperation(InstantiateOperation operation)
+		{
+			// 取消异步操作
+			operation.Cancel();
+
+			// 销毁游戏对象
+			if (operation.Result != null)
+			{
+				Object.Destroy(operation.Result);
+			}
+		}
+		private void SetRestoreGameObject(GameObject gameObj)
+		{
+			if (gameObj != null)
+			{
+				gameObj.SetActive(false);
+				gameObj.transform.SetParent(_root.transform);
+				gameObj.transform.SetPositionAndRotation(Vector3.zero, Quaternion.identity);
+			}
+		}
+	}
+}

Assets/TEngine/Runtime/GameFramework/Resource/Pool/GameObjectPool.cs.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: 3f0c9bab3d1243fda94ec9a08844ceee
+timeCreated: 1693831296

Assets/TEngine/Runtime/GameFramework/Resource/Pool/ResourcePool.cs

@@ -0,0 +1,253 @@
+using System;
+using System.Collections.Generic;
+using UnityEngine;
+using YooAsset;
+
+namespace TEngine
+{
+	/// <summary>
+	/// 游戏对象池系统。
+	/// <remarks>用法 SpawnHandle handle = ResourcePool.SpawnAsync("Cube");</remarks>
+	/// </summary>
+	public static class ResourcePool
+	{
+		private static bool _isInitialize = false;
+		private static readonly List<Spawner> Spawners = new List<Spawner>();
+		private static GameObject _root;
+		private static Spawner _defaultSpawner = null;
+		
+		/// <summary>
+		/// 默认Package对象生成器。
+		/// </summary>
+		private static Spawner DefaultSpawner => _defaultSpawner ??= CreateSpawner();
+
+		/// <summary>
+		/// 初始化游戏对象池系统
+		/// </summary>
+		internal static void Initialize(GameObject root)
+		{
+			if (_isInitialize)
+				throw new Exception($"{nameof(ResourcePool)} is initialized !");
+
+			if (_isInitialize == false)
+			{
+				_root = root;
+				_isInitialize = true;
+				Log.Info($"{nameof(ResourcePool)} Initialize !");
+			}
+		}
+
+		/// <summary>
+		/// 销毁游戏对象池系统
+		/// </summary>
+		internal static void Destroy()
+		{
+			if (_isInitialize)
+			{
+				foreach (var spawner in Spawners)
+				{
+					spawner.Destroy();
+				}
+				Spawners.Clear();
+
+				_isInitialize = false;
+
+				Log.Debug($"{nameof(ResourcePool)} destroy all !");
+			}
+		}
+
+		/// <summary>
+		/// 更新游戏对象池系统
+		/// </summary>
+		internal static void Update()
+		{
+			if (_isInitialize)
+			{
+				foreach (var spawner in Spawners)
+				{
+					spawner.Update();
+				}
+			}
+		}
+
+		/// <summary>
+		/// 创建游戏对象生成器
+		/// </summary>
+		/// <param name="packageName">资源包名称</param>
+		public static Spawner CreateSpawner(string packageName = "")
+		{
+			if (string.IsNullOrEmpty(packageName))
+			{
+				packageName = GameModule.Resource.packageName;
+			}
+			// 获取资源包
+			var assetPackage = YooAssets.GetPackage(packageName);
+			if (assetPackage == null)
+				throw new Exception($"Not found asset package : {packageName}");
+
+			// 检测资源包初始化状态
+			if (assetPackage.InitializeStatus == EOperationStatus.None)
+				throw new Exception($"Asset package {packageName} not initialize !");
+			if (assetPackage.InitializeStatus == EOperationStatus.Failed)
+				throw new Exception($"Asset package {packageName} initialize failed !");
+
+			if (HasSpawner(packageName))
+				return GetSpawner(packageName);
+
+			Spawner spawner = new Spawner(_root, assetPackage);
+			Spawners.Add(spawner);
+			return spawner;
+		}
+
+		/// <summary>
+		/// 获取游戏对象生成器。
+		/// </summary>
+		/// <param name="packageName">资源包名称。</param>
+		public static Spawner GetSpawner(string packageName = "")
+		{
+			if (string.IsNullOrEmpty(packageName))
+			{
+				packageName = GameModule.Resource.packageName;
+			}
+			foreach (var spawner in Spawners)
+			{
+				if (spawner.PackageName == packageName)
+					return spawner;
+			}
+
+			Log.Warning($"Not found spawner : {packageName}");
+			return null;
+		}
+
+		/// <summary>
+		/// 检测游戏对象生成器是否存在。
+		/// </summary>
+		/// <param name="packageName">资源包名称。</param>
+		public static bool HasSpawner(string packageName = "")
+		{
+			if (string.IsNullOrEmpty(packageName))
+			{
+				packageName = GameModule.Resource.packageName;
+			}
+			foreach (var spawner in Spawners)
+			{
+				if (spawner.PackageName == packageName)
+					return true;
+			}
+			return false;
+		}
+
+		#region 操作接口
+
+		/// <summary>
+		/// 销毁所有对象池及其资源。
+		/// </summary>
+		/// <param name="includeAll">销毁所有对象池，包括常驻对象池。</param>
+		public static void DestroyAll(bool includeAll)
+		{
+			DefaultSpawner.DestroyAll(includeAll);
+		}
+
+
+		/// <summary>
+		/// 异步创建指定资源的游戏对象池。
+		/// </summary>
+		/// <param name="location">资源定位地址。</param>
+		/// <param name="dontDestroy">资源常驻不销毁。</param>
+		/// <param name="initCapacity">对象池的初始容量。</param>
+		/// <param name="maxCapacity">对象池的最大容量。</param>
+		/// <param name="destroyTime">静默销毁时间（注意：小于零代表不主动销毁）。</param>
+		public static CreatePoolOperation CreateGameObjectPoolAsync(string location, bool dontDestroy = false, int initCapacity = 0, int maxCapacity = int.MaxValue, float destroyTime = -1f)
+		{
+			return DefaultSpawner.CreateGameObjectPoolAsync(location, dontDestroy, initCapacity, maxCapacity, destroyTime);
+		}
+
+		/// <summary>
+		/// 同步创建指定资源的游戏对象池。
+		/// </summary>
+		/// <param name="location">资源定位地址。</param>
+		/// <param name="dontDestroy">资源常驻不销毁。</param>
+		/// <param name="initCapacity">对象池的初始容量。</param>
+		/// <param name="maxCapacity">对象池的最大容量。</param>
+		/// <param name="destroyTime">静默销毁时间（注意：小于零代表不主动销毁）。</param>
+		public static CreatePoolOperation CreateGameObjectPoolSync(string location, bool dontDestroy = false, int initCapacity = 0, int maxCapacity = int.MaxValue, float destroyTime = -1f)
+		{
+			return DefaultSpawner.CreateGameObjectPoolSync(location, dontDestroy, initCapacity, maxCapacity, destroyTime);
+		}
+
+		/// <summary>
+		/// 异步实例化一个游戏对象。
+		/// </summary>
+		/// <param name="location">资源定位地址。</param>
+		/// <param name="forceClone">强制克隆游戏对象，忽略缓存池里的对象。</param>
+		/// <param name="userDatas">用户自定义数据。</param>
+		public static SpawnHandle SpawnAsync(string location, bool forceClone = false, params System.Object[] userDatas)
+		{
+			return DefaultSpawner.SpawnAsync(location, null, Vector3.zero, Quaternion.identity, forceClone, userDatas);
+		}
+
+		/// <summary>
+		/// 异步实例化一个游戏对象。
+		/// </summary>
+		/// <param name="location">资源定位地址。</param>
+		/// <param name="parent">父物体。</param>
+		/// <param name="forceClone">强制克隆游戏对象，忽略缓存池里的对象。</param>
+		/// <param name="userDatas">用户自定义数据。</param>
+		public static SpawnHandle SpawnAsync(string location, Transform parent, bool forceClone = false, params System.Object[] userDatas)
+		{
+			return DefaultSpawner.SpawnAsync(location, parent, Vector3.zero, Quaternion.identity, forceClone, userDatas);
+		}
+
+		/// <summary>
+		/// 异步实例化一个游戏对象。
+		/// </summary>
+		/// <param name="location">资源定位地址。</param>
+		/// <param name="parent">父物体。</param>
+		/// <param name="position">世界坐标。</param>
+		/// <param name="rotation">世界角度。</param>
+		/// <param name="forceClone">强制克隆游戏对象，忽略缓存池里的对象。</param>
+		/// <param name="userDatas">用户自定义数据。</param>
+		public static SpawnHandle SpawnAsync(string location, Transform parent, Vector3 position, Quaternion rotation, bool forceClone = false, params System.Object[] userDatas)
+		{
+			return DefaultSpawner.SpawnAsync(location, parent, position, rotation, forceClone, userDatas);
+		}
+
+		/// <summary>
+		/// 同步实例化一个游戏对象。
+		/// </summary>
+		/// <param name="location">资源定位地址。</param>
+		/// <param name="forceClone">强制克隆游戏对象，忽略缓存池里的对象。</param>
+		/// <param name="userDatas">用户自定义数据。</param>
+		public static SpawnHandle SpawnSync(string location, bool forceClone = false, params System.Object[] userDatas)
+		{
+			return DefaultSpawner.SpawnSync(location, null, Vector3.zero, Quaternion.identity, forceClone, userDatas);
+		}
+
+		/// <summary>
+		/// 同步实例化一个游戏对象。
+		/// </summary>
+		/// <param name="location">资源定位地址。</param>
+		/// <param name="parent">父物体</param>
+		/// <param name="forceClone">强制克隆游戏对象，忽略缓存池里的对象。</param>
+		/// <param name="userDatas">用户自定义数据。</param>
+		public static SpawnHandle SpawnSync(string location, Transform parent, bool forceClone = false, params System.Object[] userDatas)
+		{
+			return DefaultSpawner.SpawnAsync(location, parent, forceClone, userDatas);
+		}
+
+		/// <summary>
+		/// 同步实例化一个游戏对象。
+		/// </summary>
+		/// <param name="location">资源定位地址。</param>
+		/// <param name="parent">父物体。</param>
+		/// <param name="position">世界坐标。</param>
+		/// <param name="rotation">世界角度。</param>
+		/// <param name="forceClone">强制克隆游戏对象，忽略缓存池里的对象。</param>
+		/// <param name="userDatas">用户自定义数据。</param>
+		public static SpawnHandle SpawnSync(string location, Transform parent, Vector3 position, Quaternion rotation, bool forceClone = false, params System.Object[] userDatas)
+		{
+			return DefaultSpawner.SpawnSync(location,parent,position,rotation,forceClone,userDatas);
+		}
+		#endregion
+	}
+}

Assets/TEngine/Runtime/GameFramework/Resource/Pool/ResourcePool.cs.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: be208ee3e46e4243b9a68d4c7212015e
+timeCreated: 1693831058

Assets/TEngine/Runtime/GameFramework/Resource/Pool/SpawnHandle.cs

@@ -0,0 +1,152 @@
+using UnityEngine;
+using YooAsset;
+
+namespace TEngine
+{
+    public sealed class SpawnHandle : GameAsyncOperation
+    {
+        private enum ESteps
+        {
+            None,
+            Waiting,
+            Done,
+        }
+
+        private readonly GameObjectPool _pool;
+        private InstantiateOperation _operation;
+        private readonly Transform _parent;
+        private readonly Vector3 _position;
+        private readonly Quaternion _rotation;
+        private ESteps _steps = ESteps.None;
+
+        /// <summary>
+        /// 实例化的游戏对象。
+        /// </summary>
+        public GameObject GameObj
+        {
+            get
+            {
+                if (_operation == null)
+                {
+                    Log.Warning("The spawn handle is invalid !");
+                    return null;
+                }
+
+                return _operation.Result;
+            }
+        }
+
+        /// <summary>
+        /// 用户自定义数据集。
+        /// </summary>
+        public System.Object[] UserDatas { private set; get; }
+
+        private SpawnHandle()
+        {
+        }
+
+        internal SpawnHandle(GameObjectPool pool, InstantiateOperation operation, Transform parent, Vector3 position, Quaternion rotation,
+            params System.Object[] userDatas)
+        {
+            _pool = pool;
+            _operation = operation;
+            _parent = parent;
+            _position = position;
+            _rotation = rotation;
+            UserDatas = userDatas;
+        }
+
+        protected override void OnStart()
+        {
+            _steps = ESteps.Waiting;
+        }
+
+        protected override void OnUpdate()
+        {
+            if (_steps == ESteps.None || _steps == ESteps.Done)
+                return;
+
+            if (_steps == ESteps.Waiting)
+            {
+                if (_operation.IsDone == false)
+                    return;
+
+                if (_operation.Status != EOperationStatus.Succeed)
+                {
+                    _steps = ESteps.Done;
+                    Status = EOperationStatus.Failed;
+                    Error = _operation.Error;
+                    return;
+                }
+
+                if (_operation.Result == null)
+                {
+                    _steps = ESteps.Done;
+                    Status = EOperationStatus.Failed;
+                    Error = $"Clone game object is null.";
+                    return;
+                }
+
+                // 设置参数	
+                _operation.Result.transform.SetParent(_parent);
+                _operation.Result.transform.SetPositionAndRotation(_position, _rotation);
+                _operation.Result.SetActive(true);
+
+                _steps = ESteps.Done;
+                Status = EOperationStatus.Succeed;
+            }
+        }
+
+        /// <summary>
+        /// 回收对象。
+        /// </summary>
+        public void Restore()
+        {
+            if (_operation != null)
+            {
+                ClearCompletedCallback();
+                CancelHandle();
+                _pool.Restore(_operation);
+                _operation = null;
+            }
+        }
+
+        /// <summary>
+        /// 丢弃对象。
+        /// </summary>
+        public void Discard()
+        {
+            if (_operation != null)
+            {
+                ClearCompletedCallback();
+                CancelHandle();
+                _pool.Discard(_operation);
+                _operation = null;
+            }
+        }
+
+        /// <summary>
+        /// 等待异步实例化结束。
+        /// </summary>
+        public void WaitForAsyncComplete()
+        {
+            if (_operation != null)
+            {
+                if (_steps == ESteps.Done)
+                    return;
+                _operation.WaitForAsyncComplete();
+                OnUpdate();
+            }
+        }
+
+        private void CancelHandle()
+        {
+            if (IsDone == false)
+            {
+                _steps = ESteps.Done;
+                Status = EOperationStatus.Failed;
+                Error = $"User cancelled !";
+            }
+        }
+    }
+}

Assets/TEngine/Runtime/GameFramework/Resource/Pool/SpawnHandle.cs.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: eb2cdce8eb814f7c92c74199d065688a
+timeCreated: 1693831296

Assets/TEngine/Runtime/GameFramework/Resource/Pool/Spawner.cs

@@ -0,0 +1,262 @@
+using System;
+using System.Collections;
+using System.Collections.Generic;
+using UnityEngine;
+using YooAsset;
+
+namespace TEngine
+{
+	/// <summary>
+	/// 对象生成器。
+	/// </summary>
+	public class Spawner
+	{
+		private readonly List<GameObjectPool> _gameObjectPools = new List<GameObjectPool>(100);
+		private readonly List<GameObjectPool> _removeList = new List<GameObjectPool>(100);
+		private readonly GameObject _spawnerRoot;
+		private readonly ResourcePackage _package;
+
+		public string PackageName
+		{
+			get
+			{
+				return _package.PackageName;
+			}
+		}
+
+
+		private Spawner()
+		{
+		}
+		internal Spawner(GameObject poolingRoot, ResourcePackage package)
+		{
+			_spawnerRoot = new GameObject($"{package.PackageName}");
+			_spawnerRoot.transform.SetParent(poolingRoot.transform);
+			_package = package;
+		}
+
+		/// <summary>
+		/// 更新游戏对象池系统。
+		/// </summary>
+		internal void Update()
+		{
+			_removeList.Clear();
+			foreach (var pool in _gameObjectPools)
+			{
+				if (pool.CanAutoDestroy())
+					_removeList.Add(pool);
+			}
+
+			foreach (var pool in _removeList)
+			{
+				_gameObjectPools.Remove(pool);
+				pool.DestroyPool();
+			}
+		}
+
+		/// <summary>
+		/// 销毁游戏对象池系统。
+		/// </summary>
+		internal void Destroy()
+		{
+			DestroyAll(true);
+		}
+
+		/// <summary>
+		/// 销毁所有对象池及其资源。
+		/// </summary>
+		/// <param name="includeAll">销毁所有对象池，包括常驻对象池。</param>
+		public void DestroyAll(bool includeAll)
+		{
+			if (includeAll)
+			{
+				foreach (var pool in _gameObjectPools)
+				{
+					pool.DestroyPool();
+				}
+				_gameObjectPools.Clear();
+			}
+			else
+			{
+				List<GameObjectPool> removeList = new List<GameObjectPool>();
+				foreach (var pool in _gameObjectPools)
+				{
+					if (pool.DontDestroy == false)
+						removeList.Add(pool);
+				}
+				foreach (var pool in removeList)
+				{
+					_gameObjectPools.Remove(pool);
+					pool.DestroyPool();
+				}
+			}
+		}
+
+
+		/// <summary>
+		/// 异步创建指定资源的游戏对象池。
+		/// </summary>
+		/// <param name="location">资源定位地址。</param>
+		/// <param name="dontDestroy">资源常驻不销毁。</param>
+		/// <param name="initCapacity">对象池的初始容量。</param>
+		/// <param name="maxCapacity">对象池的最大容量。</param>
+		/// <param name="destroyTime">静默销毁时间（注意：小于零代表不主动销毁）。</param>
+		public CreatePoolOperation CreateGameObjectPoolAsync(string location, bool dontDestroy = false, int initCapacity = 0, int maxCapacity = int.MaxValue, float destroyTime = -1f)
+		{
+			return CreateGameObjectPoolInternal(location, dontDestroy, initCapacity, maxCapacity, destroyTime);
+		}
+
+		/// <summary>
+		/// 同步创建指定资源的游戏对象池。
+		/// </summary>
+		/// <param name="location">资源定位地址。</param>
+		/// <param name="dontDestroy">资源常驻不销毁。</param>
+		/// <param name="initCapacity">对象池的初始容量。</param>
+		/// <param name="maxCapacity">对象池的最大容量。</param>
+		/// <param name="destroyTime">静默销毁时间（注意：小于零代表不主动销毁）。</param>
+		public CreatePoolOperation CreateGameObjectPoolSync(string location, bool dontDestroy = false, int initCapacity = 0, int maxCapacity = int.MaxValue, float destroyTime = -1f)
+		{
+			var operation = CreateGameObjectPoolInternal(location, dontDestroy, initCapacity, maxCapacity, destroyTime);
+			operation.WaitForAsyncComplete();
+			return operation;
+		}
+
+		/// <summary>
+		/// 创建指定资源的游戏对象池。
+		/// </summary>
+		private CreatePoolOperation CreateGameObjectPoolInternal(string location, bool dontDestroy = false, int initCapacity = 0, int maxCapacity = int.MaxValue, float destroyTime = -1f)
+		{
+			if (maxCapacity < initCapacity)
+				throw new Exception("The max capacity value must be greater the init capacity value.");
+
+			GameObjectPool pool = TryGetGameObjectPool(location);
+			if (pool != null)
+			{
+				Log.Warning($"GameObject pool is already existed : {location}");
+				var operation = new CreatePoolOperation(pool.AssetHandle);
+				YooAssets.StartOperation(operation);
+				return operation;
+			}
+			else
+			{
+				pool = new GameObjectPool(_spawnerRoot, location, dontDestroy, initCapacity, maxCapacity, destroyTime);
+				pool.CreatePool(_package);
+				_gameObjectPools.Add(pool);
+
+				var operation = new CreatePoolOperation(pool.AssetHandle);
+				YooAssets.StartOperation(operation);
+				return operation;
+			}
+		}
+
+
+		/// <summary>
+		/// 异步实例化一个游戏对象。
+		/// </summary>
+		/// <param name="location">资源定位地址。</param>
+		/// <param name="forceClone">强制克隆游戏对象，忽略缓存池里的对象。</param>
+		/// <param name="userDatas">用户自定义数据。</param>
+		public SpawnHandle SpawnAsync(string location, bool forceClone = false, params System.Object[] userDatas)
+		{
+			return SpawnInternal(location, null, Vector3.zero, Quaternion.identity, forceClone, userDatas);
+		}
+
+		/// <summary>
+		/// 异步实例化一个游戏对象。
+		/// </summary>
+		/// <param name="location">资源定位地址。</param>
+		/// <param name="parent">父物体。</param>
+		/// <param name="forceClone">强制克隆游戏对象，忽略缓存池里的对象。</param>
+		/// <param name="userDatas">用户自定义数据。</param>
+		public SpawnHandle SpawnAsync(string location, Transform parent, bool forceClone = false, params System.Object[] userDatas)
+		{
+			return SpawnInternal(location, parent, Vector3.zero, Quaternion.identity, forceClone, userDatas);
+		}
+
+		/// <summary>
+		/// 异步实例化一个游戏对象。
+		/// </summary>
+		/// <param name="location">资源定位地址。</param>
+		/// <param name="parent">父物体。</param>
+		/// <param name="position">世界坐标。</param>
+		/// <param name="rotation">世界角度。</param>
+		/// <param name="forceClone">强制克隆游戏对象，忽略缓存池里的对象。</param>
+		/// <param name="userDatas">用户自定义数据。</param>
+		public SpawnHandle SpawnAsync(string location, Transform parent, Vector3 position, Quaternion rotation, bool forceClone = false, params System.Object[] userDatas)
+		{
+			return SpawnInternal(location, parent, position, rotation, forceClone, userDatas);
+		}
+
+		/// <summary>
+		/// 同步实例化一个游戏对象。
+		/// </summary>
+		/// <param name="location">资源定位地址。</param>
+		/// <param name="forceClone">强制克隆游戏对象，忽略缓存池里的对象。</param>
+		/// <param name="userDatas">用户自定义数据。</param>
+		public SpawnHandle SpawnSync(string location, bool forceClone = false, params System.Object[] userDatas)
+		{
+			SpawnHandle handle = SpawnInternal(location, null, Vector3.zero, Quaternion.identity, forceClone, userDatas);
+			handle.WaitForAsyncComplete();
+			return handle;
+		}
+
+		/// <summary>
+		/// 同步实例化一个游戏对象。
+		/// </summary>
+		/// <param name="location">资源定位地址。</param>
+		/// <param name="parent">父物体</param>
+		/// <param name="forceClone">强制克隆游戏对象，忽略缓存池里的对象。</param>
+		/// <param name="userDatas">用户自定义数据。</param>
+		public SpawnHandle SpawnSync(string location, Transform parent, bool forceClone = false, params System.Object[] userDatas)
+		{
+			SpawnHandle handle = SpawnInternal(location, parent, Vector3.zero, Quaternion.identity, forceClone, userDatas);
+			handle.WaitForAsyncComplete();
+			return handle;
+		}
+
+		/// <summary>
+		/// 同步实例化一个游戏对象。
+		/// </summary>
+		/// <param name="location">资源定位地址。</param>
+		/// <param name="parent">父物体。</param>
+		/// <param name="position">世界坐标。</param>
+		/// <param name="rotation">世界角度。</param>
+		/// <param name="forceClone">强制克隆游戏对象，忽略缓存池里的对象。</param>
+		/// <param name="userDatas">用户自定义数据。</param>
+		public SpawnHandle SpawnSync(string location, Transform parent, Vector3 position, Quaternion rotation, bool forceClone = false, params System.Object[] userDatas)
+		{
+			SpawnHandle handle = SpawnInternal(location, parent, position, rotation, forceClone, userDatas);
+			handle.WaitForAsyncComplete();
+			return handle;
+		}
+
+		/// <summary>
+		/// 实例化一个游戏对象。
+		/// </summary>
+		private SpawnHandle SpawnInternal(string location, Transform parent, Vector3 position, Quaternion rotation, bool forceClone, params System.Object[] userDatas)
+		{
+			var pool = TryGetGameObjectPool(location);
+			if (pool != null)
+			{
+				return pool.Spawn(parent, position, rotation, forceClone, userDatas);
+			}
+
+			// 如果不存在创建游戏对象池
+			pool = new GameObjectPool(_spawnerRoot, location, false, 0, int.MaxValue, -1f);
+			pool.CreatePool(_package);
+			_gameObjectPools.Add(pool);
+			return pool.Spawn(parent, position, rotation, forceClone, userDatas);
+		}
+
+
+		private GameObjectPool TryGetGameObjectPool(string location)
+		{
+			foreach (var pool in _gameObjectPools)
+			{
+				if (pool.Location == location)
+					return pool;
+			}
+			return null;
+		}
+	}
+}

Assets/TEngine/Runtime/GameFramework/Resource/Pool/Spawner.cs.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: 570ac9abe8a04e77b49c42719a9fa93b
+timeCreated: 1693831272

Assets/TEngine/Runtime/GameFramework/Resource/ResourceManager.cs

@@ -9,9 +9,10 @@ namespace TEngine
     /// <summary>
     /// 资源管理器。
     /// </summary>
-    internal partial class ResourceManager: GameFrameworkModule,IResourceManager
+    internal partial class ResourceManager : GameFrameworkModule, IResourceManager
     {
         #region Propreties
+
         /// <summary>
         /// 资源包名称。
         /// </summary>
@@ -21,21 +22,21 @@ namespace TEngine
         /// 获取当前资源适用的游戏版本号。
         /// </summary>
         public string ApplicableGameVersion => m_ApplicableGameVersion;
-        
+
         private string m_ApplicableGameVersion;
 
         /// <summary>
         /// 获取当前内部资源版本号。
         /// </summary>
         public int InternalResourceVersion => m_InternalResourceVersion;
-        
+
         private int m_InternalResourceVersion;
-        
+
         /// <summary>
         /// 同时下载的最大数目。
         /// </summary>
         public int DownloadingMaxNum { get; set; }
-        
+
         /// <summary>
         /// 失败重试最大数目。
         /// </summary>
@@ -45,50 +46,56 @@ namespace TEngine
         /// 获取资源只读区路径。
         /// </summary>
         public string ReadOnlyPath => m_ReadOnlyPath;
-        
+
         private string m_ReadOnlyPath;
 
         /// <summary>
         /// 获取资源读写区路径。
         /// </summary>
         public string ReadWritePath => m_ReadWritePath;
-        
+
         private string m_ReadWritePath;
-        
+
         /// <summary>
         /// 资源系统运行模式。
         /// </summary>
         public EPlayMode PlayMode { get; set; }
-        
+
         /// <summary>
         /// 下载文件校验等级。
         /// </summary>
         public EVerifyLevel VerifyLevel { get; set; }
-        
+
         /// <summary>
         /// 设置异步系统参数，每帧执行消耗的最大时间切片（单位：毫秒）。
         /// </summary>
         public long Milliseconds { get; set; }
-        
+
         /// <summary>
         /// 获取游戏框架模块优先级。
         /// </summary>
         /// <remarks>优先级较高的模块会优先轮询，并且关闭操作会后进行。</remarks>
         internal override int Priority => 4;
+
         #endregion
 
         #region 生命周期
+
         internal override void Update(float elapseSeconds, float realElapseSeconds)
         {
+            ResourcePool.Update();
         }
 
         internal override void Shutdown()
         {
             YooAssets.Destroy();
+            ResourcePool.Destroy();
         }
+
         #endregion
 
         #region 设置接口
+
         /// <summary>
         /// 设置资源只读区路径。
         /// </summary>
@@ -116,6 +123,7 @@ namespace TEngine
 
             m_ReadWritePath = readWritePath;
         }
+
         #endregion
 
         public void Initialize()
@@ -133,6 +141,7 @@ namespace TEngine
                 defaultPackage = YooAssets.CreatePackage(packageName);
                 YooAssets.SetDefaultPackage(defaultPackage);
             }
+            ResourcePool.Initialize(GameModule.Resource.gameObject);
         }
 
         public InitializationOperation InitPackage()
@@ -154,7 +163,7 @@ namespace TEngine
             //运行时使用。
             EPlayMode playMode = PlayMode;
 #endif
-            
+
             // 编辑器下的模拟模式
             InitializationOperation initializationOperation = null;
             if (playMode == EPlayMode.EditorSimulateMode)
@@ -185,7 +194,7 @@ namespace TEngine
 
             return initializationOperation;
         }
-        
+
         public void UnloadAsset(object asset)
         {
             throw new System.NotImplementedException();
@@ -207,14 +216,14 @@ namespace TEngine
             {
                 throw new GameFrameworkException("Asset name is invalid.");
             }
-            
+
             AssetInfo assetInfo = YooAssets.GetAssetInfo(assetName);
-            
+
             if (!CheckLocationValid(assetName))
             {
                 return HasAssetResult.Valid;
             }
-            
+
             if (assetInfo == null)
             {
                 return HasAssetResult.NotExist;
@@ -296,6 +305,7 @@ namespace TEngine
         }
 
         #endregion
+
         /// <summary>
         /// 同步加载资源。
         /// </summary>
@@ -309,6 +319,7 @@ namespace TEngine
                 Log.Error("Asset name is invalid.");
                 return default;
             }
+
             AssetOperationHandle handle = YooAssets.LoadAssetSync<T>(assetName);
 
             if (typeof(T) == typeof(GameObject))
@@ -339,6 +350,7 @@ namespace TEngine
                 Log.Error("Asset name is invalid.");
                 return default;
             }
+
             AssetOperationHandle handle = YooAssets.LoadAssetSync<T>(assetName);
 
             if (typeof(T) == typeof(GameObject))
@@ -362,7 +374,7 @@ namespace TEngine
         /// <param name="assetName">要加载资源的名称。</param>
         /// <typeparam name="T">要加载资源的类型。</typeparam>
         /// <returns>资源实例。</returns>
-        public T LoadAsset<T>(string assetName,out AssetOperationHandle handle) where T : Object
+        public T LoadAsset<T>(string assetName, out AssetOperationHandle handle) where T : Object
         {
             handle = YooAssets.LoadAssetSync<T>(assetName);
 
@@ -391,7 +403,7 @@ namespace TEngine
         /// <param name="parent">父节点位置。</param>
         /// <typeparam name="T">要加载资源的类型。</typeparam>
         /// <returns>资源实例。</returns>
-        public T LoadAsset<T>(string assetName, Transform parent,out AssetOperationHandle handle) where T : Object
+        public T LoadAsset<T>(string assetName, Transform parent, out AssetOperationHandle handle) where T : Object
         {
             handle = YooAssets.LoadAssetSync<T>(assetName);
 
@@ -453,7 +465,7 @@ namespace TEngine
         {
             return YooAssets.LoadSubAssetsAsync<TObject>(location: location);
         }
-        
+
         /// <summary>
         /// 同步加载子资源对象
         /// </summary>
@@ -471,9 +483,10 @@ namespace TEngine
         /// <param name="activateOnLoad">加载完毕时是否主动激活</param>
         /// <param name="priority">优先级</param>
         /// <returns>异步加载场景句柄。</returns>
-        public SceneOperationHandle LoadSceneAsync(string location, LoadSceneMode sceneMode = LoadSceneMode.Single, bool activateOnLoad = true, int priority = 100)
+        public SceneOperationHandle LoadSceneAsync(string location, LoadSceneMode sceneMode = LoadSceneMode.Single, bool activateOnLoad = true,
+            int priority = 100)
         {
-            return YooAssets.LoadSceneAsync(location,sceneMode,activateOnLoad,priority);
+            return YooAssets.LoadSceneAsync(location, sceneMode, activateOnLoad, priority);
         }
 
         /// <summary>
@@ -484,12 +497,13 @@ namespace TEngine
         /// <param name="activateOnLoad">加载完毕时是否主动激活</param>
         /// <param name="priority">优先级</param>
         /// <returns>异步加载场景句柄。</returns>
-        public SceneOperationHandle LoadSceneAsync(AssetInfo assetInfo, LoadSceneMode sceneMode = LoadSceneMode.Single, bool activateOnLoad = true, int priority = 100)
+        public SceneOperationHandle LoadSceneAsync(AssetInfo assetInfo, LoadSceneMode sceneMode = LoadSceneMode.Single, bool activateOnLoad = true,
+            int priority = 100)
         {
-            return YooAssets.LoadSceneAsync(assetInfo,sceneMode,activateOnLoad,priority);
+            return YooAssets.LoadSceneAsync(assetInfo, sceneMode, activateOnLoad, priority);
         }
-        
-        
+
+
         /// <summary>
         /// 异步加载资源实例。
         /// </summary>
@@ -499,20 +513,20 @@ namespace TEngine
         public async UniTask<T> LoadAssetAsync<T>(string assetName, CancellationToken cancellationToken) where T : Object
         {
             AssetOperationHandle handle = LoadAssetAsyncHandle<T>(assetName);
-            
+
             bool cancelOrFailed = await handle.ToUniTask().AttachExternalCancellation(cancellationToken).SuppressCancellationThrow();
 
             if (cancelOrFailed)
             {
                 return null;
             }
-            
+
             if (typeof(T) == typeof(GameObject))
             {
                 GameObject ret = handle.InstantiateSync();
-                
+
                 AssetReference.BindAssetReference(ret, handle, assetName);
-                
+
                 return ret as T;
             }
             else
@@ -530,7 +544,7 @@ namespace TEngine
         public async UniTask<GameObject> LoadGameObjectAsync(string assetName, CancellationToken cancellationToken)
         {
             AssetOperationHandle handle = LoadAssetAsyncHandle<GameObject>(assetName);
-            
+
             bool cancelOrFailed = await handle.ToUniTask().AttachExternalCancellation(cancellationToken).SuppressCancellationThrow();
 
             if (cancelOrFailed)
@@ -539,12 +553,12 @@ namespace TEngine
             }
 
             GameObject ret = handle.InstantiateSync();
-            
+
             AssetReference.BindAssetReference(ret, handle, assetName);
-            
+
             return ret;
         }
-        
+
         /// <summary>
         /// 异步加载游戏物体。
         /// </summary>
@@ -554,7 +568,7 @@ namespace TEngine
         /// <returns>异步游戏物体实例。</returns>
         public async UniTask<GameObject> LoadGameObjectAsync(string location, Transform parent, CancellationToken cancellationToken)
         {
-            GameObject gameObject = await LoadGameObjectAsync(location,cancellationToken);
+            GameObject gameObject = await LoadGameObjectAsync(location, cancellationToken);
             if (parent != null)
             {
                 gameObject.transform.SetParent(parent);
@@ -563,6 +577,7 @@ namespace TEngine
             {
                 Log.Error("Set Parent Failed");
             }
+
             return gameObject;
         }
 
@@ -575,11 +590,11 @@ namespace TEngine
         public async UniTask<RawFileOperationHandle> LoadRawAssetAsync(string location, CancellationToken cancellationToken)
         {
             RawFileOperationHandle handle = YooAssets.LoadRawFileAsync(location);
-            
+
             bool cancelOrFailed = await handle.ToUniTask().AttachExternalCancellation(cancellationToken).SuppressCancellationThrow();
 
             handle.Dispose();
-            
+
             return cancelOrFailed ? null : handle;
         }
 
@@ -591,7 +606,7 @@ namespace TEngine
         /// <param name="cancellationToken">取消操作Token。</param>
         /// <typeparam name="T">资源实例类型。</typeparam>
         /// <returns>原生文件资源实例。</returns>
-        public async UniTask<T> LoadSubAssetAsync<T>(string location,string assetName, CancellationToken cancellationToken) where T : Object
+        public async UniTask<T> LoadSubAssetAsync<T>(string location, string assetName, CancellationToken cancellationToken) where T : Object
         {
             var assetInfo = GetAssetInfo(location);
             if (assetInfo == null)
@@ -599,16 +614,16 @@ namespace TEngine
                 Log.Fatal($"AssetsInfo is null");
                 return null;
             }
-            
+
             SubAssetsOperationHandle handle = YooAssets.LoadSubAssetsAsync(assetInfo);
-            
+
             bool cancelOrFailed = await handle.ToUniTask().AttachExternalCancellation(cancellationToken).SuppressCancellationThrow();
 
             handle.Dispose();
-            
+
             return cancelOrFailed ? null : handle.GetSubAssetObject<T>(assetName);
         }
-        
+
         /// <summary>
         /// 异步加载子文件。
         /// </summary>
@@ -616,7 +631,7 @@ namespace TEngine
         /// <param name="cancellationToken">取消操作Token。</param>
         /// <typeparam name="T">资源实例类型。</typeparam>
         /// <returns>原生文件资源实例。</returns>
-        public async UniTask<T[]> LoadAllSubAssetAsync<T>(string location,CancellationToken cancellationToken) where T : Object
+        public async UniTask<T[]> LoadAllSubAssetAsync<T>(string location, CancellationToken cancellationToken) where T : Object
         {
             var assetInfo = GetAssetInfo(location);
             if (assetInfo == null)
@@ -624,13 +639,13 @@ namespace TEngine
                 Log.Fatal($"AssetsInfo is null");
                 return null;
             }
-            
+
             SubAssetsOperationHandle handle = YooAssets.LoadSubAssetsAsync(assetInfo);
-            
+
             bool cancelOrFailed = await handle.ToUniTask().AttachExternalCancellation(cancellationToken).SuppressCancellationThrow();
 
             handle.Dispose();
-            
+
             return cancelOrFailed ? null : handle.GetSubAssetObjects<T>();
         }
 
@@ -643,11 +658,12 @@ namespace TEngine
         /// <param name="activateOnLoad">加载完毕时是否主动激活.</param>
         /// <param name="priority">优先级.</param>
         /// <returns>场景资源实例。</returns>
-        public async UniTask<Scene> LoadSceneAsyncByUniTask(string location,CancellationToken cancellationToken,LoadSceneMode sceneMode = LoadSceneMode.Single,
+        public async UniTask<Scene> LoadSceneAsyncByUniTask(string location, CancellationToken cancellationToken,
+            LoadSceneMode sceneMode = LoadSceneMode.Single,
             bool activateOnLoad = true, int priority = 100)
         {
-            SceneOperationHandle handle = YooAssets.LoadSceneAsync(location,sceneMode,activateOnLoad,priority);
-            
+            SceneOperationHandle handle = YooAssets.LoadSceneAsync(location, sceneMode, activateOnLoad, priority);
+
             bool cancelOrFailed = await handle.ToUniTask().AttachExternalCancellation(cancellationToken).SuppressCancellationThrow();
 
             return cancelOrFailed ? default : handle.SceneObject;

Assets/TEngine/Runtime/GameFramework/Resource/ResourceModule.cs

@@ -100,7 +100,7 @@ namespace TEngine
         private bool m_PerformGCCollect = false;
         private float m_LastUnloadUnusedAssetsOperationElapseSeconds = 0f;
         private bool m_InitPackageByProcedure = true;
-        
+
         /// <summary>
         /// 全局取消操作Token。
         /// </summary>
@@ -262,7 +262,7 @@ namespace TEngine
         public UpdatePackageManifestOperation UpdatePackageManifestAsync(string packageVersion, bool autoSaveVersion = true, int timeout = 60)
         {
             var package = YooAssets.GetPackage(packageName);
-            return package.UpdatePackageManifestAsync(packageVersion,autoSaveVersion, timeout);
+            return package.UpdatePackageManifestAsync(packageVersion, autoSaveVersion, timeout);
         }
 
         /// <summary>
@@ -472,29 +472,6 @@ namespace TEngine
 
             handle.Completed += callback;
         }
-        
-        /// <summary>
-        /// 异步加载资源。
-        /// </summary>
-        /// <param name="assetName">要加载资源的名称。</param>
-        /// <param name="cancellationToken">取消操作Token。</param>
-        /// <typeparam name="T">要加载资源的类型。</typeparam>
-        /// <returns>异步资源实例。</returns>
-        public async UniTask<T> LoadAssetAsync<T>(string assetName, CancellationToken cancellationToken) where T : UnityEngine.Object
-        {
-            return await m_ResourceManager.LoadAssetAsync<T>(assetName, cancellationToken);
-        }
-
-        /// <summary>
-        /// 异步加载游戏物体。
-        /// </summary>
-        /// <param name="assetName">要加载的游戏物体名称。</param>
-        /// <param name="cancellationToken">取消操作Token。</param>
-        /// <returns>异步游戏物体实例。</returns>
-        public async UniTask<GameObject> LoadGameObjectAsync(string assetName, CancellationToken cancellationToken)
-        {
-            return await m_ResourceManager.LoadAssetAsync<GameObject>(assetName, cancellationToken);
-        }
 
         /// <summary>
         /// 同步加载资源并获取句柄。
@@ -517,8 +494,8 @@ namespace TEngine
         {
             return m_ResourceManager.LoadAssetAsyncHandle<T>(assetName);
         }
-        
-        
+
+
         /// <summary>
         /// 同步加载子资源对象
         /// </summary>
@@ -538,7 +515,7 @@ namespace TEngine
         {
             return m_ResourceManager.LoadSubAssetsAsync<TObject>(location: location);
         }
-        
+
         /// <summary>
         /// 同步加载子资源对象
         /// </summary>
@@ -551,6 +528,7 @@ namespace TEngine
                 Log.Fatal($"AssetsInfo is null");
                 return null;
             }
+
             return m_ResourceManager.LoadSubAssetsSync(assetInfo);
         }
 
@@ -562,7 +540,8 @@ namespace TEngine
         /// <param name="activateOnLoad">加载完毕时是否主动激活</param>
         /// <param name="priority">优先级</param>
         /// <returns>异步加载场景句柄。</returns>
-        public SceneOperationHandle LoadSceneAsync(string location, LoadSceneMode sceneMode = LoadSceneMode.Single, bool activateOnLoad = true, int priority = 100)
+        public SceneOperationHandle LoadSceneAsync(string location, LoadSceneMode sceneMode = LoadSceneMode.Single, bool activateOnLoad = true,
+            int priority = 100)
         {
             return m_ResourceManager.LoadSceneAsync(location, sceneMode, activateOnLoad, priority);
         }
@@ -575,9 +554,96 @@ namespace TEngine
         /// <param name="activateOnLoad">加载完毕时是否主动激活</param>
         /// <param name="priority">优先级</param>
         /// <returns>异步加载场景句柄。</returns>
-        public SceneOperationHandle LoadSceneAsync(AssetInfo assetInfo, LoadSceneMode sceneMode = LoadSceneMode.Single, bool activateOnLoad = true, int priority = 100)
+        public SceneOperationHandle LoadSceneAsync(AssetInfo assetInfo, LoadSceneMode sceneMode = LoadSceneMode.Single, bool activateOnLoad = true,
+            int priority = 100)
         {
             return m_ResourceManager.LoadSceneAsync(assetInfo, sceneMode, activateOnLoad, priority);
         }
+
+        /// <summary>
+        /// 异步加载资源。
+        /// </summary>
+        /// <param name="assetName">要加载资源的名称。</param>
+        /// <param name="cancellationToken">取消操作Token。</param>
+        /// <typeparam name="T">要加载资源的类型。</typeparam>
+        /// <returns>异步资源实例。</returns>
+        public async UniTask<T> LoadAssetAsync<T>(string assetName, CancellationToken cancellationToken) where T : UnityEngine.Object
+        {
+            return await m_ResourceManager.LoadAssetAsync<T>(assetName, cancellationToken);
+        }
+
+        /// <summary>
+        /// 异步加载游戏物体。
+        /// </summary>
+        /// <param name="assetName">要加载的游戏物体名称。</param>
+        /// <param name="cancellationToken">取消操作Token。</param>
+        /// <returns>异步游戏物体实例。</returns>
+        public async UniTask<GameObject> LoadGameObjectAsync(string assetName, CancellationToken cancellationToken)
+        {
+            return await m_ResourceManager.LoadGameObjectAsync(assetName, cancellationToken);
+        }
+
+        /// <summary>
+        /// 异步加载游戏物体。
+        /// </summary>
+        /// <param name="location">资源定位地址。</param>
+        /// <param name="parent">父节点位置。</param>
+        /// <param name="cancellationToken">取消操作Token。</param>
+        /// <returns>异步游戏物体实例。</returns>
+        public async UniTask<GameObject> LoadGameObjectAsync(string location, Transform parent, CancellationToken cancellationToken)
+        {
+            return await m_ResourceManager.LoadGameObjectAsync(location, parent, cancellationToken);
+        }
+
+        /// <summary>
+        /// 异步加载原生文件。
+        /// </summary>
+        /// <param name="location">资源定位地址。</param>
+        /// <param name="cancellationToken">取消操作Token。</param>
+        /// <returns>原生文件资源实例。</returns>
+        public async UniTask<RawFileOperationHandle> LoadRawAssetAsync(string location, CancellationToken cancellationToken)
+        {
+            return await m_ResourceManager.LoadRawAssetAsync(location, cancellationToken);
+        }
+
+        /// <summary>
+        /// 异步加载子文件。
+        /// </summary>
+        /// <param name="location">资源定位地址。</param>
+        /// <param name="assetName">资源名称。</param>
+        /// <param name="cancellationToken">取消操作Token。</param>
+        /// <typeparam name="T">资源实例类型。</typeparam>
+        /// <returns>原生文件资源实例。</returns>
+        public async UniTask<T> LoadSubAssetAsync<T>(string location, string assetName, CancellationToken cancellationToken) where T : UnityEngine.Object
+        {
+            return await m_ResourceManager.LoadSubAssetAsync<T>(location, assetName, cancellationToken);
+        }
+
+        /// <summary>
+        /// 异步加载所有子文件。
+        /// </summary>
+        /// <param name="location">资源定位地址。</param>
+        /// <param name="cancellationToken">取消操作Token。</param>
+        /// <typeparam name="T">资源实例类型。</typeparam>
+        /// <returns>原生文件资源实例。</returns>
+        public async UniTask<T[]> LoadAllSubAssetAsync<T>(string location, CancellationToken cancellationToken) where T : UnityEngine.Object
+        {
+            return await m_ResourceManager.LoadAllSubAssetAsync<T>(location, cancellationToken);
+        }
+
+        /// <summary>
+        /// 异步加载场景。
+        /// </summary>
+        /// <param name="location">场景的定位地址。</param>
+        /// <param name="cancellationToken">取消操作Token。</param>
+        /// <param name="sceneMode">场景加载模式。</param>
+        /// <param name="activateOnLoad">加载完毕时是否主动激活。</param>
+        /// <param name="priority">优先级。</param>
+        /// <returns>场景资源实例。</returns>
+        public async UniTask<Scene> LoadSceneAsyncByUniTask(string location, CancellationToken cancellationToken,
+            LoadSceneMode sceneMode = LoadSceneMode.Single, bool activateOnLoad = true, int priority = 100)
+        {
+            return await m_ResourceManager.LoadSceneAsyncByUniTask(location, cancellationToken, sceneMode, activateOnLoad, priority);
+        }
     }
 }

Assets/TEngine/Runtime/GameFramework/RootModule.cs

@@ -113,8 +113,6 @@ namespace TEngine
             BuglyManager.Instance.Init(Resources.Load<BuglyConfig>("BuglyConfig"));
 #endif
             
-            GameTime.StartFrame();
-
             InitTextHelper();
             InitVersionHelper();
             InitLogHelper();
@@ -141,7 +139,6 @@ namespace TEngine
 
         private void Update()
         {
-            GameTime.StartFrame();
             GameFrameworkModuleSystem.Update(Time.deltaTime, Time.unscaledDeltaTime);
         }
 

Assets/TEngine/Runtime/GameFramework/Setting/DefaultSettingSerializer.cs

@@ -5,7 +5,7 @@
     /// </summary>
     public sealed class DefaultSettingSerializer : GameFrameworkSerializer<DefaultSetting>
     {
-        private static readonly byte[] Header = new byte[] { (byte)'G', (byte)'F', (byte)'S' };
+        private static readonly byte[] Header = new byte[] { (byte)'T', (byte)'E', (byte)'S' };
 
         /// <summary>
         /// 初始化默认游戏配置序列化器的新实例。

Assets/TEngine/Runtime/Protobuf-net/protobuf-net.csproj.meta

@@ -1,7 +0,0 @@
-fileFormatVersion: 2
-guid: 3b9128b665b538746a11489aee369030
-DefaultImporter:
-  externalObjects: {}
-  userData: 
-  assetBundleName: 
-  assetBundleVariant: 

Assets/TEngine/Runtime/TEngine.Runtime.asmdef

@@ -41,6 +41,16 @@
             "name": "com.unity.modules.particlesystem",
             "expression": "",
             "define": "UNITASK_PARTICLESYSTEM_SUPPORT"
+        },
+        {
+            "name": "com.unity.textmeshpro",
+            "expression": "",
+            "define": "UNITASK_TEXTMESHPRO_SUPPORT"
+        },
+        {
+            "name": "com.demigiant.dotween",
+            "expression": "",
+            "define": "UNITASK_DOTWEEN_SUPPORT"
         }
     ],
     "noEngineReferences": false

Assets/TEngine/Runtime/UniTask/External/DOTween/DOTweenAsyncExtensions.cs

@@ -1,6 +1,6 @@
 // asmdef Version Defines, enabled when com.demigiant.dotween is imported.
 
-#if UNITASK_DOTWEEN_SUPPORT
+#if true || UNITASK_DOTWEEN_SUPPORT
 
 using Cysharp.Threading.Tasks.Internal;
 using DG.Tweening;

Assets/TEngine/Runtime/Utility/NewtonsoftJsonHelper.cs

@@ -0,0 +1,37 @@
+namespace TEngine
+{
+    public class NewtonsoftJsonHelper : Utility.Json.IJsonHelper
+    {
+        /// <summary>
+        /// 将对象序列化为 JSON 字符串。
+        /// </summary>
+        /// <param name="obj">要序列化的对象。</param>
+        /// <returns>序列化后的 JSON 字符串。</returns>
+        public string ToJson(object obj)
+        {
+            return Newtonsoft.Json.JsonConvert.SerializeObject(obj);
+        }
+
+        /// <summary>
+        /// 将 JSON 字符串反序列化为对象。
+        /// </summary>
+        /// <typeparam name="T">对象类型。</typeparam>
+        /// <param name="json">要反序列化的 JSON 字符串。</param>
+        /// <returns>反序列化后的对象。</returns>
+        public T ToObject<T>(string json)
+        {
+            return Newtonsoft.Json.JsonConvert.DeserializeObject<T>(json);
+        }
+
+        /// <summary>
+        /// 将 JSON 字符串反序列化为对象。
+        /// </summary>
+        /// <param name="objectType">对象类型。</param>
+        /// <param name="json">要反序列化的 JSON 字符串。</param>
+        /// <returns>反序列化后的对象。</returns>
+        public object ToObject(System.Type objectType, string json)
+        {
+            return Newtonsoft.Json.JsonConvert.DeserializeObject(json, objectType);
+        }
+    }
+}

Assets/TEngine/Runtime/Utility/NewtonsoftJsonHelper.cs.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: 38484765ede44acc840c664a828ca6ff
+timeCreated: 1687360419

DotNet/App/TEngineSettings.json

@@ -60,6 +60,10 @@
             "Value": "../../Client/Unity/Assets/Scripts/Hotfix/Generate/CustomExport/",
             "Comment": "客户端自定义导出代码文件夹位置"
         },
+        "SceneConfigPath": {
+            "Value": "../../../Config/Excel/Server/SceneConfig.xlsx",
+            "Comment": "SceneConfig.xlsx的位置"
+        },
         "CustomExportAssembly": {
             "Value": "Logic",
             "Comment": "自定义导出代码存放的程序集"

DotNet/Config/ProtoBuf/proto_csOuterMessage.proto

@@ -1,20 +0,0 @@
-syntax = "proto3";
-package TEngine.Network.Message;
-import "google/protobuf/struct.proto";
-
-
-message AccountInfo
-{
-	int64 UnitId  = 1;
-	int64 UserId = 2;
-	int64 CharaId = 3;
-	repeated int32 Ks = 4;
-	repeated int64 Vs = 5;
-}
-
-message ItemInfo
-{
-	int32 ItemGId = 1;
-	int32 ItemId = 2;
-	int32 Count = 3;
-}

DotNet/Logic/src/Config/Core/ByteBuf.cs

@@ -40,6 +40,7 @@ namespace Bright.Serialization
 
     public sealed class ByteBuf : ICloneable, IEquatable<ByteBuf>
     {
+#pragma warning disable CS8618
         public ByteBuf()
         {
             Bytes = Array.Empty<byte>();
@@ -76,6 +77,7 @@ namespace Bright.Serialization
         {
             return new ByteBuf(bytes, 0, bytes.Length);
         }
+#pragma warning restore CS8618
 
         public void Replace(byte[] bytes)
         {
@@ -1015,20 +1017,24 @@ namespace Bright.Serialization
             return ((long)((ulong)x >> 1) ^ ((x & 1) << 63));
         }
 
-        public void WriteString(string x)
+        public void WriteString(string? x)
         {
             var n = x != null ? Encoding.UTF8.GetByteCount(x) : 0;
             WriteSize(n);
             if (n > 0)
             {
                 EnsureWrite(n);
-                Encoding.UTF8.GetBytes(x, 0, x.Length, Bytes, WriterIndex);
+                if (x != null)
+                {
+                    Encoding.UTF8.GetBytes(x, 0, x.Length, this.Bytes, this.WriterIndex);
+                }
+
                 WriterIndex += n;
             }
         }
 
         // byte[], [start, end)
-        public static Func<byte[], int, int, string> StringCacheFinder { get; set; }
+        public static Func<byte[], int, int, string>? StringCacheFinder { get; set; }
 
         public string ReadString()
         {
@@ -1056,14 +1062,14 @@ namespace Bright.Serialization
             }
         }
 
-        public void WriteBytes(byte[] x)
+        public void WriteBytes(byte[]? x)
         {
             var n = x != null ? x.Length : 0;
             WriteSize(n);
             if (n > 0)
             {
                 EnsureWrite(n);
-                x.CopyTo(Bytes, WriterIndex);
+                x?.CopyTo(Bytes, WriterIndex);
                 WriterIndex += n;
             }
         }
@@ -1485,12 +1491,12 @@ namespace Bright.Serialization
             return string.Join(".", datas);
         }
 
-        public override bool Equals(object obj)
+        public override bool Equals(object? obj)
         {
             return (obj is ByteBuf other) && Equals(other);
         }
 
-        public bool Equals(ByteBuf other)
+        public bool Equals(ByteBuf? other)
         {
             if (other == null)
             {

DotNet/Logic/src/CustomExport/SceneTypeConfigToEnum.cs

@@ -1,48 +1,104 @@
 #if TENGINE_NET
 using System.Text;
 using TEngine.Core;
+using TEngine.Helper;
 
 namespace TEngine.Model;
 
+/// <summary>
+/// 将场景类型配置表转换为枚举和字典的自定义导出类。
+/// </summary>
 public sealed class SceneTypeConfigToEnum : ACustomExport
 {
+    /// <summary>
+    /// 执行自定义导出操作。
+    /// </summary>
     public override void Run()
     {
-        var serverSceneType = new HashSet<string>();
-        var instanceList = SceneConfigData.Instance.List;
-        
-        foreach (var sceneConfig in instanceList)
+        // 获取场景配置表的完整路径
+        using var excelPackage = ExcelHelper.LoadExcel(Define.SceneConfigPath);
+        var sceneType = new Dictionary<string, string>();
+        var sceneSubType = new Dictionary<string, string>();
+        // 获取场景类型配置工作表
+        var sceneTypeConfig = excelPackage.Workbook.Worksheets["SceneTypeConfig"];
+        // 遍历场景类型配置表的行
+        for (var row = 3; row <= sceneTypeConfig.Dimension.Rows; row++)
         {
-            serverSceneType.Add(sceneConfig.SceneType);
-        }
+            var sceneTypeId = sceneTypeConfig.GetCellValue(row, 1);
+            var sceneTypeStr = sceneTypeConfig.GetCellValue(row, 2);
 
-        if (serverSceneType.Count > 0)
+            if (string.IsNullOrEmpty(sceneTypeId) || string.IsNullOrEmpty(sceneTypeStr))
+            {
+                continue;
+            }
+
+            sceneType.Add(sceneTypeId, sceneTypeStr);
+        }
+        // 获取场景子类型配置工作表
+        var sceneSubTypeConfig = excelPackage.Workbook.Worksheets["SceneSubTypeConfig"];
+        // 遍历场景子类型配置表的行 
+        for (var row = 3; row <= sceneSubTypeConfig.Dimension.Rows; row++)
         {
-            Write(CustomExportType.Server, serverSceneType);
+            var sceneSubTypeId = sceneSubTypeConfig.GetCellValue(row, 1);
+            var sceneSubTypeStr = sceneSubTypeConfig.GetCellValue(row, 2);
+
+            if (string.IsNullOrEmpty(sceneSubTypeId) || string.IsNullOrEmpty(sceneSubTypeStr))
+            {
+                continue;
+            }
+
+            sceneSubType.Add(sceneSubTypeId, sceneSubTypeStr);
+        }
+        // 如果存在场景类型或场景子类型，执行导出操作
+        if (sceneType.Count > 0 || sceneSubType.Count > 0)
+        {
+            Write(CustomExportType.Server, sceneType, sceneSubType);
         }
     }
 
-    private void Write(CustomExportType customExportType, HashSet<string> sceneTypes)
+    private void Write(CustomExportType customExportType, Dictionary<string, string> sceneTypes, Dictionary<string, string> sceneSubType)
     {
-        var index = 0;
         var strBuilder = new StringBuilder();
         var dicBuilder = new StringBuilder();
 
+        // 添加命名空间和注释头部
         strBuilder.AppendLine("namespace TEngine\n{");
         strBuilder.AppendLine("\t// 生成器自动生成，请不要手动编辑。");
-        strBuilder.AppendLine("\tpublic class SceneType\n\t{");
-        dicBuilder.AppendLine("\n\t\tpublic static readonly Dictionary<string, int> SceneDic = new Dictionary<string, int>()\n\t\t{");
-        
-        foreach (var str in sceneTypes)
+        // 生成场景类型的静态类
+        strBuilder.AppendLine("\tpublic static class SceneType\n\t{");
+        dicBuilder.AppendLine("\n\t\tpublic static readonly Dictionary<string, int> SceneTypeDic = new Dictionary<string, int>()\n\t\t{");
+
+        // 遍历场景类型字典，生成场景类型的常量和字典项
+        foreach (var (sceneTypeId, sceneTypeStr) in sceneTypes)
         {
-            index++;
-            dicBuilder.AppendLine($"\t\t\t{{ \"{str}\", {index} }},");
-            strBuilder.AppendLine($"\t\tpublic const int {str} = {index};");
+            dicBuilder.AppendLine($"\t\t\t{{ \"{sceneTypeStr}\", {sceneTypeId} }},");
+            strBuilder.AppendLine($"\t\tpublic const int {sceneTypeStr} = {sceneTypeId};");
         }
 
+        // 添加场景类型字典尾部，合并到主字符串构建器中
+        dicBuilder.AppendLine("\t\t};");
+        strBuilder.Append(dicBuilder);
+        strBuilder.AppendLine("\t}\n");
+
+        // 生成场景子类型的静态类
+        strBuilder.AppendLine("\t// 生成器自动生成，请不要手动编辑。");
+        strBuilder.AppendLine("\tpublic static class SceneSubType\n\t{");
+        // 清空字典构建器，用于生成场景子类型的字典项
+        dicBuilder.Clear();
+        dicBuilder.AppendLine("\n\t\tpublic static readonly Dictionary<string, int> SceneSubTypeDic = new Dictionary<string, int>()\n\t\t{");
+        // 遍历场景子类型字典，生成场景子类型的常量和字典项
+        foreach (var (sceneSubTypeId, sceneSubTypeStr) in sceneSubType)
+        {
+            dicBuilder.AppendLine($"\t\t\t{{ \"{sceneSubTypeStr}\", {sceneSubTypeId} }},");
+            strBuilder.AppendLine($"\t\tpublic const int {sceneSubTypeStr} = {sceneSubTypeId};");
+        }
+
+        // 添加场景子类型字典尾部，合并到主字符串构建器中
         dicBuilder.AppendLine("\t\t};");
         strBuilder.Append(dicBuilder);
         strBuilder.AppendLine("\t}\n}");
+
+        // 调用外部方法将生成的代码写入文件
         Write("SceneType.cs", strBuilder.ToString(), customExportType);
     }
 }

DotNet/Logic/src/Generate/CustomExport/SceneType.cs

@@ -7,6 +7,7 @@ namespace TEngine
 		public const int Addressable = 2;
 		public const int Map = 3;
 		public const int Chat = 4;
+		public const int Center = 5;
 
 		public static readonly Dictionary<string, int> SceneTypeDic = new Dictionary<string, int>()
 		{
@@ -14,6 +15,7 @@ namespace TEngine
 			{ "Addressable", 2 },
 			{ "Map", 3 },
 			{ "Chat", 4 },
+			{ "Center", 5 },
 		};
 	}
 

Luban/Config/gen.bat

@@ -1,10 +0,0 @@
-set GEN_CLIENT=dotnet ..\Tools\Luban.ClientServer\Luban.ClientServer.dll
-
-%GEN_CLIENT% -j cfg --^
- -d Defines\__root__.xml ^
- --input_data_dir Datas ^
- --output_data_dir output_json ^
- --output_code_dir Gen ^
- --gen_types code_cs_unity_json,data_json ^
- -s all
-pause

Luban/Config/gen.sh

@@ -1,10 +0,0 @@
-#!/bin/zsh
-GEN_CLIENT=../Tools/Luban.ClientServer/Luban.ClientServer.dll
-
-dotnet ${GEN_CLIENT} -j cfg --\
- -d Defines/__root__.xml \
- --input_data_dir Datas \
- --output_data_dir output_json \
- --output_code_dir Gen \
- --gen_types code_cs_unity_json,data_json \
- -s all 

README.md

@@ -100,6 +100,3 @@ Assets
 #### <a href="https://github.com/focus-creative-games/hybridclr"><strong>HybridCLR</strong></a> - 特性完整、零成本、高性能、低内存的近乎完美的Unity全平台原生c#热更方案
 
 #### <a href="https://github.com/qq362946/Fantasy"><strong>Fantasy</strong></a> - Fantasy是一套源于ETServer但极为简洁，性能更强，更好上手的一套商业级服务器框架。
-
-## <strong>交流群
-### <a href="http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=MzOcQIzGVLQ5AC5LHaqqA3h_F6lZ_DX4&authKey=LctqAWGHkJ7voQvuj1oaSe5tsGrc1XmQG3U4QniieGUlxY3lC7FtDIpEvPOX0vT8&noverify=0&group_code=862987645">群   号：862987645 </strong></a>