LISTBOT

ListBot is a relatively simple Discord Bot, written in Javascript to create Lists in every channel.

Let's add everything we need on a community list!

🎉 Inspiration

A couple of friends and me wanted to keep track of the movies we wanted to watch on our discord server, so I created ListBot to do that.

✅ Add ListBot to your Discord Server

By clicking here, you can authorize ListBot to be used in your server.

You can also check out our Discord server in which we discuss what we can add to the bot, possible bug fixes, we sometimes have fun and something else in here.

🔋 Usage

Once the bot is running and connected to your Discord channel and database you can use the following commands:

    * $add <component>: adds a component to the list
    * $multi-add <element> <element> - adds mutiple elements \in a list
    * $help: shows you a message with the available commands
    * $list: lists all the components \in the channel\'s list
    * $log: a log of the versions
    * $poll <active_time_in_minutes>: creates a poll on 5 random items of the list. If attribute is not supplied the poll has no limitation of time.
    * $random: gives you a random component from the list
    * $remove <component>: removes the desired component
    * $multi-remove <element> <element> - removes multiple elements \in a list
    * $remind <time_in_minutes> <component>: adds a component to the list and reminds you of it in n minutes

⭐ Getting started

💻 Installation

Learn how to create a Discord bot and get a valid token here.

💾 To get started locally, follow these instructions:

1. Clone to your local computer using git.
2. Make sure you have Node installed; see instructions here.
3. Make also sure that you have MongoDB installed; see instructions here.
4. Create a copy of the .env.example file named .env found in ./src/config/.env.example and replace the placeholders with your bot token and MongoDB credentials
5. Run npm install to install all dependencies
6. Run npm run dev to start your server as development environment or npm run start for production

🚢 Docker

For development, you can run ListBot using Docker and Docker Compose following these steps below:

• Adjust .env with your bot token
• Run docker-composer up -d. This will build all containers on the first run and will be placed in the background
• If you want to see the logs, just type docker-compose logs -f or read all in Portainer
• If you want to stop, run docker-compose down

The docker-compose.yml file contains:

• Mongo-express: *For database manager**
• Mongo: The database itself
• Server: ListBot
• Portainer: To monitor your container services, such as logs, restarts and more.
  • You need to create a local user and password
  • Next page you need to choose docker local environment and after that click connect

To connect on:

• Portainer: localhost:9000
• Mongo-express: localhost: 8081

🏗️ Contribution Guidelines:

• All contributors must read and abide by our Contributor Code of Conduct
• Visit the Contributing Page for full details on how to get started.

🎃 Contributors Hacktoberfest 2020:

Tomas Sirio	RazCrimson	Robert Groves	Alexander Wilkinson	AldoTurmon	Peipr
Javier Ledezma	Ahmad Reza	Pirooz Amirpour	Severin	Luna	JDOG787
Nathan Dawson	Abhijay Jain	AkiaCode	Adham Mohamed	Akshansh Rewariya	CarlyRaeJepsenStan
Manish Kumar Jha	Simonarde Lima	ValentC- MartC-n	Lyd	Aditya DS	Heyimalaap
Carolini Rodrigues	DiC3genes Dauster	Giuseppe Gangi	Henrique Paulo Bonfim	Igor Silva	JOY SARKAR

Add yours!

👤 Who Am I?