戰(zhàn)指南：Python批量提取與修改Unity游戲資產(chǎn))
1. 項(xiàng)目概述當(dāng)Python遇見(jiàn)Unity資產(chǎn)如果你是一名游戲開(kāi)發(fā)者、逆向工程師或者對(duì)游戲數(shù)據(jù)挖掘、Mod制作感興趣那么你一定遇到過(guò)這樣的場(chǎng)景手頭有一個(gè)Unity引擎開(kāi)發(fā)的游戲或應(yīng)用里面有你想要的精美貼圖、有趣的文本、獨(dú)特的模型甚至是核心的游戲配置數(shù)據(jù)。你很想把它們提取出來(lái)研究、修改或者二次創(chuàng)作但面對(duì)那些.assets、.bundle文件卻感到無(wú)從下手。傳統(tǒng)的工具要么是圖形化界面操作繁瑣要么功能單一無(wú)法集成到自動(dòng)化流程中。這時(shí)一個(gè)名為UnityPy的Python庫(kù)就像一把瑞士軍刀為你打開(kāi)了這扇門。UnityPy是一個(gè)基于AssetStudio核心的Python模塊它的核心使命非常明確讓開(kāi)發(fā)者能夠用Python腳本一站式地完成Unity資產(chǎn)的讀取、提取解包和編輯。這意味著你不再需要手動(dòng)點(diǎn)擊各種工具而是可以通過(guò)編寫(xiě)幾行代碼批量處理成千上萬(wàn)個(gè)游戲文件精準(zhǔn)地提取你需要的紋理、音頻、文本甚至修改游戲內(nèi)的參數(shù)再打包回去。這對(duì)于游戲數(shù)據(jù)分析、自動(dòng)化Mod制作、資源遷移、安全審計(jì)等場(chǎng)景來(lái)說(shuō)是一個(gè)效率的飛躍。無(wú)論你是想從熱門手游里分析UI設(shè)計(jì)規(guī)律還是為自己喜歡的獨(dú)立游戲制作一個(gè)漢化補(bǔ)丁UnityPy都提供了一個(gè)強(qiáng)大而靈活的編程接口。2. UnityPy的核心架構(gòu)與工作原理拆解要熟練使用UnityPy不能只停留在調(diào)用API的層面理解其內(nèi)部如何與Unity資產(chǎn)格式交互是解決復(fù)雜問(wèn)題和進(jìn)行深度定制的基礎(chǔ)。Unity資產(chǎn)文件并不是一個(gè)簡(jiǎn)單的壓縮包它內(nèi)部有一套復(fù)雜的序列化系統(tǒng)。2.1 Unity資產(chǎn)文件格式淺析Unity的資源管理主要涉及幾種文件類型Asset文件.assets、AssetBundle文件.bundle或自定義擴(kuò)展名、以及包含這些文件的APK或IPA包。這些文件內(nèi)部可以看作是一個(gè)容器SerializedFile里面存放著許多個(gè)獨(dú)立的對(duì)象Object比如一個(gè)Texture2D對(duì)象代表一張圖片一個(gè)TextAsset對(duì)象代表一段文本或腳本。每個(gè)對(duì)象都包含兩部分關(guān)鍵信息對(duì)象頭和對(duì)象數(shù)據(jù)。對(duì)象頭包含了類型ID、路徑ID、字節(jié)大小等元信息。對(duì)象數(shù)據(jù)則是這個(gè)資源的具體內(nèi)容但其存儲(chǔ)格式并非原始數(shù)據(jù)如PNG像素而是遵循Unity內(nèi)部序列化規(guī)則的二進(jìn)制流。最關(guān)鍵的是類型樹(shù)TypeTree它定義了如何解析這個(gè)二進(jìn)制流將一串字節(jié)還原成具有具體字段如m_Name,m_Width的結(jié)構(gòu)化數(shù)據(jù)。沒(méi)有類型樹(shù)我們看到的只是一堆亂碼。UnityPy的核心工作就是模擬Unity編輯器的反序列化過(guò)程。它讀取文件根據(jù)文件頭判斷其類型AssetBundle, WebFile等然后解壓如果需要并解析出內(nèi)部的Asset容器。對(duì)于容器中的每個(gè)ObjectUnityPy利用內(nèi)置的或從游戲文件中提取的類型樹(shù)信息將二進(jìn)制數(shù)據(jù)“翻譯”成我們可以理解的Python字典或預(yù)定義的類實(shí)例。2.2 UnityPy的核心類與數(shù)據(jù)流理解了文件格式我們?cè)賮?lái)看UnityPy提供的幾個(gè)關(guān)鍵類它們構(gòu)成了數(shù)據(jù)處理的管道Environment這是入口點(diǎn)。當(dāng)你調(diào)用UnityPy.load(source)時(shí)就創(chuàng)建了一個(gè)環(huán)境。這個(gè)source可以是文件路徑、文件夾路徑、字節(jié)流bytes或io.BytesIO對(duì)象。Environment的智能之處在于能自動(dòng)檢測(cè)輸入源的類型。加載后所有解析出的資產(chǎn)都存放在env.files字典里而遍歷env.objects則可以訪問(wèn)到所有底層對(duì)象。Asset / SerializedFile代表一個(gè)加載的資產(chǎn)文件。它最重要的兩個(gè)屬性是.objects和.container。.objects是一個(gè)字典以對(duì)象唯一的path_id為鍵方便你通過(guò)ID精確查找。.container則是一個(gè)以資源在項(xiàng)目中的虛擬路徑為鍵的字典這對(duì)于想按照原始目錄結(jié)構(gòu)導(dǎo)出資源特別有用。ObjectReader這是每個(gè)具體資源對(duì)象如一張貼圖、一段音頻的包裝器。它本身并不包含解析后的數(shù)據(jù)只持有原始字節(jié)和類型信息。你必須調(diào)用其解析方法如.parse_as_object()才能獲得可操作的數(shù)據(jù)。這種“惰性加載”設(shè)計(jì)是為了性能考慮因?yàn)橐粋€(gè)資產(chǎn)文件可能包含成千上萬(wàn)個(gè)對(duì)象但通常你只關(guān)心其中幾種。數(shù)據(jù)流的典型路徑是加載文件 - 創(chuàng)建Environment - 獲取Asset - 遍歷ObjectReader - 解析為目標(biāo)對(duì)象 - 讀取或修改數(shù)據(jù) - 保存修改如果需要。整個(gè)流程清晰可控完全腳本化。注意UnityPy在處理某些大型或特殊壓縮格式的AssetBundle時(shí)可能會(huì)占用較多內(nèi)存。在處理未知來(lái)源的文件前建議先在小樣本上測(cè)試或者使用流式處理避免一次性加載所有數(shù)據(jù)導(dǎo)致內(nèi)存溢出。3. 從安裝到實(shí)戰(zhàn)一站式資產(chǎn)提取詳解理論說(shuō)得再多不如動(dòng)手一試。我們從一個(gè)完整的實(shí)戰(zhàn)例子開(kāi)始看看如何用UnityPy把游戲里的圖片資源“扒”出來(lái)。3.1 環(huán)境搭建與潛在坑位安裝UnityPy非常簡(jiǎn)單一行命令即可pip install UnityPy但這里有幾個(gè)新手常踩的坑我必須提前指出Python版本確保你的Python版本在3.8及以上。雖然文檔這么說(shuō)但我實(shí)測(cè)在某些Windows 10系統(tǒng)上使用Python 3.11或3.12的最新版本時(shí)可能會(huì)因?yàn)槟承〤擴(kuò)展依賴如brotli沒(méi)有預(yù)編譯的wheel包而導(dǎo)致安裝失敗。如果遇到pip安裝報(bào)錯(cuò)提到編譯失敗最穩(wěn)妥的解決方案是降級(jí)到Python 3.9或3.10這是大多數(shù)二進(jìn)制依賴兼容性最好的版本。Windows系統(tǒng)依賴在Windows上如果遇到運(yùn)行時(shí)錯(cuò)誤提示缺少VCRUNTIME140.dll等你需要安裝“Microsoft Visual C Redistributable”。去微軟官網(wǎng)下載最新版的安裝包即可這是很多Python科學(xué)計(jì)算庫(kù)的運(yùn)行時(shí)依賴?！办o默崩潰”問(wèn)題極少數(shù)情況下UnityPy的C語(yǔ)言類型樹(shù)讀取加速模塊可能會(huì)導(dǎo)致Python解釋器直接崩潰且無(wú)錯(cuò)誤信息。如果你在運(yùn)行腳本時(shí)遇到程序突然關(guān)閉可以嘗試禁用C加速改用純Python解析器速度會(huì)慢一些from UnityPy.helpers import TypeTreeHelper TypeTreeHelper.read_typetree_boost False把這行代碼放在你腳本的最開(kāi)頭導(dǎo)入U(xiǎn)nityPy之后。3.2 核心提取流程代碼拆解假設(shè)我們有一個(gè)游戲資源文件夾里面散落著很多.assets文件我們想批量提取出所有的Texture2D2D紋理和Sprite精靈通常是UI元素為PNG圖片。import os import UnityPy def extract_textures_and_sprites(source_dir, output_dir): 從源目錄遞歸遍歷所有文件提取紋理和精靈圖片。 Args: source_dir: 存放Unity資產(chǎn)文件(.assets, .bundle等)的根目錄。 output_dir: 圖片輸出目錄。 # 1. 遍歷源目錄 for root, dirs, files in os.walk(source_dir): for filename in files: filepath os.path.join(root, filename) # 2. 加載文件環(huán)境 # 這里用try包裹因?yàn)榉荱nity文件會(huì)加載失敗 try: env UnityPy.load(filepath) except Exception as e: print(f無(wú)法加載文件 {filepath}: {e}) continue # 跳過(guò)這個(gè)文件繼續(xù)下一個(gè) # 3. 遍歷環(huán)境中的所有對(duì)象 for obj in env.objects: # 4. 按類型篩選我們需要的對(duì)象 if obj.type.name in [Texture2D, Sprite]: # 5. 解析對(duì)象為可操作的類實(shí)例 data obj.parse_as_object() # 6. 準(zhǔn)備輸出路徑 # 使用對(duì)象的名稱作為文件名確保唯一性可以加上路徑ID # 注意對(duì)象名可能包含非法字符或?yàn)榭招枰謇?safe_name data.m_Name if data.m_Name else funnamed_{obj.path_id} # 替換路徑中的非法字符 safe_name .join(c for c in safe_name if c.isalnum() or c in ( , -, _)).rstrip() output_path os.path.join(output_dir, f{safe_name}.png) # 7. 處理重名文件如果同一個(gè)名字出現(xiàn)多次 counter 1 while os.path.exists(output_path): output_path os.path.join(output_dir, f{safe_name}_{counter}.png) counter 1 # 8. 保存圖片 # Texture2D和Sprite對(duì)象都有.image屬性它返回一個(gè)PIL.Image對(duì)象 try: data.image.save(output_path) print(f已保存: {output_path}) except AttributeError: # 有些Texture2D可能沒(méi)有有效的圖像數(shù)據(jù)如RenderTexture print(f警告: 對(duì)象 {safe_name} 無(wú)法導(dǎo)出為圖片可能不是常規(guī)紋理。) except Exception as e: print(f保存圖片 {output_path} 時(shí)出錯(cuò): {e}) # 使用示例 if __name__ __main__: source ./game_resources # 你的資源文件夾 output ./extracted_images # 輸出文件夾 os.makedirs(output, exist_okTrue) # 創(chuàng)建輸出目錄 extract_textures_and_sprites(source, output)這段代碼是一個(gè)基礎(chǔ)但功能完整的提取器。它有幾個(gè)關(guān)鍵點(diǎn)值得深入惰性解析與性能代碼在循環(huán)內(nèi)才調(diào)用obj.parse_as_object()。如果文件內(nèi)有上萬(wàn)個(gè)對(duì)象但只有幾十個(gè)是紋理這避免了不必要的解析開(kāi)銷。.type.name屬性這是ObjectReader對(duì)象的屬性直接告訴你這個(gè)對(duì)象的Unity類型是篩選的關(guān)鍵。data.image屬性這是UnityPy為Texture2D和Sprite類型提供的便捷屬性。它內(nèi)部處理了Unity紋理格式如RGBA32、DXT5到PIL標(biāo)準(zhǔn)RGB/RGBA圖像的轉(zhuǎn)換甚至為Sprite自動(dòng)合成了紋理圖集和Alpha通道省去了大量底層操作。錯(cuò)誤處理用try-except包裹加載和保存過(guò)程至關(guān)重要。游戲資源文件可能損壞或者包含一些特殊格式的紋理如壓縮紋理格式直接操作可能導(dǎo)致程序崩潰。3.3 高級(jí)提取保持原始目錄結(jié)構(gòu)上面的例子把所有圖片都扔到了一個(gè)文件夾里。但對(duì)于大型項(xiàng)目我們可能希望保持資源在Unity項(xiàng)目中的原始路徑結(jié)構(gòu)。這時(shí)就需要用到env.container。def extract_with_structure(source_dir, output_base_dir): for root, dirs, files in os.walk(source_dir): for filename in files: filepath os.path.join(root, filename) try: env UnityPy.load(filepath) except: continue # 遍歷容器它保存了路徑信息 for asset_path, obj in env.container.items(): if obj.type.name in [Texture2D, Sprite]: data obj.parse_as_object() # 基于asset_path構(gòu)建輸出路徑 # asset_path 可能像 assets/resources/ui/icon.png # 我們需要去掉可能的擴(kuò)展名換成.png full_output_path os.path.join(output_base_dir, asset_path) full_output_path os.path.splitext(full_output_path)[0] .png # 創(chuàng)建所需的目錄 os.makedirs(os.path.dirname(full_output_path), exist_okTrue) try: data.image.save(full_output_path) print(f按結(jié)構(gòu)保存: {full_output_path}) except Exception as e: print(f保存失敗 {asset_path}: {e})env.container是一個(gè)字典鍵是資源在AssetBundle或資源系統(tǒng)中的虛擬路徑。利用這個(gè)路徑我們可以完美復(fù)現(xiàn)項(xiàng)目的資源樹(shù)。這對(duì)于分析游戲資源依賴關(guān)系或者準(zhǔn)備重新導(dǎo)入U(xiǎn)nity編輯器進(jìn)行修改非常有幫助。實(shí)操心得在處理大量文件時(shí)尤其是從APK中解壓出來(lái)的成千上萬(wàn)個(gè)小型.assets文件頻繁的UnityPy.load()調(diào)用會(huì)成為性能瓶頸。一個(gè)優(yōu)化技巧是如果這些文件是獨(dú)立的Asset文件非Bundle可以考慮先將它們合并到一個(gè)列表里但要注意內(nèi)存消耗。更常見(jiàn)的做法是使用多進(jìn)程multiprocessing來(lái)并行處理多個(gè)文件但需要確保每個(gè)進(jìn)程有獨(dú)立的數(shù)據(jù)空間避免共享環(huán)境對(duì)象。4. 不止于提取資產(chǎn)的查看與編輯實(shí)戰(zhàn)提取資源只是第一步UnityPy更強(qiáng)大的能力在于“編輯”。這意味著我們可以修改游戲內(nèi)的數(shù)據(jù)再寫(xiě)回文件實(shí)現(xiàn)Mod制作或數(shù)據(jù)替換。4.1 如何查看與修改資產(chǎn)數(shù)據(jù)修改資產(chǎn)的核心在于ObjectReader.patch()方法。修改前你需要先獲取對(duì)象的當(dāng)前數(shù)據(jù)。有兩種主要方式解析為字典obj.parse_as_dict()。這會(huì)返回一個(gè)嵌套的字典完全反映了對(duì)象的類型樹(shù)結(jié)構(gòu)。修改字典的值然后調(diào)用obj.patch(modified_dict)即可。這種方式通用性強(qiáng)但需要你對(duì)類型樹(shù)結(jié)構(gòu)比較熟悉。解析為對(duì)象obj.parse_as_object()。這會(huì)返回一個(gè)UnityPy自動(dòng)生成的類實(shí)例如Texture2D,TextAsset其屬性對(duì)應(yīng)著Unity類的字段。直接修改實(shí)例的屬性然后調(diào)用obj.patch(modified_instance)。這種方式更直觀類似于操作一個(gè)普通的Python對(duì)象。示例批量重命名紋理def rename_textures_in_file(filepath, name_mapping): 修改一個(gè)資產(chǎn)文件中的紋理名稱。 Args: filepath: 資產(chǎn)文件路徑。 name_mapping: 一個(gè)字典鍵為舊名稱或部分名稱值為新名稱。 env UnityPy.load(filepath) modified False for obj in env.objects: if obj.type.name Texture2D: # 先快速讀取名稱避免不必要的完整解析 current_name obj.peek_name() if not current_name: continue # 檢查是否需要重命名 for old, new in name_mapping.items(): if old in current_name: # 解析完整對(duì)象 tex obj.parse_as_object() tex.m_Name current_name.replace(old, new) # 打補(bǔ)丁將修改寫(xiě)回ObjectReader obj.patch(tex) modified True print(f在 {filepath} 中將紋理 {current_name} 重命名為 {tex.m_Name}) break # 只替換一次 # 如果文件被修改了保存它 if modified: # env.file.save() 返回文件的字節(jié)數(shù)據(jù) new_data env.file.save() with open(filepath, wb) as f: f.write(new_data) print(f文件已保存: {filepath})obj.peek_name()是一個(gè)非常有用的優(yōu)化函數(shù)它只讀取對(duì)象頭中的名稱字段而不解析整個(gè)對(duì)象數(shù)據(jù)速度極快適合用于快速篩選。4.2 處理復(fù)雜類型MonoBehaviour與類型樹(shù)挑戰(zhàn)MonoBehaviour是Unity中用于掛載自定義腳本的組件游戲的核心邏輯和數(shù)據(jù)如角色屬性、關(guān)卡配置常存在這里。但提取和編輯MonoBehaviour是UnityPy中最有挑戰(zhàn)的部分因?yàn)樗臄?shù)據(jù)結(jié)構(gòu)是由游戲腳本定義的類型樹(shù)信息可能不包含在發(fā)布的資產(chǎn)文件中。情況一類型樹(shù)已包含在資產(chǎn)中。這是最簡(jiǎn)單的情況你可以像處理其他對(duì)象一樣解析它。import json for obj in env.objects: if obj.type.name MonoBehaviour: mb_data obj.parse_as_dict() # 解析為字典 # 現(xiàn)在mb_data是一個(gè)包含所有字段的字典 # 例如可能包含 playerHealth, maxScore 等自定義字段 print(json.dumps(mb_data, indent2, defaultstr)) # 使用defaultstr處理不可序列化對(duì)象 # 修改數(shù)據(jù) if playerHealth in mb_data: mb_data[playerHealth] 9999 # 修改生命值 obj.patch(mb_data) # 寫(xiě)回修改情況二類型樹(shù)缺失。對(duì)于使用IL2CPP等方式編譯的游戲MonoBehaviour的類型樹(shù)經(jīng)常是缺失的。直接解析會(huì)得到一堆難以理解的二進(jìn)制數(shù)據(jù)。這時(shí)就需要TypeTreeGenerator這個(gè)可選組件。安裝生成器pip install TypeTreeGeneratorAPI準(zhǔn)備游戲程序集你需要有游戲的托管程序集DLL文件。對(duì)于Mono后端游戲它們通常在游戲目錄的GameName_Data/Managed/文件夾下。對(duì)于IL2CPP你需要使用工具如Il2CppDumper從global-metadata.dat和游戲二進(jìn)制文件中生成“偽DLL”。在代碼中配置生成器import UnityPy from UnityPy.helpers.TypeTreeGenerator import TypeTreeGenerator # 1. 創(chuàng)建生成器并指定游戲使用的Unity版本非常重要 # 你可以從任意一個(gè)游戲資產(chǎn)對(duì)象中獲取env.objects[0].assets_file.unity_version unity_version 2021.3.20f1 generator TypeTreeGenerator(unity_version) # 2. 加載游戲程序集 # 方式A: 如果是Mono游戲直接指向Managed文件夾 game_managed_dir rD:\Steam\steamapps\common\MyGame\MyGame_Data\Managed generator.load_dll_folder(game_managed_dir) # 方式B: 如果是IL2CPP加載生成的偽DLL # generator.load_dll_folder(rpath\to\dump\DummyDll) # 3. 加載資產(chǎn)文件并將生成器賦值給環(huán)境 env UnityPy.load(some_asset.assets) env.typetree_generator generator # 關(guān)鍵步驟 # 4. 現(xiàn)在解析MonoBehaviour會(huì)自動(dòng)嘗試使用生成器 for obj in env.objects: if obj.type.name MonoBehaviour: # 如果類型樹(shù)缺失生成器會(huì)在后臺(tái)工作 instance obj.parse_as_object() # 此時(shí)instance可能是一個(gè)UnknownObject但其字段可以通過(guò)字典方式訪問(wèn) data_dict obj.parse_as_dict() # 或者解析為字典查看結(jié)構(gòu) print(data_dict.get(someCustomField)) **重要提示**TypeTreeGenerator不是萬(wàn)能的其準(zhǔn)確度取決于游戲程序集的完整性和Unity版本的匹配度。對(duì)于高度混淆或自定義序列化的游戲數(shù)據(jù)可能仍然無(wú)法正確解析。在實(shí)際操作中結(jié)合十六進(jìn)制查看器和動(dòng)態(tài)分析如使用dnSpy調(diào)試通常是必要的補(bǔ)充手段。 ### 4.3 其他常見(jiàn)資產(chǎn)類型的操作 * **TextAsset文本資產(chǎn)**常用于存儲(chǔ)配置表JSON、XML、Lua腳本、Shader代碼等。 python for obj in env.objects: if obj.type.name TextAsset: text_obj obj.parse_as_object() content text_obj.m_Script # 這是一個(gè)字符串 # 重要如果文件實(shí)際是二進(jìn)制數(shù)據(jù)如加密的配置需要用特定編碼讀取 # binary_content text_obj.m_Script.encode(utf-8, surrogateescape) # 修改文本內(nèi)容 if Difficulty in content: new_content content.replace(Difficulty 5, Difficulty 1) text_obj.m_Script new_content obj.patch(text_obj) * **AudioClip音頻剪輯**UnityPy可以將音頻樣本轉(zhuǎn)換為標(biāo)準(zhǔn)的WAV格式字節(jié)流。 python for obj in env.objects: if obj.type.name AudioClip: clip obj.parse_as_object() for sample_name, sample_data in clip.samples.items(): # sample_data 已經(jīng)是WAV格式的bytes with open(f{sample_name}.wav, wb) as f: f.write(sample_data) * **Mesh網(wǎng)格**可以導(dǎo)出為Wavefront .obj格式方便在3D軟件中查看。 python for obj in env.objects: if obj.type.name Mesh: mesh obj.parse_as_object() obj_str mesh.export() # 返回OBJ格式的字符串 with open(f{mesh.m_Name}.obj, w, newline) as f: f.write(obj_str) ## 5. 高級(jí)配置與疑難問(wèn)題排查 當(dāng)你的項(xiàng)目從簡(jiǎn)單提取走向復(fù)雜修改和批量處理時(shí)會(huì)遇到一些更深層次的問(wèn)題。UnityPy提供了一些配置接口來(lái)處理這些情況。 ### 5.1 處理特殊加密與壓縮 一些游戲特別是某些地區(qū)的版本可能會(huì)對(duì)AssetBundle進(jìn)行加密或使用非標(biāo)準(zhǔn)壓縮。 * **Unity中國(guó)版加密**一些中國(guó)版Unity引擎打包的AssetBundle有內(nèi)置加密。如果你有解密密鑰通常需要從游戲內(nèi)存或邏輯中分析獲取可以這樣設(shè)置 python import UnityPy # 假設(shè)你通過(guò)逆向得到了密鑰 DECRYPT_KEY byour-32-byte-key-here UnityPy.set_assetbundle_decrypt_key(DECRYPT_KEY) # 之后再load的AssetBundle就會(huì)嘗試用此密鑰解密 * **自定義壓縮算法**極少數(shù)游戲會(huì)使用Unity不支持的壓縮算法。你可以注冊(cè)自己的壓縮/解壓函數(shù)。 python from UnityPy.enums.BundleFile import CompressionFlags from UnityPy.helpers import CompressionHelper # 假設(shè)游戲使用了自定義的LZ4變種flag值為0x80假設(shè) CUSTOM_FLAG 0x80 def my_custom_decompress(data, uncompressed_size): # 實(shí)現(xiàn)你的解壓邏輯 # ... return decompressed_data def my_custom_compress(data): # 實(shí)現(xiàn)你的壓縮邏輯如果需要寫(xiě)回文件 # ... return compressed_data # 注冊(cè)到全局映射表 CompressionHelper.DECOMPRESSION_MAP[CUSTOM_FLAG] my_custom_decompress CompressionHelper.COMPRESSION_MAP[CUSTOM_FLAG] my_custom_compress 這需要你精確知道游戲使用的壓縮算法和其對(duì)應(yīng)的標(biāo)志位通常需要逆向工程分析。 ### 5.2 常見(jiàn)錯(cuò)誤與解決方案速查表 在實(shí)際操作中你大概率會(huì)遇到下面這些問(wèn)題。這里我整理了一個(gè)快速排查指南 | 問(wèn)題現(xiàn)象 | 可能原因 | 解決方案 | | :--- | :--- | :--- | | **導(dǎo)入U(xiǎn)nityPy時(shí)崩潰或無(wú)錯(cuò)誤退出** | C語(yǔ)言類型樹(shù)讀取器與當(dāng)前環(huán)境不兼容。 | 在腳本開(kāi)頭禁用C加速TypeTreeHelper.read_typetree_boost False | | **pip install UnityPy 失敗提示編譯錯(cuò)誤** | 缺少C編譯環(huán)境或Python版本太新。 | 1. 安裝Visual Studio Build Tools (Windows) 或 Xcode Command Line Tools (macOS)。br2. 更簡(jiǎn)單的方法降級(jí)Python到3.9或3.10。 | | **obj.parse_as_object() 返回 UnknownObject 或字段全是亂碼** | 1. 對(duì)象類型不被UnityPy內(nèi)置類支持。br2. (對(duì)于MonoBehaviour) 類型樹(shù)信息缺失。 | 1. 使用obj.parse_as_dict()查看原始字典結(jié)構(gòu)。br2. 安裝并使用TypeTreeGeneratorAPI并正確配置游戲程序集路徑。 | | **修改后的資產(chǎn)文件游戲無(wú)法讀取/崩潰** | 1. 修改破壞了數(shù)據(jù)的序列化結(jié)構(gòu)如數(shù)組長(zhǎng)度不對(duì)。br2. 修改了游戲代碼依賴的關(guān)鍵字段。br3. 保存時(shí)壓縮方式不匹配。 | 1. 確保patch的數(shù)據(jù)結(jié)構(gòu)與原始結(jié)構(gòu)完全一致。br2. 只修改你理解的數(shù)據(jù)字段避免改動(dòng)引用ID、類型標(biāo)識(shí)等元數(shù)據(jù)。br3. 使用env.file.save()保存它會(huì)保持原始的壓縮格式。 | | **處理大型Bundle文件內(nèi)存占用過(guò)高** | 一次性加載了整個(gè)Bundle到內(nèi)存。 | 如果只是提取部分資源考慮使用UnityPy.load的流模式并配合env.container進(jìn)行選擇性解析。對(duì)于超大型文件可能需要分塊處理或?qū)ふ移渌ぞ哌M(jìn)行預(yù)拆分。 | | **提取的圖片是純色如全紫** | 紋理使用了Unity不常見(jiàn)的壓縮格式如ASTC, ETC2而PIL或當(dāng)前環(huán)境不支持。 | UnityPy的.image屬性可能無(wú)法解碼所有格式。可以嘗試直接訪問(wèn)紋理的原始字節(jié)數(shù)據(jù)tex.image_data然后用其他專業(yè)圖像庫(kù)如astc-dec解碼。 | | **env.container 為空字典** | 加載的文件是一個(gè)普通的.assets文件SerializedFile而不是AssetBundle。AssetBundle才會(huì)維護(hù)路徑容器。 | 使用env.objects通過(guò)類型和ID來(lái)遍歷和篩選對(duì)象。 | ### 5.3 性能優(yōu)化與最佳實(shí)踐 1. **選擇性解析**始終使用obj.type.name和obj.peek_name()進(jìn)行過(guò)濾只在必要時(shí)調(diào)用parse_as_object/dict。 2. **批量操作與緩存**如果需要反復(fù)讀取同一批文件的相同類型對(duì)象可以考慮將解析后的數(shù)據(jù)緩存到內(nèi)存或本地文件如pickle避免重復(fù)解析。 3. **使用迭代器**env.objects本身是一個(gè)迭代器適合處理大量對(duì)象。避免先將其轉(zhuǎn)換為列表如list(env.objects)再遍歷除非你真的需要隨機(jī)訪問(wèn)。 4. **版本管理**如項(xiàng)目README所述UnityPy仍在活躍開(kāi)發(fā)中小版本x.y可能有破壞性更新。對(duì)于生產(chǎn)環(huán)境在requirements.txt或代碼中固定版本號(hào)如UnityPy1.9.6是明智之舉。 5. **備份原文件**在進(jìn)行任何寫(xiě)回操作env.file.save()之前**務(wù)必備份原始文件**。錯(cuò)誤的修改可能導(dǎo)致文件永久損壞。 ## 6. 項(xiàng)目實(shí)戰(zhàn)構(gòu)想從理論到創(chuàng)造 掌握了基礎(chǔ)操作和排錯(cuò)技巧后我們可以構(gòu)思一些更具體的項(xiàng)目看看UnityPy如何融入實(shí)際工作流。 **構(gòu)想一游戲本地化工具鏈** 1. **提取**編寫(xiě)腳本掃描游戲所有TextAsset和MonoBehaviour將包含文本的字段導(dǎo)出為JSON或CSV。 2. **翻譯**在表格中完成翻譯。 3. **注入**編寫(xiě)另一個(gè)腳本讀取翻譯好的表格找到對(duì)應(yīng)的游戲?qū)ο笫褂胮atch方法將原文替換為譯文。 4. **打包**將修改后的資產(chǎn)文件重新打包回游戲這可能涉及APK重簽名或Bundle更新。 **構(gòu)想二游戲資源分析與報(bào)告** 1. **資源普查**遍歷游戲所有資源統(tǒng)計(jì)各類資源紋理、音頻、網(wǎng)格的數(shù)量、尺寸、格式生成一份資源使用報(bào)告。 2. **依賴分析**通過(guò)分析MonoBehaviour中的引用關(guān)系或Prefab數(shù)據(jù)構(gòu)建資源引用圖找出未被使用的“垃圾資源”或關(guān)鍵資源。 3. **風(fēng)格提取**提取游戲所有UI紋理和字體分析其主色調(diào)、設(shè)計(jì)風(fēng)格用于制作風(fēng)格指南或輔助創(chuàng)作。 **構(gòu)想三自動(dòng)化Mod測(cè)試框架** 1. **模版化修改**為常見(jiàn)的修改如屬性調(diào)整、模型替換編寫(xiě)函數(shù)。 2. **批量應(yīng)用**將修改函數(shù)應(yīng)用到指定的游戲存檔或資源包上。 3. **快速驗(yàn)證**自動(dòng)啟動(dòng)游戲測(cè)試客戶端如果可能或驗(yàn)證生成的文件結(jié)構(gòu)是否正確。 在我自己的使用經(jīng)驗(yàn)里UnityPy最大的優(yōu)勢(shì)在于它將一個(gè)黑盒的專有格式變成了一個(gè)可以用Python生態(tài)如PIL處理圖像、pandas分析數(shù)據(jù)、Flask提供Web界面自由操作的開(kāi)放領(lǐng)域。它不是一個(gè)點(diǎn)擊即用的圖形化工具而是一個(gè)需要你動(dòng)手編程的“樂(lè)高積木”。這帶來(lái)了學(xué)習(xí)曲線但也帶來(lái)了無(wú)與倫比的靈活性和自動(dòng)化潛力。剛開(kāi)始你可能會(huì)被類型樹(shù)、路徑ID這些概念困擾但一旦理解了“環(huán)境-資產(chǎn)-對(duì)象-數(shù)據(jù)”這條主線并善用parse_as_dict()來(lái)探索未知結(jié)構(gòu)大部分障礙都能被攻克。記得游戲逆向和Mod制作社區(qū)是寶貴的資源遇到棘手問(wèn)題時(shí)去相關(guān)的論壇或Discord頻道看看往往能找到靈感或現(xiàn)成的解決方案。 UnityPy實(shí)戰(zhàn)指南：Python批量提取與修改Unity游戲資產(chǎn)
1. 項(xiàng)目概述當(dāng)Python遇見(jiàn)Unity資產(chǎn)如果你是一名游戲開(kāi)發(fā)者、逆向工程師或者對(duì)游戲數(shù)據(jù)挖掘、Mod制作感興趣那么你一定遇到過(guò)這樣的場(chǎng)景手頭有一個(gè)Unity引擎開(kāi)發(fā)的游戲或應(yīng)用里面有你想要的精美貼圖、有趣的文本、獨(dú)特的模型甚至是核心的游戲配置數(shù)據(jù)。你很想把它們提取出來(lái)研究、修改或者二次創(chuàng)作但面對(duì)那些.assets、.bundle文件卻感到無(wú)從下手。傳統(tǒng)的工具要么是圖形化界面操作繁瑣要么功能單一無(wú)法集成到自動(dòng)化流程中。這時(shí)一個(gè)名為UnityPy的Python庫(kù)就像一把瑞士軍刀為你打開(kāi)了這扇門。UnityPy是一個(gè)基于AssetStudio核心的Python模塊它的核心使命非常明確讓開(kāi)發(fā)者能夠用Python腳本一站式地完成Unity資產(chǎn)的讀取、提取解包和編輯。這意味著你不再需要手動(dòng)點(diǎn)擊各種工具而是可以通過(guò)編寫(xiě)幾行代碼批量處理成千上萬(wàn)個(gè)游戲文件精準(zhǔn)地提取你需要的紋理、音頻、文本甚至修改游戲內(nèi)的參數(shù)再打包回去。這對(duì)于游戲數(shù)據(jù)分析、自動(dòng)化Mod制作、資源遷移、安全審計(jì)等場(chǎng)景來(lái)說(shuō)是一個(gè)效率的飛躍。無(wú)論你是想從熱門手游里分析UI設(shè)計(jì)規(guī)律還是為自己喜歡的獨(dú)立游戲制作一個(gè)漢化補(bǔ)丁UnityPy都提供了一個(gè)強(qiáng)大而靈活的編程接口。2. UnityPy的核心架構(gòu)與工作原理拆解要熟練使用UnityPy不能只停留在調(diào)用API的層面理解其內(nèi)部如何與Unity資產(chǎn)格式交互是解決復(fù)雜問(wèn)題和進(jìn)行深度定制的基礎(chǔ)。Unity資產(chǎn)文件并不是一個(gè)簡(jiǎn)單的壓縮包它內(nèi)部有一套復(fù)雜的序列化系統(tǒng)。2.1 Unity資產(chǎn)文件格式淺析Unity的資源管理主要涉及幾種文件類型Asset文件.assets、AssetBundle文件.bundle或自定義擴(kuò)展名、以及包含這些文件的APK或IPA包。這些文件內(nèi)部可以看作是一個(gè)容器SerializedFile里面存放著許多個(gè)獨(dú)立的對(duì)象Object比如一個(gè)Texture2D對(duì)象代表一張圖片一個(gè)TextAsset對(duì)象代表一段文本或腳本。每個(gè)對(duì)象都包含兩部分關(guān)鍵信息對(duì)象頭和對(duì)象數(shù)據(jù)。對(duì)象頭包含了類型ID、路徑ID、字節(jié)大小等元信息。對(duì)象數(shù)據(jù)則是這個(gè)資源的具體內(nèi)容但其存儲(chǔ)格式并非原始數(shù)據(jù)如PNG像素而是遵循Unity內(nèi)部序列化規(guī)則的二進(jìn)制流。最關(guān)鍵的是類型樹(shù)TypeTree它定義了如何解析這個(gè)二進(jìn)制流將一串字節(jié)還原成具有具體字段如m_Name,m_Width的結(jié)構(gòu)化數(shù)據(jù)。沒(méi)有類型樹(shù)我們看到的只是一堆亂碼。UnityPy的核心工作就是模擬Unity編輯器的反序列化過(guò)程。它讀取文件根據(jù)文件頭判斷其類型AssetBundle, WebFile等然后解壓如果需要并解析出內(nèi)部的Asset容器。對(duì)于容器中的每個(gè)ObjectUnityPy利用內(nèi)置的或從游戲文件中提取的類型樹(shù)信息將二進(jìn)制數(shù)據(jù)“翻譯”成我們可以理解的Python字典或預(yù)定義的類實(shí)例。2.2 UnityPy的核心類與數(shù)據(jù)流理解了文件格式我們?cè)賮?lái)看UnityPy提供的幾個(gè)關(guān)鍵類它們構(gòu)成了數(shù)據(jù)處理的管道Environment這是入口點(diǎn)。當(dāng)你調(diào)用UnityPy.load(source)時(shí)就創(chuàng)建了一個(gè)環(huán)境。這個(gè)source可以是文件路徑、文件夾路徑、字節(jié)流bytes或io.BytesIO對(duì)象。Environment的智能之處在于能自動(dòng)檢測(cè)輸入源的類型。加載后所有解析出的資產(chǎn)都存放在env.files字典里而遍歷env.objects則可以訪問(wèn)到所有底層對(duì)象。Asset / SerializedFile代表一個(gè)加載的資產(chǎn)文件。它最重要的兩個(gè)屬性是.objects和.container。.objects是一個(gè)字典以對(duì)象唯一的path_id為鍵方便你通過(guò)ID精確查找。.container則是一個(gè)以資源在項(xiàng)目中的虛擬路徑為鍵的字典這對(duì)于想按照原始目錄結(jié)構(gòu)導(dǎo)出資源特別有用。ObjectReader這是每個(gè)具體資源對(duì)象如一張貼圖、一段音頻的包裝器。它本身并不包含解析后的數(shù)據(jù)只持有原始字節(jié)和類型信息。你必須調(diào)用其解析方法如.parse_as_object()才能獲得可操作的數(shù)據(jù)。這種“惰性加載”設(shè)計(jì)是為了性能考慮因?yàn)橐粋€(gè)資產(chǎn)文件可能包含成千上萬(wàn)個(gè)對(duì)象但通常你只關(guān)心其中幾種。數(shù)據(jù)流的典型路徑是加載文件 - 創(chuàng)建Environment - 獲取Asset - 遍歷ObjectReader - 解析為目標(biāo)對(duì)象 - 讀取或修改數(shù)據(jù) - 保存修改如果需要。整個(gè)流程清晰可控完全腳本化。注意UnityPy在處理某些大型或特殊壓縮格式的AssetBundle時(shí)可能會(huì)占用較多內(nèi)存。在處理未知來(lái)源的文件前建議先在小樣本上測(cè)試或者使用流式處理避免一次性加載所有數(shù)據(jù)導(dǎo)致內(nèi)存溢出。3. 從安裝到實(shí)戰(zhàn)一站式資產(chǎn)提取詳解理論說(shuō)得再多不如動(dòng)手一試。我們從一個(gè)完整的實(shí)戰(zhàn)例子開(kāi)始看看如何用UnityPy把游戲里的圖片資源“扒”出來(lái)。3.1 環(huán)境搭建與潛在坑位安裝UnityPy非常簡(jiǎn)單一行命令即可pip install UnityPy但這里有幾個(gè)新手常踩的坑我必須提前指出Python版本確保你的Python版本在3.8及以上。雖然文檔這么說(shuō)但我實(shí)測(cè)在某些Windows 10系統(tǒng)上使用Python 3.11或3.12的最新版本時(shí)可能會(huì)因?yàn)槟承〤擴(kuò)展依賴如brotli沒(méi)有預(yù)編譯的wheel包而導(dǎo)致安裝失敗。如果遇到pip安裝報(bào)錯(cuò)提到編譯失敗最穩(wěn)妥的解決方案是降級(jí)到Python 3.9或3.10這是大多數(shù)二進(jìn)制依賴兼容性最好的版本。Windows系統(tǒng)依賴在Windows上如果遇到運(yùn)行時(shí)錯(cuò)誤提示缺少VCRUNTIME140.dll等你需要安裝“Microsoft Visual C Redistributable”。去微軟官網(wǎng)下載最新版的安裝包即可這是很多Python科學(xué)計(jì)算庫(kù)的運(yùn)行時(shí)依賴?！办o默崩潰”問(wèn)題極少數(shù)情況下UnityPy的C語(yǔ)言類型樹(shù)讀取加速模塊可能會(huì)導(dǎo)致Python解釋器直接崩潰且無(wú)錯(cuò)誤信息。如果你在運(yùn)行腳本時(shí)遇到程序突然關(guān)閉可以嘗試禁用C加速改用純Python解析器速度會(huì)慢一些from UnityPy.helpers import TypeTreeHelper TypeTreeHelper.read_typetree_boost False把這行代碼放在你腳本的最開(kāi)頭導(dǎo)入U(xiǎn)nityPy之后。3.2 核心提取流程代碼拆解假設(shè)我們有一個(gè)游戲資源文件夾里面散落著很多.assets文件我們想批量提取出所有的Texture2D2D紋理和Sprite精靈通常是UI元素為PNG圖片。import os import UnityPy def extract_textures_and_sprites(source_dir, output_dir): 從源目錄遞歸遍歷所有文件提取紋理和精靈圖片。 Args: source_dir: 存放Unity資產(chǎn)文件(.assets, .bundle等)的根目錄。 output_dir: 圖片輸出目錄。 # 1. 遍歷源目錄 for root, dirs, files in os.walk(source_dir): for filename in files: filepath os.path.join(root, filename) # 2. 加載文件環(huán)境 # 這里用try包裹因?yàn)榉荱nity文件會(huì)加載失敗 try: env UnityPy.load(filepath) except Exception as e: print(f無(wú)法加載文件 {filepath}: {e}) continue # 跳過(guò)這個(gè)文件繼續(xù)下一個(gè) # 3. 遍歷環(huán)境中的所有對(duì)象 for obj in env.objects: # 4. 按類型篩選我們需要的對(duì)象 if obj.type.name in [Texture2D, Sprite]: # 5. 解析對(duì)象為可操作的類實(shí)例 data obj.parse_as_object() # 6. 準(zhǔn)備輸出路徑 # 使用對(duì)象的名稱作為文件名確保唯一性可以加上路徑ID # 注意對(duì)象名可能包含非法字符或?yàn)榭招枰謇?safe_name data.m_Name if data.m_Name else funnamed_{obj.path_id} # 替換路徑中的非法字符 safe_name .join(c for c in safe_name if c.isalnum() or c in ( , -, _)).rstrip() output_path os.path.join(output_dir, f{safe_name}.png) # 7. 處理重名文件如果同一個(gè)名字出現(xiàn)多次 counter 1 while os.path.exists(output_path): output_path os.path.join(output_dir, f{safe_name}_{counter}.png) counter 1 # 8. 保存圖片 # Texture2D和Sprite對(duì)象都有.image屬性它返回一個(gè)PIL.Image對(duì)象 try: data.image.save(output_path) print(f已保存: {output_path}) except AttributeError: # 有些Texture2D可能沒(méi)有有效的圖像數(shù)據(jù)如RenderTexture print(f警告: 對(duì)象 {safe_name} 無(wú)法導(dǎo)出為圖片可能不是常規(guī)紋理。) except Exception as e: print(f保存圖片 {output_path} 時(shí)出錯(cuò): {e}) # 使用示例 if __name__ __main__: source ./game_resources # 你的資源文件夾 output ./extracted_images # 輸出文件夾 os.makedirs(output, exist_okTrue) # 創(chuàng)建輸出目錄 extract_textures_and_sprites(source, output)這段代碼是一個(gè)基礎(chǔ)但功能完整的提取器。它有幾個(gè)關(guān)鍵點(diǎn)值得深入惰性解析與性能代碼在循環(huán)內(nèi)才調(diào)用obj.parse_as_object()。如果文件內(nèi)有上萬(wàn)個(gè)對(duì)象但只有幾十個(gè)是紋理這避免了不必要的解析開(kāi)銷。.type.name屬性這是ObjectReader對(duì)象的屬性直接告訴你這個(gè)對(duì)象的Unity類型是篩選的關(guān)鍵。data.image屬性這是UnityPy為Texture2D和Sprite類型提供的便捷屬性。它內(nèi)部處理了Unity紋理格式如RGBA32、DXT5到PIL標(biāo)準(zhǔn)RGB/RGBA圖像的轉(zhuǎn)換甚至為Sprite自動(dòng)合成了紋理圖集和Alpha通道省去了大量底層操作。錯(cuò)誤處理用try-except包裹加載和保存過(guò)程至關(guān)重要。游戲資源文件可能損壞或者包含一些特殊格式的紋理如壓縮紋理格式直接操作可能導(dǎo)致程序崩潰。3.3 高級(jí)提取保持原始目錄結(jié)構(gòu)上面的例子把所有圖片都扔到了一個(gè)文件夾里。但對(duì)于大型項(xiàng)目我們可能希望保持資源在Unity項(xiàng)目中的原始路徑結(jié)構(gòu)。這時(shí)就需要用到env.container。def extract_with_structure(source_dir, output_base_dir): for root, dirs, files in os.walk(source_dir): for filename in files: filepath os.path.join(root, filename) try: env UnityPy.load(filepath) except: continue # 遍歷容器它保存了路徑信息 for asset_path, obj in env.container.items(): if obj.type.name in [Texture2D, Sprite]: data obj.parse_as_object() # 基于asset_path構(gòu)建輸出路徑 # asset_path 可能像 assets/resources/ui/icon.png # 我們需要去掉可能的擴(kuò)展名換成.png full_output_path os.path.join(output_base_dir, asset_path) full_output_path os.path.splitext(full_output_path)[0] .png # 創(chuàng)建所需的目錄 os.makedirs(os.path.dirname(full_output_path), exist_okTrue) try: data.image.save(full_output_path) print(f按結(jié)構(gòu)保存: {full_output_path}) except Exception as e: print(f保存失敗 {asset_path}: {e})env.container是一個(gè)字典鍵是資源在AssetBundle或資源系統(tǒng)中的虛擬路徑。利用這個(gè)路徑我們可以完美復(fù)現(xiàn)項(xiàng)目的資源樹(shù)。這對(duì)于分析游戲資源依賴關(guān)系或者準(zhǔn)備重新導(dǎo)入U(xiǎn)nity編輯器進(jìn)行修改非常有幫助。實(shí)操心得在處理大量文件時(shí)尤其是從APK中解壓出來(lái)的成千上萬(wàn)個(gè)小型.assets文件頻繁的UnityPy.load()調(diào)用會(huì)成為性能瓶頸。一個(gè)優(yōu)化技巧是如果這些文件是獨(dú)立的Asset文件非Bundle可以考慮先將它們合并到一個(gè)列表里但要注意內(nèi)存消耗。更常見(jiàn)的做法是使用多進(jìn)程multiprocessing來(lái)并行處理多個(gè)文件但需要確保每個(gè)進(jìn)程有獨(dú)立的數(shù)據(jù)空間避免共享環(huán)境對(duì)象。4. 不止于提取資產(chǎn)的查看與編輯實(shí)戰(zhàn)提取資源只是第一步UnityPy更強(qiáng)大的能力在于“編輯”。這意味著我們可以修改游戲內(nèi)的數(shù)據(jù)再寫(xiě)回文件實(shí)現(xiàn)Mod制作或數(shù)據(jù)替換。4.1 如何查看與修改資產(chǎn)數(shù)據(jù)修改資產(chǎn)的核心在于ObjectReader.patch()方法。修改前你需要先獲取對(duì)象的當(dāng)前數(shù)據(jù)。有兩種主要方式解析為字典obj.parse_as_dict()。這會(huì)返回一個(gè)嵌套的字典完全反映了對(duì)象的類型樹(shù)結(jié)構(gòu)。修改字典的值然后調(diào)用obj.patch(modified_dict)即可。這種方式通用性強(qiáng)但需要你對(duì)類型樹(shù)結(jié)構(gòu)比較熟悉。解析為對(duì)象obj.parse_as_object()。這會(huì)返回一個(gè)UnityPy自動(dòng)生成的類實(shí)例如Texture2D,TextAsset其屬性對(duì)應(yīng)著Unity類的字段。直接修改實(shí)例的屬性然后調(diào)用obj.patch(modified_instance)。這種方式更直觀類似于操作一個(gè)普通的Python對(duì)象。示例批量重命名紋理def rename_textures_in_file(filepath, name_mapping): 修改一個(gè)資產(chǎn)文件中的紋理名稱。 Args: filepath: 資產(chǎn)文件路徑。 name_mapping: 一個(gè)字典鍵為舊名稱或部分名稱值為新名稱。 env UnityPy.load(filepath) modified False for obj in env.objects: if obj.type.name Texture2D: # 先快速讀取名稱避免不必要的完整解析 current_name obj.peek_name() if not current_name: continue # 檢查是否需要重命名 for old, new in name_mapping.items(): if old in current_name: # 解析完整對(duì)象 tex obj.parse_as_object() tex.m_Name current_name.replace(old, new) # 打補(bǔ)丁將修改寫(xiě)回ObjectReader obj.patch(tex) modified True print(f在 {filepath} 中將紋理 {current_name} 重命名為 {tex.m_Name}) break # 只替換一次 # 如果文件被修改了保存它 if modified: # env.file.save() 返回文件的字節(jié)數(shù)據(jù) new_data env.file.save() with open(filepath, wb) as f: f.write(new_data) print(f文件已保存: {filepath})obj.peek_name()是一個(gè)非常有用的優(yōu)化函數(shù)它只讀取對(duì)象頭中的名稱字段而不解析整個(gè)對(duì)象數(shù)據(jù)速度極快適合用于快速篩選。4.2 處理復(fù)雜類型MonoBehaviour與類型樹(shù)挑戰(zhàn)MonoBehaviour是Unity中用于掛載自定義腳本的組件游戲的核心邏輯和數(shù)據(jù)如角色屬性、關(guān)卡配置常存在這里。但提取和編輯MonoBehaviour是UnityPy中最有挑戰(zhàn)的部分因?yàn)樗臄?shù)據(jù)結(jié)構(gòu)是由游戲腳本定義的類型樹(shù)信息可能不包含在發(fā)布的資產(chǎn)文件中。情況一類型樹(shù)已包含在資產(chǎn)中。這是最簡(jiǎn)單的情況你可以像處理其他對(duì)象一樣解析它。import json for obj in env.objects: if obj.type.name MonoBehaviour: mb_data obj.parse_as_dict() # 解析為字典 # 現(xiàn)在mb_data是一個(gè)包含所有字段的字典 # 例如可能包含 playerHealth, maxScore 等自定義字段 print(json.dumps(mb_data, indent2, defaultstr)) # 使用defaultstr處理不可序列化對(duì)象 # 修改數(shù)據(jù) if playerHealth in mb_data: mb_data[playerHealth] 9999 # 修改生命值 obj.patch(mb_data) # 寫(xiě)回修改情況二類型樹(shù)缺失。對(duì)于使用IL2CPP等方式編譯的游戲MonoBehaviour的類型樹(shù)經(jīng)常是缺失的。直接解析會(huì)得到一堆難以理解的二進(jìn)制數(shù)據(jù)。這時(shí)就需要TypeTreeGenerator這個(gè)可選組件。安裝生成器pip install TypeTreeGeneratorAPI準(zhǔn)備游戲程序集你需要有游戲的托管程序集DLL文件。對(duì)于Mono后端游戲它們通常在游戲目錄的GameName_Data/Managed/文件夾下。對(duì)于IL2CPP你需要使用工具如Il2CppDumper從global-metadata.dat和游戲二進(jìn)制文件中生成“偽DLL”。在代碼中配置生成器import UnityPy from UnityPy.helpers.TypeTreeGenerator import TypeTreeGenerator # 1. 創(chuàng)建生成器并指定游戲使用的Unity版本非常重要 # 你可以從任意一個(gè)游戲資產(chǎn)對(duì)象中獲取env.objects[0].assets_file.unity_version unity_version 2021.3.20f1 generator TypeTreeGenerator(unity_version) # 2. 加載游戲程序集 # 方式A: 如果是Mono游戲直接指向Managed文件夾 game_managed_dir rD:\Steam\steamapps\common\MyGame\MyGame_Data\Managed generator.load_dll_folder(game_managed_dir) # 方式B: 如果是IL2CPP加載生成的偽DLL # generator.load_dll_folder(rpath\to\dump\DummyDll) # 3. 加載資產(chǎn)文件并將生成器賦值給環(huán)境 env UnityPy.load(some_asset.assets) env.typetree_generator generator # 關(guān)鍵步驟 # 4. 現(xiàn)在解析MonoBehaviour會(huì)自動(dòng)嘗試使用生成器 for obj in env.objects: if obj.type.name MonoBehaviour: # 如果類型樹(shù)缺失生成器會(huì)在后臺(tái)工作 instance obj.parse_as_object() # 此時(shí)instance可能是一個(gè)UnknownObject但其字段可以通過(guò)字典方式訪問(wèn) data_dict obj.parse_as_dict() # 或者解析為字典查看結(jié)構(gòu) print(data_dict.get(someCustomField)) **重要提示**TypeTreeGenerator不是萬(wàn)能的其準(zhǔn)確度取決于游戲程序集的完整性和Unity版本的匹配度。對(duì)于高度混淆或自定義序列化的游戲數(shù)據(jù)可能仍然無(wú)法正確解析。在實(shí)際操作中結(jié)合十六進(jìn)制查看器和動(dòng)態(tài)分析如使用dnSpy調(diào)試通常是必要的補(bǔ)充手段。 ### 4.3 其他常見(jiàn)資產(chǎn)類型的操作 * **TextAsset文本資產(chǎn)**常用于存儲(chǔ)配置表JSON、XML、Lua腳本、Shader代碼等。 python for obj in env.objects: if obj.type.name TextAsset: text_obj obj.parse_as_object() content text_obj.m_Script # 這是一個(gè)字符串 # 重要如果文件實(shí)際是二進(jìn)制數(shù)據(jù)如加密的配置需要用特定編碼讀取 # binary_content text_obj.m_Script.encode(utf-8, surrogateescape) # 修改文本內(nèi)容 if Difficulty in content: new_content content.replace(Difficulty 5, Difficulty 1) text_obj.m_Script new_content obj.patch(text_obj) * **AudioClip音頻剪輯**UnityPy可以將音頻樣本轉(zhuǎn)換為標(biāo)準(zhǔn)的WAV格式字節(jié)流。 python for obj in env.objects: if obj.type.name AudioClip: clip obj.parse_as_object() for sample_name, sample_data in clip.samples.items(): # sample_data 已經(jīng)是WAV格式的bytes with open(f{sample_name}.wav, wb) as f: f.write(sample_data) * **Mesh網(wǎng)格**可以導(dǎo)出為Wavefront .obj格式方便在3D軟件中查看。 python for obj in env.objects: if obj.type.name Mesh: mesh obj.parse_as_object() obj_str mesh.export() # 返回OBJ格式的字符串 with open(f{mesh.m_Name}.obj, w, newline) as f: f.write(obj_str) ## 5. 高級(jí)配置與疑難問(wèn)題排查 當(dāng)你的項(xiàng)目從簡(jiǎn)單提取走向復(fù)雜修改和批量處理時(shí)會(huì)遇到一些更深層次的問(wèn)題。UnityPy提供了一些配置接口來(lái)處理這些情況。 ### 5.1 處理特殊加密與壓縮 一些游戲特別是某些地區(qū)的版本可能會(huì)對(duì)AssetBundle進(jìn)行加密或使用非標(biāo)準(zhǔn)壓縮。 * **Unity中國(guó)版加密**一些中國(guó)版Unity引擎打包的AssetBundle有內(nèi)置加密。如果你有解密密鑰通常需要從游戲內(nèi)存或邏輯中分析獲取可以這樣設(shè)置 python import UnityPy # 假設(shè)你通過(guò)逆向得到了密鑰 DECRYPT_KEY byour-32-byte-key-here UnityPy.set_assetbundle_decrypt_key(DECRYPT_KEY) # 之后再load的AssetBundle就會(huì)嘗試用此密鑰解密 * **自定義壓縮算法**極少數(shù)游戲會(huì)使用Unity不支持的壓縮算法。你可以注冊(cè)自己的壓縮/解壓函數(shù)。 python from UnityPy.enums.BundleFile import CompressionFlags from UnityPy.helpers import CompressionHelper # 假設(shè)游戲使用了自定義的LZ4變種flag值為0x80假設(shè) CUSTOM_FLAG 0x80 def my_custom_decompress(data, uncompressed_size): # 實(shí)現(xiàn)你的解壓邏輯 # ... return decompressed_data def my_custom_compress(data): # 實(shí)現(xiàn)你的壓縮邏輯如果需要寫(xiě)回文件 # ... return compressed_data # 注冊(cè)到全局映射表 CompressionHelper.DECOMPRESSION_MAP[CUSTOM_FLAG] my_custom_decompress CompressionHelper.COMPRESSION_MAP[CUSTOM_FLAG] my_custom_compress 這需要你精確知道游戲使用的壓縮算法和其對(duì)應(yīng)的標(biāo)志位通常需要逆向工程分析。 ### 5.2 常見(jiàn)錯(cuò)誤與解決方案速查表 在實(shí)際操作中你大概率會(huì)遇到下面這些問(wèn)題。這里我整理了一個(gè)快速排查指南 | 問(wèn)題現(xiàn)象 | 可能原因 | 解決方案 | | :--- | :--- | :--- | | **導(dǎo)入U(xiǎn)nityPy時(shí)崩潰或無(wú)錯(cuò)誤退出** | C語(yǔ)言類型樹(shù)讀取器與當(dāng)前環(huán)境不兼容。 | 在腳本開(kāi)頭禁用C加速TypeTreeHelper.read_typetree_boost False | | **pip install UnityPy 失敗提示編譯錯(cuò)誤** | 缺少C編譯環(huán)境或Python版本太新。 | 1. 安裝Visual Studio Build Tools (Windows) 或 Xcode Command Line Tools (macOS)。br2. 更簡(jiǎn)單的方法降級(jí)Python到3.9或3.10。 | | **obj.parse_as_object() 返回 UnknownObject 或字段全是亂碼** | 1. 對(duì)象類型不被UnityPy內(nèi)置類支持。br2. (對(duì)于MonoBehaviour) 類型樹(shù)信息缺失。 | 1. 使用obj.parse_as_dict()查看原始字典結(jié)構(gòu)。br2. 安裝并使用TypeTreeGeneratorAPI并正確配置游戲程序集路徑。 | | **修改后的資產(chǎn)文件游戲無(wú)法讀取/崩潰** | 1. 修改破壞了數(shù)據(jù)的序列化結(jié)構(gòu)如數(shù)組長(zhǎng)度不對(duì)。br2. 修改了游戲代碼依賴的關(guān)鍵字段。br3. 保存時(shí)壓縮方式不匹配。 | 1. 確保patch的數(shù)據(jù)結(jié)構(gòu)與原始結(jié)構(gòu)完全一致。br2. 只修改你理解的數(shù)據(jù)字段避免改動(dòng)引用ID、類型標(biāo)識(shí)等元數(shù)據(jù)。br3. 使用env.file.save()保存它會(huì)保持原始的壓縮格式。 | | **處理大型Bundle文件內(nèi)存占用過(guò)高** | 一次性加載了整個(gè)Bundle到內(nèi)存。 | 如果只是提取部分資源考慮使用UnityPy.load的流模式并配合env.container進(jìn)行選擇性解析。對(duì)于超大型文件可能需要分塊處理或?qū)ふ移渌ぞ哌M(jìn)行預(yù)拆分。 | | **提取的圖片是純色如全紫** | 紋理使用了Unity不常見(jiàn)的壓縮格式如ASTC, ETC2而PIL或當(dāng)前環(huán)境不支持。 | UnityPy的.image屬性可能無(wú)法解碼所有格式。可以嘗試直接訪問(wèn)紋理的原始字節(jié)數(shù)據(jù)tex.image_data然后用其他專業(yè)圖像庫(kù)如astc-dec解碼。 | | **env.container 為空字典** | 加載的文件是一個(gè)普通的.assets文件SerializedFile而不是AssetBundle。AssetBundle才會(huì)維護(hù)路徑容器。 | 使用env.objects通過(guò)類型和ID來(lái)遍歷和篩選對(duì)象。 | ### 5.3 性能優(yōu)化與最佳實(shí)踐 1. **選擇性解析**始終使用obj.type.name和obj.peek_name()進(jìn)行過(guò)濾只在必要時(shí)調(diào)用parse_as_object/dict。 2. **批量操作與緩存**如果需要反復(fù)讀取同一批文件的相同類型對(duì)象可以考慮將解析后的數(shù)據(jù)緩存到內(nèi)存或本地文件如pickle避免重復(fù)解析。 3. **使用迭代器**env.objects本身是一個(gè)迭代器適合處理大量對(duì)象。避免先將其轉(zhuǎn)換為列表如list(env.objects)再遍歷除非你真的需要隨機(jī)訪問(wèn)。 4. **版本管理**如項(xiàng)目README所述UnityPy仍在活躍開(kāi)發(fā)中小版本x.y可能有破壞性更新。對(duì)于生產(chǎn)環(huán)境在requirements.txt或代碼中固定版本號(hào)如UnityPy1.9.6是明智之舉。 5. **備份原文件**在進(jìn)行任何寫(xiě)回操作env.file.save()之前**務(wù)必備份原始文件**。錯(cuò)誤的修改可能導(dǎo)致文件永久損壞。 ## 6. 項(xiàng)目實(shí)戰(zhàn)構(gòu)想從理論到創(chuàng)造 掌握了基礎(chǔ)操作和排錯(cuò)技巧后我們可以構(gòu)思一些更具體的項(xiàng)目看看UnityPy如何融入實(shí)際工作流。 **構(gòu)想一游戲本地化工具鏈** 1. **提取**編寫(xiě)腳本掃描游戲所有TextAsset和MonoBehaviour將包含文本的字段導(dǎo)出為JSON或CSV。 2. **翻譯**在表格中完成翻譯。 3. **注入**編寫(xiě)另一個(gè)腳本讀取翻譯好的表格找到對(duì)應(yīng)的游戲?qū)ο笫褂胮atch方法將原文替換為譯文。 4. **打包**將修改后的資產(chǎn)文件重新打包回游戲這可能涉及APK重簽名或Bundle更新。 **構(gòu)想二游戲資源分析與報(bào)告** 1. **資源普查**遍歷游戲所有資源統(tǒng)計(jì)各類資源紋理、音頻、網(wǎng)格的數(shù)量、尺寸、格式生成一份資源使用報(bào)告。 2. **依賴分析**通過(guò)分析MonoBehaviour中的引用關(guān)系或Prefab數(shù)據(jù)構(gòu)建資源引用圖找出未被使用的“垃圾資源”或關(guān)鍵資源。 3. **風(fēng)格提取**提取游戲所有UI紋理和字體分析其主色調(diào)、設(shè)計(jì)風(fēng)格用于制作風(fēng)格指南或輔助創(chuàng)作。 **構(gòu)想三自動(dòng)化Mod測(cè)試框架** 1. **模版化修改**為常見(jiàn)的修改如屬性調(diào)整、模型替換編寫(xiě)函數(shù)。 2. **批量應(yīng)用**將修改函數(shù)應(yīng)用到指定的游戲存檔或資源包上。 3. **快速驗(yàn)證**自動(dòng)啟動(dòng)游戲測(cè)試客戶端如果可能或驗(yàn)證生成的文件結(jié)構(gòu)是否正確。 在我自己的使用經(jīng)驗(yàn)里UnityPy最大的優(yōu)勢(shì)在于它將一個(gè)黑盒的專有格式變成了一個(gè)可以用Python生態(tài)如PIL處理圖像、pandas分析數(shù)據(jù)、Flask提供Web界面自由操作的開(kāi)放領(lǐng)域。它不是一個(gè)點(diǎn)擊即用的圖形化工具而是一個(gè)需要你動(dòng)手編程的“樂(lè)高積木”。這帶來(lái)了學(xué)習(xí)曲線但也帶來(lái)了無(wú)與倫比的靈活性和自動(dòng)化潛力。剛開(kāi)始你可能會(huì)被類型樹(shù)、路徑ID這些概念困擾但一旦理解了“環(huán)境-資產(chǎn)-對(duì)象-數(shù)據(jù)”這條主線并善用parse_as_dict()來(lái)探索未知結(jié)構(gòu)大部分障礙都能被攻克。記得游戲逆向和Mod制作社區(qū)是寶貴的資源遇到棘手問(wèn)題時(shí)去相關(guān)的論壇或Discord頻道看看往往能找到靈感或現(xiàn)成的解決方案。