铺路机 2.1.0 - 存档修改与报告工具

创作者: TheSeraph

已更新:2024-02-19 05:47:17

26.5MB

关于此 MOD

可配置的《幻兽帕鲁》存档编辑器——主要目标是让你再也不必手动处理SAV文件。只需告诉工具你要改什么，剩下的交给它处理！该工具还会生成你的世界与玩家报告。

完全开源，代码托管于 Github： https://github.com/adefee/paver-palworld-save-editor

柏油路：A P阿尔世界 S安息艾迪托r
一个功能全面且可扩展的《幻兽帕鲁》存档编辑器与报告工具，适用于v0.1.2.0及更高版本。指向你的存档目录（即Level.sav所在位置），即可开始使用！

本项目的主要目标之一，是让用户无需手动编辑SAV或JSON文件、无需查找正确的嵌套键值，即可生成世界与玩家状态报告，并进行任意修改。因为一个错误的类型或数值就可能导致存档或服务器崩溃，所以我希望能降低操作的复杂性。此外，Paver秉持“安全优先”原则，仅在确认无错误时才会对SAV文件进行修改。

2024年2月24日更新 Paver 在《幻兽帕鲁》v0.1.4.0 版本中已趋于稳定。《夜莺》现已推出，我短期内不打算再回归《幻兽帕鲁》，因此请勿期待后续更新。我会尽量关注相关帖子并提供适当支持，但若您希望获取更新（目前阶段），欢迎自行分叉并添加内容 :)

v2+ 现已发布，大幅提升稳定性并支持处理大型存档文件。v2 版本还修复了 v1 中几乎所有已报告或已知的问题！

此外，我们已在规划并开发【铺设机】的UI界面！更多消息即将公布。核心稳定性问题基本解决后，接下来的更新将陆续带来众多新功能与优化内容。

有新的功能建议、优化想法或其他问题要反馈吗？加入Paver的Discord服务器

自 v2.1.0 版本起，本项目已进入“稳定”阶段，其核心安全目标已达成，并提供了比手动操作更简便的存档更新机制（诚然，config.json 有时难免让人头疼，但总好过在 SAV 文件里翻遍二十万行去改一个数值）。话虽如此，世上没有完美的程序，因此我始终会…… 建议在使用此工具前备份你的存档。

有问题？报错？有想法？ 加入Paver的Discord社区

请提供需要翻译的游戏文本内容。

核心特色：

当然，存档修改： 创建一个配置文件，指定存档目录路径和所需修改（针对世界或玩家），Paver便会自动执行！该配置大大简化了手动操作——例如调整玩家等级时，系统会自动计算并同步更新经验值。目前已经支持多种常见修改/应用场景，更多功能正在规划中（只是未能赶上初版发布）。
修改玩家外观： 没错——游戏里你无法改变外观，但用Paver就能做到！自由调整角色的体型、发型、头部、名称等更多内容（颜色修改功能将在下个版本更新中推出）。
内置模块化报告系统： 铺路者可选择以只读模式（或非只读模式）运行，并生成关于你的存档、玩家等内容的报告（未来将扩展更多项目）。报告内容采用模块化设计，可根据需要在配置文件中添加或移除。铺路者还能检测并报告你世界存档中缺失对应玩家存档文件或其他重要数据的情况。未来计划进一步增加对VAC封禁、过多影响性能的资源/物品/帕鲁等的监测报告。
增量更新日志： Paver 的报告包含变更日志，让你精确掌握每条更改的内容、时间及位置。
高度可自定义： 配置文件中最少只需一行指向存档目录的设定，但为了满足你的需求，Paver 提供了数十项可自定义选项（未来还会持续增加）。
自动存储为JSON格式（可选）铺路机使用 @cheahjs/幻兽帕鲁存档工具将存档转换为JSON，并可再转回。Paver提供保留SAV和JSON两种格式的选项，方便您验证修改、运行其他模组等。转换非必需：只要您已把SAV转为JSON，Paver同样可以处理！

作为可执行文件运行（Windows系统），或作为Node应用运行： 大多数用户通常将Paver作为可执行文件使用，但如需更高级的功能和更高的自由度，Paver本身也是基于NodeJS开发并可作为应用程序运行的，详情请参阅GitHub。

前置条件：
使用Paver不需要掌握Python等编程语言。以下要求为*依赖项* ——就像引擎之于汽车，它们是Paver运行的必需。正如你无需成为机械师就能开车从A点到B点，你也无须了解这些组件的工作原理或编程知识就能使用Paver——它们都属于“看不见的核心”。

@cheahjs/幻兽帕鲁存档工具以及Paver 需要Python 3.9或更高版本。
- Windows用户：你可以安装 Python 3.12 来自微软商店或出自 python.org
- 看看吧《幻兽帕鲁》存档工具使用说明更新与更多信息请访问；CheahJs的工具用于存档与JSON格式之间的相互转换。
- Paver 在将你的改动整合为统一存档文件时，会在部分环节调用 Python。
在存档转换过程中，Paver 会使用 Python 模块 "ijson"。Paver 将尝试自动安装该模块，但请注意以下几点：
- 如果你的存档文件已经是JSON格式，则不需要此操作。
- 若看到“ijson”相关错误，或报错提示关联“helpers/updatePlayersInLevelSav.py”，可自行安装“ijson”解决。只需打开命令行，输入“pip install ijson”并回车，然后重启Paver即可。

开始使用：启动铺路机！

安装所需的必要前置组件（参见上方说明）。
下载最新版本。大多数用户请直接获取zip压缩包，内含exe执行文件及辅助文件。下载后解压至任意目录即可。
创建配置文件，或运行一次Paver自动生成。该配置文件为JSON格式（通常与Paver程序置于同一目录，命名为"config.json"），用于指示Paver的具体操作内容与修改目标。后续版本可能会提供便捷界面，帮助您自动完成配置文件的设置。但目前仍需手动操作（不过相比直接修改，这仍然更为简便高效）。文件内容示例如下：
```
{ "gameSaveDirectoryPath": "C:\\path\\to\\your\\save\\directory" }
```
只有 `gameSaveDirectoryPath` 字段是必填的，其余字段均为可选。该字段既支持相对路径（如 `"./my-save"`），也支持绝对路径（如 `"C:\\my\\path"`），但请注意： 你需要转义你的反斜杠 - 因此，“C:\my\path”必须写为“C:\\my\path”。

高级：需要更改配置文件位置吗？
在命令中添加配置参数，即可指定其他配置文件路径或名称。例如：`paver.exe config=./my-config.json`。若希望从源代码运行Paver（比如在Node/Python环境下），同样可行！前往Paver的GitHub页面可了解更多。

现在运行 Paver（可执行程序）即可！

示例

配置示例

对单名玩家进行基础调整

给玩家"Lent"42点科技点数，并为其生命值增加10点属性点。同时，确保他的好友G勤练腿部——将他的腿部尺寸设为0.8，并更换其发型。

{
  "gameSaveDirectoryPath": "C:\\path\\to\\your\\save\\directory"
  "changesToMake": {
    "待修改内容"：
    "启用护栏"：true
    "玩家": [
      {
        "handle": "借出"
        "科技点数": 42
        "statusPoints": "属性点数"
          生命值：10
       }
       {
         "handle": "幽灵像素"
         "外观": {
           "legSize": 0.8
           "hairType": "type12"
         }
       }
     ]
  }
}

注意「enableGuardrails」选项。该选项默认开启，可防止误设数值（例如避免将腿长设为"fdjsklfajs"）。若你对自己的修改有把握，或想尝试超越游戏默认值的参数（比如升到100级？），只需将其设为关闭即可。

以上所有改动涉及的数值均对应存档文件中的深层嵌套键值，且常与其他多个数值关联—— 铺路机替你搞定这一切. 你根本不需要碰SAV或JSON文件，也无需操心要修改的字段具体嵌在哪一层键名下。

正在生成报告

默认情况下，Paver 会在 ./reports 目录下自动为你生成报告，其中包括世界数据的摘要、玩家分析，以及你尝试进行的所有修改记录（包括修改是否成功、失败，以及具体尝试修改的内容）。

不一定要做修改——你也可以选择让Paver仅生成报告。以下是一个启用了特定选项的示例：

{
  "gameSaveDirectoryPath": "C:\\path\\to\\your\\save\\directory"
  "reporting": "汇报中"
    "导出": true
    "./reports
    "showSummary": true
    "showPlayerData": true,
    "showCapturedPals": true,
    "showPlayerUnlockedRecipes": false,
  }
}

在上述案例中，我们展示了一些内容，但明确表示不希望将每位玩家已解锁的配方列表导出。由于仅指定了报告选项，上述操作不会对你的存档进行任何修改。

等级与名称更改

这里稍微有点复杂，但其实不难！先聊聊等级吧。请注意在《幻兽帕鲁》中，“等级”基本上只是个数字。你的总经验值也需要同步调整，否则系统会按你原来的等级计算后续经验。比如，把1级玩家改成40级，他确实是40级了，但获得经验时仍会按1级计算——这意味着从40升到41级所需的经验，和从1级升到40级是一样的！

这大概不是我们通常想要的，对吧？没关系—— 铺路机已为你计算好经验值！ 如果你设置了等级字段但未指定明确的经验值，Paver 会自动计算该等级应有的经验值并为你调整。

以下示例中，我们将Lent的名字改为Seraph，并将其等级设为40：

{
  "gameSaveDirectoryPath": "C:\\path\\to\\your\\save\\directory"
  "changesToMake": {
“待修改项”：
    "启用护栏"：true
    "玩家"：[
（注意：原文本为JSON结构中的键值对，将"players"翻译为游戏UI或系统文本中常见的"玩家"，保持JSON结构不变。）
      {
        "guid": "e1337m8e-0000-0000-0000-000000000000"
        "handle": "炽天使",
        "等级"：40
       }
     ]
  }
}

注意上方还有别的东西吗？ 我们也指定了玩家唯一的“guid”。 要更改玩家名称，必须指定GUID——这是为了确保在名称变更后，我们仍能有效追踪该玩家的其他修改记录。

玩家GUID是未大部分更改无需此道具，但修改名称时则必须使用。或针对存档或服务器中存在多个同名玩家的情况。若未提供GUID且发现多个同名玩家，则不会对其中任何一位进行修改，以防造成数据损坏。

不知道玩家GUID？ 至少运行一次Paver 它生成的报告将包含玩家的GUID！

配置选项

以下是 config.json 文件中当前所有可用选项的列表。除 "gameSaveDirectoryPath" 字段外，其他字段均为可选；下方显示的是（Palword 或 Paver 设定的）默认值。通常情况下，您无需使用这些选项，除非您希望将其修改为与下方默认值不同的内容。

以下是示例 config.json 配置文件，列出了所有可用选项；再次提醒，绝大多数选项均为非强制填写项。

写一份好文档需要时间，而且我白天还要上班 :) 每个选项的完整表格/概要会尽快推出！

{
  "gameSaveDirectoryPath": "C:\\你的存档目录路径",
  "savToJsonConversion": "存档转JSON转换"
    "启用"：true，
    "repoUrl": "https://github.com/cheahjs/palworld-save-tools.git"
    "relativeInstallPath": "./palworld存档工具-cheahjs"
    "convertFreshEveryRun": true,
    “cleanUpJsonAfterConversion”: true
  },
  "报告"
    "导出": true
    "./reports"
    "显示总结"：true
    "showPlayerData": true,
    "显示已捕获帕鲁": true
    "showPlayerUnlockedRecipes": true,
    "showPlayerAppearance": true,
    "showChangesMade": 是否显示改动内容
  }
  "changesToMake": {
"需调整内容"
    "启用护栏": true
    "world": { "soon": "基地、背包、帕鲁的改动及计划即将上线！" }
    "players": [
      {
        "guid": "e1337m8e-0000-0000-0000-000000000000"
        "handle": "借贷"
        "等级": 42
        "exp": 123456789, // 手动设定玩家拥有的经验值，或直接省略。
        "科技点数": 250
        "ancientTechPoints": 100,
        ```json
{
  "unlockedRecipes": [
    "解锁配方"
  ]
}
```
          工作台
          "短柄战斧·凡铁"
          "新手镐"
          "手持火把"
        ]
        "已解锁快速旅行点"： [
          "即将推出——快速旅行功能即将在此开放"
        看起来你提供的文本中没有包含具体需要翻译的内容。请将待翻译的游戏文本粘贴过来，我会按照要求进行专业本地化翻译。
        "countEffigiesFound": 0 // 你已收集的雕像点数
        "currentHp": 50000 // 当前生命值（未受加成的基础值）
        "maxHealth": 50000 // 最大生命值（基础值，未受加成前）
        "maxStamina": 50000 // 最大体力值（基础值，不含加成）
        "饥饿值": 100
        "san值": 100
        "isPlayer": true, // 是否为玩家？存档中保留此项，部分因为帕鲁也存储在同一位置。
        "workSpeed": 100 // 基础工作速度（未受加成前）
        "support": 100, // 暂时不知用途
        "unusedStatusPoint": 50000
        ```json
{
  "statusPoints": "属性点"
}
```
          "生命值": 0 // 当前加成到最大生命值的点数，每点增加100点生命上限。
          "体力": 0,   // 当前属性点数，影响最大体力值。每1点提升10体力。
          "攻击力": 0 // 当前攻击力点数。每点增加2点攻击力
          "负重": 0 // 当前负重属性点数，每点增加50负重上限
          "captureRate": 0,
          "workSpeed": 0 // 当前工作/制作速度点数，每点提升50速度
        }
        "appearance": { // 颜色支持将在下次更新中上线！
          "bodyType": "A型"
          "torsoSize": 0.5, // 躯干大小，0到1，越小越纤细，越大越魁梧
          "armSize": 0.5, // 手臂粗细，0到1之间
          "legize": 0.5, // 腿部大小，0到1之间，越小越细，越大越粗。
          "headType": "type1"
          "hairType": "type1"
          "eyeMaterialName": "类型001" // 眼睛类型，编号1-6
        },
（注：原文仅为符号“},”，可能为JSON或代码片段中断。根据游戏本地化规范，此处保持原样输出）
        "voiceId": 1 // 语音选择，1-3为传统女声，4-6为传统男声
       }
     ]
  }
}