mcstatusbot

A simple Discord.js bot that pings Minecraft servers using the mc-ping-updated node module.

This bot is currently compatible with post-1.8 vanilla, Spigot, Waterfall, and Bungeecord servers. Other types of servers are partially supported with varying degrees of comaptbility.

Setup & Configuration

• First install Node.js from here if not already installed.
• Then open your OS's terminal emulator in the folder in which the bot is in and run npm i

Edit the config.json file to provide your bot token, preferred command prefix, Minecraft server IP address & port, and ping interval:

• Replace "YOUR BOT TOKEN HERE" with your bot token.
• Replace "/" with your preferred command prefix. Defaults to /.
• Replace "YOUR SERVER IP HERE" with the IP address of the Minecraft server you want to poll. Domains that redirect to IP addresses ("play.exampleserver.net") will also work.
• Replace "25565" with the port number of the Minecraft server you want to poll. Defaults to port 25565.
• Replace "30" with the frequency, in seconds, at which you want the bot to ping the server. Defaults to pinging every 30 seconds.
• Replace "7289DA" with the hex color code you prefer the bot's richEmbed messages to use.
• Start the bot by running start.sh (Linux) or start.bat (Windows). The bot should connect and begin polling the server.

Default Commands

• /help (aliases: /commands, /list, /bot) - List the other commands
• /status (aliases: /server, /online) - Manually poll the Minecraft server whose IP address and port are listed in config.json, returning the server's version and a list of any online players
• /crash - Stop the bot. If you're using a looping start.sh script like the one provided, this effectively restarts the bot.
• /start - starts the server from discord