/palworld-server-toolkit

PalWorld Server Toolkits - For Save file modify, list the players, repair sav file, etc...

Primary LanguagePythonMIT LicenseMIT

Palworld Server Toolkit

幻兽帕鲁服务端工具包

简体中文 | English

GitHub Repo stars   Python  

世界上最高速的帕鲁服务器存档编辑器, 1.9秒 打开对应转换时间 4分54秒 的约 5.1GB 的JSON。

  • 这个工具包可用于在 Palworld 世界间转移角色,允许朋友们将他们的角色转移到彼此的服务器上,而不会失去任何进度。

  • 亦可以用于编辑玩家所持有的帕鲁、参数、持有物品、金钱等等数据。

  • 亦可以移动玩家的公会、删除营地、删除玩家


GUI

直接运行

访问 Release Pages 下载运行即可。

手动安装

  1. Python 3.9或以上版本.

  2. 安装 pip 包管理器

    • For Linux users: python -m ensurepip --upgrade
    • For Windows users: py -m ensurepip --upgrade
  3. 安装包

    pip3 install palworld-server-toolkit
    
  4. 运行

    python3 -m palworld_server_toolkit.editor [options] <Level.sav>
    

使用源码前置安装需求

  1. Python 3.9或以上版本.

  2. 通过 git clone https://github.com/magicbear/palworld-server-toolkit.git 下载源码

  3. 执行 git submodule update --init --recursive

问题交流

QQ群 139107098


palworld-save-editor

清理捕捉日志,改名,合并不同服务器玩家,删除玩家,迁移坏档等工具包

Caution

⚠️ 此工具是实验性的。 小心数据丢失并 务必 进行备份。

选择的 Level.sav 需要在游戏原存档目录下、或者连同 Players 一起复制的完整存档、程序会对 Players 下的存档文件同时进行操作,否则可能损坏存档。

Warning

删除用户、删除营地、清理未引用的物品库均为测试功能,有导致服务端闪退可能性,请 务必 进行备份,如碰到问题请提交您的存档到Issues。

Note

未加-o参数默认保存文件为Level_fixed.sav

使用源码版本 以下命令 -m palworld_server_toolkit.editor 部份 修改为 palworld_server_toolkit/editor.py 运行即可

  • 使用GUI修改 Level.sav 文件 - python -i -m palworld_server_toolkit.editor -g -o Level.sav Level.sav

  • 修改 Level.sav 文件 - python -m palworld_server_toolkit.editor -i -o Level.sav Level.sav

    • ShowPlayers() - 列出玩家
    • FixDuplicateUser() - 删除多余用户数据
    • ShowGuild() - 列出公会及成员列表
    • BindGuildInstanceId(uid,instance_id) - 修改公会成员绑定ID
    • RenamePlayer(uid,new_name) - 修改玩家名字为 new_name
    • DeletePlayer(uid,InstanceId=None, dry_run=False) - 删除玩家数据 InstanceId: 删除指定InstanceId
    • DeleteGuild(group_id) - 删除公会
    • DeleteBaseCamp(base_id) - 删除基地
    • EditPlayer(uid) - 快速指定玩家数据至变量player
    • MoveToGuild(uid,guild_id) - 移动玩家至公会guild_id
    • OpenBackup(filename) - 打开备份Level.sav文件并指向变量backup_wsd
    • MigratePlayer(old_uid,new_uid) - 从old_uidnew_uid迁移玩家数据
    • CopyPlayer(old_uid,new_uid, backup_wsd) - 复制玩家数据 backup_wsd 为OpenBackup备份文件 wsd为当前主文件
    • BatchDeleteUnreferencedItemContainers() - 删除未引用的物品库
    • FixBrokenDamageRefItemContainer() - 删除损坏对象
    • FindInactivePlayer(day) - 找出天未上线的玩家
    • Save() - 保存修改并退出

操作示例

Important

以下操作均需先退出服务端

最后均为把 Level_fixed.sav 替换至 Level.sav 并启动服务端

跨服务器迁移玩家数据

  • 提前工作

    1. 复制旧服务器 Level.savSaveGames/0/<Server ID>/Old-Level.sav
    2. 复制旧服务器所有需迁移玩家 Players/xxxxxxxx000000000000000000000000.savSaveGames/0/<Server ID>/Players/xxxxxxxx000000000000000000000000.sav
  • GUI模式操作

    1. Source Player Data Source 选择 Backup File
    2. 点击 Open File 选择旧服务器存档 Old-Level.sav
    3. Source Player 选择要迁移的旧玩家
    4. Target Player 选择要被替换的玩家(如果目标玩家ID不变,可从Source Player拷贝UUID)
    5. 点击 Copy Player
    6. 点击 Save & Exit
    7. 替换文件 Level_fixed.savLevel.sav
  • 命令模式操作

    1. 使用编辑模式运行 python -i -m palworld_server_toolkit.editor Level.sav
    2. 使用以下命令 并所有需迁移玩家执行CopyPlayer

      ⚠️ UUID 可相同,数据自backup_wsd拷贝

      OpenBackup("Old-Level.sav")
      CopyPlayer("xxxxxxxx-0000-0000-0000-000000000000", "xxxxxxxx-0000-0000-0000-000000000000", backup_wsd)
      Save()
      
    3. (Optional) 最后删除旧 xxxxxxxx000000000000000000000001.sav,

服务器存档转本地

  • GUI模式操作

    1. Source Player 选择要迁移的旧玩家
    2. Target Player 输入 00000000-0000-0000-0000-000000000001
    3. 点击 Migrate Player
    4. 点击 Save & Exit
    5. 替换文件 Level_fixed.savLevel.sav

其他迁移示例

  • 本地存档迁移至服务器示例

    1. 复制本地 Level.savSaveGames/0/<Server ID>/Old-Level.sav

    本地存档通常在 C:\Users\<username>\AppData\Local\Pal\Saved\SaveGames\<SteamID>\<World Folder>

    1. 复制本地 Players/00000000000000000000000000000001.savSaveGames/0/<Server ID>/Players/00000000000000000000000000000001.sav
    2. 使用编辑模式运行 python -i -m palworld_server_toolkit.editor Level.sav
    3. 使用以下命令
      OpenBackup("Old-Level.sav")
      CopyPlayer("00000000-0000-0000-0000-000000000001", "xxxxxxxx-0000-0000-0000-000000000000", backup_wsd)
      Save()
      
    4. (Optional) 最后删除旧 00000000000000000000000000000001.savOld-Level.sav
  • 迁移用户示例

    1. 使用编辑模式运行 python -i -m palworld_server_toolkit.editor Level.sav
    2. 使用以下命令
      MigratePlayer("xxxxxxxx-0000-0000-0000-000000000000","yyyyyyyy-0000-0000-0000-000000000000")
      Save()
      
  • 清理7天未上线玩家

    1. 使用编辑模式运行 python -i -m palworld_server_toolkit.editor Level.sav
    2. 使用以下命令
      for player_uid in FindInactivePlayer(7): DeletePlayer(player_uid)
      Save()
      

palworld-player-list

usage: palworld-playey-list [-h] [--host HOST] [--port PORT] [--password PASSWORD] [filename]

用于列出服务器Players目录中的玩家名字,PlayerUId,Steam ID

positional arguments:
  filename              Filename of the player sav

options:
  -h, --help            show this help message and exit
  --host HOST, -H HOST  Host for PalWorld Server RCON
  --port PORT, -P PORT  PalWorld Server RCON Port
  --password PASSWORD, -p PASSWORD  RCON密码
  • 列出玩家 - 在工作目录 /PalSaved/SaveGames/0/<server id>/Players 中运行 python3 list.py
  • 玩家详细 - python3 list.py <PLAYER HEX UID>

palworld-server-taskset

把服务端绑定至CPU性能核 (Linux only)


FAQ

  • 复制玩家为将角色及其所有队伍和终端中的伙伴、角色身上的物品以及进度转移,但不会转移任何地图对象、原世界中箱子里的物品以及基地中工作的伙伴。(如果你想将它们一起转移,请将它们移动到身上/终端中)

  • 对于合作模式的存档,存档文件通常位于 %LocalAppData%\Pal\Saved\SaveGames<SteamID><世界文件夹>

  • 对于Xbox Game Pass玩家的存档,存档文件通常位于 C:\Users\<用户名>\AppData\Packages\ PocketpairInc.Palworld_ad4psfrxyesvt\SystemAppData\wgs

  • 对于服务器存档,请通过 Steam 进入服务器的文件位置。

  • 你需要至少 3 个文件来完成转移:源玩家角色存档文件(在 Players/中),源世界的 level.sav 文件,以及目标世界的 Level.sav 文件

  • 对于本地合作模式的存档,如果你是主机,角色文件始终是 000000...001.sav

  • 对于其他玩家的存档,只需知道他们的 ID 在不同世界间不会改变,因此他们在你的合作世界和服务器世界的角色文件名是相同的。

  • Windows 用户建议使用 Windows Terminal 取代 cmd,否则不显示色彩

  • 存档结构如下

    • 源世界
     SaveGames
     └── <steam-id>
         └── <source-world-id>
             ├── backup
             ├── Level.sav  ----------  <- The source world save-file
             ├── LevelMeta.sav
             ├── Players
             │   ├── 00000...0001.sav
             │   └── 12345...6789.sav   <- character save-file we want to transfer
             └── WorldOption.sav
    
    • 目标世界
     SaveGames
     └── <steam-id>
         └── <destination-world-id>
             ├── backup
             ├── Level.sav  ----------  <- The target world save-file
             ├── LevelMeta.sav
             ├── Players
             │   ├── 00000...0001.sav   <- the target player-placeholder save-file
             │   └── 98765...4321.sav
             └── WorldOption.sav
    

TODO

  • Cleanup the data on FoliageGridSaveDataMap

感谢