📖 帕鲁管理员 - 使用说明

🌟 一、工具介绍

帕鲁管理员是一套专为幻兽帕鲁（Palworld）服务器设计的全功能管理工具，包含服务端插件、管理服务端和可视化客户端三部分。

🎮玩家管理

📦物品发放

🐾帕鲁定制

⚔️品质词条

✈️游戏工具

📢公告系统

🔨封禁管理

📝操作日志

本工具基于 PalDefender Anti-Cheat v1.8.3 开发，需要配合 UE4SS 模组加载器使用。

📦 二、完整包内容说明

新手入门完整包包含以下所有文件，解压后按照教程依次安装即可：

📁 PalAdmin-StarterPack/ ├── 📁 PalDefender/ # 反作弊插件（C++原生mod） │ └── PalDefender.dll # 放到 Win64 目录 ├── 📁 AdminCommands/ # 管理命令插件（Lua mod） │ ├── mods.txt │ └── 📁 Scripts/ │ └── Main.lua ├── 📁 UE4SS/ # UE4SS模组加载器 │ └── d3d9.dll # 放到 Win64 目录 ├── 📁 Server/ # 管理服务端 │ ├── PalServe.exe │ ├── appsettings.json │ └── config.template.json ├── 📁 Client/ # 管理客户端 │ └── palClient.exe └── 📄 使用说明.html # 本文档

🛡️ 三、服务器Mod安装

3.1 安装 UE4SS 模组加载器

1完整包内已包含 UE4SS 模组加载器（v3.0.1），无需单独下载
如需最新版可前往 GitHub官方发布页下载

2把完整包内 UE4SS 模组加载器 文件夹内的所有文件复制到服务器目录： PalServer\Pal\Binaries\Win64\

▲ UE4SS 模组加载器文件夹内的文件，全部复制到 Win64 目录

3.2 安装 PalDefender 插件

PalDefender 是 C++ 原生插件，安装方式与普通 Lua mod 不同，直接放到 Win64 目录即可。

1将完整包中 PalDefender 文件夹里的 PalDefender.dll 复制到： PalServer\Pal\Binaries\Win64\

2确认 d3d9.dll（UE4SS加载器）也在同一个 Win64 目录下

3首次启动服务器后，Win64目录下会自动生成 PalDefender 文件夹，里面包含配置文件和日志

4修改自动生成的 PalDefender\config.json 和 RESTConfig.json（见第六章）

▲ Win64目录下的 d3d9.dll 和自动生成的 PalDefender 文件夹

3.3 安装 AdminCommands 插件

1将完整包中 AdminCommands 文件夹复制到： PalServer\Pal\Binaries\Win64\ue4ss\Mods\

2编辑 mods.txt，添加：

AdminCommands : 1

▲ ue4ss\Mods 目录下的 AdminCommands 和其他插件

两个插件都安装完成后，启动服务器，控制台看到 PalDefender Anti Cheat v1.8.3 loaded! 即为成功。

🖥️ 四、管理服务端部署

管理服务端是连接客户端和游戏服务器的中间件，提供API接口。

管理服务端必须安装在游戏服务器同一台机器上（Windows系统），因为它需要通过 127.0.0.1 连接 PalDefender 的 REST API。客户端则安装在管理员自己的电脑上。

4.1 在服务器上安装 .NET 8.0 运行时

1服务端为自包含单文件，已内置 .NET 8.0 运行时，无需单独安装
如遇启动问题，可安装 .NET 8.0 Desktop Runtime 作为备用方案

2安装完成后，在服务器的CMD执行 dotnet --list-runtimes 验证，看到 Microsoft.AspNetCore.App 8.0.x 即为成功

▲ 执行 dotnet --list-runtimes 验证.NET 8.0运行时安装成功

4.2 在服务器上配置服务端

1将完整包中 Server 文件夹放到游戏服务器的任意目录（如 D:\PalServe\）

2编辑 appsettings.json，填写你的服务器信息：

{
  "PalDefender": {
    "BaseUrl": "http://127.0.0.1:17993",
    "Token": "你的PalDefender Token"
  },
  "Management": {
    "Port": 5000,
    "ApiKey": "PdAdmin@2026"
  },
  "Rcon": {
    "Host": "127.0.0.1",
    "Port": 25575,
    "Password": "你的RCON密码"
  }
}

3也可以启动服务端后点击「设置」按钮，在可视化界面中配置所有参数：

💡 设置窗口包含：PalDefender地址/Token、API Key、RCON配置、服务器REST API、路径配置、公告配置等，填写后点击「保存设置」即可自动生成 appsettings.json。

4.3 启动服务端

1双击运行 PalServe.exe

2看到 监听端口 5000 即为启动成功

建议将 PalServe.exe 创建快捷方式到桌面，方便每次启动。也可以使用 NSSM 部署为Windows服务实现开机自启。

💡 服务端主界面：顶部按钮栏可进行设置、检查更新、保存大世界、关闭服务器等操作；运行日志会实时显示所有操作记录和更新进度。点击「检查更新」可自动从 paladmin.top 下载最新版。

💻 五、管理客户端使用

客户端是管理员操作的可视化界面，安装在管理员自己的电脑上（不需要装在服务器上）。

5.1 首次启动配置

1在管理员电脑上运行 palClient.exe

2在登录界面填写服务端地址和API Key：

服务端地址：http://你的服务器IP:5000
API Key：PdAdmin@2026（与服务端appsettings.json一致）

▲ 客户端系统设置页面，填写服务端地址和API Key

5.2 主界面介绍

👥玩家管理

📦物品发放

🐾帕鲁管理

✈️游戏工具

📢公告管理

📝操作日志

5.3 系统托盘

客户端最小化后会缩到系统托盘，右键托盘图标可显示主窗口或退出程序。

▲ 系统托盘右键菜单

⚙️ 六、配置文件说明

6.1 PalDefender config.json 关键字段

{
  "version": "1.8.3",
  // 进服欢迎语
  "MOTD": [
    "欢迎 {PlayerName} 来到 {ServerName}！"
  ],
  // REST API 配置（在RESTConfig.json中）
  // Token: 用于管理服务端认证
  // Port: 17993（默认）

  // 反作弊设置
  "shouldKickCheaters": true,
  "shouldBanCheaters": false,

  // 管理员IP白名单
  "adminIPs": ["127.0.0.1"],

  // PVP伤害限制
  "pvpMaxToBuildingDamage": 100,
  "pvpMaxToPalDamage": 1000
}

6.2 RESTConfig.json

{
  "Port": 17993,
  "BearerTokens": [
    "你的Token（复制到服务端appsettings.json）"
  ]
}

6.3 Token配置（SuperAdmin.json）

PalDefender 的管理员Token配置文件，位于 PalDefender\RESTAPI\Tokens\SuperAdmin.json。

该文件夹下默认没有 SuperAdmin.json 文件，需要手动创建。在 PalDefender\RESTAPI\Tokens\ 目录下新建文本文件，命名为 SuperAdmin.json，将下方代码粘贴进去。

{
    "Name": "SuperAdmin",
    "Token": "你的token密钥",
    "Permissions": ["REST.*"],
    "created": "2026-08-12T00:00:00Z",
    "expires": null,
    "description": "管理员完全权限"
}

将 "你的token密钥" 替换为实际的Token字符串，可使用本站的 🔑 Token生成器生成安全的随机密钥。生成后将Token同时填入服务端的 appsettings.json 中。

6.4 服务端 appsettings.json

{
  "PalDefender": {
    "BaseUrl": "http://127.0.0.1:17993",
    "Token": "PalDefender的Token"
  },
  "Management": {
    "Port": 5000,
    "ApiKey": "自定义管理密码"
  },
  "Rcon": {
    "Host": "127.0.0.1",
    "Port": 25575,
    "Password": "服务器RCON密码"
  },
  "PalServer": {
    "AdminPassword": "服务器管理员密码"
  },
  "ServerUpdate": {
    "UpdateUrl": "https://paladmin.top",
    "AutoCheckOnStart": true
  }
}

🎮 七、功能使用指南

7.1 发放物品

1进入「物品发放」页面

2选择物品分类（武器/防具/材料/食物等）

3选择物品，输入数量，点击发放

▲ 物品发放页面，支持分类筛选、批量发放和品质选择

7.2 定制帕鲁

1进入「帕鲁管理」页面

2选择帕鲁种类，设置等级、词条、是否闪光

3点击生成，帕鲁会出现在玩家面前

▲ 帕鲁管理页面，支持等级、闪光、被动词条定制

词条支持多选，闪光帕鲁有特殊外观！

7.3 游戏工具

包含传送、给予经验、设置等级、杀死玩家等实用功能，所有操作均记录到日志。

7.4 公告系统

支持发送即时公告和设置循环公告，循环公告间隔可自定义。

❓ 八、常见问题

Q1: 客户端连接失败怎么办？

A: 检查以下几点：

服务端 PalServe.exe 是否启动
防火墙是否放行5000端口
客户端填写的IP和端口是否正确
API Key是否与服务端一致

Q2: 物品发放没反应？

A: 确认 PalDefender 插件已加载，REST API 端口17993可访问，Token配置正确。

Q3: 如何更新版本？

A: 客户端启动时会自动检查更新，有新版本会弹窗提示。服务端点「检查更新」按钮即可。

Q4: 支持多人同时管理吗？

A: 支持！多个客户端可以同时连接同一个服务端，操作会同步记录到日志。

Q5: 帕鲁生成失败？

A: 检查玩家是否在线，帕鲁ID是否正确，服务端日志会显示具体错误信息。

如果遇到其他问题，请查看服务端和客户端的日志文件，或联系技术支持。

帕鲁管理员使用说明

📑 目录导航

🌟 一、工具介绍

📦 二、完整包内容说明

🛡️ 三、服务器Mod安装

3.1 安装 UE4SS 模组加载器

3.2 安装 PalDefender 插件

3.3 安装 AdminCommands 插件

🖥️ 四、管理服务端部署

4.1 在服务器上安装 .NET 8.0 运行时

4.2 在服务器上配置服务端

4.3 启动服务端

💻 五、管理客户端使用

5.1 首次启动配置

5.2 主界面介绍

5.3 系统托盘

⚙️ 六、配置文件说明

6.1 PalDefender config.json 关键字段

6.2 RESTConfig.json

6.3 Token配置（SuperAdmin.json）

6.4 服务端 appsettings.json

🎮 七、功能使用指南

7.1 发放物品

7.2 定制帕鲁

7.3 游戏工具

7.4 公告系统

❓ 八、常见问题

Q1: 客户端连接失败怎么办？

Q2: 物品发放没反应？

Q3: 如何更新版本？

Q4: 支持多人同时管理吗？

Q5: 帕鲁生成失败？

帕鲁管理员 使用说明

📑 目录导航

🌟 一、工具介绍

📦 二、完整包内容说明

🛡️ 三、服务器Mod安装

3.1 安装 UE4SS 模组加载器

3.2 安装 PalDefender 插件

3.3 安装 AdminCommands 插件

🖥️ 四、管理服务端部署

4.1 在服务器上安装 .NET 8.0 运行时

4.2 在服务器上配置服务端

4.3 启动服务端

💻 五、管理客户端使用

5.1 首次启动配置

5.2 主界面介绍

5.3 系统托盘

⚙️ 六、配置文件说明

6.1 PalDefender config.json 关键字段

6.2 RESTConfig.json

6.3 Token配置（SuperAdmin.json）

6.4 服务端 appsettings.json

🎮 七、功能使用指南

7.1 发放物品

7.2 定制帕鲁

7.3 游戏工具

7.4 公告系统

❓ 八、常见问题

Q1: 客户端连接失败怎么办？

Q2: 物品发放没反应？

Q3: 如何更新版本？

Q4: 支持多人同时管理吗？

Q5: 帕鲁生成失败？

帕鲁管理员使用说明