DiscordNotify

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:
    • 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.