XGP-save-extractor：如何破解Xbox Game Pass存档加密，实现60+款游戏跨平台迁移？

XGP-save-extractor：如何破解Xbox Game Pass存档加密，实现60+款游戏跨平台迁移？

【免费下载链接】XGP-save-extractorPython script to extract savefiles out of Xbox Game Pass for PC games项目地址: https://gitcode.com/gh_mirrors/xg/XGP-save-extractor

在Xbox Game Pass（XGP）生态中，玩家面临一个棘手的技术难题：微软采用特殊的加密存储机制，将所有游戏存档封装在神秘的"wgs"文件夹中，文件名经过随机化处理，使得存档备份和跨平台迁移几乎不可能。XGP-save-extractor项目应运而生，通过Python脚本技术，成功破解了这一技术壁垒，为60多款热门游戏提供了存档提取解决方案。

技术挑战：XGP存档系统的三重加密迷宫

微软为XGP PC版游戏设计的存档系统采用了多层保护机制，形成了技术上的"黑匣子"。首先，所有存档文件都被放置在标准化的Windows应用包路径下：%LOCALAPPDATA%\Packages\，但每个游戏都有独特的包名格式，如F024294D.50755C2F12831_8fty0by30jkny这样的随机字符串。其次，存档数据被封装在"SystemAppData/wgs"目录中，文件名使用GUID格式，完全无法直观识别。最后，容器索引文件采用二进制格式存储，包含复杂的文件时间戳和UTF-16编码字符串。

这种设计虽然增强了安全性，却给玩家带来了巨大不便。想象一下，你在《怪物猎人：崛起》中投入了数百小时的游戏进度，却因为存档无法备份而面临丢失风险；或者你想从XGP版迁移到Steam版继续游戏，却发现存档格式完全不兼容。这正是XGP-save-extractor项目要解决的核心问题。

逆向工程：解密微软的存档容器格式

项目团队通过逆向工程分析，成功破解了XGP存档的容器格式。核心发现来自于对containers.index文件的深入解析，这个二进制文件包含了存档容器的完整元数据信息。

def read_user_containers(user_wgs_dir: Path) -> Tuple[str, List[Dict[str, Any]]]: containers_dir = user_wgs_dir containers_idx_path = containers_dir / "containers.index" with containers_idx_path.open("rb") as f: f.read(4) # 未知头部 container_count = struct.unpack("<i", f.read(4))[0] pkg_display_name = read_utf16_str(f) store_pkg_name = read_utf16_str(f).split("!")[0] creation_date = read_filetime(f)

代码展示了如何解析容器索引文件的关键步骤。每个容器都包含一个GUID标识符、创建时间戳和文件列表。项目实现了多种处理器（handler）来应对不同游戏的存档格式：

• 1c1f模式：一个容器对应一个文件，适用于《原子之心》、《Celeste》等游戏
• 1cnf模式：一个容器包含多个文件，适用于《Doom Eternal》等游戏
• 1cnf-folder模式：容器代表文件夹结构，适用于需要目录组织的游戏
• 特殊处理器：针对《Control》、《Starfield》等游戏的独特格式定制

智能识别：自动检测已安装游戏和用户存档

项目实现了智能的游戏检测系统，能够自动扫描系统并识别已安装的XGP游戏。通过分析Windows注册表和Package文件夹结构，脚本可以精确找到每个游戏的存档位置。

def discover_games(supported_games: Dict[str, Any]) -> List[str]: found_games = [] for pkg_name in supported_games.keys(): pkg_path = packages_root / pkg_name if pkg_path.exists(): found_games.append(pkg_name) return found_games

更令人印象深刻的是用户识别功能。项目能够读取Xbox Live的用户信息，将十六进制的用户ID转换为实际的玩家Gamertag，确保存档提取时能够正确关联到对应的用户账户。

实际应用：从技术实现到玩家价值

XGP-save-extractor的实际应用场景非常广泛。对于《怪物猎人：崛起》玩家，这意味着可以将XGP版的数百小时游戏进度迁移到Steam平台继续冒险。对于《Starfield》玩家，可以安全备份在浩瀚宇宙中的探索记录。项目目前支持60多款热门游戏，包括：

• ✅已确认可用的游戏：《原子之心》、《Control》、《最终幻想XV》、《Forza Horizon 5》、《Hades》、《Hi-Fi RUSH》、《Persona 5 Royal》、《Starfield》等
• ❔待确认的游戏：《Celeste》、《Chained Echoes》、《Octopath Traveller》等
• ⚠️不兼容的游戏：《A Plague Tale: Requiem》、《ARK: Survival Ascended》、《死亡之门》等

技术实现细节：多格式处理器架构

项目的核心在于灵活的多格式处理器架构。每个游戏都可以配置不同的处理器和参数，以适应其独特的存档格式。

{ "name": "Atomic Heart", "package": "FocusHomeInteractiveSA.579645D26CFD_4hny5m903y3g0", "handler": "1c1f", "handler_args": { "suffix": ".sav" } }

games.json配置文件定义了每个游戏的处理规则。处理器系统支持多种参数配置，如文件后缀名、特殊格式转换等，确保了高度的可扩展性。

使用指南：三步完成存档提取

1. 下载与运行：从项目仓库获取最新版本的可执行文件或直接运行Python脚本
2. 自动检测：脚本会自动扫描系统中已安装的XGP游戏
3. 存档提取：为每个检测到的游戏创建包含所有存档文件的ZIP包

# 克隆项目 git clone https://gitcode.com/gh_mirrors/xg/XGP-save-extractor # 运行提取脚本 cd XGP-save-extractor python main.py

脚本会输出类似以下的信息：

Installed supported games: - Atomic Heart Save files for user Player123: - savegame.sav Save files written to "atomic_heart_Player123_2024-01-15_14_30_45.zip"

技术优势与社区贡献

XGP-save-extractor项目的技术优势在于其轻量级、跨平台的设计理念。纯Python实现确保了良好的兼容性，不需要复杂的依赖环境。项目采用开源协作模式，社区贡献者可以轻松添加对新游戏的支持。

项目的成功也得益于社区的力量。从最初的容器格式发现到后续的游戏支持扩展，都体现了开源协作的价值。特别感谢@snoozbuster在容器格式解析方面的开创性工作，以及所有为项目贡献新游戏支持的开发者。

未来展望：技术挑战与扩展方向

尽管项目已经取得了显著成果，但仍面临一些技术挑战。部分游戏由于使用了完全不同的存档格式而暂时无法支持，如《A Plague Tale: Requiem》和《Yakuza: Like a Dragon》。这些游戏需要更深入的反向工程分析。

未来发展方向包括：

• 增加更多游戏的支持
• 改进错误处理和用户界面
• 添加存档导入功能（从Steam/Epic导入到XGP）
• 开发图形化界面工具

结论：打破平台壁垒的技术创新

XGP-save-extractor项目代表了玩家社区对数字版权和游戏数据自主权的追求。通过技术手段破解微软的存档加密系统，项目不仅解决了实际问题，更体现了开源精神的力量。对于技术开发者和游戏玩家来说，这个项目展示了如何通过逆向工程和社区协作，克服商业平台的技术限制，实现真正的数据自主。

在游戏存档管理这个细分领域，XGP-save-extractor填补了重要的技术空白，为XGP玩家提供了与Steam、Epic等平台同等的存档管理能力。随着更多游戏的加入和支持，项目的价值将持续增长，成为XGP生态中不可或缺的工具之一。

【免费下载链接】XGP-save-extractorPython script to extract savefiles out of Xbox Game Pass for PC games项目地址: https://gitcode.com/gh_mirrors/xg/XGP-save-extractor