A Discord bot to assign/remove a role from users in your guild based on whether or not they have been active lately
- Remove an 'active' role from a user who has not been active for a number of days
- Optionally assign an 'inactive' role to a user when they lose the 'active' role
- Optionally re-assign the 'active' role when a user who becomes active again
- Configure specific users or roles to be exempt from monitoring
- Configure threshold for inactivity
- Keep active members at the top of the members sidebar
- Reward active members for participating in the community
- Recognise how many inactive members your server has
- By using this bot you agree to the terms laid out in the Privacy & Terms document
- If you agree, use my public invite to invite the bot to your server
Admin only Setup requires administrator permission in the Discord server
- Create a role (or choose an existing one) to use to mark active users
- Make your chosen role mentionable (only needed until setup is complete)
- Put the bot's role higher in the list than your chosen role
- Run
@Activity Monitor setupin a channel the bot can read and write in- If you've nicknamed the bot, substitute
@Activity Monitorfor it's nickname
- If you've nicknamed the bot, substitute
- Respond with the information the bot asks you for, until setup is complete
- You can view your guild settings with
@Activity Monitor view-config
Example:
The bot requires certain permissions, which you are prompted for on the invite screen. Each permission has a reason for being required, explained below.
| Permission | Reason |
|---|---|
| Read messsages | Detect when people are active |
| Send messages | Used to ask setup questions (can be disabled after setup is complete) |
| Manage roles | Assign and remove the active role from users |
| Embed links | Responses to 'help' requests use message embeds for nice formatting |
- Install Node.js v10 and
- Clone the repository, or download and extract the zip file (preferrably from the release page)
- Add a file named token in the root folder; paste in your bot token
- Run
npm run full-startto compile and run the bot- If you see yellow 'WARN' messages about peer dependencies, you can safely ignore these
Note for git users
If you cloned the repository with git, make sure you git reset --hard vX.Y to a specific version, as latest master isn't always production ready!
I am available for contact via my support Discord server. I will always do my best to respond, however I am often busy so can't always be available right away, and as this is a free service I may not always be able to resolve your query.
- Node.js - Runtime
- discord.js - Discord library
- disharmony - Bot framework
SemVer is used for versioning; view available versions on the tags page
This project is licensed under the MIT License - see the LICENSE file for details