Skip to content

Latest commit

 

History

History
107 lines (82 loc) · 4.32 KB

README.md

File metadata and controls

107 lines (82 loc) · 4.32 KB
Raw

BibleBot

Codacy Badge Help Translate on Crowdin Join us on Discord Discord Bots

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.