告别存档丢失！用XGP-save-extractor实现《腐烂国度2》存档从XGP到Steam的无缝迁移
项目地址: https://gitcode.com/gh_mirrors/xg/XGP-save-extractor 你是否曾遇到这样的困境：在Xbox Game Pass (XGP) 上投入数百小时畅玩《腐烂国度2》(State of Decay 2)，却因订阅到期或想体验Steam版的社区功能，不得不面对存档无法迁移的难题？手动重建基地、重新培养角色、重复完成剧情任务——这些不仅浪费时间，更会消磨游戏热情。本文将详细介绍如何使用开源工具XGP-save-extractor，通过简单几步实现存档从XGP到Steam平台的完美迁移，让你无缝延续末日生存之旅。
读完本文后，你将掌握：
- XGP存档系统的底层存储原理
- 利用XGP-save-extractor提取《腐烂国度2》存档的完整流程
- 存档文件的校验与Steam平台导入方法
- 常见迁移问题的诊断与解决方案
- 自动化迁移脚本的编写技巧
XGP存档系统的技术解析
微软UWP应用的存档容器结构
XGP for PC游戏基于Universal Windows Platform (UWP) 架构，其存档文件采用特殊的容器格式存储在系统目录中。与传统PC游戏直接将存档保存为可识别的.sav文件不同，XGP游戏的存档被加密封装在多个GUID命名的二进制文件中，分散存储于以下路径：
%LOCALAPPDATA%\Packages\Microsoft.Dayton_8wekyb3d8bbwe\SystemAppData\wgs\
该目录下包含两类关键文件：
- 容器索引文件（containers.index）：记录存档元数据，包括文件名、创建时间、GUID映射关系
- 数据文件：以128位UUID命名的二进制文件，存储实际存档内容
《腐烂国度2》的存档特殊性
作为支持跨平台云同步的游戏，《腐烂国度2》的存档结构更为复杂：
- 采用"1容器多文件"（1cnf）存储模式，所有存档文件集中在单个容器内
- 文件名为内部路径格式（如
SaveSlot01/savegame），需剥离路径前缀并添加.sav扩展名 - 包含角色状态、基地设施、世界事件等多维度数据，单个存档文件通常超过50MB
点击查看《腐烂国度2》存档容器结构（JSON示例）
{
"name": "StateOfDecay2_Saves",
"number": 1,
"files": [
{
"name": "SaveSlot01/savegame",
"path": "C:\\Users\\User\\AppData\\Local\\Packages\\Microsoft.Dayton_8wekyb3d8bbwe\\SystemAppData\\wgs\\...\\GUID"
},
{
"name": "SaveSlot02/savegame",
"path": "C:\\Users\\User\\AppData\\Local\\Packages\\Microsoft.Dayton_8wekyb3d8bbwe\\SystemAppData\\wgs\\...\\GUID"
}
]
}
XGP-save-extractor工具的工作原理
XGP-save-extractor是一款用Python编写的开源工具，专为解析XGP存档容器格式设计。其核心功能通过以下模块实现：
工具架构与关键函数
核心处理流程分为四步：
- 游戏检测：通过
read_game_list()加载支持的游戏列表，确认《腐烂国度2》的包名Microsoft.Dayton_8wekyb3d8bbwe - 容器定位：调用
find_user_containers()扫描系统中的有效存档目录 - 索引解析：解析containers.index文件，提取文件名与GUID的映射关系
- 文件转换：应用
state-of-decay-2专用处理器，执行路径剥离和扩展名添加
与同类工具的对比优势
| 特性 | XGP-save-extractor | 手动导出工具 | 商业存档转换器 |
|---|---|---|---|
| 《腐烂国度2》支持 | ✅ 原生支持 | ❌ 需要手动处理 | ✅ 部分支持 |
| 云同步状态检测 | ✅ 自动检测 | ❌ 无此功能 | ⚠️ 有限支持 |
| 批量处理能力 | ✅ 多存档自动打包 | ❌ 单文件操作 | ✅ 付费功能 |
| 开源可审计 | ✅ MIT许可证 | ❌ 闭源 | ❌ 闭源 |
迁移前的环境准备
系统与软件要求
| 组件 | 最低要求 | 推荐配置 |
|---|---|---|
| 操作系统 | Windows 10 1903+ | Windows 11 22H2+ |
| Python环境 | Python 3.7 | Python 3.10+ |
| 磁盘空间 | 至少200MB空闲空间 | 500MB以上（含临时文件） |
| 权限要求 | 普通用户权限 | 管理员权限（解决文件锁定） |
前置工具安装
-
Python环境配置 从Python官网下载并安装3.10以上版本，安装时勾选"Add Python to PATH"选项。验证安装：
python --version # 应输出Python 3.10.x pip --version # 应输出pip 22.x以上 -
工具获取与依赖安装
# 克隆仓库 git clone https://gitcode.com/gh_mirrors/xg/XGP-save-extractor cd XGP-save-extractor # 安装依赖（实际无需额外依赖，标准库已足够） pip list # 检查是否已安装json、zipfile等标准模块 -
游戏存档准备
- 启动XGP版《腐烂国度2》，确保云同步完成（主菜单显示"同步完成"）
- 退出游戏及Xbox应用，避免存档文件被锁定
- 手动备份存档目录（可选但推荐）：
robocopy "%LOCALAPPDATA%\Packages\Microsoft.Dayton_8wekyb3d8bbwe\SystemAppData\wgs" "D:\SOD2_Backup" /E
完整迁移步骤
步骤1：提取XGP存档
-
运行提取工具 在XGP-save-extractor目录中打开命令提示符，执行主脚本：
python main.py -
工具执行流程 工具会自动完成以下操作：
- 读取
games.json识别已安装的《腐烂国度2》 - 定位用户存档目录（通常为
{UserID}_{TitleID}格式的子目录） - 解析containers.index文件，提取所有有效存档
- 生成ZIP压缩包，命名格式为
state_of_decay_2_{用户名}_{时间戳}.zip
- 读取
-
确认提取成功 成功执行后会显示类似以下输出：
Installed supported games: - State of Decay 2 Save files for user GamerTag123: - SaveSlot01.sav - SaveSlot02.sav Save files written to "state_of_decay_2_GamerTag123_2023-10-20_15_30_45.zip"
步骤2：验证存档文件
-
ZIP包结构检查 使用文件管理器打开生成的ZIP文件，确认结构如下：
state_of_decay_2_GamerTag123_2023-10-20_15_30_45.zip/ ├── SaveSlot01.sav ├── SaveSlot02.sav └── SaveSlot03.sav -
文件完整性校验 对每个
.sav文件执行大小检查：- 标准存档：30-80MB（取决于游戏进度）
- 过大文件（>100MB）：可能包含未清理的临时数据
- 过小文件（<10MB）：可能提取不完整，需重新运行工具
-
二进制签名验证 使用十六进制编辑器检查文件头部，有效的《腐烂国度2》存档应以
SOD2magic number开头：53 4F 44 32 00 01 00 00 00 02 00 00 00 03 00 00
步骤3：导入Steam版游戏
-
定位Steam存档目录 Steam版《腐烂国度2》的存档位置为：
%USERPROFILE%\Documents\StateOfDecay2\Saves\该目录下可能存在多个用户ID子目录（如
76561198012345678），需确认对应你的Steam用户ID。 -
存档文件放置 将提取的
.sav文件复制到目标目录，注意：- Steam版仅识别
SaveSlot01.sav至SaveSlot05.sav的文件名 - 若已有同名文件，建议重命名备份（如
SaveSlot01_OLD.sav） - 确保文件权限正确（右键→属性→解除锁定，若有）
- Steam版仅识别
-
验证导入结果 启动Steam版《腐烂国度2》，在"加载游戏"菜单中检查：
- 存档缩略图是否正确显示基地预览
- "上次保存时间"是否与XGP版一致
- 加载存档后确认角色状态、资源数量、任务进度无误
高级应用：自动化迁移脚本
对于需要频繁迁移存档的玩家，可创建批处理脚本实现一键操作。以下是一个PowerShell脚本示例：
<# SOD2_Save_Migrator.ps1 #>
# 配置参数
$EXTRACTOR_PATH = "D:\Tools\XGP-save-extractor"
$STEAM_SAVE_PATH = "$env:USERPROFILE\Documents\StateOfDecay2\Saves\76561198012345678"
$BACKUP_PATH = "D:\SOD2_Backups"
# 1. 运行提取工具
Set-Location $EXTRACTOR_PATH
python main.py
# 2. 查找最新生成的ZIP文件
$latestZip = Get-ChildItem -Path . -Filter "state_of_decay_2_*.zip" |
Sort-Object LastWriteTime -Descending |
Select-Object -First 1
if (-not $latestZip) {
Write-Error "未找到提取的存档文件"
exit 1
}
# 3. 解压存档
$tempDir = New-TemporaryFile | Remove-Item -ErrorAction SilentlyContinue -Force | New-Item -ItemType Directory
Expand-Archive -Path $latestZip.FullName -DestinationPath $tempDir.FullName -Force
# 4. 复制到Steam存档目录
Copy-Item -Path "$tempDir\*.sav" -Destination $STEAM_SAVE_PATH -Force
# 5. 创建备份
$backupName = "SOD2_Backup_$(Get-Date -Format 'yyyyMMdd_HHmmss').zip"
Compress-Archive -Path "$STEAM_SAVE_PATH\*.sav" -DestinationPath "$BACKUP_PATH\$backupName"
# 6. 清理与报告
Remove-Item $tempDir -Recurse -Force
Write-Host "迁移完成！最新备份: $backupName"
pause
使用方法：
- 替换脚本中的路径和Steam用户ID
- 保存为
SOD2_Save_Migrator.ps1 - 右键→"使用PowerShell运行"
常见问题与解决方案
提取阶段问题
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 工具提示"找不到游戏" | games.json缺失或路径错误 | 确认工具目录下存在games.json，或重新克隆仓库 |
| 存档文件为空 | Xbox云同步未完成 | 启动XGP版游戏至主菜单，等待"同步完成"提示后退出 |
| 权限被拒绝 | 文件被Xbox服务锁定 | 重启电脑或结束XboxAppServices进程 |
| 提取的ZIP为空 | 多用户目录混淆 | 手动指定用户目录：python main.py --user-dir {UserID} |
导入阶段问题
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| Steam版不显示存档 | 文件路径错误或权限问题 | 检查用户ID目录是否正确，文件是否解除锁定 |
| 存档加载后崩溃 | 文件损坏或版本不兼容 | 验证游戏文件完整性（Steam→属性→本地文件） |
| 进度不匹配 | 提取的不是最新存档 | 确认XGP版云同步完成，重新提取 |
| 存档名称乱码 | 字符编码问题 | 使用工具最新版本，或手动重命名为纯英文 |
技术支持资源
- 官方仓库：工具源代码与更新日志
- 社区论坛：Steam社区指南
- 故障排查：提交issue时请包含
containers.index和工具输出日志
总结与展望
XGP-save-extractor作为一款专注于解决跨平台存档迁移痛点的开源工具，不仅为《腐烂国度2》玩家提供了切实帮助，其模块化设计也为其他XGP游戏的存档处理提供了参考。随着微软对UWP架构的持续优化，未来可能会出现更多自动化迁移方案，但目前而言，本工具仍是最可靠、最透明的选择。
对于《腐烂国度2》玩家，掌握存档迁移技能不仅能保障游戏进度安全，更能让你自由选择最适合自己的游戏平台。希望本文提供的方法能让你在末日生存之路上走得更远，建立起坚不可摧的生存基地！
如果你觉得本教程有帮助，请在项目仓库中点赞支持开发者，或分享给其他需要的玩家。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
