Discord 聊天插件

PalworldDiscordPlugin

一个用于 Palworld 专用服务器的 Discord 桥接插件，基于 UE4SS（Unreal Engine 4/5 脚本系统）。

它可将游戏内聊天以及加入、离开和死亡事件桥接到 Discord Webhook。

功能

• 聊天桥接 - 玩家聊天消息直接转发到 Discord。
• 事件通知 - 加入、离开和死亡事件可作为 Discord 嵌入消息发送。
• 可配置事件 - 每个事件类型均可单独启用或禁用。
• 自定义机器人名称 - 设置 Discord Webhook 显示的名称。
• 基于文件的 IPC - 通过文件实现可靠的 Lua 到 C++ 通信。
• 调试日志 - 提供详细日志用于设置和故障排除。

系统要求

• Palworld 专用服务器（Windows）
• UE4SS 安装在以下路径： Pal/Binaries/Win64/
• 一个拥有 Discord Webhook 的 Discord 服务器

安装

1. 停止你的 Palworld 服务器

   在安装或替换文件之前，请完全停止 Palworld 专用服务器。

2. 解压 ZIP 文件

   将插件 ZIP 解压到你的服务器目录：

   Pal/Binaries/Win64/

   ZIP 包含以下内容：

   PalworldDiscordPlugin.dll
   ue4ss/Mods/PalworldDiscordBridge/
   

3. 创建一个 Discord Webhook

   • 打开你的 Discord 服务器设置。
   • 进入“集成”→“Webhook”。
   • 点击“新建 Webhook”。
   • 选择消息要显示到的 Discord 频道。
   • 点击“复制 Webhook URL”。

4. 配置插件

   启动 Palworld 服务器一次。这会创建配置文件。

   再次停止服务器，然后打开：

   Pal/Binaries/Win64/ue4ss/Mods/PalworldDiscordBridge/dlls/config.json

   粘贴你的 Webhook URL：

   {
     "discord": {
       "webhook_url": "https://discord.com/api/webhooks/YOUR/WEBHOOK_URL"
     }
   }
   

5. 激活 UE4SS 模组

   打开 UE4SS Mods 文件夹中的 Mods.txt 文件，添加或启用以下条目：

   PalworldDiscordBridge : 1
   

   重要： 除非在 Mods.txt 中启用了该模组，否则插件无法正常工作。

6. 启动服务器

   重新启动你的 Palworld 服务器。

   在 Palworld 聊天中发送一条消息，检查它是否出现在你的 Discord 频道中。

配置

完整的配置参考可在 CONFIG.md 中找到。

config.json 的基本示例：

{
  "discord": {
    "webhook_url": "YOUR_WEBHOOK_URL_HERE",
    "bot_name": "Server Chat"
  },
  "events": {
    "chat": true,
    "join": false,
    "leave": true,
    "death": true
  }
}

字段	描述
discord.webhook_url	你的 Discord Webhook URL。必填。
discord.bot_name	Discord 中聊天消息显示的名称。
events.chat	将玩家聊天消息转发到 Discord。
events.join	发送加入嵌入消息。目前不建议启用，可能导致断线。
events.leave	玩家离开服务器时发送离开嵌入消息。
events.death	玩家死亡时发送死亡嵌入消息。

故障排除

Discord 中没有消息出现

请检查以下内容：

• 打开此日志文件并查找错误： Pal/Binaries/Win64/PalworldDiscordPlugin.log
• 验证 config.json 中的 Webhook URL 是否正确。
• 启用调试日志：

  {
    "debug_mode": true
  }
  

• 检查你的 Palworld 服务器控制台，查找以 [PalworldDiscordPlugin] 开头的消息。
• 确保 PalworldDiscordBridge 已在 UE4SS 的 Mods.txt 中启用。

服务器崩溃或玩家加入时断线

目前请勿启用加入事件。

当前 Palworld 版本在加入钩子激活时可能导致断线。

请使用以下配置：

{
  "events": {
    "chat": true,
    "join": false,
    "leave": true,
    "death": true
  }
}

机器人显示玩家名称而非“Server Chat”

编辑 config.json 中的 bot_name 值：

{
  "discord": {
    "webhook_url": "YOUR_WEBHOOK_URL_HERE",
    "bot_name": "Server Chat"
  }
}

更改配置后请重启服务器。

文件结构

Pal/Binaries/Win64/
├── PalworldDiscordPlugin.dll
├── PalworldDiscordPlugin.log
├── CONFIG.md
├── README.md
└── ue4ss/
    └── Mods/
        └── PalworldDiscordBridge/
            ├── mod.txt
            ├── Scripts/
            │   └── main.lua
            └── dlls/
                ├── PalworldDiscordPlugin.dll
                └── config.json

PalworldDiscordPlugin.dll 是主要的插件 DLL 文件。

main.lua 是 Palworld 与 Discord 插件之间的 UE4SS Lua 桥接文件。

致谢

由 rl-dev.de 制作
Robin Oliver Lucas