# 💬 TextWhitelist
厌倦了管理笨重的 `whitelist.json` 文件？**TextWhitelist** 是一个强大、轻量级的 Spigot 基础服务器（Paper，Purpur 等）的白名单插件，设计具有广泛的兼容性 (**1.8 - 1.21+**)。
它是离线模式服务器或任何需要使用简单的文本文件而不是处理 UUID 来快速管理玩家访问权限的社区的完美解决方案。
这个插件在简单白名单的基础上进化为一个完整的访问管理工具，允许您通过游戏内命令控制每个方面，而无需重新启动服务器。
---
## ✨ 特性
- **完全的游戏内管理：** 使用全面的命令套件控制插件的每个方面。
- **主开关：** 使用 `/wltxt enable|disable` 随时启用或禁用插件的功能。
- **双重白名单模式：**
- **PLAYERS 模式：** 标准操作。允许在 `players.txt` 中列出的玩家。
- **ADMINS 模式：** 维护模式。仅允许在 `admins.txt` 中列出的员工。
- **上下文感知的命令：** 该插件很智能！它为不同的场景提供不同的踢出消息，并且仅在有意义时才踢出玩家。
- **即时重新加载：** 使用 `/wltxt reload` 立即应用对 `.txt` 文件的更改，而无需重新启动服务器。
- **重新加载时的强制执行：** 重新加载时，该插件将自动踢出所有不再在当前白名单上的在线玩家。
- **广泛的版本兼容性：** 适用于 1.8 到 1.21 及更高版本的绝大多数 Spigot 基础服务器。
- **高优先级登录阻止：** 为了与其他插件（如 AuthMe）共存，使用最高的事件优先级构建，确保其规则最终有效。
---
## 🚀 安装
1. 从 **版本** 选项卡下载最新的 `.jar` 文件。
2. 将 `TextWhitelist.jar` 文件放入服务器的 `plugins` 目录中。
3. 重新启动您的服务器。插件将在您的 `plugins` 目录中自动生成一个 `TextWhitelist` 文件夹，其中包含 `config.yml`、`players.txt` 和 `admins.txt`。
---
## 💻 命令 & 用法
基础命令是 `/whitelistxt` (别名: `/wltxt`)。所有子命令需要 `textwhitelist.admin` 权限。
| 命令 | 描述 |
| :--- | :--- |
| `/wltxt` | 显示当前状态（启用/禁用）和活动模式。 |
| `/wltxt help` | 显示所有可用命令的列表。 |
| `/wltxt enable` | 启用白名单检查。 |
| `/wltxt disable`| 禁用白名单检查。 |
| `/wltxt change ` | 切换活动模式。 |
| `/wltxt reload`| 从磁盘重新加载这两个 `.txt` 文件。 |
| `/wltxt add ` | 将玩家添加到指定的列表中。 |
| `/wltxt remove ` | 从指定的列表中移除玩家。 |
## ⚙️ 权限
- **`textwhitelist.admin`**: 授予对所有 `/wltxt` 命令的访问权限。默认情况下，此权限授予服务器操作员 (OP)。