转载 工具 JWhitelist 1.0.5

[MD]
# JWhitelist

JWhitelist 是一款适用于 Bukkit、Spigot、Paper 与 Folia 服务端的白名单管理插件。它通过独立的白名单系统控制允许进入服务器的玩家，并提供比 Minecraft 原版白名单更灵活的管理与自定义能力。

## 功能特性

### 支持 Bukkit、Spigot、Paper 与 Folia

- 支持 Bukkit、Spigot、Paper 和 Folia 服务端。
- 插件会自动检测服务器是否运行在 Folia 环境，并进行相应适配。

### 白名单管理命令

- `/jw add <player>`：将玩家添加至白名单。
- `/jw remove <player>`：将玩家从白名单中移除。
- `/jw list`：显示全部白名单玩家。
- `/jw status`：查看白名单当前是否已启用。
- `/jw enable`：启用白名单。
- `/jw disable`：禁用白名单。
- `/jw reload`：重新加载插件配置。
- `/jw import`：从原版 `whitelist.json` 导入玩家列表。

### 多语言支持

- 自动加载语言文件，例如 `lang_en.yml`、`lang_es.yml` 等。
- 支持自行修改翻译内容。
- 语言文本可使用 Minecraft 颜色代码 `&`。

### 配置文件

插件通过 `config.yml` 提供配置选项，可用于调整插件行为及默认语言等设置。

### 数据存储

允许加入服务器的玩家列表会保存在 `whitelist.yml` 中。

### 命令音效

添加或移除白名单玩家时，插件会播放相应音效。

### 原版白名单兼容

插件可读取原版 `whitelist.json` 中的白名单数据，将原版 `whitelist.json` 转换为 `whitelist.yml` 使用。

## 权限节点

### 基础权限

| 权限节点 | 说明 |
|---|---|
| `jw.use` | 允许使用 `/jw` 命令。 |

### 白名单管理权限

| 权限节点 | 说明 |
|---|---|
| `jw.add` | 允许将玩家加入白名单：`/jw add <player>`。 |
| `jw.remove` | 允许将玩家移出白名单：`/jw remove <player>`。 |
| `jw.list` | 允许查看全部白名单玩家：`/jw list`。 |
| `jw.status` | 允许查看白名单是否已启用：`/jw status`。 |
| `jw.enable` | 允许启用白名单：`/jw enable`。 |
| `jw.disable` | 允许禁用白名单：`/jw disable`。 |
| `jw.reload` | 允许重新加载插件配置：`/jw reload`。 |
| `jw.import` | 允许从 `whitelist.json` 导入玩家：`/jw import`。 |

### 管理员权限

| 权限节点 | 说明 |
|---|---|
| `jw.admin` | 授予全部白名单管理命令的使用权限。 |

## 用途

JWhitelist 提供一套独立于 Minecraft 原版白名单的自定义白名单系统，适用于 Spigot、Paper 与 Folia 服务端。管理员可以通过命令、权限节点、语言文件和配置文件，对服务器准入玩家进行灵活管理。
[/MD]