# ZenPings
**ZenPings** 是一个轻量级、简洁明了的 Minecraft 插件，专为 Paper 服务器设计，为您的聊天带来清晰、可定制的 Ping 通知。
通过 `@Username` 提及玩家，在多人聊天中吸引他们的注意力 — 附带声音提醒、高亮显示效果和操作栏消息。保持被关注，保持井然有序，无需杂乱。
---
## ✨ 特性
- 🔔 **Ping 提醒** – 使用 `@Username` 提及玩家，播放声音并高亮显示他们的名字。
- 🎛️ **开关支持** – 玩家可以使用 `/ping` 或 `/ping on/off` 轻松启用或禁用 Ping。
- ⏱️ **防垃圾邮件冷却** – 通过完全可配置的冷却计时器，防止 Ping 垃圾邮件。
- 🚀 **极致优化** – 使用 **Kotlin** 构建，以性能为核心重点。
- 📦 **仅 Paper** – 专为现代 **Paper 服务器** 设计，以获得最佳兼容性和速度。
---
## 📜 指令
| 指令 | 描述 |
|---------------------|--------------------------------|
| `/ping` | 切换 Ping 提醒的开关 |
| `/ping on` / `off` | 明确启用/禁用 Ping |
| `/ping reload` | 重新加载插件配置 (管理员) |
---
## 🔐 权限
| 权限 | 描述 |
|------------------------|---------------------------------|
| `zenpings.toggle` | 允许使用 `/ping` |
| `zenpings.reload` | 允许使用 `/ping reload` |
| `zenpings.color.vip` | 授予 **金色** Ping |
| `zenpings.color.default` | 授予 **水蓝色/灰色/自定义** Ping 颜色 |
---
## ⚙️ 配置 (`config.yml`)
```yaml
replacement-text: "@%player% "
sound: BLOCK_NOTE_BLOCK_PLING
volume: 1.0
pitch: 0.8
prefix: "@"
cooldown-seconds: 5
action-bar-message: "%player% 提到了你! "
```
## 📬 支持
需要帮助或有功能建议？
- 💬 加入 **ZenPings Discord**：[点击这里](https://discord.gg/HFP5v3rZAA)
- 🛠️ 在 [GitHub](https://github.com/luvtoxic/ZenPings/issues) 上提交问题
我们在这里提供帮助!
---
## 🧾 许可
**ZenPings** 采用 **非商业许可**。
你可以：
- ✅ 在公共或私人服务器上使用它
- ✅ 修改源代码以供个人或公共使用
- ✅ **提供署名**分享修改后的版本
你不能：
- ❌ 出售此插件或其修改后的版本
- ❌ 将其包含在付费产品、捆绑包或设置中
阅读完整的条款在 [`LICENSE`](https://github.com/luvtoxic/ZenPings?tab=License-1-ov-file)。
---
## 🧑💻 署名
> 使用 ☕ 和 ❤️ 由 [luvtoxic](https://github.com/luvtoxic) 构建