续集鹦鹉

The Sequel Parrot

一个精密的 Minecraft 服务端模组，用于在 Minecraft 聊天与 Discord 频道之间架起桥梁。

这是为我们自己的 SMP 服务器而构建的，但我们决定将其公开发布。

功能特性

• 无缝的 Minecraft <-> Discord 互联：在两个平台之间平滑地转发所有消息。
• 转发死亡与进度消息：将玩家死亡与获得的成就直接广播到 Discord。
• 回复 Discord 消息：在 Minecraft 聊天中点击 Discord 消息即可自动填入 /reply 命令。
• 提及 Discord 用户：使用 /mention 命令或直接在聊天中输入 @discord_name 来@通知用户。
• 自定义提及消息：当使用 /mention 而不附带消息内容时，触发自定义的、基于特定角色的通知模板。
• Quark 兼容性：无缝地将 Quark 模组“分享物品”功能分享的物品转发到 Discord。
• 回复上下文：在 Minecraft 中悬停在镜像的 Discord 消息上，可查看其所回复的消息内容。
• 反刷屏提及：通过超时和自动踢出超过每分钟可配置提及阈值的玩家来防止刷屏。
• 反杂乱：将聊天消息中的换行符压缩为单行，并阻止已执行命令泄漏到转发频道中。
• 便捷提及：在 Minecraft 聊天中点击任何 Discord 用户名，即可自动准备 /mention 命令。

---

命令

Minecraft 命令

• /reply <message_id> <message> - 通过 ID 回复特定的 Discord 消息。
• /mention <user_name> [message] - 直接@通知一个 Discord 用户，或发送预设的自定义提及消息。

Discord 命令

• /ping - 检查机器人的响应状态和延迟。
• /players - 显示当前在线的 Minecraft 玩家列表。
• /mention <role> <message> - 为指定角色设置自定义提及模板字符串。

自定义提及系统

默认的提及格式是：(Minecraft) 提及了你，(Discord)。

服务器管理员或持有特定角色的人员可以通过 Discord 使用 /mention 命令配置动态通知格式。

占位符语法

• <@> - 会被替换为发送者的 Minecraft 用户名。
• (@) - 会被替换为接收者的 Discord 显示名称。

示例

• <@> 提及了你，(@)。
• 需要关注！<@> 请求 (@) 提供帮助！

注意： 当玩家运行 /mention <user_name> 而未提供额外的消息参数时，会触发自定义提及模板。

---

设置指南

1. 创建 Discord 机器人

1. 导航至 Discord 开发者门户 并创建一个新的应用。
2. 自定义你的机器人名称和头像。
3. 在侧边栏中前往 Bot 标签页。
4. 点击 Reset Token 并复制你的新机器人令牌（请保持此令牌私密）。
5. 向下滚动至 Privileged Gateway Intents 并启用：
   • Server Members Intent
   • Message Content Intent
6. 在 Bot 权限下（或通过 OAuth2 -> URL Generator 且带有 bot 作用域），授予以下权限：
   • Send Messages
   • Manage Messages
   • Embed Links
7. 将机器人邀请到你的 Discord 服务器中。

2. 配置模组

1. 使用已安装的模组启动你的 Minecraft 服务器一次，以生成配置文件。
2. 打开你服务器的 config 文件夹，找到 messager_bot-server.toml。
3. 打开该文件，并将你的机器人令牌粘贴到指定字段中。

3. 绑定 Discord 频道

1. 在 Discord 中，打开 用户设置 -> 高级。
2. 启用 开发者模式。
3. 在 Discord 中右键点击你想要的聊天转发频道，选择 复制频道 ID。
4. 将频道 ID 粘贴到 messager_bot-server.toml 中。
5. 重启或重新加载你的服务器。

---

致谢（Sequel 团队）

• MeroSsSany - 首席开发者
• Guardian - 安全测试员
• Cattopy - 测试员
• Sanys - 徽标设计