VerifyMC

插件

· 作者 Starry-cbz

现代 Minecraft 白名单插件:网页注册、邮箱验证、管理员审核、多主题、国际化(i18n)。

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

最新 1.7.2 · 26.2 · Bukkit / Folia

一键开服(送7天)

?️ VerifyMC

? 简介

VerifyMC 是一款超轻量级且功能强大的 Minecraft 服务器白名单管理插件。它支持基于网页的注册、自动/手动审核、封禁、主题切换、AuthMe 集成以及高度可定制性,帮助您轻松保障和管理服务器社区安全。


? 主要功能

  1. ?️ 网页注册与审核:玩家可通过网页提交白名单申请;管理员可在线进行审核、封禁及管理用户。
  2. ? 自动/手动审核:支持自动批准和手动管理员审核,以适应不同的服务器需求。
  3. ? 封禁系统:封禁问题玩家,确保服务器安全。
  4. ? GlassX 主题:拥有平滑动画和现代 UI 的美丽毛玻璃设计风格。
  5. ? 邮箱验证与域名白名单:集成 SMTP 邮箱验证,支持邮箱域名白名单及别名限制。
  6. ? 自托管验证码:内置图形验证码(数学/文本),无需依赖外部服务。
  7. ? Discord 集成:支持 OAuth2 Discord 账号绑定,可选或强制模式。
  8. ? 注册问卷:支持多语言的可自定义问卷系统。
  9. ? 用户通知:白名单审批通过或拒绝时自动发送电子邮件通知。
  10. ? 多语言支持:Web 界面和插件消息均支持英文和中文。
  11. ⚙️ 高度可定制:可设置每个邮箱的最大账号数、玩家 ID 正则表达式、白名单绕过 IP 等。
  12. ? 轻量级:插件 jar 包小于 6MB,集成多种功能,运行高效。
  13. ? 自动更新与备份:配置文件自动升级,每次更新前进行完整备份。
  14. ? 灵活的白名单模式:支持 Bukkit 原生白名单同步、插件内部管理以及 MySQL 存储。
  15. ? MySQL 与数据文件存储:可在本地文件和 MySQL 存储之间轻松切换;支持自动迁移。
  16. ? 审计日志多存储:审计日志可存储在文件或 MySQL 中。
  17. ? 自定义国际化:自动加载任何 messages_xx.properties 文件;用户可添加任意语言。
  18. ? AuthMe 集成:与 AuthMe 插件无缝集成,用于密码管理和自动注册。
  19. ? 基岩版支持:支持 Geyser/Floodgate 玩家前缀,适用于跨平台服务器。
  20. ? 代理支持:支持 BungeeCord/Velocity 代理插件,实现网络级别的白名单强制执行。

?️ 截图 (GlassX 主题)

首页

Home GlassX

注册页

Registration GlassX

管理面板

Admin GlassX


?️ 技术栈

  • Java (Bukkit/Spigot/Paper/Folia 插件)
  • 前端:Vue3 + Tailwind CSS (支持自定义主题)
  • WebSocket 实时通信
  • 邮件服务:SMTP

? 安装与配置

  1. 下载最新的 VerifyMC.jar 并将其放入服务器的 plugins 目录。
  2. 启动服务器以自动生成配置文件,然后根据需要进行编辑 config.yml(见下方完整示例)。
  3. 重启服务器并访问 http://your_server_ip:8080 进入管理面板。
# ----------------------------------------
# 常规设置
# ----------------------------------------
# 全局语言设置。影响插件消息和 Web 界面。(例如 'zh', 'en')
language: zh
# 启用详细的控制台日志以便故障排除。
debug: false

# ----------------------------------------
# Web 服务器
# ----------------------------------------
# Web 界面的端口。
web_port: 8080
# Web 界面上显示的服务器名称。
web_server_prefix: '[ Name ]'

# ----------------------------------------
# 验证与白名单
# ----------------------------------------
# 支持的认证方法。选项:'email'(邮箱验证)、'captcha'(图形验证码)。
# 您可以使用多种方法,例如:[email, captcha]
# 
# [重要] 在下方配置 captcha: 部分并不能启用验证码!
# 要启用验证码,您必须在此列表中添加 'captcha':
#   仅验证码:auth_methods: [captcha]
#   同时启用邮箱和验证码:auth_methods: [email, captcha]
auth_methods:
  - email
# 单个邮箱地址可以绑定的最大游戏账号数。
max_accounts_per_email: 2
# 白名单模式:'bukkit'(与服务器 whitelist.json 同步)或 'plugin'(使用内部数据库)。
whitelist_mode: plugin
# 当处于 'plugin' 模式时,向未列入白名单的玩家显示的注册 URL。
web_register_url: https://domain.com/

# ----------------------------------------
# 注册
# ----------------------------------------
# 如果为 true,新用户注册将自动批准。如果为 false,则需要管理员手动批准。
register:
  auto_approve: false

# ----------------------------------------
# 用户与安全
# ----------------------------------------
# 用于验证玩家名称的正则表达式。
username_regex: "^[a-zA-Z0-9_-]{3,16}$"
# 如果为 false,仅大小写不同的用户名(例如 "Player" 和 "player")将被视为相同。
username_case_sensitive: false
# 可以不列入白名单即可加入服务器的 IP 地址列表。
whitelist_bypass_ips:
  - 127.0.0.1
# 访问 Web 界面管理面板的密码。
admin:
  password: your_custom_password

# ----------------------------------------
# 用户通知
# ----------------------------------------
# 当管理员审核其申请时向用户发送电子邮件通知。
user_notification:
  # 是否启用用户通知功能
  enabled: true
  # 是否在申请批准时发送通知
  on_approve: true
  # 是否在申请被拒时发送通知
  on_reject: true

----------------------------------------

前端 (UI)

----------------------------------------

frontend:

Web 界面的视觉主题。选项:'glassx'。

theme: glassx

Logo 的 URL。可以是网络链接或本地文件路径(例如 '/logo.png')。

logo_url: /logo.png

在首页上显示的消息。

announcement: 欢迎来到 [ Name ]!

----------------------------------------

电子邮件 (SMTP)

----------------------------------------

smtp: host: smtp.qq.com port: 587 username: your_email@qq.com password: your_email_password from: your_email@qq.com enable_ssl: true

验证码邮件的主题(标题)

email_subject: VerifyMC 验证码

----------------------------------------

同步设置 (适用于 bukkit 模式)

----------------------------------------

如果为 true,自动将 whitelist.json 中的更改同步到插件数据库。

whitelist_json_sync: true

如果为 true,自动将已批准的用户添加到 whitelist.json,并移除被封禁/删除的用户。

auto_sync_whitelist: true

如果 'bukkit' 模式被禁用,此设置(如果为 true)会清理 whitelist.json 中的玩家。

auto_cleanup_whitelist: true

----------------------------------------

自动更新与备份

----------------------------------------

如果为 true,在插件更新时自动将新设置添加到你的 config.yml 中。

auto_update_config: true

如果为 true,自动更新语言文件。

auto_update_i18n: true

如果为 true,自动更新电子邮件模板。

auto_update_email: true

如果为 true,自动更新主题文件。

auto_update_static: true

如果为 true,在任何自动更新之前创建插件数据文件夹的完整备份。

backup_on_update: true

----------------------------------------

电子邮件注册限制

----------------------------------------

启用电子邮件域名白名单

enable_email_domain_whitelist: true

启用电子邮件别名限制(例如禁止 user+xxx@gmail.com)

enable_email_alias_limit: false

电子邮件域名白名单。留空以使用默认的主流域名

email_domain_whitelist:

  • gmail.com
  • 163.com
  • 126.com
  • qq.com
  • outlook.com
  • hotmail.com
  • icloud.com
  • yahoo.com
  • foxmail.com

----------------------------------------

存储与数据迁移

----------------------------------------

storage:

存储类型,选项:data(本地文件),mysql(外部数据库)

type: data

当切换 storage.type 时(例如 data→mysql 或 mysql→data),是否自动将数据从原始存储迁移到新存储

auto_migrate_on_switch: false mysql: host: localhost port: 3306 database: verifymc user: root password: yourpassword

----------------------------------------

Authme 集成配置

----------------------------------------

authme:

是否启用 Authme 集成功能

enabled: true

是否在网页注册期间要求输入密码

require_password: true

是否在获得批准后自动向 Authme 注册

auto_register: false

是否在用户被删除时自动从 Authme 注销

auto_unregister: false

密码正则表达式模式

password_regex: "^[a-zA-Z0-9_]{3,16}$"

----------------------------------------

验证码配置

----------------------------------------

验证码可用作电子邮件验证的替代或补充

将 'captcha' 添加到 auth_methods 以启用:auth_methods: [captcha]

或者同时使用两者:auth_methods: [email, captcha]

captcha:

验证码类型:math(数学表达式)或 text(随机字符)

type: math

文本验证码的长度(对 math 类型无效)

length: 4

验证码过期时间(秒)

expire_seconds: 300

----------------------------------------

Bedrock 玩家支持

----------------------------------------

用于 Geyser/Floodgate bedrock 玩家

bedrock:

是否启用 bedrock 玩家支持

enabled: false

bedrock 玩家的前缀(Floodgate 通常为 ".")

prefix: "."

bedrock 用户名的正则表达式

username_regex: "^\.[a-zA-Z0-9_\s]{3,16}$"

----------------------------------------

问卷配置

----------------------------------------

详细问题在 questionnaire.yml 中配置

questionnaire:

是否启用问卷功能

enabled: false

及格最低分数

pass_score: 60

自动批准通过问卷的用户

auto_approve_on_pass: false

----------------------------------------

Discord 集成 (OAuth2)

----------------------------------------

需要在 创建 Discord 应用程序

discord:

是否启用 Discord 集成

enabled: false

Discord 应用程序 Client ID

client_id: ""

Discord 应用程序 Client Secret

client_secret: ""

OAuth2 重定向 URI

redirect_uri: "

可选:要求用户必须在特定的公会/服务器中

guild_id: ""

注册是否必须绑定 Discord

required: false


---

## ? 官方社区

- **QQ 群**: 1041540576 ([加入](https://qm.qq.com/q/F7zuhZ7Mze))
- **Discord**: [https://discord.gg/TCn9v88V](https://discord.gg/TCn9v88V)

---

> ❤️ 如果你喜欢这个项目,请 Star、分享并提供反馈!

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源