TextWhitelist

💬 TextWhitelist - The Simple & Powerful Whitelist Plugin

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.
• 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 reload to apply changes to your .txt files instantly without a server restart.
• 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.

🚀 Source Code

• View the Source Code on GitHub
• Report an Issue or Suggest a Feature

⚙️ Installation & Configuration

Installation

1. Download the latest .jar file from the Versions tab.
2. Place the TextWhitelist.jar file into your server's plugins directory.
3. Restart your server. The plugin will automatically generate a TextWhitelist folder inside your plugins directory, containing config.yml, players.txt, and admins.txt.

Configuration Files

• config.yml: Contains the master switch for the plugin. (whitelist-enabled: true|false)
• players.txt: The main whitelist file for PLAYERS mode. Add one player name per line.
• admins.txt: The maintenance whitelist file for ADMINS mode. Add one admin/staff name per line.

💻 Commands & Usage

The base command is /whitelistxt (alias: /wltxt). All subcommands require the textwhitelist.admin permission.

🛡️ Permissions

• textwhitelist.admin: Grants access to all /wltxt commands. (Given to OPs by default)