Skip to content

RahulR100/mcstatusbot

Repository files navigation

Minecraft Server Status - Discord Bot

A simple Discord.js bot that displays the status of Minecraft servers.

Discord Server Count Invite to Server

Docker Pulls Host your own Visit our website Join our Discord


To use: Simply invite the bot to your server, or host your own instance.

Having trouble? Check out the FAQ, open an issue, or ask our Discord server.

Want to contribute a translation? Read the contributing guide here.

Features

  • 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: 🇬🇧 🇩🇪 🇩🇰 🇪🇸

Fall 2025: Self hosted verion release!

The self-hosted version of the bot is now available for use! Read the self host guide for installation and usage.

Other updates:

  • Better display of error messages while getting server status
  • Updated /help command to show options for getting support with problems
  • Package and server software updates
  • General bugfixes

As usual, please open an issue here if you notice any bugs/abnormal behaviour. Thank you!

Usage notes

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.

Commands

/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

Roadmap

  • 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 servers Use Playit
  • Custom online / offline indicators

About

Discord bot for server status

Topics

Resources

License

Contributing

Stars

Watchers

Forks