實戰(zhàn)：AssetBundle熱更與腳本擴展)
1. 為什么要在Unity3D里自己造一個Mod系統(tǒng)做游戲開發(fā)這行尤其是獨立團隊或者小規(guī)模工作室遲早會碰到一個繞不開的問題玩家想要自定義內(nèi)容而你的代碼架構(gòu)從一開始就沒給這件事留口子。我最早接觸Mod系統(tǒng)是在一個沙盒建造類項目里當(dāng)時策劃跑過來問“能不能讓玩家自己加方塊貼圖”我第一反應(yīng)是“改AssetBundle就行”結(jié)果真動手才發(fā)現(xiàn)移動端的熱更新限制、資源加載路徑、腳本注入安全每一個都是坑。這個項目標(biāo)題說的是“簡單實現(xiàn)”但簡單不等于簡陋。我理解的“簡單”是架構(gòu)清晰、依賴少、PC和移動端都能跑而不是功能殘缺。所以這篇文章我會從零開始把一套可用的Mod系統(tǒng)拆開講透包括資源加載、配置解析、腳本擴展點設(shè)計以及移動端特有的權(quán)限和路徑問題。適合誰看如果你已經(jīng)會用Unity做基礎(chǔ)開發(fā)知道AssetBundle或者Addressables怎么用但沒系統(tǒng)做過Mod框架那這篇就是給你寫的。如果你是完全的新手建議先把Unity的資源加載流程摸一遍再回來不然有些細(xì)節(jié)會卡住。核心關(guān)鍵詞我先擺出來Unity3D Mod系統(tǒng)、移動端資源加載、AssetBundle熱更、腳本擴展、跨平臺路徑管理。這幾個詞會貫穿全文你可以在腦子里先有個印象。2. 整體架構(gòu)設(shè)計與技術(shù)選型思路2.1 為什么不用現(xiàn)成的Mod框架市面上確實有一些開源的Unity Mod方案比如基于Mono.Cecil的腳本注入、或者用Lua做熱更層。我試過其中兩三種最后都放棄了。原因很直接移動端對反射和動態(tài)代碼生成的限制越來越嚴(yán)IL2CPP模式下很多方案直接跑不起來。而且現(xiàn)成框架往往綁定了一套完整的資源管理邏輯你項目里已有的AssetBundle流程要硬塞進去改造成本比自研還高。所以我的選擇是資源層用AssetBundle配置層用JSON腳本層用接口反射注冊。這套組合在PC和移動端都能穩(wěn)定運行不依賴任何第三方熱更庫代碼量可控出問題也好排查。2.2 核心模塊劃分整個Mod系統(tǒng)我拆成四個模塊每個模塊職責(zé)單一方便單獨調(diào)試Mod發(fā)現(xiàn)與加載器掃描指定目錄識別Mod包結(jié)構(gòu)讀取清單文件。資源管理器負(fù)責(zé)從AssetBundle里加載預(yù)制體、貼圖、音頻等資源并處理依賴關(guān)系。配置解析器讀取JSON格式的Mod配置映射到游戲內(nèi)的數(shù)據(jù)對象。擴展點注冊中心提供接口讓Mod代碼掛載到游戲邏輯的特定節(jié)點上。這四個模塊之間的通信全部通過事件或者接口調(diào)用不直接互相引用內(nèi)部實現(xiàn)。這樣做的好處是你以后想換資源加載方式比如換成Addressables只需要改資源管理器其他模塊不動。2.3 跨平臺路徑策略PC和移動端最大的差異在文件路徑。PC上你可以隨便用Application.dataPath往上翻幾層移動端尤其是AndroidStreamingAssets是只讀的persistentDataPath才是可寫目錄。我的做法是public static string GetModRootPath() { #if UNITY_ANDROID !UNITY_EDITOR return Path.Combine(Application.persistentDataPath, Mods); #elif UNITY_IOS !UNITY_EDITOR return Path.Combine(Application.persistentDataPath, Mods); #else return Path.Combine(Application.dataPath, ../Mods); #endif }注意Android上如果Mod資源需要隨包發(fā)布得先放在StreamingAssets里首次啟動時拷貝到persistentDataPath。這個拷貝操作只需要做一次用版本號或者文件哈希做標(biāo)記。2.4 Mod包結(jié)構(gòu)約定為了讓加載器能統(tǒng)一處理我定了一個固定的目錄結(jié)構(gòu)Mods/ ModA/ mod.json resources.bundle preview.png ModB/ mod.json resources.bundlemod.json是必須的里面至少包含Mod名稱、版本、作者、入口程序集名稱如果有腳本。resources.bundle是AssetBundle文件里面打包了所有資源。preview.png可選用于在Mod列表里顯示縮略圖。這個結(jié)構(gòu)看起來簡單但實際用起來很穩(wěn)。我試過讓Mod支持多個AssetBundle文件結(jié)果依賴關(guān)系管理變得復(fù)雜后來統(tǒng)一成一個Bundle內(nèi)部靠AssetBundleManifest處理依賴省心很多。3. 核心細(xì)節(jié)解析與實操要點3.1 AssetBundle的打包策略打包這塊我踩過最大的坑是移動端和PC端的Bundle不能混用。Unity在打包AssetBundle時不同平臺的壓縮格式和序列化方式不一樣你拿PC上打的包放到Android上加載會直接報錯。所以我的構(gòu)建腳本里一定會根據(jù)當(dāng)前BuildTarget輸出到不同目錄[MenuItem(ModTools/Build Mod Bundles)] public static void BuildModBundles() { string outputPath Path.Combine(Application.dataPath, ../Mods/ModA); if (!Directory.Exists(outputPath)) Directory.CreateDirectory(outputPath); BuildPipeline.BuildAssetBundles(outputPath, BuildAssetBundleOptions.ChunkBasedCompression, EditorUserBuildSettings.activeBuildTarget); }ChunkBasedCompression是我推薦的壓縮方式它比LZMA解壓快比不壓縮體積小移動端加載時內(nèi)存占用也合理。LZ4HC壓縮率更高但解壓慢不適合頻繁加載的場景。實操心得打包時一定要把AssetBundleManifest也打進去加載資源前先讀Manifest拿到依賴列表再加載目標(biāo)Bundle。不然遇到共享貼圖或者共享Shader會出現(xiàn)資源丟失或者重復(fù)加載。3.2 資源加載的同步與異步選擇移動端上同步加載大Bundle會卡主線程表現(xiàn)就是游戲瞬間掉幀。我的原則是小于1MB的Bundle可以同步加載大于1MB的一律異步。異步加載用協(xié)程或者UniTask都可以我這邊為了不引入額外依賴用的是原生協(xié)程。IEnumerator LoadModBundleAsync(string bundlePath, ActionAssetBundle onComplete) { var request AssetBundle.LoadFromFileAsync(bundlePath); yield return request; if (request.assetBundle null) { Debug.LogError($加載Bundle失敗: {bundlePath}); onComplete?.Invoke(null); yield break; } onComplete?.Invoke(request.assetBundle); }加載完成后Bundle不要立刻Unload因為里面的資源可能還在場景里用著。我的做法是維護一個引用計數(shù)當(dāng)所有從該Bundle加載的資源都被釋放后再調(diào)用Unload(true)。3.3 配置文件的解析與容錯mod.json的解析看起來簡單但實際會遇到各種奇葩情況BOM頭、注釋、字段缺失、類型不對。我一開始用JsonUtility.FromJson結(jié)果發(fā)現(xiàn)它不支持字典和嵌套數(shù)組后來換成了輕量級的JSON解析庫自己寫了個包裝層。[Serializable] public class ModManifest { public string name; public string version; public string author; public string entryAssembly; public string[] dependencies; }解析的時候一定要做字段校驗比如name為空就跳過這個Modversion格式不對就記警告。我見過有玩家手動改mod.json把版本號寫成中文的如果不做容錯整個Mod列表加載都會崩。注意移動端讀取JSON文件時要用File.ReadAllText指定UTF-8編碼不然中文Mod名稱會亂碼。PC上默認(rèn)編碼可能是GBK所以統(tǒng)一指定編碼最保險。3.4 腳本擴展點的設(shè)計這是整個Mod系統(tǒng)里最敏感的部分。移動端IL2CPP模式下動態(tài)加載C#腳本基本不可行所以我的方案是Mod腳本必須提前編譯成DLL并且和游戲主程序集一起打包。也就是說Mod的代碼擴展能力在構(gòu)建時就確定了運行時只負(fù)責(zé)反射調(diào)用。具體做法是定義一個接口public interface IModExtension { string ModName { get; } void OnLoad(); void OnUnload(); void OnGameStart(); }Mod開發(fā)者實現(xiàn)這個接口編譯成DLL后放到Mod目錄。游戲啟動時用Assembly.LoadFrom加載DLL反射找到實現(xiàn)類創(chuàng)建實例并調(diào)用OnLoad。var assembly Assembly.LoadFrom(dllPath); var types assembly.GetTypes().Where(t typeof(IModExtension).IsAssignableFrom(t) !t.IsInterface); foreach (var type in types) { var instance Activator.CreateInstance(type) as IModExtension; instance?.OnLoad(); _loadedMods.Add(instance); }實操心得反射創(chuàng)建實例時如果Mod的構(gòu)造函數(shù)里有異常整個加載流程會中斷。所以一定要用try-catch包住每個Mod的加載過程一個Mod失敗不影響其他Mod。4. 完整實操流程與關(guān)鍵環(huán)節(jié)實現(xiàn)4.1 環(huán)境準(zhǔn)備與目錄搭建先在項目根目錄下建一個Mods文件夾和Assets同級。然后在Assets里建一個ModSystem文件夾放所有Mod系統(tǒng)相關(guān)的腳本。目錄結(jié)構(gòu)如下ProjectRoot/ Assets/ ModSystem/ ModLoader.cs ModResourceManager.cs ModConfigParser.cs ModExtensionRegistry.cs Mods/ ModA/ mod.json resources.bundlePC上Mods目錄直接可讀寫Android上需要把Mods放到StreamingAssets里首次啟動拷貝到persistentDataPath?？截愡壿嬑覍懗梢粋€靜態(tài)方法在游戲啟動時調(diào)用一次。4.2 Mod加載器的完整實現(xiàn)加載器的流程分四步掃描目錄、讀取清單、加載Bundle、注冊擴展。我把它寫成一個協(xié)程方便異步處理。public IEnumerator LoadAllMods() { string modRoot GetModRootPath(); if (!Directory.Exists(modRoot)) { Debug.LogWarning(Mod目錄不存在跳過加載); yield break; } string[] modDirs Directory.GetDirectories(modRoot); foreach (string dir in modDirs) { string manifestPath Path.Combine(dir, mod.json); if (!File.Exists(manifestPath)) continue; string json File.ReadAllText(manifestPath, Encoding.UTF8); ModManifest manifest null; try { manifest JsonUtility.FromJsonModManifest(json); } catch (Exception e) { Debug.LogError($解析mod.json失敗: {dir}, {e.Message}); continue; } if (string.IsNullOrEmpty(manifest.name)) { Debug.LogWarning($Mod名稱為空跳過: {dir}); continue; } string bundlePath Path.Combine(dir, resources.bundle); if (File.Exists(bundlePath)) { yield return LoadModBundleAsync(bundlePath, (bundle) { if (bundle ! null) { _loadedBundles[manifest.name] bundle; } }); } if (!string.IsNullOrEmpty(manifest.entryAssembly)) { string dllPath Path.Combine(dir, manifest.entryAssembly); if (File.Exists(dllPath)) { LoadModAssembly(dllPath, manifest.name); } } } }這段代碼里L(fēng)oadModBundleAsync是前面寫的異步加載方法LoadModAssembly負(fù)責(zé)反射加載DLL。每個Mod獨立處理互不影響。4.3 資源加載與實例化Bundle加載完后從里面取資源就很簡單了public GameObject InstantiateModPrefab(string modName, string prefabName) { if (!_loadedBundles.TryGetValue(modName, out AssetBundle bundle)) { Debug.LogError($Mod未加載: {modName}); return null; } GameObject prefab bundle.LoadAssetGameObject(prefabName); if (prefab null) { Debug.LogError($預(yù)制體不存在: {prefabName}); return null; } return Object.Instantiate(prefab); }這里有個細(xì)節(jié)LoadAsset的名字必須和打包時設(shè)置的名字一致。我建議在打包腳本里統(tǒng)一用文件名作為Asset名稱避免手動指定出錯。4.4 配置數(shù)據(jù)的映射與使用Mod配置里可能包含數(shù)值、顏色、路徑等數(shù)據(jù)。我一般定義一個通用的ModConfig類用字典存鍵值對然后由各個Mod自己解析。[Serializable] public class ModConfig { public string key; public string value; public string type; // int, float, string, color }游戲邏輯里需要讀取配置時通過ModConfigParser.GetValue(modName, key)獲取內(nèi)部做類型轉(zhuǎn)換和緩存。這樣Mod開發(fā)者只需要在mod.json里加配置項不用改代碼。4.5 擴展點的實際掛載擴展點注冊中心維護一個事件列表Mod在OnLoad時注冊自己的回調(diào)public static class ModExtensionRegistry { private static Dictionarystring, Action _events new Dictionarystring, Action(); public static void Register(string eventName, Action callback) { if (!_events.ContainsKey(eventName)) _events[eventName] callback; else _events[eventName] callback; } public static void Trigger(string eventName) { if (_events.TryGetValue(eventName, out var action)) action?.Invoke(); } }游戲主邏輯在關(guān)鍵節(jié)點調(diào)用Trigger比如OnGameStart、OnPlayerDeath、OnLevelLoaded。Mod開發(fā)者只需要在OnLoad里調(diào)用Register就能把自己的邏輯掛上去。注意事件回調(diào)里如果拋異常會中斷后續(xù)所有回調(diào)。所以Trigger內(nèi)部要用try-catch包住每個回調(diào)記錄日志但不中斷。5. 常見問題與排查技巧實錄5.1 Bundle加載失敗排查表現(xiàn)象可能原因排查方法加載返回null路徑錯誤打印完整路徑檢查文件是否存在加載報錯“無法讀取”平臺不匹配確認(rèn)Bundle是用當(dāng)前平臺打的資源加載為nullAsset名稱不對用bundle.GetAllAssetNames()打印所有名稱實例化后材質(zhì)丟失Shader未打包把Shader加入Bundle或使用Always Included Shaders移動端加載卡頓同步加載大Bundle改用異步加載或拆分Bundle這個表是我實際排查時總結(jié)的基本覆蓋了八成以上的問題。尤其是Shader丟失PC上編輯器里正常打包到移動端就變粉紅就是因為Shader沒進Bundle。5.2 反射加載DLL的常見異常移動端IL2CPP下Assembly.LoadFrom加載的DLL必須是提前編譯好的而且不能包含UnityEditor相關(guān)的代碼。我遇到過Mod開發(fā)者把編輯器腳本也打進DLL結(jié)果運行時直接崩。解決辦法是在Mod開發(fā)文檔里明確寫清楚只引用UnityEngine和游戲主程序集不要引用UnityEditor。另一個坑是DLL的.NET版本。Unity 2021之后默認(rèn)用.NET Standard 2.1如果Mod DLL是用.NET Framework 4.8編譯的可能加載失敗。統(tǒng)一用.NET Standard 2.1編譯最穩(wěn)。5.3 移動端權(quán)限與路徑問題Android 11之后persistentDataPath的訪問不需要額外權(quán)限但如果你想把Mod放到外部存儲比如/sdcard/就需要申請存儲權(quán)限。我的建議是不要碰外部存儲全部放在persistentDataPath里省去權(quán)限申請的麻煩。iOS上更嚴(yán)格persistentDataPath是沙盒內(nèi)的Mod只能通過應(yīng)用內(nèi)下載或者iTunes文件共享導(dǎo)入。如果要做Mod導(dǎo)入功能得額外寫文件選擇器邏輯這塊我暫時沒做因為大部分移動端Mod需求都是內(nèi)置的。5.4 性能優(yōu)化與內(nèi)存管理Mod系統(tǒng)跑起來后內(nèi)存占用是必須監(jiān)控的。我一般會在加載完所有Mod后調(diào)用Resources.UnloadUnusedAssets()清理一次。另外每個Bundle的引用計數(shù)要維護好不用的時候及時Unload(false)只卸載Bundle文件本身不銷毀已加載的資源。public void UnloadMod(string modName) { if (_loadedBundles.TryGetValue(modName, out AssetBundle bundle)) { bundle.Unload(false); _loadedBundles.Remove(modName); } }實操心得Unload(true)會銷毀所有從該Bundle加載的資源如果場景里還有對象在用會直接變missing。所以除非確定不用了否則一律用Unload(false)。5.5 Mod沖突與加載順序多個Mod可能修改同一個配置或者注冊同一個事件。我的處理方式是按Mod目錄名稱排序加載后加載的Mod覆蓋先加載的。同時在配置解析時如果發(fā)現(xiàn)同一個key被多個Mod定義記錄警告并采用最后一個。事件注冊則相反多個Mod注冊同一個事件時全部保留按注冊順序依次調(diào)用。這樣Mod之間可以協(xié)作比如一個Mod加UI另一個Mod加邏輯。6. 一些實戰(zhàn)中的個人體會這套Mod系統(tǒng)我在兩個項目里用過一個是PC端的建造游戲一個是移動端的休閑模擬。PC上基本沒遇到大問題移動端踩的坑主要集中在路徑和Shader上。后來我養(yǎng)成了一個習(xí)慣每次打包Mod Bundle后先在目標(biāo)平臺上跑一遍加載測試確認(rèn)沒問題再發(fā)布。這個步驟看起來多余但能省掉大量玩家反饋的排查時間。另外Mod系統(tǒng)的文檔比代碼更重要。我見過太多開發(fā)者包括我自己早期覺得“代碼寫好了就行”結(jié)果Mod開發(fā)者不知道怎么打包、怎么命名、怎么調(diào)試最后Mod生態(tài)根本起不來。所以如果你打算長期維護Mod功能一定要寫一份清晰的Mod開發(fā)指南把目錄結(jié)構(gòu)、配置格式、擴展點列表、常見錯誤都列出來。最后分享一個小技巧在游戲里加一個“Mod調(diào)試模式”開啟后可以在屏幕上顯示當(dāng)前加載的Mod列表、Bundle數(shù)量、內(nèi)存占用。這個功能在排查玩家反饋時特別有用玩家截個圖你就能定位問題不用反復(fù)問“你裝了什么Mod”。 Unity3D跨平臺Mod系統(tǒng)實戰(zhàn)：AssetBundle熱更與腳本擴展
1. 為什么要在Unity3D里自己造一個Mod系統(tǒng)做游戲開發(fā)這行尤其是獨立團隊或者小規(guī)模工作室遲早會碰到一個繞不開的問題玩家想要自定義內(nèi)容而你的代碼架構(gòu)從一開始就沒給這件事留口子。我最早接觸Mod系統(tǒng)是在一個沙盒建造類項目里當(dāng)時策劃跑過來問“能不能讓玩家自己加方塊貼圖”我第一反應(yīng)是“改AssetBundle就行”結(jié)果真動手才發(fā)現(xiàn)移動端的熱更新限制、資源加載路徑、腳本注入安全每一個都是坑。這個項目標(biāo)題說的是“簡單實現(xiàn)”但簡單不等于簡陋。我理解的“簡單”是架構(gòu)清晰、依賴少、PC和移動端都能跑而不是功能殘缺。所以這篇文章我會從零開始把一套可用的Mod系統(tǒng)拆開講透包括資源加載、配置解析、腳本擴展點設(shè)計以及移動端特有的權(quán)限和路徑問題。適合誰看如果你已經(jīng)會用Unity做基礎(chǔ)開發(fā)知道AssetBundle或者Addressables怎么用但沒系統(tǒng)做過Mod框架那這篇就是給你寫的。如果你是完全的新手建議先把Unity的資源加載流程摸一遍再回來不然有些細(xì)節(jié)會卡住。核心關(guān)鍵詞我先擺出來Unity3D Mod系統(tǒng)、移動端資源加載、AssetBundle熱更、腳本擴展、跨平臺路徑管理。這幾個詞會貫穿全文你可以在腦子里先有個印象。2. 整體架構(gòu)設(shè)計與技術(shù)選型思路2.1 為什么不用現(xiàn)成的Mod框架市面上確實有一些開源的Unity Mod方案比如基于Mono.Cecil的腳本注入、或者用Lua做熱更層。我試過其中兩三種最后都放棄了。原因很直接移動端對反射和動態(tài)代碼生成的限制越來越嚴(yán)IL2CPP模式下很多方案直接跑不起來。而且現(xiàn)成框架往往綁定了一套完整的資源管理邏輯你項目里已有的AssetBundle流程要硬塞進去改造成本比自研還高。所以我的選擇是資源層用AssetBundle配置層用JSON腳本層用接口反射注冊。這套組合在PC和移動端都能穩(wěn)定運行不依賴任何第三方熱更庫代碼量可控出問題也好排查。2.2 核心模塊劃分整個Mod系統(tǒng)我拆成四個模塊每個模塊職責(zé)單一方便單獨調(diào)試Mod發(fā)現(xiàn)與加載器掃描指定目錄識別Mod包結(jié)構(gòu)讀取清單文件。資源管理器負(fù)責(zé)從AssetBundle里加載預(yù)制體、貼圖、音頻等資源并處理依賴關(guān)系。配置解析器讀取JSON格式的Mod配置映射到游戲內(nèi)的數(shù)據(jù)對象。擴展點注冊中心提供接口讓Mod代碼掛載到游戲邏輯的特定節(jié)點上。這四個模塊之間的通信全部通過事件或者接口調(diào)用不直接互相引用內(nèi)部實現(xiàn)。這樣做的好處是你以后想換資源加載方式比如換成Addressables只需要改資源管理器其他模塊不動。2.3 跨平臺路徑策略PC和移動端最大的差異在文件路徑。PC上你可以隨便用Application.dataPath往上翻幾層移動端尤其是AndroidStreamingAssets是只讀的persistentDataPath才是可寫目錄。我的做法是public static string GetModRootPath() { #if UNITY_ANDROID !UNITY_EDITOR return Path.Combine(Application.persistentDataPath, Mods); #elif UNITY_IOS !UNITY_EDITOR return Path.Combine(Application.persistentDataPath, Mods); #else return Path.Combine(Application.dataPath, ../Mods); #endif }注意Android上如果Mod資源需要隨包發(fā)布得先放在StreamingAssets里首次啟動時拷貝到persistentDataPath。這個拷貝操作只需要做一次用版本號或者文件哈希做標(biāo)記。2.4 Mod包結(jié)構(gòu)約定為了讓加載器能統(tǒng)一處理我定了一個固定的目錄結(jié)構(gòu)Mods/ ModA/ mod.json resources.bundle preview.png ModB/ mod.json resources.bundlemod.json是必須的里面至少包含Mod名稱、版本、作者、入口程序集名稱如果有腳本。resources.bundle是AssetBundle文件里面打包了所有資源。preview.png可選用于在Mod列表里顯示縮略圖。這個結(jié)構(gòu)看起來簡單但實際用起來很穩(wěn)。我試過讓Mod支持多個AssetBundle文件結(jié)果依賴關(guān)系管理變得復(fù)雜后來統(tǒng)一成一個Bundle內(nèi)部靠AssetBundleManifest處理依賴省心很多。3. 核心細(xì)節(jié)解析與實操要點3.1 AssetBundle的打包策略打包這塊我踩過最大的坑是移動端和PC端的Bundle不能混用。Unity在打包AssetBundle時不同平臺的壓縮格式和序列化方式不一樣你拿PC上打的包放到Android上加載會直接報錯。所以我的構(gòu)建腳本里一定會根據(jù)當(dāng)前BuildTarget輸出到不同目錄[MenuItem(ModTools/Build Mod Bundles)] public static void BuildModBundles() { string outputPath Path.Combine(Application.dataPath, ../Mods/ModA); if (!Directory.Exists(outputPath)) Directory.CreateDirectory(outputPath); BuildPipeline.BuildAssetBundles(outputPath, BuildAssetBundleOptions.ChunkBasedCompression, EditorUserBuildSettings.activeBuildTarget); }ChunkBasedCompression是我推薦的壓縮方式它比LZMA解壓快比不壓縮體積小移動端加載時內(nèi)存占用也合理。LZ4HC壓縮率更高但解壓慢不適合頻繁加載的場景。實操心得打包時一定要把AssetBundleManifest也打進去加載資源前先讀Manifest拿到依賴列表再加載目標(biāo)Bundle。不然遇到共享貼圖或者共享Shader會出現(xiàn)資源丟失或者重復(fù)加載。3.2 資源加載的同步與異步選擇移動端上同步加載大Bundle會卡主線程表現(xiàn)就是游戲瞬間掉幀。我的原則是小于1MB的Bundle可以同步加載大于1MB的一律異步。異步加載用協(xié)程或者UniTask都可以我這邊為了不引入額外依賴用的是原生協(xié)程。IEnumerator LoadModBundleAsync(string bundlePath, ActionAssetBundle onComplete) { var request AssetBundle.LoadFromFileAsync(bundlePath); yield return request; if (request.assetBundle null) { Debug.LogError($加載Bundle失敗: {bundlePath}); onComplete?.Invoke(null); yield break; } onComplete?.Invoke(request.assetBundle); }加載完成后Bundle不要立刻Unload因為里面的資源可能還在場景里用著。我的做法是維護一個引用計數(shù)當(dāng)所有從該Bundle加載的資源都被釋放后再調(diào)用Unload(true)。3.3 配置文件的解析與容錯mod.json的解析看起來簡單但實際會遇到各種奇葩情況BOM頭、注釋、字段缺失、類型不對。我一開始用JsonUtility.FromJson結(jié)果發(fā)現(xiàn)它不支持字典和嵌套數(shù)組后來換成了輕量級的JSON解析庫自己寫了個包裝層。[Serializable] public class ModManifest { public string name; public string version; public string author; public string entryAssembly; public string[] dependencies; }解析的時候一定要做字段校驗比如name為空就跳過這個Modversion格式不對就記警告。我見過有玩家手動改mod.json把版本號寫成中文的如果不做容錯整個Mod列表加載都會崩。注意移動端讀取JSON文件時要用File.ReadAllText指定UTF-8編碼不然中文Mod名稱會亂碼。PC上默認(rèn)編碼可能是GBK所以統(tǒng)一指定編碼最保險。3.4 腳本擴展點的設(shè)計這是整個Mod系統(tǒng)里最敏感的部分。移動端IL2CPP模式下動態(tài)加載C#腳本基本不可行所以我的方案是Mod腳本必須提前編譯成DLL并且和游戲主程序集一起打包。也就是說Mod的代碼擴展能力在構(gòu)建時就確定了運行時只負(fù)責(zé)反射調(diào)用。具體做法是定義一個接口public interface IModExtension { string ModName { get; } void OnLoad(); void OnUnload(); void OnGameStart(); }Mod開發(fā)者實現(xiàn)這個接口編譯成DLL后放到Mod目錄。游戲啟動時用Assembly.LoadFrom加載DLL反射找到實現(xiàn)類創(chuàng)建實例并調(diào)用OnLoad。var assembly Assembly.LoadFrom(dllPath); var types assembly.GetTypes().Where(t typeof(IModExtension).IsAssignableFrom(t) !t.IsInterface); foreach (var type in types) { var instance Activator.CreateInstance(type) as IModExtension; instance?.OnLoad(); _loadedMods.Add(instance); }實操心得反射創(chuàng)建實例時如果Mod的構(gòu)造函數(shù)里有異常整個加載流程會中斷。所以一定要用try-catch包住每個Mod的加載過程一個Mod失敗不影響其他Mod。4. 完整實操流程與關(guān)鍵環(huán)節(jié)實現(xiàn)4.1 環(huán)境準(zhǔn)備與目錄搭建先在項目根目錄下建一個Mods文件夾和Assets同級。然后在Assets里建一個ModSystem文件夾放所有Mod系統(tǒng)相關(guān)的腳本。目錄結(jié)構(gòu)如下ProjectRoot/ Assets/ ModSystem/ ModLoader.cs ModResourceManager.cs ModConfigParser.cs ModExtensionRegistry.cs Mods/ ModA/ mod.json resources.bundlePC上Mods目錄直接可讀寫Android上需要把Mods放到StreamingAssets里首次啟動拷貝到persistentDataPath?？截愡壿嬑覍懗梢粋€靜態(tài)方法在游戲啟動時調(diào)用一次。4.2 Mod加載器的完整實現(xiàn)加載器的流程分四步掃描目錄、讀取清單、加載Bundle、注冊擴展。我把它寫成一個協(xié)程方便異步處理。public IEnumerator LoadAllMods() { string modRoot GetModRootPath(); if (!Directory.Exists(modRoot)) { Debug.LogWarning(Mod目錄不存在跳過加載); yield break; } string[] modDirs Directory.GetDirectories(modRoot); foreach (string dir in modDirs) { string manifestPath Path.Combine(dir, mod.json); if (!File.Exists(manifestPath)) continue; string json File.ReadAllText(manifestPath, Encoding.UTF8); ModManifest manifest null; try { manifest JsonUtility.FromJsonModManifest(json); } catch (Exception e) { Debug.LogError($解析mod.json失敗: {dir}, {e.Message}); continue; } if (string.IsNullOrEmpty(manifest.name)) { Debug.LogWarning($Mod名稱為空跳過: {dir}); continue; } string bundlePath Path.Combine(dir, resources.bundle); if (File.Exists(bundlePath)) { yield return LoadModBundleAsync(bundlePath, (bundle) { if (bundle ! null) { _loadedBundles[manifest.name] bundle; } }); } if (!string.IsNullOrEmpty(manifest.entryAssembly)) { string dllPath Path.Combine(dir, manifest.entryAssembly); if (File.Exists(dllPath)) { LoadModAssembly(dllPath, manifest.name); } } } }這段代碼里L(fēng)oadModBundleAsync是前面寫的異步加載方法LoadModAssembly負(fù)責(zé)反射加載DLL。每個Mod獨立處理互不影響。4.3 資源加載與實例化Bundle加載完后從里面取資源就很簡單了public GameObject InstantiateModPrefab(string modName, string prefabName) { if (!_loadedBundles.TryGetValue(modName, out AssetBundle bundle)) { Debug.LogError($Mod未加載: {modName}); return null; } GameObject prefab bundle.LoadAssetGameObject(prefabName); if (prefab null) { Debug.LogError($預(yù)制體不存在: {prefabName}); return null; } return Object.Instantiate(prefab); }這里有個細(xì)節(jié)LoadAsset的名字必須和打包時設(shè)置的名字一致。我建議在打包腳本里統(tǒng)一用文件名作為Asset名稱避免手動指定出錯。4.4 配置數(shù)據(jù)的映射與使用Mod配置里可能包含數(shù)值、顏色、路徑等數(shù)據(jù)。我一般定義一個通用的ModConfig類用字典存鍵值對然后由各個Mod自己解析。[Serializable] public class ModConfig { public string key; public string value; public string type; // int, float, string, color }游戲邏輯里需要讀取配置時通過ModConfigParser.GetValue(modName, key)獲取內(nèi)部做類型轉(zhuǎn)換和緩存。這樣Mod開發(fā)者只需要在mod.json里加配置項不用改代碼。4.5 擴展點的實際掛載擴展點注冊中心維護一個事件列表Mod在OnLoad時注冊自己的回調(diào)public static class ModExtensionRegistry { private static Dictionarystring, Action _events new Dictionarystring, Action(); public static void Register(string eventName, Action callback) { if (!_events.ContainsKey(eventName)) _events[eventName] callback; else _events[eventName] callback; } public static void Trigger(string eventName) { if (_events.TryGetValue(eventName, out var action)) action?.Invoke(); } }游戲主邏輯在關(guān)鍵節(jié)點調(diào)用Trigger比如OnGameStart、OnPlayerDeath、OnLevelLoaded。Mod開發(fā)者只需要在OnLoad里調(diào)用Register就能把自己的邏輯掛上去。注意事件回調(diào)里如果拋異常會中斷后續(xù)所有回調(diào)。所以Trigger內(nèi)部要用try-catch包住每個回調(diào)記錄日志但不中斷。5. 常見問題與排查技巧實錄5.1 Bundle加載失敗排查表現(xiàn)象可能原因排查方法加載返回null路徑錯誤打印完整路徑檢查文件是否存在加載報錯“無法讀取”平臺不匹配確認(rèn)Bundle是用當(dāng)前平臺打的資源加載為nullAsset名稱不對用bundle.GetAllAssetNames()打印所有名稱實例化后材質(zhì)丟失Shader未打包把Shader加入Bundle或使用Always Included Shaders移動端加載卡頓同步加載大Bundle改用異步加載或拆分Bundle這個表是我實際排查時總結(jié)的基本覆蓋了八成以上的問題。尤其是Shader丟失PC上編輯器里正常打包到移動端就變粉紅就是因為Shader沒進Bundle。5.2 反射加載DLL的常見異常移動端IL2CPP下Assembly.LoadFrom加載的DLL必須是提前編譯好的而且不能包含UnityEditor相關(guān)的代碼。我遇到過Mod開發(fā)者把編輯器腳本也打進DLL結(jié)果運行時直接崩。解決辦法是在Mod開發(fā)文檔里明確寫清楚只引用UnityEngine和游戲主程序集不要引用UnityEditor。另一個坑是DLL的.NET版本。Unity 2021之后默認(rèn)用.NET Standard 2.1如果Mod DLL是用.NET Framework 4.8編譯的可能加載失敗。統(tǒng)一用.NET Standard 2.1編譯最穩(wěn)。5.3 移動端權(quán)限與路徑問題Android 11之后persistentDataPath的訪問不需要額外權(quán)限但如果你想把Mod放到外部存儲比如/sdcard/就需要申請存儲權(quán)限。我的建議是不要碰外部存儲全部放在persistentDataPath里省去權(quán)限申請的麻煩。iOS上更嚴(yán)格persistentDataPath是沙盒內(nèi)的Mod只能通過應(yīng)用內(nèi)下載或者iTunes文件共享導(dǎo)入。如果要做Mod導(dǎo)入功能得額外寫文件選擇器邏輯這塊我暫時沒做因為大部分移動端Mod需求都是內(nèi)置的。5.4 性能優(yōu)化與內(nèi)存管理Mod系統(tǒng)跑起來后內(nèi)存占用是必須監(jiān)控的。我一般會在加載完所有Mod后調(diào)用Resources.UnloadUnusedAssets()清理一次。另外每個Bundle的引用計數(shù)要維護好不用的時候及時Unload(false)只卸載Bundle文件本身不銷毀已加載的資源。public void UnloadMod(string modName) { if (_loadedBundles.TryGetValue(modName, out AssetBundle bundle)) { bundle.Unload(false); _loadedBundles.Remove(modName); } }實操心得Unload(true)會銷毀所有從該Bundle加載的資源如果場景里還有對象在用會直接變missing。所以除非確定不用了否則一律用Unload(false)。5.5 Mod沖突與加載順序多個Mod可能修改同一個配置或者注冊同一個事件。我的處理方式是按Mod目錄名稱排序加載后加載的Mod覆蓋先加載的。同時在配置解析時如果發(fā)現(xiàn)同一個key被多個Mod定義記錄警告并采用最后一個。事件注冊則相反多個Mod注冊同一個事件時全部保留按注冊順序依次調(diào)用。這樣Mod之間可以協(xié)作比如一個Mod加UI另一個Mod加邏輯。6. 一些實戰(zhàn)中的個人體會這套Mod系統(tǒng)我在兩個項目里用過一個是PC端的建造游戲一個是移動端的休閑模擬。PC上基本沒遇到大問題移動端踩的坑主要集中在路徑和Shader上。后來我養(yǎng)成了一個習(xí)慣每次打包Mod Bundle后先在目標(biāo)平臺上跑一遍加載測試確認(rèn)沒問題再發(fā)布。這個步驟看起來多余但能省掉大量玩家反饋的排查時間。另外Mod系統(tǒng)的文檔比代碼更重要。我見過太多開發(fā)者包括我自己早期覺得“代碼寫好了就行”結(jié)果Mod開發(fā)者不知道怎么打包、怎么命名、怎么調(diào)試最后Mod生態(tài)根本起不來。所以如果你打算長期維護Mod功能一定要寫一份清晰的Mod開發(fā)指南把目錄結(jié)構(gòu)、配置格式、擴展點列表、常見錯誤都列出來。最后分享一個小技巧在游戲里加一個“Mod調(diào)試模式”開啟后可以在屏幕上顯示當(dāng)前加載的Mod列表、Bundle數(shù)量、內(nèi)存占用。這個功能在排查玩家反饋時特別有用玩家截個圖你就能定位問題不用反復(fù)問“你裝了什么Mod”。