About

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

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

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

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

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

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

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

• 8My 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].

• 9Is this service open-source?

  Yes, the library used to retrieve server statuses is entirely open source and available for use. The source code is available on our GitHub organization.

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

• 11Why are Aternos server statuses unreliable?

  Aternos uses a clever system to display to the user in-game when one of their hosted servers is currently down, by showing "This server is offline." in the MOTD. This works well for Minecraft players but makes it difficult for server status retrieval tools because it tricks our service into thinking it is online because it returned a successful response. While we could incorporate a workaround to show these servers as offline, there is no guaranteed method to properly detect this.

  Additionally, Aternos puts servers into a suspended state if there has been no activity on the network for a while. When our service attempts to retrieve the status of a suspended server, their network declines any connection and a true offline response is returned by our service. Immediately following, Aternos will allow connections but return their fake "This server is offline." response again, while our server is still returning the initial offline response due to our 1 minute cache duration. There is currently no solution for any of the issues listed above.

  There is currently no solution for any of the issues listed above. It is recommended that you do not rely on our service to accurately determine the status of any Minecraft server hosted by Aternos.

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.