Welcome to PurgeBot! This bot helps manage and clean up your Discord server by automatically purging old messages from channels based on your specified duration. Whether you need to clear out outdated messages or keep your channels tidy, PurgeBot has you covered.
- Purge Old Messages: Automatically delete messages older than a specified duration.
- Stop Purging: Easily stop the purging task for a channel.
- List Purge Tasks: Get a list of all active purge tasks in your guild.
- Add or Remove Users/Roles: Grant or revoke permission for specific users or roles to manage purge tasks.
- Go: Ensure you have Go installed on your system.
- Discord Bot Token: Create a bot on Discord Developer Portal and get your token.
- SQLite: The bot uses SQLite for database storage.
-
Clone the repository:
git clone https://github.com/keshon/purge-bot.git cd purge-bot -
Install dependencies:
go mod tidy
-
Set up your environment:
Create a
.envfile in the root directory with the following content:DISCORD_KEY=your-discord-bot-token
-
Run the bot:
go run main.go
Automatically purge old messages in the channel.
- Usage:
@PurgeBot <duration> - Example:
@PurgeBot 30s(purges messages older than 30 seconds) - Note:
@PurgeBotis just an example. The actual bot mention may vary based on the bot's name or configuration.
Stop the active purge task in the channel.
- Usage:
@PurgeBot stop
Get a list of all channels with active purge tasks in the guild.
- Usage:
@PurgeBot list
Grant a user permission to manage purge tasks. You can use either username or user ID.
- Usage:
@PurgeBot adduser <username>or@PurgeBot adduserid <userID> - Example:
@PurgeBot adduser JohnDoeor@PurgeBot adduserid 339767128292982785
Revoke a user's permission to manage purge tasks. You can use either username or user ID.
- Usage:
@PurgeBot removeuser <username>or@PurgeBot removeuserid <userID> - Example:
@PurgeBot removeuser JohnDoeor@PurgeBot removeuserid 339767128292982785
Grant a role permission to manage purge tasks. You can use either role name or role ID.
- Usage:
@PurgeBot addrole <roleName>or@PurgeBot addroleid <roleID> - Example:
@PurgeBot addrole Adminor@PurgeBot addroleid 1274017921756172403
Revoke a role's permission to manage purge tasks. You can use either role name or role ID.
- Usage:
@PurgeBot removerole <roleName>or@PurgeBot removeroleid <roleID> - Example:
@PurgeBot removerole Adminor@PurgeBot removeroleid 1274017921756172403
Get a list of all users and roles registered to manage purge tasks, including their names.
- Usage:
@PurgeBot listpermissions
Get detailed usage instructions and a list of available commands.
- Usage:
@PurgeBot help
- Purge Interval: The interval at which the bot checks for messages to purge (default: 33 seconds).
- Minimum Duration: The minimum duration for purging tasks (default: 30 seconds).
- Maximum Duration: The maximum duration for purging tasks (default: 3333 days).
To invite PurgeBot to your server, use the following invite link format:
https://discord.com/oauth2/authorize?client_id=YOUR_APPLICATION_ID&scope=bot&permissions=75776
Required Permissions:
- Read Messages
- Send Messages
- Manage Messages (for purging messages)
- Read Message History
Replace YOUR_APPLICATION_ID in the URL with your bot's actual application ID from the Discord Developer Portal.
Here's how you can use PurgeBot in your server:
-
Start purging messages older than 1 hour:
@PurgeBot 1h -
Stop purging in a channel:
@PurgeBot stop -
Get a list of all purge tasks:
@PurgeBot list -
Add a user to manage purge tasks:
@PurgeBot adduser JohnDoe -
Remove a user from managing purge tasks:
@PurgeBot removeuser JohnDoe -
Add a role to manage purge tasks:
@PurgeBot addrole Admin -
Remove a role from managing purge tasks:
@PurgeBot removerole Admin -
Get a list of all registered users and roles:
@PurgeBot listpermissions -
Get help:
@PurgeBot help
PurgeBot was inspired by the original KMS Bot project. The original bot, written in Python, provided the foundational concept for this Go implementation. A special thanks to the creator of that project!