Notify Me Mod

模组

· 作者 Antara89

NotifyMe 是一个轻量级的 Fabric 服务端模组,适用于 Minecraft 1.21.1,它会监控常见的服务器事件并在游戏外发送通知。

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

需要前置:Fabric API

最新 1.0.0 · 1.21.1 · Fabric

一键开服(送7天)

NotifyMe

NotifyMe 是一款轻量级的 Fabric 服务端模组,适用于 Minecraft 1.21.1。它监控常见的服务器事件并向游戏外发送通知。

该模组专为希望在不保持 Minecraft 客户端开启的情况下了解重要事件发生的服务器所有者而构建。NotifyMe 可以向游戏内操作员发出警报、通过 Postfix/sendmail 发送邮件、发送 Telegram 机器人消息、调用通用 JSON Webhook,或发布到 ntfy 主题。

功能特性

  • 服务器启动和停止通知
  • 玩家加入和离开通知
  • 玩家死亡通知,包含死亡信息、维度、位置、生命值和伤害元数据
  • 可选的聊天、命令广播和游戏内消息通知
  • 针对操作员或指定接收者的游戏内通知
  • 通过兼容 Postfix 的 sendmail 二进制文件进行邮件投递
  • Telegram 机器人投递
  • 通用 Webhook 投递,支持可选的秘密标头
  • ntfy 主题投递,支持可选的身份验证令牌、优先级和标签
  • 玩家过滤器,用于监视和忽略特定玩家
  • 消息前缀过滤器,用于过滤敏感聊天或命令内容
  • 运行时管理命令,用于重载配置、测试通知和状态检查

要求

  • Minecraft 1.21.1
  • Fabric Loader 0.18.4 或更高版本
  • Fabric API
  • Java 21 或更高版本

NotifyMe 仅作用于服务端。玩家无需在客户端安装此模组。

安装

  1. 在你的 Minecraft 1.21.1 服务器上安装 Fabric Loader 和 Fabric API。
  2. 将 NotifyMe 的 jar 文件放入服务器的 mods 文件夹中。
  3. 启动服务器一次。
  4. 编辑生成的配置文件 config/notifymemod.json。
  5. 运行 /notifyme reload 或重启服务器。
  6. 运行 /notifyme test 以验证已配置的通知渠道。

通知渠道

游戏内

游戏内通知默认启用。默认情况下,NotifyMe 仅向服务器操作员发送消息。

将 inGame.opsOnly 设置为 false 可向所有在线玩家发送,或将 inGame.recipients 设置为确切玩家名称列表。

Postfix / sendmail

NotifyMe 可以将电子邮件传递给本地的 sendmail 命令,这与 Postfix 配合良好。

启用 postfix.enabled,配置 postfix.from,并在 postfix.to 中添加一个或多个地址。

示例:

"postfix": {
  "enabled": true,
  "sendmailPath": "/usr/sbin/sendmail",
  "from": "minecraft@example.com",
  "to": ["admin@example.com"],
  "timeoutSeconds": 10
}

Postfix 必须在服务器上预先配置好。NotifyMe 仅负责将消息交给 sendmail;它不会配置 SMTP、DNS、DKIM、SPF 或中继设置。

Telegram

使用 BotFather 创建机器人,将其添加到目标聊天频道,并配置机器人令牌和聊天 ID。

示例:

"telegram": {
  "enabled": true,
  "botToken": "123456:bot-token",
  "chatId": "123456789",
  "messageThreadId": 0,
  "disableNotification": false,
  "timeoutSeconds": 10
}

对于论坛主题或超级群组线程,请设置 messageThreadId。

Webhook

Webhook 后端发送包含事件名称、标题、消息、紧凑消息、玩家名称、时间戳和元数据的 JSON 负载。

示例:

"webhook": {
  "enabled": true,
  "url": "https://example.com/minecraft-webhook",
  "secretHeaderName": "X-NotifyMe-Secret",
  "secretHeaderValue": "change-me",
  "timeoutSeconds": 10
}

ntfy

NotifyMe 可以直接发布到 ntfy 主题 URL。

示例:

"ntfy": {
  "enabled": true,
  "topicUrl": "https://ntfy.sh/my-minecraft-topic",
  "token": "",
  "priority": "default",
  "tags": ["minecraft"],
  "timeoutSeconds": 10
}

对于受保护的 ntfy 主题,请设置 token。

配置

NotifyMe 在首次运行时创建 config/notifymemod.json。

默认事件设置:

"events": {
  "serverStarted": true,
  "serverStopping": true,
  "playerJoined": true,
  "playerLeft": true,
  "playerDied": true,
  "chatMessage": false,
  "commandMessage": false,
  "gameMessage": false,
  "test": true
}

聊天、命令和游戏消息通知默认禁用,因为它们可能会产生噪音,且可能包含私人或敏感信息。仅在符合你的服务器策略时才启用它们。

过滤选项:

"filters": {
  "watchedPlayers": [],
  "ignoredPlayers": [],
  "ignoreMessagesStartingWith": ["/login", "/register"]
}
  • watchedPlayers:如果非空,则仅发送这些玩家的事件。
  • ignoredPlayers:跳过这些玩家的事件。
  • ignoreMessagesStartingWith:跳过具有匹配前缀的聊天或命令消息通知。

常规选项:

"serverName": "Minecraft Server",
"timezone": "system",
"subjectPrefix": "[Minecraft]"
  • serverName 显示在通知正文中。
  • timezone 接受 system 或 Java 时区 ID,如 Europe/Berlin 或 America/New_York。
  • subjectPrefix 添加在通知标题前。

命令

NotifyMe 命令需要权限等级 2。

/notifyme reload
/notifyme test
/notifyme status
  • /notifyme reload 重新加载 config/notifymemod.json。
  • /notifyme test 通过启用的渠道排队发送测试通知。
  • /notifyme status 显示配置路径、启用的事件类型以及后端就绪状态。

隐私说明

外部通知服务可能会接收玩家名称、聊天内容(如果启用)、死亡信息、坐标、服务器元数据和时间戳。

在公共服务器上启用聊天、命令消息、游戏消息、Webhook、Telegram、ntfy 或邮件投递之前,请仔细审查你的配置。

兼容性

NotifyMe 使用 Fabric API 事件钩子,不需要 mixins。除非其他模组以异常方式更改相同的事件,否则它应与大多数服务端 Fabric 模组兼容。

许可证

NotifyMe 采用 CC0-1.0 许可证授权。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源