Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/bendangnuksung/bota

🤖 A discord bot for Dota2 community
https://github.com/bendangnuksung/bota

bot discord discord-bot discord-bots dota2 python

Last synced: about 2 months ago
JSON representation

🤖 A discord bot for Dota2 community

Host: GitHub
URL: https://github.com/bendangnuksung/bota
Owner: bendangnuksung
License: mit
Created: 2018-10-16T23:56:47.000Z (about 6 years ago)
Default Branch: master
Last Pushed: 2023-10-17T21:16:16.000Z (about 1 year ago)
Last Synced: 2024-07-30T18:06:05.261Z (5 months ago)
Topics: bot, discord, discord-bot, discord-bots, dota2, python
Language: Python
Homepage: https://bota.tech/
Size: 21.1 MB
Stars: 23
Watchers: 3
Forks: 5
Open Issues: 4
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # BOTA

[![Server](https://img.shields.io/badge/dynamic/json?url=http://34.72.210.131:5000/getstat&label=Discord%20Servers&query=$.n_servers&color=green)](https://discordapp.com/api/oauth2/authorize?client_id=501100945405378562&permissions=388176&scope=bot)

[![Users](https://img.shields.io/badge/dynamic/json?url=http://34.72.210.131:5000/getstat&label=Unique%20Users&query=$.n_users&color=success)](https://discordapp.com/api/oauth2/authorize?client_id=501100945405378562&permissions=388176&scope=bot)

BOT-A is a free Discord Dota 2 bot which provides comprehensive Information of every Dota 2 characters and exciting features for the community. Pull request are welcome and report any issues you find. The Bot is still in beta so I don't expect it to be perfect. 
  

**Website:** [https://bota.tech/](https://bota.tech/)


[![Join Bota Server](/github_images/join_server.jpg)](https://discord.gg/a7QYPWd)  [![Add Bota to your server](/github_images/add_bot.jpg)](https://discordapp.com/api/oauth2/authorize?client_id=501100945405378562&permissions=388176&scope=bot)

## Commands & Screenshots

Commands List: `!help`  

  ![help](/github_images/commands.png)

Screenshots:

1. Command:  `!counter  morphling`  ![counter morphling](/github_images/counter.png)

2. Command:  `!item storm` ![item storm](/github_images/item.png)

## Pre-Requirements:

Before setting up the environment we first need to get:

1. Discord Token

2. Discord Client ID

3. Dota2 API key

4. Twitch Client ID

5. Discord User (Optional)

* To get `Discord Token` and `Discord Client ID` you can check [this](http://github.com/reactiflux/discord-irc/wiki/Creating-a-discord-bot-&-getting-a-token)

* You can get your  `Dota2 API key` from [here](https://steamcommunity.com/dev/apikey)

* To get `Twitch Client ID` you need to register an application in Twitch developer. You can follow [this](https://dev.twitch.tv/docs/v5#getting-a-client-id) 

* You can get your `Discord User` by clicking on your profile in discord. It will look like `YourName#1234` eg: `bendang#3278`

Once this is done you can assign all this key values in `bota/private_constant.py`.

## Setup Bota

1. Clone repo and Setup postgres DB  

    ```bash

    # clone repo

    git clone https://github.com/bendangnuksung/bota.git

    cd bota

    

    # Install and setup PSQL

    # default password given, please check db_setup.sh to change password

    sh db_setup.sh

    ```

1. Run the independent flask server which handles the log process.   

      ```bash

      sh run_flask.sh

      ```

3. Run the bot. There are two ways to run BOTA

    1. Run using Docker. **(RECOMMENDED)**

    2. Run directly from the Repository

### 1. Run using Docker **(RECOMMENDED)**

1. Download the docker image from [DockerHub](https://hub.docker.com/r/bendang/bota) or download directly using:

   ```bash

   docker pull bendang/bota:latest

   ```

2. Run the docker image with the credentials which you got from Pre-Requirements:

   ```bash

   # docker run --rm -i -t --net=host --entrypoint=/bota/run_bota_docker.sh bendang/bota:latest "DISCORD_TOKEN" "DISCORD_CLIENT_ID" "DOTA2_API_KEY" "ADMIN_ID" "TWITCH_CLIENT_IDS" "LOG_PROCESS_IP_ADDRESS"

   docker run --rm -i -t --net=host --entrypoint=/bota/run_bota_docker.sh bendang/bota:latest 1234 ABCD 6789 YOU#67 FGHI http://0.0.0.0:5000

   ```

   

### 2. Run directly from Repository

1. Install requirements 

    ```bash

    sudo sh setup.sh

    ```

2. Create two Screen.

   1. Screen 1: **Run the scrap process**

      ```bash

      sh run_scrap.sh

      ```

      Detach

   2. Screen 2: **Run the BOT process** 

      ```bash

      sh run_bota.sh

      ```

      Detach

**CAUTION** : While running directly from repository if you are using chrome it will automatically close as the scrap process uses it and it kills once the scraping is done.

### Data Collection Source

1. [DotaBuff](https://www.dotabuff.com/)

2. [Reddit](https://www.reddit.com/r/DotA2/)

3. [Twitch](https://www.twitch.tv/)

4. [D2PT](http://www.dota2protracker.com/)

5. [DotaVoyance](http://dotavoyance.com/)

6. Dota2API