About

mcstatus.io was created as a utility for people to check the status of a Minecraft server for any purpose. This service also doubles as an API for developers to programmatically check the status of servers. The design of the website was heavily inspired by the simplicity of mcsrvstat.us but aimed at improving consistency and conformity to standards. The website is built using NextJS and the back-end was built with Go. This site uses clean advertising from Carbon Ads to help cover the hosting and development costs.

• How do I check the status of a server?

  Simply paste the address of the server into the address box on the home page. The address is in the form of host:port but the port is optional and defaults to 25565 for Java Edition servers and 19132 for Bedrock Edition servers.

• How do I hide the status of my server?

  Status is enabled by default in the server.properties file of your server. In order to disable this, set the enable-status property to false. Please note that this will also prevent actual Minecraft clients from seeing your MOTD in the in-game multiplayer menu.

• Does this service use query?

  We intentionally chose not to use query in this service because it slows down any status retrieval, and it also does not provide much more information than the data sent by the status protocol.

• How do I see all players on the server?

  Minecraft limits the amount of player names sent by the server to 12 players, picked at random. Most public servers have this feature disabled entirely, or they modify the player names to customized information about the server. Just look at the player list of play.purpleprison.net for example.

• Why don't you show the ping to the server?

  The latency to the server is only measured from the location of our service hosting provider, which is irrelevant to show because your connection to the server is going to be a lot different. It would not make sense to show this data in the response.

• Why is there not a new-line character in some MOTDs?

  Some servers will use character overflows to write text onto the second line of the MOTD. Since Minecraft uses a non-monospaced font, it is almost impossible to figure out where the MOTD splits into a new line outside of the game itself. An example of this is play.purpleprison.net, notice how the entire MOTD is one line.

• I made a library, how do I add it to the API docs?

  You can open a GitHub issue with details about your library and I will get it added to the website for you.

• Is this service open-source?

  Yes, this service is entirely open source and available for anybody to review or host your own. The source code is available on our GitHub organization.

If you wish to contact me, please do so using [email protected]. I accept any sort of feedback on our service including bug reports, feature suggestions, questions about usage, etc.