# Messenger
一个用于发送
[MiniMessage](https://docs.advntr.dev/minimessage/format.html) 格式化
定时轮换信息的聊天插件。
## 配置
- `duration`: 整数
- 在每次消息发送到聊天之间的时间间隔(秒)
- 默认为:`300` (5 分钟)
- `message-format`: 字符串
- 在聊天中显示给用户的消息格式。
- 用于在消息前添加前缀或后缀
- 支持 [MiniMessage](https://docs.advntr.dev/minimessage/format.html)
- 默认为:`[+ ] %message%` (渲染为 `[+] %message%`)
- `debug-logging`: 布尔值
- 是否将详细的日志打印到控制台
- 默认为:`false`
## 指令
- `/messenger `
- Messenger 的主指令
- `/messenger add` - 打开编辑器以添加一个新的轮换消息到聊天中。
- `/messenger add ` - 直接将消息添加到聊天中
- `/messenger reload` - 从 `messages.json` 文件重新加载插件的配置和消息。
## 权限
- `messenger.command.messenger`
- 运行 `/messenger` 指令的能力
- 默认为:`op`
## 数据
该插件目前仅处理两个文件:`config.yml` 和 `messages.json`。
`config.yml` 包含插件的配置,更多详情请参考
[配置](#configuration)
`messages.json` 包含要打印到聊天的每个消息。
从此列表中删除/添加消息将从/添加到游戏中(在 `/messenger reload` 或服务器重启后)。
## 消息格式
可以使用
[MiniMessage](https://docs.advntr.dev/minimessage/format.html) 格式化消息。 如果
`%player%` 包含在消息中,则它将被玩家的用户名替换。
## API
该插件提供一个简单的 API,允许添加新的消息。
如果使用 Maven,请将以下内容添加到您的 pom.xml 中,以将其添加为依赖项:
```xml
jitpack.io
https://jitpack.io
com.github.funnyboy-roks
Messenger
Tag
```
否则,请查看 [jitpack 仓库](https://jitpack.io/#funnyboy-roks/Messenger/1.0) 以获取其他系统
### 使用示例
```java
// 构造一条新的消息,显示 "hello " + 玩家名称
// 并发送给所有玩家
Message msg = new Message(
p -> Component.text("hello ").append(p.displayName()),
p -> true
);
// 将消息添加到列表中
Messenger.api().addMessage(msg);
```
## 未来待办事项
- [ ] PAPI 支持 - 如果有兴趣
- [ ] 更多的配置选项
我一直在寻找想法,如果您有任何想法,请创建一个问题
并告诉我!