Discord - Minecraft Hook - 游戏与聊天互通插件

💡简介

本插件用于将 Minecraft 服务器与 Discord 社区连接起来，实现玩家身份验证、角色同步和跨平台聊天等功能。使用前请确保服务器环境为 Java 11 或更高版本。

❓教程：设置 Discord 机器人

首先，你需要创建一个 Discord 机器人并获取其 Token。

创建机器人应用

• 访问 https://discordapp.com/developers/applications/。
• 点击 “New Application”，填写应用名称、头像和描述（可选）。
• 创建后，在左侧设置栏中点击 “Bot”。
• 点击 “Add Bot”，然后确认 “Yes, do it!”。

获取并邀请机器人

• 返回 “General Information” 设置页。
• 复制 “Client ID”。
• 访问此链接：https://discordapp.com/oauth2/authorize?permissions=2146958579&scope=bot&client_id=，并将复制的 Client ID 粘贴到链接末尾。
• 在打开的页面中选择你的 Discord 服务器，完成机器人邀请。

获取机器人 Token

• 再次进入 “Bot” 设置页面。
• 在 “Privileged Gateway Intents” 下，开启必要的权限开关（通常需要 Presence Intent 和 Server Members Intent）。
• 点击 “Reset Token” 或 “Copy” 按钮，复制生成的 Token 并妥善保存，后续配置会用到。

🔧安装与配置插件

安装插件

• 确保已下载并安装最新版本的 Discord Bot API 插件。
• 下载本插件，将两个插件的 JAR 文件一同放入服务器的 plugins 文件夹。

初次配置

• 启动服务器，插件会因未配置而自动禁用，随后关闭服务器。
• 编辑本插件生成的配置文件。
• 在配置文件的 Bot 部分，粘贴你之前复制的机器人 Token。
• 根据需要修改验证后的角色名称（默认为 Verified）。
• 设置 Minecraft 消息同步至 Discord 的频道，以及接收 Discord 消息的频道（请确保这些频道已在 Discord 服务器中创建）。

服务器端设置

• 在你的 Discord 服务器中创建名为 Verified 的角色（或你在配置中指定的名称）。
• 将机器人自身的角色权限层级调整至高于 Verified 角色。
• 完成以上步骤后，重新启动服务器，插件应能正常工作。

✨验证流程

玩家在游戏内完成身份验证的步骤如下

• 在 Minecraft 游戏中输入命令 /verify。
• 玩家将收到一条包含特定验证指令的提示消息。
• 将该指令发送到配置好的 Discord 验证频道中。
• 发送后，玩家的 Discord 账号将与 Minecraft 游戏角色绑定，并获得相应的 Verified 角色。

🎮命令与权限

以下是插件提供的游戏内命令及其所需权限

玩家命令

• /verify

-   权限：`minecrafthook.verify`

-   功能：开始验证流程，获取 Discord 验证指令。

• /unverify

-   权限：`minecrafthook.verify`

-   功能：解除当前账号的 Discord 绑定。

管理员命令

• /giverole <role> <player>

-   权限：`minecrafthook.giverole`

-   功能：为指定玩家授予指定的 Discord 角色。

• /removerole <role> <player>

-   权限：`minecrafthook.giverole`

-   功能：移除指定玩家的指定 Discord 角色。

• /sc <Message. . .>

-   权限：`minecrafthook.staffchat`

-   功能：将消息发送到关联的 Discord 管理频道。

⭐注意事项与支持

• 请确保已正确安装并配置其依赖插件 Discord Bot API。
• 配置时，请仔细检查 Discord 频道 ID 和角色名称的拼写。
• 如果遇到问题，请先通过 Discord 社区联系开发者反馈，而不要直接给予差评。
• 欢迎加入开发者的 Discord 服务器获取支持，并考虑通过赞助支持插件的持续开发。