Looking for group serverless discord bot. This bot lets you creat "groups" with descriptions and size limits. People in your channel can join a group, and when the group is full the bot will reply and let you know. Thest best part is the serverless part. The bot will work 24/7 but it doesn't have to be hosted 24/7, so you only pay for what you use!
It's great if you want to play a game, you join / create a group and when others want to play as well, they can join the group and once its full you can get gaming. Think of it like WoW dungeon finder or other games that do group finder, just less flashy.
All of the group data is saved in DynamoDB and expires after 24 hours. If you run it on a low population discord server its likely to be free to run or near free.
Higher usage will cost you, but the dynamoDB queries are optimized to cost as little as possible (There are no scans!)
Feedback welcome!
To use serverless you'll need Node and the serverless framework installed.
https://www.serverless.com/framework/docs/providers/aws/guide/installation/
The goal for me was to make this so anyone with an AWS account can deploy the stack and get a bot working. The serverless.yml file attached will build all the infrastructure you need. It also injects the variable names you need into the lambda env variables.
My inspiration was this post on mendium. https://oozio.medium.com/serverless-discord-bot-55f95f26f743
They give really good examples to get set up with discord bots. Please check out that article if you get a chance its a great read and really help me.
There are some variables that you will have to provide yourself.
- DISCORD_PUBLIC_KEY (Gotten from Discord devloper portal)
- DEV_ACCOUNT_ID (Your AWS Account ID)
Place these into an env.json file in the same diretory as the serverless file. They will be read into the lambda environment variables.
These can be gotten from the Discord developer portal when you create your application and bot.
The other big thing you have to set up is the nacl lambda layer. Here is a guide you can follow for that. https://medium.com/@geoff.ford_33546/creating-a-pynacl-lambda-layer-c3f2e1b6ff11
In there serverless YML there is an section. Otherwise the lambda will not be able to verfy the signature of the Discord POST request.
Once you haver everything set up just run
sls deploy --stage dev
I included a script that you can use to register commands. If you want the commands that work out of the box you should run the update_commands function in the register_commands.py file. Run this locally.
For this to work you need 2 env variables you will need to get from the discord developer portal. Create a .env file in the same directory as the script to and put the following into it.
- bot_id='YOUR BOT ID'
- bot_key='YOUR BOT KEY'
/lfg create_group has 1 required parameter which is group name. You can optionally provide a group description and group size.
/lfg join_group has 1 required parameter which is group name.
/lfg leave_group has 1 required parameter which is group name.
/lfg get_group has 1 required parameter which is group name.
This will return inforamtion about the group.
- Users in group
- Group Description
- Group Size
/lfg get_groups has 1 optional parameter which is avaliable.
- Blank = True
- True = True
- False = False
If you provide True you will return all groups with avaliable space. If you provide False you will provide all groups that are full.
Information returned is.
- Group Name
- Group Description
- Avaliable space in group.