MCLocalAuth

插件

· 作者 UNGEUR

MCLocalAuth 是一款面向 Minecraft 服务器的安全插件,使用 Discord 作为认证系统。通过限制访问权限,仅允许你的 Discord 社区成员加入服务器,从而保护你的服务器。

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

最新 1.4.1.1 · 26.2 · Velocity

一键开服(送7天)

?️ MCLocalAuth

集成 Discord 机器人的 Minecraft 身份验证插件


? 描述

MCLocalAuth 是一款 Minecraft 服务器安全插件,使用 Discord 作为身份验证系统。通过限制仅允许你的 Discord 社区成员访问,来保护你的服务器。

支持 Spigot/Paper、BungeeCord 和 Velocity —— Discord 机器人在这三个平台上均可运行并具备所有功能。

? 工作原理

  1. 玩家连接 → 立即断开连接并获得一个唯一代码
  2. 在 Discord 上 → 输入 /mclogin <code>(在服务器上或在机器人的私聊中)
  3. 机器人验证 → 该玩家是否为 Discord 成员?
  4. 如果是 → 注册 IP,允许重新连接 ✅
  5. 如果否 → 阻止 ❌

? 使用统计

Spigot / Paper :

BungeeCord :

Velocity :


✨ 特性

? 三重安全层

  • ✅ 需要 Discord:只有你的 Discord 成员才能游玩
  • ✅ 临时代码:每次连接都会生成一个过期的唯一代码
  • ✅ IP 保护:一个用户名 = 一个 IP → 无法窃取身份

? 集成 Discord 机器人

  • 随服务器自动启动
  • 无需托管外部机器人
  • 无需打开网络端口
  • 原生 Discord 斜杠命令
  • 支持 Spigot/Paper、BungeeCord 和 Velocity
  • 支持在私聊中使用命令(全局注册)
  • 启动时自动验证机器人状态

?️ 灵活的存储

  • YAML(默认):本地 data.yml 文件
  • MySQL(可选):跨服务器的共享数据库
  • 非常适合多服务器网络(BungeeCord/Velocity)

? 自动更新检查器

  • 启动时检查 Modrinth API
  • 如果有新版本可用,会在控制台通知

? Geyser/Bedrock 支持

  • 自动检测 Bedrock 玩家
  • 适配的踢出消息(无颜色代码)

? Discord 命令

命令 描述 权限
/mclogin <code> 使用在游戏中获得的代码进行身份验证 所有人
/mctest 测试机器人 ↔ 插件连接 所有人
/status 检查你的身份验证状态 所有人
/unlink <discord_id> 解除账户关联 管理员
/mcadmin showips <player> 查看已授权的 IP 管理员
/mcadmin addip <player> <ip> 添加已授权的 IP 管理员
/mcadmin removeip <player> <ip> 移除已授权的 IP 管理员
/mcadmin resetip <player> 重置所有 IP 管理员
/mcadmin setip <player> <ip> 设置主 IP 管理员

管理员命令仅限于在 config.yml 的 admin.discord_id 中设置的 Discord ID。

⚙️ 游戏内管理员命令

命令 Spigot/Paper BungeeCord Velocity
/auth showips <player> ✅ ✅ ✅
/auth addip <player> <ip> ✅ ✅ ✅
/auth removeip <player> <ip> ✅ ✅ ✅
/auth resetip <player> ✅ ✅ ✅
/auth setip <player> <ip> ✅ ✅ ✅

? 安装

前置条件

  • Minecraft 服务器 1.8.9 到 26.2 (Spigot, Paper, Purpur)、BungeeCord 或 Velocity 3.3.0+
  • Java 8 及以上版本 (Spigot/BungeeCord) · Java 17 及以上版本 (Velocity)
  • 已在 Discord Developer Portal 配置好的 Discord 机器人

Spigot / Paper / BungeeCord

  1. 下载 MCLocalAuth-v1.4.1.jar
  2. 放置 文件到你的服务器 plugins/ 文件夹中
  3. 启动 服务器以生成配置文件
  4. 配置 plugins/MCLocalAuth/config.yml 中的 Discord 机器人:
discord:
  enabled: true
  bot_token: "YOUR_DISCORD_BOT_TOKEN"
  guild_id: "YOUR_DISCORD_SERVER_ID"
  invite_link: ""

admin:
  discord_id: "YOUR_DISCORD_ID"

storage:
  type: "yaml"       # yaml 或 mysql
  mysql:
    host: "localhost"
    port: 3306
    database: "mclocalauth"
    username: "root"
    password: ""
  1. 重启 服务器
  2. 测试 在 Discord 上使用 /mctest

Velocity

  1. 下载 MCLocalAuth-Velocity-v1.4.1.jar
  2. 放置 在你的代理服务器 plugins/ 文件夹中
  3. 配置 plugins/mclocalauth/config.yml
  4. 重启 代理服务器

? 配置

Discord 机器人设置

  1. 前往 Discord Developer Portal
  2. 创建一个新的应用
  3. Bot 选项卡 → 创建机器人
  4. 复制令牌(切勿分享!)
  5. 启用以下 特权网关意图 (Privileged Gateway Intents):
    • ✅ 服务器成员意图 (Server Members Intent)
    • ✅ 消息内容意图 (Message Content Intent)(可选)
  6. OAuth2 → URL Generator 选项卡:
    • 勾选 bot 和 applications.commands
    • 权限:Administrator(或自定义)
  7. 使用生成的 URL 邀请 机器人到你的服务器

获取 Discord 服务器 ID

  1. 在 Discord 中启用 开发者模式:
    • 设置 → 高级 → 开发者模式
  2. 右键点击你的服务器 → 复制服务器 ID
  3. 粘贴到 config.yml 中的 guild_id

Java: 8+ (Spigot/BungeeCord) · 17+ (Velocity)
注意: 插件会在启动时自动检测你的 Minecraft 版本。


? 报告 Bug

如果你遇到问题:

  1. 请确认你使用的是最新版本
  2. 查看 现有 Issue
  3. 如果问题仍然存在,请 提交新的 Issue,并附上:
    • 插件版本
    • Minecraft 版本
    • 服务器日志
    • 详细的问题描述

? 建议功能

有新想法?请使用 enhancement 标签 提交 Issue!


? 许可证

本项目采用 专有许可证。详情请参阅 LICENSE 文件。

简要说明:

  • ✅ 可在 Minecraft 服务器上免费使用
  • ✅ 可查看代码以学习
  • ❌ 禁止修改或重新分发
  • ❌ 禁止商业使用

? 致谢

开发者: UNGEUR

使用的库:


? 支持


⭐ 如果本插件对你有用,请不要犹豫给它一个 Star!

为 Minecraft 社区 ❤️ 制作

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源