YAWL (Yet Another Whitelist Plugin)
YAWL 是一款专为 Velocity 代理设计的极其简单、轻量且高效的白名单插件。如果你需要一个无需繁琐设置、易于管理且能正常工作的白名单解决方案,那么这款插件就是为你准备的。
? 概览
YAWL 的核心理念是简单。在复杂的插件世界中,YAWL 凭借专注做好一件事而脱颖而出。它通过纯文本文件 (whitelist.txt) 来管理服务器白名单,使得查看、编辑和管理变得轻松自如,无需依赖数据库或复杂的命令。其设计旨在尽可能高性能且不引人注目,确保对服务器的性能零影响。
✨ 为什么选择 YAWL?
- ⚡ 轻量级: 该插件占用极小。它经过优化以具备极高的效率,不会给代理增加任何臃肿或延迟。
- ✏️ 简单的基于文本的管理: 所有列入白名单的玩家都存储在一个简单的
whitelist.txt 文件中。你可以直接编辑此文件并在游戏内重载插件。
- ⚙️ 直观的配置文件: 干净的
config.toml 文件让你可以轻松切换白名单开关、更改消息语言以及设置大小写敏感模式。
- ? 多语言支持: YAWL 内置了多种预打包语言包(
en, ar, de, es, fr, ja, ru, uk, zh-cn, pt-br, tr)。它甚至可以根据玩家的客户端语言自动显示消息!
- ? 实时重载: 无需重启整个代理。只需一个简单的命令即可立即重载配置和白名单。
- ? 权限就绪: 细粒度的权限节点让你完全控制谁可以管理白名单。
? 安装
- 下载最新版本的插件。
- 将下载的
.jar 文件放入 Velocity 代理的 plugins 文件夹中。
- 启动或重启你的代理。
- 默认配置 (
config.toml)、本地化文件和一个空的 whitelist.txt 文件将在 plugins/yawl 目录下生成。请根据你的喜好编辑它们!
⚙️ 配置
配置文件位于 plugins/yawl/config.toml 文件中。
[settings]
# 启用或禁用白名单。如果为 false,插件将不会踢出任何人。
enabled = true
# 设置插件消息的语言。
# 对应 'locales' 文件夹中的文件名(例如 "en", "ru")。
locale = "en"
# 如果为 true 且客户端设置了存在于插件 locales 文件夹中的语言,则将使用该语言显示。
# 如果为 false,则显示由上方设置定义的默认语言。
use-client-locale = false
# 如果为 true,白名单中的玩家名称将区分大小写(例如 "Player" 与 "player" 不同)。
# 如果为 false,将忽略大小写("Player" 和 "player" 视为相同)。
# 建议保持为 'false' 以提高用户友好性。
case-sensitive = false
# 在白名单移除或过期后立即踢出活跃玩家。
# 如果为 false,玩家将保持连接状态,直到他们重新连接或发生重载。
kick-active-on-revoke = true
# 占位符重载间隔(分钟)
placeholder-reload-interval = 2
? 占位符
从版本 1.2 开始,你可以使用 %yawl_duration% 占位符,其中包含玩家剩余的时间量。要使用占位符,你需要在后端服务器上安装 YetAnotherWhitelistCompanion 和 PlaceholderAPI。
? 命令
所有命令均以 /yawl 开头。
| 命令 |
描述 |
/yawl |
显示插件帮助信息。 |
/yawl add <player> |
将玩家添加到白名单。 |
/yawl add <player> [<duration>] |
将玩家添加到白名单指定时长。 |
/yawl extend <player> [<duration>] [add|replace] |
为玩家增加时间。如果白名单计时器已过期,它将建议基于实际时间替换时间或在旧时限上累加。 |
/yawl remove <player> |
从白名单中移除玩家。 |
/yawl list |
显示所有白名单玩家的列表。 |
/yawl reload |
重载配置和 whitelist.txt。 |
? 权限
将这些权限授予你的工作人员组,以控制谁可以管理白名单。
| 权限 |
描述 |
yawl.bypass |
允许玩家即使不在白名单上也能加入服务器。 |
yawl.command.add |
允许使用 /yawl add 命令。 |
yawl.command.extend |
允许使用 /yawl extend 命令。 |
yawl.command.remove |
允许使用 /yawl remove 命令。 |
yawl.command.list |
允许使用 /yawl list 命令。 |
yawl.command.reload |
允许使用 /yawl reload 命令。 |
YAWL (Yet Another Whitelist Plugin)
YAWL is an incredibly simple, lightweight, and efficient whitelist plugin designed exclusively for the Velocity proxy. If you need a no-fuss, easy-to-manage whitelist solution that just works, this is the plugin for you.
? Overview
The core philosophy of YAWL is simplicity. In a world of complex plugins, YAWL stands out by doing one thing and doing it well. It manages a server whitelist through a plain text file (whitelist.txt), making it easy to view, edit, and manage without needing databases or complicated commands. It's built to be as performant and unobtrusive as possible, ensuring zero impact on your server's performance.
✨ Why Choose YAWL?
- ⚡ Lightweight: The plugin has a minimal footprint. It's written to be extremely efficient and won't add any bloat or lag to your proxy.
- ✏️ Simple Text-Based Management: All whitelisted players are stored in a simple
whitelist.txt file. You can edit this file directly and reload the plugin in-game.
- ⚙️ Straightforward Configuration: A clean
config.toml file allows you to toggle the whitelist, change message languages, and set case sensitivity with ease.
- ? Multi-Language Support: YAWL comes with multiple pre-packaged languages (
en, ar, de, es, fr, ja, ru, uk, zh-cn, pt-br, tr). It can even automatically display messages in a player's client language!
- ? Live Reload: No need to restart your entire proxy. A simple command reloads the configuration and the whitelist instantly.
- ? Permissions-Ready: Fine-grained permission nodes give you complete control over who can manage the whitelist.
? Installation
- Download the latest version of the plugin.
- Place the downloaded
.jar file into the plugins folder of your Velocity proxy.
- Start or restart your proxy.
- The default configuration (
config.toml), locales, and an empty whitelist.txt file will be generated in plugins/yawl. Edit them to your liking!
⚙️ Configuration
The configuration is handled in the plugins/yawl/config.toml file.
[settings]
# Enable or disable the whitelist. If false, the plugin will not kick anyone.
enabled = true
# Sets the language for plugin messages.
# Corresponds to a file name in the 'locales' folder (e.g., "en", "ru").
locale = "en"
# If true and the client has a language set that exists in the plugin's locales folder, it will be displayed.
# If false, it will display default locale defined by upper setting.
use-client-locale = false
# If true, player names in the whitelist will be case-sensitive (e.g., "Player" is different from "player").
# If false, case will be ignored ("Player" and "player" are the same).
# It's recommended to keep this 'false' for user-friendliness.
case-sensitive = false
# Kick active player immediately after whitelist removal or expiry.
# If false, the player will remain connected until they reconnect or reload occurs.
kick-active-on-revoke = true
# Placeholder reload interval in minutes
placeholder-reload-interval = 2
? Placeholders
Starting with version 1.2, you can use the %yawl_duration% placeholder, which contains the amount of time remaining for the player. To use placeholders, you need to install YetAnotherWhitelistCompanion and PlaceholderAPI on your backend server(s).
? Commands
All commands start with /yawl.
| Command |
Description |
/yawl |
Displays the plugin help message. |
/yawl add <player> |
Adds a player to the whitelist. |
/yawl add <player> [<duration>] |
Adds a player to the whitelist for a specific time. |
/yawl extend <player> [<duration>] [add|replace] |
Adds time for a specific player. If the white list timer has expired, it will suggest replacing the time based on the actual time or adding to the old time limit. |
/yawl remove <player> |
Removes a player from the whitelist. |
/yawl list |
Shows a list of all whitelisted players. |
/yawl reload |
Reloads the config and whitelist.txt. |
? Permissions
Grant these permissions to your staff groups to control who can manage the whitelist.
| Permission |
Description |
yawl.bypass |
Allows a player to join the server even if not on the whitelist. |
yawl.command.add |
Allows using the /yawl add command. |
yawl.command.extend |
Allows using the /yawl extend command. |
yawl.command.remove |
Allows using the /yawl remove command. |
yawl.command.list |
Allows using the /yawl list command. |
yawl.command.reload |
Allows using the /yawl reload command. |
评论 0
登录后参与评分
还没有评论,来抢沙发吧