BibleBot

The premier Discord bot for Bible verses and Christian resources.

To use it, just say a Bible verse or use the +biblebot help command.

Self-Host Installation

Linux/MacOS

git clone https://github.com/BibleBot/BibleBot.git
cd BibleBot
python3 -m venv venv
source venv/bin/activate
cp src/config.example.ini src/config.ini
$EDITOR src/config.ini
pip install -U discord.py[voice] bs4 colorama lxml tinydb name_scraper
python src/bot.py

Windows (requires Git Bash)

Step 1. Git

1. Clone or download the repository.
2. Open a command prompt in that folder.

Step 2. Command Prompt

python -m venv venv
.\venv\Scripts\activate
copy src\config.example.ini src\config.ini
notepad src\config.ini
pip install -U discord.py[voice] bs4 colorama lxml requests tinydb name_scraper
python src/bot.py

---

Commands:

(this section needs to be updated, use +biblebot for current command reference)

• +biblebot - the help command
• +versions - show all Bible translations you can set
• +setversion VER - set a preferred version
• +version - display your current version
• +versioninfo VER - read information about a version, using the acronym
• +random - get a random Bible verse
• +verseoftheday (+votd) - get the verse of the day
• +headings enable/disable - enable or disable the headings that display on certain verses
• +versenumbers enable/disable - enable or disable verse numbers from showing on each line
• +languages - show all available language translations you can set
• +setlanguage LANG - set a preferred language
• +language - display your current language
• +users - list all users throughout all servers (not counting duplicates)
• +servers - list all servers BibleBot is in
• +invite - get the invite link for BibleBot

Extra-Biblical Commands:

• +creeds - the ecumenical creeds (contains further commands)

Guild Commands:

• +setguildversion ABBV - set the guild's default version to ABBV
• +guildversion - see the default version for this guild
• +setguildlanguage LANG - set the guild's default language to LANG
• +guildlanguage - see the guild's default language, if one is set (default: english)
• +setvotdtime TIME - set the VOTD scheduler time to TIME (TIME must be 24h format and in UTC)
• +clearvotdtime - clear the VOTD scheduler time
• +votdtime - see the VOTD scheduler time and channel

Bot Owner Commands:

• +addversion versionname abbv hasOT hasNT hasDEU (+av) - add a version
• +puppet message - say something as the bot (requires 'Manage Messages' perms in order to fully function)
• +eval python - execute python code (it's an exec() wrapper)
• +userid name#discriminator - grab a user id by name and discriminator
• +optout id - optout an id from using the bot (works for users)
• +unoptout id - unoptout an id from using the bot (works for users)
• +leave NAME - leave the current or NAME server (argument optional)

Invite BibleBot to your server!
https://discordapp.com/oauth2/authorize?client_id=361033318273384449&scope=bot&permissions=93248

Permissions

BibleBot requires the following permissions in order to function properly:

• Read Messages, Send Messages - Obviously.

• Embed Links - This is for BibleBot to use the Discord embed object, as BibleBot uses these for everything besides verses.

  • Example:
    

• Add Reactions, Manage Messages (to clear reactions after timeout), Read Message History - To use reactions properly on things like +search and +versions.

  • Example:
    

Special Thanks

• My translators on Crowdin for their hard work on helping BibleBot reach the world.
• My Patreon supporters for helping fund development and keep BibleBot running.