MinecraftStateMessages

插件

· 作者 GGLVXD

一个强大的 Minecraft 服务器插件,通过 Webhook 将实时服务器状态通知发送到 Discord,并支持自定义嵌入(embeds)。

0 本站下载 0 关注 更新于 9 个月前

最新 1.0.1 · 1.21.11 · Paper / Purpur

一键开服(送7天)

MinecraftStateMessages

一款强大的 Minecraft 服务器插件,通过自定义嵌入(Embed)将实时服务器状态通知发送到 Discord。

功能 • 安装 • 配置 • 支持


? 功能

  • ? 实时通知 - 服务器启动或停止时即时发送 Discord 通知
  • ? 自定义嵌入 - 美观且完全可定制的 Discord 嵌入,支持颜色编码
  • ? 灵活配置 - 易于使用的 YAML 配置文件,带有合理的默认值
  • ? 轻量级 - 对服务器性能影响极小

? 安装

  1. 从 发布页面 下载最新的 MinecraftStateMessages.jar
  2. 将 JAR 文件放入服务器的 plugins/ 目录中
  3. 重启服务器
  4. 通过编辑 plugins/MinecraftStateMessages/config.yml 配置插件
  5. 运行 /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

  1. 打开你的 Discord 服务器
  2. 进入 服务器设置 → 集成 → Webhooks
  3. 点击 新建 Webhook 或 创建 Webhook
  4. 自定义 Webhook 名称和频道
  5. 点击 复制 Webhook URL
  6. 将 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 用 ❤️ 开发


由 gglvxd 用 ? 制作 | 由 Fryde 提供支持

如果你喜欢这个插件,请考虑给它一个 ⭐ 并加入我们的 Discord!

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源