# ✨ Little Nebo
一个轻量级、用心打造的 Paper 服务器聊天插件 - 灵感来源于 **Nebo**，智慧和沟通之神。
**Little Nebo** 让您的聊天可定制且安全，并提供对 MiniMessage、PlaceholderAPI 和旧版颜色代码的优雅支持。
专为 1.21 设计，但回溯到 **1.19.1+** 也能干净运行。🧵
---
## 🌷 特性
- 💬 **MiniMessage 格式化** — 使用颜色、悬停文本、渐变和其他元素创建灵活的聊天布局。
- 🧩 **PlaceholderAPI 集成** — 支持任何注册的占位符（例如 `%player_name%`、`%luckperms_prefix%`）。
- 🎨 **旧版颜色代码支持** — 允许玩家消息使用 `&`- 风格的 Minecraft 颜色代码（可切换）。
- 🌈 **骄傲标签支持 (1.19.1+)** — 包含反向移植的 `` 标签，用于 1.21 之前的服务器。
- 🔐 **安全的输入解析** — 过滤掉玩家消息中危险的标签，如 `` 或 ``。
- 🛠 **简单的管理员工具** — 在游戏中实时重新加载配置、切换调试模式或测试格式。
---
## 📥 安装
1. 将 `LittleNebo.jar` 放入您的 `/plugins/` 文件夹中。
2. *(可选)* 添加 PlaceholderAPI 以获得扩展的占位符支持。
3. 启动您的服务器一次以生成配置。
4. 打开 `/plugins/LittleNebo/config.yml` 以开始自定义！
---
## 🧭 指令
| 指令 | 权限 | 描述 |
|-------------------------------|---------------------|-----------------------------------------|
| `/littlenebo reload` | `littlenebo.reload` | 重新加载插件配置。 |
| `/littlenebo debug` | `littlenebo.admin` | 切换调试模式的开启/关闭。 |
| `/littlenebo debug config` | `littlenebo.admin` | 显示当前的配置值。 |
| `/littlenebo debug test `| `littlenebo.admin` | 预览 `` 将如何格式化。 |
---
## 🎀 权限
- `littlenebo.admin` - 管理插件和测试格式
- `littlenebo.reload` - 重新加载 Little Nebo 配置
- `littlenebo.format.*` - 使用名为的聊天格式，例如 `admin`、`donator` 等。
---
## 🧾 配置示例
这是一个使用 MiniMessage 的简单默认格式：
```yaml
formats:
default:
format: "[Chat ] {display_name} : {message} "
```
---
## 注意事项:
- `{display_name}` 和 `{message}` 将被插件自动替换。
- 您可以包含 `%player_name%` 或任何 PlaceholderAPI 占位符，如果已安装。
- 将 `settings.parse-player-colors` 设置为 `true` 以允许玩家消息中使用 `&` 代码。
更多示例和说明请参阅生成的 config.yml。
---
## 📜 许可证
MIT 许可证 - 使用它、修改它、改进它。只需友善即可。
---
这个插件是用关怀和好奇心制作的 - 感谢您在我学习过程中的耐心。 🫶