## ✅ 发布说明(Release Notes)
### 🇯🇵 日语版
# JoinFailNotifier v1.0 发布说明
这个插件是一个工具,可以向OP通知玩家无法加入服务器的原因。
它可以自动检测未在白名单上注册、版本不一致等原因,并以易于理解的格式发送通知。
---
## ✨ 主要功能
* **检测并通知加入失败**
将被拒绝登录的玩家的名称和原因通过聊天通知给所有在线的OP玩家。
* **原因自定义**
可以在 `config.yml` 的 `kick_reasons` 部分,将Bukkit的登录拒绝原因和显示名称进行映射。
* **通知消息编辑**
可以自由自定义包含 `{player}` 和 `{reason}` 占位符的通知消息。
* **管理命令**
使用 `/joinfailnotifier reload` 重新加载配置。
使用 `/joinfailnotifier help` 显示用法。
---
## 📄 config.yml 的例子
```yaml
kick_reasons:
WHITELIST: "未在白名单上"
BANNED: "已被BAN"
VERSION: "版本不一致"
message_format: "&c[警告] &e{player} &c无法加入服务器:{reason}"
messages:
help_message: "&e用法: /joinfailnotifier "
reload_success: "&a已重新加载配置。"
invalid_command: "&c无效的命令。使用 /joinfailnotifier help。"
```
---
### 🇺🇸 英文版
# JoinFailNotifier v1.0 Release Notes
This plugin notifies online OPs when a player fails to join the server.
It captures reasons such as whitelist exclusion or version mismatch and displays a clear message in chat.
---
## ✨ Features
* **Join Failure Detection**
When a player is denied login, their name and reason are broadcast to all online OPs.
* **Custom Reason Mapping**
Customize kick reasons in `config.yml` under `kick_reasons`, mapping Bukkit reasons to friendly messages.
* **Customizable Messages**
Modify the notification message freely using `{player}` and `{reason}` placeholders.
* **Admin Commands**
* `/joinfailnotifier reload`: Reloads the configuration.
* `/joinfailnotifier help`: Shows usage instructions.
---
## 📄 Example `config.yml`
```yaml
kick_reasons:
WHITELIST: "Not whitelisted"
BANNED: "Banned from the server"
VERSION: "Version mismatch"
message_format: "&c[Alert] &e{player} &ccould not join the server: {reason}"
messages:
help_message: "&eUsage: /joinfailnotifier "
reload_success: "&aConfiguration reloaded."
invalid_command: "&cInvalid command. Use /joinfailnotifier help."
```
---
## 📝 描述(针对 Modrinth)
### 🇯🇵 日语
一个简单的插件,当玩家无法加入服务器时,通过聊天通知OP。
可以根据拒绝原因自定义显示,例如白名单问题、封禁和版本不匹配。
支持使用 `/joinfailnotifier reload` 命令重新加载配置。
---
### 🇺🇸 English
A simple plugin that notifies OPs when a player fails to join the server.
Whitelist issues, bans, and version mismatches are detected and displayed in customizable messages.
Supports `/joinfailnotifier reload` for configuration reload.