Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/vyvy-vi/teardrops

A sad discord bot made using discord.py
https://github.com/vyvy-vi/teardrops

discord-bot discord-mongodb discord-py python teardrops

Last synced: about 2 months ago
JSON representation

A sad discord bot made using discord.py

Host: GitHub
URL: https://github.com/vyvy-vi/teardrops
Owner: Vyvy-vi
License: bsd-3-clause
Created: 2020-10-26T18:37:13.000Z (over 4 years ago)
Default Branch: main
Last Pushed: 2023-04-10T11:12:00.000Z (almost 2 years ago)
Last Synced: 2024-04-14T10:43:35.226Z (10 months ago)
Topics: discord-bot, discord-mongodb, discord-py, python, teardrops
Language: Python
Homepage: http://chat.vyvy-vi.ninja
Size: 4.2 MB
Stars: 14
Watchers: 1
Forks: 16
Open Issues: 8
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        ![](.github/resources/title.svg)

# **THIS PROJECT HAS BEEN ARCHIVED**

















  

[![All Contributors](https://img.shields.io/badge/all_contributors-22-orange.svg?style=flat-square)](#contributors-)



   

      

![sadblob](https://media.discordapp.net/attachments/771696574697832469/773264495006318623/sadblob.png)

![tears](.github/resources/crying.gif)

![cri](.github/resources/cri.png)

#### Python based discord bot built to add fun to the guild with memes, provide wisdom with book-recommendations along with XP rating system with TEARS currency.

A discord bot wrapped around the theme of tears and crying.

In concept, the idea is absurd but that's more of a reason to make this. :)

The bot uses tears as an economy and you can "cry" to get daily credit tears.

**NOTE**- It is recommended that you add your own discord token while running the bot.

## How to test the bot before running it on your server

To test the bot join the [Support Server](https://discord.gg/jTzGuYx)

  [*NOTE- Bot is not active 24x7 as it is hosted on heroku. To get a sample, join* [TearDropsSupport](https://discord.gg/jTzGuYx) *and ping* **@Tissue**]

## How to run the bot on your own server

~~[Invite the bot to your server]()~~

~~[*NOTE- The bot is still in v0.2.0 and is being constantly updated and bug fixed. Inviting this, might have unintentional complications. If you really want the bot, open an issue so that we can provide a Beta Version to you that is stable and updated slowly*]~~

## Hosting the bot locally:

**NOTE**: To replicate this bot, you will need a bot **token**. Go get yours at https://discord.com/developers/ (If you need help with this step, feel free to ask for help in our [Support Server](https://discord.gg/jTzGuYx)).

- Clone this repo using `git clone`

- cd into the bot folder.

- Add the token in a `.env` file in the project root as follows:

```text

DISCORD_BOT_TOKEN=

```

- Install [docker and docker-compose](https://docs.docker.com/desktop/) and then run:

```

docker-compose up

```

- Enjoy! (don't forget to add your own bot into your discord server by generating an invite link from the discord developers application page in [OAuth2 section](https://discord.com/developers/applications/) and choose application and check Oauth2 section)

- To stop this instance of the bot, run `docker-compose down`

- You may do bug-reporting or ask for help in on the SupportServer... or just open an issue on this repo.

## How to contribute

Before contributing, here is some information that might help your **PR (Pull Request)** get merged.

### How to set up the development environment

    

Requirements:

- git

- pip

- python `3.8.1` or higher

1. Fork and clone the repository with `git clone https://github.com//TearDrops`

2. Get to the clone directory using the command `cd Teardrops`

3. Copy the contents of the `.env.sample` file into a new file - `.env` and add your DISCORD bot token in there.

4. There are two ways to do further setup, pipenv or via docker:\

DOCKER METHOD:\

  \- Install [docker and docker-compose](https://docs.docker.com/desktop/)\

  \- Run the command: `docker-compose up`\

**OR**\

THE TRADITIONAL METHOD:\

(Requires [pipenv](https://pipenv.pypa.io/en/latest/))

\- Install pipenv\

\- Add the mongo connection URI in the `.env` file\

\- Run `pipenv sync --dev` to install project dependencies and development dependencies\

\- Run `pipenv run start` to run the bot.\

\- Run `pipenv run lint` to lint the code.\

\- For downloading more libraries, use `pipenv install `\

\- If you're adding any development-dependencies, use-> `pipenv install  --dev`\

## Requirements:

- python 3

- discord(rewrite branch)

- asyncio(inbuilt with python3.4)

- wikipedia

- aiohttp

- motor(asynchronous client for mongodb)

- dnspython

## Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

  

    
_{All Contributors}
📖

    
_{Vyom Jain}
💻 📆 🎨 📖 🚧 👀

    
_Anubhav
💻 📖 🤔 🚇

    
_Gamerrio
🤔 💻 🎨

    
_{Rascal_Two}
🐛 💻 🤔

    
_{Sayan Dutta}
🤔 💻 🎨

    
_{Nicholas Carrigan (he/him)}
🤔 📖

  

  

    
_{Michael Mba}
🤔

    
_{Allan Regush}
🤔 📖

    
_{Matt (IPv4) Cowley}
🤔

    
_{Alex Nørgaard}
🤔

    
_{Nitesh Kumar}
💻

    
_{TJ LeBlanc}
💻

    
_s04
🤔

  

  

    
_{Rayn Islam}
🐛 🤔

    
_Akshaya
🐛

    
_Jay
🤔 📖 🐛

    
_mstanciu552
📖

    
_{Utkarsh Singh}
🤔 📖

    
_{Sreekaran Srinath}
📖

    
_{Souhit Dey}
📖

  

  

    
_{Karuna Tata}
🎨

  

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!