HuoNiu Discord｜XF2.3 联动对接 1.0.3

HuoNiu Discord 是 XenForo 2.3 专用集成插件。支持 Discord OAuth 绑定与可选登录、用户组角色同步、封禁与踢人策略、论坛节点内容推频道、提醒/私信/关注镜像 Discord 私信、原生举报进频道与积压提醒。后台可管理服务器、频道、角色并群发提醒，附带在线人数 Widget。可选对接 XFRM 与 NF Tickets。需自行配置 Discord Bot。

HuoNiu Discord
XenForo 2.3 与 Discord 深度集成插件
把论坛账号、用户组、封禁与内容动态，通过 Discord Bot 与服务器角色、频道、私信打通。沿用 XenForo 关联账户体系，不替代论坛登录与权限模型。

核心功能

账号绑定与登录

• 通过 XenForo 关联账户 绑定 Discord

• 可选开启 Discord 登录（未绑定时走注册/关联流程）

• 绑定后可申请加入已配置的 Discord 服务器

• 支持 Token 过期后 重新授权

用户组与角色同步

• 后台管理 多台 Discord 服务器，可设默认服务器

• 用户组 ↔ Discord 角色 一一映射，成员变更后自动排队同步

• 可选：同步时覆盖 Discord 侧角色、同步昵称、同步头像、同步带管理权限的用户组

• 封禁同步：论坛封禁可同步到 Discord

• 可选：解绑时踢出服务器；指定用户组变更时踢出服务器

• 同步任务走 发送队列，失败自动重试，并提供 同步日志

论坛内容推送到频道

• 每个论坛节点可指定 Discord 频道

• 新主题/首帖自动推送；可选 回复也推送

• 版主可将单个主题 手动推广 到所选频道（按节点权限控制）

• 主题/帖子 移动、复制 时推送逻辑随 XenForo 原生流程处理

• Embed 可配置默认颜色与页脚图标

私信镜像（需会员已绑定 Discord）

• 论坛提醒 可镜像为 Discord 私信，并按提醒类型单独开关

• 私信会话 新消息可镜像为 Discord 私信

• 关注论坛 时可勾选同时接收 Discord 私信通知

• 站长可全局关闭 Discord 私信功能

举报通知

• 对接 XenForo 原生举报（非第三方举报中心）

• 新建举报、已关闭举报被重开时，可推送到指定 Discord 频道

• 可配置：未处理举报过多、长时间未处理的 定时提醒

后台管理

• 服务器：添加/编辑、邀请 Bot、测试连接、同步服务器信息

• 频道 / 角色：列表查看与编辑（依赖 Bot 权限）

• 向多个频道 群发运营提醒

• 用户组页为每个 XF 用户组勾选对应 Discord 角色

• 工具页：集成测试、指定会员角色同步测试、Gateway 连接测试

前台组件

• Widget：展示所选 Discord 服务器在线人数

可选扩展（需相应插件已安装）

• XFRM：资源分类可绑频道，新资源与资源更新可推送

• NF Tickets：工单分类可绑频道，新建工单与回复可推送

系统要求

使用说明

1. 在 XenForo 后台「关联账户」中配置 Discord 应用信息

2. 添加 Discord 服务器并邀请 Bot 入服

3. 配置用户组与角色的映射关系

4. 为需要推送的论坛节点（及 XFRM/NF Tickets 分类）指定频道

5. 会员在个人设置中绑定 Discord，并按需开启私信镜像选项

说明

• 本插件实现的是 论坛 → Discord 的账号、角色与通知同步，不包含 Discord 消息回写论坛

• 不包含 Discord 斜杠命令、音乐 Bot 等玩法

• 频道推送、角色同步、私信镜像是否生效，取决于 Bot 权限、会员是否绑定 Discord 及个人偏好设置

• XFRM、NF Tickets 为可选集成，未安装时不影响核心功能