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

注册页

管理面板

?️ 技术栈
- Java (Bukkit/Spigot/Paper/Folia 插件)
- 前端:Vue3 + Tailwind CSS (支持自定义主题)
- WebSocket 实时通信
- 邮件服务:SMTP
? 安装与配置
- 下载最新的
VerifyMC.jar 并将其放入服务器的 plugins 目录。
- 启动服务器以自动生成配置文件,然后根据需要进行编辑
config.yml(见下方完整示例)。
- 重启服务器并访问
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
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、分享并提供反馈!
?️ VerifyMC
? Introduction
VerifyMC is an ultra-lightweight, powerful whitelist management plugin for Minecraft servers. It supports web-based registration, auto/manual review, banning, theme switching, AuthMe integration, and high customizability, helping you secure and manage your server community with ease.
? Key Features
- ?️ Web Registration & Review: Players can submit whitelist applications via a web page; admins can review, ban, and manage users online.
- ? Auto/Manual Review: Supports both automatic approval and manual admin review to fit different server needs.
- ? Ban System: Ban problematic players to keep your server safe.
- ? GlassX Theme: Beautiful glassmorphism design with smooth animations and modern UI.
- ? Email Verification & Domain Whitelist: Integrated SMTP email verification, supports email domain whitelist and alias limit.
- ? Self-hosted CAPTCHA: Built-in graphical CAPTCHA (math/text) - no external services required.
- ? Discord Integration: OAuth2 Discord account linking with optional/required mode.
- ? Registration Questionnaire: Customizable questionnaire system with multi-language support.
- ? User Notifications: Automatic email notifications for whitelist approval/rejection.
- ? Multi-language Support: Both web UI and plugin messages support English and Chinese.
- ⚙️ Highly Customizable: Set max accounts per email, player ID regex, whitelist bypass IPs, and more.
- ? Lightweight: Plugin jar is under 6MB, integrates multiple features, and runs efficiently.
- ? Auto Update & Backup: Config files auto-upgrade, with full backup before each update.
- ? Flexible Whitelist Modes: Supports Bukkit native whitelist sync, plugin self-management, and MySQL storage.
- ? MySQL & Data File Storage: Easily switch between local file and MySQL storage; supports automatic migration.
- ? Audit Log Multi-Storage: Audit logs can be stored in file or MySQL.
- ? Custom Internationalization: Auto-loads any messages_xx.properties file; users can add any language.
- ? AuthMe Integration: Seamless integration with AuthMe plugin for password management and auto-registration.
- ? Bedrock Support: Geyser/Floodgate player prefix support for cross-platform servers.
- ? Proxy Support: BungeeCord/Velocity proxy plugin for network-level whitelist enforcement.
?️ Screenshots (GlassX Theme)
Home Page

Registration Page

Admin Panel

?️ Tech Stack
- Java (Bukkit/Spigot/Paper/Folia plugin)
- Frontend: Vue3 + Tailwind CSS (custom themes supported)
- WebSocket real-time communication
- Email service: SMTP
? Installation & Configuration
- Download the latest
VerifyMC.jar and place it in your server's plugins directory.
- Start the server to auto-generate config files, then edit
config.yml as needed (see full example below).
- Restart the server and visit
http://your_server_ip:8080 to access the admin panel.
# ----------------------------------------
# General Settings
# ----------------------------------------
# Global language setting. Affects plugin messages and web UI. (e.g., 'zh', 'en')
language: zh
# Enable detailed console logs for troubleshooting.
debug: false
# ----------------------------------------
# Web Server
# ----------------------------------------
# The port for the web interface.
web_port: 8080
# The server name displayed on the web interface.
web_server_prefix: '[ Name ]'
# ----------------------------------------
# Verification & Whitelist
# ----------------------------------------
# Supported authentication methods. Options: 'email' (email verification), 'captcha' (graphical captcha).
# You can use multiple methods, e.g.: [email, captcha]
#
# [IMPORTANT] Configuring the captcha: section below does NOT enable captcha!
# To enable captcha, you MUST add 'captcha' to this list:
# Captcha only: auth_methods: [captcha]
# Both email and captcha: auth_methods: [email, captcha]
auth_methods:
- email
# Maximum number of game accounts that can be linked to a single email address.
max_accounts_per_email: 2
# Whitelist mode: 'bukkit' (syncs with server's whitelist.json) or 'plugin' (uses internal database).
whitelist_mode: plugin
# Registration URL displayed to non-whitelisted players when in 'plugin' mode.
web_register_url: https://domain.com/
# ----------------------------------------
# Registration
# ----------------------------------------
# If true, new user registrations are automatically approved. If false, they require manual admin approval.
register:
auto_approve: false
# ----------------------------------------
# User & Security
# ----------------------------------------
# A regular expression to validate player names.
username_regex: "^[a-zA-Z0-9_-]{3,16}$"
# If false, usernames that only differ by case (e.g., "Player" and "player") are treated as the same.
username_case_sensitive: false
# A list of IP addresses that can join the server without being whitelisted.
whitelist_bypass_ips:
- 127.0.0.1
# The password for accessing the admin panel on the web interface.
admin:
password: your_custom_password
# ----------------------------------------
# User Notification
# ----------------------------------------
# Send email notification to users when admin reviews their application.
user_notification:
# Whether to enable user notification feature
enabled: true
# Whether to send notification when application is approved
on_approve: true
# Whether to send notification when application is rejected
on_reject: true
# ----------------------------------------
# Frontend (UI)
# ----------------------------------------
frontend:
# The visual theme for the web interface. Options: 'glassx'.
theme: glassx
# URL for the logo. Can be a web link or a local file path (e.g., '/logo.png').
logo_url: /logo.png
# A message to display on the homepage.
announcement: Welcome to [ Name ]!
# ----------------------------------------
# Email (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
# Subject (title) of the verification code email
email_subject: VerifyMC Verification Code
# ----------------------------------------
# Sync Settings (for bukkit mode)
# ----------------------------------------
# If true, automatically syncs changes from whitelist.json to the plugin's database.
whitelist_json_sync: true
# If true, automatically adds approved users to whitelist.json and removes banned/deleted users.
auto_sync_whitelist: true
# If 'bukkit' mode is disabled, this setting (if true) cleans players from whitelist.json.
auto_cleanup_whitelist: true
# ----------------------------------------
# Auto Update & Backup
# ----------------------------------------
# If true, automatically adds new settings to your config.yml on plugin updates.
auto_update_config: true
# If true, automatically updates the language files.
auto_update_i18n: true
# If true, automatically updates the email templates.
auto_update_email: true
# If true, automatically updates theme files.
auto_update_static: true
# If true, creates a full backup of the plugin data folder before any auto-updates.
backup_on_update: true
# ----------------------------------------
# Email Registration Restrictions
# ----------------------------------------
# Enable email domain whitelist
enable_email_domain_whitelist: true
# Enable email alias limit (e.g. forbid user+xxx@gmail.com)
enable_email_alias_limit: false
# Email domain whitelist. Leave empty to use default mainstream domains
email_domain_whitelist:
- gmail.com
- 163.com
- 126.com
- qq.com
- outlook.com
- hotmail.com
- icloud.com
- yahoo.com
- foxmail.com
# ----------------------------------------
# Storage & Data Migration
# ----------------------------------------
storage:
# Storage type, options: data (local file), mysql (external database)
type: data
# Whether to automatically migrate data from the original storage to the new storage when switching storage.type (e.g., data→mysql or mysql→data)
auto_migrate_on_switch: false
mysql:
host: localhost
port: 3306
database: verifymc
user: root
password: yourpassword
# ----------------------------------------
# Authme Integration Configuration
# ----------------------------------------
authme:
# Whether to enable Authme integration functionality
enabled: true
# Whether to require password input during web registration
require_password: true
# Whether to automatically register to Authme when approval is granted
auto_register: false
# Whether to automatically unregister from Authme when user is deleted
auto_unregister: false
# Password regex pattern
password_regex: "^[a-zA-Z0-9_]{3,16}$"
# ----------------------------------------
# Captcha Configuration
# ----------------------------------------
# Captcha can be used as an alternative or supplement to email verification
# Add 'captcha' to auth_methods to enable: auth_methods: [captcha]
# Or use both: auth_methods: [email, captcha]
captcha:
# Captcha type: math (math expression) or text (random characters)
type: math
# Length of text captcha (ignored for math type)
length: 4
# Captcha expiration time in seconds
expire_seconds: 300
# ----------------------------------------
# Bedrock Player Support
# ----------------------------------------
# For Geyser/Floodgate bedrock players
bedrock:
# Whether to enable bedrock player support
enabled: false
# Prefix for bedrock players (commonly "." for Floodgate)
prefix: "."
# Regex for bedrock usernames
username_regex: "^\\.[a-zA-Z0-9_\\s]{3,16}$"
# ----------------------------------------
# Questionnaire Configuration
# ----------------------------------------
# Detailed questions are configured in questionnaire.yml
questionnaire:
# Whether to enable questionnaire feature
enabled: false
# Minimum score to pass
pass_score: 60
# Auto-approve users who pass the questionnaire
auto_approve_on_pass: false
# ----------------------------------------
# Discord Integration (OAuth2)
# ----------------------------------------
# Requires creating a Discord application at https://discord.com/developers/applications
discord:
# Whether to enable Discord integration
enabled: false
# Discord application client ID
client_id: ""
# Discord application client secret
client_secret: ""
# OAuth2 redirect URI
redirect_uri: "https://yourdomain.com/api/discord/callback"
# Optional: require users to be in specific guild/server
guild_id: ""
# Whether Discord linking is required for registration
required: false
? Official Community
- QQ Group: 1041540576 (Join)
- Discord:
❤️ If you like this project, please Star, share, and give us feedback!
评论 0
登录后参与评分
还没有评论,来抢沙发吧