Discord2FA - Discord双重验证插件

Discord2FA 是一款为 Minecraft 服务器设计的双重验证插件，旨在保护玩家账户免受恶意攻击。它通过在玩家登录时要求其通过 Discord 接收并输入验证码来完成身份验证，从而大幅提升账户安全性。

💡核心功能

• 玩家加入服务器时，必须通过 Discord 私信接收的验证码进行身份验证。
• 支持为已验证玩家生成备用代码（Backup Codes）。
• 可配置的验证倒计时和尝试次数限制。
• 支持与 AuthMe、LoginSecurity 等登录插件联动。
• 在验证期间，可限制玩家执行命令、破坏方块、使用聊天等功能。
• 提供完整的配置文件和权限控制。

🎮安装与配置

创建 Discord 机器人

• 前往 Discord 开发者门户 创建一个新的应用。
• 在应用页面，进入 Bot 标签页，点击 Add Bot 并确认。
• 在同一标签页的 Privileged Gateway Intents 下，启用 SERVER MEMBERS INTENT 选项。
• 点击 Token 下方的复制按钮，保存好机器人的令牌。

安装插件

• 停止你的 Minecraft 服务器。
• 将 Discord2FA 插件放入服务器的 plugins 文件夹。
• 启动服务器以生成配置文件，然后再次停止服务器。
• 打开配置文件 config.yml，将之前复制的机器人令牌粘贴到 bot-token 选项中。
• （可选）使用机器人的 Client ID 生成邀请链接，将其邀请到你的 Discord 服务器。
• 完成！现在你可以根据需求在配置文件中调整所有设置。

🔧使用方法

添加玩家到验证列表

要将玩家纳入双重验证，你需要知道该玩家的 Discord ID。

• 启用开发者模式：在 Discord 用户设置的 外观 -> 高级 中，开启“开发者模式”。
• 获取 Discord ID：在 Discord 中右键点击用户，选择“复制 ID”。
• 执行命令：在游戏内或控制台使用命令：

`/discord2fa addToVerifyList <玩家游戏名> <玩家的 Discord ID>`

添加后，该玩家下次登录时就需要进行验证。

玩家如何进行验证？

• 玩家加入服务器后，会进入验证状态，并收到一条包含验证码的 Discord 私信。
• 玩家必须在游戏内使用以下命令完成验证：

`/auth <验证码>`

• 如果验证码正确，玩家即可正常游戏。

管理验证列表

• 查看列表：/discord2fa verifyList
• 移除玩家：/discord2fa removeFromVerifyList <玩家游戏名>
• 生成备用代码：/discord2fa generateBackupCodes <玩家游戏名>

- **注意**：生成新的备用代码会覆盖旧的代码。

• 手动移除验证状态：/discord2fa removeFromCheck <玩家游戏名> （用于将已验证玩家移出“检查”状态）

⭐命令列表

管理员命令

权限节点：discord2fa.admin

• /discord2fa addToVerifyList <player> <discord id> – 添加玩家到验证列表。
• /discord2fa removeFromVerifyList <player> – 从验证列表移除玩家。
• /discord2fa verifyList – 查看验证列表。
• /discord2fa generateBackupCodes <player> – 为玩家生成备用代码。
• /discord2fa removeFromCheck <player> – 将玩家移出检查状态。
• /discord2fa reloadConfig – 重载插件配置。
• /discord2fa enable – 启用插件。
• /discord2fa disable – 禁用插件。

玩家命令

无需特殊权限，仅在需要验证时可用。

• /auth <code> – 输入收到的验证码进行身份验证。

✨配置文件摘要

以下为 config.yml 的核心配置项概览：

数据库 (MySQL)

• mysql.enabled: 是否启用 MySQL 存储（默认 false）。

机器人设置

• bot-token: 你的 Discord 机器人令牌。
• bot-activity.enabled: 是否设置机器人状态。

验证设置

• auth-countdown: 验证倒计时时间（秒）。
• number-of-rights: 允许输入错误验证码的次数。
• rights-reached-console-command: 尝试次数用尽后执行的命令（例如：tempban %player% 20m 2FA Failed）。
• auto-verification: 是否启用自动验证。
• code-length: 验证码长度。
• code-type: 验证码类型（如 NUMERIC）。

插件兼容性

• authme-support: 是否启用 AuthMe 支持。
• loginsecurity-support: 是否启用 LoginSecurity 支持。

事件限制

可配置在验证期间是否取消特定事件（如使用命令、破坏方块、聊天等），并可设置白名单。

消息文本

所有游戏内提示信息、踢出信息、Discord 私信格式等均可在此部分完全自定义。

❓权限

• discord2fa.admin – 允许使用所有 /discord2fa 子命令。
• /auth 命令无需特定权限，任何处于“检查状态”的玩家均可使用。

🔧支持与联系

• 支持的插件：AuthMe (authme-support)、LoginSecurity (loginsecurity-support)。
• 问题反馈：如有问题，可通过 Discord 联系开发者：Umut Erarslan#8378。

使用示例服务器：SkyCraft (Skycraft.es)