5分钟跑通 uesave 免费教程快速读写虚幻引擎存档的完整指南【免费下载链接】uesaveRust library and CLI to read and write Unreal Engine save files项目地址: https://gitcode.com/gh_mirrors/ue/uesaveuesave是一个免费开源的 Rust 工具集核心库 命令行程序专门用来读取和写入虚幻引擎Unreal Engine的二进制存档文件即GVAS格式的.sav文件并能在二进制与人类可读的JSON之间无损往返转换。无论你是想备份和微调游戏进度的普通玩家、乐于破解存档结构的进阶玩家还是想集成存档解析能力的开发者几分钟内就能跑通它的主流程。 能力速览uesave 能做什么功能说明典型场景to-json把二进制.sav转成格式化 JSON查看存档内容、手动编辑前的准备from-json把编辑后的 JSON 转回二进制.sav修改完成写回游戏可识别的格式edit调用系统编辑器原地编辑存档JSON 视图一步完成「转码 → 编辑 → 转回」test-resave重新读入并写回一份存档校验字节级一致编辑前确认工具对该游戏存档无损-t类型提示手动指定 Map/Set 内结构体类型自动推测失败时强制指定字段类型Rust 库 / WASM API以Save::read/save.write直接编程集成到自己的工具或 Web 前端中 快速上手一键安装与版本验证确认 Rust 环境项目要求 stable 工具链见rust-toolchain.tomlrustc --version安装命令行工具仓库根目录是 workspace需指定uesave_cli包cargo install --git https://gitcode.com/gh_mirrors/ue/uesave --package uesave_cli验证安装看到版本号即成功uesave --version uesave --help--help会列出to-json、from-json、edit、test-resave四个子命令接下来用它们走完主流程。 核心工作流二进制 ↔ JSON 往返转换整个流程遵循「输入 → 处理 → 输出」三段式输入一个游戏二进制存档SaveGame.sav处理to-json解析 GVAS 结构并输出带缩进的 JSONuesave to-json -i SaveGame.sav -o SaveGame.json编辑用任意文本编辑器修改 JSON只动你认识的数值字段输出from-json写回二进制存档uesave from-json -i SaveGame.json -o SaveGame_new.sav维度转换前.sav转换后.json形态字节流肉眼不可读结构化键值对可搜索可折叠查看工具十六进制编辑器任意文本编辑器修改成本极高易损坏低只改目标字段即可风险点手工写坏即失效误删结构会导致回写失败小技巧-i/-o都支持-表示标准输入/输出可以灵活拼接管道解析时若出现无法识别的字段会以Raw形式保留并打印警告加--no-warn可静默。 实战演练用《深岩银河》存档走完整流程仓库根目录自带一份 Deep Rock Galactic 测试存档drg-save-test.sav直接拿它练手最方便。备份原件任何修改的第一步cp drg-save-test.sav drg-backup.sav转成 JSONuesave to-json -i drg-save-test.sav -o drg-save.json查看并修改目标字段。打开drg-save.json你会看到形如这样的结构字段名因游戏而异此处仅为示意{ root: { properties: { NumberOfGamesPlayed: 2173, // 已游玩局数Int 属性 Credits: 50000, // 货币类数值Int 属性 UnlockedItemSkins: { // Map 属性键为皮肤 GUID Key: Guid, Value: Struct } } } }✅ 推荐修改纯数值Int / Float / Bool。⚠️ 谨慎修改数组、Map/Set 的键值对。❌ 避免修改Raw字段与不认识的类型标记。写回二进制uesave from-json -i drg-save.json -o drg-modified.sav无损验证把存档重新读入再写回逐字节比对uesave test-resave drg-backup.sav终端输出Resave successful说明该存档格式被完全支持可以放心编辑若失败可加--debug生成input.sav/output.sav便于排查。⚡ 效率进阶批量转换、类型提示与 API 集成批量转换脚本把整个目录的存档一次性转成 JSON#!/bin/bash for save in *.sav; do echo 处理: $save uesave to-json -i $save -o ${save%.sav}.json || echo 跳过: $save done手动指定字段类型存档本身缺少 Map/Set 内部结构体的类型信息uesave 会尝试推测推测失败时可用-t强制指定例如uesave to-json -i SaveGame.sav -o SaveGame.json \ -t .UnlockedItemSkins.SkinsGuid \ -t .EnemiesKilled.ValueStruct作为 Rust 库调用参考uesave/examples/read-save/main.rsuse uesave::Save; let save Save::read(mut std::fs::File::open(drg-save-test.sav)?)?; match save.root.properties[NumberOfGamesPlayed] { Property::Int(value) println!(已游玩 {value} 局), _ {} }Web 集成仓库中的uesave_wasm提供了sav_to_json/json_to_sav两个 WASM 函数配合web/目录的 Svelte 前端即可在浏览器里完成同样的转换。️ 避坑与安全编辑存档前检查清单操作前请逐项确认✅ 已备份原始.sav复制一份再动手✅ 已用test-resave确认工具对该存档无损⚠️ 只修改自己理解的字段保留其余结构原样❌ 不要改动Raw字段、GUID 结构和整体键层级常见问题问题 → 解决方案问题解析时报结构类型警告或字段变成 Raw方案存档缺少 Map/Set 内部类型信息。用-t按路径指定类型如-t .SomeMap.KeyGuid或加--no-warn忽略告警继续转换。问题写回的.sav游戏读不了方案先对原始存档跑一次test-resave若报Resave did not match说明该游戏存档存在未完全支持的结构加--debug导出前后文件对比定位。问题JSON 太大难以编辑方案借助编辑器的折叠与搜索功能只修改目标字段批量操作优先写脚本而非手工改动。️ 源码地图核心模块一览uesave/ ├── uesave/ # 核心 Rust 库解析 序列化 │ ├── src/ │ │ ├── archive.rs # GVAS 读写 traitArchiveReader / ArchiveWriter │ │ ├── serialization.rs # 具体结构体的 JSON 反序列化实现 │ │ ├── context.rs # 类型上下文、Schema 记录 │ │ ├── error.rs # 错误类型定义 │ │ └── lib.rs # Save 主类型、属性/标签解析核心逻辑 │ └── examples/read-save/main.rs # 最小的读档示例 ├── uesave_cli/ # 命令行工具二进制名 uesave │ └── src/main.rs # to-json / from-json / edit / test-resave ├── uesave_wasm/ # WASM 封装供 Web 前端调用 └── web/ # Svelte Vite 图形界面lib.rs是整个项目的核心Save::read负责把字节流解析为属性树save.write负责按 GVAS 规范写回uesave_cli/src/main.rs则把这些能力包装成四枚命令。⏱️ 结尾速查30 秒回顾uesave 把「二进制存档 ↔ JSON」的往返做到了命令级简单掌握下面这条口诀即可上手1 备份 → 2 转换to-json→ 3 编辑 → 4 回写from-json→ 5 验证test-resave最后三条重要提醒永远先备份修改从小范围数值开始遇到解析警告先用-t指定类型不要硬猜回写后用test-resave验证无损再交给游戏读取适用Rust stable 工具链uesave 当前版本 0.7.1。对 Deep Rock Galactic 存档已完整支持读写其他虚幻引擎 GVAS 存档建议先运行 test-resave 验证兼容性。【免费下载链接】uesaveRust library and CLI to read and write Unreal Engine save files项目地址: https://gitcode.com/gh_mirrors/ue/uesave创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考