# NotifyMe<\/p>\n
NotifyMe is a lightweight Fabric server-side mod for Minecraft 1.21.1 that watches common server events and sends notifications outside the game.<\/p>\n
It is built for server owners who want to know when important things happen without keeping the Minecraft client open. NotifyMe can alert operators in-game, send email through Postfix\/sendmail, post Telegram bot messages, call a generic JSON webhook, or publish to an ntfy topic.<\/p>\n
## Features<\/p>\n
– Server started and server stopping notifications
\n– Player join and leave notifications
\n– Player death notifications with death message, dimension, position, health, and damage metadata
\n– Optional chat, command broadcast, and game message notifications
\n– In-game notifications for operators or named recipients
\n– Email delivery through a Postfix-compatible `sendmail` binary
\n– Telegram bot delivery
\n– Generic webhook delivery with optional secret header
\n– ntfy topic delivery with optional bearer token, priority, and tags
\n– Player filters for watched and ignored players
\n– Message-prefix filters for sensitive chat or command content
\n– Runtime admin commands for reloads, test notifications, and status checks<\/p>\n
## Requirements<\/p>\n
– Minecraft 1.21.1
\n– Fabric Loader 0.18.4 or newer
\n– Fabric API
\n– Java 21 or newer<\/p>\n
NotifyMe is server-side. Players do not need to install it on their clients.<\/p>\n
## Installation<\/p>\n
1. Install Fabric Loader and Fabric API on your Minecraft 1.21.1 server.
\n2. Put the NotifyMe jar into the server `mods` folder.
\n3. Start the server once.
\n4. Edit the generated config file at `config\/notifymemod.json`.
\n5. Run `\/notifyme reload` or restart the server.
\n6. Run `\/notifyme test` to verify your configured notification channels.<\/p>\n
## Notification Channels<\/p>\n
### In-Game<\/p>\n
In-game notifications are enabled by default. By default, NotifyMe sends messages only to server operators.<\/p>\n
Set `inGame.opsOnly` to `false` to send to all online players, or set `inGame.recipients` to a list of exact player names.<\/p>\n
### Postfix \/ sendmail<\/p>\n
NotifyMe can pass email to a local `sendmail` command, which works well with Postfix.<\/p>\n
Enable `postfix.enabled`, configure `postfix.from`, and add one or more addresses to `postfix.to`.<\/p>\n
Example:<\/p>\n
“`json
\n“postfix”: {
\n “enabled”: true,
\n “sendmailPath”: “\/usr\/sbin\/sendmail”,
\n “from”: “minecraft@example.com”,
\n “to”: [“admin@example.com”],
\n “timeoutSeconds”: 10
\n}
\n“`<\/p>\n
Postfix must already be configured on the server. NotifyMe only hands the message to `sendmail`; it does not configure SMTP, DNS, DKIM, SPF, or relay settings.<\/p>\n
### Telegram<\/p>\n
Create a bot with BotFather, add it to the target chat, and configure the bot token and chat id.<\/p>\n
Example:<\/p>\n
“`json
\n“telegram”: {
\n “enabled”: true,
\n “botToken”: “123456:bot-token”,
\n “chatId”: “123456789”,
\n “messageThreadId”: 0,
\n “disableNotification”: false,
\n “timeoutSeconds”: 10
\n}
\n“`<\/p>\n
For forum topics or supergroup threads, set `messageThreadId`.<\/p>\n
### Webhook<\/p>\n
The webhook backend sends a JSON payload with the event name, title, message, compact message, player name, timestamp, and metadata.<\/p>\n
Example:<\/p>\n
“`json
\n“webhook”: {
\n “enabled”: true,
\n “url”: “https:\/\/example.com\/minecraft-webhook”,
\n “secretHeaderName”: “X-NotifyMe-Secret”,
\n “secretHeaderValue”: “change-me”,
\n “timeoutSeconds”: 10
\n}
\n“`<\/p>\n
### ntfy<\/p>\n
NotifyMe can publish directly to an ntfy topic URL.<\/p>\n
Example:<\/p>\n
“`json
\n“ntfy”: {
\n “enabled”: true,
\n “topicUrl”: “https:\/\/ntfy.sh\/my-minecraft-topic”,
\n “token”: “”,
\n “priority”: “default”,
\n “tags”: [“minecraft”],
\n “timeoutSeconds”: 10
\n}
\n“`<\/p>\n
For protected ntfy topics, set `token`.<\/p>\n
## Configuration<\/p>\n
NotifyMe creates `config\/notifymemod.json` on first run.<\/p>\n
Default event settings:<\/p>\n
“`json
\n“events”: {
\n “serverStarted”: true,
\n “serverStopping”: true,
\n “playerJoined”: true,
\n “playerLeft”: true,
\n “playerDied”: true,
\n “chatMessage”: false,
\n “commandMessage”: false,
\n “gameMessage”: false,
\n “test”: true
\n}
\n“`<\/p>\n
Chat, command, and game-message notifications are disabled by default because they can be noisy and may contain private or sensitive information. Enable them only when that fits your server policy.<\/p>\n
Filtering options:<\/p>\n
“`json
\n“filters”: {
\n “watchedPlayers”: [],
\n “ignoredPlayers”: [],
\n “ignoreMessagesStartingWith”: [“\/login”, “\/register”]
\n}
\n“`<\/p>\n
– `watchedPlayers`: if non-empty, only events for these players are sent.
\n– `ignoredPlayers`: events for these players are skipped.
\n– `ignoreMessagesStartingWith`: skips chat or command-message notifications with matching prefixes.<\/p>\n
General options:<\/p>\n
“`json
\n“serverName”: “Minecraft Server”,
\n“timezone”: “system”,
\n“subjectPrefix”: “[Minecraft]”
\n“`<\/p>\n
– `serverName` appears in notification bodies.
\n– `timezone` accepts `system` or a Java time zone id such as `Europe\/Berlin` or `America\/New_York`.
\n– `subjectPrefix` is added to notification titles.<\/p>\n
## Commands<\/p>\n
NotifyMe commands require permission level 2.<\/p>\n
“`text
\n\/notifyme reload
\n\/notifyme test
\n\/notifyme status
\n“`<\/p>\n
– `\/notifyme reload` reloads `config\/notifymemod.json`.
\n– `\/notifyme test` queues a test notification through enabled channels.
\n– `\/notifyme status` shows the config path, enabled event types, and backend readiness.<\/p>\n
## Privacy Notes<\/p>\n
External notification services can receive player names, chat content if enabled, death messages, coordinates, server metadata, and timestamps.<\/p>\n
Review your configuration before enabling chat, command-message, game-message, webhook, Telegram, ntfy, or email delivery on public servers.<\/p>\n
## Compatibility<\/p>\n
NotifyMe uses Fabric API event hooks and does not require mixins. It should be compatible with most server-side Fabric mods unless another mod changes the same events in unusual ways.<\/p>\n
## License<\/p>\n
NotifyMe is licensed under CC0-1.0.<\/p>\n","protected":false},"excerpt":{"rendered":"
NotifyMe is a lightweight Fabric server-side mod for Minecraft 1.21.1 that watches common server events and sends notifications outside the game.<\/p>\n","protected":false},"featured_media":113985,"template":"","meta":{"_minecraft_slug":"notifymemod","_minecraft_project_id":"bbq3FTqI","_minecraft_author":"Antara89","_minecraft_license":"CC-BY-4.0","_minecraft_downloads":8,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"notifymemod.zip","_minecraft_size_bytes":1458797,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:55:06.056525Z","_minecraft_date_created":"2026-05-08T00:47:01.992509Z","_minecraft_date_modified":"2026-05-06T15:08:41.092733Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/notifymemod","_minecraft_icon_attachment_id":113985,"_minecraft_imported_at":"2026-06-06T17:15:26+00:00","_minecraft_import_hash":"d7102733b22b2c3870656a0d26411c3a","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,126,867],"mod_loader":[99],"minecraft_version":[37],"class_list":["post-113984","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-management","mod_category-social","mod_loader-fabric","minecraft_version-1-21-1"],"yoast_head":"\n