- 引入 UnityGameFramework

- 使用 Luban 替代原来的 UGF 的数据表
2026-08-30 18:08:55 +08:00
parent 42ad134759
commit 92bf3e9097
1925 changed files with 362268 additions and 4859 deletions
@@ -0,0 +1,9 @@
+fileFormatVersion: 2
+guid: 33ba0562010e2da46883baefb271f573
+folderAsset: yes
+timeCreated: 1528026146
+licenseType: Pro
+DefaultImporter:
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
@@ -0,0 +1,54 @@
+using SepCore.Definition;
+using SepCore.UI;
+using UnityEngine;
+using UnityEngine.Serialization;
+using UnityGameFramework.Runtime;
+
+namespace SepCore.CustomComponent
+{
+    public class BuiltinDataComponent : GameFrameworkComponent
+    {
+        [FormerlySerializedAs("m_BuildInfoTextAsset")] [SerializeField] private TextAsset _buildInfoTextAsset = null;
+
+        [FormerlySerializedAs("m_DefaultDictionaryTextAsset")] [SerializeField] private TextAsset _defaultDictionaryTextAsset = null;
+
+        [FormerlySerializedAs("m_UpdateResourceFormTemplate")] [SerializeField] private GameObject _updateResourceFormTemplate = null;
+
+        private BuildInfo _buildInfo = null;
+
+        public BuildInfo BuildInfo => _buildInfo;
+
+        public GameObject UpdateResourceFormTemplate => _updateResourceFormTemplate;
+
+        public void InitBuildInfo()
+        {
+            if (_buildInfoTextAsset == null || string.IsNullOrEmpty(_buildInfoTextAsset.text))
+            {
+                Log.Info("Build info can not be found or empty.");
+                return;
+            }
+
+            _buildInfo = GameFramework.Utility.Json.ToObject<BuildInfo>(_buildInfoTextAsset.text);
+            if (_buildInfo == null)
+            {
+                Log.Warning("Parse build info failure.");
+                return;
+            }
+        }
+
+        public void InitDefaultDictionary()
+        {
+            if (_defaultDictionaryTextAsset == null || string.IsNullOrEmpty(_defaultDictionaryTextAsset.text))
+            {
+                Log.Info("Default dictionary can not be found or empty.");
+                return;
+            }
+
+            if (!GameEntry.Localization.ParseData(_defaultDictionaryTextAsset.text))
+            {
+                Log.Warning("Parse default dictionary failure.");
+                return;
+            }
+        }
+    }
+}
@@ -0,0 +1,12 @@
+fileFormatVersion: 2
+guid: cfb0b001fcb30fe45ac95ddb8c28ba57
+timeCreated: 1528026146
+licenseType: Pro
+MonoImporter:
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 0d03aa2b156c24d25a59994ee920721d
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
@@ -0,0 +1,211 @@
+using GameFramework.Resource;
+using System;
+using System.Collections.Generic;
+using Luban;
+using SepCore.Definition;
+using UnityEngine;
+using UnityGameFramework.Runtime;
+
+namespace SepCore.CustomComponent
+{
+    /// <summary>
+    /// Luban 数据表组件。
+    /// 生成的数据结构与枚举位于 Assets/GameMain/Scripts/Base/Gen。
+    /// 负责加载 Luban 导出的二进制数据表（.bytes）并构建 SepCore.Definition.Tables。
+    /// 注意：表名列表需与 SepCore.Definition.Tables 构造函数保持一致。
+    /// </summary>
+    public class LubanComponent : GameFrameworkComponent
+    {
+        private static readonly string[] TableNames = new string[]
+        {
+            "tbglobalconfig",
+            "tbrarityconfig",
+            "tbdifficultyconfig",
+            "tbcharacterconfig",
+            "tbbattleactionconfig",
+            "tbthreatlevelconfig",
+            "tbenemyconfig",
+            "tbenemypartyconfig",
+            "tbitemconfig",
+            "tbresourcepointconfig",
+            "tbenemydropconfig",
+            "tbentityconfig",
+            "tbmusicconfig",
+            "tbsceneconfig",
+            "tbsoundconfig",
+            "tbuiformconfig",
+            "tbuisoundconfig",
+        };
+
+        private sealed class TableAccessor
+        {
+            public Func<Tables, int, object> RowGetter;
+            public Func<Tables, object> ListGetter;
+        }
+
+        private static readonly Dictionary<Type, TableAccessor> TableAccessors =
+            new Dictionary<Type, TableAccessor>
+            {
+                { typeof(CharacterConfig), Accessor(tables => id => tables.TbCharacterConfig.GetOrDefault(id), tables => tables.TbCharacterConfig.DataList) },
+                { typeof(BattleActionConfig), Accessor(tables => id => tables.TbBattleActionConfig.GetOrDefault(id), tables => tables.TbBattleActionConfig.DataList) },
+                { typeof(ThreatLevelConfig), Accessor(tables => id => tables.TbThreatLevelConfig.GetOrDefault(id), tables => tables.TbThreatLevelConfig.DataList) },
+                { typeof(EnemyConfig), Accessor(tables => id => tables.TbEnemyConfig.GetOrDefault(id), tables => tables.TbEnemyConfig.DataList) },
+                { typeof(EnemyPartyConfig), Accessor(tables => id => tables.TbEnemyPartyConfig.GetOrDefault(id), tables => tables.TbEnemyPartyConfig.DataList) },
+                { typeof(ItemConfig), Accessor(tables => id => tables.TbItemConfig.GetOrDefault(id), tables => tables.TbItemConfig.DataList) },
+                { typeof(ResourcePointConfig), Accessor(tables => id => tables.TbResourcePointConfig.GetOrDefault(id), tables => tables.TbResourcePointConfig.DataList) },
+                { typeof(EnemyDropConfig), Accessor(tables => id => tables.TbEnemyDropConfig.GetOrDefault(id), tables => tables.TbEnemyDropConfig.DataList) },
+                { typeof(RarityConfig), Accessor(tables => id => tables.TbRarityConfig.GetOrDefault((Rarity)id), tables => tables.TbRarityConfig.DataList) },
+                { typeof(DifficultyConfig), Accessor(tables => id => tables.TbDifficultyConfig.GetOrDefault((DifficultyTier)id), tables => tables.TbDifficultyConfig.DataList) },
+                { typeof(EntityConfig), Accessor(tables => id => tables.TbEntityConfig.GetOrDefault(id), tables => tables.TbEntityConfig.DataList) },
+                { typeof(MusicConfig), Accessor(tables => id => tables.TbMusicConfig.GetOrDefault(id), tables => tables.TbMusicConfig.DataList) },
+                { typeof(SceneConfig), Accessor(tables => id => tables.TbSceneConfig.GetOrDefault(id), tables => tables.TbSceneConfig.DataList) },
+                { typeof(SoundConfig), Accessor(tables => id => tables.TbSoundConfig.GetOrDefault(id), tables => tables.TbSoundConfig.DataList) },
+                { typeof(UIFormConfig), Accessor(tables => id => tables.TbUIFormConfig.GetOrDefault(id), tables => tables.TbUIFormConfig.DataList) },
+                { typeof(UISoundConfig), Accessor(tables => id => tables.TbUISoundConfig.GetOrDefault(id), tables => tables.TbUISoundConfig.DataList) },
+            };
+
+        private static TableAccessor Accessor<TValue>(Func<Tables, Func<int, object>> rowGetterFactory,
+            Func<Tables, List<TValue>> listGetter) where TValue : BeanBase
+        {
+            return new TableAccessor
+            {
+                RowGetter = (tables, id) => rowGetterFactory(tables)(id),
+                ListGetter = tables => listGetter(tables)
+            };
+        }
+
+        private Dictionary<string, byte[]> _tableBytes = null;
+        private int _remainCount = 0;
+        private Action _onLoadSuccess = null;
+        private Action<string> _onLoadFailure = null;
+
+        /// <summary>
+        /// 获取 Luban 数据表管理器，加载完成后可用。
+        /// </summary>
+        public SepCore.Definition.Tables Tables { get; private set; }
+
+        /// <summary>
+        /// 获取数据表是否已加载完成。
+        /// </summary>
+        public bool IsReady => Tables != null;
+
+        /// <summary>
+        /// 按 id 获取数据行，未找到时返回 null。
+        /// </summary>
+        /// <typeparam name="T">数据行类型（对应生成的 xxxConfig 类）。</typeparam>
+        /// <param name="id">数据行主键。</param>
+        /// <returns>数据行，未找到时返回 null。</returns>
+        public T Get<T>(int id) where T : class
+        {
+            if (Tables == null)
+            {
+                throw new InvalidOperationException("Luban data tables are not loaded yet.");
+            }
+
+            TableAccessor accessor;
+            if (!TableAccessors.TryGetValue(typeof(T), out accessor))
+            {
+                throw new NotSupportedException("No table getter is registered for type '" + typeof(T).FullName + "'.");
+            }
+
+            return (T)accessor.RowGetter(Tables, id);
+        }
+
+        /// <summary>
+        /// 获取整个表的所有数据行。
+        /// </summary>
+        /// <typeparam name="T">数据行类型（对应生成的 xxxConfig 类）。</typeparam>
+        /// <returns>表内全部数据行，可安全遍历。</returns>
+        public IReadOnlyList<T> GetTable<T>() where T : class
+        {
+            if (Tables == null)
+            {
+                throw new InvalidOperationException("Luban data tables are not loaded yet.");
+            }
+
+            TableAccessor accessor;
+            if (!TableAccessors.TryGetValue(typeof(T), out accessor))
+            {
+                throw new NotSupportedException("No table getter is registered for type '" + typeof(T).FullName + "'.");
+            }
+
+            return (IReadOnlyList<T>)accessor.ListGetter(Tables);
+        }
+
+        /// <summary>
+        /// 异步加载所有数据表。
+        /// </summary>
+        /// <param name="onSuccess">加载成功回调。</param>
+        /// <param name="onFailure">加载失败回调，参数为错误信息。</param>
+        public void LoadTables(Action onSuccess, Action<string> onFailure)
+        {
+            if (IsReady)
+            {
+                onSuccess?.Invoke();
+                return;
+            }
+
+            _onLoadSuccess = onSuccess;
+            _onLoadFailure = onFailure;
+            _tableBytes = new Dictionary<string, byte[]>(TableNames.Length);
+            _remainCount = TableNames.Length;
+
+            foreach (string tableName in TableNames)
+            {
+                GameEntry.Resource.LoadAsset(GetTableAssetPath(tableName), Constant.AssetPriority.DataTableAsset,
+                    new LoadAssetCallbacks(OnLoadTableSuccess, OnLoadTableFailure), tableName);
+            }
+        }
+
+        private void OnLoadTableSuccess(string assetName, object asset, float duration, object userData)
+        {
+            string tableName = (string)userData;
+            TextAsset textAsset = asset as TextAsset;
+            if (textAsset == null)
+            {
+                OnLoadTableFailure(assetName, LoadResourceStatus.AssetError, "Table asset is invalid.", userData);
+                return;
+            }
+
+            _tableBytes[tableName] = textAsset.bytes;
+            if (--_remainCount > 0)
+            {
+                return;
+            }
+
+            try
+            {
+                Tables = new SepCore.Definition.Tables(name => new Luban.ByteBuf(_tableBytes[name]));
+                _tableBytes = null;
+                Log.Info("Load Luban data tables OK.");
+                Action onLoadSuccess = _onLoadSuccess;
+                _onLoadSuccess = null;
+                _onLoadFailure = null;
+                onLoadSuccess?.Invoke();
+            }
+            catch (Exception exception)
+            {
+                Log.Error("Build Luban data tables failure with exception '{0}'.", exception);
+                Action<string> onLoadFailure = _onLoadFailure;
+                _onLoadSuccess = null;
+                _onLoadFailure = null;
+                onLoadFailure?.Invoke(exception.ToString());
+            }
+        }
+
+        private void OnLoadTableFailure(string assetName, LoadResourceStatus status, string errorMessage, object userData)
+        {
+            Log.Error("Can not load data table '{0}' from '{1}' with error message '{2}'.", (string)userData, assetName,
+                errorMessage);
+            Action<string> onLoadFailure = _onLoadFailure;
+            _onLoadSuccess = null;
+            _onLoadFailure = null;
+            onLoadFailure?.Invoke(errorMessage);
+        }
+
+        private static string GetTableAssetPath(string tableName)
+        {
+            return GameFramework.Utility.Text.Format("Assets/GameMain/DataTables/{0}.bytes", tableName);
+        }
+    }
+}
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 7686ced148554a92ba9da1fd22a26d01
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: