A multipurpose Discord bot.
Note that I'm not developing this bot with any particular features in mind (for example, moderation tools). Also, some features of this bot are somewhat specific and might not be useful to you, but I add them because they're useful to me or others. Feel free to suggest a feature if you want something the bot doesn't already have! If it's not super complicated, I'm happy to add whatever features you might want.
There are two ways you can do this!
The first and easiest way to get the bot into one of your servers is by adding it to your server with this link!
Note that if you want to play around with owner commands (/debug, /link, /cdn, etc.), you will not be able to do that this way.
This is the other way to get the bot into one of your servers, and is best for development. It also allows you to access all commands or use some commands with your own configuration. Instructions are below!
Note
These instructions assume you know how to create a bot application through Discord's Developer Portal and how to obtain a bot token, channel ID, etc. If you need help with any of this, feel free to reach out to me with any of the contact methods listed on my website!
This is the easiest way to run the bot yourself if you just want to run it and don't need to work on development.
First, you must have Docker installed. If you do not have it installed already, follow the instructions here to install Docker. Once Docker is installed:
config.example.json to config.jsonconfig.json, provide values for at least botToken, homeChannel and homeServerId. Other values are optional, but some functionality may not work without them (the bot should tell you what's missing though if you try to use a feature that requires a value you didn't set). If you're not sure about a value, see the wiki page on config.json or feel free to contact me!docker-compose.yml, comment out or adjust the bind mount for id_ed25519 if necessary (for example, if you will not be utilizing the package update check feature of the bot, or if you do not use an SSH key for this or use one in a different format)docker-compose up -d(If you see an error about docker-compose not being recognized as a command, try removing the hyphen (so docker compose up -d). If you're still having issues, you may need to install Docker Compose separately.)
This is the way to go if you intend on working on development. Note that you will need to have Redis installed to run the bot this way - if you do not already have it installed, I recommend this guide for Linux, this guide for macOS, and this port for Windows. Once you have Redis installed:
config.example.json to config.dev.jsonconfig.dev.json, provide values for at least botToken, homeChannel and homeServerId (other values are optional, but some functionality may not work without them - see the wiki page for more information on config values)I'm not the best at this, so feel free to open an issue or PR if you notice anything that seems wrong or if you have a suggestion! I'm all ears. However, please note that I have some Contribution Guidelines.
This bot depends on a few projects and services to provide the features that it has. They are listed below!
Without these people I wouldn't be where I am today, and this project wouldn't be here.