About

• 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?

  Yes, the Java Edition status route checks the query information of the server at the same time it is checking the status information. If the information is available, it is added to the response.

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

• My IP address was banned from the API, how do I appeal?

  Most IP bans are because of mass spam requests to the API. Mass requests may cause a disruption in service for other developers who are looking to use the API. You may request to be unbanned by providing an explanation when you email [email protected].

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

• What is demo.mcstatus.io?

  demo.mcstatus.io is a fake Minecraft server hosted on our network with the intention of showing off all features our service supports. You are not able to connect to this server because it was built from scratch with only the status and query protocol supported. If you do try to connect, your player name is put into the sample players response and you can view it on our website. Go ahead and give it a try if you really want to. If you would like to learn more about how this demo server works, it is open-sourced on our GitHub organization.

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