PalWorld Server Toolkit 使用指南

PalWorld Server Toolkit 使用指南

1. 项目介绍

PalWorld Server Toolkit 是一个开源项目，旨在为 PalWorld 游戏服务器提供一系列工具，帮助玩家和服务器管理员修改存档文件、管理玩家数据、修复存档文件等问题。该工具包提供了图形界面和命令行界面，方便用户进行操作。

2. 项目快速启动

环境准备

• Python 3.9 或更高版本
• Windows 用户可以从 Microsoft Store 下载 Python 3.12 或从 python.org 安装
• Linux 用户可以使用 python -m ensurepip --upgrade 命令安装 pip

安装

使用 pip 包管理器安装 PalWorld Server Toolkit：

pip3 install palworld-server-toolkit

运行

• GUI 模式：直接运行以下命令启动 GUI 界面

  python -i -m palworld_server_toolkit.editor -g -o Level.sav Level.sav
  

• 命令行模式：运行以下命令启动命令行界面

  python -m palworld_server_toolkit.editor -i -o Level.sav Level.sav
  

3. 应用案例和最佳实践

跨服务器迁移玩家数据

1. 复制旧服务器 Level.sav 至 SaveGames/0/<Server ID>/Old-Level.sav
2. 复制旧服务器所有需迁移玩家 Players/xxxxxxxx000000000000000000000000.sav 至 SaveGames/0/<Server ID>/Players/xxxxxxxx000000000000000000000000.sav
3. 在 GUI 模式下，选择 Backup File 并打开旧服务器存档 Old-Level.sav
4. 选择要迁移的旧玩家，目标玩家，点击 Copy Player，然后点击 Save & Exit
5. 将 Level_fixed.sav 替换至 Level.sav 并启动服务端

服务器存档转本地

1. 复制本地 Level.sav 至 SaveGames/0/<Server ID>/Old-Level.sav
2. 复制本地 Players/00000000000000000000000000000001.sav 至 SaveGames/0/<Server ID>/Players/00000000000000000000000000000001.sav
3. 使用命令行模式运行编辑器，并执行相关命令
4. 将 Level_fixed.sav 替换至 Level.sav 并启动服务端

清理长时间未上线玩家

1. 使用命令行模式运行编辑器
2. 执行以下命令清理 7 天未上线玩家

for player_uid in FindInactivePlayer(7): DeletePlayer(player_uid)
Save()

4. 典型生态项目

目前 PalWorld Server Toolkit 社区内有一些相关的项目，例如：

• PalEdit：提供帕鲁编辑器功能
• PalworldCharacterTransfer：动态物品数据迁移引用概念
• Palworld Host Save Fix：服务器存档修复和玩家数据迁移

这些项目可以和 PalWorld Server Toolkit 结合使用，为用户提供更丰富的功能。