[MD]
# TheJoinTitle
自定义玩家加入消息的 Minecraft Paper 插件，支持 1.21.11。
部分代码由deepseek生成，维护由MC_XYR维护。
## 功能
- 自定义全体玩家加入消息（all）
- 自定义特定玩家统一加入消息（specificall）
- 自定义特定玩家单独加入消息（specific）
- 优先级：specific > specificall > all
- 游戏内指令动态增删改查
- 多语言支持，自由扩展语言文件
- 支持 `&`和`§` 颜色代码
- 管理员可指定他人权限
## 前置
**[必需]** Paper 1.21.11+ 理论可以向下兼容到1.8，但未经测试不保证稳定性以及安全性。
**[可选]** [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/)2.11.0+ — 安装后可解析 PAPI 变量。
## 安装
- 下载 jar 放入 `plugins/` 文件夹
- 重启服务器
- 编辑 `plugins/TheJoinTitle/config.yml` 配置
## 指令
| 指令 | 说明 | 权限 |
|------|------|------|
| `/thejointitle add <玩家> <消息>` | 添加特定玩家的加入消息 | thejointitle.use |
| `/thejointitle remove <玩家>` | 移除特定玩家的加入消息 | thejointitle.use |
| `/thejointitle edit <玩家> <新消息>` | 修改特定玩家的加入消息 | thejointitle.use |
| `/thejointitle toggle <all\|specificall\|specific>` | 开关对应功能 | thejointitle.use |
| `/thejointitle set <all\|specificall\|specific> <enabled\|message> <值>` | 修改配置项 | thejointitle.use |
| `/thejointitle language <语言代码>` | 切换语言 | thejointitle.use |
| `/thejointitle reload` | 重载配置和语言文件 | thejointitle.use |
| `/thejointitle grant <玩家>` | 授予玩家使用权限 | thejointitle.admin |
| `/thejointitle revoke <玩家>` | 撤销玩家使用权限 | thejointitle.admin |
| `/thejointitle about` | 查看插件信息 | thejointitle.use |
别名：`/tjt`、`/jointitle`、`/玩家加入标题`
**权限节点：**
- `thejointitle.admin` — 管理员权限，OP 默认拥有
- `thejointitle.use` — 使用权限，需管理员通过 `/thejointitle grant` 授予
## 配置文件
`config.yml`：
```yaml
#TheJoinTitle配置文件
#支持格式化代码（颜色代码）
#各个配置的等级specific＞specificall＞all
#这个是语言默认zh_cn，语言文件可以自定义，安装只需把语言文件直接放到language文件夹然后在config.yml中切换。原本的zh_cn和en_us不用动。别的语言的翻译可以交给ai。
language: zh_cn
#这里是加入后自定义提示消息，消息示例：更新公告：移除了herobrine
#all是是否更改全部玩家的加入消息；on打开off关闭；默认off
all:
enabled: off
message: "更新公告：移除了herobrine"
#这个是给特定玩家的自定义提示消息开关
#下面的是自定义提示消息的玩家；示例herobrine和notch
#这个是 没办法 单独设置 特定玩家 特定加入消息 的
specificall:
enabled: off
message: "更新公告：移除了herobrine"
players:
- herobrine
- notch
#这个是给特定玩家的自定义提示消息开关
#下面的是自定义提示消息的玩家；示例dog和MC_XYR
#这个是 可以 单独设置 特定玩家 特定加入消息 的；格式："玩家名:自定义提示消息"
specific:
enabled: off
players:
- "dog:&c汪汪汪"
- "MC_XYR:我是作者，我添加了114514个高危漏洞[doge]"
```
---
# 作者
MC_XYR
QQ: 3365671772
---
# 开源协议
本项目采用 GNU General Public License v3.0 (GPL v3) 开源协议。详细信息请参阅 Github上的 LICENSE 文件。
[/MD]
