幻兽帕鲁存档编辑器：Paver v2.1.0 (报告与修改工具)
工具功能介绍
Paver 是一款功能全面且可扩展的幻兽帕鲁存档编辑器及报告工具，旨在支持幻兽帕鲁 v0.1.2.0 及更高版本。 此工具完全开源。 Paver 的主要目标之一是让用户能够方便地生成关于其游戏世界和玩家状态的报告，并根据需要进行修改，而无需直接接触复杂的 SAV 存档文件或 JSON 数据，从而降低因错误修改存档而导致损坏的风险。 Paver 以“安全第一”为核心理念运作，仅在确认无误时才对存档文件进行更改。
主要特性包括：
- 存档编辑： 通过编辑配置文件，用户可以修改世界及玩家数据。Paver 会自动处理许多手动修改时繁琐的细节，例如调整玩家等级时，会自动计算并调整相应的经验值。 支持多种常见的修改用例，并计划加入更多功能。
- 修改玩家外观： 游戏内无法更改角色外观？Paver 可以！支持修改玩家的体型、发型、头部、角色名称等。 （v2.1.0版本后计划加入颜色修改功能 ）。
- 内置模块化报告系统： Paver 可以选择以只读模式运行（或在修改同时），生成关于您的存档、玩家数据等的详细报告。 报告内容可根据需求在配置文件中定制。 Paver 还能检测并报告存档中玩家数据丢失或其他重要数据异常的情况。
- 增量式更改日志： Paver 生成的报告中包含详细的更改日志，让您清楚了解何时、何处以及对哪些内容进行了修改。
- 高度可定制： 核心功能仅需在配置文件中指定存档路径即可，同时提供数十种选项以满足用户的个性化需求。
- SAV <> JSON 自动转换 (可选)： Paver 使用名为“@cheahjs/palworld-save-tools”的第三方工具来完成存档文件 (SAV) 与 JSON 格式之间的相互转换。 Paver 允许用户选择保留转换后的 SAV 和 JSON 文件，便于校验更改或配合其他MOD使用。 如果您的存档已是 JSON 格式，Paver 也可以直接处理。
- 多种运行方式： 对于 Windows 用户，Paver 提供了可执行文件 (.exe)。对于高级用户，也可以作为 NodeJS 应用程序运行以获得更多控制权。
- </INDENT]
重要状态说明
- 作者在2024年2月24日的更新中表示，Paver 对于当时的幻兽帕鲁 v0.1.4.0 版本是稳定的。
- 然而，作者当时也表明，由于转向其他游戏（Nightingale），短期内没有计划为Paver提供进一步的功能更新。 作者会尝试在合理范围内提供支持，但用户应知晓此工具的后续开发和维护可能已暂停。 </INDENT]
前置需求 (重要！)
要成功运行 Paver 工具，您的电脑需要满足以下特定的软件环境要求，请仔细阅读：
- Python 3.9 或更高版本：
[*]Paver 及其依赖的存档转换组件都需要 Python 运行环境。Python 是一种广泛应用的编程语言，用户需要自行从 Python 官方网站等渠道获取并正确安装与配置。
- 核心存档转换工具 (palworld-save-tools by cheahjs)：
[*]Paver 依赖一个名为“palworld-save-tools”（由 cheahjs 开发）的第三方开源工具来进行幻兽帕鲁存档文件 (SAV) 与 JSON 数据格式之间的关键转换操作。 Paver 的文档通常会包含如何配置或自动管理此工具的说明。确保此工具能够正常工作是 Paver 运行的基础。
- ijson (Python 模块)：
作者提示：您无需了解 Python 编程即可使用 Paver。上述依赖项如同汽车的引擎，是工具运行所必需的组件，用户只需确保它们已正确安装。
[*]在进行存档转换（特别是将大型JSON文件转换回SAV）的过程中，Paver 会使用到一个名为“ijson”的 Python 模块。 Paver 会尝试自动为用户安装此模块。
[*]如果您的存档文件已是 JSON 格式，则可能不需要此步骤。
[*]如果在运行 Paver 时遇到关于“ijson”的错误，或者与“helpers/updatePlayersInLevelSav.py”相关的错误，您可以尝试手动安装“ijson”模块。 通常，您可以在系统的命令行/终端中执行 <span>pip install ijson</span> 命令来安装，然后重新运行 Paver。
安装与使用指南
- 【！！！极端重要！！！】在进行任何操作之前，请务必完整备份您的幻兽帕鲁游戏存档！ 以防万一出现任何意外情况导致存档损坏。
- 下载 Paver 工具包： 从MOD来源处下载最新版本的 Paver 工具（通常是一个名为 <span>paver-vX.X.X.zip</span> 的压缩文件，其中包含 <span>Paver.exe</span> 可执行程序及一些辅助文件）。
- 解压工具包： 将下载的 <span>.zip</span> 压缩文件解压到您电脑硬盘上的任意 удобное (convenient/suitable) 位置。
- 配置 <span>config.json</span> 文件：
- Paver 的所有操作都通过一个名为 config.json 的文本文件进行配置。此文件应与 Paver.exe 主程序放置在同一目录下。如果您在解压后没有找到此文件，可以尝试先运行一次 Paver.exe，它可能会自动生成一个配置模板。
- 核心配置项： <span>config.json</span> 文件中唯一必须填写的配置项是 <span>"gameSaveDirectoryPath"</span>。 您需要在此项中准确指定您的幻兽帕鲁存档所在的文件夹路径 (即包含 <span>Level.sav</span> 文件的那个目录)。
- 存档路径示例 (Steam版典型路径，具体请以您电脑为准)：
代码：
C:\Users\您的Windows用户名\AppData\Local\Pal\Saved\SaveGames\一长串数字和字母组合的文件夹ID - 路径格式注意：在 <span>config.json</span> 文件中填写路径时，所有的反斜杠 <span>\</span> 必须进行转义，即写成双反斜杠 <span>\\</span>。 例如，C:\MyPath 应写作 C:\\MyPath。
- 进行存档编辑与操作：
- 所有具体的存档修改（如更改玩家等级 、经验值 、科技点 、属性点 、外观参数 等）以及报告生成选项 ，都是通过编辑 config.json 文件中相应的参数来实现的。您可以参照作者提供的示例或完整配置选项列表来按需修改。
- <span>enableGuardrails</span> (安全防护) 选项： 此选项默认为 <span>true</span> (开启)，有助于防止用户设置无效或可能导致问题的数值（例如，将腿部大小设为文本）。 如果您确信自己的修改无误，或者希望尝试超出游戏默认范围的数值（如设定超过100级），可以将此选项设为 <span>false</span>，但请注意相关风险。
- 玩家GUID (全局唯一标识符)： 在修改玩家名称，或者当服务器/存档中存在同名玩家时，为了精确定位目标玩家，您需要在 <span>config.json</span> 中提供该玩家的GUID。 如果不提供GUID且遇到重名玩家，Paver为安全起见可能不会执行修改。
- 如何获取玩家GUID？ 首次成功运行Paver（即使只生成报告），其生成的报告文件中通常会包含您存档内所有玩家的GUID信息。
- 运行 Paver： 配置好 <span>config.json</span> 文件后，双击运行 <span>Paver.exe</span> (或其他平台的主程序文件)。Paver 将会读取配置文件并根据您的设定开始执行任务（如转换存档、应用修改、生成报告等）。 </INDENT]
MOD文件下载说明
paver-v2.1.0.zip
版本：2.1.0描述：此为Paver存档修改与报告工具的v2.1.0版本。根据作者说明，此版本是一个相对稳定的版本，在发布时用户报告中无重大功能性问题。它旨在提供一个比手动编辑更安全、更便捷的存档修改方式。
</INDENT]
模组来自NexusMods
