\n
\n
# YAWL (Yet Another Whitelist Plugin)<\/p>\n
**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.<\/p>\n
## \ud83d\ude80 Overview<\/p>\n
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.<\/p>\n
## \u2728 Why Choose YAWL?<\/p>\n
* **\u26a1 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.
\n * **\u270f\ufe0f 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.
\n * **\u2699\ufe0f Straightforward Configuration:** A clean `config.toml` file allows you to toggle the whitelist, change message languages, and set case sensitivity with ease.
\n * **\ud83c\udf0d 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**!
\n * **\ud83d\udd04 Live Reload:** No need to restart your entire proxy. A simple command reloads the configuration and the whitelist instantly.
\n * **\ud83d\udd12 Permissions-Ready:** Fine-grained permission nodes give you complete control over who can manage the whitelist.<\/p>\n
## \ud83d\udce6 Installation<\/p>\n
1. Download the latest version of the plugin.
\n2. Place the downloaded `.jar` file into the `plugins` folder of your Velocity proxy.
\n3. Start or restart your proxy.
\n4. The default configuration (`config.toml`), locales, and an empty `whitelist.txt` file will be generated in `plugins\/yawl`. Edit them to your liking!<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
The configuration is handled in the `plugins\/yawl\/config.toml` file.<\/p>\n
“`toml
\n[settings]
\n# Enable or disable the whitelist. If false, the plugin will not kick anyone.
\nenabled = true<\/p>\n
# Sets the language for plugin messages.
\n# Corresponds to a file name in the ‘locales’ folder (e.g., “en”, “ru”).
\nlocale = “en”<\/p>\n
# If true and the client has a language set that exists in the plugin’s locales folder, it will be displayed.
\n# If false, it will display default locale defined by upper setting.
\nuse-client-locale = false<\/p>\n
# If true, player names in the whitelist will be case-sensitive (e.g., “Player” is different from “player”).
\n# If false, case will be ignored (“Player” and “player” are the same).
\n# It’s recommended to keep this ‘false’ for user-friendliness.
\ncase-sensitive = false<\/p>\n
# Kick active player immediately after whitelist removal or expiry.
\n# If false, the player will remain connected until they reconnect or reload occurs.
\nkick-active-on-revoke = true<\/p>\n
# Placeholder reload interval in minutes
\nplaceholder-reload-interval = 2
\n“`<\/p>\n
## \ud83c\udd94 Placeholders
\nStarting 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).<\/p>\n
\n
\n<\/p>\n
## \ud83d\udcac Commands<\/p>\n
All commands start with `\/yawl`.<\/p>\n
| Command | Description | ## \ud83d\udd11 Permissions<\/p>\n Grant these permissions to your staff groups to control who can manage the whitelist.<\/p>\n | Permission | Description | Most simple whitelist plugin for Velocity server.<\/p>\n","protected":false},"featured_media":172933,"template":"","meta":{"_minecraft_slug":"yawl","_minecraft_project_id":"DpUirrNB","_minecraft_author":"Renwixx","_minecraft_license":"MIT","_minecraft_downloads":97,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"yawl.zip","_minecraft_size_bytes":102510,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-15T19:45:29.603361Z","_minecraft_date_created":"2025-08-31T21:32:21.921745Z","_minecraft_date_modified":"2025-09-15T22:02:39.952309Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/yawl","_minecraft_icon_attachment_id":172933,"_minecraft_imported_at":"2026-06-09T22:27:58+00:00","_minecraft_import_hash":"e98b73a198e96ace3958bff30bf983c0","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,867,92,985],"mod_loader":[986],"minecraft_version":[73,74,38,78,79,80,81],"class_list":["post-172932","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-social","mod_category-utility","mod_category-velocity","mod_loader-velocity","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n
\n| ——————————— | ————————————————— |
\n| `\/yawl` | Displays the plugin help message. |
\n| `\/yawl add
\n| `\/yawl add
\n| `\/yawl extend
\n| `\/yawl remove
\n| `\/yawl list` | Shows a list of all whitelisted players. |
\n| `\/yawl reload` | Reloads the config and `whitelist.txt`. |<\/p>\n
\n| ———————- | ————————————————————- |
\n| `yawl.bypass` | Allows a player to join the server even if not on the whitelist. |
\n| `yawl.command.add` | Allows using the `\/yawl add` command. |
\n| `yawl.command.extend` | Allows using the `\/yawl extend` command. |
\n| `yawl.command.remove` | Allows using the `\/yawl remove` command. |
\n| `yawl.command.list` | Allows using the `\/yawl list` command. |
\n| `yawl.command.reload` | Allows using the `\/yawl reload` command. |<\/p>\n","protected":false},"excerpt":{"rendered":"