
TextWhitelist
A powerful, text-file based whitelist with multiple modes and full in-game command management.
📖About TextWhitelist
💬 TextWhitelist
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+).
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.
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.
✨ Features
- Full In-Game Management: Control every aspect of the plugin with a comprehensive command suite.
- Master On/Off Switch: Globally enable or disable the plugin's functionality on the fly with
/wltxt enable|disable. - Dual Whitelist Modes:
- PLAYERS Mode: Standard operation. Allows players listed in
players.txt. - ADMINS Mode: Maintenance mode. Only allows staff listed in
admins.txt.
- PLAYERS Mode: Standard operation. Allows players listed in
- Context-Aware Commands: The plugin is smart! It provides different kick messages for different scenarios and only kicks players when it makes sense.
- Instant Reloading: Use
/wltxt reloadto apply changes to your.txtfiles instantly without a server restart. - Enforce on Reload: When reloaded, the plugin automatically kicks any online players who are no longer on the active whitelist.
- Wide Version Compatibility: Works on most Spigot-based servers from version 1.8 to 1.21 and newer.
- High-Priority Login-Blocking: Built to coexist with other plugins like AuthMe by using the highest event priority, ensuring its rules are final.
🚀 Installation
- Download the latest
.jarfile from the Versions tab. - Place the
TextWhitelist.jarfile into your server'spluginsdirectory. - Restart your server. The plugin will automatically generate a
TextWhitelistfolder inside yourpluginsdirectory, containingconfig.yml,players.txt, andadmins.txt.
💻 Commands & Usage
The base command is /whitelistxt (alias: /wltxt). All subcommands require the textwhitelist.admin permission.
| Command | Description |
|---|---|
/wltxt |
Shows the current status (enabled/disabled) and active mode. |
/wltxt help |
Displays a list of all available commands. |
/wltxt enable |
Enables the whitelist checks. |
/wltxt disable |
Disables the whitelist checks. |
/wltxt change <players|admins> |
Switches the active mode. |
/wltxt reload |
Reloads both .txt files from the disk. |
/wltxt add <player|admin> <name> |
Adds a player to the specified list. |
/wltxt remove <player|admin> <name> |
Removes a player from the specified list. |
⚙️ Permissions
textwhitelist.admin: Grants access to all/wltxtcommands. This permission is given to server operators (OPs) by default.