# 🧩 Lejo — 自定义加入/退出消息插件
**Lejo** 是一个轻量级且灵活的 Minecraft (Paper/Purpur) 插件，允许完全自定义加入和退出消息。它支持渐变色、十六进制颜色、使用占位符的格式化，以及基于权限、世界、昵称等的逻辑。
---
## 🔧 主要功能
### ✅ 1. 加入/退出消息
当玩家：
* **加入**服务器
* **离开**服务器
插件会发送自定义聊天消息。
### ✅ 2. 基于群组的消息 (`permission`)
你可以为特定权限（如 `admin`、`prime` 等）定义不同的消息模板。
### ✅ 3. 占位符支持
| 占位符 | 描述 |
| ----------------------- | ----------------------------------------- |
| `{p}` | 玩家的名称 (昵称或显示名称) |
| `{t}` | 当前服务器时间 (可自定义格式) |
| `{l}` | 玩家的位置.|
| `{w}` | 世界名称的别名 |
### ✅ 4. 渐变 & 颜色格式化
你可以使用：
* **十六进制颜色**: `文本`
* **渐变**: `文本`
* **标准的 MiniMessage 格式化**，如 ``、`` 等。
### ✅ 5. 优先级系统
消息的选择基于以下顺序：
1. **昵称**
2. **父权限/权限**
3. **默认**
---
## 📄 `config.yml` 结构
```yaml
messages:
default:
join:
- "随机消息"
- "其他随机消息"
leave:
- "[...]"
permission:
admin:
join:
- "[...]"
leave:
- "[...]"
prime:
join:
- "[...]"
leave:
- "[...]"
nickname:
SomePlayer:
join:
- "[...]"
leave:
- "[...]"
system:
enable: "Lejo 插件已启用"
disable: "Lejo 插件已禁用"
reload: "Lejo 插件重载"
placeholders:
time-format: "HH:mm:ss"
date-format: "dd.MM.yyyy"
location-format: "x:{x} y:{y} z:{z}"
worlds:
nether: "nether"
overworld: "overworld"
end: "end"
custom: "custom"
prefix:
suffix-mode: false
join: [+]
leave: [-]
```
---
## 🔌 命令
| 命令 | 描述 | 权限 |
| --------------- | ------------------------- | -------------- |
| `/lejo reload` | 重载插件配置 | `lejo.reload` |
---
## 💡 加入消息示例
```yaml
join:
- "欢迎 {p} 加入 {w} 的服务器，时间为 {t}!"
```
→ 玩家 **John** 加入了 `world_nether`，时间为 `13:42:17`
**聊天输出:** `欢迎 John 加入 world 的服务器，时间为 13:42:17!`
---
## 🧠 额外功能
* MiniMessage 支持（渐变色、十六进制颜色、格式化）
* 清晰、独立的的消息生成逻辑
* 优先级逻辑: `昵称 > 权限 > 默认`