帕尔桥

🔗 PalBridge

一款面向 Palworld 专用服务器的现代化 Discord 桥接与管理套件。

由 Nexium Labs 开发的 PalBridge 通过轻量级的 UE4SS 服务端模组 和配套的 Discord 机器人，将你的 Palworld 专用服务器直接连接到 Discord。

PalBridge 专为希望获得更好的社区整合、实时服务器信息以及便捷管理控制、而无需频繁访问游戏服务器控制台的服务器管理员而设计。

[line]

✨ 功能特性

💬 双向 Discord 聊天

让你的 Discord 社区与游戏内玩家保持联系。

[list] []转发 Palworld → Discord 玩家聊天[/] []转发 Discord → Palworld 消息[/] []为游戏内消息提供整洁的 Discord 嵌入卡片[/] []默认自动忽略 [code]/[/code]和 [code]![/code]命令消息[/] []内置防止消息循环的保护机制[/] [/list]

[line]

👥 玩家活动

PalBridge 可以直接通过 Discord 提供有用的玩家信息。

[list] []玩家加入通知[/] []玩家离开通知[/] []在线玩家列表[/] []玩家等级[/] []玩家延迟信息[/] [/list]

[line]

📊 实时服务器状态

使用： [code]/pal status[/code]

查看以下信息：

[list] []服务器名称[/] []Palworld 版本[/] []当前玩家数量[/] []最大玩家数量[/] []服务器 FPS[/] []帧时间[/] []服务器运行时间[/] []当前世界天数[/] []据点数量[/] [/list]

[line]

🛡️ Discord 管理

获得授权的 Discord 管理员可以直接从 Discord 执行常见的 Palworld 服务器管理任务。

[table][tr][th]命令[/th] [th]说明[/th] [/tr] [tr][td][code]/pal announce[/code][/td] [td]向服务器上的玩家广播消息[/td] [/tr] [tr][td][code]/pal kick[/code][/td] [td]踢出一名在线玩家[/td] [/tr] [tr][td][code]/pal ban[/code][/td] [td]封禁一名在线玩家[/td] [/tr] [tr][td][code]/pal unban[/code][/td] [td]使用玩家用户 ID 解除封禁[/td] [/tr] [tr][td][code]/pal save[/code][/td] [td]强制保存当前世界[/td] [/tr] [tr][td][code]/pal shutdown[/code][/td] [td]保存并优雅关闭服务器[/td] [/tr] [/table]

公开命令

[table][tr][th]命令[/th] [th]说明[/th] [/tr] [tr][td][code]/pal help[/code][/td] [td]显示可用的 PalBridge 命令[/td] [/tr] [tr][td][code]/pal status[/code][/td] [td]查看实时服务器信息[/td] [/tr] [tr][td][code]/pal players[/code][/td] [td]查看当前在线玩家[/td] [/tr] [/table]

[line]

🔐 安全性

PalBridge 将 Discord 机器人与 Palworld 游戏进程分离。

你的 Discord 机器人令牌不会存储在 UE4SS Lua 模组中。

安全相关功能包括：

[list] []Discord 令牌仅由配套机器人存储[/] []PalBridge 组件之间使用共享密钥认证[/] []可配置的 Discord 管理员角色[/] []支持 Discord [code]Administrator[/code]权限[/] []支持 Discord [code]Manage Server[/code]权限[/] []可选的管理操作日志记录[/] []玩家 IP 地址不会通过公开命令暴露[/] []优雅关闭会在停止服务器前请求保存世界[/] [/list]

[quote]重要

Palworld REST API 应保持私有。除非得到妥善保护，否则不要将 REST API 端口直接暴露到公共互联网。[/quote]

[line]

🧩 PalBridge 工作原理

[code]Palworld Dedicated Server | |-- UE4SS / PalBridge | | | -- In-game chat events | |-- Palworld REST API | | | -- Players / Status / Administration | v PalBridge Discord Bot | v Discord[/code]

UE4SS 组件负责处理 Palworld 侧的功能，例如游戏聊天事件。

Palworld 的 REST API 用于获取服务器信息以及执行受支持的管理操作。

将这些系统分离可以减小 UE4SS 部分的体积，同时让 Discord 机器人更易于配置、更新和排查问题。

[line]

📦 环境要求

在安装 PalBridge 之前，请确保你已具备：

[list] []Palworld 专用服务器[/] []兼容的 UE4SS 安装[/] []Node.js 22 或更新版本[/] []Discord 机器人/应用[/] []Palworld 服务器进程可用的 [code]curl[/code][/] []已启用 Palworld REST API[/] [/list]

[line]

🛠️ 安装

1. 安装 UE4SS 模组

解压下载的压缩包。

将包含的 [code]NexiumPalBridge[/code] 文件夹放入你的 UE4SS 模组目录中。

典型的 UE4SS 3.x 安装目录应类似于：

[code]Pal/Binaries/Win64/ue4ss/Mods/NexiumPalBridge/ ├── enabled.txt └── scripts/ ├── config.lua └── main.lua[/code]

如果你的 UE4SS 安装使用 [code]mods.txt[/code]，请添加或启用：

[code]NexiumPalBridge : 1[/code]

[line]

2. 启用 Palworld REST API

找到当前使用的： [code]PalWorldSettings.ini[/code]

启用 REST API 并配置其端口和管理密码。

示例：

[code]RESTAPIEnabled=True RESTAPIPort=8212 AdminPassword=YOUR_STRONG_ADMIN_PASSWORD[/code]

将： [code]YOUR_STRONG_ADMIN_PASSWORD[/code]

替换为你实际的 Palworld 管理密码。

更改配置后，重启你的 Palworld 专用服务器。

[line]

3. 配置 PalBridge

打开： [code]NexiumPalBridge/scripts/config.lua[/code]

配置所需选项，包括：

[list] []桥接地址[/] []共享密钥[/] []服务器名称[/] []其他可用的 PalBridge 设置[/] [/list]

共享密钥应为一长串随机生成的值，且不应公开分享。

[line]

4. 配置 Discord 机器人

打开包含的： [code]discord-bot[/code] 目录。

安装所需的 Node.js 包：

[code]npm install[/code]

将： [code].env.example[/code]

复制为： [code].env[/code]

然后输入你的 Discord 机器人和 Palworld 服务器配置。

使用以下命令启动 PalBridge：

[code]npm start[/code]

更多设置和故障排除信息包含在打包的 [code]README.md[/code] 中。

[line]

🖥️ 专用服务器与托管支持

PalBridge 面向 Palworld 专用服务器，可用于以下环境：

[list] []Windows 专用服务器[/] []Linux 专用服务器[/] []VPS 环境[/] []独立物理机[/] []Pterodactyl[/] []其他兼容的游戏服务器托管面板[/] [/list]

你的托管环境必须允许所需组件之间相互通信。

容器

如果你的 Discord 机器人和 Palworld 服务器运行在独立容器中：

[code]127.0.0.1[/code] 并不指向另一个容器。

每个容器都有自己的 localhost 接口。

请使用适当的私有或受限网络地址，以允许 PalBridge 组件之间进行通信。

[line]

⚙️ 配置

PalBridge 的设计理念是将配置保留在主应用代码之外。

UE4SS 部分可通过以下文件进行配置： [code]scripts/config.lua[/code]

Discord 机器人使用： [code].env[/code]

请勿公开分享你的 [code].env[/code] 文件。

它可能包含敏感信息，包括：

[list] []Discord 机器人令牌[/] []Palworld 管理密码[/] []桥接认证密钥[/] [/list]

[line]

⚠️ 兼容性

Palworld 更新有时可能会更改 UE4SS 所使用的 Unreal Engine 函数。

因此，重大的 Palworld 更新可能会影响 PalBridge 的游戏侧聊天集成。

如果 Palworld 更改了当前用于聊天事件的函数，则可能需要更新版本的 PalBridge。

服务器管理功能有意与 UE4SS 聊天集成分离，并在适当的情况下使用 Palworld 的 REST API。

[line]

❓ 故障排除

如果 PalBridge 无法启动或无法正常通信，请检查以下内容：

[list] []UE4SS 已正确安装[/] []PalBridge 已在 UE4SS 中启用[/] []已安装 Node.js 22+[/] [][code]npm install[/code] 已成功完成[/] []你的 [code].env[/code] 值正确[/] []你的 [code]config.lua[/code] 值正确[/] []Palworld REST API 已启用[/] []REST API 端口与你的 PalBridge 配置匹配[/] []你的 Palworld 管理密码正确[/] []你的桥接共享密钥匹配[/] []Palworld 服务器和 Discord 机器人之间所需端口可访问[/] []防火墙未阻止组件之间的私有通信[/] [/list]

对于基于容器的环境，还需确认你没有错误地使用 [code]127.0.0.1[/code] 在独立容器之间进行通信。

[line]

📝 问题反馈

如果你遇到问题，提供详细信息会显著简化故障排除过程。

报告问题时，请包含：

[list] []Palworld 服务器版本[/] []PalBridge 版本[/] []UE4SS 版本[/] []操作系统[/] []托管环境[/] []相关日志或错误消息[/] []复现问题所需的步骤[/] [/list]

公开发布日志前，请移除密码、Discord 令牌、API 凭据、共享密钥及其他私密信息。

[line]

❤️ 鸣谢

Nexium Labs

PalBridge 由 Nexium Labs 开发。

简洁的服务器工具。更好的社区管理。一座连接 Palworld 与 Discord 的桥梁。

如果 PalBridge 对你的服务器有帮助，欢迎留下反馈、报告 bug 或分享兼容性信息，以帮助改进未来的版本。