How to Send Minecraft Server Status to Discord

Why Display Server Status in Discord?

Showing your minecraft server status discord feed gives players instant visibility into whether the server is online, how many people are playing, and whether performance is healthy, all without launching the game. It reduces "is the server down?" messages and keeps your community engaged even when they are not in-game.

There are two main approaches: using DiscordSRV's built-in status features, or using webhooks with a standalone status bot. This guide covers both.

Option 1, DiscordSRV Status Channel

If you already have DiscordSRV installed (see our Discord bot setup guide or the DiscordSRV guide), you can enable the built-in server status message with minimal effort.

Enable the Status Embed

Open plugins/DiscordSRV/config.yml and locate the ServerWatchdogEnabled and ChannelTopicUpdaterChannelTopicsAtShutdownEnabled options. The channel topic updater writes live player counts and TPS into a Discord channel's topic bar automatically.

For a richer status embed, enable the ServerWatchdog module. It posts a message when the server goes offline and sends a recovery notification when it comes back. Configure the target channel:

ServerWatchdogEnabled: true
ServerWatchdogTimeout: 30

This checks the server heartbeat every 30 seconds and sends an alert if no response is received.

Customizing the Topic Updater

DiscordSRV can write dynamic information into the channel topic. In config.yml, look for ChannelTopicUpdater settings. You can include placeholders like %playercount%, %playermax%, %tps%, and %date%. The topic updates every few minutes, Discord rate-limits topic changes to twice per 10 minutes per channel, so do not expect real-time updates here.

Option 2, Webhook-Based Status Updates

If you want a standalone solution or do not use DiscordSRV, you can push minecraft server status discord updates via webhooks. This approach works with any server type, including modded servers and proxies.

Create a Discord Webhook

In your Discord server, go to the status channel's settings > Integrations > Webhooks > New Webhook. Name it something like "Server Status" and copy the webhook URL.

Write a Status Script

A simple bash script can query your Minecraft server and post results to the webhook. This example uses mcstatus, a Python tool:

#!/bin/bash
# Install: pip install mcstatus
STATUS=$(mcstatus localhost:25565 status 2>&1)
PLAYERS=$(echo "$STATUS" | grep -oP 'players: \K[0-9]+/[0-9]+')
VERSION=$(echo "$STATUS" | grep -oP 'version: \K.*')

curl -H "Content-Type: application/json" \
  -d "{"embeds":[{"title":"Server Status","color":65280,"fields":[{"name":"Players","value":"$PLAYERS"},{"name":"Version","value":"$VERSION"}]}]}" \
  YOUR_WEBHOOK_URL_HERE

Run this script on a cron job every 5 minutes:

*/5 * * * * /home/minecraft/status-webhook.sh

Option 3, Bot Presence Status

DiscordSRV can set the bot's activity status to show the current player count. In config.yml:

DiscordGameStatus: "%playercount%/%playermax% players online"

This makes the bot's status line in the Discord member list read something like "4/50 players online," giving everyone a quick minecraft server status discord glance without opening any channel.

Advanced, Embed with Server Icon and MOTD

For a polished look, create a dedicated #server-status channel set to read-only. Post a single embed message that your bot edits in place every few minutes, rather than spamming new messages. The embed can include:

• Server IP and port
• Current MOTD
• Online player count with a list of player names
• TPS and MSPT (milliseconds per tick)
• Uptime since last restart
• Server version and loaded plugin count

This single, auto-updating embed becomes the first thing new members see in your Discord and eliminates repetitive questions about connectivity.

Troubleshooting

• Topic not updating: Discord rate-limits topic edits. Wait 10 minutes before assuming it is broken.
• Webhook returning 404: The webhook was deleted, recreate it and update the URL in your script.
• Player count shows 0 when players are online: Ensure the query port (25565 by default) is open and enable-query=true in server.properties.

For server protection while exposing query ports, see our DDoS protection guide.

Summary

A live minecraft server status discord feed is one of the simplest quality-of-life features you can add. Whether you use DiscordSRV's built-in tools, a cron-driven webhook, or a custom bot, the result is the same: your community stays informed and your support channel stays quiet.

Want to see Discord integration done right? Join Astroworld MC, IP play.astroworldmc.com, Java + Bedrock.