使用uesave工具解密与编辑Unreal Engine游戏存档：从AES密钥到JSON修改全指南

发布时间：2026/7/10 6:30:45

1. 项目概述：为什么你需要一个存档编辑工具？

在游戏开发与玩家社区中，Unreal Engine（虚幻引擎）以其强大的表现力和灵活性，成为了众多3A大作和独立精品的选择。然而，一个长久以来困扰着玩家和模组开发者的“黑盒”，就是游戏的存档文件。这些以.sav为后缀的文件，承载着你数十甚至上百小时的游戏进度、角色属性、物品库存和世界状态。当它们因为游戏更新、系统崩溃或单纯的坏档而无法读取时，那种挫败感是毁灭性的。或者，当你只是想调整一下背包里的资源数量，体验一下不同的游戏节奏，却苦于没有内置的控制台或修改器时，那种无力感同样强烈。

uesave，正是为了打破这个“黑盒”而生的利器。它不是一个拥有华丽界面的软件，而是一个命令行工具，一个纯粹的“解码器”和“编辑器”。它的核心价值在于，能够解析Unreal Engine序列化存档的底层二进制格式，将其转换为人类可读的JSON文本，让你可以像编辑文本文档一样，精确地修改存档中的每一个数值、每一个字符串、每一个布尔值。修改完成后，它又能将JSON重新打包回游戏可以识别的.sav文件。这个过程，相当于给了你一把打开游戏数据保险库的万能钥匙。

对于普通玩家，这意味着你可以修复损坏的存档、备份关键进度，或者进行一些不影响游戏平衡的便利性调整（比如补充因BUG丢失的任务物品）。对于模组制作者和游戏研究者，这更是一个不可或缺的分析工具，可以深入理解游戏数据的存储结构，为制作复杂的游戏修改模组（Mod）提供数据层面的支持。接下来，我将以一个拥有十多年经验的游戏数据解构者的视角，带你从零开始，彻底掌握uesave这把利器。

2. 核心原理：Unreal Engine存档的“锁”与“钥匙”

要熟练使用uesave，不能只停留在“怎么用”的层面，必须理解它“为什么能这么用”。这涉及到Unreal Engine存档文件的核心机制。

2.1 存档文件的结构：不止是数据，更是蓝图

一个Unreal Engine的.sav文件，远非简单的“属性-值”列表。它是一个复杂的、序列化的对象网络。想象一下，你的游戏角色（一个Character对象）身上挂载着库存组件（InventoryComponent）、技能组件（SkillComponent），库存里有一把剑（Weapon对象），剑上附有魔法效果（Effect对象）。在存档时，引擎会遍历所有这些对象以及它们之间的引用关系，将它们“拍扁”成一连串的字节流，并写入文件。

这个字节流包含了：

文件头（Header）：包含魔数、版本号、保存时间等元信息。
数据体（Data）：核心的游戏状态数据，以Unreal Engine特有的序列化格式存储。
压缩与加密：很多游戏会对数据体进行压缩（如GZip）和加密，以防止玩家轻易窥探或修改。加密是uesave需要解决的首要问题。

2.2 加密与AES密钥：找到正确的“钥匙”

Unreal Engine存档常用的加密算法是AES（高级加密标准）。AES加密需要一个“密钥”（Key）。这个密钥通常是一个32字节（256位）的十六进制字符串。游戏在保存时用这个密钥加密数据，读取时再用同一个密钥解密。

uesave工作的前提，就是获取到目标游戏所使用的AES密钥。没有密钥，你看到的加密存档就是一堆乱码。那么，密钥从哪里来？

游戏社区共享：对于热门游戏，其AES密钥往往早已被社区大神通过逆向工程找到，并公开分享。这是最常见、最安全的来源。
自行分析：通过分析游戏二进制文件（如.exe或.dll），在内存中搜索密钥常量或密钥生成算法。这需要较高的逆向工程技能。
引擎版本通用密钥：某些旧版本或特定配置的Unreal Engine项目可能使用了默认或通用的密钥。

重要提示：使用uesave修改存档应仅限于个人单机游戏体验或模组开发。在多人游戏或任何有反作弊系统的在线服务中使用，极有可能导致账号被封禁。请务必遵守游戏用户协议，并尊重开发者的劳动成果。

2.3 JSON作为中间层：人类与机器的翻译官

uesave的核心工作流程是一个“解密-翻译-修改-回译-加密”的过程。其中，JSON扮演了至关重要的“翻译官”角色。

解密：使用正确的AES密钥，将加密的.sav文件解密。
反序列化：将Unreal Engine的二进制序列化数据，解析成内存中的数据结构。
转换为JSON：将这些数据结构转换成标准化的JSON文本文件。JSON的树形结构和键值对格式，完美契合了游戏对象的层级和属性关系，变得一目了然。
编辑JSON：你可以用任何文本编辑器（如VS Code、Notepad++）修改这个JSON文件。
序列化：uesave读取修改后的JSON，将其转换回Unreal Engine的内存数据结构。
加密与保存：最后，用相同的AES密钥将数据加密，并写回新的.sav文件。

这个过程，赋予了玩家前所未有的控制精度。你可以修改一个NPC的健康值，调整一件装备的耐久度，甚至改变一个任务的目标状态——只要你能在JSON结构中找到对应的数据节点。

3. 环境准备与工具获取：搭建你的编辑工作台

工欲善其事，必先利其器。使用uesave不需要复杂的IDE，但需要准备好正确的工具链和文件。

3.1 获取uesave可执行文件

uesave本身是一个用Rust语言编写的开源项目，源代码托管在GitHub上。对于大多数用户，我们不需要自己编译，直接下载预编译好的二进制文件即可。

访问发布页面：在GitHub上搜索uesave项目，进入其Releases页面。
选择对应版本：根据你的操作系统下载对应的文件。通常是：
- Windows:uesave-x86_64-pc-windows-msvc.zip
- Linux:uesave-x86_64-unknown-linux-gnu.tar.gz
- macOS:uesave-x86_64-apple-darwin.zip
解压文件：将下载的压缩包解压，你会得到一个名为uesave（Windows下为uesave.exe）的可执行文件。为了方便，我建议你将其放置在一个单独的文件夹中，例如D:\GameTools\uesave\。

3.2 确定目标游戏的AES密钥

这是最关键的一步。你需要为目标游戏找到正确的AES-256密钥。密钥是一个64位的十六进制字符串（因为256位 = 32字节 = 64个十六进制字符）。

查找途径：

游戏模组（Mod）社区：如Nexus Mods、GameBanana。在对应游戏的Mod或工具分类下搜索“save editor”、“save decrypt”等关键词，相关帖子或Mod描述中常会提供密钥。
技术论坛：如Reddit的r/technicaltft、r/ReverseEngineering子版块，或专门的游戏逆向论坛。
开源项目：一些开源的游戏存档编辑工具或库（如SaveGame相关的项目）的代码或文档中可能会列出已知游戏的密钥。

假设我们以一款虚构的热门UE游戏《幻境之旅》为例，其社区公布的AES密钥为：4E6F7468616E6742757420616E204578616D706C65204B65792121212121212121

实操心得：务必核对密钥的完整性和正确性。一个错误的字符会导致解密失败。最好从多个来源交叉验证。将常用游戏的密钥保存在一个安全的文本文件中是个好习惯。

3.3 定位游戏存档目录

不同游戏、不同平台（Steam、Epic、本地）的存档位置各不相同。常见位置有：

Windows (Steam):C:\Users\[你的用户名]\AppData\Local\[游戏名]\Saved\SaveGames\
Windows (Epic):C:\Users\[你的用户名]\AppData\Local\[游戏名]\Saved\SaveGames\或位于Epic安装目录下的云存档文件夹。
Linux (Steam):~/.local/share/Steam/steamapps/compatdata/[游戏AppID]/pfx/drive_c/users/steamuser/AppData/Local/[游戏名]/Saved/SaveGames/（通过Proton运行时）
你也可以直接在文件资源管理器中搜索*.sav文件，并查看其路径。

找到你的目标存档文件，例如PlayerSave.sav，将其复制一份到你的uesave工作目录（如D:\GameTools\uesave\）中进行操作。永远不要直接编辑原始存档！

4. 完整实操流程：从解密到回写

现在，让我们进入实战环节。打开命令行终端（Windows的CMD或PowerShell，Linux/macOS的Terminal），导航到你的uesave工作目录。

4.1 第一步：解密存档为JSON

基础命令格式如下：

uesave decrypt -i <输入.sav文件> -o <输出.json文件> --aes-key <AES密钥>

以我们的《幻境之旅》为例：

uesave decrypt -i PlayerSave.sav -o PlayerSave.json --aes-key 4E6F7468616E6742757420616E204578616D706C65204B65792121212121212121

执行后，你会看到类似输出：

Successfully decrypted ‘PlayerSave.sav‘ to ‘PlayerSave.json‘.

此时，当前目录下会生成一个PlayerSave.json文件。用文本编辑器打开它，你会看到一个结构庞大但清晰的JSON对象。

4.2 第二步：分析与编辑JSON存档

打开JSON文件，初始可能会被其体积和深度吓到。使用支持JSON折叠的编辑器（如VS Code）可以极大提升浏览效率。

JSON结构导航技巧：

搜索是关键：使用编辑器的查找功能（Ctrl+F）。如果你想修改金币，就搜索“Gold”、“Money”、“Currency”。想修改角色等级，就搜索“Level”、“XP”、“Experience”。

理解层级：JSON是嵌套的。一个典型的属性路径可能看起来像：

{ "root": { "properties": { "SaveData": { "value": { "PlayerState": { "value": { "Health": {"value": 85.0}, "MaxHealth": {"value": 100.0}, "Inventory": { "value": { "Items": { "value": [ {"value": {"ItemId": "Potion_Health", "Count": {"value": 5}}}, {"value": {"ItemId": "Sword_Iron", "Durability": {"value": 75.2}}} ] } } } } } } } } } }

注意"value"键频繁出现，这是Unreal Engine序列化格式在JSON中的体现。

数据类型：留意数值（85.0）、字符串（"Potion_Health"）、布尔值（true/false）和数组（[...]）。修改时必须保持数据类型一致。

编辑示例：修改金币和生命值假设我们找到路径如下：

"PlayerCurrency": { "value": { "Gold": {"value": 150} } }, "PlayerStats": { "value": { "CurrentHealth": {"value": 65.0}, "MaxHealth": {"value": 120.0} } }

我们可以将Gold修改为99999，将CurrentHealth修改为120.0（回满血）。保存你的JSON文件。

4.3 第三步：将JSON加密回SAV文件

编辑完成后，使用encrypt命令将其打包回去。

uesave encrypt -i PlayerSave_modified.json -o PlayerSave_modified.sav --aes-key <相同的AES密钥>

重要！确保使用的AES密钥与解密时完全一致。

4.4 第四步：替换与测试

将新生成的PlayerSave_modified.sav重命名为游戏原存档的文件名（如PlayerSave.sav）。
备份你的原始存档到其他位置。
将修改后的存档文件覆盖回游戏的存档目录。
启动游戏，加载存档，检查修改是否生效。

5. 高级技巧与深度应用

掌握了基础操作后，你可以探索更强大的功能。

5.1 批量操作与自动化

如果你需要频繁修改多个存档或进行复杂修改，手动编辑JSON效率低下。此时可以借助脚本（Python、PowerShell等）。

示例：使用Python脚本批量增加所有存档的金币

import json import os import subprocess AES_KEY = “4E6F7468616E6742757420616E204578616D706C65204B65792121212121212121“ UESAVE_PATH = r“D:\GameTools\uesave\uesave.exe“ SAVE_DIR = r“C:\Games\幻境之旅\Saves“ for filename in os.listdir(SAVE_DIR): if filename.endswith(“.sav“): sav_path = os.path.join(SAVE_DIR, filename) json_path = sav_path.replace(“.sav“, “.json“) modified_json_path = sav_path.replace(“.sav“, “_mod.json“) modified_sav_path = sav_path.replace(“.sav“, “_modified.sav“) # 1. 解密 subprocess.run([UESAVE_PATH, “decrypt“, “-i“, sav_path, “-o“, json_path, “--aes-key“, AES_KEY]) # 2. 修改JSON with open(json_path, ‘r‘, encoding=‘utf-8‘) as f: data = json.load(f) # 假设金币路径，这里需要你根据实际JSON结构调整 data[“root“][“properties“][“SaveData“][“value“][“PlayerCurrency“][“value“][“Gold“][“value“] += 10000 with open(modified_json_path, ‘w‘, encoding=‘utf-8‘) as f: json.dump(data, f, indent=2) # 3. 加密 subprocess.run([UESAVE_PATH, “encrypt“, “-i“, modified_json_path, “-o“, modified_sav_path, “--aes-key“, AES_KEY]) print(f“Processed: {filename}“)

这个脚本自动完成了解密、修改、加密的全过程。注意：路径和JSON结构需要你根据实际情况精确调整。

5.2 处理复杂数据类型：数组与对象引用

游戏存档中经常包含物品栏（数组）、任务列表（数组）、装备槽（对象）等。

修改数组中的特定物品：你需要定位到数组，然后通过索引或遍历查找特定ItemId再进行修改。
处理对象引用：Unreal Engine存档中，对象间可能通过唯一ID（如PersistentId）相互引用。修改时需要保持引用关系的一致性，否则可能导致游戏崩溃或逻辑错误。除非你非常清楚在做什么，否则不要轻易改动这些ID字段。

5.3 使用jq命令行工具辅助分析

在Linux/macOS或Windows的WSL环境下，jq是一个处理JSON的神器。你可以用它快速过滤和查询存档内容。

例如，提取所有物品ID和数量：

jq ‘.root.properties.SaveData.value.PlayerInventory.value.Items.value[].value | {id: .ItemId.value, count: .Count.value}‘ PlayerSave.json

6. 常见问题排查与避坑指南

在实际操作中，你肯定会遇到各种问题。以下是我踩过坑后总结的速查表。

问题现象	可能原因	解决方案
解密失败，提示“Invalid AES key”或乱码	1. AES密钥错误。 2. 存档文件已损坏。 3. 游戏使用了非标准加密或压缩。	1. 反复核对密钥，确保64位十六进制字符无误，无多余空格。 2. 尝试用备份的原版存档。 3. 查看游戏社区是否有特殊说明，或尝试其他工具（如`SavReader`）先解包。
加密后的存档游戏无法识别	1. JSON格式在编辑过程中被破坏（如缺少逗号、引号）。 2. 修改了关键的结构或数据类型（如将数字改成字符串）。 3. 使用的`uesave`版本与游戏引擎版本不兼容。	1. 使用在线JSON验证工具（如JSONLint）检查编辑后的JSON文件。 2. 回退修改，确保只改动`“value“`字段内的内容，保持外部结构不变。 3. 尝试`uesave`的不同发布版本。
游戏加载修改存档后崩溃	1. 修改了引擎内部对象或关键引用ID。 2. 数值超出合理范围（如将生命值设为负数或极大值）。 3. 存档版本与游戏版本不匹配（游戏更新后）。	1. 避免修改你不理解的、名称古怪的对象（如带`“_“`前缀的）。只修改明确的游戏数据属性。 2. 将数值修改在游戏设计可能允许的范围内。 3. 确保游戏版本未更新，或等待社区更新AES密钥和工具。
找不到想修改的属性	1. 属性名称与想象的不同（如“Money” vs “Gold” vs “Currency”）。 2. 属性嵌套在很深的层级或被折叠。 3. 该数据可能存储在另一个系统文件或云端。	1. 用更广泛的关键词搜索，或参考该游戏已有的模组、修改教程来了解数据结构。 2. 在编辑器中展开所有JSON节点，仔细浏览。 3. 对于某些在线功能强的游戏，部分数据可能无法通过本地存档修改。
修改无效	1. 修改了错误的JSON节点（可能有多处类似名称）。 2. 游戏在加载时从其他来源（如服务器、配置文件）覆盖了存档数据。 3. 需要修改多个关联属性才能生效（如改了当前生命值，但没改最大生命值标志位）。	1. 确认你修改的节点路径唯一且正确。可以尝试修改一个非常显眼的属性（如角色名）来测试整个流程。 2. 单机游戏通常没问题。对于有在线验证的，本地修改可能无效。 3. 观察游戏逻辑，进行关联修改。