regulad / PepperCord

Multi-Purpose Discord bot chock full of functions, including music, Minecraft, and heaps more

PepperCord Legacy (don't use unless you really, really want to!)

Although PepperCord still receives some updates, its codebase is rickety. A new bot is planned. Stay tuned!

About

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.

Using

Public instance

Primary | Mirror | Server

Setup

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

Configuration

PepperCord uses MongoDB as a datastore, and environment variables for configuration and secrets. (For ease of use in docker.)

Config files:

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.

Environment variables:

Secrets

• PEPPERCORD_URI: MongoDB connection URI. Default is mongodb://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.

Config

• PEPPERCORD_SHARDS: Number of shards to use on Discord. Default is 0.
• PEPPERCORD_DB_NAME: Name of the primary database. Default is peppercord.
• PEPPERCORD_PREFIX: Command prefix. Default is ?.
• PEPPERCORD_WEB: Website used in some commands. Default is https://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.

Intents

• PEPPERCORD_MESSAGE_CONTENT: Optional.
• PEPPERCORD_PRESENCES: Optional.
• PEPPERCORD_MEMBERS: Optional.