VerifyMC

# 🛡️ 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 1. 🖥️ **Web Registration & Review**: Players can submit whitelist applications via a web page; admins can review, ban, and manage users online. 2. 🔒 **Auto/Manual Review**: Supports both automatic approval and manual admin review to fit different server needs. 3. 🚫 **Ban System**: Ban problematic players to keep your server safe. 4. 🎨 **GlassX Theme**: Beautiful glassmorphism design with smooth animations and modern UI. 5. 📨 **Email Verification & Domain Whitelist**: Integrated SMTP email verification, supports email domain whitelist and alias limit. 6. 🔐 **Self-hosted CAPTCHA**: Built-in graphical CAPTCHA (math/text) - no external services required. 7. 🎮 **Discord Integration**: OAuth2 Discord account linking with optional/required mode. 8. 📋 **Registration Questionnaire**: Customizable questionnaire system with multi-language support. 9. 📧 **User Notifications**: Automatic email notifications for whitelist approval/rejection. 10. 🌐 **Multi-language Support**: Both web UI and plugin messages support English and Chinese. 11. ⚙️ **Highly Customizable**: Set max accounts per email, player ID regex, whitelist bypass IPs, and more. 12. 🪶 **Lightweight**: Plugin jar is under 6MB, integrates multiple features, and runs efficiently. 13. 🔄 **Auto Update & Backup**: Config files auto-upgrade, with full backup before each update. 14. 🧩 **Flexible Whitelist Modes**: Supports Bukkit native whitelist sync, plugin self-management, and MySQL storage. 15. 💾 **MySQL & Data File Storage**: Easily switch between local file and MySQL storage; supports automatic migration. 16. 📝 **Audit Log Multi-Storage**: Audit logs can be stored in file or MySQL. 17. 🌍 **Custom Internationalization**: Auto-loads any messages_xx.properties file; users can add any language. 18. 🔐 **AuthMe Integration**: Seamless integration with AuthMe plugin for password management and auto-registration. 19. 🎮 **Bedrock Support**: Geyser/Floodgate player prefix support for cross-platform servers. 20. 🔗 **Proxy Support**: BungeeCord/Velocity proxy plugin for network-level whitelist enforcement. --- ## 🖼️ Screenshots (GlassX Theme) ### Home Page !(https://verifymc.cn-nb1.rains3.com/docs/screenshot-home-glassx.png) ### Registration Page !(https://verifymc.cn-nb1.rains3.com/docs/screenshot-register-glassx.png) ### Admin Panel !(https://verifymc.cn-nb1.rains3.com/docs/screenshot-admin-glassx.png) --- ## 🛠️ Tech Stack - Java (Bukkit/Spigot/Paper/Folia plugin) - Frontend: Vue3 + Tailwind CSS (custom themes supported) - WebSocket real-time communication - Email service: SMTP --- ## 📦 Installation & Configuration 1. Download the latest `VerifyMC.jar` and place it in your server's `plugins` directory. 2. Start the server to auto-generate config files, then edit `config.yml` as needed (see full example below). 3. Restart the server and visit `http://your_server_ip:8080` to access the admin panel. ```yaml # ---------------------------------------- # 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: '' # ---------------------------------------- # Verification & Whitelist # ---------------------------------------- # Supported authentication methods. Options: 'email' (email verification), 'captcha' (graphical captcha). # You can use multiple methods, e.g.: # # Configuring the captcha: section below does NOT enable captcha! # To enable captcha, you MUST add 'captcha' to this list: # Captcha only: auth_methods: # Both email and captcha: auth_methods: 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