LISTBOT

A 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.

Also you can check out our Discord server in which we discuss what we can Add to the bot, possible bugfixes, etcetera 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:

Clone to your local computer using git.
Make sure you have Node installed; see instructions here.
Make also sure that you have MongoDB installed; see instructions here.
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
Run npm install to install all dependencies
Run npm run dev to start server as development environment or npm run start for production

🚢 Docker

For development, you can run ListBot using Docker and Docker Compose following this 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 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:

fork and clone this repository
Make a new branch using git checkout -b change/username
Commit the desired changes to that branch
Sign off your commits using git commit -s -m w/signoff
Push your changes to the branch and open a pull request

🎃 Contributors Hacktoberfest 2020:

_{Tomas Sirio}	_{Javier Ledezma}	_AldoTurmon	_Luna	_JDOG787	_{Nathan Dawson}
_{Abhijay Jain}	_AkiaCode	_Peipr	_{Akshansh Rewariya}	_{Manish Kumar Jha}	_{Simonarde Lima}
_{Adham Mohamed}	_{Aditya DS}	_Heyimalaap	_{Carolini Rodrigues}	_{DiC3genes Dauster}	_{Henrique Paulo Bonfim}
_{Igor Silva}	_{JOY SARKAR}	_{Juuso Takala}	_{Lovekesh Kumar}	_{Quan Pham}	_Sh1710
_Toshiuk	_{Arthur-merlin}	_Khai93	_{Koji Adriano Jr.}	_Severin