MinecraftStateMessages
? 功能
- ? 实时通知 - 服务器启动或停止时即时发送 Discord 通知
- ? 自定义嵌入 - 美观且完全可定制的 Discord 嵌入,支持颜色编码
- ? 灵活配置 - 易于使用的 YAML 配置文件,带有合理的默认值
- ? 轻量级 - 对服务器性能影响极小
? 安装
- 从 发布页面 下载最新的
MinecraftStateMessages.jar - 将 JAR 文件放入服务器的
plugins/目录中 - 重启服务器
- 通过编辑
plugins/MinecraftStateMessages/config.yml配置插件 - 运行
/reload或重启服务器以应用更改
⚙️ 配置
首次运行后,会在 plugins/MinecraftStateMessages/ 目录下生成一个 config.yml 文件。以下是所有配置选项的详细说明:
基本设置
# 服务器启动时发送到 Discord 的消息
server-start-message: "Server has been started!"
# 服务器停止时发送到 Discord 的消息
server-stop-message: "Server has been stopped!"
# 你的 Discord Webhook URL - 请从 Discord 服务器设置 > 集成 > Webhooks 获取
discord-webhook-url: "https://discord.com/api/webhooks/your-webhook-url"
嵌入设置
# 启用或禁用 Discord 嵌入(如果为 false,则发送纯文本消息)
embed-enabled: true
# 服务器启动通知的颜色
# 支持:green, red, blue, yellow, orange, purple, gray/grey, black, white
# 或使用十六进制代码:"#2ECC71" 或 "2ECC71"
embed-start-color: "green"
# 服务器停止通知的颜色
embed-stop-color: "red"
# 显示在嵌入顶部的标题
# 留空("")以完全隐藏标题
embed-title: "Minecraft Server"
? 颜色参考
| 颜色名称 | 十六进制代码 | 预览 |
|---|---|---|
green |
#2ECC71 |
? 适合启动消息 |
red |
#E74C3C |
? 适合停止消息 |
blue |
#3498DB |
? 一般信息 |
yellow |
#FFFF00 |
? 警告 |
orange |
#E67E22 |
? 警报 |
purple |
#9B59B6 |
? 特殊事件 |
gray/grey |
#95A5A6 |
⚪ 中性 |
black |
#23272A |
⚫ Discord 深色主题 |
white |
#FFFFFF |
⚪ 亮色 |
你也可以使用任何自定义十六进制颜色:
embed-start-color: "#FF6B6B" # 自定义珊瑚红
embed-stop-color: "4ECDC4" # 自定义绿松石色(# 可选)
配置示例
示例 1:最小化设置(无标题)
server-start-message: "✅ Server Online"
server-stop-message: "❌ Server Offline"
discord-webhook-url: "https://discord.com/api/webhooks/123456789/abcdefg"
embed-enabled: true
embed-start-color: "green"
embed-stop-color: "red"
embed-title: "" # 为空 = 不显示标题
示例 2:品牌化服务器
server-start-message: "? The server is now online and ready for players!"
server-stop-message: "? The server is now offline for maintenance."
discord-webhook-url: "https://discord.com/api/webhooks/123456789/abcdefg"
embed-enabled: true
embed-start-color: "#00FF00"
embed-stop-color: "#FF0000"
embed-title: "? AwesomeCraft Network"
示例 3:简单文本消息(无嵌入)
server-start-message: "[SERVER] Started successfully!"
server-stop-message: "[SERVER] Shutting down..."
discord-webhook-url: "https://discord.com/api/webhooks/123456789/abcdefg"
embed-enabled: false # 发送纯文本而非嵌入
embed-start-color: "green"
embed-stop-color: "red"
embed-title: ""
? 设置 Discord Webhook
- 打开你的 Discord 服务器
- 进入 服务器设置 → 集成 → Webhooks
- 点击 新建 Webhook 或 创建 Webhook
- 自定义 Webhook 名称和频道
- 点击 复制 Webhook URL
- 将 URL 粘贴到 config.yml 中的
discord-webhook-url
?️ 高级用法
标题可见性
embed-title 字段具有特殊行为:
- 设置为任意文本:将该文本显示为嵌入标题
embed-title: "My Awesome Server" - 设置为空字符串 (
"")):不会显示标题embed-title: "" - 未指定/删除:不会显示标题(与为空相同)
多个 Webhook(高级)
想要将通知发送到多个 Discord 频道?你可以动态修改 Webhook URL 或创建多个配置。对于高级设置,建议分叉此插件并添加多 Webhook 支持。
? 故障排除
Webhook 未发送
问题:Discord 中没有出现消息
解决方案:
- ✅ 验证你的 Webhook URL 是否正确
- ✅ 确保
discord-webhook-url没有设置为默认的占位符 - ✅ 检查服务器控制台是否有错误消息
- ✅ 确认该 Webhook 没有在 Discord 中被删除
- ✅ 使用 webhook.site 等工具测试 Webhook URL
颜色不起作用
问题:嵌入显示错误的颜色或没有颜色
解决方案:
- ✅ 使用支持的颜色名称(参见 颜色参考)
- ✅ 如果使用十六进制代码,请确保格式正确:
"#FF0000"或"FF0000" - ✅ 更改颜色后重新加载插件
标题在不应该显示时显示了
问题:即使设置为空,标题仍然出现
解决方案:
- ✅ 确保
embed-title: ""完全如此(空引号) - ✅ 移除引号之间的任何空格:❌
" "→ ✅"" - ✅ 配置更改后重新加载/重启服务器
? 支持与链接
获取帮助 & 保持联系
- ? 支持服务器: dsc.gg/gglvxd - 获取帮助、报告错误或提出功能建议
- ?? 开发者: gglvxd.net - 访问开发者网站
- ? 组织: Fryde - 由 Fryde 提供支持
? 权限
本插件无需任何特殊权限。它仅需要:
- 文件系统访问权限以进行配置管理
- 网络访问权限以发送 webhook 请求
? 许可证
本项目采用 MIT 许可证授权 - 详情请参阅 LICENSE 文件。
? 鸣谢
由 gglvxd 用 ❤️ 开发
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧