PalServerBridge

PalServerBridge

PalServerBridge是一款用于幻兽帕鲁（Palworld）专用服务器的服务端UE4SS模组。它提供了一个本地HTTP REST API，允许外部工具、管理面板、商店系统、Discord/QQ机器人以及服务器自动化脚本安全地进行交互。

实用工具

PalServerBridge预览查看大图

Palworld Dedicated Server Remote API Mod / 幻兽帕鲁专用服务器远程API模组

PalServerBridge 是一个服务端的 UE4SS 模组，为 Palworld 专用服务器提供本地 HTTP REST API。 它使得外部工具（如管理面板、网页商城、Discord/QQ机器人、自动化脚本）能够安全地与运行中的服务器进行交互，功能远超RCON所提供的。 PalServerBridge 是一个服务端 UE4SS 模组，为幻兽帕鲁专用服务器提供本地 HTTP REST API。 它允许外部工具（管理面板、网页商城、Discord/QQ 机器人、自动化脚本）安全地与运行中的服务器交互，功能远超传统 RCON。 API docs Url：API文档 API 文档地址：API 文档

What It Can Do / 它能做什么

  • Query player data / 查询玩家数据: online list, inventory, pal storage/party, guilds, location. 在线玩家列表、背包物品、帕鲁仓库与队伍、公会信息、坐标与朝向。
  • Give rewards / 发放内容: items, pals (with full SaveParameter/StaticParameter override), technology points, ancient technology points, effigies, EXP. 发放物品、自定义帕鲁、科技点、古代科技点、翠叶鼠雕像、经验值。
  • Delete items and pals / 删除管理: delete items by code, delete pals by storage slot or SaveParameter filter. 按物品代码删除物品，按仓库槽位或属性条件删除帕鲁。
  • Server messaging / 服务器消息: public chat, private messages, system announcements. 公屏聊天、私聊消息、系统警报公告。
  • World spawning / 世界生成: spawn wild pals at arbitrary coordinates with custom attributes. 在指定坐标生成携带自定义属性的野生帕鲁。
  • Template system / 模板引擎: predefine pal, item, gift, lottery, and world-spawn templates for reusable one-click rewards. 预定义帕鲁、物品、礼包、抽奖、世界生成模板，实现可复用的自动化发放。

Use Cases / 应用场景

  • Web shop / 网页商城: players self-purchase items and pals, automatically delivered by the server. 玩家自助购买物品/帕鲁，服务器自动发放。
  • Discord / QQ bot / 群机器人: daily check-in rewards, lottery draws, backpack queries. 群内签到奖励、抽奖、背包查询。
  • Admin dashboard / 管理面板: search a SteamID to view and modify player inventory, pals, or location. 搜索SteamID查看并修改玩家背包、帕鲁与位置。
  • Event automation / 活动自动化: scheduled EXP events, festival boss spawns via script. 定时双倍经验、节日世界BOSS生成。

Installation / 安装

  1. 将发布包解压到服务器的Pal/Binaries/Win64目录中。 将发布包解压到服务器 Pal/Binaries/Win64 目录。
  2. 启动服务器一次生成 config.json，然后编辑它： 启动一次服务器生成配置文件 ue4ss/Mods/PalServerBridge/dlls/config.json，然后编辑：
  • 将 api_key 更改为一个强而唯一字符串。 修改 api_key 为强密码。
  • 保持 http_port 私有，不要直接暴露到互联网上。 保持 http_port 仅本地访问，勿直接暴露公网。
  1. 使用 http://127.0.0.1:8888/ping 进行验证。 访问 http://127.0.0.1:8888/ping 验证。
  2. 阅读 docs/ 中的自动生成文档，以集成你的工具。 阅读自动生成的 docs/ 文档开始对接你的工具。

Security / 安全提醒

这个模组可以修改玩家背包和帕鲁数据。 始终更改默认API密钥。只允许受信任的工具访问API。 使用反向代理、防火墙或将绑定严格限制在 127.0.0.1。 本模组可以修改玩家数据，务必修改默认API密钥。仅允许受信工具访问API。 使用反向代理、防火墙，或将绑定地址严格限制为 127.0.0.1。

FAQ / 常见问题

  • My IP got banned / 我被封禁了 从 ue4ss/Mods/PalServerBridge/dlls/banned_ips.txt 中移除你的IP地址。 从 banned_ips.txt 中删除你的 IP。
  • The mod isn't loading / 插件未被 UE4SS 加载 使用发布包中提供的兼容UE4SS版本，该版本已针对PalSchema共存进行了优化。 请使用发布包内配套的 UE4SS 版本，该版本针对 PalSchema 共存做过优化。

Compatibility / 兼容性

仅限服务器端，玩家无需安装客户端。 包含了一个兼容的 UE4SS 构建版本，适用于同样使用 PalSchema 的服务器。 纯服务端模组，玩家无需安装。 压缩包内附带与 PalSchema 共存的兼容 UE4SS 版本。