Minecraft Server Status Badges

Four badges, one check

Every badge comes from the same status ping. They only differ in what they print, so pick the one that fits the space you have.

Status

Online or offline, nothing else. The smallest one, and plenty for a README where you only want to show the server exists. It turns red the moment the ping fails.

Players

Players online next to the slot limit the server reports. If the server answers but keeps its count to itself, you get a question mark, not a number we made up. Grey when the server can't be reached.

Version

The version text your server sends back, which often includes the software, like Paper 1.21.4. We cut it off after 18 characters so a long proxy string can't stretch the badge into a banner.

Combined

Status and player count in one badge. If you only put one on your website, make it this one.

Build the URL yourself

Once you know the pattern you don't need the generator. A badge is a plain SVG at this address:

https://badges.astroworldmc.com/badge/play.example.com.svg?type=combined

Replace play.example.com with your server. Not on port 25565? Put the port after a colon, as in play.example.com:25566. Leave type out and you get the status badge; the other values are players, version and combined.

For each badge the generator writes two snippets: Markdown for GitHub and most forums, HTML for websites. Both wrap the badge in a link to Astroworld.

How fresh is it?

When a badge loads, we connect to your server over TCP and send the same status ping your multiplayer screen sends before you join. The server gets five seconds to answer. Whatever comes back is kept for 60 seconds per address.

So a busy page pings your server about once a minute, not once per visitor. The flip side is that right after a restart the badge can trail reality by up to a minute. Give it that minute before you go hunting for a problem.

Server is up, badge says offline

• Players join through an SRV record.We don't look up SRV records. If people type a plain domain and the record quietly sends them to another port, put the real host and port in the badge instead. How SRV records work
• enable-status is switched off.With enable-status=false in server.properties the server ignores status pings. Every server list sees it as offline, and so does this badge. You don't need enable-query for badges, by the way; that setting belongs to a different protocol. server.properties explained
• It's a Bedrock-only server.The ping we send is the Java one. Bedrock listens on UDP port 19132 by default and speaks another protocol, so it never answers. Running Geyser next to a Java server? Use the Java address. Crossplay with Geyser
• The port isn't open to the internet.If friends can only join from your own network, nothing outside it can ping the server either, and that includes us. Port forwarding a Minecraft server

Not sure which one it is? Try the same address in our status checker and compare.

A badge proves the server is alive. Getting players to show up is a separate job, and our rundown of Minecraft server lists is a decent place to start.