A plugin for AdvancedDiscordBot that adds experience points, levels, and role rewards based on user activity.
- Track XP per user per guild
- Award XP on message activity (with configurable rate limiting)
- Level-up notifications
- Role rewards for reaching specific levels
- Leaderboard commands
- Admin configuration
/level- Check your or another user's level and XP/leaderboard- View the server XP ranking (top 10)/level-config- Admin: Configure XP rates, cooldowns, and level-up channel/level-roles- Admin: Manage role rewards for specific levels
- Copy this folder to your bot's
plugins/directory - Restart the bot (required for slash command registration)
- Use
/level-configto set up the plugin
xpPerMessage: Amount of XP awarded per message (default: 5)xpCooldown: Seconds between XP awards for the same user (default: 60)xpPerMinuteLimit: Maximum XP a user can earn per minute (default: 100)levelUpChannelId: Channel ID for level-up announcements (optional)
XP is awarded based on message activity with anti-spam protection. Levels are calculated using the formula: level = floor(sqrt(xp / 100)).
When a user levels up:
- Their level is updated in the database
- A level-up event is emitted for other plugins to listen to
- A message is sent in the configured level-up channel (if set)
- Any role rewards for the new level are automatically assigned
The plugin creates three namespaced collections:
plugin_adb-plugin-levels_level- Stores user XP and levelsplugin_adb-plugin-levels_levelconfig- Stores guild configurationplugin_adb-plugin-levels_leaderole- Stores level-to-role mappings
- discord.js ^14.14.1
- mongoose ^8.0.3
This project is licensed under the GNU Affero General Public License v3.0. See the LICENSE file for details.
This repository follows the policies of the main ADB project.
- Contribution Guidelines: CONTRIBUTING.md
- Code of Conduct: CODE_OF_CONDUCT.md
- Security Policy: SECURITY.md