A simple Discord.js bot that displays the status of Minecraft servers.
To use: Host your own instance. The central server is no longer accepting invites and will be shut down soon. See update below for further information.
Having trouble? Check out the FAQ, open an issue, or ask our Discord server.
Want to contribute a translation? Read the contributing guide here.
- Auto-updating voice channels to display the server's status and the number of players online
- Support for both Java and Bedrock servers
- Support for monitoring multiple Minecraft servers at once
- Check the status of non-monitored servers
- Slash command support with ephemeral responses (configurable) to prevent channels from being cluttered with commands
- Multiple languages: 🇬🇧 🇩🇪 🇩🇰 🇪🇸
|
|
Alex and I started working on MCStatusBot over 4 years ago while in college. It was a very useful project, and taught us a lot about Discord bots, scaling applications, sharding, and much more.
Fast forward to today - I'm headed to grad school soon and Alex works full time. We no longer have time to maintain the server that powers over 70k instances of this bot. Trust me, it's a lot of work. I now have nothing but respect for the people who operate applications at Google's or Amazon's scale.
Therefore, we must make the hard decision of shutting down the server. Fear not, it will not be shutting down immediately. It will go offline on 01 September 2026, which should give y'all a few months to find an alternative, or host your own instance. In the meantime however, no new bot invite requests will be accepted.
Similarly, the code is not going anywhere. Updates will be sporadic but pull requests from users are welcome! The source code for all other parts of the project will be made open source and free to use. You may modify, redistribute, and use any part of the code, so long as you add an attribution to the original repository. These repositories are linked below.
Thank you again for all your support over the past few years! We reached over 70k servers which, considering we started at around 70 is crazy!!
Bedrock servers: to use the /status and /monitor commands, you must set the type option to "Bedrock" for the bot to function correctly.
Local IP Addresses (Cloud hosted only) The bot filters out private IP addresses (192.168, 127.0.0, 10.0 etc) which are inaccessible to the bot. The bot will now show Status: Error if your server's IP address has been filtered. If you wish to monitor a private server, you may host your own instance of the bot, or use a free proxy such as Playit to make your server securely accessible via a domain, and then monitor that domain.
/status [server] [platform] Displays the current status and active players for any server
/monitor server [nickname] [platform] [default] [online] [offline] Create 2 voice channels that display the status of a Minecraft server and optionally set a nickname, default status, online, and offline indicator.
/nickname nickname [server] Change the nickname of a monitored Minecraft server
/default server Set a server to be the default for all commands
/unmonitor [server|all] Remove the voice channels for the specified server or all servers
/ephemeral setting Enable or disable ephemeral messages. Note: this is a global setting for your Discord server
/indicators server|all [online] [offline] Customise the online/offline indicators for each/all servers
/bug Send a bug report to the developers
/help List the other commands
- Add server list command (basic management interface)
- Add option to monitor server with message embed instead of voice channels
- Server offline notifications in channel
- Rewrite backend api to support ipc and new federation system
- Rework monitor and nickname commands to include modal workflow
- Link Discord usernames to Minecraft accounts for player list in status command (see this repository)
- Add graph support (see this repository)
- Docker version for self host uses
- Rework status, nickname, and unmonitor commands to include dropdown menus
- Allow disabling of ephemeral messages
-
Minecraft plugin to allow monitoring of local serversUse Playit - Custom online / offline indicators