A quick understanding of what we do
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.
Answers to commonly asked questions
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.
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.
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.
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.
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.
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.
You can open a GitHub issue with details about your library and I will get it added to the website for you.
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].
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.
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.
How to contact me if needed
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.