oOo is an open source Discord bot coded in discord.py by Obscure. Feel free to add a star ⭐ to the repository to promote the project!

Features

oOo bot is updated and mainainted on a weekly basis. In addition to that we are also adding new and exiciting features to the bot in a weekly manner. Default prefix: +

List

oOo currently offers:

• ✉️ Active Support regarding the bot in our support server.

• ⚙️ Guild Configuration (custom prefixes).

• 😀 Commands made pleasant with use of embeds and minimal colors and relative emojis.

• 😂 Fast & Responsive memes and various content pulled from some of the most popular subreddits.

oOo also actively accepts feature requests in discussions tab or in our support server.

Commands

oOo has many commands and they are maintained properly.

Some of them are:

• 👻 Fun: memes, meirl, slap, punch, poke

• 🎮 Mini games: rps, 8ball, toss/flip, roll

• ⚙️ Utility: quickpolls, would you rather polls, advanced polls, setprefix

• 👑 Owner: loadcogs, unloadcogs

See full commands list

Installation

Non Customized version

If you don't want to edit the code of the bot, a permanent 24/7 online version is available, which you can invite to your own Discord server!

Customized version

Requirements

• Python 3.6 or later

• Tenor Gifs API key [Used for commands like punch, slap, etc.]

• Bot Token

• Mongodb Connection URL [Modify the bots code according to collections in your database.]

Cloning the repo

Cloning the repo using terminal:

git clone https://github.com/Obscure-Git/oOo-Bot.git

Downloading as a zip file:

Modifying the env file

Open .env.example file and fill in the information. The file should look something like this:

Token= "YOUR BOT TOKEN HERE"
Tenor= "YOUR TENOR API KEY HERE"
Mongodb= "YOUR MONGODB CONNECTION URL HERE"

After filling the information rename the .env.example file to .env

NEVER SHARE THE INFORMATION INSIDE .env FILE!!!

Running the bot

Open your terminal inside the main folder of the bot and execute the following command:

python main.py

This should run the bot, Any Errors occurred will be shown in the terminal screen.

Links

• Bot website

• Support Server

• Bot invite

• Commands list

• Discord.py Documentation

License

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Contribution

Before creating an issue, please ensure that it hasn't already been reported/suggested. And if you have a question, please ask it in the Discussion Tab or Discord server instead of opening an issue. If you wish to contribute to the oOo bot codebase, feel free to fork the repository and submit a pull request!