Giter VIP home page Giter VIP logo

mcstatusbot's Introduction

Deploy

Minecraft Server Status - Discord Bot

A simple Discord.js bot that displays the status of Minecraft servers using the mcping-js node module.

Features

  • Self-updating voice channels to display the server's status and the number of players online
  • Support for monitoring multiple Minecraft servers at once
  • See the usernames of the players on the server
  • Check the status of non-monitored servers
  • Slash command support with ephemeral responses to prevent channels from being cluttered with commands

Setup

Method 1: Invite the Bot

  • Invite the bot to your server

Method 2: Heroku Deployment

Note: self-hosting through Heroku deployment is still being worked on

  • Follow this guide and this guide to set up and invite the bot to your server. When creating the invite link, make sure to check the boxes for Manage Roles and Manage Channels
  • Use the Deploy to Heroku button to create an instance of the bot
  • Fill out the configuration variables using your client ID (found in the "OAuth2" section of the Discord Developer Portal) and bot token (found in the "Bot" section of the Discord Developer Portal)

Usage

  • Use /monitor ip (replace ip with the IP address of the server you would like to monitor) to create two self-updating voice channels that display the server's status and the number of players online
  • Use /status to get a detailed report of the default server's status (the first server that was monitored that hasn't been unmonitored). This detailed report includes the server's status, the number of players online, a list of usernames corresponding to the players online, and the server's version
  • Use /status ip to get a detailed report of the specified server's status
  • Use /unmonitor ip to delete the self-updating channels corresponding to the specified server
  • Use /unmonitor all to delete all of the self-updating channels. This should be done prior to removing the bot from the server

Commands

  • /help - List the other commands
  • /status [ip] - Displays the current status and active players for the default server or the specified IP address
  • /monitor ip - Monitor the server with the specified IP address
  • /unmonitor ip|all - Unmonitor the server with the specified IP address or all servers

To-Do

  • Allow users to manage default server for /status command (/default ip command and /monitor ip [default] option, add new key-value pair to server object and use findIndex to get default server)
  • Add graph support (see this repository)
  • Self-hosting via Heroku deployment

mcstatusbot's People

Contributors

alex-programs avatar huskydog9988 avatar lerokko avatar rahulr100 avatar sweethuman avatar tedztar avatar thedjchi avatar thomasbnt avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.