the-moth

Official bot of Satyrine's finest eatery... The Magniloquent Moth!

Check us out at: https://themagniloquentmoth.blogspot.com

Features:

• supports slash commands (thanks xPMo!)
• can draw sooth cards
• can roll dice (thanks xPMo!)
• can track flux for Invisible Sun dice (thanks Baconaetor!)
• can roll saves and generate character stats for Suns Apart (thanks again xPMo!)
• Docker support (thanks lackita!)

Usage:

• Add The Moth bot to your Discord server with this link.
• Make sure you grant the bot permissions to read and write messages in the channel(s) you want to use it in.
• type / in a channel it can access and start exploring!

Running Locally

You can either run this directly or through Docker. Either way, you'll also need to create a bot token, which you can find instructions on here.

To run directly, you'll need python3 and pip3 installed. Then you can run the following:

pip3 install -r requirements.txt
MOTH_BOT_TOKEN=$your_bot_token python3 theMoth.py

If you're interested in using docker, you can build and run using the following commands:

docker build -t the-moth .
docker run -e MOTH_BOT_TOKEN=$your_bot_token the-moth

Running on a Remote Server

For the "official" instance of the bot, I pay for a cloud server and I run it off that with pm2 to ensure that the bot process stays alive with no downtime. Since I was constantly forgetting how to update the production instance of the bot after making code changes, I created a setup script which automates the process of updating some tooling and replacing the running bot process with a fresh one. So for me, the way I would run this is:

ssh root@$my_server_ip
git clone https://github.com/v01dlight/the-moth.git
cd the-moth
chmod +x setup.sh
./setup.sh "$my_bot_token"

Credits:

Moth logo image by Nika Akin from Pixabay.