Although PepperCord still receives some updates, its codebase is rickety. A new bot is planned. Stay tuned!
PepperCord was born out of necessity for an open-source alternative to other utility bots.
Have an issue? Think you can make PepperCord better? Join our support server.
Fully-documented source code is available for those able to make improvements.
Docker is the best way to run an instance of the bot. See the file docker-compose.yml
for an example compose file.
If you want to run the bot outside a Docker container, you'll need to install the following dependencies from your favorite package manager:
git
ffmpeg
PepperCord uses MongoDB as a datastore, and environment variables for configuration and secrets. (For ease of use in docker.)
PepperCord uses a folder named config/
for everything that isn't stored in configuration files.
SERVICE_ACCOUNT.JSON
: Google Cloud Service Account authentication information. Used for Google Cloud Text-To-Speech. Not required. If the file is missing, the TextToSpeech extension will not fully load.
PEPPERCORD_URI
: MongoDB connection URI. Default ismongodb://mongo:27107
.PEPPERCORD_TOKEN
: Discord token.PEPPERCORD_EVB
: EditVideoBot API Token.https://pigeonburger.xyz/api/
. If you don't know what it is, don't add the var.
PEPPERCORD_SHARDS
: Number of shards to use on Discord. Default is0
.PEPPERCORD_DB_NAME
: Name of the primary database. Default ispeppercord
.PEPPERCORD_PREFIX
: Command prefix. Default is?
.PEPPERCORD_WEB
: Website used in some commands. Default ishttps://www.regulad.xyz/PepperCord
.PEPPERCORD_WEBHOOK
: Optional. A link to a Discord webhook for logging.PEPPERCORD_DEBUG
: Optional. Enables debug information in the log.PEPPERCORD_TESTGUILDS
: Optional. A comma seperated list of Discord guild ids. The bot will only be enabled in these servers. If these are present, global slash commands will not be uploaded.PEPPERCORD_SLASH_COMMANDS
: Optional. If slash commands should be disabled.PEPPERCORD_HOME_SERVER
: Optional. The Discord guild id of the bot's home server. Used for some commands, mainly making emojis.
PEPPERCORD_MESSAGE_CONTENT
: Optional.PEPPERCORD_PRESENCES
: Optional.PEPPERCORD_MEMBERS
: Optional.