Revolutionize your Discord communityās activity and cleanliness with the innovative Decay Score System.
CleanerBot has evolved. Itās no longer just an inactivity manager. Itās a powerful, proactive community hygiene tool. Say goodbye to manual cleanups. Welcome automated, intelligent member retention. Whether you nurture a niche community or oversee a bustling public server, CleanerBot offers a unique blend of gamification and utility. It ensures your community stays vibrant and engaged without you lifting a finger.
CleanerBot is lightweight and privacy-friendly. No admin rights are required! Itās built for peak performance. Itās time to transform how you manage inactivity. Foster a thriving, active environment.
CleanerBot introduces the Decay Score System. This differs from traditional activity tracking. Every member accumulates a Decay Score D(t)
. This score increases over time with inactivity. It directly influences configurable moderation actions. Inactivity becomes a transparent, actionable metric. Think of it as an āinactivity XPā system. The higher the score, the more inactive a member is.
Your Decay Score increases daily. This happens unless you perform qualifying engagement actions. These include:
When a memberās score hits a configured threshold, CleanerBot can trigger automated actions:
Your Decay Score is reduced or reset by activity. It can also be influenced by server-side configurations or special āDecay Boostā roles. These roles slow down the scoreās increase for valued members (e.g., VIPs, donors).
Hereās how the Decay Score system works in practice. These are based on typical server settings:
#kick-review
channel. This is for staff to manually review her removal.Type /start
in your server. This will initiate the interactive setup wizard. CleanerBot will guide you through setting up your Decay Score thresholds. It will also help you assign roles, define activity rules, and enable or disable automatic kicks. Your server can be cleaner, more active, and fully automated in minutes!
/report_decay
)/config show
)/config check_permissions
)/help
)CleanerBot primarily uses Discordās native Slash Commands. This provides a seamless user experience.
/help
: Displays all available commands and their descriptions./my_decay_score
: Shows your current decay score and a brief history./export_decay_data
: [Bot Admin] Exports guild decay data as a CSV file (requires permissions)./report_decay
: Reports members with decay scores above the warning threshold./decay_top10 order:[highest|lowest] limit:[1-20]
: Shows users with the highest or lowest decay scores. This gamifies inactivity./next_check
: Shows when the next decay calculation cycle will run./config set_decay_interval
: Sets how often decay score increases (e.g., 1
for daily)./config set_decay_increment
: Sets how much decay score increases per interval (e.g., 1
)./config toggle_decay_reset
: Toggles full score reset or partial reduction on activity./config set_decay_reduction
: Sets how much decay score is reduced on activity (if not full reset)./config set_warning_threshold
: Sets the decay score for a member warning./config set_decay_role_threshold
: Sets the decay score for ādecay roleā assignment./config set_kick_threshold
: Sets the decay score making a member eligible for kicking./config toggle_auto_kick
: If true
, members are automatically kicked at the threshold./config set_manual_kick_channel
: Sets channel for manual kick review embeds if auto_kick
is false
./config add_decay_boost_role
: Adds a role whose members decay slower./config remove_decay_boost_role
: Removes a role from decay boost roles./config set_language
: Changes the botās language for the guild (e.g., en
, de
)./config set_admin_role
: Sets the role that can use admin commands for this guild./config set_inactive_role
: Sets the role assigned when a member hits the decay role threshold./config add_default_role
: Adds a role new members automatically receive on joining./config remove_default_role
: Removes a role from default roles for new members./config add_exempt_roles [role2]...
: Adds roles exempt from inactivity checks./config remove_exempt_roles [role2]...
: Removes roles from exempt roles./config set_warning_channel
: Sets the channel for warning messages./config set_staff_notification_channel
: Sets the channel for staff notifications./config toggle_reactions_as_activity
: Sets whether reactions count as activity./config add_whitelisted_channel [channel2]...
: Adds channels the bot should NOT scan for activity./config remove_whitelisted_channel [channel2]...
: Removes channels from the whitelist./config clear_whitelisted_channels
: Clears all channels from the whitelist./config clear_default_roles
: Clears all default roles./config clear_exempt_roles
: Clears all exempt roles./config show
: Displays the current configuration for this guild./config validate
: Checks if the guild setup is complete and usable./config check_permissions
: Checks the botās permissions in the current guild./admin set_decay_score
: Sets the decay score for a specific user (0-100)./admin reset_all_decay_scores
: Resets all decay scores for all guild members to 0 (irreversible)./premium
: Learn about CleanerBotās premium features!/checkpremium
: Check the current premium status for this guild./guildtiers
: Displays member limits for each tier.CleanerBot offers extensive language support for global communities:
Short description: Automatically clean up inactive users, manage roles, and keep your Discord community active and thriving.
Prefix: /
Servers: 0
Shards: Unknown
Library: discord.py
Review: No review was provided.