# Velocity Whitelist<\/p>\n
This is a Velocity plugin designed to manage a Minecraft whitelist using MySQL\/MariaDB as the backend storage. Unable to find a plugin that met my exact requirements, I decided to adapt this one to suit my needs.<\/p>\n
The project is based on MySQLWhitelistVelocity by moesnow version 1.2.0.<\/p>\n
## Installation<\/p>\n
1. Download the latest release from the Releases page.
\n2. Place the JAR file in the `plugins` directory of your Velocity proxy.
\n3. Start or Restart the proxy.<\/p>\n
## Configuration<\/p>\n
The plugin uses a configuration file (`config.properties`) located in the `plugins\/velocitywhitelist` directory.<\/p>\n
### Default Configuration<\/p>\n
“`properties
\n# Whitelist Status
\nenabled: false<\/p>\n
# Enable Debug Messages
\ndebug: false<\/p>\n
# MySQL settings
\nhost: localhost
\nuser: username
\npassword: strongpassword
\ndatabase: velocity
\nport: 3306
\ntable: g_whitelist<\/p>\n
# Kick message
\nmessage: Sorry, you are not in the whitelist.
\n“`<\/p>\n
### Configuration Options<\/p>\n
– `enabled`: Set to `true` to enable the whitelist.
\n– `host`, `user`, `password`, `database`, `port`, `table`: MySQL database connection details.
\n– `message`: Kick message displayed to players not in the whitelist.<\/p>\n
## Commands<\/p>\n
# Basic Commands # Admin Commands ## Permissions<\/p>\n – `velocitywhitelist`: Required to use the basic whitelist commands. ## Usage<\/p>\n 1. Configure the MySQL connection details in the `config.properties` file. ## Issues and Contributions<\/p>\n <\/p>\n If you encounter any issues or have suggestions for improvement, please open an issue or submit a pull request on the GitHub repository.<\/p>\n","protected":false},"excerpt":{"rendered":" Velocity plugin for managing a Minecraft whitelist using MySQL\/MariaDB<\/p>\n","protected":false},"featured_media":165576,"template":"","meta":{"_minecraft_slug":"velocity-whitelist","_minecraft_project_id":"w4sVUrV7","_minecraft_author":"Rathinosk","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":595,"_minecraft_follows":5,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"velocity-whitelist.zip","_minecraft_size_bytes":629148,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T10:16:39.371183Z","_minecraft_date_created":"2025-03-23T15:13:12.070039Z","_minecraft_date_modified":"2025-03-19T06:45:55.643876Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/velocity-whitelist","_minecraft_icon_attachment_id":165576,"_minecraft_imported_at":"2026-06-09T17:50:56+00:00","_minecraft_import_hash":"d6e5c315fd00e0769cc205ac8a4d92ad","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,985],"mod_loader":[986],"minecraft_version":[59,36,60,93,94,101,102,62,37,73,74,38],"class_list":["post-165575","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-velocity","mod_loader-velocity","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-2","minecraft_version-1-21-3","minecraft_version-1-21-4"],"yoast_head":"\n
\n– `\/vwl add
\n– `\/vwl del
\n– `\/vwl list
\n– `\/vwl enable`: Enable the whitelist.
\n– `\/vwl disable`: Disable the whitelist.
\n– `\/vwl reload`: Reload the config.properties.
\n– `\/vwl debug
\n– `velocitywhitelist.admin`: Required to use whitelist admin commands.<\/p>\n
\n2. Start the proxy.
\n3. Use the `\/vwl` command to manage the whitelist.<\/p>\n