# \ud83d\udcac TextWhitelist<\/p>\n
Tired of managing a cumbersome `whitelist.json` file? **TextWhitelist** is a powerful, lightweight whitelist plugin for Spigot-based servers (Paper, Purpur, etc.) designed for wide compatibility (**1.8 – 1.21+**). <\/p>\n
It’s the perfect solution for offline-mode servers or any community that needs to quickly manage player access using simple text files instead of dealing with UUIDs.<\/p>\n
This plugin evolves beyond a simple whitelist into a full-fledged access management tool, allowing you to control every aspect directly from in-game commands without ever needing a server restart.<\/p>\n
—
\n## \u2728 Features<\/p>\n
– **Full In-Game Management:** Control every aspect of the plugin with a comprehensive command suite.
\n– **Master On\/Off Switch:** Globally enable or disable the plugin’s functionality on the fly with `\/wltxt enable|disable`.
\n– **Dual Whitelist Modes:**
\n – **PLAYERS Mode:** Standard operation. Allows players listed in `players.txt`.
\n – **ADMINS Mode:** Maintenance mode. Only allows staff listed in `admins.txt`.
\n– **Context-Aware Commands:** The plugin is smart! It provides different kick messages for different scenarios and only kicks players when it makes sense.
\n– **Instant Reloading:** Use `\/wltxt reload` to apply changes to your `.txt` files instantly without a server restart.
\n– **Enforce on Reload:** When reloaded, the plugin automatically kicks any online players who are no longer on the active whitelist.
\n– **Wide Version Compatibility:** Works on most Spigot-based servers from version 1.8 to 1.21 and newer.
\n– **High-Priority Login-Blocking:** Built to coexist with other plugins like AuthMe by using the highest event priority, ensuring its rules are final.<\/p>\n
—
\n## \ud83d\ude80 Installation<\/p>\n
1. Download the latest `.jar` file from the **Versions** tab.
\n2. Place the `TextWhitelist.jar` file into your server’s `plugins` directory.
\n3. Restart your server. The plugin will automatically generate a `TextWhitelist` folder inside your `plugins` directory, containing `config.yml`, `players.txt`, and `admins.txt`.<\/p>\n
—
\n## \ud83d\udcbb Commands & Usage<\/p>\n
The base command is `\/whitelistxt` (alias: `\/wltxt`). All subcommands require the `textwhitelist.admin` permission.<\/p>\n
| Command | Description | ## \u2699\ufe0f Permissions<\/p>\n – **`textwhitelist.admin`**: Grants access to all `\/wltxt` commands. This permission is given to server operators (OPs) by default.<\/p>\n","protected":false},"excerpt":{"rendered":" A powerful, text-file based whitelist with multiple modes and full in-game command management.<\/p>\n","protected":false},"featured_media":153577,"template":"","meta":{"_minecraft_slug":"textwhitelist","_minecraft_project_id":"kA6d3xT5","_minecraft_author":"Cowboy-original","_minecraft_license":"MIT","_minecraft_downloads":64,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"textwhitelist.zip","_minecraft_size_bytes":9622,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T20:38:49.304176Z","_minecraft_date_created":"2025-07-08T02:43:41.874256Z","_minecraft_date_modified":"2025-06-27T05:12:29.730024Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/textwhitelist","_minecraft_icon_attachment_id":153577,"_minecraft_imported_at":"2026-06-09T07:27:53+00:00","_minecraft_import_hash":"8ab53efc26df276d696c76ba822abf11","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,128,129,92],"mod_loader":[132,133,134],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,73,74,38,78,79,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864],"class_list":["post-153576","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","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","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4"],"yoast_head":"\n
\n| :— | :— |
\n| `\/wltxt` | Shows the current status (enabled\/disabled) and active mode. |
\n| `\/wltxt help` | Displays a list of all available commands. |
\n| `\/wltxt enable` | Enables the whitelist checks. |
\n| `\/wltxt disable`| Disables the whitelist checks. |
\n| `\/wltxt change
\n| `\/wltxt reload`| Reloads both `.txt` files from the disk. |
\n| `\/wltxt add
\n| `\/wltxt remove