幻兽帕鲁存档转换工具 palworld-save-tools：5分钟把 Level.sav 变成可编辑 JSON

【免费下载链接】palworld-save-toolsTools for converting Palworld .sav files to JSON and back项目地址: https://gitcode.com/gh_mirrors/pa/palworld-save-tools

深夜两点，你终于刷到一只理想词条的帕鲁，却发现它等级低得可怜；想给背包塞一组帕鲁球，用记事本打开 .sav 却只看到满屏乱码。这正是palworld-save-tools要解决的问题——这是一款专业的幻兽帕鲁存档转换工具，能把游戏二进制存档 .sav 转成可读的 JSON，修改后再原样转回，全程 SAV→JSON→SAV 逐字节一致，转换过程中不会丢任何数据。

一、先看清它到底能解析什么

这个工具的价值在于"真正懂《幻兽帕鲁》"：它针对游戏特有的数据结构做了深度解析，而不是像通用 Unreal 存档工具那样只给你一堆看不懂的二进制字段。

简单说：角色、物品、帕鲁、基地、公会这五类玩家最想动的东西，它都帮你解开了。

二、装好环境，两条命令即刻可用

安装前先确认你的机器满足两个条件：

• Python 3.9 或更高版本（终端执行python --version自查）
• 建议 64 位 Python，处理大存档时内存更从容

安装方式任选其一，推荐直接装成命令行工具：

pip install palworld-save-tools

想自己看源码、跑测试，也可以克隆仓库到本地：

git clone https://gitcode.com/gh_mirrors/pa/palworld-save-tools cd palworld-save-tools pip install .

装完终端里就多了一条palworld-save-tools命令，接下来进入正题。

三、实战：5 分钟改出你想要的存档

下面以"把角色等级提上去，并给背包增加一组帕鲁球"为例，完整走一遍流程。

第 1 步：先备份，再动手

复制一份原始存档到别的目录，比如Level.sav.bak。这一步是底线，改坏了随时能退回来。

第 2 步：找到你的存档文件

• Windows Steam 版：%LOCALAPPDATA%\Pal\Saved\SaveGames\<SteamID>\<SaveID>\
• 专用服务器：在你配置的存档目录中查找

核心文件就是其中的Level.sav，它承载了绝大部分世界数据。

第 3 步：SAV 转 JSON

在终端执行：

palworld-save-tools convert Level.sav --to-json

稍等片刻，目录下会出现Level.sav.json。转换出的文件可能很大（几十到几百 MB 很常见），记得用 VS Code 或 JetBrains 系编辑器打开，别用记事本。

⚠️ 小提醒：转换过程比较吃内存。如果报内存不足，跳到第四节的"选择性解析"。

第 4 步：定位并修改目标数据

打开 JSON 后，用编辑器的全局搜索（Ctrl+Shift+F）查找你的角色名，就能定位到CharacterSaveParameterMap下对应的角色对象。在这里你可以：

1. 找到等级相关字段，把数值改成你想要的等级
2. 找到经验值、技能点字段，一并调整
3. 同理搜索物品名，在ItemContainerSaveData里调整帕鲁球的数量

改完记得保存。如果数据太多不好手改，也可以写个小脚本批量处理：

import json with open("Level.sav.json", encoding="utf-8") as f: data = json.load(f) # 在这里实现你的修改逻辑： # 1. 遍历 CharacterSaveParameterMap 定位目标角色 # 2. 调整等级、经验等字段 # 3. 在 ItemContainerSaveData 中增减物品数量 with open("Level.sav.json", "w", encoding="utf-8") as f: json.dump(data, f, ensure_ascii=False)

💡 原则：一次只改少量字段，改完立刻转回测试，出问题好定位。

第 5 步：JSON 转回 SAV 并验证

palworld-save-tools convert Level.sav.json --from-json

转换会重新生成Level.sav。把它放回存档目录覆盖原文件（备份还在），启动游戏，进档查看效果。

四、进阶技巧与常见报错排查

选择性解析：大存档不再爆内存

只解析你关心的数据结构，其他一概跳过，速度能快一半以上：

palworld-save-tools convert Level.sav --to-json \ --custom-properties ".worldSaveData.CharacterSaveParameterMap.Value.RawData,.worldSaveData.ItemContainerSaveData.Value.RawData"

其他实用参数

• --minify-json：输出压缩版 JSON，方便程序二次读取
• --convert-nan-to-null：把特殊浮点值 NaN/Inf 转成 null（注意会丢失信息）
• --force：输出文件已存在时跳过确认，脚本化必加

常见报错速查表

三条保命建议

1. 永远保留备份，转换前复制一份是铁律
2. 小步修改 + 及时验证，别一次性改几十处
3. 尽量在单人档操作，联机环境慎用修改，尊重他人游戏体验

五、轻量原理：数据是怎么"变魔法"的

理解数据流转能帮你少踩坑。整个流程只有四步：

1. Level.sav是经过压缩的二进制存档，工具先用palsav.py解压
2. 解压后得到 Unreal 引擎标准的 GVAS 文件，由gvas.py负责读写
3. 再结合paltypes.py里定义的数据结构映射，把二进制字段翻译成可读 JSON
4. 反向转换就是上述流程的逆过程：JSON 打包回 GVAS，再压缩成 SAV

关键点在于第 3 步的映射表——这就是它比通用工具强的地方：它知道每个字节段代表"等级"还是"帕鲁球数量"，你改 JSON 时自然一目了然。

六、生态与延伸资源

围绕这个工具已经形成了一套小生态，值得你按需探索：

• PalEdit：图形化帕鲁编辑器，不想碰命令行时用
• palworld-server-tool：服务器管理工具，集成存档解析，可远程管理
• palworld-server-toolkit：存档批量处理工具集
• 仓库内部源码：palworld_save_tools/rawdata/下按数据结构拆分的解析模块，是学习数据格式的最佳教材
• Windows 便捷入口：convenience_tools/convert.cmd，直接把 .sav 拖上去就能转换

想深入了解数据结构，读paltypes.py的属性映射表和rawdata/目录下的解析器，比看任何文档都直观。

七、现在就去动手

先复制一份Level.sav备份，然后执行palworld-save-tools convert Level.sav --to-json，看看你的存档到底藏着多少秘密。等你第一次把角色等级改上去、回游戏看到生效的瞬间，你会明白：备份在手，帕鲁我有。你的游戏体验，从这一刻起由你说了算。

【免费下载链接】palworld-save-toolsTools for converting Palworld .sav files to JSON and back项目地址: https://gitcode.com/gh_mirrors/pa/palworld-save-tools