BetBot

A discord bot for betting on MMA with simulated money!
Explore the docs »

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

About The Project

Invite BetBot to your server! (BETA): INVITE

This is the very first discord sports betting bot created (That I was able to find)! This has not been done before due to the privitization of sports betting API's. I created my own UFC API https://github.com/erobin27/UFC-API that allows me to get data from the UFC website. I then present this data to the user through the discord bot. Users can place bets using their balance. User's balance, wagers, discord id, and past wagers are all stored in a mySQL database.

What is special about this project?

• Users are determined by their static discord UID so their account info is kept across any discord server
• Makes use of the new discord components which are not officially released yet
• Can place bets in real time and verify that the fights have not started/ended

I plan on continuing to build this project up. Currently the stack I am using is as follows.

FrontEnd: Python

• Discord
• Discord Components
• requests

API: Node.js

• Express
• Puppetteer

Backend: mySQL

(back to top)

Built With

This section should list any major frameworks/libraries used to bootstrap your project. Leave any add-ons/plugins for the acknowledgements section. Here are a few examples.

• Python
• mySQL
• Discord
• My UFC API

(back to top)

Getting Started

To get started clone the repo to your local machine and begin installing it's dependencies. You will need to setup your discord token and database connection info in a .env file in the project directory.

Prerequisites

To run this app you will need to install python, pip, and mySQL server

Installation

1. Clone the repo

   git clone https://github.com/erobin27/BetBot.git

2. Install python dependecies with pip (will add requirement file soon)

   pip install ...

3. run the python file BetBot.py whilst UFC-API and mySQL database are running

(back to top)

Usage

This is a way for people to make the UFC fights more engaging and fun without the harmful effects of gambling with real world money. I intend to make BetBot very interactive with leaderboards, xp ranks, etc. The betting process is not without risk since user balance is stored and after losing your money you would have to earn more but this definitely beats going broke in the real world from betting.

(back to top)

Roadmap

• Allow users to place bets
• Check bets and award winners
• [] list previous wagers and outcome
• [] Add a way for users to earn money
• [] Add a ranking/xp system
• [] Add server leaderboards

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

You are not allowed to use this source code.

(back to top)

Contact

Project Link: https://github.com/erobin27/BetBot

(back to top)

Acknowledgments

Credits

• ReadMe Template

(back to top)