Skip to content

hpbonfim/ListBot

Β 
Β 

Repository files navigation

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!

image

πŸŽ‰ Inspiration

image

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:

  • 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:

tomassirio
Tomas Sirio
AldoTu
AldoTurmon
Peiprjs
Peipr
jledezma-mt
Javier Ledezma
ahmad-reza619
Ahmad Reza
medusalix
Severin
lunatite
Lunatite
rgroves
Robert Groves
JDOG787
JDOG787
Abhijay007
Abhijay Jain
AkiaCode
AkiaCode
anontyro
Alexander Wilkinson
hpbonfim
Henrique Paulo Bonfim
hyonim
Hyo
valmyzk
ValentC- MartC-n
simonardejr
Simonarde Lima
adhammo
Adham Mohamed
Akshansh99
Akshansh Rewariya
aaronzshey
Aaron Zhi-Ren Shey
manishkrjha
Manish Kumar Jha
RazCrimson
RazCrimson
Adrienne14
Free Stack
khai93
Khai93
arthur-merlin
Arthur-merlin
Toshiuk
Toshiuk
phamducquanptit
Quan Pham
thelovekesh
Lovekesh Kumar
divn
Juuso Takala
joy98
JOY SARKAR
jsilvaigor
Igor Silva

Add yours!

πŸ‘€ Who Am I?

About

Discord Bot

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 99.5%
  • Other 0.5%