## 概述
PlayerWaypointColors 允许玩家设置自己的航路点颜色，并允许管理员为其他玩家设置颜色。 支持使用 PlaceholderAPI 进行自动玩家颜色分配。
## 功能
- 为玩家航路点分配自定义十六进制颜色（例如，`#FF0000` 或 `FF0000` 代表红色）
- 玩家和管理员的简单命令
- 可选的 PlaceholderAPI 集成，用于在加入时自动分配颜色
## 兼容性
- **Minecraft:** Spigot 1.21.7, Paper 1.21.7
- **可选:** [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/)
## 安装
1. 下载最新的 `PlayerWaypointColors.jar`。
2. 将其放置在服务器的 `plugins` 文件夹中。
3. (可选) 如果您想进行动态颜色分配，请安装 PlaceholderAPI。
4. 启动或重新加载您的服务器。
## 命令 & 权限
| 命令 | 描述 | 权限 | 默认 |
|--------------------------------------------------|-----------------------------------------------------|------------------------------|---------|
| `/pwc help` | 显示帮助消息 | playerwaypointcolor.help | all |
| `/pwc set [#hexcode]` | 设置您自己的航路点颜色 | playerwaypointcolor.self | OP |
| `/pwc setother [#hexcode]` | 设置另一个玩家的航路点颜色 | playerwaypointcolor.others | OP |
| `/pwc get` | 获取您自己的航路点颜色 | playerwaypointcolor.self | OP |
| `/pwc get ` | 获取另一个玩家的航路点颜色 | playerwaypointcolor.others | OP |
| `/pwc reset` | 重置您自己的航路点颜色 | playerwaypointcolor.self | OP |
| `/pwc reset ` | 重置另一个玩家的航路点颜色 | playerwaypointcolor.others | OP |
`/pwc get` 仅在 Spigot (而不是 Paper) 上受支持，因为存在 API 限制。
## 配置文件
插件将在首次运行时创建一个 `config.yml` 文件。 您可以：
- 启用 PlaceholderAPI 集成
- 设置自动颜色分配的占位符
示例配置：
```yaml
placeholderapi:
auto-apply-on-join: false
variable: ""
```
## PlaceholderAPI 集成
如果安装了 PlaceholderAPI，您可以使用占位符在玩家加入时自动分配十六进制颜色。 将 config.yml 中的变量设置为您想要的占位符（例如，`%luckperms_meta_color%`），该占位符必须返回以 `#00FF00` 或 `00FF00` 格式的十六进制颜色。
最简单的方法是使用 LuckPerms 元数据功能。
1. 在组上设置权限 `meta.color.#FF0000`
2. 将 config.yml 选项 `auto-apply-on-join` 设置为 `true`
3. 将 config.yml 选项 `variable` 设置为 `%luckperms_meta_color%`
4. 保存 config.yml，重启您的服务器
或者，您可以使用 PlaceholderAPI 字符串扩展（特别是 `%string_replaceCharacters__%`）来操作您的占位符，使其返回一个有效的十六进制代码。