
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

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

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

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:
msgrestarttest
- Allow or block role pings for:
- Reload configuration without restarting the server
- Console-only update checker
- Silent when up to date
/discordnotify testto verify webhook setup/discordnotify versionto 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 theconfig.ymlincluded 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.enabledandmessages.stop.enabledconfig options - Allows disabling server start and/or stop messages entirely
- New
Per-command role mention control
- New config toggles for each command:
commands.msg.mentionRolecommands.restart.mentionRolecommands.test.mentionRole
- Test messages do not role ping by default
- New config toggles for each command:
Message preview commands
- New
/discordnotify previewcommands to show exactly what would be sent to Discord - Supported previews:
preview msg <message>preview restart <time> [extra text]preview testpreview startpreview stop
- Previews respect prefix, role mentions, and auto-delete settings
- No webhook is sent and nothing is tracked
- New
Expanded debug logging
- New
debug.logSendsoption for detailed webhook send/delete logs - Helpful for troubleshooting webhook and auto-delete behavior
- New
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.enabledandprefix.textconfig options - When enabled, the prefix is added to every message DiscordNotify sends (start/stop + all commands)
- New
Fixed
- Stop message not being tracked for auto-delete
- The server stop notification now properly logs its message ID to
sent-messages.txtwhen tracking is enabled - This allows the stop message to be deleted by:
- Keep Last N
- Delete after X seconds
/discordnotify deleteall(or/dn deleteall)
- The server stop notification now properly logs its message ID to
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
/dnalias 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.enabledis true/deleteallworks even if:keepLastis set to0- timed delete is disabled
- Auto-delete tracking logic cleaned up and made more predictable
Notes
- To use
/deleteall,autoDelete.enabledmust be set totrue - 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.deleteAfterSecondsenabled: toggle timed auto-deleteseconds: how long to wait before deleting each messagemaxScheduled: safety cap for scheduled deletionspersist: keeps pending deletions across restarts (optional)
Changed
- DiscordNotify now uses
?wait=trueonly 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.enabledremains 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
autoDeleteconfiguration 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=trueonly 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 reloadsubcommand to reload the config without restarting the server - Tab completion for
/discordnotifysubcommands 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
Комментарии
Загружаем…