TigerReportsSupports - TigerReports Discord 支持插件

💡TigerReportsSupports

TigerReportsSupports 是 TigerReports 插件的扩展支持模块，由 MrTigreroux 开发。目前，它主要为 TigerReports 插件添加了 Discord 通知功能，让管理团队能通过 Discord 频道及时接收和处理服务器上的举报信息。

🎮功能特性

• Discord 通知支持：将 TigerReports 的举报动态同步至指定的 Discord 频道。
• 可定制的通知类型：
• 新举报提醒
• 处理中举报提醒
• 重要举报提醒
• 已处理举报提醒
• 灵活的服务器部署方案：支持在单台或多台 Spigot 服务器上安装。
• 完整的配置与本地化：可通过配置文件调整所有 Discord 消息内容。

🔧安装指南

前置要求

• 已安装并运行最新版的 TigerReports 插件。
• 一个可用的 Discord 账号，用于创建和管理机器人。

安装步骤

• 停止你的 Spigot 服务器。
• 将下载的 TigerReportsSupports.jar 文件放入服务器的 plugins 文件夹。
• 启动服务器，插件将自动生成配置文件。

网络部署建议

• 推荐方案（单服务器安装）：
• 仅在一台 Spigot 服务器上安装本插件。
• 优点：只需维护一份配置；节省其他服务器的资源（CPU、内存等）。
• 注意：该服务器必须至少有一名在线玩家才能接收 BungeeCord 通知并转发至 Discord。

• 非推荐方案（多服务器安装）：
• 在所有 Spigot 服务器上安装本插件。
• 必须在每台服务器的 config.yml 中将 NotifyOnlyLocalReports 设置为 yes。
• 优点：即使某台服务器没有玩家在线，举报信息也能推送至 Discord。
• 缺点：每台服务器都需要独立配置；会消耗所有服务器的资源来运行机器人。

✨配置 Discord 机器人

创建机器人

• 访问 Discord 开发者门户 并登录。
• 点击 New App，输入机器人名称后点击 Create。
• 在应用页面点击 Add Bot 将应用转换为机器人。
• 在机器人设置中：
• 取消勾选 Public bot
• 取消勾选 Requires OAuth2 Code Grant
• 勾选 Message Content Intent
• 点击 Save Changes
• 生成邀请链接：
• 使用此 URL 模板：https://discordapp.com/api/oauth2/authorize?client_id=<ID>&scope=bot&permissions=0
• 将 <ID> 替换为你的机器人 Client ID。
• 在浏览器中访问该链接，选择你的 Discord 服务器并授权机器人加入。

插件配置

• 打开 ../plugins/TigerReportsSupports/config.yml。
• 启用 Discord 支持：将 Discord: Enabled 设置为 true。
• 设置机器人令牌：将 Discord: Token 的值替换为从开发者页面复制的 Token。
• 设置通知频道：
• 在 Discord 中右键点击目标文字频道，选择 复制 ID。
• 或将频道名称以 \#频道名 的形式发送，并复制其高亮显示的 ID。
• 将频道 ID 填入 Discord: Channel 设置项。
• 在游戏内或 Discord 中执行重载命令：/tigerreports reload。

完成以上步骤后，机器人将开始在该频道发送举报通知。

⭐配置文件说明

config.yml

主要配置选项包括

• Discord: Enabled：是否启用 Discord 支持。
• Discord: Token：Discord 机器人的令牌。
• Discord: Channel：用于发送通知的 Discord 频道 ID。
• Discord: Managers：允许使用 /tigerreports 命令的 Discord 用户列表。
• 移除 none 和 # 注释，将 pseudo 替换为用户的 Discord 名称。
• Discord: ServerInfo：是否在通知中显示服务器名称。

默认配置文件可参考：[此处](默认配置链接)。

messages.yml

• 所有 Discord 消息内容均可在此文件中自定义。
• 默认语言为法语，但文件内附有英文消息基础模板可供修改使用。
• 重要提示：
• 若使用 Minecraft 1.8 或更低版本，请将文件编码设置为 ANSI，否则请使用 UTF-8。
• 文件首行不能是注释（即不能以 # 开头），否则消息将无法正常加载。
• 提及角色：如需让机器人提及某个 Discord 角色，可在消息中插入 <@&ROLE_ID>，其中 ROLE_ID 可通过在 Discord 频道输入 \@角色名 获取。

❓常用命令与工具

Discord 机器人命令

• /tigerreports reload：重载配置文件（config.yml 和 messages.yml）。
• /tigerreports stop：让机器人断开连接。

消息更新工具

升级插件后，可使用此在线工具辅助更新 messages.yml 文件：[消息更新工具链接]。

🔧注意事项与致谢

使用条款

• 请勿声称本插件为你所创作。
• 请勿在本站或其他平台分销或出售本插件，仅可分享此页面链接。
• 如需引用或复制部分源代码，请注明作者（MrTigreroux）并事先通知。
• 请勿在评论区提交错误报告，如有问题请直接联系作者。

支持与反馈

本插件为免费开发，旨在帮助有需要的服务器管理员。如果你觉得它有用，一个好评将是作者最大的动力。

• 源代码：可在 [GitHub](GitHub链接) 查看。
• 反馈渠道：
• [GitHub Issues](GitHub问题链接)
• [讨论页面](讨论页链接)
• 私信联系
• 关注作者（法语用户）：Twitter [@MrTigreroux](Twitter链接)

感谢你的阅读与使用！