# \ud83d\udee1\ufe0f VerifyMC<\/p>\n
## \ud83d\ude80 Introduction<\/p>\n
**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.<\/p>\n
—<\/p>\n
## \ud83d\udcdd Key Features<\/p>\n
1. \ud83d\udda5\ufe0f **Web Registration & Review**: Players can submit whitelist applications via a web page; admins can review, ban, and manage users online.
\n2. \ud83d\udd12 **Auto\/Manual Review**: Supports both automatic approval and manual admin review to fit different server needs.
\n3. \ud83d\udeab **Ban System**: Ban problematic players to keep your server safe.
\n4. \ud83c\udfa8 **GlassX Theme**: Beautiful glassmorphism design with smooth animations and modern UI.
\n5. \ud83d\udce8 **Email Verification & Domain Whitelist**: Integrated SMTP email verification, supports email domain whitelist and alias limit.
\n6. \ud83d\udd10 **Self-hosted CAPTCHA**: Built-in graphical CAPTCHA (math\/text) – no external services required.
\n7. \ud83c\udfae **Discord Integration**: OAuth2 Discord account linking with optional\/required mode.
\n8. \ud83d\udccb **Registration Questionnaire**: Customizable questionnaire system with multi-language support.
\n9. \ud83d\udce7 **User Notifications**: Automatic email notifications for whitelist approval\/rejection.
\n10. \ud83c\udf10 **Multi-language Support**: Both web UI and plugin messages support English and Chinese.
\n11. \u2699\ufe0f **Highly Customizable**: Set max accounts per email, player ID regex, whitelist bypass IPs, and more.
\n12. \ud83e\udeb6 **Lightweight**: Plugin jar is under 6MB, integrates multiple features, and runs efficiently.
\n13. \ud83d\udd04 **Auto Update & Backup**: Config files auto-upgrade, with full backup before each update.
\n14. \ud83e\udde9 **Flexible Whitelist Modes**: Supports Bukkit native whitelist sync, plugin self-management, and MySQL storage.
\n15. \ud83d\udcbe **MySQL & Data File Storage**: Easily switch between local file and MySQL storage; supports automatic migration.
\n16. \ud83d\udcdd **Audit Log Multi-Storage**: Audit logs can be stored in file or MySQL.
\n17. \ud83c\udf0d **Custom Internationalization**: Auto-loads any messages_xx.properties file; users can add any language.
\n18. \ud83d\udd10 **AuthMe Integration**: Seamless integration with AuthMe plugin for password management and auto-registration.
\n19. \ud83c\udfae **Bedrock Support**: Geyser\/Floodgate player prefix support for cross-platform servers.
\n20. \ud83d\udd17 **Proxy Support**: BungeeCord\/Velocity proxy plugin for network-level whitelist enforcement.<\/p>\n
—<\/p>\n
## \ud83d\uddbc\ufe0f Screenshots (GlassX Theme)<\/p>\n
### Home Page
\n<\/p>\n
### Registration Page
\n<\/p>\n
### Admin Panel
\n<\/p>\n
—<\/p>\n
## \ud83d\udee0\ufe0f Tech Stack<\/p>\n
– Java (Bukkit\/Spigot\/Paper\/Folia plugin)
\n– Frontend: Vue3 + Tailwind CSS (custom themes supported)
\n– WebSocket real-time communication
\n– Email service: SMTP<\/p>\n
—<\/p>\n
## \ud83d\udce6 Installation & Configuration<\/p>\n
1. Download the latest `VerifyMC.jar` and place it in your server’s `plugins` directory.
\n2. Start the server to auto-generate config files, then edit `config.yml` as needed (see full example below).
\n3. Restart the server and visit `http:\/\/your_server_ip:8080` to access the admin panel.<\/p>\n
“`yaml
\n# —————————————-
\n# General Settings
\n# —————————————-
\n# Global language setting. Affects plugin messages and web UI. (e.g., ‘zh’, ‘en’)
\nlanguage: zh
\n# Enable detailed console logs for troubleshooting.
\ndebug: false<\/p>\n
# —————————————-
\n# Web Server
\n# —————————————-
\n# The port for the web interface.
\nweb_port: 8080
\n# The server name displayed on the web interface.
\nweb_server_prefix: ‘[ Name ]’<\/p>\n
# —————————————-
\n# Verification & Whitelist
\n# —————————————-
\n# Supported authentication methods. Options: ’email’ (email verification), ‘captcha’ (graphical captcha).
\n# You can use multiple methods, e.g.: [email, captcha]
\n#
\n# [IMPORTANT] Configuring the captcha: section below does NOT enable captcha!
\n# To enable captcha, you MUST add ‘captcha’ to this list:
\n# Captcha only: auth_methods: [captcha]
\n# Both email and captcha: auth_methods: [email, captcha]
\nauth_methods:
\n – email
\n# Maximum number of game accounts that can be linked to a single email address.
\nmax_accounts_per_email: 2
\n# Whitelist mode: ‘bukkit’ (syncs with server’s whitelist.json) or ‘plugin’ (uses internal database).
\nwhitelist_mode: plugin
\n# Registration URL displayed to non-whitelisted players when in ‘plugin’ mode.
\nweb_register_url: https:\/\/domain.com\/<\/p>\n
# —————————————-
\n# Registration
\n# —————————————-
\n# If true, new user registrations are automatically approved. If false, they require manual admin approval.
\nregister:
\n auto_approve: false<\/p>\n
# —————————————-
\n# User & Security
\n# —————————————-
\n# A regular expression to validate player names.
\nusername_regex: “^[a-zA-Z0-9_-]{3,16}$”
\n# If false, usernames that only differ by case (e.g., “Player” and “player”) are treated as the same.
\nusername_case_sensitive: false
\n# A list of IP addresses that can join the server without being whitelisted.
\nwhitelist_bypass_ips:
\n – 127.0.0.1
\n# The password for accessing the admin panel on the web interface.
\nadmin:
\n password: your_custom_password<\/p>\n
# —————————————-
\n# User Notification
\n# —————————————-
\n# Send email notification to users when admin reviews their application.
\nuser_notification:
\n # Whether to enable user notification feature
\n enabled: true
\n # Whether to send notification when application is approved
\n on_approve: true
\n # Whether to send notification when application is rejected
\n on_reject: true<\/p>\n
# —————————————-
\n# Frontend (UI)
\n# —————————————-
\nfrontend:
\n # The visual theme for the web interface. Options: ‘glassx’.
\n theme: glassx
\n # URL for the logo. Can be a web link or a local file path (e.g., ‘\/logo.png’).
\n logo_url: \/logo.png
\n # A message to display on the homepage.
\n announcement: Welcome to [ Name ]!<\/p>\n
# —————————————-
\n# Email (SMTP)
\n# —————————————-
\nsmtp:
\n host: smtp.qq.com
\n port: 587
\n username: your_email@qq.com
\n password: your_email_password
\n from: your_email@qq.com
\n enable_ssl: true
\n# Subject (title) of the verification code email
\nemail_subject: VerifyMC Verification Code<\/p>\n
# —————————————-
\n# Sync Settings (for bukkit mode)
\n# —————————————-
\n# If true, automatically syncs changes from whitelist.json to the plugin’s database.
\nwhitelist_json_sync: true
\n# If true, automatically adds approved users to whitelist.json and removes banned\/deleted users.
\nauto_sync_whitelist: true
\n# If ‘bukkit’ mode is disabled, this setting (if true) cleans players from whitelist.json.
\nauto_cleanup_whitelist: true<\/p>\n
# —————————————-
\n# Auto Update & Backup
\n# —————————————-
\n# If true, automatically adds new settings to your config.yml on plugin updates.
\nauto_update_config: true
\n# If true, automatically updates the language files.
\nauto_update_i18n: true
\n# If true, automatically updates the email templates.
\nauto_update_email: true
\n# If true, automatically updates theme files.
\nauto_update_static: true
\n# If true, creates a full backup of the plugin data folder before any auto-updates.
\nbackup_on_update: true <\/p>\n
# —————————————-
\n# Email Registration Restrictions
\n# —————————————-
\n# Enable email domain whitelist
\nenable_email_domain_whitelist: true
\n# Enable email alias limit (e.g. forbid user+xxx@gmail.com)
\nenable_email_alias_limit: false
\n# Email domain whitelist. Leave empty to use default mainstream domains
\nemail_domain_whitelist:
\n – gmail.com
\n – 163.com
\n – 126.com
\n – qq.com
\n – outlook.com
\n – hotmail.com
\n – icloud.com
\n – yahoo.com
\n – foxmail.com <\/p>\n
# —————————————-
\n# Storage & Data Migration
\n# —————————————-
\nstorage:
\n # Storage type, options: data (local file), mysql (external database)
\n type: data
\n # Whether to automatically migrate data from the original storage to the new storage when switching storage.type (e.g., data\u2192mysql or mysql\u2192data)
\n auto_migrate_on_switch: false
\n mysql:
\n host: localhost
\n port: 3306
\n database: verifymc
\n user: root
\n password: yourpassword <\/p>\n
# —————————————-
\n# Authme Integration Configuration
\n# —————————————-
\nauthme:
\n # Whether to enable Authme integration functionality
\n enabled: true
\n # Whether to require password input during web registration
\n require_password: true
\n # Whether to automatically register to Authme when approval is granted
\n auto_register: false
\n # Whether to automatically unregister from Authme when user is deleted
\n auto_unregister: false
\n # Password regex pattern
\n password_regex: “^[a-zA-Z0-9_]{3,16}$”<\/p>\n
# —————————————-
\n# Captcha Configuration
\n# —————————————-
\n# Captcha can be used as an alternative or supplement to email verification
\n# Add ‘captcha’ to auth_methods to enable: auth_methods: [captcha]
\n# Or use both: auth_methods: [email, captcha]
\ncaptcha:
\n # Captcha type: math (math expression) or text (random characters)
\n type: math
\n # Length of text captcha (ignored for math type)
\n length: 4
\n # Captcha expiration time in seconds
\n expire_seconds: 300<\/p>\n
# —————————————-
\n# Bedrock Player Support
\n# —————————————-
\n# For Geyser\/Floodgate bedrock players
\nbedrock:
\n # Whether to enable bedrock player support
\n enabled: false
\n # Prefix for bedrock players (commonly “.” for Floodgate)
\n prefix: “.”
\n # Regex for bedrock usernames
\n username_regex: “^\\.[a-zA-Z0-9_\\s]{3,16}$”<\/p>\n
# —————————————-
\n# Questionnaire Configuration
\n# —————————————-
\n# Detailed questions are configured in questionnaire.yml
\nquestionnaire:
\n # Whether to enable questionnaire feature
\n enabled: false
\n # Minimum score to pass
\n pass_score: 60
\n # Auto-approve users who pass the questionnaire
\n auto_approve_on_pass: false<\/p>\n
# —————————————-
\n# Discord Integration (OAuth2)
\n# —————————————-
\n# Requires creating a Discord application at https:\/\/discord.com\/developers\/applications
\ndiscord:
\n # Whether to enable Discord integration
\n enabled: false
\n # Discord application client ID
\n client_id: “”
\n # Discord application client secret
\n client_secret: “”
\n # OAuth2 redirect URI
\n redirect_uri: “https:\/\/yourdomain.com\/api\/discord\/callback”
\n # Optional: require users to be in specific guild\/server
\n guild_id: “”
\n # Whether Discord linking is required for registration
\n required: false<\/p>\n
“`<\/p>\n
—<\/p>\n
## \ud83d\udcac Official Community<\/p>\n
– **QQ Group**: 1041540576 (Join)
\n– **Discord**: https:\/\/discord.gg\/TCn9v88V<\/p>\n
—<\/p>\n
> \u2764\ufe0f If you like this project, please Star, share, and give us feedback!<\/p>\n","protected":false},"excerpt":{"rendered":"
Modern Minecraft whitelist plugin: web registration, email verification, admin review, multi-theme, i18n.<\/p>\n","protected":false},"featured_media":165766,"template":"","meta":{"_minecraft_slug":"verifymc","_minecraft_project_id":"g1yQHQKy","_minecraft_author":"Starry-cbz","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":597,"_minecraft_follows":15,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"verifymc.zip","_minecraft_size_bytes":64009392,"_minecraft_version_count":11,"_minecraft_updated_at":"2026-05-16T10:17:45.168614Z","_minecraft_date_created":"2025-07-28T04:06:41.742585Z","_minecraft_date_modified":"2026-01-29T10:41:41.373420Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/verifymc","_minecraft_icon_attachment_id":165766,"_minecraft_imported_at":"2026-06-09T17:59:29+00:00","_minecraft_import_hash":"63fee216711de08957b232554d6a5391","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,126,127,128,867,129,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-165765","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n