Compatibility
Minecraft: Java Edition
1.21–1.21.4
1.20.x
Platforms
75% of ad revenue goes to creators
Support creators and Modrinth ad-free with Modrinth+Creators
Details
Licensed GPL-3.0-only
Published 2 months ago
Updated 2 months ago
Velocity Whitelist
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.
The project is based on MySQLWhitelistVelocity by moesnow version 1.2.0.
Installation
- Download the latest release from the Releases page.
- Place the JAR file in the
plugins
directory of your Velocity proxy. - Start or Restart the proxy.
Configuration
The plugin uses a configuration file (config.properties
) located in the plugins/velocitywhitelist
directory.
Default Configuration
# Whitelist Status
enabled: false
# Enable Debug Messages
debug: false
# MySQL settings
host: localhost
user: username
password: strongpassword
database: velocity
port: 3306
table: g_whitelist
# Kick message
message: Sorry, you are not in the whitelist.
Configuration Options
enabled
: Set totrue
to enable the whitelist.host
,user
,password
,database
,port
,table
: MySQL database connection details.message
: Kick message displayed to players not in the whitelist.
Commands
Basic Commands
/vwl add <player>
: Add a player to the whitelist./vwl del <player>
: Remove a player from the whitelist. (with DB autocomplete)/vwl list <search>
: Lists players matching search criteria. (min 2 characters)
Admin Commands
/vwl enable
: Enable the whitelist./vwl disable
: Disable the whitelist./vwl reload
: Reload the config.properties./vwl debug <on/off>
: Turn debug messages on or off.
Permissions
velocitywhitelist
: Required to use the basic whitelist commands.velocitywhitelist.admin
: Required to use whitelist admin commands.
Usage
- Configure the MySQL connection details in the
config.properties
file. - Start the proxy.
- Use the
/vwl
command to manage the whitelist.
Issues and Contributions
If you encounter any issues or have suggestions for improvement, please open an issue or submit a pull request on the GitHub repository.