Motorchik

Motorchik, discord bot written in python.

This bot has been replaced by its rust version: https://github.com/JohnTheCoolingFan/rusted-motorchik

Longer about

Motorchik is a discord bot, written in python using discord.py. At current state Motorchik provides simple tools for discord servers, such as delete a number of messages, ban or kick someone, give default roles to new members (without breaking Verification Level), etc. Per-server configuration system is still in development, but working. This bot will be published on some site about discord bots when I consider that it's ready for public usage. Feel free to use it, but be aware that the bot is nearly always 50% done. If you want to add this bot on your server, hosted nearly 24/7 on my OrangePi PC, message me at discord John The Cooling Fan#6411 for a bot invitation link.

Minimum supported python version is 3.7

Features

• Misc
  • Greeting message on member join.
  • Default roles given when member joins.
  • Message when member leaves.
  • Log bans and unbans.
• Factorio stuff
  • Get a mod (or mods) statistics and display as embed.
  • Send a list of mod statistics info.
• Configuration
  • Motorchik is highly configurable for servers (guilds).
  • Commands can be turned on/off or black/whitelisted by channel.
  • Various info channels are available to be configured
  • Configuration can be stored multiple ways (if you want to host this bot by yourself).

How to use / Installation

1. Clone this repo or download archived sources to your local machine

2. Make sure you have discord.py, python-dateutil, beautifulsoup4 and natsort:

# python3 -m pip install discord.py python-dateutil beautifulsoup4 natsort

or

$ python3 -m pip install -r requirements.txt

Add --user after pip install to install these packages to your local user. You can also install these packages using your OS' package manager if you want. If you plan to use MongoDB configuration module, also install dependencies from mongo_requirements.txt

3. Run main.py

python3 main.py

or

./main.py

4. Autostart

You can use any type of auto-starting. My host runs linux and I use systemd unit to run it automatically. This is an example unit for running it as root. ~/.config/systemd/system/Motorchik.service

[Unit]
Description=Motorchik, discord bot written in python
After=network-online.target

[Service]
ExecStart=/path/to/Motorchik/main.py
WorkingDirectory=/path/to/Motorchik

[Install]
WantedBy=default.target

And then

$ systemctl enable --now Motorchik.service

Everything will be logged to STDOUT, so you can view entire bot's log with:

$ journalctl -u Motorchik.service

(Requires restarting the unit for entire log to show up)

Features on TODO

• [General] Support for modern Discord features, such as slash commands and Message components (buttons)
• [General] Localization and per-server message configuration
• [Moderation] Automatic moderation, such as spam filtering and timed warns/bans/kicks (e.g. [member] banned for 3 days)
• [Moderation] Make $$clearchat more powerful
• [Server Configuration] Better configuration interface
• [GuildConfig] More storage methods
• [Factorio] Better thumbnail color detection
• [Factorio] Customizable mod-list that is configured like welcome/log info channel