VerifyMC
项目简介
VerifyMC 是一款极致轻量、功能强大的 Minecraft 服务器白名单管理插件，支持网页注册、自动/手动审核、封禁、主题切换、AuthMe 集成与高度自定义，助力服务器安全与社区管理。
主要功能
- 网页注册与审核 - 玩家可通过网页提交白名单申请，管理员可在线审核、封禁、管理玩家
- 自动/手动审核 - 支持自动通过或管理员手动审核，灵活适配不同服务器需求
- 封禁系统 - 支持对违规玩家进行封禁，保障服务器安全
- GlassX 主题 - 精美的玻璃拟态设计，流畅动画与现代化界面
- 邮件验证与域名白名单 - 集成 SMTP 邮箱验证码，支持邮箱域名白名单与别名限制
- 自托管图形验证码 - 内置图形验证码（数学题/文字），无需外部服务
- Discord 集成 - OAuth2 Discord 账户绑定，支持可选/强制模式
- 注册问卷 - 可自定义问卷系统，支持多语言
- 用户通知 - 白名单审核通过/拒绝时自动发送邮件通知
- 多语言支持 - 支持中英文界面与消息
- 高度定制化 - 自定义单邮箱账号上限、玩家ID正则、免白名单IP等
- 轻量级 - 插件本体体积小于6MB，集成多种功能，运行高效
- 自动更新与备份 - 配置文件自动升级，升级前自动备份数据
- 灵活白名单模式 - 支持 Bukkit 原生白名单同步、插件自管理，以及 MySQL 存储
- MySQL 与本地文件存储 - 可在配置中自由切换本地文件和 MySQL 存储，支持自动迁移
- 审核日志多存储 - 审核日志可存储于本地文件或 MySQL
- 自定义多语言国际化 - 自动加载任意 messages_xx.properties 文件，用户可自定义任意语言
- AuthMe 集成 - 与 AuthMe 插件无缝集成，支持密码管理和自动注册
- 基岩版支持 - 支持 Geyser/Floodgate 玩家前缀，实现跨平台服务器兼容
- 代理支持 - BungeeCord/Velocity 代理插件，实现群组级白名单管控
- LLM 问答评分 - AI 驱动的文本问答自动评分，支持 DeepSeek/Google，内置熔断器与并发控制
截图预览（GlassX 主题）
首页
注册页
管理后台
技术栈
- Java（Bukkit/Spigot/Paper/Folia 插件）
- 前端：Vue3 + Tailwind CSS（支持自定义主题）
- WebSocket 实时通信
- 邮件服务：SMTP
bStats
安装与配置
- 下载最新版
VerifyMC.jar，放入服务器plugins目录。 - 启动服务器自动生成配置文件，按需编辑
config.yml（见下方完整示例）。 - 重启服务器，访问
http://你的服务器IP:8080进入管理后台。
yaml
language: zh
debug: false
web_port: 8080
web_server_prefix: '[ Name ]'
auth_methods:
- email
max_accounts_per_email: 2
whitelist_mode: plugin
web_register_url: https://domain.com/
register:
auto_approve: false
username_regex: "^[a-zA-Z0-9_-]{3,16}$"
username_case_sensitive: false
admin:
password: your_custom_password
user_notification:
enabled: true
on_approve: true
on_reject: true
frontend:
theme: glassx
logo_url: /logo.png
announcement: 欢迎来到 [ Name ]!
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 Verification Code
auto_update_resources: 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:
host: localhost
port: 3306
database: verifymc
user: root
password: yourpassword
authme:
enabled: true
require_password: true
password_regex: "^[a-zA-Z0-9_]{8,26}$"
database:
type: sqlite
table: authme
sync_interval_seconds: 30
mysql:
host: 127.0.0.1
port: 3306
database: authme
user: root
password: yourpassword
sqlite:
path: plugins/AuthMe/authme.db
columns:
mySQLColumnName: username
mySQLRealName: realname
mySQLColumnPassword: password
mySQLColumnEmail: email
captcha:
type: math
length: 4
expire_seconds: 300
bedrock:
enabled: false
prefix: "."
username_regex: "^[a-zA-Z0-9._-]{3,15}$"
questionnaire:
enabled: false
pass_score: 60
rate_limit:
window_ms: 300000
ip:
max: 20
uuid:
max: 8
email:
max: 6
llm:
enabled: true
provider: deepseek
api_base: https://api.deepseek.com/v1
api_key: ""
model: deepseek-chat
timeout: 10000
retry: 1
max_concurrency: 4
acquire_timeout: 1500
retry_backoff_base: 300
retry_backoff_max: 5000
input_max_length: 2000
circuit_breaker:
failure_threshold: 5
open_ms: 30000
system_prompt: |
You are a fair Minecraft whitelist questionnaire grader.
Score strictly based on the question, candidate answer, and scoring rule.
Return JSON only.
scoring_rule: |
Evaluate primarily:
1) Relevance to the question
2) Completeness and level of detail
3) Understanding of server rules and community norms
score_format: '{"score": number, "reason": string, "confidence": number}'
discord:
enabled: false
client_id: ""
client_secret: ""
redirect_uri: "https://yourdomain.com/api/discord/callback"
guild_id: ""
required: false官方社区
- QQ 群: 1041540576 (点击加入)
- Discord: https://discord.gg/dcsBw5Z5ZT
如果你喜欢本项目，欢迎 Star、分享与反馈！