Velocity 白名单
这是一个 Velocity 插件,旨在使用 MySQL/MariaDB 作为后端存储来管理 Minecraft 白名单。由于找不到完全符合我需求的插件,我决定修改此插件以满足我的需要。
该项目基于 moesnow 的 MySQLWhitelistVelocity 版本 1.2.0。
我正在原封不动地在我的 26.1/26.2 服务器集群中使用它。
安装
- 从 Releases 页面下载最新版本。
- 将 JAR 文件放入 Velocity 代理的
plugins 目录中。
- 启动或重启代理。
配置
该插件使用位于 plugins/velocitywhitelist 目录中的配置文件 (config.properties)。
默认配置
# 白名单状态
enabled: false
# 启用调试消息
debug: false
# MySQL 设置
host: localhost
user: username
password: strongpassword
database: velocity
port: 3306
table: g_whitelist
# 踢出消息
message: Sorry, you are not in the whitelist.
配置选项
enabled: 设置为 true 以启用白名单。
host, user, password, database, port, table: MySQL 数据库连接详情。
message: 显示给不在白名单中的玩家的踢出消息。
命令
基本命令
/vwl add <player>: 将玩家添加到白名单。
/vwl del <player>: 从白名单中移除玩家。(支持数据库自动补全)
/vwl list <search>: 列出匹配搜索条件的玩家。(最少 2 个字符)
管理员命令
/vwl enable: 启用白名单。
/vwl disable: 禁用白名单。
/vwl reload: 重新加载 config.properties。
/vwl debug <on/off>: 开启或关闭调试消息。
权限
velocitywhitelist: 使用基本白名单命令所需权限。
velocitywhitelist.admin: 使用白名单管理员命令所需权限。
用法
- 在
config.properties 文件中配置 MySQL 连接详情。
- 启动代理。
- 使用
/vwl 命令管理白名单。
问题与贡献

如果您遇到任何问题或有改进建议,请在 GitHub 仓库 上提交 Issue 或 Pull Request。
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.
I am actively using it, as-is, on my 26.1/26.2 server farm.
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 to true 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧