# Notify 插件
![Banner][banner]
[![Modrinth][badge-modrinth]][modrinth]
[![License][badge-license]][license]
[![Discord][badge-discord]][social-discord]
[![Follow @simplecloudapp][badge-x]][social-x]
[![Follow @simplecloudapp][badge-bluesky]][social-bluesky]
[![Follow @simplecloudapp][badge-youtube]][social-youtube]
[报告 Bug][issue-bug-report]
·
[请求功能][issue-feature-request]
🌟 感谢您的支持 — 您的支持对我们意义重大!
> 关于此项目的全部信息都可以在我们的详细 [文档][docs-thisproject] 中找到。
使用 MiniMessage 格式实时通知,让您的工作人员了解服务器状态的变化。
## 功能
- [x] **游戏内通知**: 获取关于服务器变化的聊天消息
- [x] **自定义消息**: 可配置的消息 ([minimessage](https://docs.advntr.dev/minimessage/index.html) 支持)
- [x] **Velocity & BungeeCord 支持**
## 配置
您可以在此处看到插件的配置文件。 所有可能的选项都在注释中进行了说明。
```yaml
# 插件使用的日期格式模式。
# 更多信息,请参阅官方 Java 文档: https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/text/SimpleDateFormat.html
date-format: dd.MM.yyyy HH:mm:ss
# 筛选要通知的服务器状态。
server-state-filter:
# server-state 显然设置要筛选的服务器状态
- server-state: STARTING
# 向允许的玩家发送的消息放在这里。
# 不要因为 |- 格式而感到恼火,它只是一个多行字符串。 您也可以传递单行消息。
# 您可以在此处使用的可能占位符是:
# -
: 服务器所属的组名
# - : 服务器的数字 ID
# - : 服务器的 UUID
# - : 更新后的服务器状态
# - : 服务器运行的 IP 地址
# - : 服务器绑定的端口
# - : 服务器上当前在线的玩家人数
# - : 可以加入服务器的最大玩家人数
# - : 服务器上次更新的日期
# - : 服务器的初始更新 (创建) 日期
message: |-
⚡ ⚡ Information of
Timestamp:
State:
Server-IP:
Port:
Players: /'>Server updated its state to .
# 用户需要此权限才能接收消息。 如果要允许所有人接收消息,请将其留空 (即可 '')。
permission: notify.receive.state-changed.starting
# 您可以添加更多服务器状态来筛选,例如:
- server-state: AVAILABLE
# 要设计您自己的消息,我们建议使用 minimessage web-ui: https://webui.advntr.dev/
message: |-
⚡ ⚡ Information of
Timestamp:
State:
Server-IP:
Port:
Players: /'>Server updated its state to .
# 默认权限是 notify.receive.state-changed.[server-state]
permission: notify.receive.state-changed.available
- server-state: STOPPING
message: |-
⚡ ⚡ Information of
Timestamp:
State:
Server-IP:
Port:
Players: /'>Server updated its state to .
# 在这里,您可以看到每个人都会收到消息,因为权限为空。
permission: ''
```
## 贡献
欢迎并热烈欢迎对 SimpleCloud 的贡献。 但是,在您开始之前,我们希望您阅读我们的 [贡献指南][docs-contribute]。
## 许可
此存储库使用 [Apache 2.0][license] 许可。
[banner]: https://raw.githubusercontent.com/simplecloudapp/branding/refs/heads/main/readme/banner/plugin/notify.png
[issue-bug-report]: https://github.com/theSimpleCloud/notify-plugin/issues/new?labels=bug&projects=template=01_BUG-REPORT.yml&title=%5BBUG%5D+%3Ctitle%3E
[issue-feature-request]: https://github.com/theSimpleCloud/notify-plugin/discussions/new?category=ideas
[docs-thisproject]: https://docs.simplecloud.app/plugin/notify
[docs-contribute]: https://docs.simplecloud.app/contribute
[modrinth]: https://modrinth.com/plugin/notify-plugin
[maven-central]: https://central.sonatype.com/artifact/app.simplecloud.controller/controller-api
[dev]: https://repo.simplecloud.app/#/snapshots/app/simplecloud/controller/controller-api
[artifacts]: https://repo.simplecloud.app/#/snapshots/app/simplecloud/controller/controller-api
[dev-artifacts]: https://repo.simplecloud.app/#/snapshots/app/simplecloud/controller/controller-api
[badge-maven-central]: https://img.shields.io/badge/modrinth-18181b.svg?style=flat-square&logo=modrinth
[badge-dev]: https://repo.simplecloud.app/api/badge/latest/snapshots/app/simplecloud/controller/controller-api?name=Dev&style=flat-square&color=0ea5e9
[license]: https://opensource.org/licenses/Apache-2.0
[snapshots]: https://repo.simplecloud.app/#/snapshots
[social-x]: https://x.com/simplecloudapp
[social-bluesky]: https://bsky.app/profile/simplecloud.app
[social-youtube]: https://www.youtube.com/@thesimplecloud9075
[social-discord]: https://discord.simplecloud.app
[badge-modrinth]: https://img.shields.io/badge/modrinth-18181b.svg?style=flat-square&logo=modrinth
[badge-license]: https://img.shields.io/badge/apache%202.0-blue.svg?style=flat-square&label=license&labelColor=18181b&style=flat-square&color=e11d48
[badge-discord]: https://img.shields.io/badge/Community_Discord-d95652.svg?style=flat-square&logo=discord&color=27272a
[badge-x]: https://img.shields.io/badge/Follow_@simplecloudapp-d95652.svg?style=flat-square&logo=x&color=27272a
[badge-bluesky]: https://img.shields.io/badge/Follow_@simplecloud.app-d95652.svg?style=flat-square&logo=bluesky&color=27272a
[badge-youtube]: https://img.shields.io/badge/youtube-d95652.svg?style=flat-square&logo=youtube&color=27272a