
让白名单全自动运行。DiscordID 无缝连接 Discord 账号与 Minecraft Java & Bedrock 配置文件,让你的社区成员能够自行验证并加入服务器。无需等待时间,也无需管理员投入额外精力。
由 优化后的异步架构 驱动,加入检查通常耗时不到 20ms,确保连接即时且无延迟。管理你的服务器同样快速,提供游戏内交互式设置和直观 GUI 菜单,触手可及。

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

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

命令与权限
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: 启用绕过列表。
鸣谢

Put your whitelist on autopilot. DiscordID seamlessly connects Discord accounts to Minecraft Java & Bedrock profiles, allowing your community members to verify and join on their own. Zero wait times or admin overhead.
Powered by an optimized asynchronous architecture, join checks typically take less than 20ms, keeping connections instant and lag-free. Managing your server is just as fast, featuring an in-game interactive setup and intuitive GUI menus right at your fingertips.

- Guild Verification: Only allow players who are members of a specific Discord server to join.
- Online Roles: Assign an online role to players while they are connected to the Minecraft server.
- Seamless Linking: Players can connect to the server, enter the
/linkcommand on Discord, and be allowed in without having to reconnect. - Interactive Setup: Easily set up the bot and link your Discord server right from in-game using
/discord setup. - In-Game Menus: View linked players and manage your integrations using elegant in-game GUIs.
- Secure Sessions (Optional): Require players to verify login attempts from unknown IP addresses via Discord DM. This effectively prevents impersonation on cracked servers.
- Update Notifications: Notifies you when a new version of DiscordID is available on Modrinth.
- Automatic Migration: DiscordID automatically migrates your old links and configuration to the new format and creates a backup so you can easily roll back if needed.
- Floodgate Support: Experimental compatibility with Floodgate (Geyser) for Bedrock players.
How it Works
When an unlinked player attempts to join the Minecraft server, their connection is blocked and they are shown a screen with a 4-character verification code. The player must then go to your Discord server and run the /link <code> command.
Once executed, their Minecraft profile is linked to their Discord account, and they are immediately allowed onto the server without needing to reconnect.

⚙️ Discord Bot Setup
You need to create a dedicated Discord application for DiscordID to function.
- Go to the Discord Developer Portal and click New Application.
- Navigate to the Bot tab in the left sidebar.
- CRITICAL: Scroll down to Privileged Gateway Intents and enable the Server Members Intent. If this is off, DiscordID cannot check if users are in your server or assign roles.
- Click Reset Token to get your bot token. Copy this and paste it into the
discordTokenfield in yourconfig.yml. - Navigate to OAuth2 -> URL Generator.
- Under Scopes, select
bot. - Under Bot Permissions, select Manage Roles (this is strictly required if you want the bot to assign online roles or require specific roles to join).
- Copy the generated URL at the bottom, paste it into your browser, and authorize the bot to join your server.
- Get your server's ID by right-clicking your server icon (requires Developer Mode enabled in Discord) and selecting "Copy Server ID". Paste this into
guildIDin your config. - Role Hierarchy: If you use the online role feature, open your Discord Server Settings -> Roles, and drag your Bot's role above the online role you want it to assign.

Commands & Permissions
Discord Commands
/link <code>-> Links your Discord account to a Minecraft profile using the verification code./link-> Displays the connected Minecraft profile(s) for the server./unlink-> Unlinks your profile. If multiple profiles are linked, a dropdown will appear./unlink <profile>-> Unlinks a specific profile by its name or UUID.
Minecraft Commands (Player)
/discord-> Shows information about your current link./discord unlink-> Unlinks the current profile from its Discord account. (Default Permission: did.unlink)
Minecraft Commands (Admin)
/discord list-> Shows all links on this server. (Permission: did.manage)/discord unlink <profile>-> Unlinks a specific profile. (Permission: did.manage.unlink)/discord link <profile> <account>-> Link a specific profile by name/UUID to a specific Discord account by name/ID. (Permission: did.manage.link)/discord setup-> Interactive setup menu for configuring the Discord bot and guild. (Permission: did.manage.setup)/discord rules-> Shows which join rules are currently active. (Permission: did.manage.rules)/discord cleanup-> Cleans up stale links. (Permission: did.manage.cleanup)/discord reload-> Reloads the config and restarts the bot. (Permission: did.manage.reload)/discord bypass-> Shows information about bypassed players. (Permission: did.manage.bypass)/discord bypass <on/off>-> Enabled or disabled bypass. (Permission: did.manage.bypass.toggle)/discord bypass add <player>-> Adds a player to the bypass list. (Permission: did.manage.bypass.add)/discord bypass remove <player>-> Removes a player from the bypass list. (Permission: did.manage.bypass.remove)
Configuration
Authentication
- discordToken: Your Discord bot token from the Developer Portal.
- guildID: The ID of your Discord server.
Join Rules
- requireLinked: Enforces the plugin. Only profiles linked to a Discord account are allowed to join.
- requireMember: Only members of the configured
guildIDare allowed to join. - alwaysAllowWhitelisted: Players on the server's vanilla whitelist bypass ALL DiscordID requirements - linking, guild membership, and role checks included. Only enable this if you understand that whitelisted players skip Discord verification entirely.
- alwaysAllowOperators: Server Operators bypass all DiscordID requirements.
- showLinkedMsg: Shows a message to the player upon joining detailing which Discord account they are linked to.
- allowMultiLink: Allows one Discord account to link to multiple Minecraft profiles.
- allowJavaBedrockLink: Allows one Discord account to link to exactly one Java and one Bedrock profile.
- allowMultiSession: Allows multiple profiles linked to the same Discord account to be online simultaneously.
- enforceSessionAuthorization: Players joining from a new IP address must authorize the session via Discord DM.
- sessionDuration: Time in minutes before a player has to re-authenticate an IP session.
Discord
- assignOnlineRole: Enables assigning a Discord role to players while they are online.
- onlineRoleId: The Discord Role ID to assign. Your Bot's role must be above this role on Discord.
- requireDiscordRole: Requires users to have a specific Discord role to join the Minecraft server. (Set to 0 to disable).
Bypass
- allowBypass: Enables the bypass list.
Credits
下载 DiscordID | 白名单与双重认证
下载 DiscordID | 白名单与双重认证
下载 DiscordID | 白名单与双重认证
下载 DiscordID | 白名单与双重认证
下载 DiscordID | 白名单与双重认证
下载 DiscordID | 白名单与双重认证
下载 DiscordID | 白名单与双重认证
下载 DiscordID | 白名单与双重认证
下载 DiscordID | 白名单与双重认证
下载 DiscordID | 白名单与双重认证
⚙️ 2.1.2 版本更新内容
DiscordID 2.1.2 是一个热修复版本,用于解决可能导致 DiscordID 错误重新初始化的关键性 Bug。
更新日志
- 修复了与插件激活和反射扫描相关的问题,该问题可能导致插件失去已激活状态并停止工作
- 增加了额外的安全措施,防止在 DiscordID 遇到错误时发生未授权的加入行为
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧