A Discord Bot that guards servers against spambots, scammers and such by implementing baits in onboarding. Dekomori is fully customizable so that you can choose how aggressive you want it to be against suspicious accounts.
- Checks for suspicious accounts based on onboarding questions.
- Completely customizable - you can toggle every single feature on and off.
- Handles most exceptions in users such as users who join repeatedly, users who join and leave, users who join and don't answer the questions, etc.
- Logs everything in a channel of your choice.
- Has a few fun commands to play around with.
Dekomori is written in Python and uses discord.py. You can run it on your own machine or on a server, or you can use Docker to get it running in a few commands. If you know any other easy installation method such as docker compose, please let me know so I can add it here.
You can get Dekomori running easily with a few commands. Just make sure you have docker and git installed in your system. 0. If you're running Dekomori for the first time, it's advised to not invite her to your server before she's running. This is because she automatically creates a configuration file for a server when she joins it. You can recreate this file manually later, but it's easier to just let her do it on her own.
- Clone the repository with
git clone https://github.com/soreikomori/dekomori. - Navigate to the directory with
cd dekomori. - Populate the
config.tomlfile with your bot token first and foremost. You can get a bot token from the Discord Developer Portal. You can also customize the rest of the configuration file to your liking, but the commands need to be synced at least once first. - Customize your Dockerfile however you wish. There is a sample Dockerfile "Dockerfile.example" in the repository that you can simply run if you want, just make sure to remove the
.exampleextension.- Additionally, you can customize the fun_mod.txt file to your liking. This file contains the messages that Dekomori will send when you run the d!fight and d!chuuni commands. For d!fight, make sure to format the users as
<userA>and<userB>. An example is provided in the file.
- Additionally, you can customize the fun_mod.txt file to your liking. This file contains the messages that Dekomori will send when you run the d!fight and d!chuuni commands. For d!fight, make sure to format the users as
- Build the container with
docker build -t dekomori .. - Run
docker run -d --name dekomori -v ./config:/app/config dekomori. - Dekomori should be running now, and you can invite her to your server with the invite link generated in the Discord Developer Portal. Once you've done this, make her sync the commands with
d!sync. You might need to restart your discord client to see the slash commands. - If Dekomori joined your server before she was running, you will need to create default configuration files for your server. You can do this by running the
d!remakeguildconfig herecommand in your server. If you don't have access to the server, you can run thed!remakeguildconfig [Server ID]>command anywhere.
If you need help or want extra information about Dekomori, feel free to join the support server! I'll be happy to help you out.
If you want to contribute to Dekomori, feel free to submit a feature request issue, or fork the repository and submit a pull request. I'll review it as soon as I can. You could also join the support server above and talk to me directly.
Dekomori will always be fully free and open source, and there will never be any features locked behind paywalls. However, if you want to support me and my projects, you can donate to my Ko-fi. I appreciate every donation, no matter the amount!
Dekomori is licensed under the CC BY-NC-SA 4.0 license. You can read the full license here.
Dekomori uses discord.py. Dekomori's ToS and Privacy Policy were inspired by Eresh bot's. You can find their discord server here.