# pv-addon-reminder
一个轻量级 **Plasmo Voice** 插件，当玩家加入你的服务器时，提醒他们安装模组 —— **无需 Plasmo Voice API**。 可以在 AuthMe 登录之前或之后运行，甚至在完全没有 AuthMe 的情况下运行。
## ✨ 特性
- **灵活的时间控制** – 运行提醒：
- 加入时 (**before-auth** 模式)
- AuthMe 登录后 (**after-auth** 模式)
- 根据是否安装 AuthMe 自动选择 (**auto** 模式)
- **AuthMe 可选** – 即使没有安装 AuthMe 也会运行。
- **无需 PV API** – 通过插件通道数据包检测 Plasmo Voice 客户端。
- **单次会话提醒** 选项 – 避免骚扰玩家。
- **可定制的提醒消息** – 完整的可配置文本，带有颜色代码和 `{player}` 占位符。
- **轻量级** – 最小的性能影响。
---
## 📥 安装
1. 从 [版本](#) 选项卡下载最新的 jar 文件。
2. 将其放置在服务器的 `/plugins` 文件夹中。
3. 启动你的服务器以生成配置文件。
4. 编辑 `config.yml` 以满足您的需求。
---
## ⚙️ 配置文件
```yaml
mode: auto # auto | after-auth | before-auth
message: "&7Hey {player}! This server uses &aPlasmo Voice &7for proximity chat. Install it: &bmodrinth.com/plugin/plasmo-voice"
auth-delay-ticks: 20 # Delay when using after-auth (or auto + AuthMe present)
join-delay-ticks: 40 # Delay when using before-auth (or auto + AuthMe missing)
once-per-session: true # Send reminder only once per session
plasmovoice-channel-prefix: "plasmovoice:"
channels:
- "plasmovoice:voice"
- "plasmovoice:main"
```
---
## 🛠️ 命令 & 权限
没有命令或权限 — 安装和配置即可。
---
## 🔌 兼容性
- **Minecraft:** 1.21.8+ (可能适用于旧版本，但不保证)
- **服务器:** Paper, Spigot, Purpur 和分支
- **可选:** AuthMe Reloaded
---
## 📜 授权协议
本项目采用 MIT 许可证。