DiscordID | 白名单与双重认证

插件

原名 DiscordID | Whitelist & 2FA · 作者 Frozdbyte

轻松、基于 Discord 的 Minecraft 白名单和会话安全。

0 本站下载 0 关注 更新于 1 个月前

最新 2.1.2 · 26.3 · Paper

一键开服(送7天)

DiscordID

让白名单全自动运行。DiscordID 无缝连接 Discord 账号与 Minecraft Java & Bedrock 配置文件,让你的社区成员能够自行验证并加入服务器。无需等待时间,也无需管理员投入额外精力。

由 优化后的异步架构 驱动,加入检查通常耗时不到 20ms,确保连接即时且无延迟。管理你的服务器同样快速,提供游戏内交互式设置和直观 GUI 菜单,触手可及。

Features Link in Seconds

  • 公会验证: 仅允许特定 Discord 服务器的成员加入。
  • 在线角色: 当玩家连接到 Minecraft 服务器时,为其分配在线角色。
  • 无缝链接: 玩家可以连接到服务器,在 Discord 中输入 /link 命令,即可在不重新连接的情况下获准进入。
  • 交互式设置: 使用 /discord setup 命令,轻松从游戏内设置机器人并链接你的 Discord 服务器。
  • 游戏内菜单: 通过优雅的游戏内 GUI 查看已链接的玩家并管理你的集成。
  • 安全会话(可选): 要求玩家通过 Discord 私聊验证来自未知 IP 地址的登录尝试。这能有效防止盗版服务器上的冒充行为。
  • 更新通知: 当 Modrinth 上发布新的 DiscordID 版本时,会通知你。
  • 自动迁移: DiscordID 会自动将旧链接和配置迁移到新格式,并创建备份,以便在需要时可以轻松回滚。
  • Floodgate 支持: 实验性兼容 Floodgate (Geyser),适用于 Bedrock 玩家。

工作原理

当未链接的玩家尝试加入 Minecraft 服务器时,其连接会被阻止,并显示一个包含 4 位验证码的屏幕。然后,玩家需要前往你的 Discord 服务器并运行 /link <code> 命令。

执行后,他们的 Minecraft 配置文件将与 Discord 账号关联,并立即被允许进入服务器,无需重新连接。


Installation

⚙️ Discord 机器人设置

你需要为 DiscordID 创建一个专用的 Discord 应用程序才能使其正常运行。

  1. 前往 Discord Developer Portal 并点击 New Application。
  2. 导航到左侧边栏中的 Bot 选项卡。
  3. 关键步骤: 向下滚动到 Privileged Gateway Intents 并启用 Server Members Intent。如果此项关闭,DiscordID 无法检查用户是否在您的服务器中或分配角色。
  4. 点击 Reset Token 获取你的机器人令牌。复制此令牌并将其粘贴到 config.yml 中的 discordToken 字段中。
  5. 导航到 OAuth2 -> URL Generator。
  6. 在 Scopes 下,选择 bot。
  7. 在 Bot Permissions 下,选择 Manage Roles(如果你希望机器人分配在线角色或要求特定角色才能加入,这是严格必需的)。
  8. 复制底部生成的 URL,将其粘贴到浏览器中,并授权机器人加入你的服务器。
  9. 通过右键单击你的服务器图标(需要在 Discord 中启用开发者模式)并选择“Copy Server ID”来获取你的服务器 ID。将此 ID 粘贴到配置中的 guildID。
  10. 角色层级: 如果你使用在线角色功能,打开你的 Discord 服务器设置 -> 角色,并将你的 Bot 的角色拖到你想要它分配的在线角色 上方。

Usage

命令与权限

Discord 命令

  • /link <code> -> 使用验证码将你的 Discord 账号链接到 Minecraft 配置文件。
  • /link -> 显示该服务器连接的 Minecraft 配置文件。
  • /unlink -> 取消链接你的配置文件。如果链接了多个配置文件,会出现下拉菜单。
  • /unlink <profile> -> 通过名称或 UUID 取消链接特定的配置文件。

Minecraft 命令(玩家)

  • /discord -> 显示你当前链接的信息。
  • /discord unlink -> 取消当前配置文件与其 Discord 账号的链接。(默认权限:did.unlink)

Minecraft 命令(管理员)

  • /discord list -> 显示此服务器上的所有链接。(权限:did.manage)
  • /discord unlink <profile> -> 取消链接特定的配置文件。(权限:did.manage.unlink)
  • /discord link <profile> <account> -> 按名称/UUID 将特定的配置文件链接到按名称/ID 指定的特定 Discord 账号。(权限:did.manage.link)
  • /discord setup -> 用于配置 Discord 机器人和公会的交互式设置菜单。(权限:did.manage.setup)
  • /discord rules -> 显示当前激活的加入规则。(权限:did.manage.rules)
  • /discord cleanup -> 清理过期的链接。(权限:did.manage.cleanup)
  • /discord reload -> 重新加载配置并重启机器人。(权限:did.manage.reload)
  • /discord bypass -> 显示关于绕过玩家的详细信息。(权限:did.manage.bypass)
  • /discord bypass <on/off> -> 启用或禁用绕过功能。(权限:did.manage.bypass.toggle)
  • /discord bypass add <player> -> 将玩家添加到绕过列表。(权限:did.manage.bypass.add)
  • /discord bypass remove <player> -> 从绕过列表中移除玩家。(权限:did.manage.bypass.remove)

配置

认证

  • discordToken: 来自 Developer Portal 的 Discord 机器人令牌。
  • guildID: 你的 Discord 服务器的 ID。

加入规则

  • requireLinked: 强制启用插件。仅允许已绑定 Discord 账号的玩家加入。
  • requireMember: 仅允许配置了 guildID 的服务器成员加入。
  • alwaysAllowWhitelisted: 位于服务器原版白名单中的玩家可绕过所有 DiscordID 要求——包括绑定、公会成员资格及角色检查。仅在您理解白名单玩家完全跳过 Discord 验证的情况下启用此选项。
  • alwaysAllowOperators: 服务器管理员(Operators)可绕过所有 DiscordID 要求。
  • showLinkedMsg: 玩家加入时显示一条消息,详细说明其绑定的 Discord 账号。
  • allowMultiLink: 允许一个 Discord 账号绑定多个 Minecraft 个人资料。
  • allowJavaBedrockLink: 允许一个 Discord 账号分别绑定恰好一个 Java 版和一个基岩版(Bedrock)的个人资料。
  • allowMultiSession: 允许绑定到同一 Discord 账号的多个个人资料同时在线。
  • enforceSessionAuthorization: 从新 IP 地址加入的玩家必须通过 Discord 私聊授权该会话。
  • sessionDuration: 玩家在重新认证 IP 会话前所需的分钟数。

Discord

  • assignOnlineRole: 启用为玩家分配 Discord 角色的功能(在其在线期间)。
  • onlineRoleId: 要分配的 Discord 角色 ID。您的机器人角色在 Discord 层级中必须高于此角色。
  • requireDiscordRole: 要求用户拥有特定的 Discord 角色才能加入 Minecraft 服务器。(设置为 0 以禁用)。

绕过

  • allowBypass: 启用绕过列表。

鸣谢

  • Fruxz 为 DiscordID 运行的许多核心库编写了代码。
  • MCHeads 提供了 Discord 交互中使用的 Minecraft 头像。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源