I am no longer maintaining this project. It should continue to work just fine, but if it breaks I won't be interested in fixing it.
You are welcome to fork and update the code yourself. I'm happy to answer any questions you may have in this regard.
Discord Activity Monitor
A Discord bot to assign/remove a role from users in your guild based on whether or not they have been active lately.
Features
- 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
Use cases
- 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
Getting started
Role Assigner needs to be deployed before you can invite it to your Discord server. Please see my written deployment guide for deployment instructions.
Once you have deployed the bot then return here to follow the Discord setup instructions below.
This button can be used for following the Heroku deployment steps.
Discord setup
Follow these instructions once you have deployed Activity Monitor and added it to your Discord server.
Use @Activity Monitor help to view available commands.
Admin only
The setup command requires administrator permission in the Discord server.
- Create a role (or choose an existing one) to use to mark active users
- 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:
Permissions
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 messages | Detect when people are active |
| Send messages | Ask setup questions and respond to commands |
| Manage roles | Assign and remove the active role from users |
| Embed links | Respond to commands |
Troubleshooting
- Test Activity Monitor's ability to reply by using the version command
@Activity Monitor version - Double check that Activity Monitor has both read and write permissions in the channel you're using
- Make sure you're actually mentioning the bot and not the role with the same name
- Make sure you have the 'Administrator' permission if you're trying to use an admin command
- Double check that you've given Activity Monitor all the necessary permissions
- Make sure that the 'Activity Monitor' role is higher in the server role hierarchy than the active/inactive roles
Built With
- Node.js v10 - Runtime
- discord.js - Discord library
- disharmony - Bot framework
Versioning
SemVer is used for versioning. View available versions on the tags page.
License
This project is licensed under the MIT License. See the LICENSE file for details.