Перейти к содержимому
Mineforgian

DiscordNotify

DiscordNotify is a lightweight Paper plugin that sends server start, stop, and custom notifications to Discord using webhooks. Designed as a simple, lag-free alternative to DiscordSRV for status updates and restart alerts.

Загрузки
304
Подписчики
3
Обновлён
1 февраля 2026 г.
Лицензия
All-Rights-Reserved

Опубликован 24 января 2026 г.

DiscordNotify

Fabric, Forge, and Neoforge versions and being worked on please be patient.


DiscordNotify is a lightweight Minecraft plugin that sends server notifications to Discord using webhooks only with no Discord bot, no gateway connection, and no added server lag.

Designed for server owners who want simple, reliable Discord notifications without running a bot or external service.


Server Start & Stop Notifications

Server start notification sent by DiscordNotify

DiscordNotify automatically sends messages to Discord when your server starts and stops, so staff always know the server’s status.

Both messages can be:

  • Fully customized
  • Individually enabled or disabled via config.yml

Restart Countdown Warnings

Restart countdown message sent by DiscordNotify

Send formatted restart countdown messages using a simple command:

/discordnotify restart 10m

Supports flexible time formats such as 30m, 1h30m, and 2h15m10s.


Easy Webhook Testing

DiscordNotify webhook test message

Verify your webhook setup instantly using:

/discordnotify test

No role pings and no spam — just a clean confirmation that the webhook is working.


Message Preview (No Spam)

Preview exactly what will be sent to Discord before sending anything:

  • /discordnotify preview msg <message>
  • /discordnotify preview restart <time>
  • /discordnotify preview test
  • /discordnotify preview start
  • /discordnotify preview stop

Previews respect:

  • Prefix settings
  • Role mention rules
  • Auto-delete configuration

Nothing is sent to Discord and nothing is tracked.


Why DiscordNotify?

🚀 Webhook-only. No Discord bot required.

Unlike plugins such as DiscordSRV or Discord StatusBot, DiscordNotify does not log in a Discord bot, maintain a gateway connection, or run background listeners.

Plugins that rely on Discord bots must maintain persistent connections and process gateway events.
DiscordNotify avoids this entirely by sending messages through webhooks only.

What that means for your server:

  • No extra threads or bot overhead
  • No external hosting or token management
  • Fully async message sending
  • Safe, predictable performance

Just paste a webhook URL and you are done.


Features

  • Server start and stop notifications (individually toggleable)
  • Send custom Discord messages via commands
  • Restart countdown helpers with flexible time parsing
  • Message preview commands (no webhook spam)
  • Optional configurable message prefix
  • Optional Discord role mentions (disabled by default)
  • Per-command role mention control
    • Allow or block role pings for:
      • msg
      • restart
      • test
  • Reload configuration without restarting the server
  • Console-only update checker
    • Silent when up to date
  • /discordnotify test to verify webhook setup
  • /discordnotify version to show installed version

Optional Webhook Auto-Delete

  • Keep Last N messages sent by DiscordNotify
  • Time-based auto-delete (delete messages after X seconds)
  • Tracks all messages, including server stop notifications
  • Both modes:
    • Are disabled by default
    • Use webhooks only (no bot, no gateway)
    • Run fully asynchronously with no TPS impact

Usage

  • /discordnotify msg <message> — send a custom message
  • /discordnotify restart <time> — send a restart countdown
  • /discordnotify test — verify webhook setup
  • /discordnotify preview <type> — preview messages
  • /discordnotify version — display plugin version
  • /discordnotify reload — reload configuration

Permissions

DiscordNotify uses a small, clear permission set:

  • discordnotify.use
    Allows:

    • /discordnotify msg
    • /discordnotify restart
    • /discordnotify test
    • /discordnotify preview
  • discordnotify.reload
    Allows /discordnotify reload

All permissions default to OP.


Configuration

Only a Discord webhook URL is required.

Start and stop messages can be:

  • Customized
  • Enabled or disabled individually

Optional features such as:

  • Message prefixes
  • Role mentions
  • Per-command role ping control
  • Webhook auto-delete (Keep Last N)
  • Time-based auto-delete

are disabled by default and can be enabled manually.

If you are new to Discord webhooks, see Discord’s official guide:
👉 https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks


Support

For help, suggestions, or questions, you can join the discord.


⚠️ Note:
The commands listed above apply to the latest version of DiscordNotify.
If you are using an older version, command usage may differ. Always check the config.yml included with your installed version.

Ченджлог

1.1.9Релиз1.21.9, 1.21.10, 1.21.11 · 1 февраля 2026 г.

v1.1.9

Added

  • Automatic message toggles

    • New messages.start.enabled and messages.stop.enabled config options
    • Allows disabling server start and/or stop messages entirely
  • Per-command role mention control

    • New config toggles for each command:
      • commands.msg.mentionRole
      • commands.restart.mentionRole
      • commands.test.mentionRole
    • Test messages do not role ping by default
  • Message preview commands

    • New /discordnotify preview commands to show exactly what would be sent to Discord
    • Supported previews:
      • preview msg <message>
      • preview restart <time> [extra text]
      • preview test
      • preview start
      • preview stop
    • Previews respect prefix, role mentions, and auto-delete settings
    • No webhook is sent and nothing is tracked
  • Expanded debug logging

    • New debug.logSends option for detailed webhook send/delete logs
    • Helpful for troubleshooting webhook and auto-delete behavior

Improved

  • Shutdown message reliability

    • Stop messages are now sent synchronously when needed to ensure message IDs are captured before shutdown
    • Improves consistency with auto-delete and tracking systems
  • Cross-platform compatibility

    • Internal scheduling logic updated to remain compatible with Paper, Spigot, Purpur, Bukkit, and Folia-style threading models
    • No blocking operations added to the main server thread

Notes

  • All new features are disabled by default to preserve existing behavior
  • Config files automatically merge new options without overwriting user values
  • Fully webhook-only and async (no Discord bot, no gateway connection)
1.1.8Релиз1.21.9, 1.21.10, 1.21.11 · 30 января 2026 г.

v1.1.8

Added

  • Optional message prefix
    • New prefix.enabled and prefix.text config options
    • When enabled, the prefix is added to every message DiscordNotify sends (start/stop + all commands)

Fixed

  • Stop message not being tracked for auto-delete
    • The server stop notification now properly logs its message ID to sent-messages.txt when tracking is enabled
    • This allows the stop message to be deleted by:
      • Keep Last N
      • Delete after X seconds
      • /discordnotify deleteall (or /dn deleteall)

Notes

  • Auto-delete features remain disabled by default
  • Webhook-only, async-only (no Discord bot, no gateway)
1.1.7Релиз1.21.9, 1.21.10, 1.21.11 · 29 января 2026 г.

v1.1.7

Added

  • /dn alias for /discordnotify
  • New command: /discordnotify deleteall
    • Deletes all messages previously sent by DiscordNotify
    • Uses webhooks only (no bot)
    • Fully async, no server lag

Changed

  • Message IDs are now tracked whenever autoDelete.enabled is true
    • /deleteall works even if:
      • keepLast is set to 0
      • timed delete is disabled
  • Auto-delete tracking logic cleaned up and made more predictable

Notes

  • To use /deleteall, autoDelete.enabled must be set to true
  • Works on Paper, Purpur, Bukkit, and Spigot
  • Folia may work but is untested and unsupported.
1.1.6Релиз1.21.9, 1.21.10, 1.21.11 · 29 января 2026 г.

v1.1.6

Added

  • Time-based auto-delete: optionally delete each message DiscordNotify sends after a configurable delay.
  • New config section: autoDelete.deleteAfterSeconds
    • enabled: toggle timed auto-delete
    • seconds: how long to wait before deleting each message
    • maxScheduled: safety cap for scheduled deletions
    • persist: keeps pending deletions across restarts (optional)

Changed

  • DiscordNotify now uses ?wait=true only when needed (Keep Last N and/or timed auto-delete enabled), to fetch message IDs for deletion.

Notes

  • Still webhook-only (no Discord bot / gateway connection).
  • All sends and deletes are async-only (no TPS impact).
  • Timed auto-delete can be used alone or together with Keep Last N messages.
  • autoDelete.enabled remains the master switch to disable all auto-delete features instantly.
1.1.5Релиз1.21.9, 1.21.10, 1.21.11 · 28 января 2026 г.

v1.1.5

Added

  • Optional webhook auto-delete (Keep Last N messages)
  • New autoDelete configuration section to control message cleanup behavior
  • Support for automatically deleting older DiscordNotify messages sent via the webhook
  • Optional persistence of sent message IDs to continue cleanup after server restarts
  • Debug mode for the update checker to assist with troubleshooting and testing
  • Optional forced update version for testing update notifications without contacting Modrinth

Changed

  • Update checker reliability improvements:
    • Robust version comparison that scans all available Modrinth versions
    • No longer relies on API ordering to determine the latest release
  • Update notifications now use clear visual separators in the console for better visibility
  • Webhook messages use ?wait=true only when auto-delete is enabled (required to retrieve message IDs)
  • Improved internal webhook handling for safer message deletion
  • Configuration auto-merge continues to add new options without overwriting existing values

Notes

  • Auto-delete is fully optional and disabled by default
  • Update checks remain console-only and silent if up to date
  • Debug output is disabled by default and intended for troubleshooting only
  • Uses Discord webhooks only (no bot, no gateway connection)
  • Runs asynchronously with no TPS impact
  • Only messages sent by DiscordNotify are affected
  • No new commands or permissions were added
1.1.3Релиз1.21.9, 1.21.10, 1.21.11 · 24 января 2026 г.

v1.1.3

Added

  • Optional Discord role mention support (disabled by default)
  • Support for combined restart time formats (e.g. 1h30m, 2h15m10s)

Changed

  • Restart time formatting now displays clean, human-readable durations
  • Configuration handling now automatically adds new options without overwriting existing values
  • Updated configuration comments to document new restart time formats

Notes

  • Existing configuration values (including webhook URLs) are preserved on update
  • Role mentions require the role to be mentionable in Discord
  • No impact on server performance; all webhook requests remain asynchronous
1.1.2Релиз1.21.9, 1.21.10, 1.21.11 · 24 января 2026 г.

v1.1.2

Changed

  • Updated configuration comments and documentation to reflect new command structure
  • Minor internal cleanup and wording improvements

Notes

  • No functional changes to commands or configuration behavior.
1.1.1Релиз1.21.9, 1.21.10, 1.21.11 · 24 января 2026 г.

v1.1.1

Added

  • New /discordnotify msg <message> subcommand for sending custom Discord messages
  • New /discordnotify restart <time> subcommand with formatted restart countdowns
  • New /discordnotify reload subcommand to reload the config without restarting the server
  • Tab completion for /discordnotify subcommands and restart time arguments

Changed

  • Command structure updated to use explicit subcommands instead of raw arguments
  • Commands now correctly report when the webhook is not configured instead of pretending to send

Fixed

  • Prevented crashes when the Discord webhook URL is missing or invalid

Комментарии

Загружаем…